ItemModelSurfaceDataProxy QML Type
Surface3D を使用してアイテムモデル内のデータを表示するためのプロキシクラス。詳細...
| Import Statement: | import QtDataVisualization 1.12 |
| Since: | QtDataVisualization 1.0 |
| In C++: | QItemModelSurfaceDataProxy |
| Inherits: | |
| Status: | Deprecated |
この型は非推奨です。新しいコードでの使用は強く推奨しません。
プロパティ
- 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
詳細な説明
このタイプを使用すると、AbstractItemModel から派生したモデルを、Surface3D のデータソースとして使用できます。
マッピングまたはモデルが変更されるたびに、データは非同期的に解決されます。
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座標にマッピングするためのアイテムモデルのロール。このロールが定義されていない場合、columnRole が使用され、解決されたQSurfaceDataItem アイテムのX座標値が決定されます。
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も参照してください 。
© 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.