注意
本主題描述 MSAA UI 元素參考的目的,功能表項 物件。 此處未說明如何在各種UI架構中建立 功能表項 物件。 如需您使用的 UI 架構,請參閱 API 參考檔。
功能表項代表功能表列或快捷選單中的特定專案。 例如,Microsoft Active Accessibility 會在功能表欄中建立 檔案 選單的功能表項物件。 同樣地,Microsoft Active Accessibility 會從 [檔案] 快捷功能表,為 [開啟] 功能表項建立功能表項的功能表項物件。
功能表項的窗口類別名稱為 “#32768”。
IAccessible 方法
選單項支援下列 IAccessible 方法:
| 方法 | 評論 |
|---|---|
| accDoDefaultAction | 對於功能表欄的功能表項,accDoDefaultAction 會根據功能表的狀態顯示或關閉功能表。 對於快捷功能表的功能表項,accDoDefaultAction 按單單項來執行功能表命令。 |
| acchittest | |
| accLocation | |
| accNavigate | |
| accSelect |
IAccessible 屬性
選單項支援下列 IAccessible 屬性:
| 財產 | 評論 |
|---|---|
| get_accChild | 擷取此專案的快顯功能表物件 IDispatch 介面。 |
| get_accChildCount | ChildCount 屬性是顯示功能表或子選單的功能表項之一;否則,ChildCount 屬性為零。 |
| get_accDefaultAction | 顯示功能表或子功能表之功能表項的 DefaultAction 屬性會根據功能表的狀態而「開啟」或「關閉」。 所有其他功能表項的 DefaultAction 屬性為 “Execute”。 |
| get_accFocus | |
| get_accKeyboardShortcut | KeyboardShortcut 屬性是功能表項的訪問鍵,這是功能表項名稱文字中的加底線字元。 例如,KeyboardShortcut 屬性的File 功能表項是 “f”。 |
| get_accName | Name 屬性與功能表項的名稱相同。 |
| get_accParent | Parent 屬性是包含功能表項的功能表列或快捷選單。 |
| get_accRole | Role 屬性 ROLE_SYSTEM_MENUITEM。 |
| get_accState |
State 屬性是下列一或多個值的 STATE_SYSTEM_INVISIBLE 或組合:STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_CHECKED | STATE_SYSTEM_DEFAULT | STATE_SYSTEM_HOTTRACKED | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_HASPOPUP |
筆記
- 在功能表項上使用時,accDoDefaultAction 會傳回S_OK,但如果存取鍵中使用的字元是 @?, !, @,或是需要SHIFT鍵或其他修飾詞索引鍵的任何其他字元,則無法執行動作。 這也會發生在具有需要按下 ALT GR 鍵的存取鍵字元的國際鍵盤上。
- 具有 SELFLAG_TAKEFOCUS 的 accSelect 方法不會造成功能表項開啟或關閉快捷功能表。 用戶端會使用 accDoDefaultAction 方法來開啟或關閉快捷功能表。
- 不顯示快捷功能表的功能表欄項目會傳回 Name 屬性的 「應用程式」,而不是功能表項的名稱。