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

См. также 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 : real

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

Это свойство QML было добавлено в 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.

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

См. также margins.

Layout.margins : real

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

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

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

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

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

Это свойство QML было добавлено в 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.

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

См. также margins.

Layout.row : int

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

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

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

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

Layout.rowSpan : int

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

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

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

Layout.topMargin : real

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

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

См. также margins.