Тип QML Column

Располагает своих дочерние элементы в столбце. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• add : Переход
• bottomPadding : вещественное
• leftPadding : вещественное
• move : Переход
• padding : вещественное
• populate : Переход
• rightPadding : вещественное
• spacing : вещественное
• topPadding : вещественное

Сигналы

• positioningComplete()

Методы

• forceLayout()

Подробное описание

Column — тип, который располагает свои дочерние элементы вдоль одного столбца. Его можно использовать в качестве удобного способа вертикального расположения серии элементов без использования якорей.

Ниже представлен Column, содержащий три прямоугольника различных размеров:

Column {
    spacing: 2

    Rectangle { color: "red"; width: 50; height: 50 }
    Rectangle { color: "green"; width: 20; height: 50 }
    Rectangle { color: "blue"; width: 50; height: 20 }
}

Column автоматически размещает эти элементы в вертикальном порядке, как показано ниже:

Если элемент внутри Column не видим, или если у него ширина или высота равны 0, элемент не будет размещён, и он не будет виден в столбце. Кроме того, поскольку Column автоматически располагает свои дочерние элементы вертикально, дочерний элемент внутри Column не должен устанавливать своё положение по оси y или вертикально привязываться с помощью якорей top, bottom, anchors.verticalCenter, fill или centerIn. Если вам необходимо выполнить эти действия, рассмотрите размещение элементов без использования Column.

Обратите внимание, что элементы в Column могут использовать свойство Positioner для получения дополнительной информации о своем положении в Column.

Дополнительную информацию об использовании Column и других связанных типах позиционеров см. в разделе Позиционеры элементов.

Использование переходов

Column анимирует элементы, используя определённые переходы при добавлении элементов или перемещении элементов в Column.

Например, ниже представлен Column, который устанавливает свойство move для определенного Перехода:

Column {
    spacing: 2

    Rectangle { color: "red"; width: 50; height: 50 }
    Rectangle { id: greenRect; color: "green"; width: 20; height: 50 }
    Rectangle { color: "blue"; width: 50; height: 20 }

    move: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }

    focus: true
    Keys.onSpacePressed: greenRect.visible = !greenRect.visible
}

При нажатии клавиши пробела значение свойства visible зелёного Rectangle переключается. По мере появления и исчезновения синего Rectangle перемещается в пределах Column, и переход move автоматически применяется к синему Rectangle:

См. также Row, Grid, Flow, Positioner, ColumnLayout и Примеры Qt Quick — Позиционеры.

Документация свойств

add : Переход

Это свойство содержит переход, который будет выполняться для элементов, добавляемых в этот позиционер. Для позиционера это относится к:

• Элементы, которые созданы или переродированы в качестве дочерних элементов позиционера после создания позиционера
• Дочерние элементы, которые изменяют свойство Item::visible со значения false на true и, следовательно, теперь видны

Переход может использовать свойство ViewTransition для доступа к дополнительным данным об элементе, который добавляется. См. документацию ViewTransition для получения дополнительной информации и примеров использования этих переходов.

Примечание: Этот переход не применяется к элементам, которые уже являются частью позиционера во время его создания. В этом случае применяется переход populate.

См. также populate, ViewTransition и Примеры Qt Quick — Позиционеры.

bottomPadding : вещественное

Эти свойства содержат отступы вокруг содержимого.

Это свойство было введено в Qt 5.6.

leftPadding : вещественное

Эти свойства содержат отступы вокруг содержимого.

Это свойство было введено в Qt 5.6.

move : Переход

Это свойство содержит переход, который будет выполняться для элементов, перемещенных в пределах позиционера. Для позиционера это относится к:

• Дочерние элементы, которые перемещаются при смещении из-за добавления, удаления или переупорядочения других элементов в позиционере
• Дочерние элементы, которые перемещаются при изменении размера других элементов в позиционере

Переход может использовать свойство ViewTransition для доступа к дополнительным данным об элементе, который перемещается. Обратите внимание, что для данного перехода перемещения списки ViewTransition.targetIndexes и ViewTransition.targetItems устанавливаются только при срабатывании этого перехода из-за добавления других элементов в позиционер; в других случаях эти списки будут пустыми. См. документацию ViewTransition для получения дополнительной информации и примеров использования этих переходов.

Примечание: В Qt Quick 1 этот переход применялся ко всем элементам, которые были частью позиционера во время его создания. Начиная с Qt Quick 2, позиционеры вместо этого применяют переход populate к этим элементам.

См. также add, ViewTransition и Примеры Qt Quick — Позиционеры.

padding : вещественное

Эти свойства содержат отступы вокруг содержимого.

Это свойство было введено в Qt 5.6.

populate : Переход

Это свойство содержит переход, который будет выполняться для элементов, являющихся частью этого позиционера во время его создания. Переход выполняется при первом создании позиционера.

Переход может использовать свойство ViewTransition для доступа к дополнительным данным об элементе, который добавляется. См. документацию ViewTransition для получения дополнительной информации и примеров использования этих переходов.

См. также add, ViewTransition и Примеры Qt Quick — Позиционеры.

rightPadding : вещественное

Эти свойства содержат отступы вокруг содержимого.

Это свойство было введено в Qt 5.6.

spacing : вещественное

Отступ — это количество пикселей, оставленных пустым между соседними элементами. Значение отступа по умолчанию — 0.

См. также Grid::spacing.

topPadding : вещественное

Эти свойства содержат отступы вокруг содержимого.

Это свойство было введено в Qt 5.6.

Документация сигналов

positioningComplete()

Этот сигнал испускается при завершении позиционирования.

Соответствующий обработчик — onPositioningComplete.

Этот сигнал был введен в Qt 5.9.

Документация методов

forceLayout()

Column обычно позиционирует свои дочерние элементы один раз за кадр. Это означает, что внутри блоков скрипта дочерние элементы могут измениться, но Column еще не был обновлен соответствующим образом.

Этот метод заставляет Column немедленно реагировать на любые ожидающие изменения в своих дочерних элементах.

Примечание: методы, как правило, следует вызывать только после завершения компонента.

Этот метод был введен в Qt 5.9.