Тип 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, размер элемента будет фиксированным и равным его предпочтительному размеру. В противном случае он будет увеличиваться или уменьшаться между минимальным и максимальным размером по мере изменения размера макета.

Примечание: Не рекомендуется использовать привязки к свойствам x, y, width или height элементов в макете, так как это противоречит целям макета и может также вызвать циклы привязки.

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

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

Layout.alignment : Qt.Alignment

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

Значение по умолчанию — 0, что означает, что он будет Qt.AlignVCenter | Qt.AlignLeft

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

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

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.

Layout.leftMargin : вещественное число

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

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

См. также margins.

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.

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

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

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

См. также margins.

Layout.row : целое

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

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

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

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

Layout.rowSpan : целое

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

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

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

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

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

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

См. также margins.