FieldLayouts プロパティ

FieldLayout オブジェクトのコレクションを返します (読み取り専用)。

シンタックス

Visual Basic

'宣言
 
Public ReadOnly Property FieldLayouts As FieldLayoutCollection

C#

public FieldLayoutCollection FieldLayouts {get;}

解説

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

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

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

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

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

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

使用例

The following example demonstrates how to create a FieldLayout and add it to the FieldLayouts property of a DataPresenterBase derived control. It also demonstrates how to create and initialize the FieldSettings of a FieldLayout and create the Fields that will make up that FieldLayout including the use of UnboundField instances.

XAML

<igDP:XamDataGrid x:Name="XamDataGrid12" BindToSampleData="true">
    <igDP:XamDataGrid.FieldLayouts>
        <!-- define a field layout that will match the data -->
        <igDP:FieldLayout>

            <!-- initialize settings for the fields in this specific field layout -->
            <igDP:FieldLayout.FieldSettings>
                <igDP:FieldSettings CellClickAction="SelectRecord"/>
            </igDP:FieldLayout.FieldSettings>

            <!-- define the fields for the field layout -->
            <igDP:FieldLayout.Fields>
                <igDP:Field Name="name" Label="Name"/>
                <igDP:Field Name="department" Label="Dept." />
                <igDP:Field Name="salary" Label="Salary"/>
                <igDP:Field Name="email" Label="Email"/>
                <!--
                    The XamDataGrid allows you to include Unbound Fields in a
                    FieldLayout. This sample shows how you can use
                    Unbound Fields to include calculated values. -->
                <igDP:UnboundField Name="SubTotal" Label="Sub-total"></igDP:UnboundField>
                <igDP:UnboundField Name="SalesTax" Label="Sales Tax (7%)" />
                <igDP:UnboundField Name="Total" Label="Total" DataType="{x:Type sys:Decimal}"></igDP:UnboundField>
            </igDP:FieldLayout.Fields>

        </igDP:FieldLayout>
    </igDP:XamDataGrid.FieldLayouts>
</igDP:XamDataGrid>