バージョン

DefaultFieldLayout プロパティ

Field ヘッダーを作成するときに XamTreeGrid によって使用され、GroupByArea でグループ化のために利用可能な Field のリストを作成するときに使用する FieldLayout を決定するために以前のスタイルの GroupByArea UI (新しい GroupByAreaMulti で使用されない) によって使用されるデフォルト FieldLayout を取得または設定します。
シンタックス
'宣言
 
Public Property DefaultFieldLayout As FieldLayout
public FieldLayout DefaultFieldLayout {get; set;}
解説

注: グループ化 UI のプロパティ使用について: コントロールはデフォルトで新しい GroupByAreaMulti を使用してグループ化 UI を提供します。このプロパティはデフォルトのグループ化 UI で使用/表示される FieldLayout に影響しません。グループ化 UI を変更して、以前の GroupByArea および新しい GroupByAreaMulti の間に切り替えるには、 GroupByAreaMode プロパティを使用します。このプロパティのデフォルト値は GroupByAreaMode.MultipleFieldLayoutsFull ですが、以前のスタイルの GroupByArea グループ化 UI を使用するために GroupByAreaMode.DefaultFieldLayoutOnly に設定できます。

上に説明したとおり、GroupByArea でのデフォルトの FieldLayout として使用される FieldLayout がこのプロパティによって設定できるか、 FieldLayoutFieldLayout.IsDefault プロパティによって設定できます。明示的に設定されていない場合、このプロパティは少なくとも1 つの DataRecord が割り当てられている FieldLayouts コレクションの最初のアイテムを返します。

注: XamTreeGrid によりこのプロパティの使用について: XamTreeGrid は、デフォルトとして設定される FieldLayout を表示する Field ヘッダーを決定する Field を提供するために使用します。

DataSource の各アイテムが要求されるときに、DataRecord は遅延作成されます。DataRecord が作成されると、FieldLayouts コレクションが既存の FieldLayout.FieldsDataRecord.DataItem プロパティと一致する FieldLayout に対して検索されます。見つからない場合、新しい FieldLayout が作成されます。その場合 FieldLayoutInitializing イベントおよび FieldLayoutInitialized イベントが発生します。

注: 新しい FieldLayoutFieldLayout.AutoGenerateFieldsResolved プロパティが true を返すと、データ項目のパブリック プロパティごとに FieldLayout.Fields コレクションに Field が自動的に生成されます。これは FieldLayoutInitializing および FieldLayoutInitialized イベント間で行われます。

いずれの場合も AssigningFieldLayoutToItem イベントが発行され、異なる FieldLayoutDataRecord に割り当てることができるようになります。最終的に InitializeRecord イベントが発生します。

フィールドの説明については、開発者ガイドの「フィールド」を参照してください。

FieldLayout オブジェクトの説明については、開発者ガイドの「フィールド レイアウト」を参照してください。

どのようにすべてが一緒に機能するかの説明については、開発者ガイドの「操作の理論」を参照してください。

参照