Compartir a través de

Patrón de control ObjectModel

  • Artículo

Describe instrucciones y convenciones para implementar IObjectModelProvider, incluida la información sobre los métodos. El ObjectModel patrón de control se usa para exponer un puntero al modelo de objetos subyacente de un documento.

Muchas aplicaciones implementan modelos de objetos enriquecidos que agregan valor más allá de lo que proporciona Microsoft UI Automation. Este patrón de control permite a un cliente navegar desde un elemento de Automatización de la interfaz de usuario al modelo de objetos subyacente.

Este tema contiene las secciones siguientes.

Directrices y convenciones de implementación

Al implementar el patrón de control objectModel , tenga en cuenta las siguientes directrices y convenciones:

  • El método IObjectModelProvider::GetUnderlyingObjectModel debe devolver un puntero al objeto lo más cercano posible al elemento de interfaz de usuario de origen. Por ejemplo, en un explorador web, un proveedor de automatización de la interfaz de usuario para un único elemento debe devolver un puntero del modelo de objetos para el elemento. Devolver un puntero de modelo de objetos para la raíz del documento sería mucho menos útil.
  • Se espera que el cliente del ObjectModel patrón de control tenga el IID para la interfaz que buscan, por lo que es suficiente devolver un puntero IUnknown simple.
  • Dado que la automatización de la interfaz de usuario serializa el puntero al proceso de cliente, el proveedor debe esperar que el cliente acceda al modelo de objetos mediante prácticas estándar del modelo de objetos componentes (COM).

Miembros necesarios para IObjectModelProvider

El método siguiente es necesario para implementar la interfazIObjectModelProvider.

Miembros necesarios Tipo de miembro Notas
GetUnderlyingObjectModel Método Devuelve un puntero COM al modelo de objetos subyacente. Se espera que el cliente llame al método IUnknown::QueryInterface para recuperar punteros de modelo de objetos específicos.

 

Este patrón de control no tiene eventos asociados.

tipos de control y sus patrones de control admitidos

Introducción a los patrones de control de automatización de la interfaz de usuario de

Información general del árbol de automatización de la interfaz de usuario de