窗口控件模式

介绍实现 IWindowProvider 的准则和约定,包括有关属性、方法和事件的信息。 Window 控件模式支持在传统 GUI 中提供基于窗口的基本功能的控件。

必须实现此控件模式的控件示例包括顶级应用程序窗口、多文档界面 (MDI) 子窗口、大小可调的拆分窗格控件、模式对话框和气球状帮助窗口。 有关实现此控件模式的控件示例,请参阅 Control Pattern Mapping for UI Automation Clients

本主题包含以下各节:

实现准则和约定

实现 Window 控件模式时,请注意以下准则和约定:

  • 若要支持使用 Microsoft UI 自动化 修改窗口大小和屏幕位置的功能,除 IWindowProvider 外,控件还必须实现 ITransformProvider
  • 实现 IWindowProvider 通常需要包含标题栏的控件以及允许移动、调整大小、最大化、最小化或关闭控件的标题栏元素。
  • 工具提示弹出窗口和组合框或菜单下拉列表等控件通常不实现 IWindowProvider
  • 通过提供类似窗口的 “关闭 ”按钮,气球帮助窗口与基本工具提示弹出窗口不同。
  • IWindowProvider 不支持全屏模式,因为它特定于应用程序的功能,并且不是典型的窗口行为。

IWindowProvider 的必需成员

实现 IWindowProvider 接口需要以下属性、方法和事件。

必需的成员 成员类型 说明
WindowInteractionState 属性 不保证 WindowInteractionState_ReadyForUserInteraction
IsModal 属性
IsTopmost 属性
CanMaximize 属性
CanMinimize 属性
WindowVisualState 属性
关闭 方法
SetVisualState 方法
WaitForInputIdle 方法
UIA_Window_WindowClosedEventId 事件
UIA_Window_WindowOpenedEventId 事件

 

概念性

UI 自动化控件模式概述

UI 自动化客户端的控件模式映射

UI 自动化树概述