Función UiaProviderForNonClient (uiautomationcoreapi.h)

Obtiene el proveedor para todo el área que no es cliente de una ventana o para un control en el área que no es cliente de una ventana.

Sintaxis

HRESULT UiaProviderForNonClient(
  [in]  HWND                      hwnd,
  [in]  long                      idObject,
  [in]  long                      idChild,
  [out] IRawElementProviderSimple **ppProvider
);

Parámetros

[in] hwnd

Tipo: HWND

Ventana que posee el área que no es cliente o el control que no es de cliente.

[in] idObject

Tipo: long

Identificador de objeto del control que no es cliente o OBJID_WINDOW para todo el área que no es de cliente. Para obtener una lista de los valores posibles, vea Identificadores de objeto.

[in] idChild

Tipo: long

Identificador secundario del control que no es de cliente.

[out] ppProvider

Tipo: IRawElementProviderSimple**

Recibe el proveedor del área que no es cliente o del control que no es de cliente.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o si un valor de error de lo contrario.

Comentarios

Esta función devuelve el proveedor predeterminado de Microsoft Automatización de la interfaz de usuario para el área que no es cliente de una ventana. Automatización de la interfaz de usuario admite el área que no es de cliente sin ninguna ayuda explícita de la ventana. Puede invalidar y personalizar la compatibilidad mediante la interfaz IRawElementProviderSimple recuperada por esta función.

Esta función es especialmente útil cuando se usa con la marca ProviderOptions_RefuseNonClientSupport, que deshabilita el proveedor predeterminado Automatización de la interfaz de usuario para el área que no es de cliente para que la ventana pueda proporcionar su propio proveedor.

Los identificadores de objeto admitidos para los controles del área que no son cliente incluyen OBJID_WINDOW, OBJID_VSCROLL, OBJID_HSCROLL, OBJID_TITLEBAR, OBJID_MENU y OBJID_SIZEGRIP. Para OBJID_TITLEBAR, use el identificador secundario para distinguir entre toda la barra de título y los botones que contiene.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	uiautomationcoreapi.h
Library	Uiautomationcore.lib
Archivo DLL	Uiautomationcore.dll

Consulte también

Funciones para proveedores