共用方式為


標題列 (MSAA UI 元素參考)

注意

本主題描述 標題列 物件,以用於 MSAA UI 元素參考。 此處未說明如何在各種UI架構中建立 標題列 物件。 如需您使用的 UI 架構,請參閱 API 參考檔。

視窗頂端的標題列會顯示應用程式定義的圖示和文字行。 文字會指定應用程式的名稱,並指出視窗的用途。 標題列也可讓使用者使用滑鼠或其他指向裝置來移動視窗。

標題列至少包含三個小按鈕,可將標題列最小化、最大化或還原,並關閉與標題列相關聯的視窗。 標題欄也包含內容敏感的 [說明] 按鈕。 在 windows 作系統 Far-East 版本中執行的應用程式也可能包含輸入法編輯器 (IME) 按鈕。 Microsoft Active Accessibility 會將這些按鈕公開為標題欄的子元素。

IAccessible 方法

標題列支援下列 IAccessible 方法:

IAccessible 屬性

標題列支援下列 IAccessible 屬性:

財產 評論
get_accChildCount ChildCount 屬性為五。 ChildCount 屬性包含 IME 和上下文相關 [說明] 按鈕,即使它們未顯示也一樣。 未顯示的按鈕具有 State 屬性 STATE_SYSTEM_INVISIBLE
get_accDescription 標題欄本身的 Description 屬性為:「顯示視窗的名稱,並包含要作它的控制項」。標題列中的子按鈕具有下列描述:
  • 「將視窗移出
  • 「使視窗已滿
  • 「將最小化或
  • 「關閉視窗」
  • 「輸入或離開內容-
  • 「按下時啟動鍵盤」
get_accName 標題欄本身不支援 Name 屬性。 標題列中的子按鈕具有下列名稱:
  • “最小化”
  • 最大化“ 或 「Restore」,
  • “Close”
  • 「內容說明」
  • “IME”
get_accParent 標題列的 Parent 屬性是主應用程式視窗(ROLE_SYSTEM_WINDOW),其應用程式定義的視窗類別名稱與標題列相同。
get_accRole Role 屬性是 ROLE_SYSTEM_TITLEBAR。 標題列中的子按鈕具有 Role 屬性 ROLE_SYSTEM_PUSHBUTTON
get_accState 標題列和子按鈕的 State 屬性可以是下列一或多個 值的組合STATE_SYSTEM_FOCUSABLE
STATE_SYSTEM_INVISIBLE
STATE_SYSTEM_OFFSCREEN
STATE_SYSTEM_UNAVAILABLE
STATE_SYSTEM_PRESSED
get_accValue Value 屬性是字串,與標題欄中顯示的文字相同。

筆記

  • 雖然應用程式的標題列具有 State 屬性旗標 STATE_SYSTEM_FOCUSABLE,但從未 State 旗標 STATE_SYSTEM_FOCUSED。 將焦點設定為標題欄物件會將焦點放在應用程式視窗。
  • 因為標題欄物件不支援 get_accChild,標題欄上的按鈕是簡單的元素。 它們不支援 IAccessible介面本身。 標題欄物件會提供這些子按鈕的相關信息。
  • 因為標題列不會取得焦點,而且沒有默認動作,因此此控件不支援 accDoDefaultActionget_accDefaultAction 方法。

IAccessible 介面