共用方式為

捲軸 (MSAA UI 元素參考)

  • 發行項

注意

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

 

捲軸可讓使用者選擇方向和距離，在相關的視窗或清單方塊中捲動資訊。 捲軸的視窗類別名稱是 「SCROLLBAR」。

IAccessible屬性的內容取決於捲軸是垂直還是水準，以及用戶端正在查詢捲軸的下列哪一部分：

  • 捲軸本身
  • 頂端或向右鍵按鈕
  • 底部或向左鍵按鈕
  • 捲動方塊 (指紋)
  • 頁面向上或頁面右區域
  • 頁面向下或頁面左區域

IAccessible 方法

捲軸支援下列 IAccessible 方法：

  • accDoDefaultAction — 捲軸物件本身和捲軸指紋不支援 accDoDefaultAction 方法。

    針對垂直捲動條上的其他捲軸元件，accDoDefaultAction會呼叫PostMessage，並將wParam設定為下列值WM_VSCROLL訊息。

    按鈕/區域 Vaule
    頂端箭頭按鈕 SB_LINEUP
    向下箭號按鈕 SB_LINEDOWN
    向上頁區域 SB_PAGEUP
    頁面向下區域 SB_PAGEDOWN

     

    針對水準捲軸上的其他捲軸元件，accDoDefaultAction會呼叫PostMessage，並將wParam設定為下列值WM_HSCROLL訊息。

    按鈕/區域 值
    向左鍵按鈕 SB_LINELEFT
    右箭頭按鈕 SB_LINERIGHT
    頁面左區域 SB_PAGELEFT
    頁面右區域 SB_PAGERIGHT

     

  • accHitTest

  • accLocation

  • accNavigate

IAccessible 屬性

捲軸支援下列 IAccessible 屬性：

  • get_accChildCount— 捲軸物件的 ChildCount 屬性是五個。 對於其他捲軸元件， ChildCount 屬性為零。

  • get_accDefaultAction— 捲軸物件本身和捲軸指紋不支援 DefaultAction 屬性。 箭頭按鈕的 DefaultAction 屬性，以及捲動指紋任一邊的陰影區域為 「Press」。

  • get_accDescription— Description 屬性取決於查詢的捲軸部分。

    垂直捲動條的元件具有下列描述。

    部分 描述
    捲軸本身 「用來變更垂直檢視區域」
    頂端箭頭按鈕 「將垂直位置向上移動一行」
    向下箭號按鈕 「將垂直位置向下移動一行」
    捲動指紋 「指出目前的垂直位置，並可拖曳以直接變更它」
    向上頁區域 「將垂直位置向上移動幾行」
    頁面向下區域 「指出目前的垂直位置，並可拖曳以直接變更它」

     

    水準捲軸的部分具有下列描述。

    部分 描述
    捲軸本身 「用來變更水準檢視區域」
    向左鍵按鈕 「將水準位置向左移動一欄」
    右箭頭按鈕 「將水準位置向右移動一欄」
    捲動指紋 「指出目前的水準位置，並可拖曳以直接變更它」
    頁面左區域 「將水準位置向左移動幾個資料行」
    頁面右區域 「指出目前的垂直位置，並可拖曳以直接變更它」

     

  • get_accHelp

  • get_accHelpTopic

  • get_accName— Name 屬性取決於查詢的捲軸部分。

    垂直捲動條的元件具有下列名稱。

    部分 名稱
    捲軸視窗 「Vertical」
    頂端箭頭按鈕 「Line up」
    向下箭號按鈕 「Line down」
    捲動指紋 「Position」
    向上頁區域 「Page up」
    頁面向下區域 「Page down」

     

    水準捲軸的部分具有下列名稱。

    部分 名稱
    捲軸視窗 「Horizontal」
    向左鍵按鈕 「欄左方」
    右箭頭按鈕 「資料行右方」
    捲動指紋 「Position」
    頁面右區域 「Page right」
    頁面左區域 「Page left」

     

  • get_accParent— 箭號按鈕、滾動捲軸和捲軸視窗任一端陰影區域的 Parent 屬性是捲軸視窗。 捲軸視窗的 Parent 屬性是一個視窗 (ROLE_SYSTEM_WINDOW) ，會圍繞控制項，而且具有相同 的 Name 屬性和視窗類別名稱。

  • get_accRole— Role 屬性取決於查詢的捲軸部分。 捲軸的部分具有下列角色。

    部分 角色
    捲軸本身 ROLE_SYSTEM_SCROLLBAR
    上方、向下、向左和向右鍵按鈕 ROLE_SYSTEM_PUSHBUTTON
    捲動指紋 ROLE_SYSTEM_INDICATOR
    上一頁、下頁、左頁和頁面右頁面區域 ROLE_SYSTEM_PUSHBUTTON

     

  • get_accState— 每個捲軸元件的 State 屬性包含下列 值的組合。

    狀態 值
    STATE_SYSTEM_INVISIBLE 對於捲軸本身，這表示指定的垂直或水準捲軸不存在。 對於頁面向上或向下頁面區域，這表示指紋的位置，使得區域不存在。
    STATE_SYSTEM_OFFSCREEN 對於捲軸本身，這表示視窗的大小會讓指定的垂直或水準捲軸目前未顯示。
    STATE_SYSTEM_PRESSED 按下箭頭按鈕或頁面區域。
    STATE_SYSTEM_UNAVAILABLE 元件已停用。

     

  • get_accValue— 捲軸視窗的 Value 屬性工作表示捲軸位置，而且是包含從 「0」 到 「100」 整數的字串。

IAccessible 介面