ItemModelSurfaceDataProxy QML Type

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

• 継承されたメンバーを含む、すべてのメンバーの一覧
• ItemModelSurfaceDataProxyは、Qt Graphs の3D用QMLタイプの一部です。

プロパティ

• autoColumnCategories : bool
• autoRowCategories : bool
• columnCategories : list<String>
• columnRole : string
• columnRolePattern : regExp
• columnRoleReplace : string
• itemModel : model
• multiMatchBehavior : enumeration
• rowCategories : list<String>
• rowRole : string
• rowRolePattern : regExp
• rowRoleReplace : string
• type : AbstractDataProxy.DataType
• useModelCategories : bool
• xPosRole : string
• xPosRolePattern : regExp
• xPosRoleReplace : string
• yPosRole : string
• yPosRolePattern : regExp
• yPosRoleReplace : string
• zPosRole : string
• zPosRolePattern : regExp
• zPosRoleReplace : string

信号

• autoColumnCategoriesChanged(bool enable)
• autoRowCategoriesChanged(bool enable)
• columnCategoriesChanged()
• columnRoleChanged(string role)
• columnRolePatternChanged(regExp pattern)
• columnRoleReplaceChanged(string replace)
• itemModelChanged(model itemModel)
• multiMatchBehaviorChanged(enumeration behavior)
• rowCategoriesChanged()
• rowRoleChanged(string role)
• rowRolePatternChanged(regExp pattern)
• rowRoleReplaceChanged(string replace)
• useModelCategoriesChanged(bool enable)
• xPosRoleChanged(string role)
• xPosRolePatternChanged(regExp pattern)
• xPosRoleReplaceChanged(string replace)
• yPosRoleChanged(string role)
• yPosRolePatternChanged(regExp pattern)
• yPosRoleReplaceChanged(string replace)
• zPosRoleChanged(string role)
• zPosRolePatternChanged(regExp pattern)
• zPosRoleReplaceChanged(string replace)

詳細な説明

このタイプを使用すると、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 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座標にマッピングするためのアイテムモデルのロール。このロールが定義されていない場合、columnRole が使用され、解決されたQSurfaceDataItem アイテムのX座標値が決定されます。

xPosRolePattern : regExp

このプロパティが設定されている場合、x-positionロールによってマッピングされた値は、アイテムの位置値として使用される前に、検索と置換が行われます。このプロパティは、マッピングされた値の中から置換対象となる部分を見つけるための正規表現を指定するものであり、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 に変更されたときに発せられます。

autoRowCategoriesChanged(bool enable)

このシグナルは、autoRowCategories がenable に変更されたときに発生します。

columnCategoriesChanged()

このシグナルは、columnCategories が変更されたときに発生します。

columnRoleChanged(string role)

このシグナルは、columnRole がrole に変更されたときに発生します。

columnRolePatternChanged(regExp pattern)

このシグナルは、columnRolePattern がpattern に変更されたときに発生します。

columnRoleReplaceChanged(string replace)

このシグナルは、columnRoleReplace がreplace に変更されたときに発信されます。

itemModelChanged(model itemModel)

このシグナルは、itemModel がitemModel に変化したときに発生します。

multiMatchBehaviorChanged(enumeration behavior)

このシグナルは、multiMatchBehavior がbehavior に変化したときに発せられます。

rowCategoriesChanged()

このシグナルは、rowCategories が変更されたときに発生します。

rowRoleChanged(string role)

このシグナルは、rowRole がrole に切り替わったときに発生します。

rowRolePatternChanged(regExp pattern)

このシグナルは、rowRolePattern がpattern に変更されたときに発生します。

rowRoleReplaceChanged(string replace)

このシグナルは、rowRoleReplace がreplace に変更されたときに発生します。

useModelCategoriesChanged(bool enable)

このシグナルは、useModelCategories がenable に変更されたときに発生します。

xPosRoleChanged(string role)

このシグナルは、xPosRole がrole に変更されたときに発信されます。

xPosRolePatternChanged(regExp pattern)

このシグナルは、xPosRolePattern がpattern に変更されたときに発生します。

xPosRoleReplaceChanged(string replace)

このシグナルは、xPosRoleReplace がreplace に変更されたときに発生します。

yPosRoleChanged(string role)

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

yPosRolePatternChanged(regExp pattern)

このシグナルは、yPosRolePattern がpattern に変更されたときに発生します。

yPosRoleReplaceChanged(string replace)

このシグナルは、yPosRoleReplace がreplace に変更されたときに発生します。

zPosRoleChanged(string role)

このシグナルは、zPosRole がrole に変更されたときに発生します。

zPosRolePatternChanged(regExp pattern)

このシグナルは、zPosRolePattern がpattern に変化したときに発生します。

zPosRoleReplaceChanged(string replace)

このシグナルは、zPosRoleReplace がreplace に変更されたときに発生します。