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

列カテゴリにマッピングする項目モデル・ロール。データがどの列に属するかを定義するだけでなく、別のx位置ロールも定義されていない限り、モデルデータが解決されるときに、列ロールが示す値が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位置ロールによってマップされた値に対して検索と置換が行われます。このプロパティは、マップされた値の置換する部分を見つけるための正規表現を指定し、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-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 です。


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