捲動條 (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 postMessage,並將 wParam 設定為下列值 WM_HSCROLL 訊息。
按鈕/區域 價值 向左鍵按鈕 SB_LINELEFT 向右鍵按鈕 SB_LINERIGHT 頁面左區域 SB_PAGELEFT 頁面右區域 SB_PAGERIGHT
IAccessible 屬性
滾動條支援下列 IAccessible 屬性:
get_accChildCount— 滾動條物件的 ChildCount 屬性為五。 對於其他滾動條元件,ChildCount 屬性為零。
get_accDefaultAction: 滾動條物件本身和滾動條拇指不支援 defaultAction 屬性。 箭頭按鈕的 DefaultAction 屬性,以及捲動拇指兩側的陰影區域為 “Press”。
get_accDescription— Description 屬性取決於查詢的滾動條部分。
垂直滾動條的部分具有下列描述。
部分 描述 滾動條本身 「用來變更垂直檢視區域」 頂端箭號按鈕 「將垂直位置向上移動一行」 向下鍵按鈕 「將垂直位置向下移動一行」 捲動拇指 「表示目前的垂直位置,並可拖曳以直接變更」 向上頁區域 「將垂直位置向上移動幾行」 向下頁區域 「表示目前的垂直位置,並可拖曳以直接變更」 水平滾動條的部分具有下列描述。
部分 描述 滾動條本身 「用來變更水平檢視區域」 向左鍵按鈕 「將水準位置向左移動一欄」 向右鍵按鈕 '將水準位置向右移動一欄」 捲動拇指 「表示目前的水準位置,並可拖曳以直接變更」 頁面左區域 「將水準位置向左移動幾個數據行」 頁面右區域 「表示目前的垂直位置,並可拖曳以直接變更」 get_accName— Name 屬性取決於查詢的滾動條部分。
垂直滾動條的部分具有下列名稱。
部分 名字 滾動條視窗 “Vertical” 頂端箭號按鈕 “排隊” 向下鍵按鈕 “Line down” 捲動拇指 “Position” 向上頁區域 “Page up” 向下頁區域 “Page down” 水平滾動條的部分具有下列名稱。
部分 名字 滾動條視窗 “Horizontal” 向左鍵按鈕 欄左” 向右鍵按鈕 “Column right” 捲動拇指 “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:滾動條視窗的 值 屬性會指出滾動條位置,而且是包含從 “0” 到 “100” 整數的字元串。
相關主題