Método IUIAutomation3::AddTextEditTextChangedEventHandler (uiautomationclient.h)

Artigo
06/29/2023

Registra um método que manipula eventos programáticos de edição de texto.

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

Sintaxe

HRESULT AddTextEditTextChangedEventHandler(
  [in] IUIAutomationElement                         *element,
  [in] TreeScope                                    scope,
  [in] TextEditChangeType                           textEditChangeType,
  [in] IUIAutomationCacheRequest                    *cacheRequest,
  [in] IUIAutomationTextEditTextChangedEventHandler *handler
);

Parâmetros

[in] element

Tipo: IUIAutomationElement*

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

[in] scope

Tipo: TreeScope

O escopo de eventos a serem manipulados ou seja, se eles estão no próprio elemento ou em seus ancestrais e descendentes.

[in] textEditChangeType

Tipo: TextEditChangeType

O tipo de alteração específico a ser escutado. Os clientes se registram para cada tipo de alteração de edição de texto separadamente, para que o sistema de Automação da Interface do Usuário possa marcar para ouvintes registrados em tempo de execução e evitar a geração de eventos para alterações específicas de edição de texto quando não houver ouvintes.

[in] cacheRequest

Tipo: IUIAutomationCacheRequest*

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

[in] handler

Tipo: IUIAutomationTextEditTextChangedEventHandler*

Um ponteiro para o objeto que manipula o evento de edição de texto programático.

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

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 8.1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	uiautomationclient.h (include UIAutomation.h)