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

最新推荐文章于 2023-03-02 21:29:42 发布

界面开发小八哥

最新推荐文章于 2023-03-02 21:29:42 发布

阅读量269

点赞数

文章标签：界面控件 ui devexpress winform

本文链接：https://blog.csdn.net/AABBbaby/article/details/125777615

版权

在官方最近的几个新版发布周期中，为 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）大声朗读的名称，它没有说明按钮的实际作用。

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

using DevExpress.Accessibility;

public MyForm() {
InitializeComponent();
// ...
DXAccessible.QueryAccessibleInfo += (s, e) => {
if (e.OwnerControl == this.colorEdit1 && e.Name == "Glyph")
e.Name = "Magnifier";
};
}

网格行名称

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

行简称为 "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; */
};