Тип QML Layout

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

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

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

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

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

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

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

См. также margins.

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

Устанавливает отступы вне элемента со значением по умолчанию. Сам элемент не оценивает свои отступы. Родительский элемент отвечает за то, нужно ли ему оценивать отступы.

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

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

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

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

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