Back to Qt.io
Contact Us Blog Download Qt

ItemModelBarDataProxy QML Type

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

Import Statement: import QtGraphs
In C++: QItemModelBarDataProxy
Inherits:

BarDataProxy

プロパティ

信号

詳細な説明

この型を使用すると、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: ["2020", "2021", "2022", "2023"]
    columnCategories: ["Oulu", "Rauma", "Helsinki", "Tampere"]
}

BarDataProxy およびQt Graphs 3D によるデータ処理も参照してください 。

プロパティ ドキュメント

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 : enumeration

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

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


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も参照してください 。


type : AbstractDataProxy.DataType [read-only]

プロキシの型。QAbstractDataProxy::DataType 。


useModelCategories : bool

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


valueRole : string

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


valueRolePattern : regExp

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

valueRole およびvalueRoleReplaceも参照のこと 。


valueRoleReplace : string

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

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


シグナルのドキュメント

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 です。


rotationRoleChanged(string role)

このシグナルはrotationRole がrole に変更されたときに発せられる。

注： 対応するハンドラはonRotationRoleChanged です。


rotationRolePatternChanged(regExp pattern)

このシグナルはrotationRolePattern がpattern に変更されたときに発せられる。

注： 対応するハンドラはonRotationRolePatternChanged です。


rotationRoleReplaceChanged(string replace)

このシグナルはrotationRoleReplace がreplace に変更されたときに発せられる。

注： 対応するハンドラはonRotationRoleReplaceChanged です。


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 です。


valueRoleChanged(string role)

このシグナルはvalueRole がrole に変更されたときに発せられる。

注： 対応するハンドラはonValueRoleChanged である。


valueRolePatternChanged(regExp pattern)

このシグナルは、valueRolePattern がpattern に変わったときに発せられる。

注 : 対応するハンドラはonValueRolePatternChanged です。


valueRoleReplaceChanged(string replace)

このシグナルはvalueRoleReplace がreplace に変更されたときに発せられる。

注 : 対応するハンドラはonValueRoleReplaceChanged です。


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