为 Windows 窗体上的控件提供辅助功能信息

2008-08-18

更新：2007 年 11 月

辅助功能是一些专用的程序和设备，用于帮助残疾人更有效地使用计算机。这方面的示例包括为盲人提供的屏幕读取器，以及为提供口头命令而不是使用鼠标或键盘的人们所提供的语音输入实用工具。这些辅助功能与由 Windows 窗体控件公开的辅助功能属性交互。这些属性是：

AccessibilityObject
AccessibleDefaultActionDescription
AccessibleDescription
AccessibleName
AccessibleRole

AccessibilityObject 属性

此只读属性包含一个 AccessibleObject 类实例。AccessibleObject 实现了 IAccessible 接口，此接口提供关于控件的描述、屏幕位置、定位功能和值的信息。设计人员在将控件添加到窗体时设置此值。

AccessibleDefaultActionDescription 属性

此字符串描述控件的操作。它并不出现在“属性”窗口中，而或许只能在代码中设置。下列示例为一个按钮 (Button) 控件设置了此属性：

' Visual Basic
Button1.AccessibleDefaultActionDescription = _
   "Closes the application."

// C#
Button1.AccessibleDefaultActionDescription = 
   "Closes the application.";

// C++
button1->AccessibleDefaultActionDescription =
   "Closes the application.";

AccessibleDescription 属性

此字符串描述控件。它可以在“属性”窗口中设置，或者如下所示在代码中设置：

' Visual Basic
Button1.AccessibleDescription = "A button with text 'Exit'."

// C#
Button1.AccessibleDescription = "A button with text 'Exit'";

// C++
button1->AccessibleDescription = "A button with text 'Exit'";

AccessibleName 属性

这是报告给辅助功能的控件的名称。它可以在“属性”窗口中设置，或者如下所示在代码中设置：

' Visual Basic
Button1.AccessibleName = "Order"

// C#
Button1.AccessibleName = "Order";

// C++
button1->AccessibleName = "Order";

AccessibleRole 属性

此属性包含 AccessibleRole 枚举枚举，用以描述控件的用户界面角色。新控件将该值设置为 Default。这意味着默认情况下，Button 控件充当 Button。如果控件还具有其他角色，您可能想重置此属性。例如，可以将 PictureBox 控件用作 Chart，而您可能想使辅助功能将其角色报告为 Chart 而不是 PictureBox。您还可能希望为已经开发的自定义控件指定此属性。该属性可以在“属性”窗口中设置，或者如下所示在代码中设置：

' Visual Basic
PictureBox1.AccessibleRole = AccessibleRole.Chart

// C#
PictureBox1.AccessibleRole = AccessibleRole.Chart;

// C++
pictureBox1->AccessibleRole = AccessibleRole::Chart;