Тип QML ScrollView

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

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

Свойства

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

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

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

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

Пример:

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

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

Пример:

ScrollView {
    ListView {
        ...
    }
}

В этом случае размер содержимого ScrollView просто скопирует размер его содержащего элемента flickableItem.

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

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

[по умолчанию] contentItem : Item

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

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

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

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

frameVisible : bool

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

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

highlightOnFocus : bool

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

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

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

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

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

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

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

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

style : Component

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

См. также Типы QML Qt Quick Controls Styles.

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

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

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

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

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

viewport : Item

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