Compartir a través de


Método IUIAutomation::ElementFromIAccessibleBuildCache (uiautomationclient.h)

Recupera un elemento de automatización de la interfaz de usuario para el objeto accesible especificado desde un servidor de accesibilidad activa de Microsoft, captura previamente las propiedades solicitadas y los patrones de control, y almacena los elementos previamente capturados en la memoria caché.

Sintaxis

HRESULT ElementFromIAccessibleBuildCache(
  [in]          IAccessible               *accessible,
  [in]          int                       childId,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **element
);

Parámetros

[in] accessible

Tipo: IAccessible*

Puntero a la interfaz IAccessible del objeto accesible.

[in] childId

Tipo: int

Identificador secundario del objeto accesible.

[in] cacheRequest

Tipo: IUIAutomationCacheRequest**

Dirección de la solicitud de caché que especifica las propiedades y los patrones de control que se van a almacenar en la memoria caché.

[out, retval] element

Tipo: IUIAutomationElement**

Recibe un puntero al elemento de automatización de la interfaz de usuario.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método permite a los clientes de Automatización de la interfaz de usuario de Microsoft obtener interfaces IUIAutomationElement para objetos accesibles implementados por un servidor de accesibilidad activo de Microsoft.

Este método puede producir un error si el servidor implementa interfaces de proveedor de automatización de la interfaz de usuario junto con la compatibilidad con accesibilidad activa de Microsoft.

El método devuelve E_INVALIDARG si la implementación subyacente del elemento ui Automation no es un servidor nativo de accesibilidad activa de Microsoft; es decir, si un cliente intenta recuperar la interfaz IAccessible para un elemento admitido originalmente por un objeto proxy de Oleacc.dll o por el puente UIA a MSAA.

Requisitos

   
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Actualización de plataforma para Windows Vista, Windows XP con SP3 y Actualización de plataforma para Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008, Windows Server 2003 con SP2 y Actualización de plataforma para Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uiautomationclient.h (include UIAutomation.h)

Consulte también

IUIAutomation

IUIAutomation::ElementFromHandleBuildCache