功能表項目 (MSAA UI 元素參考)
注意
本主題描述 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 屬性是 「Open」 或 「Close」。 所有其他功能表項目的 DefaultAction 屬性為 「Execute」。 |
get_accFocus | |
get_accKeyboardShortcut | KeyboardShortcut屬性是功能表項目的存取鍵,這是功能表項目名稱文字中的加底線字元。 例如,File 功能表項目的 KeyboardShortcut 屬性是 「f」。 |
get_accName | Name屬性與功能表項目的名稱相同。 |
get_accParent | Parent屬性是包含功能表項目的功能表列或快顯功能表。 |
get_accRole | Role屬性ROLE_SYSTEM_MENUITEM。 |
get_accState |
State屬性STATE_SYSTEM_INVISIBLE或下列一或多個值的組合:STATE_SYSTEM_UNAVAILABLE | 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 屬性的 「應用程式」,而不是功能表項目的名稱。