Función UiaProviderFromIAccessible (uiautomationcoreapi.h)

Crea un proveedor de Automatización de la interfaz de usuario de Microsoft basado en el objeto de accesibilidad activo de Microsoft especificado.

Sintaxis

HRESULT UiaProviderFromIAccessible(
  [in]  IAccessible               *pAccessible,
  [in]  long                      idChild,
  [in]  DWORD                     dwFlags,
  [out] IRawElementProviderSimple **ppProvider
);

Parámetros

[in] pAccessible

Tipo: IAccessible*

Puntero al objeto De accesibilidad activa de Microsoft.

[in] idChild

Tipo: long

Identificador secundario del objeto De accesibilidad activa de Microsoft.

[in] dwFlags

Tipo: DWORD

Uno de los siguientes valores:

UIA_PFIA_DEFAULT

UIA_PFIA_UNWRAP_BRIDGE

[out] ppProvider

Tipo: IRawElementProviderSimple**

Nuevo proveedor de automatización de la interfaz de usuario.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

La automatización de la interfaz de usuario proporciona compatibilidad con versiones anteriores para los proveedores de accesibilidad activa de Microsoft proporcionando un proxy para ellos, denominado proxy de accesibilidad activa de Microsoft a la automatización de la interfaz de usuario. Este proxy se crea automáticamente cuando una ventana responde a un mensaje de WM_GETOBJECT devolviendo un proveedor de accesibilidad activa de Microsoft. Use UiaProviderFromIAccessible cuando necesite crear manualmente un proxy de accesibilidad activa de Microsoft para la automatización de la interfaz de usuario; por ejemplo, al implementar la interfaz IAccessibleEx .

Algunas propiedades, como LabeledBy, deben expresarse como proveedor de automatización de la interfaz de usuario. Un proveedor IAccessibleEx puede usar UiaProviderFromIAccessible para encapsular un objeto IAccessible para devolverlo como el valor de la propiedad LabeledBy.

Requisitos

Consulte también

Funciones para proveedores

UiaIAccessibleFromProvider