Compartilhar via


Método IUIAutomationTextEditTextChangedEventHandler::HandleTextEditTextChangedEvent (uiautomationclient.h)

Manipula um evento gerado quando um provedor do Microsoft Automação da Interface do Usuário para um controle de edição de texto relata uma alteração de texto programática.

Sintaxe

HRESULT HandleTextEditTextChangedEvent(
  [in] IUIAutomationElement *sender,
  [in] TextEditChangeType   textEditChangeType,
  [in] SAFEARRAY            *eventStrings
);

Parâmetros

[in] sender

Tipo: IUIAutomationElement*

Um ponteiro para o elemento que gerou o evento.

[in] textEditChangeType

Tipo: TextEditChangeType

O tipo de alteração de edição de texto que ocorreu.

[in] eventStrings

Tipo: SAFEARRAY*

Dados de evento passados pelo evento.

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

Esse método é implementado pelo aplicativo para lidar com eventos aos quais ele se inscreveu usando AddTextEditTextChangedEventHandler.

Os dados do evento contêm conteúdos diferentes para cada tipo de alteração de edição de texto:

  • TextEditChangeType_AutoCorrect: os dados são a nova cadeia de caracteres corrigida.
  • TextEditChangeType_Composition: os dados são a cadeia de caracteres atualizada na composição (apenas a parte que foi alterada).
  • TextEditChangeType_CompositionFinalized: os dados são a cadeia de caracteres finalizada da composição concluída (isso pode estar vazio se a composição tiver sido cancelada ou excluída).

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 (inclua UIAutomation.h)

Confira também

Práticas recomendadas para usar matrizes seguras

IUIAutomationTextEditTextChangedEventHandler