Тип SplitView QML

Размещает элементы с перетаскиваемым разделителем между каждым элементом. Подробнее...

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

Свойства

• handleDelegate : Компонент
• orientation : int
• resizing : bool

Методы

• void addItem(Элемент item)
• void removeItem(Элемент item)

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

SplitView — это элемент управления, который размещает элементы по горизонтали или вертикали с перетаскиваемым разделителем между каждым элементом.

В SplitView всегда будет один (и только один) элемент, у которого свойство Layout.fillWidth установлено в true (или Layout.fillHeight, если ориентация — Qt.Vertical). Это означает, что элемент получит всё оставшееся пространство после размещения других элементов. По умолчанию это последнее видимое дочернее значение SplitView, но его можно изменить, явно установив fillWidth в true для другого элемента.

Поскольку размер элемента fillWidth автоматически изменяется в соответствии с дополнительным пространством, явные присваивания его свойств width и height будут игнорироваться (но Layout.minimumWidth и Layout.maximumWidth будут всё ещё учитываться). Начальные размеры других элементов должны быть заданы через свойства width и height. Любое присваивание связи свойству width или height элемента будет прервано, как только пользователь перетащит ручку разделителя этого элемента.

Ручка может относиться к элементу либо с левой/верхней стороны, либо с правой/нижней стороны:

• Если элемент fillWidth находится справа: ручка принадлежит левому элементу.
• Если элемент fillWidth находится слева: ручка принадлежит правому элементу.

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

SplitView поддерживает установку присоединённых свойств Layout для дочерних элементов, что означает, что для каждого дочернего элемента можно установить следующие присоединённые свойства:

• Layout.minimumWidth
• Layout.minimumHeight
• Layout.maximumWidth
• Layout.maximumHeight
• Layout.fillWidth (true только для одного дочернего элемента)
• Layout.fillHeight (true только для одного дочернего элемента)

Примечание: импортируйте QtQuick.Layouts 1.0 в свой файл QML, чтобы использовать присоединённые свойства Layout внутри SplitView.

Пример:

Чтобы создать SplitView с тремя элементами и позволить центральному элементу получить избыточное пространство, можно сделать следующее:

SplitView {
    anchors.fill: parent
    orientation: Qt.Horizontal

    Rectangle {
        width: 200
        Layout.maximumWidth: 400
        color: "lightblue"
        Text {
            text: "View 1"
            anchors.centerIn: parent
        }
    }
    Rectangle {
        id: centerItem
        Layout.minimumWidth: 50
        Layout.fillWidth: true
        color: "lightgray"
        Text {
            text: "View 2"
            anchors.centerIn: parent
        }
    }
    Rectangle {
        width: 200
        color: "lightgreen"
        Text {
            text: "View 3"
            anchors.centerIn: parent
        }
    }
}

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

handleDelegate : Компонент

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

orientation : int

Это свойство содержит ориентацию SplitView. Значение может быть Qt.Horizontal или Qt.Vertical. Значение по умолчанию — Qt.Horizontal.

resizing : bool

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

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

void addItem(Элемент item)

Добавляет item в конец представления.

Этот метод был введён в QtQuick.Controls 1.3.

void removeItem(Элемент item)

Удаляет item из представления.

Этот метод был введён в QtQuick.Controls 1.4.