CustomFilterSelectionControlOpening イベント

フィールドのカスタム フィルター条件を入力する UI を表示する前に発生されます。このイベントをキャンセルして独自の UI を表示できます。

シンタックス

Visual Basic

'宣言
 
Public Event CustomFilterSelectionControlOpening As EventHandler(Of CustomFilterSelectionControlOpeningEventArgs)

C#

public event EventHandler<CustomFilterSelectionControlOpeningEventArgs> CustomFilterSelectionControlOpening

イベント データ

イベント ハンドラが、このイベントに関連するデータを含む、CustomFilterSelectionControlOpeningEventArgs 型の引数を受け取りました。次の CustomFilterSelectionControlOpeningEventArgs プロパティには、このイベントの固有の情報が記載されます。

プロパティ	解説
Cancel Infragistics.Windows.Controls.Events.CancelableRoutedEventArgsから継承されます。
Control	フィールドのカスタム フィルター条件を選択するための UI に表示されているコントロールを返します (読み取り専用)。
FieldLayout	Infragistics.Windows.DataPresenter.CustomFilterSelectionControl がフィルターを作成/編集する Infragistics.Windows.DataPresenter.Field と関連する FieldLayout を返します。(読み取り専用)。
FilterType	Infragistics.Windows.DataPresenter.CustomFilterSelectionControl が作成/編集するフィルター タイプを表す Infragistics.Windows.DataPresenter.CustomFilterSelectionControlFilterType を返します。(読み取り専用)。
Handled System.Windows.RoutedEventArgsから継承されます。	Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route.
OriginalSource System.Windows.RoutedEventArgsから継承されます。	Gets the original reporting source as determined by pure hit testing, before any possible System.Windows.RoutedEventArgs.Source adjustment by a parent class.
RecordFilter	FilterType が Infragistics.Windows.DataPresenter.CustomFilterSelectionControlFilterType.SingleField の場合、フィルター選択コントロールに変更される RecordFilter インスタンスを返します。それ以外の場合、null 値を返します (読み取り専用)。
RecordManager	フィルターの作成/編集で各 Infragistics.Windows.DataPresenter.Field に表示する一意な値を決定するために使用される RecordManager を返します。(読み取り専用)。
RoutedEvent System.Windows.RoutedEventArgsから継承されます。	Gets or sets the System.Windows.RoutedEventArgs.RoutedEvent associated with this System.Windows.RoutedEventArgs instance.
Source System.Windows.RoutedEventArgsから継承されます。	Gets or sets a reference to the object that raised the event.

解説

CustomFilterSelectionControlOpening はカスタム フィルター条件を入力するユーザー インタフェイスが表示される前に発生します。ユーザーはフィルター ドロップダウンから (Custom) エントリを選択した時に発生します。フィルター機能を有効にするには、FieldSettings.AllowRecordFiltering プロパティおよび FieldLayoutSettings.FilterUIType プロパティを設定します。

UI が表示されない場合にはこのイベントをキャンセルできることに注意してください。ユーザーのカスタム フィルター条件の入力を可能にする固有な UI の表示が可能になります。RecordFilterDropDownPopulating イベントを使用してフィルター ドロップダウン リストから「(Custom)」エントリを削除したり、他のカスタム フィルター エントリを追加できる点にも注意してください。

使用例

Visual Basic

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

    Private Sub Dp_CustomFilterSelectionControlOpening(ByVal sender As Object, ByVal e As CustomFilterSelectionControlOpeningEventArgs)
        ' RecordFilter returns the filter that is to be manipulated by the custom
        ' filter dialog.
        Dim filter As RecordFilter = e.RecordFilter

        ' You can get the field for which the custom filter dialog is opening by
        ' using the RecordFilter's Field property.
        Dim field As Field = filter.Field

        ' Control property returns the CustomFilterSelectionControl that will
        ' be displayed.
        Dim customFilterControl As CustomFilterSelectionControl = e.Control

        ' Print a message.
        Debug.WriteLine("Custom filter dialog is being displayed for field " & field.Name)

        ' You can set Cancel to true to prevent the data presenter from displaying
        ' the custom filter dialog.
        e.Cancel = True

        ' Setting Cancel to true lets you display display your own custom filter 
        ' dialog. All you need to do is update the e.RecordFilter with the conditions
        ' that the user selects from your custom dialog.
    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 dp_CustomFilterSelectionControlOpening( object sender, CustomFilterSelectionControlOpeningEventArgs e )
		{
			// RecordFilter returns the filter that is to be manipulated by the custom
			// filter dialog.
			RecordFilter filter = e.RecordFilter;

			// You can get the field for which the custom filter dialog is opening by
			// using the RecordFilter's Field property.
			Field field = filter.Field;

			// Control property returns the CustomFilterSelectionControl that will
			// be displayed.
			CustomFilterSelectionControl customFilterControl = e.Control;

			// Print a message.
			Debug.WriteLine( "Custom filter dialog is being displayed for field " + field.Name );

			// You can set Cancel to true to prevent the data presenter from displaying
			// the custom filter dialog.
			e.Cancel = true;

			// Setting Cancel to true lets you display display your own custom filter 
			// dialog. All you need to do is update the e.RecordFilter with the conditions
			// that the user selects from your custom dialog.
		}

XAML

        <igDP:XamDataGrid x:Name="_dp" HorizontalAlignment="Stretch" VerticalAlignment="Stretch"
                                            CustomFilterSelectionControlOpening="dp_CustomFilterSelectionControlOpening"
                                        >

            <igDP:XamDataGrid.FieldSettings>
                <!--Set AllowRecordFiltering to enable filter-record.-->
                <igDP:FieldSettings AllowRecordFiltering="true" />
            </igDP:XamDataGrid.FieldSettings>
            
        </igDP:XamDataGrid>