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

Artigo
08/08/2024

Registra um método que manipula uma matriz nativa de eventos alterados pela propriedade.

Observação Antes de implementar um manipulador de eventos, você deve estar familiarizado com os problemas de threading descritos no Noções básicas sobre problemas de threading.

Sintaxe

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

Um ponteiro para o elemento de Automação da Interface do Usuário associado ao manipulador de eventos.

[in] scope

Tipo: TreeScope

O escopo dos eventos a serem tratados; ou seja, se eles estão no próprio elemento, ou em seus ancestrais e filhos.

[in] cacheRequest

Tipo: * IUIAutomationCacheRequest

Um ponteiro para uma solicitação de cache ou NULL se nenhum cache for desejado.

[in] handler

Tipo: * IUIAutomationPropertyChangedEventHandler

Um ponteiro para o objeto que manipula o evento.

[in] propertyArray

Tipo: PROPERTYID*

Um ponteiro para os identificadores das propriedades de interesse da Automação da Interface do Usuário. Para obter uma lista de IDs de propriedade, consulte Identificadores de Propriedade.

[in] propertyCount

Tipo: int

O número de identificadores de propriedade em propertyArray.

Valor de retorno

Tipo: HRESULT

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

exemplo

Para obter exemplos de código que mostram como implementar interfaces que permitem que os clientes recebam e lidem com eventos de Automação da Interface do Usuário da Microsoft (incluindo AddPropertyChangedEventHandlerNativeArray), consulte How to Implement Event Handlers.

Observações

O item de interface do usuário especificado pelo elemento pode não dar suporte às propriedades especificadas pelo parâmetro propertyArray .

Esse método serve à mesma finalidade que IUIAutomation::AddPropertyChangedEventHandler, mas usa uma matriz normal de identificadores de propriedade em vez de um SAFEARRAY.

Um cliente de Automação de Interface do Usuário não deve usar vários threads para adicionar ou remover manipuladores de eventos. Um comportamento inesperado pode resultar se um manipulador de eventos estiver sendo adicionado ou removido enquanto outro estiver sendo adicionado ou removido no mesmo processo de cliente.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 7, Windows Vista com SP2 e Platform Update para Windows Vista, Windows XP com SP3 e Platform Update para Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008, Windows Server 2003 com SP2 e Platform Update para Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	uiautomationclient.h (include UIAutomation.h)

Consulte também

AddPropertyChangedEventHandler

padrões de controle e propriedades de automação da interface do usuário de cache

Conceitual

IUIAutomation

de referência de

RemoveAllEventHandlers

RemovePropertyChangedEventHandler

assinatura de eventos de automação da interface do usuário

noções básicas sobre problemas de threading

Compartilhar via