Тип QML SwipeView

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

Заявление об импорте:	import QtQuick.Controls 2.15
С момента:	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.

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

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

Это свойство содержит значение, определяющее, является ли представление Swipe View горизонтальным.

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

Это свойство содержит значение, определяющее, является ли представление Swipe View вертикальным.

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

См. также orientation.