Тип QML SwipeView

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

Заявление об импорте:	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

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

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

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

См. также orientation.