Тип QML макета

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

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

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

• alignment : Qt.Alignment
• bottomMargin : вещественное
• column : целое число
• columnSpan : целое число
• fillHeight : логическое
• fillWidth : логическое
• leftMargin : вещественное
• margins : вещественное
• maximumHeight : вещественное
• maximumWidth : вещественное
• minimumHeight : вещественное
• minimumWidth : вещественное
• preferredHeight : вещественное
• preferredWidth : вещественное
• rightMargin : вещественное
• row : целое число
• rowSpan : целое число
• topMargin : вещественное

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

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

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

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

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

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

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

См. также 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 : вещественное

Устанавливает нижний отступ вне элемента. Если значение не задано, используется значение из margins.

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

См. также margins.

Layout.column : целое число

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

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

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

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

Layout.columnSpan : целое число

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

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

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

Layout.fillHeight : логическое

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

См. также fillWidth.

Layout.fillWidth : логическое

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

См. также fillHeight.

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

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

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

См. также margins.

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

Устанавливает одинаковые отступы (маржины) вокруг элемента. Сам элемент не вычисляет свои отступы. Родительский элемент отвечает за их вычисление.

Конкретно, отступы вычисляются только 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.