客户端 UI 自动化提供程序的实现

备注

本文档适用于想要使用 UI 自动化 命名空间中定义的托管 System.Windows.Automation 类的 .NET Framework 开发人员。 有关 UI 自动化的最新信息,请参阅 Windows 自动化 API:UI 自动化

Microsoft 操作系统中使用几种不同的 用户界面 (UI) 框架,包括 Win32、Windows 窗体和 Windows Presentation Foundation (WPF) 。 Microsoft UI 自动化 向客户公开有关 UI 元素的信息。 但是, UI 自动化 本身并不了解存在于这些框架中的不同类型的控件以及从中提取信息所需的技术。 而是将此任务留给称为提供程序的对象。 一个提供程序从特定控件中提取信息,并将该信息传递给 UI 自动化,后者随后以一致的方式将其呈现给客户端。

提供程序可以存在于服务器端或客户端上。 服务器端提供程序由控件本身实现。 WPF 元素实现提供程序,正如可以在考虑到 UI 自动化 的情况下写入第三方控件一样。

但较旧的控件(如 Win32 和 Windows 窗体中的控件)不直接支持 UI 自动化 。 这些控件都将改为由存在于客户端进程中的提供程序提供,并且使用跨进程通信获取有关控件的信息;例如,通过监视在窗口与控件之间来回的消息。 此类客户端提供程序有时称为代理。

Windows Vista 为标准 Win32 和 Windows 窗体控件提供提供程序。 此外,回退提供程序为 UI 自动化 任何不由另一个服务器端提供程序或代理提供但具有 Microsoft Active Accessibility 实现的控件提供部分支持。 所有这样的提供程序均已自动加载,并且可供客户端应用程序使用。

有关 Win32 和 Windows 窗体控件支持的详细信息,请参阅 UI 自动化对标准控件的支持

应用程序还可以注册其他客户端提供程序。

分布客户端提供程序

UI 自动化 预期在托管代码程序集中查找客户端提供程序。 此程序集中命名空间的名称应与程序集名称相同。 例如,名为 ContosoProxies.dll 的程序集将包含 ContosoProxies 命名空间。 在命名空间内创建一个 UIAutomationClientSideProviders 类。 在静态 ClientSideProviderDescriptionTable 字段的实现中,创建一个描述提供程序的 ClientSideProviderDescription 结构数组。

注册并配置客户端提供程序

动态链接库中的客户端提供程序 (DLL) 通过调用加载 RegisterClientSideProviderAssembly 。 客户端应用程序不需要任何进一步的操作即可使用提供程序。

在客户端自己的代码中实现的提供程序通过使用 RegisterClientSideProviders注册。 此方法将 ClientSideProviderDescription 结构数组作为参数,每个结构均指定以下属性:

  • 创建提供程序对象的回调函数。

  • 提供程序将提供的控件的类名。

  • 提供程序将提供的应用程序(通常为可执行文件的完整名称)的映像名称。

  • 控制如何将类名与在目标应用程序中找到的窗口类进行匹配的标志。

最后两个参数为可选。 当客户端需要为不同的应用程序使用不同的提供程序时,它可能会指定目标应用程序的映像名称。 例如,客户端可能会在支持多个视图模式的已知应用程序中为 Win32 列表视图控件使用一个提供程序,而在另一个未使用的已知应用程序中使用另一个提供程序。

另请参阅