ItemModelBarDataProxy QML Type

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

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

継承されたメンバを含むすべてのメンバの一覧
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 Data Handling with 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 です。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の商標です。その他すべての商標は、それぞれの所有者に帰属します。