Función UiaAddEvent (uiautomationcoreapi.h)

Nota Esta función está en desuso. En su lugar, las aplicaciones cliente deben usar las interfaces del modelo de objetos componentes de automatización de la interfaz de usuario de Microsoft (COM).

 

Agrega un agente de escucha para eventos en un nodo del árbol de automatización de la interfaz de usuario.

Sintaxis

HRESULT UiaAddEvent(
  [in]  HUIANODE         hnode,
  [in]  EVENTID          eventId,
  [in]  UiaEventCallback *pCallback,
  [in]  TreeScope        scope,
  [in]  PROPERTYID       *pProperties,
  [in]  int              cProperties,
  [in]  UiaCacheRequest  *pRequest,
  [out] HUIAEVENT        *phEvent
);

Parámetros

[in] hnode

Tipo: HUIANODE

Nodo al que se va a agregar un agente de escucha de eventos.

[in] eventId

Tipo: EVENTID

Identificador del evento que se va a escuchar. Para obtener una lista de identificadores de eventos, consulte Identificadores de eventos.

[in] pCallback

Tipo: UiaEventCallback*

Dirección de la función de devolución de llamada definida por la aplicación UiaEventCallback a la que se llama cuando se genera el evento.

[in] scope

Tipo: TreeScope*

Valor del tipo enumerado TreeScope que indica el ámbito de los eventos que se van a controlar; es decir, si están en el propio elemento o en sus antecesores y elementos secundarios.

[in] pProperties

Tipo: PROPERTYID*

Dirección de una matriz que contiene los identificadores de las propiedades para supervisar los eventos de cambio, cuando eventId es el EVENTID derivado de AutomationPropertyChanged_Event_GUID; de lo contrario, este parámetro es NULL. Para obtener una lista de identificadores de propiedad, vea Identificadores de propiedad.

[in] cProperties

Tipo: int

Recuento de elementos de la matriz pProperties .

[in] pRequest

Tipo: UiaCacheRequest*

Dirección de una estructura UiaCacheRequest que define la solicitud de caché en vigor para los nodos que se devuelven con eventos.

[out] phEvent

Tipo: HUIEVENT*

Cuando se devuelve esta función, contiene un puntero al evento que se agrega. Este parámetro se pasa sin inicializar.

Valor devuelto

Tipo: HRESULT

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

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	uiautomationcoreapi.h
Library	Uiautomationcore.lib
Archivo DLL	Uiautomationcore.dll

Consulte también

UiaLookupId