Тип 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)
            }
        }
    }
}

Примечание: SwipeView принимает на себя управление геометрией элементов, добавленных в представление. Использование якорей на элементах не поддерживается, и любые width или height назначения будут перезаписаны представлением. Обратите внимание, что это относится только к корню элемента. Установка ширины и высоты или использование якорей для его дочерних элементов работает как ожидается.

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

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

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

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

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

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