2024年终活动

DevExpress控件使用交流,DevExpress中国社区Dev联系电话 联系电话:023-68661681

看界面控件DevExpress WinForms——如何自定义辅助功能属性(上)

来源:   发布时间:2022-07-13   浏览:1079次

在官方最近的几个新版发布周期中,为 DevExpress WinForm 产品线添加了许多创新功能,包括:

  • 受 Web 启发的 HTML 和 CSS 模板。
  • 支持DirectX并在功能的底层利用DirectX 引擎(受Windows 10启发的Fluent Form和Fluent Splash Screen、v22.1 DirectX Form、文本编辑器的高级模式等)。
  • 控件中的矢量皮肤和 SVG 图像。
  • 无需导入自定义皮肤程序集即可更改标准 DevExpress 皮肤的功能。
  • ······

一个非常重要(并且不断增强)的功能是可访问性的支持,在最近更新的v22.1中包括一个新的 DXAccessible.QueryAccessibleInfo 事件 — 一个强大的功能,它将辅助功能自定义或 UIAutomation 提升到一个全新的水平。本文中将演示一些在过去只能使用内部 WinForms 类的后代来解决的可访问性自定义任务。

获取DevExpress WinForms v22.1正式版下载

在开始之前

在这篇文章中将使用Microsoft Inspect检索各个UI元素的可访问性信息,尽管与 Accessibility Insights 应用程序相比,Inspect 可能已经过时,但它仍然是一个强大的工具,可以与完美的实用程序一起使用。

Inspect 是 Windows SDK 安装中包含的免费工具。 安装后,您可以在 C:\Program Files (x86)\Windows Kits\10\bin\sdk_build_version\x64 文件夹中找到“inspect.exe”文件。

放大镜按钮

运行Inspect工具并将鼠标悬停在ColorEdit的放大镜按钮上(可以在"Data Editors | Color Edit" 示例模块中找到示例编辑器)。

如图所示,可访问的按钮名称是“Glyph”。这是由辅助功能客户端(例如Windows Narrator)大声朗读的名称,它没有说明按钮的实际作用。

看界面控件DevExpress WinForms——如何自定义辅助功能属性(上)

要解决此问题并分配更合理的辅助功能名称,请处理新的 QueryAccessibleInfo 事件,如下所示。

using DevExpress.Accessibility;

public MyForm() {
InitializeComponent();
// ...
DXAccessible.QueryAccessibleInfo += (s, e) => {
if (e.OwnerControl == this.colorEdit1 && e.Name == "Glyph")
e.Name = "Magnifier";
};
}
看界面控件DevExpress WinForms——如何自定义辅助功能属性(上)
网格行名称

切换到同一示例的"Inplace Grid Cell Editors" 模块并检查网格单元名称,辅助功能树如下所示:

看界面控件DevExpress WinForms——如何自定义辅助功能属性(上)

行简称为 "Row 1", "Row 2", "Row 3"等,单元格名称为“Editor Name Row N”和“Value row N”。虽然这些名称让用户对当前鼠标指针位置有一个模糊的了解,但 QueryAccessibleInfo 事件允许我们指定更准确的行和单元格名称。

using DevExpress.Accessibility;

DXAccessible.QueryAccessibleInfo += (s, e) => {
if (e.OwnerControl == gridControl1) {
if (e.Role == AccessibleRole.Cell) {
if (e.Name.StartsWith("Editor Name"))
e.Name = "Editor Name";
else if (e.Name.StartsWith("Value"))
e.Name = e.AccessibleObject.Parent.GetChild(0).Value + " Value";
}
if (e.Role == AccessibleRole.Row)
e.Name = e.AccessibleObject.GetChild(0).Value + " Row";
}
/* For builds of v22.1.3 and older
if(e.Role == AccessibleRole.ListItem && e.Name.StartsWith("Row"))
e.Role = AccessibleRole.Row;
if (e.Role == AccessibleRole.Row)
e.Name = e.AccessibleObject.GetChild(0).Value; */
};
看界面控件DevExpress WinForms——如何自定义辅助功能属性(上)

v22.1.3 和更早的版本需要注释块,因为在这些版本中,网格行的 AccessibleRole 错误地返回了“ListItem”,官方已经在最新版本中修复了这个问题(除了之前实施的许多其他修复)。

DevExpress WinForm | 下载试用

DevExpress WinForm拥有180+组件和UI库,能为Windows Forms平台创建具有影响力的业务解决方案。DevExpress WinForms能完美构建流畅、美观且易于使用的应用程序,无论是Office风格的界面,还是分析处理大批量的业务数据,它都能轻松胜任!


DevExpress技术交流群6:600715373      欢迎一起进群讨论

更多DevExpress线上公开课、中文教程资讯请上中文网获取

DevExpress企业定制服务
本站文章除注明转载外,均为本站原创或翻译
欢迎任何形式的转载,但请务必注明出处,尊重他人劳动成果
转载请注明:文章转载自:DevExpress控件中文网 [https://www.devexpresscn.com/]
本文地址:https://www.devexpresscn.com/post/3158.html

相关产品: DevExpress Universal Subscription,

扫码咨询
电话咨询
023-68661681
返回
顶部