Тип SwipeView QML

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

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

Свойства

• interactive : bool
• orientation : перечисление

Присоединенные свойства

• 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, Элементы управления навигацией и Элементы управления контейнерами.

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

interactive : bool

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

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

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

orientation : перечисление

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

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

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

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

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

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

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

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

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

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

[только для чтения] SwipeView.isNextItem : bool

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

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

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

[только для чтения] SwipeView.isPreviousItem : bool

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

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

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

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

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

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