界面控件DevExpress WinForms - 为何弃用受关注的MaskBox属性？-控件新闻-慧都网

界面控件DevExpress WinForms - 为何弃用受关注的MaskBox属性？

原创|行业资讯|编辑：龚雪|2022-07-27 10:48:28.377|阅读 71 次

概述：本文将为大家揭秘DevExpress炙手可热的WinForms控件为何要在新版中弃用受关注的MaskBox属性，欢迎下载最新版产品体验！

在官方技术团队发布的v20.2版本周期中，宣布了高级文本编辑器模式的可用性，高级文本编辑器模式引入了许多具有影响力的功能，包括插入符号/选择动画支持和嵌入式文本标签。在当时的发布公告中详细说明了未来的计划，以及官方技术团队在所有报告的问题得到解决后将其设为默认编辑器模式，虽然还没有将此设置为默认模式，但最新的WXI皮肤是朝着这个目标迈出的一大步。

界面控件DevExpress WinForms - 为何弃用受关注的MaskBox属性？

当WXI皮肤处于激活状态时，所有文本编辑器都会切换到此高级模式。在这方面，有色文本选择可能是一个线索，但它肯定不是切换的唯一原因。在新的 WXI 皮肤中，编辑器使用与不同编辑器状态相对应的附加背景元素，更多元素意味着额外的客户区和边界计算、增加的边界和内容绘制逻辑以及整体复杂性的增加。在标准模式下解决这些挑战会产生副作用和伪影，因此技术团队决定利用高级模式的力量来解决这些问题。

在WXI皮肤中使用高级模式引发了围绕遗留代码（专为遗留、非高级编辑器模式编写的代码）兼容性的内部讨论，最受关注的当然是属性。此属性允许您获得标准的 WinForms 文本框控件（DevExpress WinForms TextEdit 编辑器的基础），但高级模式下的TextEdits是完整的自定义控件并且不再基于标准，这些编辑器的 MaskBox 属性返回 null（在 VB.NET 中为空）。

技术团队分许了许多支持中心的问题，来寻找需要通过MaskBox 属性访问标准文本框的实际用例。根据研究表明，这些案例中大多数属于两个主要类别：自动完成和文本处理（包括自定义输入掩码）。

文本自动完成

现在可以通过本机 TextEditor API 使用自动完成功能，要引入自动完成功能，请设置 Editor.AdvancedModeOptions.AutoCompleteSource 属性以指定编辑器是否建议来自您的自定义数据源或自动填充源的条目（最近的项目、历史列表中的 URL、系统文件和文件夹名称等）。您需要指定适当的模式（Suggest、Append、两者的组合或 SuggestSingleWord），并分配自定义数据源（如果选择了CustomSource自动完成模式）。

using DevExpress.XtraEditors;

void OnFormLoad(object sender, EventArgs e) {
var DaysOfTheWeek = new AutoCompleteStringCollection();
DaysOfTheWeek.AddRange(new string[]
{"Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"});

textEdit1.Properties.UseAdvancedMode = DevExpress.Utils.DefaultBoolean.True;
textEdit1.Properties.AdvancedModeOptions.AutoCompleteMode =
TextEditAutoCompleteMode.SuggestAppend;
textEdit1.Properties.AdvancedModeOptions.AutoCompleteSource =
AutoCompleteSource.CustomSource;
textEdit1.Properties.AdvancedModeOptions.AutoCompleteCustomSource = DaysOfTheWeek;
}

掩码和文本处理 API

在之前的发布周期中，我们引入了一系列方法来帮助获取和修改编辑器文本：

和其他（请参阅的 TextEdit 方法的完整列表）

这些方法与标准TextBox方法相同，例如。如果您检索标准TextBox来利用其方法，现在可以使用本机TextEdit API来获得相同的结果。

至于低级输入掩码，我们最近添加了方法，此方法允许您手动跟踪用户操作并根据需要分配编辑器值。

例如，如果您需要限制用户输入的字节数，以前的版本要求您使用重写的 TextEdit.CreateMaskBoxInstance 方法实现自定义 TextEdit 后代，该方法接受自定义 TextBoxMaskBox 对象。然后，这个自定义类将处理用户输入。

使用方法，您不再需要任何继承逻辑，只需在分配的回调中直接检查字节长度。

using DevExpress.Data.Mask;

int m_maxByteLength = 5;

textEdit1.Properties.EnableCustomMaskTextInput(args => {
// Do nothing if no edits were made
if (args.IsCanceled || args.ActionType == CustomTextMaskInputAction.Init)
return;

if (GetByteLength(args.ResultEditText) > m_maxByteLength) {
args.Cancel();
return;
}
args.SetResult(
args.ResultEditText, args.ResultCursorPosition, args.ResultSelectionAnchor);
});

int GetByteLength(string text) {
return System.Text.Encoding.Default.GetBytes(text).Length;
}