ItemModelBarDataProxy QML Type

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

この型は非推奨です。新しいコードでの使用は強く推奨しません。

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• 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

詳細な説明

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

マッピングまたはモデルが変更されるたびに、データは非同期的に解決されます。データが解決されると、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も参照してください 。