Тип QML макета

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

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.

Layout.leftMargin : real

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

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

См. также margins.

Layout.margins : real

Устанавливает поля вне элемента, все имеющие одинаковое значение. Сам элемент не оценивает свои поля. Родитель отвечает за то, хочет ли он их оценивать.

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

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

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

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

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

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

Layout.maximumHeight : real

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

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

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

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

Layout.maximumWidth : real

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

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

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

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

Layout.minimumHeight : real

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

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

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

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

Layout.minimumWidth : real

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

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

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

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

Layout.preferredHeight : real

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

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

Layout.preferredWidth : real

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

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

Layout.rightMargin : real

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

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

См. также margins.

Layout.row : int

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

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

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

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

Layout.rowSpan : int

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

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

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

Layout.topMargin : real

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

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

См. также margins.