Método IRawElementProviderHwndOverride::GetOverrideProviderForHwnd (uiautomationcore.h)

Obtiene un proveedor de Automatización de la interfaz de usuario para el elemento especificado.

Sintaxis

HRESULT GetOverrideProviderForHwnd(
  [in]          HWND                      hwnd,
  [out, retval] IRawElementProviderSimple **pRetVal
);

Parámetros

[in] hwnd

Tipo: HWND

Identificador de ventana del elemento.

[out, retval] pRetVal

Tipo: IRawElementProviderSimple**

Recibe un puntero al nuevo proveedor para la ventana especificada o NULL si el proveedor no se reemplaza. Este parámetro se pasa sin inicializar.

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 se implementa mediante raíces de fragmento que contienen elementos secundarios basados en ventanas. De forma predeterminada, los controles hospedados en ventanas se sirven por proveedores predeterminados, además de los proveedores personalizados. Los proveedores predeterminados tratan todas las ventanas dentro de una ventana primaria como elementos del mismo nivel. Si desea reestructurar el árbol de Automatización de la interfaz de usuario para que un control basado en ventanas se vea como elemento secundario de otro, debe invalidar el proveedor predeterminado implementando este método en la raíz del fragmento. El proveedor devuelto puede proporcionar propiedades adicionales o invalidar las propiedades del componente especificado.

El proveedor devuelto debe formar parte del árbol de fragmentos. Puede proporcionar propiedades adicionales o invalidar las propiedades del componente especificado.

Si el proveedor devuelto implementa IRawElementProviderFragment, el proveedor debe formar parte del árbol del fragmento y ser accesible navegando desde la raíz del fragmento.

Requisitos

Consulte también

IRawElementProviderHwndOverride