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 プロパティには置換文字列が格納されます。

アクセス関数：

通知信号:

「 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

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

データがどの行に属するかを定義することに加え、別途z位置ロールが定義されていない限り、行ロールで指定された値は、モデルデータが解決される際にQSurfaceDataItem のZ座標値としても設定されます。

アクセス関数：

通知信号:

rowRolePattern : QRegularExpression

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

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

アクセス関数：

通知シグナル:

「 rowRole 」および「rowRoleReplace 」も参照してください 。

rowRoleReplace : QString

このプロパティには、行ロールパターンと組み合わせて使用される置換内容が格納されます。

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

アクセス関数:

Notifierシグナル:

関連項目: rowRole およびrowRolePattern 。

useModelCategories : bool

このプロパティは、マッピングに行および列のロールとカテゴリが使用されるかどうかを指定します。

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

アクセス関数:

通知シグナル：

xPosRole : QString

このプロパティは、X座標にマッピングするためのアイテムモデルの役割を持ちます。

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

アクセス関数：

通知信号：

xPosRolePattern : QRegularExpression

このプロパティは、x 位置ロールによってマッピングされた値が、アイテムの位置値として使用される前に、検索と置換が行われるかどうかを指定します。

このプロパティは、置換対象となるマッピング済み値の部分を検索するための正規表現を指定し、xPosRoleReplace プロパティには置換文字列が格納されます。

アクセス関数：

通知シグナル:

「 xPosRole 」および「xPosRoleReplace 」も参照してください 。

xPosRoleReplace : QString

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

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

アクセス関数：

通知シグナル:

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

yPosRole : QString

このプロパティは、Y位置にマッピングするためのアイテムモデルの役割を持ちます。

アクセス関数：

通知信号:

yPosRolePattern : QRegularExpression

このプロパティは、y 位置ロールによってマッピングされた値が、アイテムの位置値として使用される前に、検索と置換が行われるかどうかを指定します。

このプロパティは、置換対象となるマッピング済み値の部分を検索するための正規表現を指定し、yPosRoleReplace プロパティには置換文字列が格納されます。

アクセス関数：

通知シグナル:

「 yPosRole 」および「yPosRoleReplace 」も参照してください 。

yPosRoleReplace : QString

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

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

アクセス関数：

通知シグナル:

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

zPosRole : QString

このプロパティは、Z位置にマッピングするためのアイテムモデルの役割を保持します。

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

アクセス関数：

通知信号：

zPosRolePattern : QRegularExpression

このプロパティは、z 位置ロールによってマッピングされた値が、アイテムの位置値として使用される前に、検索と置換が行われるかどうかを指定します。

このプロパティは、置換対象となるマッピング済み値の一部を検索するための正規表現を指定し、zPosRoleReplace プロパティには置換文字列が格納されます。

アクセス関数：

通知シグナル:

「 zPosRole 」および「zPosRoleReplace 」も参照してください 。

zPosRoleReplace : QString

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

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

アクセス関数：

通知シグナル:

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