为控件提供辅助功能信息(Windows 窗体 .NET)
辅助工具是专用的程序和设备,用于帮助残障人士更加有效地使用计算机。 示例包括适用于盲人的屏幕阅读器,还有声音输入实用功能,方便人们发出声音命令,而不使用鼠标或键盘。 这些辅助工具与由 Windows 窗体控件公开的辅助功能属性相交互。 这些属性为:
- System.Windows.Forms.AccessibleObject
- System.Windows.Forms.Control.AccessibleDefaultActionDescription
- System.Windows.Forms.Control.AccessibleDescription
- System.Windows.Forms.Control.AccessibleName
- System.Windows.Forms.AccessibleRole
重要
面向 .NET 7 和 .NET 6 的桌面指南文档正在撰写中。
AccessibilityObject 属性
此只读属性包含 AccessibleObject 实例。 AccessibleObject
实现了 IAccessible 接口,它提供了有关控件的说明、屏幕位置、导航功能和值的信息。 在将控件添加到窗体时,设计器会设置此值。
AccessibleDefaultActionDescription 属性
该字符串描述控件的操作。 它不显示在“属性”窗口中,可能只在代码中被设置。 下面的示例为按钮控件设置 AccessibleDefaultActionDescription 属性:
Button1.AccessibleDefaultActionDescription = "Closes the application."
button1.AccessibleDefaultActionDescription = "Closes the application.";
AccessibleDescription 属性
该字符串描述控件。 AccessibleDescription 属性可能在“属性”窗口或代码中被设置,如下所示:
Button1.AccessibleDescription = "A button with text 'Exit'."
button1.AccessibleDescription = "A button with text 'Exit'";
AccessibleName 属性
这是报告给辅助工具的控件名称。 AccessibleName 属性可能在“属性”窗口或代码中被设置,如下所示:
Button1.AccessibleName = "Order"
button1.AccessibleName = "Order";
AccessibleRole 属性
此属性描述控件的用户接口角色,其中包含 AccessibleRole 枚举。 新控件的值设置为 Default
。 这意味着默认情况下,Button
控件充当 Button
。 如果控件具有另一个角色,你可能希望重置此属性。 例如,你可能正将 PictureBox
控件用作 Chart
,并且可能希望辅助工具将角色报告为 Chart
,而非 PictureBox
。 你可能还希望为已开发的自定义控件指定此属性。 此属性可能在“属性”窗口或代码中被设置,如下所示:
PictureBox1.AccessibleRole = AccessibleRole.Chart
pictureBox1.AccessibleRole = AccessibleRole.Chart;
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈