MSAA UI 元素参考) (组合框

注意

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

 

组合框是与静态控件或编辑控件组合在一起的列表框,静态控件或编辑控件在组合框的列表框部分中显示了当前选定的项目。 控件的列表框部分在用户选择下拉箭头 (控件旁边的按钮) 时,将一直显示或仅显示下拉列表部分。 如果选择字段是编辑控件,则用户可以输入不在列表中的信息;否则,用户只能选择列表中的项。

组合框的窗口类名称为“COMBOBOX”。

IAccessible 属性的内容取决于客户端查询组合框的以下哪个部分:

  • 组合框窗口
  • 编辑控件或静态文本控件
  • 下拉箭头 (一个按下按钮)
  • 列表框
  • 列表框中的列表项

IAccessible 方法

组合框支持以下 IAccessible 方法:

IAccessible 属性

组合框支持以下 IAccessible 属性:

  • get_accChild

  • get_accChildCount — 下表显示了组合框不同部分的子计数值。

    组合框部件 ChildCount
    组合框窗口 3
    编辑控件 0
    下拉箭头 0
    列表框 列表项数
    列表项 0

     

  • get_accDefaultAction — 下表显示了组合框不同部分的 DefaultAction 属性。

    组合框部件 DefaultAction
    组合框窗口
    编辑控件
    下拉箭头 “打开”或“关闭”,具体取决于下拉列表的状态
    列表框
    列表项 “双击”

     

  • get_accDescription

  • get_accFocus

  • get_accHelp

  • get_accHelpTopic

  • get_accKeyboardShortcut — 下表显示了组合框不同部分的 KeyboardShortcut 属性。

    组合框部件 KeyboardShortcut
    组合框窗口 关联标签的访问键
    编辑控件
    下拉箭头 “Alt+向下键”
    列表框
    列表项

     

    组合框的访问键是标记组合框的关联静态文本控件的文本中的带下划线字符。 例如,在打开文件的标准“打开”对话框中(例如在 Microsoft 写字板中),标有“文件类型:”的组合框具有 KeyboardShortcut “Alt+t”。

  • get_accName — 下表显示了组合框不同部分的 Name 属性。

    组合框部件 名称
    组合框窗口 用作标签的静态文本控件
    编辑控件 用作标签的静态文本控件
    下拉箭头 “打开”或“关闭”,具体取决于下拉列表的状态
    列表框 关联的标签
    列表项 列表项的文本

     

    组合框、其子编辑控件及其子列表框的 Name 属性是标记组合框的关联静态文本控件中的文本。 例如,在打开文件的标准“打开”对话框上(如在写字板中),两个组合框 的名称 属性为“查找范围:”和“文件类型:”。

  • get_accParent — 下表显示了组合框不同部分的父值。

    组合框部件 Parent
    组合框窗口 一个窗口,其 Role 属性 为 ROLE_SYSTEM_WINDOW ,它环绕组合框,并且与组合框具有相同的 Name 属性和窗口类名称。
    编辑控件 (或静态文本控件) 组合框窗口。
    下拉箭头 组合框窗口。
    列表框父窗口 组合框窗口。 此窗口环绕列表框。
    列表框 列表框父窗口。
    列表项 列表框。

     

  • get_accRole — 下表显示了组合框不同部分的 Role 属性。

    组合框部件 角色
    组合框窗口 ROLE_SYSTEM_COMBOBOX
    编辑控件 (或静态文本控件) ROLE_SYSTEM_TEXTROLE_SYSTEM_STATICTEXT
    下拉箭头 ROLE_SYSTEM_PUSHBUTTON
    列表框 ROLE_SYSTEM_LIST
    列表项 ROLE_SYSTEM_LISTITEM

     

  • get_accState — 下表显示了组合框不同部分的 State 属性。

    组合框部件 可能的状态
    组合框窗口 STATE_SYSTEM_INVISIBLE | | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLESTATE_SYSTEM_NORMAL | | STATE_SYSTEM_EXPANDEDSTATE_SYSTEM_COLLAPSED
    编辑控件 STATE_SYSTEM_INVISIBLE | | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLESTATE_SYSTEM_NORMAL
    下拉箭头 0,表示按钮可见且未按下;或 STATE_SYSTEM_PRESSED | STATE_SYSTEM_INVISIBLE |STATE_SYSTEM_NORMAL
    列表框 STATE_SYSTEM_INVISIBLE | | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FLOATINGSTATE_SYSTEM_NORMAL
    列表项 STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | | STATE_SYSTEM_FOCUSEDSTATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_NORMAL

     

  • get_accValue — 下表显示了组合框不同部分的 Value 属性。

    组合框部件
    组合框窗口 当前所选列表项的文本
    编辑控件 当前所选列表项的文本
    下拉箭头
    列表框
    列表项

     

备注

  • accNavigate 在组合框的列表框部分使用 NAVDIR_NEXT 标志调用时,它会错误地导航到应返回 VT_EMPTY的托盘窗口。

IAccessible 接口