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

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