Тип SwipeView QML

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

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