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