FieldChooser クラス

ユーザーがデータ プレゼンターで表示されるフィールドをカスタマイズすることを許可するコントロール。

シンタックス

Visual Basic

'宣言
 
Public Class FieldChooser 
   Inherits Infragistics.Windows.Controls.IGControlBase

C#

public class FieldChooser : Infragistics.Windows.Controls.IGControlBase 

解説

FieldChooser がデータ プレゼンターで表示できるフィールドのリストを表示します。データ プレゼンターでフィールドを表示/非表示にするために、ユーザーはデータ プレゼンターと FieldChooser の間でフィールドをドラッグ アンド ドロップできます。

非表示のフィールドを表示するには、ユーザーが [フィールドの選択] でフィールドの隣りにあるチェックボックスを選択するか、フィールドをフィールドの選択からデータ プレゼンターにドロップすることができます。ドラッグ アンド ドロップ機能のように、フィールド レイアウトの領域の指定された位置でフィールドをドロップできます。

表示されているフィールドを非表示するには、ユーザーがフィールドの選択でフィールドの隣りにあるチェックボックスの選択を解除するか、フィールドをデータ プレゼンターからフィールドの選択などのデータ プレゼンター以外の位置にフィールドをドロップできます。

FieldSettings FieldSettings.AllowHiding プロパティを Never に設定して、ユーザーが特定のフィールドを表示または非表示しないようにできます。フィールドは、[フィールドの選択] で表示されません。ユーザーがフィールドをデータ プレゼンターの外にドラッグしてもそのフィールドを非表示にできません。

使用例

Visual Basic

Imports Infragistics.Windows
Imports Infragistics.Windows.Controls
Imports Infragistics.Windows.Editors
Imports Infragistics.Windows.DataPresenter
Imports Infragistics.Windows.DataPresenter.Events

    Private Sub Window1_Loaded(ByVal sender As Object, ByVal e As RoutedEventArgs)
        ' FieldChooserButton option displays a button in the headers area where field labels
        ' are displayed, right above the record selectors. This button shows the FieldChooser.
        _dataPresenter.FieldLayoutSettings.HeaderPrefixAreaDisplayMode = HeaderPrefixAreaDisplayMode.FieldChooserButton

        ' Ensure that record selectors are visible otherwise above property setting will not
        ' have any effect. Note that the record selectors are visible by default.
        _dataPresenter.FieldLayoutSettings.RecordSelectorLocation = RecordSelectorLocation.LeftOfCellArea
    End Sub

    Private Sub Dp_FieldChooserOpening(ByVal sender As Object, ByVal e As FieldChooserOpeningEventArgs)
        ' Get the field chooser that's about to be displayed.
        Dim fieldChooser As FieldChooser = e.FieldChooser

        ' Set some properties on it.
        fieldChooser.FieldDisplayOrder = FieldChooserDisplayOrder.Alphabetical
        fieldChooser.DisplayHiddenFieldsOnly = False
    End Sub

C#

using Infragistics.Windows;
using Infragistics.Windows.Controls;
using Infragistics.Windows.Editors;
using Infragistics.Windows.DataPresenter;
using Infragistics.Windows.DataPresenter.Events;

		public void Window1_Loaded( object sender, RoutedEventArgs e )
		{
			// FieldChooserButton option displays a button in the headers area where field labels
			// are displayed, right above the record selectors. This button shows the FieldChooser.
			_dataPresenter.FieldLayoutSettings.HeaderPrefixAreaDisplayMode = HeaderPrefixAreaDisplayMode.FieldChooserButton;

			// Ensure that record selectors are visible otherwise above property setting will not
			// have any effect. Note that the record selectors are visible by default.
			_dataPresenter.FieldLayoutSettings.RecordSelectorLocation = RecordSelectorLocation.LeftOfCellArea;
		}

		private void dp_FieldChooserOpening( object sender, FieldChooserOpeningEventArgs e )
		{
			// Get the field chooser that's about to be displayed.
			FieldChooser fieldChooser = e.FieldChooser;

			// Set some properties on it.
			fieldChooser.FieldDisplayOrder = FieldChooserDisplayOrder.Alphabetical;
			fieldChooser.DisplayHiddenFieldsOnly = false;
		}

XAML

        <igDP:XamDataGrid x:Name="_dataPresenter" Grid.Column="1" FieldChooserOpening="dp_FieldChooserOpening" >
            <igDP:XamDataGrid.FieldLayoutSettings>
                <igDP:FieldLayoutSettings HeaderPrefixAreaDisplayMode="FieldChooserButton" />
            </igDP:XamDataGrid.FieldLayoutSettings>            
        </igDP:XamDataGrid>