Método IUIAutomation::AddPropertyChangedEventHandlerNativeArray (uiautomationclient.h)
Registra um método que manipula uma matriz nativa de eventos alterados por propriedade.
Sintaxe
HRESULT AddPropertyChangedEventHandlerNativeArray(
[in] IUIAutomationElement *element,
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 Automação da Interface do Usuário associado ao manipulador de eventos.
scope
[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 do Automação da Interface do Usuário propriedades de interesse. 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.
Retornar valor
Tipo: HRESULT
Se o 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 manipulem eventos do Microsoft Automação da Interface do Usuário (incluindo AddPropertyChangedEventHandlerNativeArray), confira Como implementar manipuladores de eventos.
Comentários
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 Automação da Interface do Usuário não deve usar vários threads para adicionar ou remover manipuladores de eventos. Um comportamento inesperado poderá 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 |
---|---|
Cliente mínimo com suporte | Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista, Windows XP com SP3 e Atualização de Plataforma para Windows Vista [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008, Windows Server 2003 com SP2 e Atualização de Plataforma para Windows Server 2008 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | uiautomationclient.h (inclua UIAutomation.h) |
Confira também
AddPropertyChangedEventHandler
Armazenando em cache Automação da Interface do Usuário propriedades e padrões de controle
Conceitual
Referência
RemovePropertyChangedEventHandler
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de