看界面控件DevExpress WinForms——如何自定义辅助功能属性（上）-控件新闻-慧都网

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

翻译|使用教程|编辑：龚雪|2022-07-13 10:08:46.430|阅读 71 次

概述：本文主要为大家介绍如何在使用DevExpress WinForms控件自定义辅助功能属性，欢迎下载最新版产品体验哦~

在开始之前

在这篇文章中将使用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";
};
}

网格行名称

切换到同一示例的"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; */
};