Back to Qt.io
Contact Us Blog Download Qt
このページでは

ItemModelSurfaceDataProxy QML Type

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

Import Statement: import QtGraphs
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 Graphs 3D によるデータ処理も参照してください 。

プロパティ ドキュメント

autoColumnCategories : bool

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

autoRowCategories : bool

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

columnCategories : list<String>

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

columnRole : string

列カテゴリにマッピングする項目モデルロール。データがどの列に属するかを定義することに加えて、列ロールによって示される値は、モデルデータが解決されるとき、QSurfaceDataItem のX座標値として設定されます。

columnRolePattern : regExp

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

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

columnRoleReplace : string

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

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

itemModel : model

Surface3D のデータソースとして使用されるアイテムモデル。

multiMatchBehavior : enumeration

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

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

rowCategories : list<String>

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

rowRole : string

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

rowRolePattern : regExp

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

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

rowRoleReplace : string

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

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

type : AbstractDataProxy.DataType [read-only]

プロキシのタイプ。QAbstractDataProxy::DataType 。

useModelCategories : bool

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

xPosRole : string

X位置に対応付けるアイテムモデルの役割。このロールが定義されていない場合、解決されたQSurfaceDataItem アイテムの X 座標値を決定するためにcolumnRole が使用されます。

xPosRolePattern : regExp

設定されると、x-positionロールによってマップされた値が項目位置値として使用される前に、検索と置換が行われる。このプロパティは、マップされた値の置換する部分を検索する正規表現を指定し、xPosRoleReplace プロパティには置換文字列が格納されます。

xPosRole とxPosRoleReplaceも参照してください 。

xPosRoleReplace : string

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

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

yPosRole : string

Yポジションにマッピングするアイテムモデルの役割。

yPosRolePattern : regExp

設定された場合、項目位置値として使用される前に、y-positionロールによってマップされた値に対して検索と置換が行われる。このプロパティは、マップされた値の置換する部分を検索する正規表現を指定し、yPosRoleReplace プロパティには置換文字列が格納されます。

yPosRole とyPosRoleReplaceも参照してください 。

yPosRoleReplace : string

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

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

zPosRole : string

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

zPosRolePattern : regExp

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

zPosRole とzPosRoleReplaceも参照してください 。

zPosRoleReplace : string

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

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

シグナルのドキュメント

autoColumnCategoriesChanged(bool enable)

このシグナルは、autoColumnCategories がenable に変更されたときに発せられる。

注： 対応するハンドラはonAutoColumnCategoriesChanged 。

autoRowCategoriesChanged(bool enable)

このシグナルは、autoRowCategories がenable に変更されたときに発せられる。

注： 対応するハンドラはonAutoRowCategoriesChanged 。

columnCategoriesChanged()

このシグナルはcolumnCategories が変更されたときに発せられる。

注意: 対応するハンドラはonColumnCategoriesChanged です。

columnRoleChanged(string role)

このシグナルは、columnRole がrole に変更されたときに発せられる。

注： 対応するハンドラはonColumnRoleChanged 。

columnRolePatternChanged(regExp pattern)

このシグナルは、columnRolePattern がpattern に変更されたときに発せられる。

注： 対応するハンドラはonColumnRolePatternChanged 。

columnRoleReplaceChanged(string replace)

このシグナルは、columnRoleReplace がreplace に変更されたときに発せられる。

注： 対応するハンドラはonColumnRoleReplaceChanged 。

itemModelChanged(model itemModel)

このシグナルは、itemModel がitemModel に変更されたときに発せられる。

注： 対応するハンドラはonItemModelChanged 。

multiMatchBehaviorChanged(enumeration behavior)

このシグナルは、multiMatchBehavior がbehavior に変更されたときに発せられる。

注： 対応するハンドラはonMultiMatchBehaviorChanged 。

rowCategoriesChanged()

このシグナルはrowCategories が変更されたときに発せられる。

注意: 対応するハンドラはonRowCategoriesChanged です。

rowRoleChanged(string role)

このシグナルは、rowRole がrole に変更されたときに発せられる。

注： 対応するハンドラはonRowRoleChanged 。

rowRolePatternChanged(regExp pattern)

このシグナルは、rowRolePattern がpattern に変更されたときに発せられる。

注： 対応するハンドラはonRowRolePatternChanged 。

rowRoleReplaceChanged(string replace)

このシグナルは、rowRoleReplace がreplace に変更されたときに発せられる。

注： 対応するハンドラはonRowRoleReplaceChanged 。

useModelCategoriesChanged(bool enable)

このシグナルは、useModelCategories がenable に変更されたときに発せられる。

注： 対応するハンドラはonUseModelCategoriesChanged 。

xPosRoleChanged(string role)

このシグナルは、xPosRole がrole に変更されたときに発せられる。

注： 対応するハンドラはonXPosRoleChanged 。

xPosRolePatternChanged(regExp pattern)

このシグナルは、xPosRolePattern がpattern に変更されたときに発せられる。

注： 対応するハンドラはonXPosRolePatternChanged 。

xPosRoleReplaceChanged(string replace)

このシグナルは、xPosRoleReplace がreplace に変更されたときに発せられる。

注： 対応するハンドラはonXPosRoleReplaceChanged 。

yPosRoleChanged(string role)

このシグナルは、yPosRole がrole に変更されたときに発せられる。

注： 対応するハンドラはonYPosRoleChanged 。

yPosRolePatternChanged(regExp pattern)

このシグナルは、yPosRolePattern がpattern に変更されたときに発せられる。

注： 対応するハンドラはonYPosRolePatternChanged 。

yPosRoleReplaceChanged(string replace)

このシグナルは、yPosRoleReplace がreplace に変更されたときに発せられる。

注： 対応するハンドラはonYPosRoleReplaceChanged 。

zPosRoleChanged(string role)

このシグナルは、zPosRole がrole に変更されたときに発せられる。

注： 対応するハンドラはonZPosRoleChanged 。

zPosRolePatternChanged(regExp pattern)

このシグナルは、zPosRolePattern がpattern に変更されたときに発せられる。

注： 対応するハンドラはonZPosRolePatternChanged 。

zPosRoleReplaceChanged(string replace)

このシグナルは、zPosRoleReplace がreplace に変更されたときに発せられる。

注： 対応するハンドラはonZPosRoleReplaceChanged 。

© 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.