Тип QML ScrollView

Прокручиваемое представление. Подробнее...

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

Свойства

• contentChildren : список<Элемент>
• contentData : список<Объект>
• contentHeight : вещественное число
• contentWidth : вещественное число

Подробное описание

ScrollView обеспечивает прокрутку для пользовательского контента. Его можно использовать для замены Flickable или для оформления существующего.

Первый пример демонстрирует самое простое использование ScrollView.

ScrollView {
    width: 200
    height: 200
    clip: true

    Label {
        text: "ABC"
        font.pixelSize: 224
    }
}

Примечание: ScrollView не автоматически обрезает свой контент. Если он не используется как элемент всего экрана, следует рассмотреть установку свойства clip в true, как показано выше.

Второй пример иллюстрирует использование существующего Flickable, то есть ListView.

ScrollView {
    width: 200
    height: 200

    ListView {
        model: 20
        delegate: ItemDelegate {
            text: "Item " + index
        }
    }
}

Скролл-бары

К горизонтальному и вертикальному скролл-барам можно получить доступ и настроить их с помощью присоединённых свойств ScrollBar.horizontal и ScrollBar.vertical. В следующем примере настраиваются политики скролл-баров таким образом, чтобы горизонтальный скролл-бар всегда был скрыт, а вертикальный — всегда отображался.

ScrollView {
    // ...
    ScrollBar.horizontal.policy: ScrollBar.AlwaysOff
    ScrollBar.vertical.policy: ScrollBar.AlwaysOn
}

Взаимодействие с сенсорным экраном и мышью

При взаимодействии с сенсорным экраном ScrollView включает прокрутку с отскоком и делает скролл-бары неинтерактивными.

При взаимодействии с устройством мыши прокрутка с отскоком отключается, а скролл-бары становятся интерактивными.

Скролл-бары можно сделать интерактивными при взаимодействии с сенсорным экраном или неинтерактивными при взаимодействии с устройством мыши, явно установив свойство interactive соответственно в true или false.

ScrollView {
    // ...
    ScrollBar.horizontal.interactive: true
    ScrollBar.vertical.interactive: true
}

См. также ScrollBar, ScrollIndicator, Настройка ScrollView и Контейнерные элементы управления.

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

contentChildren : список<Элемент>

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

Список содержит все элементы, объявленные в QML в качестве дочерних элементов представления.

Примечание: В отличие от contentData, contentChildren не включает невидимые QML-объекты.

См. также Элемент::children и contentData.

[по умолчанию] contentData : список<Объект>

Это свойство содержит список данных содержимого.

Список содержит все объекты, объявленные в QML в качестве дочерних элементов представления.

Примечание: В отличие от contentChildren, contentData включает невидимые QML-объекты.

См. также Элемент::data и contentChildren.

contentHeight : вещественное число

Это свойство содержит высоту прокручиваемого содержимого.

Если в ScrollView используется только один элемент, размер содержимого автоматически вычисляется на основе неявного размера содержащегося элемента.

См. также contentWidth.

contentWidth : вещественное число

Это свойство содержит ширину прокручиваемого содержимого.

Если в ScrollView используется только один элемент, размер содержимого автоматически вычисляется на основе неявного размера содержащегося элемента.

См. также contentHeight.