滚动条 (MSAA UI 元素参考)

注意

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

 

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

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

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

IAccessible 方法

滚动条支持以下 IAccessible 方法:

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

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

    按钮/区域 Vaule
    上箭头按钮 SB_LINEUP
    底部箭头按钮 SB_LINEDOWN
    Page up 区域 SB_PAGEUP
    分页区域 SB_PAGEDOWN

     

    对于水平滚动条上的其他滚动条部件,accDoDefaultAction 调用 PostMessageWM_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_accDescriptionDescription 属性取决于查询的滚动条的一部分。

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

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

     

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

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

     

  • get_accHelp

  • get_accHelpTopic

  • get_accNameName 属性取决于查询的滚动条的一部分。

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

    部分 名字
    滚动条窗口 “Vertical”
    上箭头按钮 “排队”
    底部箭头按钮 “下行”
    滚动拇指 “Position”
    Page up 区域 “Page up”
    分页区域 “Page down”

     

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

    部分 名字
    滚动条窗口 “Horizontal”
    向左键按钮 “左列”
    向右键按钮 “右列”
    滚动拇指 “Position”
    页面右侧区域 “页面右侧”
    页面左区域 “Page left”

     

  • get_accParent— 箭头按钮、滚动拇指和拇指两侧的 属性是滚动条窗口。 滚动条窗口的 属性是环绕控件的窗口(ROLE_SYSTEM_WINDOW),并且具有相同 Name 属性和窗口类名。

  • get_accRoleRole 属性取决于查询的滚动条的一部分。 滚动条的各个部分具有以下角色。

    部分 角色
    滚动条本身 ROLE_SYSTEM_SCROLLBAR
    顶部、向下、向左和向右键按钮 ROLE_SYSTEM_PUSHBUTTON
    滚动拇指 ROLE_SYSTEM_INDICATOR
    Page up、page down、page left 和 page right regions ROLE_SYSTEM_PUSHBUTTON

     

  • get_accState- 每个滚动条组件的 状态 属性包括以下 值的组合

    价值
    STATE_SYSTEM_INVISIBLE 对于滚动条本身,这表示指定的垂直或水平滚动条不存在。 对于页面向上或下页区域,这表示拇指定位为该区域不存在。
    STATE_SYSTEM_OFFSCREEN 对于滚动条本身,这表示窗口的大小,以便当前不显示指定的垂直或水平滚动条。
    STATE_SYSTEM_PRESSED 按下箭头按钮或页面区域。
    STATE_SYSTEM_UNAVAILABLE 组件已禁用。

     

  • get_accValue— 滚动条窗口的 属性指示滚动条位置,并且是包含从“0”到“100”的整数的字符串。

IAccessible 接口