ScrollBar QML Type

An interactive scroll bar control. More...

• List of all members, including inherited members

Properties

• active : bool
• orientation : enumeration
• position : real
• pressed : bool
• size : real
• stepSize : real

Attached Properties

• horizontal : ScrollBar
• vertical : ScrollBar

Methods

• void decrease()
• void increase()

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:

• orientation
• position
• size
• active

Notice that ScrollBar does not filter key events of the Flickable it is attached to. The following example illustrates how to implement scrolling with up and down keys:

  Flickable {
      focus: true

      Keys.onUpPressed: scrollBar.decrease()
      Keys.onDownPressed: scrollBar.increase()

      ScrollBar.vertical: ScrollBar { id: scrollBar }
  }

Horizontal and vertical scroll bars do not share the active state with each other by default. In order to keep both bars visible whilst scrolling to either direction, establish a two-way binding between the active states as presented by the following example:

  Flickable {
      anchors.fill: parent

      contentWidth: parent.width * 2
      contentHeight: parent.height * 2

      ScrollBar.horizontal: ScrollBar { id: hbar; active: vbar.active }
      ScrollBar.vertical: ScrollBar { id: vbar; active: hbar.active }
  }

See also ScrollIndicator, Customizing ScrollBar, and Indicator Controls.

Property Documentation

Attached Property Documentation

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

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

Method Documentation