Função UiaRaiseTextEditTextChangedEvent (uiautomationcoreapi.h)

Chamado por um provedor para notificar o núcleo do Microsoft Automação da Interface do Usuário de que um controle de texto alterou o texto programaticamente.

Sintaxe

HRESULT UiaRaiseTextEditTextChangedEvent(
  [in] IRawElementProviderSimple *pProvider,
  [in] TextEditChangeType        textEditChangeType,
  [in] SAFEARRAY                 *pChangedData
);

Parâmetros

[in] pProvider

Tipo: IRawElementProviderSimple*

O nó do provedor em que a alteração de texto ocorreu.

[in] textEditChangeType

Tipo: TextEditChangeType

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

[in] pChangedData

Tipo: SAFEARRAY*

Os dados do evento. Deve ser atribuível como um VAR do tipo VT_BSTR.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Essa é uma função auxiliar para provedores que implementam ITextEditProvider e estão gerando os eventos necessários do padrão. Siga as diretrizes fornecidas em TextEdit Control Pattern que descreve quando gerar os eventos e qual conteúdo os eventos devem passar para Automação da Interface do Usuário.

Se não houver clientes escutando um tipo de alteração específico, nenhum evento será gerado.

Os dados do evento devem conter conteúdos diferentes para cada tipo de alteração (por TextEditChangeType):

• TextEditChangeType_AutoCorrect: pChangedData deve ser a nova cadeia de caracteres corrigida .
• TextEditChangeType_Composition: pChangedData deve ser a cadeia de caracteres atualizada na composição (somente a parte que foi alterada).
• TextEditChangeType_CompositionFinalized: pChangedData deve ser 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

Confira também

HandleTextEditTextChangedEvent

ITextEditProvider

IUIAutomation3::AddTextEditTextChangedEventHandler

Padrão de controle TextEdit