工具列控制件 (MSAA UI 元素參考)
注意
本主題描述 用於 MSAA UI 元素參考的工具列控件 物件。 此處未說明如何在各種UI架構中建立 工具列控件 物件。 如需您使用的 UI 架構,請參閱 API 參考檔。
工具列控制件包含執行功能表命令的按鈕,通常包含在功能表欄下方的視窗中。
工具列控件的視窗類別名稱是 TOOLBARCLASSNAME,在 Commctrl.h 中定義為 “ToolbarWindow32”。
IAccessible 方法
工具列控制件支援下列 IAccessible 方法:
方法 | 註解 |
---|---|
accDoDefaultAction | 工具欄本身確實支援 accDoDefaultAction 方法。 針對工具列上的按鈕,accDoDefaultAction 會使用BM_CLICK訊息呼叫 PostMessage,以按下指定的按鈕。 |
accHitTest | |
accLocation | |
accNavigate | |
accSelect |
IAccessible 屬性
工具列控制件支援下列 IAccessible 屬性:
屬性 | 註解 |
---|---|
get_accChild | |
get_accChildCount | ChildCount 屬性是工具列中包含的控件數目。 |
get_accDefaultAction | 工具欄物件本身沒有 DefaultAction 屬性。 工具列按鈕的DefaultAction屬性取決於工具列按鈕樣式。 具有樣式的按鈕TBSTYLE_DROPDOWN具有 「Open」 做為其 DefaultAction 屬性。 所有其他工具列按鈕的DefaultAction屬性為 「Press」。。 |
get_accDescription | |
get_accFocus | |
get_accHelp | |
get_accHelpTopic | |
get_accKeyboardShortcut | 工具列沒有鍵盤快捷方式。 不過,如果工具列的視窗文字包含 ampersand (&) 字元,Microsoft Active Accessibility 會傳回非 Null 字串做為 KeyboardShortcut 屬性。 |
get_accName | 工具列的 Name 屬性是從控件的視窗文字 (或 標題) 取得。 此文字不會與工具列一起顯示,因此伺服器開發人員必須在控件的資源定義語句中提供有意義的文字,以協助用戶端公用程式的用戶識別控件。 您可以使用 SetWindowText 函式來設定視窗文字。 |
get_accParent | Parent 屬性是圍繞控件的視窗 (ROLE_SYSTEM_WINDOW),而且與控件具有相同的 Name 屬性和視窗類別名稱。 |
get_accRole | Role 屬性是ROLE_SYSTEM_TOOLBAR。 |
get_accSelection | |
get_accState | 工具列本身的 State 屬性值為零,這表示對像是可見的。 工具列按鈕之 State 屬性的可能值為:STATE_SYSTEM_INVISIBLE 或 | STATE_SYSTEM_UNAVAILABLE STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_MOVEABLE | STATE_SYSTEM_FOCUSED STATE_SYSTEM_FOCUSABLE | |
備註
工具列上的按鈕會傳送 EVENT_OBJECT_STATECHANGE 事件。