Skip to main content
All docs
V25.1
  • XRDesignMdiControllerDesignSettings.FilterCriteriaDisplayStyle Property

    Gets or sets whether Filter Editors render filter criteria in the text format or in the visual format.

    Namespace: DevExpress.XtraReports.UserDesigner

    Assembly: DevExpress.XtraReports.v25.1.Extensions.dll

    NuGet Package: DevExpress.Win.Reporting

    Declaration

    [DefaultValue(FilterCriteriaDisplayStyle.Default)]
    public FilterCriteriaDisplayStyle FilterCriteriaDisplayStyle { get; set; }

    Property Value

    Type Default Description
    FilterCriteriaDisplayStyle Default

    Text, to render filter criteria in the text format; Visual, to render filter criteria in the visual format; Default, to render filter criteria per the WindowsFormsSettings.FilterCriteriaDisplayStyle global property value.

    Available values:

    Name Description
    Default

    When a control’s FilterCriteriaDisplayStyle property is set to Default, the actual display style is specified by the WindowsFormsSettings.FilterCriteriaDisplayStyle property.

    For the Report Designer and Dashboard Designer, the default display style is Visual.

    For other controls, the default display style is Visual starting from v21.1; in older versions, the default display style is Text.

    Visual

    Renders filter criteria in an easy-to-read format and uses skin-based colored highlights to differentiate between column names, functions, and values. In the Filter Panel, the ‘x’ button is displayed when you hover over a condition. This button allows users to remove individual conditions from the filter.

    image

    Text

    Renders filter criteria in a text-based format.

    image

    Property Paths

    You can access this nested property as listed below:

    Object Type Path to FilterCriteriaDisplayStyle
    XRDesignMdiController
    .DesignSettings .FilterCriteriaDisplayStyle

    Remarks

    You can toggle the filter criteria render format on application startup.

    FilterCriteriaDisplayStyle

    The Visual format renders filter criteria in an easy-to-read format and uses skin-based colored highlights to differentiate between column names, functions and values. In the Filter Panel, the ‘x’ button is displayed when users hover over a condition. This button removes individual conditions from the filter.

    The Text format renders filter criteria in a text-based format.

    Example

    The code sample below illustrates how to switch the filter criteria display format to text.

    using DevExpress.XtraEditors;
    using DevExpress.XtraReports.UI;
    using DevExpress.XtraReports.UserDesigner;
    // ...
    XtraReport report = new XtraReport();
    XRDesignRibbonForm form = new XRDesignRibbonForm();
    // Set the FilterString Editor's filter criteria display format to Text within a specific form.
    WindowsFormsSettings.FilterCriteriaDisplayStyle = FilterCriteriaDisplayStyle.Text;
    // Set the FilterString Editor's filter criteria display format to Text within an entire application.
    form.DesignMdiController.DesignSettings.FilterCriteriaDisplayStyle = FilterCriteriaDisplayStyle.Text;
    form.OpenReport(report);
    form.ShowDialog();
    
    See Also