Método IUIAutomation::AddPropertyChangedEventHandler (uiautomationclient.h)
Registra um método que manipula e matriz de eventos alterados por propriedade.
Sintaxe
HRESULT AddPropertyChangedEventHandler(
[in] IUIAutomationElement *element,
TreeScope scope,
[in] IUIAutomationCacheRequest *cacheRequest,
[in] IUIAutomationPropertyChangedEventHandler *handler,
[in] SAFEARRAY *propertyArray
);
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: SAFEARRAY*
Um ponteiro para as propriedades de Automação da Interface do Usuário de interesse. Para obter uma lista de IDs de propriedade, consulte Identificadores de propriedade.
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.
Comentários
O item de interface do usuário especificado pelo elemento pode não dar suporte às propriedades especificadas pelo parâmetro propertyArray .
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 (include UIAutomation.h) |
Confira também
AddPropertyChangedEventHandlerNativeArray
Práticas recomendadas para usar matrizes seguras
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