Тип QML Layout

Предоставляет присоединенные свойства для элементов, помещенных в GridLayout, RowLayout или ColumnLayout. Подробнее...

• Список всех членов, включая унаследованные

Присоединенные свойства

• alignment : Qt.Alignment
• bottomMargin : real
• column : int
• columnSpan : int
• fillHeight : bool
• fillWidth : bool
• leftMargin : real
• margins : real
• maximumHeight : real
• maximumWidth : real
• minimumHeight : real
• minimumWidth : real
• preferredHeight : real
• preferredWidth : real
• rightMargin : real
• row : int
• rowSpan : int
• topMargin : real

Подробное описание

Объект типа Layout прикрепляется к дочерним элементам макета, чтобы предоставить информацию о макете конкретного элемента. Свойства присоединенного объекта влияют на то, как макет будет располагать элементы.

Например, вы можете указать minimumWidth, preferredWidth и maximumWidth, если значения по умолчанию не удовлетворяют вас.

При изменении размера макета элементы могут увеличиваться или уменьшаться. Из-за этого элементы имеют минимальный размер, предпочтительный размер и максимальный размер.

Если минимальный размер элемента не был явно указан, размер устанавливается в 0. Если максимальный размер элемента не был явно указан, размер устанавливается в Number.POSITIVE_INFINITY.

Для макетов неявные минимальный и максимальный размеры зависят от содержимого макета.

Свойства fillWidth и fillHeight могут иметь значения true или false. Если они false, размер элемента фиксируется на его предпочтительном размере. В противном случае он будет увеличиваться или уменьшаться между минимальным и максимальным размером по мере изменения размера макета.

Примечание: Не привязывайтесь к свойствам x, y, width или height элементов в макете, так как это противоречит целям макета и может также привести к циклам привязки. Свойства width и height используются движком макета для хранения текущего размера элементов, рассчитанного на основе присоединенных свойств min/preferred/max, и могут быть переопределены каждый раз при расположении элементов. Используйте Layout.preferredWidth и Layout.preferredHeight или implicitWidth и implicitHeight для указания предпочтительного размера элементов.

См. также GridLayout, RowLayout и ColumnLayout.

Документация по присоединенным свойствам

Layout.alignment : Qt.Alignment

Это свойство позволяет указать выравнивание элемента внутри ячейки(ей), которую он занимает.

Значение по умолчанию — 0, что означает, что он будет Qt.AlignVCenter | Qt.AlignLeft. Эти значения по умолчанию также применяются, если указан только горизонтальный или вертикальный флаг: если указан только горизонтальный флаг, по умолчанию будет вертикальный флаг Qt.AlignVCenter, а если указан только вертикальный флаг, по умолчанию будет горизонтальный флаг Qt.AlignLeft.

Действительное выравнивание — это комбинация следующих флагов:

• Qt::AlignLeft
• Qt::AlignHCenter
• Qt::AlignRight
• Qt::AlignTop
• Qt::AlignVCenter
• Qt::AlignBottom
• Qt::AlignBaseline

[с QtQuick.Layouts 1.2] Layout.bottomMargin : real

Устанавливает нижнюю границу за пределами элемента. Если значение не задано, оно будет взято из margins.

Это свойство было добавлено в QtQuick.Layouts 1.2.

См. также margins.

Layout.column : int

Это свойство позволяет указать позицию столбца элемента в GridLayout.

Если ни row, ни это свойство не установлены, макету нужно самостоятельно назначить ячейку элементу.

Значение по умолчанию — 0.

См. также row и columnSpan.

Layout.columnSpan : int

Это свойство позволяет указать интервал столбцов элемента в GridLayout.

Значение по умолчанию — 1.

См. также rowSpan и column.

Layout.fillHeight : bool

Если это свойство true, элемент будет максимально возможной высоты, при соблюдении заданных ограничений. Если свойство false, высота элемента будет фиксирована, равна предпочтительной высоте. Значение по умолчанию — false, за исключением самих макетов, у которых значение по умолчанию true.

См. также fillWidth.

Layout.fillWidth : bool

Если это свойство true, элемент будет максимально возможной ширины, при соблюдении заданных ограничений. Если свойство false, ширина элемента будет фиксирована, равна предпочтительной ширине. Значение по умолчанию — false, за исключением самих макетов, у которых значение по умолчанию true.

См. также fillHeight.

[с QtQuick.Layouts 1.2] Layout.leftMargin : real

Устанавливает левую границу за пределами элемента. Если значение не задано, оно будет взято из margins.

Это свойство было добавлено в QtQuick.Layouts 1.2.

См. также margins.

[с QtQuick.Layouts 1.2] Layout.margins : real

Устанавливает отступы за пределами элемента, одинаковые для всех сторон. Сам элемент не оценивает свои отступы. Родительский элемент отвечает за принятие решения о необходимости оценки отступов.

Точнее, отступы оцениваются только в ColumnLayout, RowLayout, GridLayout и других контейнерах типа макета, таких как SplitView, где эффективный размер ячейки элемента увеличивается по мере увеличения отступов.

Поэтому, если элемент с отступами является дочерним элементом другого Item, его позиция, размер и неявный размер останутся без изменений.

Комбинирование отступов с выравниванием приведет к выравниванию элемента включая отступы. Например, вертикально центрированный элемент с верхним отступом 1 и нижним отступом 9 приведет к тому, что эффективное выравнивание элемента внутри ячейки будет на 4 пикселя выше центра.

Значение по умолчанию — 0.

Это свойство было добавлено в QtQuick.Layouts 1.2.

См. также leftMargin, topMargin, rightMargin и bottomMargin.

Layout.maximumHeight : вещественное

Значение по умолчанию — неявная максимальная высота элемента.

Если элемент является макетом, неявная максимальная высота будет максимальной высотой макета без увеличения высоты каких-либо его элементов за пределы их максимальной высоты. Неявная максимальная высота для любого другого элемента — Number.POSITIVE_INFINITY.

Установка этого значения в -1 сбросит высоту до её неявной максимальной высоты.

См. также minimumHeight и preferredHeight.

Layout.maximumWidth : вещественное

Это свойство содержит максимальную ширину элемента в макете. Значение по умолчанию — неявная максимальная ширина элемента.

Если элемент является макетом, неявная максимальная ширина будет максимальной шириной макета без увеличения ширины каких-либо его элементов за пределы их максимальной ширины. Неявная максимальная ширина для любого другого элемента — Number.POSITIVE_INFINITY.

Установка этого значения в -1 сбросит ширину до её неявной максимальной ширины.

См. также minimumWidth и preferredWidth.

Layout.minimumHeight : вещественное

Это свойство содержит минимальную высоту элемента в макете. Значение по умолчанию — неявная минимальная высота элемента.

Если элемент является макетом, неявная минимальная высота будет минимальной высотой макета без уменьшения высоты каких-либо его элементов ниже их минимальной высоты. Неявная минимальная высота для любого другого элемента — 0.

Установка этого значения в -1 сбросит высоту до её неявной минимальной высоты.

См. также preferredHeight и maximumHeight.

Layout.minimumWidth : вещественное

Это свойство содержит минимальную ширину элемента в макете. Значение по умолчанию — неявная минимальная ширина элемента.

Если элемент является макетом, неявная минимальная ширина будет минимальной шириной макета без уменьшения ширины каких-либо его элементов ниже их минимальной ширины. Неявная минимальная ширина для любого другого элемента — 0.

Установка этого значения в -1 сбросит ширину до её неявной минимальной ширины.

См. также preferredWidth и maximumWidth.

Layout.preferredHeight : вещественное

Это свойство содержит предпочтительную высоту элемента в макете. Если предпочтительная высота — -1, она будет проигнорирована, и макет будет использовать implicitHeight вместо неё. Значение по умолчанию — -1.

См. также minimumHeight и maximumHeight.

Layout.preferredWidth : вещественное

Это свойство содержит предпочтительную ширину элемента в макете. Если предпочтительная ширина — -1, она будет проигнорирована, и макет будет использовать implicitWidth вместо неё. Значение по умолчанию — -1.

См. также minimumWidth и maximumWidth.

[с QtQuick.Layouts 1.2] Layout.rightMargin : вещественное

Указывает правое отступы вне элемента. Если значение не установлено, используется значение из margins.

Это свойство было добавлено в QtQuick.Layouts 1.2.

См. также margins.

Layout.row : целое

Это свойство позволяет задать позицию строки элемента в GridLayout.

Если оба column и это свойство не установлены, макет сам должен назначить ячейку элементу.

Значение по умолчанию — 0.

См. также column и rowSpan.

Layout.rowSpan : целое

Это свойство позволяет задать интервал строк элемента в GridLayout.

Значение по умолчанию — 1.

См. также columnSpan и row.

[с QtQuick.Layouts 1.2] Layout.topMargin : вещественное

Указывает верхний отступ вне элемента. Если значение не установлено, используется значение из margins.

Это свойство было добавлено в QtQuick.Layouts 1.2.

См. также margins.