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

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

[по умолчанию] contentItem : Элемент

contentItem ScrollView. Это задается пользователем.

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

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

flickableItem ScrollView. Если предоставленный в ScrollView contentItem — это 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 указывает, сколько области содержимого отображается.