RecordFilterScope プロパティ

Visual Basic
C#

'宣言
 
Public Property RecordFilterScope As RecordFilterScope

public RecordFilterScope RecordFilterScope {get; set;}

RecordFilterScope プロパティは、レコードフィルタリングがフィールドレイアウトレベルまたは固有レコードコレクションレベルのかどちらにするかを決定します。子フィールドレイアウトのみに影響します。このプロパティを AllRecords に設定する場合は、ユーザーがフィルター条件を入れた時に、フィールドレイアウトに関連付けられるすべてのレコードをこのフィルターに適用します。プロパティを SiblingDataRecords に設定した場合、フィルター条件は特定なレコードコレクションのデータレコードにのみに適用します。Default は SiblingDataRecords に解決されます。

注: このプロパティは、コードでのフィルター条件の指定方法に影響を与えます。このプロパティを AllRecords に設定した場合は、FieldLayout の RecordFilters プロパティを使用しなければなりません。このプロパティを SiblingDataRecords に設定した場合は、RecordManager の RecordManager.RecordFilters を使用しなければなりません。

The following sample code shows how you can specify record filters in code. It adds record filter criteria to root records and also child records, which is only applicable if you have hierarchical data source.

Visual Basic

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

Private Sub Window1_Loaded(ByVal sender As Object, ByVal e As RoutedEventArgs)

Dim fieldLayout As FieldLayout = _dp.FieldLayouts(0)

' Create a new RecordFilter for 'Country' field.
Dim filter As RecordFilter = New RecordFilter()
filter.FieldName = "Country"
filter.Conditions.Add(New ComparisonCondition(ComparisonOperator.Equals, "US"))

' Add the RecordFilter to field layout's RecordFilters collection.
fieldLayout.RecordFilters.Add(filter)

' If you have hierarchical data source then you can also filter child records.
' Create a RecordFilter that filters the child records.
filter = New RecordFilter()
filter.FieldName = "Product"
filter.Conditions.Add(New ComparisonCondition(ComparisonOperator.Equals, "A"))

' Now add the filter. For child field layouts, each individual parent
' record's child records can be filtered independently. That is one parent
' record's child records can have different filter criteria from another
' parent record's child records. This is the default mode of filtering. You
' can change it by setting RecordFilterScope property to AllRecords in which
' case all child records in the child field layout are affected by the
' filter. However depending on the mode, the place where you specify the
' filter criteria is different. For the default SiblingDataRecords mode, you
' need to specify the filter criteria on RecordFilters property of the child
' RecordManager of a parent record. For the AllRecords mode, use the child
' FieldLayout's RecordFilters property. Note that the root field layout
' doesn't support SiblingDataRecords mode since it doesn't have multiple
' record collections and therefore for the root field layout, always use the
' field layout's RecordFilters property.
'
Dim childDataRecordsManager As RecordManager = _dp.RecordManager.Unsorted(0).ChildRecords(0).ChildRecordManager
Dim childFieldLayout As FieldLayout = _dp.FieldLayouts(1)
childFieldLayout.Settings.RecordFilterScope = RecordFilterScope.AllRecords
If RecordFilterScope.AllRecords = childFieldLayout.Settings.RecordFilterScope Then
' When using AllRecords mode, use the field layout's RecordFilters.
childFieldLayout.RecordFilters.Add(filter)
Else
' When using SiblingDataRecords, use the child RecordManager's RecordFilters.
childDataRecordsManager.RecordFilters.Add(filter)
End If

End Sub

C#

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

		public void Window1_Loaded( object sender, RoutedEventArgs e )
		{
			FieldLayout fieldLayout = _dp.FieldLayouts[0];

			// Create a new RecordFilter for 'Country' field.
			RecordFilter filter = new RecordFilter( );
			filter.FieldName = "Country";
			filter.Conditions.Add( new ComparisonCondition( ComparisonOperator.Equals, "US" ) );

			// Add the RecordFilter to field layout's RecordFilters collection.
			fieldLayout.RecordFilters.Add( filter );

			// If you have hierarchical data source then you can also filter child records.
			// Create a RecordFilter that filters the child records.
			filter = new RecordFilter( );
			filter.FieldName = "Product";
			filter.Conditions.Add( new ComparisonCondition( ComparisonOperator.Equals, "A" ) );

			// Now add the filter. For child field layouts, each individual parent
			// record's child records can be filtered independently. That is one parent
			// record's child records can have different filter criteria from another
			// parent record's child records. This is the default mode of filtering. You
			// can change it by setting RecordFilterScope property to AllRecords in which
			// case all child records in the child field layout are affected by the
			// filter. However depending on the mode, the place where you specify the
			// filter criteria is different. For the default SiblingDataRecords mode, you
			// need to specify the filter criteria on RecordFilters property of the child
			// RecordManager of a parent record. For the AllRecords mode, use the child
			// FieldLayout's RecordFilters property. Note that the root field layout
			// doesn't support SiblingDataRecords mode since it doesn't have multiple
			// record collections and therefore for the root field layout, always use the
			// field layout's RecordFilters property.
			// 
			RecordManager childDataRecordsManager = _dp.RecordManager.Unsorted[0].ChildRecords[0].ChildRecordManager; 
			FieldLayout childFieldLayout = _dp.FieldLayouts[1];
			childFieldLayout.Settings.RecordFilterScope = RecordFilterScope.AllRecords;
			if ( RecordFilterScope.AllRecords == childFieldLayout.Settings.RecordFilterScope )
			{
				// When using AllRecords mode, use the field layout's RecordFilters.
				childFieldLayout.RecordFilters.Add( filter );
			}
			else
			{
				// When using SiblingDataRecords, use the child RecordManager's RecordFilters.
				childDataRecordsManager.RecordFilters.Add( filter );
			}
		}

XAML

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

            <igDP:XamDataGrid.FieldLayouts>

                
                <igDP:FieldLayout IsDefault="true">
                    <igDP:FieldLayout.Fields>
                        <igDP:Field Name="ID" />
                        <igDP:Field Name="Country" />
                    </igDP:FieldLayout.Fields>

                    
                    <igDP:FieldLayout.RecordFilters>
                        <igDP:RecordFilter FieldName="Country">
                            <igWindows:ComparisonCondition Operator="Equals" Value="US" />
                        </igDP:RecordFilter>
                    </igDP:FieldLayout.RecordFilters>

                </igDP:FieldLayout>

                
                <igDP:FieldLayout>
                    <igDP:FieldLayout.Fields>
                        <igDP:Field Name="ID" />
                        <igDP:Field Name="Product" />
                    </igDP:FieldLayout.Fields>

                    
                    <igDP:FieldLayout.Settings>
                        <igDP:FieldLayoutSettings RecordFilterScope="AllRecords" />
                    </igDP:FieldLayout.Settings>

                    
                    <igDP:FieldLayout.RecordFilters>
                        <igDP:RecordFilter FieldName="Product">
                            <igWindows:ComparisonCondition Operator="StartsWith" Value="A" />
                        </igDP:RecordFilter>
                    </igDP:FieldLayout.RecordFilters>

                </igDP:FieldLayout>

            </igDP:XamDataGrid.FieldLayouts>

        </igDP:XamDataGrid>

参照

FieldLayoutSettings クラス
 FieldLayoutSettings メンバ
 RecordFilterScope 列挙体
 AllowRecordFiltering プロパティ
 FilterUIType プロパティ
 RecordFilters プロパティ
 RecordFilters プロパティ
 FilterAction プロパティ

WPF | ヘルプ トピック

参照

WPF | ヘルプトピック