Share via


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

Remove um manipulador de eventos de edição de texto programático.

Sintaxe

HRESULT RemoveTextEditTextChangedEventHandler(
  [in] IUIAutomationElement                         *element,
  [in] IUIAutomationTextEditTextChangedEventHandler *handler
);

Parâmetros

[in] element

Tipo: IUIAutomationElement*

Um ponteiro para o elemento de Automação da Interface do Usuário do qual remover o manipulador.

[in] handler

Tipo: IUIAutomationTextEditTextChangedEventHandler*

Um ponteiro para a interface que foi passada para IUIAutomation3::AddTextEditTextChangedEventHandler.

Valor retornado

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 de Automação da Interface do Usuário da Microsoft 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.

É possível que um evento seja entregue a um manipulador de eventos após a assinatura do manipulador, se o evento for recebido simultaneamente com a solicitação para cancelar a assinatura do evento. A melhor prática é seguir o padrão COM (Component Object Model) e evitar destruir o objeto do manipulador de eventos até que sua contagem de referência tenha atingido zero. Destruir um manipulador de eventos imediatamente após cancelar a assinatura de eventos poderá resultar em uma violação de acesso se um evento for entregue com atraso.

Requisitos

   
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)

Confira também

IUIAutomation3

RemoveAllEventHandlers