Тип QML SwipeView

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

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

Свойства

• 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)
            }
        }
    }
}

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

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

[только чтение, с QtQuick.Controls 2.3 (Qt 5.10)] horizontal : bool

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

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

См. также orientation.

[с QtQuick.Controls 2.1 (Qt 5.8)] interactive : bool

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

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

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

[с QtQuick.Controls 2.2 (Qt 5.9)] orientation : перечисление

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

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

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

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

[только чтение, с QtQuick.Controls 2.3 (Qt 5.10)] vertical : bool

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

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

См. также orientation.

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

[только чтение] SwipeView.index : int

Это присоединённое свойство содержит индекс каждого дочернего элемента в SwipeView.

Он присоединён к каждому дочернему элементу SwipeView.

[только чтение] SwipeView.isCurrentItem : bool

Это присоединённое свойство равно true если этот дочерний элемент является текущим элементом.

Он присоединён к каждому дочернему элементу SwipeView.

[только чтение, с QtQuick.Controls 2.1 (Qt 5.8)] SwipeView.isNextItem : bool

Это присоединённое свойство равно true если этот дочерний элемент — следующий.

Он присоединён к каждому дочернему элементу SwipeView.

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

[только чтение, с QtQuick.Controls 2.1 (Qt 5.8)] SwipeView.isPreviousItem : bool

Это присоединённое свойство равно true если этот дочерний элемент — предыдущий.

Он присоединён к каждому дочернему элементу SwipeView.

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

[только чтение] SwipeView.view : SwipeView

Это присоединённое свойство содержит представление, которое управляет этим дочерним элементом.

Он присоединён к каждому дочернему элементу SwipeView.