Tumbler

A control that can have several spinnable wheels, each with items that can be selected. More...

Import Statement:	import QtQuick.Extras 1.4
Since:	Qt 5.5

List of all members, including inherited members

Properties

columnCount : int
style : Component

Methods

TumblerColumn addColumn(TumblerColumn column)
int currentIndexAt(int columnIndex)
TumblerColumn getColumn(int columnIndex)
TumblerColumn insertColumn(int index, TumblerColumn column)
void setCurrentIndexAt(int columnIndex, int itemIndex, int interval)

Detailed Description

A Tumbler

Note: Tumbler requires Qt 5.5.0 or later.

The Tumbler control is used with one or more TumblerColumn items, which define the content of each column:

Tumbler {
    TumblerColumn {
        model: 5
    }
    TumblerColumn {
        model: [0, 1, 2, 3, 4]
    }
    TumblerColumn {
        model: ["A", "B", "C", "D", "E"]
    }
}

You can also use a traditional model with roles:

Rectangle {
    width: 220
    height: 350
    color: "#494d53"

    ListModel {
        id: listModel

        ListElement {
            foo: "A"
            bar: "B"
            baz: "C"
        }
        ListElement {
            foo: "A"
            bar: "B"
            baz: "C"
        }
        ListElement {
            foo: "A"
            bar: "B"
            baz: "C"
        }
    }

    Tumbler {
        anchors.centerIn: parent

        TumblerColumn {
            model: listModel
            role: "foo"
        }
        TumblerColumn {
            model: listModel
            role: "bar"
        }
        TumblerColumn {
            model: listModel
            role: "baz"
        }
    }
}

Limitations

For technical reasons, the model count must be equal to or greater than visibleItemCount plus one. The visibleItemCount must also be an odd number.

You can create a custom appearance for a Tumbler by assigning a TumblerStyle. To style individual columns, use the delegate and highlight properties of TumblerColumn.

Property Documentation

[read-only] columnCount : int

The number of columns in the Tumbler.

style : Component

Method Documentation

TumblerColumn addColumn(TumblerColumn column)

Adds a column and returns the added column.

The column argument can be an instance of TumblerColumn, or a Component. The component has to contain a TumblerColumn. Otherwise null is returned.

int currentIndexAt(int columnIndex)

Returns the current index of the column at columnIndex, or null if the index is invalid.

See also setCurrentIndexAt().

TumblerColumn getColumn(int columnIndex)

Returns the column at columnIndex or null if the index is invalid.

TumblerColumn insertColumn(int index, TumblerColumn column)

Inserts a column at the given index and returns the inserted column.

The column argument can be an instance of TumblerColumn, or a Component. The component has to contain a TumblerColumn. Otherwise, null is returned.

void setCurrentIndexAt(int columnIndex, int itemIndex, int interval)

Sets the current index of the column at columnIndex to itemIndex. The animation length can be set with interval, which defaults to 0.

Does nothing if columnIndex or itemIndex are invalid.

See also currentIndexAt().

Contents