大网数据广告活动
.NET 与 C# 开发

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

· 52CE 我爱测

几种不同的 !INCLUDE[TLA#tla_ui] 框架在 !INCLUDE[TLA#tla_ms] 操作系统内部使用,包括 !INCLUDE[TLA2#tla_win32]、 !INCLUDE[TLA#tla_winforms]和 !INCLUDE[TLA#tla_winclient]。 !INCLUDE[TLA#tla_uiautomation] 向客户公开有关 UI 元素的信息。 但是, !INCLUDE[TLA2#tla_uiautomation] 本身并不了解存在于这些框架中的不同类型的控件以及从中提取信息所需的技术。 而是将此任务留给称为提供程序的对象。 一个提供程序从特定控件中提取信息,并将该信息传递给 !INCLUDE[TLA2#tla_uiautomation],后者随…

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

几种不同的 用户界面 (UI) 框架在 Microsoft 操作系统内部使用,包括 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 命名空间。 在命名空间内创建一个 xref:UIAutomationClientsideProviders.UIAutomationClientSideProviders 类。 在静态 xref:UIAutomationClientsideProviders.UIAutomationClientSideProviders.ClientSideProviderDescriptionTable 字段的实现中,创建一个描述提供程序的 xref:System.Windows.Automation.ClientSideProviderDescription 结构数组。

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

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

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

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

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

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

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

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

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。