Тип 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 используются механизмом макета для хранения текущего размера элементов, рассчитанного из присоединённых свойств minimum/preferred/maximum, и могут перезаписываться каждый раз при расположении элементов. Используйте 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.