ScrollBar QML Type

An interactive scroll bar control. More...

Import Statement: import Qt.labs.controls 1.0
Inherits:

Control

Properties

Attached Properties

Detailed Description

ScrollBar is an interactive bar that can be used to scroll to a specific position. A scroll bar can be either vertical or horizontal, and can be attached to any Flickable, such as ListView and GridView.

Flickable {
    // ...
    ScrollBar.vertical: ScrollBar { }
}

Note: When ScrollBar is attached vertically or horizontally to a Flickable, its geometry and the following properties are automatically set and updated as appropriate:

Note: Types in the Qt.labs module are not guaranteed to remain compatible in future versions.

See also ScrollIndicator, Customizing ScrollBar, and Indicator Controls.

Property Documentation

active : bool

This property holds whether the scroll bar is active ie. when its pressed or the attached Flickable is moving.


handle : Item

This property holds the handle item.

See also Customizing ScrollBar.


orientation : enumeration

This property holds the orientation of the scroll bar.

Possible values:

ConstantDescription
Qt.HorizontalHorizontal
Qt.VerticalVertical (default)

position : real

This property holds the position of the scroll bar, scaled to 0.0 - 1.0.

See also Flickable::visibleArea.


pressed : bool

This property holds whether the scroll bar is pressed.


size : real

This property holds the size of the scroll bar, scaled to 0.0 - 1.0.

See also Flickable::visibleArea.


Attached Property Documentation

ScrollBar.horizontal : ScrollBar

This property attaches a horizontal scroll bar to a Flickable.

Flickable {
    contentWidth: 2000
    ScrollBar.horizontal: ScrollBar { }
}

ScrollBar.vertical : ScrollBar

This property attaches a vertical scroll bar to a Flickable.

Flickable {
    contentHeight: 2000
    ScrollBar.vertical: ScrollBar { }
}

© 2017 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.