Тип 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 элементов в макете, так как это может противоречить целям Layout, а также привести к циклам привязки. Свойства 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

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 : 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.