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
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8.1 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2012 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | uiautomationcoreapi.h |
| Biblioteca | Uiautomationcore.lib |
| DLL | Uiautomationcore.dll |
Confira também
HandleTextEditTextChangedEvent