Qt 5.6 | Qt Labs Controls | QML Types | Tumbler QML Type

Qt 5.6.3 Reference Documentation

# Tumbler QML Type

A spinnable wheel of items that can be selected. More...

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

- List of all members, including inherited members

## Properties

- count : int
- currentIndex : int
- currentItem : Item
- delegate : component
- model : variant
- visibleItemCount : int

## Detailed Description

      Tumbler {
          model: 5
          // ...
      }

## Non-wrapping Tumbler

The default contentItem of Tumbler is a PathView, which wraps when it reaches the top and bottom. To achieve a non-wrapping Tumbler, use ListView as the contentItem:

      Tumbler {
          id: listViewTumbler

          contentItem: ListView {
              anchors.fill: parent
              model: listViewTumbler.model
              delegate: listViewTumbler.delegate

              snapMode: ListView.SnapToItem
              highlightRangeMode: ListView.StrictlyEnforceRange
              preferredHighlightBegin: height / 2 - (height / listViewTumbler.visibleItemCount / 2)
              preferredHighlightEnd: height / 2  + (height / listViewTumbler.visibleItemCount / 2)
              clip: true
          }
      }

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

See also Customizing Tumbler and Input Controls.

## Property Documentation

[read-only] count : int

This property holds the number of items in the model.

currentIndex : int

This property holds the index of the current item.

[read-only] currentItem : Item

This property holds the item at the current index.

delegate : component

This property holds the delegate used to display each item.

model : variant

This property holds the model that provides data for this tumbler.

visibleItemCount : int

This property holds the number of items visible in the tumbler. It must be an odd number, as the current item is always vertically centered.