ItemModelBarDataProxy QML Type

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

• 継承メンバを含む全メンバ一覧
• ItemModelBarDataProxy はQt Graphs QML Types for 3D に含まれます。

プロパティ

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

信号

• autoColumnCategoriesChanged(bool enable)
• autoRowCategoriesChanged(bool enable)
• columnCategoriesChanged()
• columnRoleChanged(string role)
• columnRolePatternChanged(regExp pattern)
• columnRoleReplaceChanged(string replace)
• itemModelChanged(model itemModel)
• multiMatchBehaviorChanged(enumeration behavior)
• rotationRoleChanged(string role)
• rotationRolePatternChanged(regExp pattern)
• rotationRoleReplaceChanged(string replace)
• rowCategoriesChanged()
• rowRoleChanged(string role)
• rowRolePatternChanged(regExp pattern)
• rowRoleReplaceChanged(string replace)
• useModelCategoriesChanged(bool enable)
• valueRoleChanged(string role)
• valueRolePatternChanged(regExp pattern)
• valueRoleReplaceChanged(string replace)

詳細な説明

この型を使用すると、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

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

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

valueRoleReplace : string

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

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

シグナルのドキュメント

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 に変更されたときに発せられる。

rotationRoleChanged(string role)

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

rotationRolePatternChanged(regExp pattern)

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

rotationRoleReplaceChanged(string replace)

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

rowCategoriesChanged()

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

rowRoleChanged(string role)

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

rowRolePatternChanged(regExp pattern)

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

rowRoleReplaceChanged(string replace)

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

useModelCategoriesChanged(bool enable)

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

valueRoleChanged(string role)

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

valueRolePatternChanged(regExp pattern)

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

valueRoleReplaceChanged(string replace)

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