ObjectModel 控件模式

介绍实现 IObjectModelProvider 的准则和约定,包括有关方法的信息。 ObjectModel 控件模式用于公开指向文档的基础对象模型的指针。

许多应用程序实现丰富的对象模型,这些模型增加了超出 Microsoft UI 自动化 提供的价值。 此控件模式允许客户端从 UI 自动化 元素导航到基础对象模型。

本主题包含以下各节:

实现准则和约定

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

  • IObjectModelProvider::GetUnderlyingObjectModel 方法应返回指向尽可能接近源 UI 元素的 对象的指针。 例如,在 Web 浏览器中,单个元素的UI 自动化提供程序应返回元素的对象模型指针。 返回文档根的对象模型指针的用处要小得多。
  • ObjectModel 控件模式的客户端应具有他们正在查找的接口的 IID,这就是为什么返回简单的 IUnknown 指针就足够了。
  • 由于UI 自动化封送指向客户端进程的指针,因此提供程序应期望客户端使用标准组件对象模型 (COM) 做法访问对象模型。

IObjectModelProvider 的必需成员

实现 IObjectModelProvider 接口需要以下方法。

必需的成员 成员类型 说明
GetUnderlyingObjectModel 方法 返回指向基础对象模型的 COM 指针。 客户端应调用 IUnknown::QueryInterface 方法来检索特定的对象模型指针。

 

没有与此控件模式关联的事件。

控件类型及其支持的控件模式

UI 自动化控件模式概述

UI 自动化树概述