Тип QML Tumbler

Элемент управления, который может содержать несколько вращаемых колес, каждое из которых имеет элементы, которые можно выбрать. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• columnCount : int
• style : Component

Методы

• 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)

Подробное описание

Примечание: Для использования Tumbler требуется Qt 5.5.0 или более поздняя версия.

Элемент управления Tumbler используется с одним или несколькими элементами TumblerColumn, которые определяют содержимое каждого столбца:

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

Вы также можете использовать традиционную модель с ролями:

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"
        }
    }
}

Ограничения

По техническим причинам количество моделей должно быть равно или больше, чем visibleItemCount плюс один. visibleItemCount также должен быть нечётным числом.

Вы можете создать пользовательский вид для Tumbler, назначив стиль TumblerStyle. Для стилизации отдельных столбцов используйте свойства delegate и highlight элемента TumblerColumn.

Документация по свойствам

[только для чтения] columnCount : int

Количество столбцов в Tumbler.

style : Component

Стиль Component для этого элемента управления.

См. также Типы QML Qt Quick Controls Styles.

Документация по методам

TumblerColumn addColumn(TumblerColumn column)

Добавляет column и возвращает добавленный столбец.

Аргумент column может быть экземпляром TumblerColumn или Component. Компонент должен содержать TumblerColumn. В противном случае возвращается null.

int currentIndexAt(int columnIndex)

Возвращает текущий индекс столбца по columnIndex или null, если индекс недействителен.

TumblerColumn getColumn(int columnIndex)

Возвращает столбец по columnIndex или null, если индекс недействителен.

TumblerColumn insertColumn(int index, TumblerColumn column)

Вставляет column в заданный index и возвращает вставленный столбец.

Аргумент column может быть экземпляром TumblerColumn или Component. Компонент должен содержать TumblerColumn. В противном случае, возвращается null.

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

Устанавливает текущий индекс столбца по columnIndex на itemIndex. Длительность анимации можно установить с помощью interval, который по умолчанию равен 0.

Ничего не делает, если columnIndex или itemIndex недействительны.