Xceed Toolkit Plus for WPF v5.0 Documentation
Xceed.Wpf.ListBox Assembly / Xceed.Wpf.Controls Namespace / FilterControl Class / UIFilterExpression Property


In This Topic
    UIFilterExpression Property
    In This Topic
    Gets or sets the filter expression that is updated in real-time.
    Syntax
    'Declaration
     
    Public Property UIFilterExpression As FilterExpressionBase
    'Usage
     
    Dim instance As FilterControl
    Dim value As FilterExpressionBase
     
    instance.UIFilterExpression = value
     
    value = instance.UIFilterExpression
    public FilterExpressionBase UIFilterExpression {get; set;}

    Property Value

    A FilterExpressionBase representing the filter expressoin that is updated in real-time.
    Remarks

    The FilterControl acts as a delay-providing link between the SearchTextBox and the ListBox. It contains an ApplyFilterInterval property, which represents the amount of time the FilterControl waits after a change to UIFilterExpression (bound to the SearchTextBox's FilterExpression with two-way binding) before the filter is used to update DataSourceFilterExpression (bound to the FilterExpression property of the ListBox with two-way binding). This prevents DataSourceFilterExpression from being updated after each keypress: instead, the property is updated only after 700 milliseconds have elapsed, by default.

    The UIFilterExpression property is in effect the "input" of the FilterControl, which is used to update DataSourceFilterExpression only after ApplyFilterInterval. UIFilterExpression is updated continuously, unlike DataSourceFilterExpression.

    Requirements

    Target Platforms: Windows 11, Windows 10, 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

    See Also