QItemModelSurfaceDataProxy Class

QItemModelSurfaceDataProxy *proxy = new QItemModelSurfaceDataProxy(customModel,
                                                                   QStringLiteral("longitude"), // Row role
                                                                   QStringLiteral("latitude"), // Column role
                                                                   QStringLiteral("height")); // Y-position role

プロパティのドキュメント

autoColumnCategories : bool

このプロパティは、列カテゴリが自動的に生成されるかどうかを保持します。

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

アクセス関数：

通知シグナル：

autoRowCategories : bool

このプロパティは、行カテゴリが自動的に生成されるかどうかを保持します。

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

アクセス関数：

通知シグナル：

columnCategories : QStringList

このプロパティはマッピングの列カテゴリを保持します。

アクセス関数：

通知シグナル：

columnRole : QString

このプロパティは、列カテゴリにマッピングするアイテムモデルロールを保持する。

データがどのカラムに属するかを定義することに加えて、カラムロールによって示される値は、別のx-positionロールも定義されていない限り、モデルデータが解決される際にQSurfaceDataItem のX座標値としても設定されます。

アクセス関数：

通知シグナル：

columnRolePattern : QRegularExpression

このプロパティは、列ロールによってマップされた値が列カテゴリとして使用される前に、検索と置換が行われるかどうかを保持します。

このプロパティは、マップされた値の置換する部分を検索する正規表現を指定し、columnRoleReplace プロパティには置換文字列が格納されます。

アクセス関数：

Notifierシグナル：

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

columnRoleReplace : QString

このプロパティは、列の役割パターンと組み合わせて使用される置換内容を保持します。

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

アクセス関数：

通知シグナル：

columnRole およびcolumnRolePatternも参照のこと 。

itemModel : QAbstractItemModel*

このプロパティは、3D サーフェスのデータソースとして使用されるアイテムモデルを保持する。

アクセス関数

通知シグナル

multiMatchBehavior : QItemModelSurfaceDataProxy::MultiMatchBehavior

各行/列の組み合わせに対する複数マッチの処理方法。

デフォルトはLast。

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

アクセス関数：

通知シグナル

rowCategories : QStringList

このプロパティは、マッピングの行カテゴリを保持する。

アクセス関数：

通知シグナル：

rowRole : QString

このプロパティは、行カテゴリにマッピングするアイテムモデルロールを保持する。

データがどの行に属するかを定義するだけでなく、行ロールで示される値は、モデルデータが解決される際に、QSurfaceDataItem のZ座標値としても設定されます（別途Z位置ロールが定義されている場合を除く）。

アクセス関数：

通知シグナル：

rowRolePattern : QRegularExpression

このプロパティは、行カテゴリとして使用される前に、行ロールによってマップされた値に対して検索と置換が実行されるかどうかを保持します。

このプロパティは、マップされた値の置換する部分を検索する正規表現を指定し、rowRoleReplace プロパティには置換文字列が格納されます。

アクセス関数：

Notifierシグナル：

rowRole およびrowRoleReplaceも参照のこと 。

rowRoleReplace : QString

このプロパティは、行役割パターンと組み合わせて使用される置換内容を保持する。

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

アクセス関数：

通知シグナル：

rowRole およびrowRolePatternも参照のこと 。

useModelCategories : bool

このプロパティは、行と列のロールとカテゴリをマッピングに使用するかどうかを保持します。

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

アクセス関数：

通知シグナル：

xPosRole : QString

このプロパティは、X 位置に対応付けるアイテムモデルの役割を保持する。

このロールが定義されていない場合、解決されたQSurfaceDataItem オブジェクトの X 座標値を決定するためにcolumnRole が使用される。

アクセス関数：

通知シグナル：

xPosRolePattern : QRegularExpression

このプロパティは、項目位置値として使用される前に、x 位置ロールによってマップされた値に対して検索と置換が行われるかどうかを保持する。

このプロパティには、マップされた値の置換する部分を検索する正規表現が指定され、xPosRoleReplace プロパティには置換文字列が格納されます。

アクセス関数：

Notifier シグナル：

xPosRole およびxPosRoleReplaceも参照のこと 。

xPosRoleReplace : QString

このプロパティは、x位置ロールパターンと組み合わせて使用される置換内容を保持する。

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

アクセス関数：

通知シグナル：

xPosRole およびxPosRolePatternも参照のこと 。

yPosRole : QString

このプロパティは、Y 位置に対応付けるアイテムモデルの役割を保持する。

アクセス関数

通知シグナル

yPosRolePattern : QRegularExpression

このプロパティは、項目位置値として使用される前に、y 位置ロールによってマップされた値に対して検索と置換が行われるかどうかを保持する。

このプロパティには、マップされた値の置換する部分を検索する正規表現が指定され、yPosRoleReplace プロパティには置換文字列が格納される。

アクセス関数：

Notifier シグナル：

yPosRole およびyPosRoleReplaceも参照のこと 。

yPosRoleReplace : QString

このプロパティは、y位置ロールパターンと組み合わせて使用される置換内容を保持する。

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

アクセス関数：

通知シグナル：

yPosRole およびyPosRolePatternも参照のこと 。

zPosRole : QString

このプロパティは、Z位置に対応付けるアイテムモデルの役割を保持する。

このロールが定義されていない場合、解決されたQSurfaceDataItem オブジェクトの Z 座標値を決定するためにrowRole が使用される。

アクセス関数：

通知シグナル：

zPosRolePattern : QRegularExpression

このプロパティは、項目位置値として使用される前に、z 位置ロールによってマップされた値に対して検索と置換が行われるかどうかを保持する。

このプロパティには、マップされた値の置換する部分を検索する正規表現が指定され、zPosRoleReplace プロパティには置換文字列が格納される。

アクセス関数：

Notifier シグナル：

zPosRole およびzPosRoleReplaceも参照のこと 。

zPosRoleReplace : QString

このプロパティは、zポジション役割パターンと組み合わせて使用される置換内容を保持する。

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

アクセス関数：

通知シグナル：

zPosRole およびzPosRolePatternも参照 。