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

Это свойство содержит значение, определяющее, является ли прокрутка по представлению горизонтальной.

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

Это свойство содержит значение, определяющее, является ли прокрутка по представлению вертикальной.

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