Тип QML SwipeView

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

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

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

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