Тип QML DelegateChooser

Позволяет представлению использовать разные делегаты для разных типов элементов в модели. Подробнее...

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

Свойства

• choices : список<DelegateChoice>
• role : строка

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

DelegateChooser — это специальный тип компонента, предназначенный для тех случаев, когда представление требует компонента и используется в качестве делегата. DelegateChooser encapsulates набор DelegateChoice. Эти варианты используются для определения делегата, который будет создан для каждого элемента модели. Выбор варианта выполняется на основе значения, которое элемент модели имеет для role, а также на основе индекса.

DelegateChooser обычно используется, когда представлению необходимо отобразить набор делегатов, которые существенно отличаются друг от друга. Например, типичное представление настроек телефона может содержать переключатели, ползунки, радиокнопки и другие визуализации в зависимости от типа каждой настройки. В этом случае DelegateChooser может предоставить простой способ связать различный тип делегата с каждой настройкой:

import QtQuick 2.15
import QtQuick.Controls 2.15
import Qt.labs.qmlmodels 1.0

ListView {
    width: 200; height: 400

    ListModel {
        id: listModel
        ListElement { type: "info"; ... }
        ListElement { type: "switch"; ... }
        ListElement { type: "swipe"; ... }
        ListElement { type: "switch"; ... }
    }

    DelegateChooser {
        id: chooser
        role: "type"
        DelegateChoice { roleValue: "info"; ItemDelegate { ... } }
        DelegateChoice { roleValue: "switch"; SwitchDelegate { ... } }
        DelegateChoice { roleValue: "swipe"; SwipeDelegate { ... } }
    }

    model: listModel
    delegate: chooser
}

Примечание: Этот тип предназначен для прозрачной работы только с TableView и любым представлением на основе DelegateModel. Представления (включая пользовательские представления), которые не основаны внутренне на DelegateModel, должны явно поддерживать этот тип компонента, чтобы он функционировал как описано.

См. также DelegateChoice.

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

[по умолчанию] choices : список<DelegateChoice>

Список DelegateChoices для выбора.

Список обрабатывается как упорядоченный список, где первый DelegateChoice, соответствующий условиям, будет использоваться представлением.

Обычно не требуется обращаться к свойству choices, так как это свойство по умолчанию для DelegateChooser, и поэтому все дочерние элементы автоматически назначаются этому свойству.

role : строка

Это свойство содержит роль или имя свойства, используемое для определения делегата для данного элемента модели.

См. также DelegateChoice.