Тип QML ScrollView

Обеспечивает прокручиваемый вид внутри другого элемента. Подробнее...

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

Свойства

• contentItem : Элемент
• flickableItem : Элемент
• frameVisible : bool
• highlightOnFocus : bool
• horizontalScrollBarPolicy : перечисление
• style : Компонент
• verticalScrollBarPolicy : перечисление
• viewport : Элемент

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

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

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

Пример:

ScrollView {
    Image { source: "largeImage.png" }
}

В предыдущем примере элемент Image неявно получит поведение прокрутки так, как будто он используется в Flickable. Ширина и высота дочернего элемента будут использоваться для определения размера области содержимого.

Пример:

ScrollView {
    ListView {
        ...
    }
}

В этом случае размер содержимого ScrollView просто будет соответствовать размеру содержащегося flickableItem.

Вы можете создать пользовательский вид ScrollView, назначив ScrollViewStyle.

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

[default] contentItem : Элемент

Элемент содержимого ScrollView. Это устанавливается пользователем.

Обратите внимание, что определение contentItem несколько отличается от Flickable, где contentItem создается неявно.

[только для чтения] flickableItem : Элемент

flickableItem ScrollView. Если contentItem, предоставленный ScrollView, является Flickable, он будет являться contentItem.

frameVisible : bool

Это свойство сообщает ScrollView, следует ли отображать рамку вокруг содержимого.

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

highlightOnFocus : bool

Это свойство контролирует, должна ли быть выделенная рамка вокруг рамки, когда ScrollView получает фокус.

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

Примечание: Это свойство применимо только на некоторых платформах, таких как macOS.

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

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

• Qt.ScrollBarAsNeeded
• Qt.ScrollBarAlwaysOff
• Qt.ScrollBarAlwaysOn

Политика по умолчанию — Qt.ScrollBarAsNeeded.

Это свойство было введено в QtQuick.Controls 1.3.

style : Компонент

Компонент стиля для этого элемента управления.

См. также Типы QML стилей Qt Quick Controls 1.

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

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

• Qt.ScrollBarAsNeeded
• Qt.ScrollBarAlwaysOff
• Qt.ScrollBarAlwaysOn

Политика по умолчанию — Qt.ScrollBarAsNeeded.

Это свойство было введено в QtQuick.Controls 1.3.

viewport : Элемент

Viewport определяет текущее "окно" на contentItem. Другими словами, он его обрезает, и размер viewport указывает, какая часть области содержимого видима.