Back to Qt.io
Contact Us Blog Download Qt

ItemModelSurfaceDataProxy QML Type

アイテムモデルのデータをSurface3D で表示するためのプロキシ・クラスです。詳細...

Import Statement: import QtDataVisualization 1.8
Since: QtDataVisualization 1.0
In C++: QItemModelSurfaceDataProxy
Inherits:

SurfaceDataProxy

プロパティ

詳細説明

この型を使用すると、Surface3D のデータソースとしてAbstractItemModel 派生モデルを使用できます。

マッピングやモデルが変更されるたびに、非同期にデータが解決されます。

ItemModelSurfaceDataProxy 列挙型については、QItemModelSurfaceDataProxy::MultiMatchBehavior を参照してください。

詳細はQItemModelSurfaceDataProxy ドキュメントを参照してください。

使用例：

ItemModelSurfaceDataProxy {
    itemModel: model // E.g. a list model defined elsewhere containing population data.
    // Mapping model roles to surface series rows, columns, and values.
    rowRole: "longitude"
    columnRole: "latitude"
    valueRole: "pop_density"
}

SurfaceDataProxy およびQt Data Visualization データ処理も参照してください 。

プロパティのドキュメント

autoColumnCategories : bool

true に設定すると、モデルからのデータが解決されるたびに、マッピングは明示的に設定された列カテゴリを無視し、自動生成されたもので上書きします。また、true に設定すると、列のプロキシ最小値と最大値もデータから自動生成されます。デフォルトはtrue です。


autoRowCategories : bool

true に設定すると、モデルからのデータが解決されるたびに、マッピングは明示的に設定された行カテゴリを無視し、自動生成されたもので上書きします。また、true に設定すると、プロキシ最小行値とプロキシ最大行値がデータから自動生成されます。デフォルトはtrue 。


columnCategories : list<String>

マッピングの列カテゴリ。データが解決される際には、このリストにある列の役割を持つ項目のみが含まれます。列は、このリストにあるのと同じ順序で並べられます。


columnRole : string

列カテゴリにマッピングする項目モデル・ロール。データがどの列に属するかを定義するだけでなく、列ロールによって示される値は、別のx位置ロールも定義されていない限り、モデルデータが解決されるときにQSurfaceDataItem のX座標値としても設定されます。


columnRolePattern : regExp

設定されると、列カテゴリとして使用される前に、列ロールによってマップされた値に対して検索と置換が行われます。このプロパティは、マップされた値の置換する部分を検索する正規表現を指定し、columnRoleReplace プロパティは置換文字列を含みます。

columnRole およびcolumnRoleReplaceも参照してください 。


columnRoleReplace : string

columnRolePattern と組み合わせて使用する置換内容です。デフォルトは空文字列です。正規表現による検索と置換の動作の詳細については、QString::replace(constQRegularExpression &rx, constQString &after)関数のドキュメントを参照してください。

columnRole およびcolumnRolePatternも参照して ください。


itemModel : model

Surface3D のデータソースとして使用される項目モデル。


multiMatchBehavior : ItemModelSurfaceDataProxy.MultiMatchBehavior

各行/列の組み合わせに対する複数の一致の処理方法を定義します。デフォルトはItemModelSurfaceDataProxy.MMBLast です。

例えば、不規則な間隔で取得されたタイムスタンプ付きデータを持つ項目モデルがあり、各時間におけるデータ項目の平均位置をサーフェスグラフで可視化したいとします。これは、各表面点が 1 時間を表すように行と列のカテゴリを指定し、multiMatchBehavior をItemModelSurfaceDataProxy.MMBAverage に設定することで実現できます。


rowCategories : list<String>

マッピングの行カテゴリ。このリストにある行の役割を持つ項目のみが、データ解決時に含まれます。行は、このリストにあるのと同じ順序で並べられます。


rowRole : string

行カテゴリにマッピングする項目モデル・ロール。データがどの行に属するかを定義するだけでなく、別のZ位置ロールも定義されていない限り、モデルデータが解決されるときに、行ロールが示す値がQSurfaceDataItem のZ座標値としても設定されます。


rowRolePattern : regExp

設定されると、行カテゴリとして使用される前に、行ロールによってマップされた値に対して検索と置換が行われます。このプロパティは、マップされた値の置換する部分を見つけるための正規表現を指定し、rowRoleReplace プロパティには置換文字列が含まれます。

rowRole とrowRoleReplaceも参照してください 。


rowRoleReplace : string

rowRolePattern と組み合わせて使用する置換内容。デフォルトは空文字列です。正規表現による検索と置換の動作の詳細については、QString::replace(constQRegularExpression &rx, constQString &after)関数のドキュメントを参照してください。

rowRole およびrowRolePatternも参照してください 。


useModelCategories : bool

true に設定すると、マッピングは行と列のロールとカテゴリを無視し、代わりにモデルの行と列を使用します。デフォルトはfalse です。


xPosRole : string

X位置にマッピングする項目モデルのロール。このロールが定義されていない場合、解決されたQSurfaceDataItem アイテムの X 座標値を決定するためにcolumnRole が使用されます。


xPosRolePattern : regExp

設定されている場合、アイテム位置値として使用される前に、X位置ロールによってマップされた値に対して検索と置換が行われる。このプロパティは、マップされた値の置換する部分を見つけるための正規表現を指定し、xPosRoleReplace プロパティには置換文字列が格納されます。

xPosRole とxPosRoleReplaceも参照のこと 。


xPosRoleReplace : string

xPosRolePattern と組み合わせて使用する置換内容。デフォルトは空文字列です。正規表現による検索と置換の動作の詳細については、QString::replace(constQRegularExpression &rx, constQString &after)関数のドキュメントを参照してください。

xPosRole およびxPosRolePatternも参照して ください。


yPosRole : string

Y位置にマップするアイテムモデルロール。


yPosRolePattern : regExp

このプロパティを設定すると、Y位置ロールにマップされた値がアイテム位置値として使用される前に、検索と置換が行われます。このプロパティには、マップされた値の置換する部分を検索する正規表現が指定され、yPosRoleReplace プロパティには置換文字列が指定されます。

yPosRole およびyPosRoleReplaceも参照のこと 。


yPosRoleReplace : string

yPosRolePattern と組み合わせて使用する置換内容。デフォルトは空文字列です。正規表現による検索と置換の動作の詳細については、QString::replace(constQRegularExpression &rx, constQString &after)関数のドキュメントを参照してください。

yPosRole およびyPosRolePatternも参照して ください。


zPosRole : string

Z位置にマップする項目モデルの役割。このロールが定義されていない場合、rowRole は、解決されたQSurfaceDataItem アイテムの Z 座標値を決定するために使用されます。


zPosRolePattern : regExp

設定されている場合、アイテム位置値として使用される前に、Z位置ロールによってマップされた値に対して検索と置換が行われる。このプロパティは、マップされた値の置換する部分を見つけるための正規表現を指定し、zPosRoleReplace プロパティには置換文字列が格納されます。

zPosRole およびzPosRoleReplaceも参照のこと 。


zPosRoleReplace : string

zPosRolePattern と組み合わせて使用する置換内容。デフォルトは空文字列です。正規表現による検索と置換の動作の詳細については、QString::replace(constQRegularExpression &rx, constQString &after)関数のドキュメントを参照してください。

zPosRole およびzPosRolePatternも参照して ください。


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.