滚动条 (MSAA UI 元素引用)

备注

本主题介绍用于 MSAA UI 元素参考的 滚动条 对象。 此处未介绍如何在各种 UI 框架中创建 滚动条 对象。 请参阅所使用的 UI 框架的 API 参考文档。

 

滚动条允许用户选择在相关窗口或列表框中滚动信息的方向和距离。 滚动条的窗口类名称为“SCROLLBAR”。

IAccessible 属性的内容取决于滚动条是垂直还是水平,以及客户端正在查询滚动条的以下哪个部分:

  • 滚动条本身
  • 上箭头或向右键按钮
  • 底部或向左键按钮
  • 滚动框 (拇指)
  • 页面向上或页面右侧区域
  • 页面向下或页面左侧区域

IAccessible 方法

滚动条支持以下 IAccessible 方法:

  • accDoDefaultAction - 滚动条对象本身和滚动拇指不支持 accDoDefaultAction 方法。

    对于垂直滚动条上的其他滚动条部分, accDoDefaultAction 调用 PostMessage ,其中 WM_VSCROLL 消息, wParam 设置为以下值。

    按钮/区域 Vaule
    上箭头按钮 SB_LINEUP
    下箭头按钮 SB_LINEDOWN
    页面向上区域 SB_PAGEUP
    页面向下区域 SB_PAGEDOWN

     

    对于水平滚动条上的其他滚动条部分, accDoDefaultAction 调用 PostMessage ,其中 WM_HSCROLL 消息, wParam 设置为以下值。

    按钮/区域
    向左键按钮 SB_LINELEFT
    向右键按钮 SB_LINERIGHT
    页面左侧区域 SB_PAGELEFT
    页面右侧区域 SB_PAGERIGHT

     

  • accHitTest

  • accLocation

  • accNavigate

IAccessible 属性

滚动条支持以下 IAccessible 属性:

  • get_accChildCount - 滚动条对象的 ChildCount 属性为 5。 对于其他滚动条部分, ChildCount 属性为零。

  • get_accDefaultAction - 滚动条对象本身和滚动拇指不支持 DefaultAction 属性。 箭头按钮的 DefaultAction 属性和滚动拇指两侧的阴影区域为“按”。

  • get_accDescription - Description 属性取决于查询的滚动条部分。

    垂直滚动条的各个部分具有以下说明。

    组成部分 说明
    滚动条本身 “用于更改垂直查看区域”
    上箭头按钮 “将垂直位置上移一行”
    下箭头按钮 “将垂直位置向下移动一行”
    滚动拇指 “指示当前垂直位置,可以拖动以直接更改它”
    页面向上区域 “将垂直位置向上移动几行”
    页面向下区域 “指示当前垂直位置,可以拖动以直接更改它”

     

    水平滚动条的各个部分具有以下说明。

    组成部分 说明
    滚动条本身 “用于更改水平查看区域”
    向左键按钮 “将水平位置左移一列”
    向右键按钮 “将水平位置右移一列”
    滚动拇指 “指示当前水平位置,可以拖动以直接更改它”
    页面左侧区域 “将水平位置左移几列”
    页面右侧区域 “指示当前垂直位置,可以拖动以直接更改它”

     

  • get_accHelp

  • get_accHelpTopic

  • get_accName - Name 属性取决于查询的滚动条部分。

    垂直滚动条的各个部分具有以下名称。

    组成部分 名称
    滚动条窗口 “Vertical”
    上箭头按钮 “Line up”
    下箭头按钮 “下行”
    滚动拇指 “位置”
    页面向上区域 “Page up”
    页面向下区域 “Page down”

     

    水平滚动条的各个部分具有以下名称。

    组成部分 名称
    滚动条窗口 “Horizontal”
    向左键按钮 “左列”
    向右键按钮 “列右”
    滚动拇指 “位置”
    页面右侧区域 “页面右侧”
    页左区域 “向左页”

     

  • 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 接口