DevExpress Winforms使用技巧教程：掌握Filter Editor（一）

DevExpress WinForms安装附带两个允许最终用户构建过滤器查询的控件：提供GUI的Filter控件和将Filter控件与基于文本输入的面板组合在一起的Filter Editor控件。

DevExpress Winforms Controls 内置140多个UI控件和库，完美构建流畅、美观且易于使用的应用程序。想要体验击下载>>

DevExpress WinForms安装附带两个允许最终用户构建过滤器查询的控件：提供GUI的Filter控件和将Filter控件与基于文本输入的面板组合在一起的Filter Editor控件。WinForms中，大多数数据感知控件都使用这些组件，但是您也可以将其包含在自己的表单中，并根据需要将其绑定到数据感知控件中。

为了说明这一点，下面是带有Filter Editor的数据 格，用户可以单击过滤器面板中的Edit Filter按钮来调出Filter Editor，并且由于属性DefaultFilterEditorView设置为TextAndVisual，因此可以看到Filter Editor Control的文本面板。

在下图中，您可以看到两个控件中可用的一些标准功能，包括“小于或等于”，“大于或等于”，“今天”，“昨天”以及许多其他功能。Filter控件和Filter Editor控件均提供多种功能供您选择，可用功能集因要为其构建表达式的数据字段的类型而异。

自定义函数

在某些情况下，标准函数集还不够。技术团队在处理大量技术支持问题发现，查找是最常见需要的自定义函数。以下是三种最受欢迎的方案：

• 标准函数的倒置，可以在filter editor中手动应用这些，但是对于频繁使用，自定义函数更方便。
• 表示复杂表达式的标准函数组合的函数。 例如，Within Days of X函数可能包含行，其中字段值在给定日期之前或之后的N天内，这省去了用户在两个不同日期之间配置标准函数的工作量。
• 自定义DateTime函数，例如Is Weekend，N Days Ago等。

从v19.1开始，Filter Editor控件和Filter控件完全支持自定义函数，从而可以轻松实现上述方案和许多其他方案。

技术基础

这些是接口实现所需的方法和属性：

• Name – 您用来从代码中引用自定义函数的技术功能名称
• DisplayName – GUI中显示的可读函数名称。 例如，名称为NotStartsWith的函数的DisplayName可能不是开头的
• Image – Filter Control菜单中为该函数显示的图标，该属性类型为Object，但是下面的示例显示了如何使用现有的标准图像，也可以分配图像对象
• Category – Expression Editor的函数类别，如果您打算仅将函数用于过滤器，则这无关紧要
• MinOperatorCount, MaxOperatorCount, IsValidOperandCount – 该函数支持运算符数量，对于Filter和Filter Editor控件，所有三个值可以相等。 如果计划在Expression Editor中使用函数，则可以灵活地支持可变数量的运算符。
• IsValidOperandType – 调用每个操作数来检查是否具有有效的类型，仅检查第一个操作数的筛选器
• ResultType – 函数的返回值类型，Filter控件仅显示具有布尔结果类型的函数
• Evaluate – 该函数在函数每次对一个数据字段求值时都会调用的方法，值在操作数数组中传递。 返回true包括相关行，返回false排除相关行。

最后，我们建议添加两个静态便利函数Register和Unregister。 这是一个可选步骤，但是实现很简单（请参见下文），并且它们以CriteriaOperator类型调用现有的帮助器。

示例

供您参考，下面是三个示例，它们涵盖了上面提到的三个最需要的方案。 第一个自定义函数称为NotBeginsWith，它是对标准函数BeginsWith的取反。

public class NotBeginsWithFunction : ICustomFunctionDisplayAttributes {public const string FunctionName = "NotBeginsWith";static readonly NotBeginsWithFunction instance = new NotBeginsWithFunction();public static void Register() {CriteriaOperator.RegisterCustomFunction(instance);}public static bool Unregister() {return CriteriaOperator.UnregisterCustomFunction(instance);}public string Name => FunctionName;public string DisplayName => "Does not begin with";public object Image => "FontSizeDecrease;Office2013";public string Description =>"Hides records when the field begins with the given value";public FunctionCategory Category => FunctionCategory.Text;public int MinOperandCount => 2;public int MaxOperandCount => 2;public bool IsValidOperandCount(int count) => count == 2;public bool IsValidOperandType(int operandIndex, int operandCount,Type type) => type == typeof(string);public Type ResultType(params Type[] operands) => typeof(bool);public object Evaluate(params object[] operands) {if(operands[0] != null && operands[1] != null) {string str1 = operands[0].ToString();string str2 = operands[1].ToString();return !str1.StartsWith(str2, StringComparison.InvariantCultureIgnoreCase);}return false;}}

这是第二个自定义函数InternalDaysOfToday，用于检查DateTime值是否在今天-N天和今天+ N天的时间范围内。

public class WithinDaysOfTodayFunction : ICustomFunctionDisplayAttributes {public const string FunctionName = "WithinDaysOfToday";static readonly WithinDaysOfTodayFunction instance =new WithinDaysOfTodayFunction();public static void Register() {CriteriaOperator.RegisterCustomFunction(instance);}public static bool Unregister() {return CriteriaOperator.UnregisterCustomFunction(instance);}public string Name => FunctionName;public string DisplayName => "Within days of today";public object Image => "SwitchTimeScalesTo;Size16x16;Colored";public string Description =>"Shows records when the field value within X days of today";public FunctionCategory Category => FunctionCategory.DateTime;public int MinOperandCount => 2;public int MaxOperandCount => 2;public bool IsValidOperandCount(int count) => count == 2;public bool IsValidOperandType(int operandIndex, int operandCount,Type type) => operandIndex == 0 && type == typeof(DateTime) ||operandIndex == 1 && type == typeof(int);public Type ResultType(params Type[] operands) => return typeof(bool);public object Evaluate(params object[] operands) {DateTime dt = Convert.ToDateTime(operands[0]);int days = Convert.ToInt32(operands[1]);DateTime start = DateTime.Today.AddDays(-days);DateTime end = DateTime.Today.AddDays(days);return dt >= start && dt <= end;}}

最后，IsWeekend测试DateTime值是星期六还是星期天。

public class IsWeekendFunction : ICustomFunctionDisplayAttributes {public const string FunctionName = "IsWeekend";static readonly IsWeekendFunction instance = new IsWeekendFunction();public static void Register() {CriteriaOperator.RegisterCustomFunction(instance);}public static bool Unregister() {return CriteriaOperator.UnregisterCustomFunction(instance);}public string Name => FunctionName;public string DisplayName => "Is weekend";public object Image => "DayView;Office2013";public string Description =>"Shows records when the field value is on Saturday or Sunday";public FunctionCategory Category => FunctionCategory.DateTime;public int MinOperandCount => 1;public int MaxOperandCount => 1;public bool IsValidOperandCount(int count) => count == 1;public bool IsValidOperandType(int operandIndex, int operandCount,Type type) => type == typeof(DateTime);public Type ResultType(params Type[] operands) => typeof(bool);public object Evaluate(params object[] operands) {DateTime dt = Convert.ToDateTime(operands[0]);return dt.DayOfWeek == DayOfWeek.Sunday ||dt.DayOfWeek == DayOfWeek.Saturday;}}

DevExpress v19.2线上公开课即将开课，前10名免费参与哦~

DevExpress技术交流群：540330292      欢迎一起进群讨论