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

Registra un método que controla una matriz nativa de eventos modificados por propiedades.

Nota Antes de implementar un controlador de eventos, debe estar familiarizado con los problemas de subprocesos descritos en Descripción de los problemas de subprocesos.

 

Sintaxis

HRESULT AddPropertyChangedEventHandlerNativeArray(
  [in] IUIAutomationElement                     *element,
  [in] TreeScope                                scope,
  [in] IUIAutomationCacheRequest                *cacheRequest,
  [in] IUIAutomationPropertyChangedEventHandler *handler,
  [in] PROPERTYID                               *propertyArray,
  [in] int                                      propertyCount
);

Parámetros

[in] element

Tipo: IUIAutomationElement

Puntero al elemento de automatización de la interfaz de usuario asociado al controlador de eventos.

[in] scope

Tipo: treeScope de

Á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] cacheRequest

Tipo: IUIAutomationCacheRequest*

Puntero a una solicitud de caché o NULL si no se desea ningún almacenamiento en caché.

[in] handler

Tipo: * IUIAutomationPropertyChangedEventHandler

Puntero al objeto que controla el evento.

[in] propertyArray

Tipo: PROPERTYID*

Puntero a los identificadores de las propiedades de automatización de la interfaz de usuario de interés. Para obtener una lista de identificadores de propiedad, consulte Identificadores de propiedad.

[in] propertyCount

Tipo: int

Número de identificadores de propiedad en propertyArray.

Valor devuelto

Tipo: HRESULT

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

ejemplo

Para obtener ejemplos de código que muestran cómo implementar interfaces que permiten a los clientes recibir y controlar eventos de Automatización de la interfaz de usuario de Microsoft (incluido AddPropertyChangedEventHandlerNativeArray), consulte Cómo implementar controladores de eventos.

Observaciones

Es posible que el elemento de interfaz de usuario especificado por elemento no admita las propiedades especificadas por el parámetro propertyArray.

Este método tiene el mismo propósito que IUIAutomation::AddPropertyChangedEventHandler, pero toma una matriz normal de identificadores de propiedad en lugar de SAFEARRAY.

Un cliente de Automatización de la interfaz de usuario no debe usar varios subprocesos para agregar o quitar controladores de eventos. El comportamiento inesperado puede producir si se agrega o quita un controlador de eventos mientras se agrega o quita otro en el mismo proceso de cliente.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista, Windows XP con SP3 y Platform Update para Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2008 R2, Windows Server 2008 con SP2 y Platform Update para Windows Server 2008, Windows Server 2003 con SP2 y Platform Update para Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	uiautomationclient.h (include UIAutomation.h)

Consulte también

AddPropertyChangedEventHandler

propiedades y patrones de control de automatización de la interfaz de usuario de almacenamiento en caché

conceptual de

IUIAutomation

de referencia de

removeAllEventHandlers

RemovePropertyChangedEventHandler

suscribirse a eventos de automatización de la interfaz de usuario

Descripción de los problemas de subprocesos