為 Windows Form 上的控制項提供可及性資訊

發行項
08/12/2011

協助工具輔助是特定程式和裝置，可以協助殘障人士更有效率地使用電腦。其範例包含可供盲人使用的螢幕讀取器，以及讓使用者提供口頭指令而不使用滑鼠或鍵盤的語音輸入公用程式。這些協助工具輔助會和 Windows Form 控制項所公開的可及性屬性 (Property) 進行互動。這些屬性 (Property) 為：

AccessibilityObject
AccessibleDefaultActionDescription
AccessibleDescription
AccessibleName
AccessibleRole

AccessibilityObject 屬性

本唯讀屬性 (Property) 包含 AccessibleObject 類別執行個體。 AccessibleObject 會實作 IAccessible 介面，此介面提供有關控制項說明、螢幕位置、巡覽能力和值的資訊。當控制項加入表單時，設計工具會設定此數值。

AccessibleDefaultActionDescription 屬性

本字串描述控制項的動作。它不會在 [屬性] 視窗中出現，只能在程式碼中設定。下列範例是為按鈕控制項設定此屬性 (Property)：

' 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 屬性

本屬性 (Property) 包含 AccessibleRole 列舉型別，描述控制項的使用者介面角色。新的控制項會將數值設定為 Default。這表示依預設值，Button 控制項會當成 Button 使用。若控制項有另一個角色時，您可能會想要重新設定這個屬性 (Property)。例如，您可能將 PictureBox 控制項當成 Chart 使用，且希望協助工具輔助將角色當成 Chart 來報告，而非 PictureBox。您也可能為所開發的自訂控制項指定這個屬性 (Property)。本屬性可以在 [屬性] 視窗中設定，或如下所示在程式碼中設定：

' Visual Basic
PictureBox1.AccessibleRole = AccessibleRole.Chart

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

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