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

列「category」にマッピングされるアイテムモデルのロール。

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 に変更されたときに発生します。

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