'宣言 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 がこのプロパティによって設定できるか、 FieldLayout の FieldLayout.IsDefault プロパティによって設定できます。明示的に設定されていない場合、このプロパティは少なくとも1 つの DataRecord が割り当てられている FieldLayouts コレクションの最初のアイテムを返します。
注: XamTreeGrid によりこのプロパティの使用について: XamTreeGrid は、デフォルトとして設定される FieldLayout を表示する Field ヘッダーを決定する Field を提供するために使用します。
DataSource の各アイテムが要求されるときに、DataRecord は遅延作成されます。DataRecord が作成されると、FieldLayouts コレクションが既存の FieldLayout.Fields が DataRecord.DataItem プロパティと一致する FieldLayout に対して検索されます。見つからない場合、新しい FieldLayout が作成されます。その場合 FieldLayoutInitializing イベントおよび FieldLayoutInitialized イベントが発生します。
注: 新しい FieldLayout の FieldLayout.AutoGenerateFieldsResolved プロパティが true を返すと、データ項目のパブリック プロパティごとに FieldLayout.Fields コレクションに Field が自動的に生成されます。これは FieldLayoutInitializing および FieldLayoutInitialized イベント間で行われます。
いずれの場合も AssigningFieldLayoutToItem イベントが発行され、異なる FieldLayout を DataRecord に割り当てることができるようになります。最終的に InitializeRecord イベントが発生します。
フィールドの説明については、開発者ガイドの「フィールド」を参照してください。
FieldLayout オブジェクトの説明については、開発者ガイドの「フィールド レイアウト」を参照してください。
どのようにすべてが一緒に機能するかの説明については、開発者ガイドの「操作の理論」を参照してください。