ItemModelSurfaceDataProxy QML Type
アイテムモデルのデータをSurface3D で表示するためのプロキシクラスです。詳細...
| Import Statement: | import QtDataVisualization 1.11 |
| Since: | QtDataVisualization 1.0 |
| In C++: | QItemModelSurfaceDataProxy |
| Inherits: |
プロパティ
- autoColumnCategories : bool
- autoRowCategories : bool
- columnCategories : list<String>
- columnRole : string
- columnRolePattern : regExp
- columnRoleReplace : string
- itemModel : model
- multiMatchBehavior : ItemModelSurfaceDataProxy.MultiMatchBehavior
- rowCategories : list<String>
- rowRole : string
- rowRolePattern : regExp
- rowRoleReplace : string
- useModelCategories : bool
- xPosRole : string
- xPosRolePattern : regExp
- xPosRoleReplace : string
- yPosRole : string
- yPosRolePattern : regExp
- yPosRoleReplace : string
- zPosRole : string
- zPosRolePattern : regExp
- zPosRoleReplace : string
詳細説明
この型を使用すると、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位置に対応付けるアイテムモデルの役割。このロールが定義されていない場合、解決されたQSurfaceDataItem アイテムの Z 座標値を決定するためにrowRole が使用されます。
zPosRolePattern : regExp
設定されると、項目位置値として使用される前に、z 位置ロールによってマップされた値に対して検索と置換が行われる。このプロパティは、マップされた値の置換する部分を見つけるための正規表現を指定し、zPosRoleReplace プロパティには置換文字列が含まれます。
zPosRole とzPosRoleReplaceも参照してください 。
zPosRoleReplace : string
zPosRolePattern と組み合わせて使用する置換内容。デフォルトは空文字列。正規表現による検索置換の動作の詳細については、QString::replace(constQRegularExpression &rx, constQString &after) 関数のドキュメントを参照してください。
zPosRole およびzPosRolePatternも参照して ください。
© 2026 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.