ItemModelBarDataProxy QML Type

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

Import Statement:	`import QtDataVisualization 1.8`
Since:	QtDataVisualization 1.0
In C++:	QItemModelBarDataProxy
Inherits:	BarDataProxy

継承メンバを含む全メンバ一覧

プロパティ

autoColumnCategories : bool
autoRowCategories : bool
columnCategories : list<String>
columnRole : string
columnRolePattern : regExp
columnRoleReplace : string
itemModel : model
multiMatchBehavior : ItemModelBarDataProxy.MultiMatchBehavior
rotationRole : string
rotationRolePattern : regExp
rotationRoleReplace : string
rowCategories : list<String>
rowRole : string
rowRolePattern : regExp
rowRoleReplace : string
useModelCategories : bool
valueRole : string
valueRolePattern : regExp
valueRoleReplace : string

詳細な説明

この型を使用すると、AbstractItemModel 派生モデルをBars3D のデータソースとして使用することができます。

マッピングやモデルが変更されるたびに、非同期にデータが解決されます。QBarDataProxy::arrayResetデータが解決されると () が発行されます。

ItemModelBarDataProxy 列挙型については、QItemModelBarDataProxy::MultiMatchBehavior を参照してください。

詳細はQItemModelBarDataProxy ドキュメントを参照してください。

使用例：

ItemModelBarDataProxy {
    itemModel: model // E.g. a list model defined elsewhere containing yearly expenses data.
    // Mapping model roles to bar series rows, columns, and values.
    rowRole: "year"
    columnRole: "city"
    valueRole: "expenses"
    rowCategories: ["2010", "2011", "2012", "2013"]
    columnCategories: ["Oulu", "Rauma", "Helsinki", "Tampere"]
}

BarDataProxy およびQt Data Visualization データ処理も参照してください 。

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

autoColumnCategories : bool

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

autoRowCategories : bool

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

columnCategories : list<String>

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

columnRole : string

列カテゴリにマッピングする項目モデル・ロール。

columnRolePattern : regExp

設定されると、列カテゴリとして使用される前に、列ロールによってマップされた値に対して検索と置換が行われます。このプロパティは、マップされた値の置換する部分を見つけるための正規表現を指定し、columnRoleReplace プロパティは置換文字列を含みます。これは、例えば、項目モデルの単一のタイムスタンプフィールドから行および列カテゴリを解析する際に便利です。

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

columnRoleReplace : string

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

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

itemModel : model

項目モデル。

multiMatchBehavior : ItemModelBarDataProxy.MultiMatchBehavior

各行/列の組み合わせに対する複数マッチの処理方法を定義します。デフォルトはItemModelBarDataProxy.MMBLast です。選択された動作は、バーの値と回転の両方に影響します。

例えば、不規則な間隔で取得されたタイムスタンプ付きデータを持つ項目モデルがあり、各日のデータ項目の合計値を棒グラフで可視化したいとします。これは、各バーが1日を表すように行と列のカテゴリを指定し、multiMatchBehavior をItemModelBarDataProxy.MMBCumulative に設定することで実現できます。

rotationRole : string

アイテム・モデルのロールをバーの回転角度にマッピングします。

rotationRolePattern : regExp

このプロパティを設定すると、バーの回転角度として使用する前に、回転ロールでマップされた値に対して検索と置換が行われます。このプロパティには、マップされた値の置換する部分を検索する正規表現が指定され、rotationRoleReplace プロパティには置換文字列が格納されます。

rotationRole およびrotationRoleReplaceも参照のこと。

rotationRoleReplace : string

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

rotationRole およびrotationRolePatternも参照してください。

rowCategories : list<String>

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

rowRole : string

行カテゴリにマッピングする項目モデル・ロール。

rowRolePattern : regExp

設定されると、行カテゴリとして使用される前に、行ロールでマップされた値に対して検索と置換が行われます。このプロパティには、マップされた値の置換する部分を見つけるための正規表現が指定され、rowRoleReplace プロパティには置換文字列が格納されます。これは、例えば、項目モデルの単一のタイムスタンプフィールドから行および列カテゴリを解析する際に便利です。

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

rowRoleReplace : string

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

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

useModelCategories : bool

true に設定された場合、マッピングは行と列のロールとカテゴリを無視し、代わりにモデルからの行と列を使用します。行と列のラベルには行ヘッダと列ヘッダが使用されます。デフォルトはfalse です。

valueRole : string

バー値にマップする項目モデルのロール。

valueRolePattern : regExp

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

valueRole とvalueRoleReplaceも参照してください。

valueRoleReplace : string

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

valueRole およびvalueRolePatternも参照してください。

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