DelegateModel QML Type

デリゲートは、ビューによってインスタンス化された各項目を定義するテンプレートを提供します。インデックスは、アクセス可能なindex プロパティとして公開されます。データモデルの種類に応じて、モデルのプロパティも利用可能です。

このプロパティは、デリゲートモデルをフィルタリングするために使用されるグループの名前を保持します。

このグループに属する項目のみがビューに表示されます。

デフォルトでは、これはitems グループです。

このプロパティは、デリゲートモデルのグループ定義を保持します。

グループは、デリゲートモデル内のアイテムのサブセットを定義し、モデルをフィルタリングするために使用することができます。

DelegateModel で定義されたすべてのグループに対して、2つの付属の擬似プロパティが各デリゲート項目に追加されます。最初のDelegateModel.inGroupNameは、そのアイテムがグループに属しているかどうかを保持し、2 番目のDelegateModel.groupNameIndexは、そのグループ内のアイテムのインデックスを保持します。

以下の例では、モデル内の項目を選択するためにグループを使用しています。

import QtQuick
import QtQml.Models

Rectangle {
    width: 200; height: 100

    DelegateModel {
        id: visualModel
        model: ListModel {
            ListElement { name: "Apple" }
            ListElement { name: "Orange" }
        }

        groups: [
            DelegateModelGroup { name: "selected" }
        ]

        delegate: Rectangle {
            id: item
            height: 25
            width: 200
            Text {
                text: {
                    var text = "Name: " + name
                    if (item.DelegateModel.inSelected)
                        text += " (" + item.DelegateModel.selectedIndex + ")"
                    return text;
                }
            }
            MouseArea {
                anchors.fill: parent
                onClicked: item.DelegateModel.inSelected = !item.DelegateModel.inSelected
            }
        }
    }

    ListView {
        anchors.fill: parent
        model: visualModel
    }
}

delegate: Rectangle {
    DelegateModel.inSelected: true
}

このプロパティは、すべての新しいアイテムが追加されるデフォルトグループを保持します。

このプロパティは、DelegateModel のデータを提供するモデルを保持します。

モデルは、ビューの項目を作成するために使用されるデータのセットを提供します。大きなデータセットや動的なデータセットの場合、モデルは通常 C++ モデル・オブジェクトによって提供されます。C++モデル・オブジェクトは、QAbstractItemModel のサブクラスか、単純なリストでなければなりません。

モデルは、例えばListModel を使ってQMLで直接作成することもできます。

データ・モデル」も参照してください 。

parts プロパティは、指定されたパートからデリゲートを作成するDelegateModel を選択します。これはPackage タイプと組み合わせて使用します。

例えば、以下のコードは、Package からlistという名前のデリゲートを作成するモデルを選択します：

DelegateModel {
    id: visualModel
    delegate: Package {
        Item { Package.name: "list" }
    }
    model: myModel
}

ListView {
    width: 200; height:200
    model: visualModel.parts.list
}

Packageも参照して ください。

このプロパティは、デリゲートモデルの永続化アイテムグループを保持します。

このグループのアイテムは、ビューによって解放されても破棄されません。

DelegateModelinPersistedItems プロパティを false に設定することで、アイテムを persistedItems グループから削除することができます。その時、アイテムがビューによって参照されていなければ、破棄されます。このグループに項目を追加しても、新しいインスタンスは作成されません。

QtQml.Models::DelegateModelGroup::create() 関数によって返されたアイテムは、自動的にこのグループに追加されます。

QAbstractItemModel rootIndex 、 の任意のノードの子ノードをこのモデルから提供することができます。QAbstractItemModel

このプロパティは、QAbstractItemModel 型のモデルのうち、階層的なモデル（例えば、ツリーモデル）にのみ影響します。

例えば、簡単な対話型ファイルシステム・ブラウザを示します。ディレクトリ名がクリックされると、ビューのrootIndex がクリックされたディレクトリのQModelIndex ノードに設定され、新しいディレクトリの内容が表示されるようにビューが更新されます。

main.cpp:

int main(int argc, char ** argv)
{
    QApplication app(argc, argv);

    QQuickView view;

    QFileSystemModel model;
    view.rootContext()->setContextProperty("fileSystemModel", &model);

    view.setSource(QUrl::fromLocalFile("view.qml"));
    view.show();

    return app.exec();
}

view.qml:

import QtQuick
import QtQml.Models

ListView {
    id: view
    width: 300
    height: 400

    model: DelegateModel {
        model: fileSystemModel

        delegate: Rectangle {
            width: 200; height: 25
            Text { text: filePath }

            MouseArea {
                anchors.fill: parent
                onClicked: {
                    if (model.hasModelChildren)
                        view.model.rootIndex = view.model.modelIndex(index)
                }
            }
        }
    }
}

model がQAbstractItemModel のサブクラスである場合、デリゲートは、デリゲートのモデルアイテムに子ノードがあるかどうかを示すhasModelChildren プロパティ（オプションでmodel.prefix で修飾）を参照することもできます。

modelIndex() およびparentModelIndex()も参照してください 。

この Attached プロパティは、そのアイテムが属する DelegateModelGroups の名前を保持します。

このプロパティは、デリゲートの各インスタンスにアタッチされます。

この Attached プロパティは、アイテムがデフォルトのitems DelegateModelGroup に属しているかどうかを保持します。

このプロパティを変更すると、アイテム グループにアイテムが追加または削除されます。

このプロパティは、デリゲートの各インスタンスにアタッチされます。

このアタッチされたプロパティは、アイテムがpersistedItems DelegateModelGroup に属しているかどうかを保持します。

このプロパティを変更すると、アイテム グループからアイテムが追加または削除されます。persistedItems グループからアイテムを削除すると、モデルによって参照されていない場合、現在のインスタンスが破壊されるので、注意して変更してください。

このプロパティはデリゲートの各インスタンスにアタッチされます。

このアタッチされたプロパティは、ビジュアルアイテムがデータモデルインデックスにバインドされているかどうかを示します。アイテムがモデルにバインドされていない場合はtrueを返し、バインドされている場合はfalseを返します。

未解決のアイテムは、DelegateModelGroup::resolve （）関数を使用してデータモデルにバインドすることができます。

これは、デリゲートの各インスタンスにアタッチされます。

このアタッチされたプロパティは、デフォルトのitems DelegateModelGroup における項目のインデックスを保持します。

デリゲートの各インスタンスにアタッチされます。

このアタッチされたプロパティは、このデリゲートのインスタンスが属するデータモデルを保持します。

これは、デリゲートの各インスタンスにアタッチされます。

このアタッチされたプロパティは、persistedItems DelegateModelGroup の項目のインデックスを保持します。

これは、デリゲートの各インスタンスにアタッチされます。

QAbstractItemModel QMLはリストデータのみを扱うのに対して、この関数は階層的なツリーデータを提供します。この関数はQMLでツリーモデルを使用する際に役立ちます。

指定されたindex に対するQModelIndex を返します。この値はrootIndex に代入することができます。

rootIndexも参照してください 。

QAbstractItemModel QMLはリストデータのみを扱うのに対して、この関数はデータの階層的なツリー を提供します。この関数はQMLでツリーモデルを使用する際に役立ちます。

現在のrootIndex の親のQModelIndex を返す。この値はrootIndex に代入することができます。

rootIndexも参照してください 。