ShowFieldChooser(FieldLayout,Boolean,Boolean,String) メソッド

データ プレゼンターで表示されるフィールドをユーザーが選択することを許可する FieldChooser を表示します。

シンタックス

Visual Basic

'宣言
 
Public Overloads Sub ShowFieldChooser( _
   ByVal fieldLayout As FieldLayout, _
   ByVal allowFieldLayoutSelection As Boolean, _
   ByVal retainFieldChooser As Boolean, _
   ByVal windowCaption As String _
) 

C#

public void ShowFieldChooser( 
   FieldLayout fieldLayout,
   bool allowFieldLayoutSelection,
   bool retainFieldChooser,
   string windowCaption
)

パラメータ

fieldLayout

FieldChooser が表示されるフィールド レイアウト。ルートのフィールド レイアウトがあらかじめ選択されていて、ユーザーが別のフィールド レイアウトを選択することを許可する場合は、null の可能性があります。

allowFieldLayoutSelection

ユーザーがフィールド レイアウトを変更して、別のフィールド レイアウトのフィールドを選択できるかどうかを指定します。

retainFieldChooser

このメソッドを呼び出すときに FieldChooser を再使用するために、データ プレゼンターが表示されている FieldChooser を保存するかどうかを指定します。この場合、FieldChooser の状態も保持されます。

windowCaption

FieldChooser が表示されているウィンドウのキャプションを指定します。null が設定された場合、デフォルトのキャプションが使用されます。文字列を指定すると、キャプションは表示されません。

解説

ShowFieldChooser は、ユーザーがデータ プレゼンターで表示される指定されたフィールド レイアウトのフィールドの選択を許可する FieldChooser を表示します。FieldChooser コントロールは Infragistics.Windows.Controls.ToolWindow を使用して表示されます。

FieldChooserOpening イベントにフックして、FieldChooser の要素を制御できます。関連付けられたイベント引数は、表示される FieldChooser のインスタンス、およびそれを表示する ToolWindow も提供します。

fieldLayout パラメーターが設定された場合、そのフィールド レイアウトのフィールドは FieldChooser で表示される点に注意してください。そうでない場合、ルートのフィールド レイアウトのフィールドを表示されます。AllowFieldLayoutSelection パラメーターは、ユーザーがフィールド レイアウトを変更して、他のフィールド レイアウトのフィールドを選択できるかどうかを指定します。FieldChooser の FieldChooser.FieldGroupSelectorVisibility プロパティはそのパラメーターに基づいて初期化されます。

使用例

Visual Basic

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

    Private Sub OnButtonClick(ByVal sender As Object, ByVal e As RoutedEventArgs)
        Dim customersFieldLayout As FieldLayout = _dataPresenter.FieldLayouts("Customers")

        Me._dataPresenter.ShowFieldChooser(customersFieldLayout, False, True, "Select Customer Fields to Display")
    End Sub

C#

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

		private void OnButtonClick( object sender, RoutedEventArgs e )
		{
			FieldLayout customersFieldLayout = _dataPresenter.FieldLayouts["Customers"];

			this._dataPresenter.ShowFieldChooser( customersFieldLayout, false, true, "Select Customer Fields to Display" );
		}