对话框 (MSAA UI 元素引用)
注意
本主题介绍用于 MSAA UI 元素引用的 Dialog Box 对象。 此处不介绍如何在各种 UI 框架中创建 Dialog Box 对象。 请参阅所使用的 UI 框架的 API 参考文档。
对话框是应用程序为检索用户输入而创建的临时窗口。 应用程序使用对话框提示用户输入有关用户从菜单中选择的命令的其他信息。 对话框包含一个或多个控件 (子窗口) 用户输入文本、选择选项或指示命令的操作。
对话框的窗口类名称为“#32770”。
IAccessible 方法
对话框支持以下 IAccessible 方法：
| 方法 | 注释 |
|---|---|
| accDoDefaultAction | 如果对话框包含默认的按下按钮，则 accDoDefaultAction 方法使用BM_CLICK按钮消息调用 PostMessage 以单击默认的按下按钮。 |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
IAccessible 属性
对话框支持以下 IAccessible 属性：
| 属性 | 注释 |
|---|---|
| get_accChildCount | ChildCount 属性等于对话框中子窗口控件的数目。 |
| get_accDefaultAction | 如果对话框包含默认的按下按钮， 则 DefaultAction 属性为“Press”。 |
| get_accFocus | |
| get_accKeyboardShortcut | 通常，对话框没有键盘快捷方式。 如果对话框的窗口文本包含与号 (&) 字符，Microsoft Active Accessibility 将返回非 Null 字符串作为 KeyboardShortcut 属性。 |
| get_accName | Name 属性是显示在对话框标题栏中的窗口文本或描述文字。 |
| get_accParent | Parent 属性是围绕对话框 ( ROLE_SYSTEM_WINDOW) 的窗口，其 Name 属性和窗口类名称与对话框相同。 |
| get_accRole | Role属性ROLE_SYSTEM_DIALOG或ROLE_SYSTEM_PROPERTYPAGE。 |
| get_accState |
State 属性是以下一个或多个值的组合：STATE_SYSTEM_INVISIBLE STATE_SYSTEM_UNAVAILABLE | | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE |
备注
dialog 对象不支持 get_accChild 方法。 若要获取指向对话框中控件的 IAccessible 接口指针，客户端必须获取控件的窗口句柄，然后调用 AccessibleObjectFromWindow。