Тип QML SwipeView

Позволяет пользователю переходить между страницами, пропуская их вбок. Подробнее...

Заявление об импорте:	import QtQuick.Controls 2.4
С момента:	Qt 5.7
Наследует:	Container

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

Свойства

horizontal : bool
interactive : bool
orientation : перечисление
vertical : bool

Прикреплённые свойства

index : int
isCurrentItem : bool
isNextItem : bool
isPreviousItem : bool
view : SwipeView

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

SwipeView предоставляет модель навигации на основе свайпа.

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

SwipeView {
    id: view

    currentIndex: 1
    anchors.fill: parent

    Item {
        id: firstPage
    }
    Item {
        id: secondPage
    }
    Item {
        id: thirdPage
    }
}

PageIndicator {
    id: indicator

    count: view.count
    currentIndex: view.currentIndex

    anchors.bottom: view.bottom
    anchors.horizontalCenter: parent.horizontalCenter
}

Как показано выше, SwipeView обычно заполняется набором статических страниц, определённых непосредственно в виде дочерних элементов представления. Также можно добавлять, вставлять, перемещать и удалять страницы динамически во время выполнения.

В целом не рекомендуется добавлять чрезмерное количество страниц в SwipeView. Однако, когда количество страниц увеличивается, или отдельные страницы относительно сложные, может потребоваться освободить ресурсы, загрузив страницы, которые находятся за пределами досягаемости. Следующий пример показывает, как использовать Loader, чтобы поддерживать максимальное количество трёх страниц, одновременно загруженных.

SwipeView {
    Repeater {
        model: 6
        Loader {
            active: SwipeView.isCurrentItem || SwipeView.isNextItem || SwipeView.isPreviousItem
            sourceComponent: Text {
                text: index
                Component.onCompleted: console.log("created:", index)
                Component.onDestruction: console.log("destroyed:", index)
            }
        }
    }
}

Примечание: SwipeView берет на себя управление геометрией элементов, добавленных в представление. Использование якорей на элементах не поддерживается, и любые width или height присваивания будут переопределены представлением. Обратите внимание, что это относится только к корню элемента. Установка ширины и высоты или использование якорей для его дочерних элементов работает как ожидается.

См. также TabBar, PageIndicator, Настройка SwipeView, Навигационные элементы управления, Элементы управления контейнерами и Управление фокусом в Qt Quick Controls 2.

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

[только для чтения] horizontal : bool

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

Это свойство было введено в QtQuick.Controls 2.3 (Qt 5.10).

См. также orientation.

interactive : bool

Это свойство описывает, может ли пользователь взаимодействовать с SwipeView. Пользователь не может пролистывать представление, которое не является интерактивным.

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

Это свойство было введено в QtQuick.Controls 2.1 (Qt 5.8).

orientation : перечисление

Это свойство содержит ориентацию.

Возможные значения:

Константа	Описание
`Qt.Horizontal`	Горизонтальная (по умолчанию)
`Qt.Vertical`	Вертикальная

Это свойство было введено в QtQuick.Controls 2.2 (Qt 5.9).

См. также horizontal и vertical.

[только для чтения] vertical : bool

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

Это свойство было введено в QtQuick.Controls 2.3 (Qt 5.10).

См. также orientation.