UXDataFilter Class

Provides a user interface for data filtering.

Object Model

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#
C++/CLI

<TemplatePartAttribute(Name="ScrollViewer", Type=Intersoft.Client.UI.Controls.UXScrollViewer)>
<DescriptionAttribute("Provides a user interface for data filtering.")>
<TemplatePartAttribute(Name="AllCheckBox", Type=Intersoft.Client.UI.Data.UXDataFilterItem)>
<TemplatePartAttribute(Name="ItemsPresenter", Type=System.Windows.Controls.ItemsPresenter)>
<StyleTypedPropertyAttribute(Property="ScrollViewerStyle", StyleTargetType=Intersoft.Client.UI.Controls.UXScrollViewer)>
<TemplatePartAttribute(Name="GroupBox", Type=Intersoft.Client.UI.Controls.GroupBox)>
<TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)>
<TemplatePartAttribute(Name="SearchBox", Type=Intersoft.Client.UI.Aqua.UXCollection.UXSearchBox)>
<StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Data.UXDataFilterItem)>
<StyleTypedPropertyAttribute(Property="GroupBoxStyle", StyleTargetType=Intersoft.Client.UI.Controls.GroupBox)>
Public Class UXDataFilter 
   Inherits Intersoft.Client.Framework.ISHeaderedItemsControl
   Implements Intersoft.Client.Framework.IControl, Intersoft.Client.Framework.IFramework, Intersoft.Client.Framework.IItemsControl, Intersoft.Client.Framework.ILicensing, Intersoft.Client.Framework.ISelectionItem

Dim instance As UXDataFilter

[TemplatePartAttribute(Name="ScrollViewer", Type=Intersoft.Client.UI.Controls.UXScrollViewer)]
[DescriptionAttribute("Provides a user interface for data filtering.")]
[TemplatePartAttribute(Name="AllCheckBox", Type=Intersoft.Client.UI.Data.UXDataFilterItem)]
[TemplatePartAttribute(Name="ItemsPresenter", Type=System.Windows.Controls.ItemsPresenter)]
[StyleTypedPropertyAttribute(Property="ScrollViewerStyle", StyleTargetType=Intersoft.Client.UI.Controls.UXScrollViewer)]
[TemplatePartAttribute(Name="GroupBox", Type=Intersoft.Client.UI.Controls.GroupBox)]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="SearchBox", Type=Intersoft.Client.UI.Aqua.UXCollection.UXSearchBox)]
[StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Data.UXDataFilterItem)]
[StyleTypedPropertyAttribute(Property="GroupBoxStyle", StyleTargetType=Intersoft.Client.UI.Controls.GroupBox)]
public class UXDataFilter : Intersoft.Client.Framework.ISHeaderedItemsControl, Intersoft.Client.Framework.IControl, Intersoft.Client.Framework.IFramework, Intersoft.Client.Framework.IItemsControl, Intersoft.Client.Framework.ILicensing, Intersoft.Client.Framework.ISelectionItem

[TemplatePartAttribute(Name="ScrollViewer", Type=Intersoft.Client.UI.Controls.UXScrollViewer)]
[DescriptionAttribute("Provides a user interface for data filtering.")]
[TemplatePartAttribute(Name="AllCheckBox", Type=Intersoft.Client.UI.Data.UXDataFilterItem)]
[TemplatePartAttribute(Name="ItemsPresenter", Type=System.Windows.Controls.ItemsPresenter)]
[StyleTypedPropertyAttribute(Property="ScrollViewerStyle", StyleTargetType=Intersoft.Client.UI.Controls.UXScrollViewer)]
[TemplatePartAttribute(Name="GroupBox", Type=Intersoft.Client.UI.Controls.GroupBox)]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="SearchBox", Type=Intersoft.Client.UI.Aqua.UXCollection.UXSearchBox)]
[StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Data.UXDataFilterItem)]
[StyleTypedPropertyAttribute(Property="GroupBoxStyle", StyleTargetType=Intersoft.Client.UI.Controls.GroupBox)]
public ref class UXDataFilter : public Intersoft.Client.Framework.ISHeaderedItemsControl, Intersoft.Client.Framework.IControl, Intersoft.Client.Framework.IFramework, Intersoft.Client.Framework.IItemsControl, Intersoft.Client.Framework.ILicensing, Intersoft.Client.Framework.ISelectionItem

Remarks

The UXDataFilter control provides a configurable user interface for filtering through a data collection. Similar to other ClientUI data controls, UXDataFilter supports both server side and client side operation.

Client Data Operation

Client data operation means that the data operation in this case data filtering is executed in client side against the data source provided to UXDataFilter. To use this mode, you set the QueryOperation property to Client.

You need to wrap your collection in a PagedCollectionView class to provide data filtering functionality to the IEnumerable collection. The PagedCollectionView provides consistent handling for data operation in other data controls as well such as UXGridView and UXDataPager.

To learn how to implement data filter using UXDataFilter, see How-to: Implement Data Filtering using UXDataFilter.

Server Data Operation

Server data operation means that the data operation, in this case data filtering, is processed in the server. This means that UXDataFilter does not handle the filtering operation by its own. Instead, UXDataFilter provides the query information allowing you to process it further.

To use this mode, you set the QueryOperation property to Server. When this mode is selected, UXDataFilter will not attempt to perform the data operation on the given data source. Instead, it will store and distribute the query information to FilterDescriptors property. When the collection of the property change, the QueryChanged event of the associated QueryDescriptor will be raised. This allows you to streamline the query processing in a centralized function, which is one of the strong benefits of QueryDescriptor. For more information about QueryDescriptor, see QueryDescriptor Overview.

To learn how to filter data using FilterDescriptors and UXDataFilter, see How-to: Implement Data Filtering using FilterDescriptors and UXDataFilter.

Inheritance Hierarchy

System.Object
   System.Windows.DependencyObject
      System.Windows.UIElement
         System.Windows.FrameworkElement
            System.Windows.Controls.Control
               System.Windows.Controls.ItemsControl
                  Intersoft.Client.Framework.HeaderedItemsControl
                     Intersoft.Client.Framework.ISHeaderedItemsControl
                        Intersoft.Client.UI.Data.UXDataFilter

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

UXDataFilter Members
Intersoft.Client.UI.Data Namespace