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.v24.2.Extensions.dll
NuGet Package: DevExpress.Win.Reporting
#Declaration
[DefaultValue(FilterCriteriaDisplayStyle.Default)]
public FilterCriteriaDisplayStyle FilterCriteriaDisplayStyle { get; set; }
#Property Value
Type | Default | Description |
---|---|---|
Filter |
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 Windows |
Available values:
Name | Description |
---|---|
Default | When a control’s Filter 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. |
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. |
Text | Renders filter criteria in a text-based format. |
#Property Paths
You can access this nested property as listed below:
Object Type | Path to Filter |
---|---|
XRDesign |
|
#Remarks
You can toggle the filter criteria render format on application startup.
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.
- The WindowsFormsSettings.FilterCriteriaDisplayStyle global property specifies how to render filter criteria in all data-aware controls and Filter Editors.
- The FilterCriteriaDisplayStyle property overrides the render format for a specific Report Designer instance.
#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();