Partilhar via

Padrão de controle do Editor de Texto

Apresenta diretrizes e convenções para implementar ITextEditProvider, incluindo informações sobre propriedades e métodos. O padrão de controle TextEdit é usado para acesso programático a um controle que modifica texto, por exemplo, um controle que executa a correção automática ou permite a composição de entrada.

Observação

As notas de implementação neste tópico referem-se a APIs provenientes do Text Services Framework (TSF). Para obter mais informações sobre a TSF e a referência da API, consulte Text Services Framework.

Membros necessários para ITextEditProvider

Essas propriedades e métodos são necessários para implementar o ITextEditProvider interface.

Membros obrigatórios Tipo de membro Observações
GetActiveComposition Método Retorna o intervalo da conversão atual (nenhuma se não houver conversão). Devolver a composição ativa (na TSF, este é o intervalo marcado por GUID_PROP_COMPOSING). Por exemplo, com o Microsoft Japanese Input Method Editor (IME), este seria o texto sublinhado completo.
GetConversionTarget Método Retorna o intervalo de destino de conversão atual (nenhum, se nenhuma conversão). Na TSF, este é o intervalo de caracteres marcados como TF_ATTR_TARGET_NOTCONVERTED ou TF_ATTR_TARGET_CONVERTED da estrutura TF_DISPLAYATTRIBUTE.

Os eventos TextEditTextChanged e ConversionTargetChanged devem ser gerados pelos elementos de Automação da Interface do Usuário da Microsoft que suportam o padrão Editor de Texto.

TextEditTextChanged

  • Use a função UiaRaiseTextEditTextChangedEvent para aumentar o evento TextEditTextChanged.
  • A tabela a seguir lista os casos em que você deve gerar o evento e os parâmetros deUiaRaiseTextEditTextChangedEvent a serem usados.
TextEditChangeType Carga útil do evento Observações
de AutoCorreção Nova string corrigida Acionado quando uma correção automática é feita pelo controle. Ou sempre que é feita uma substituição através da TSF e a gama tem um valor GUID_PROP_TKB_ALTERNATES de TKB_ALTERNATES_AUTOCORRECTION_APPLIED.
Composição A cadeia de caracteres atualizada A carga deve incluir apenas os caracteres que foram alterados (não envie toda a cadeia de composição). Levantado sempre que é feita uma substituição de composição. Na TSF, uma substituição de composição é definida como uma substituição que tem a bandeira GUID_PROP_COMPOSING definida. Os controles de edição que implementam a TSF podem monitorar essas alterações por meio da notificação OnEndEdit.
ComposiçãoFinalizado A sequência de composição finalizada (ver Notas) No TSF, a cadeia de conversão que está sendo finalizada é definida pelo sinalizador de GUID_PROP_COMPOSING que está sendo removido de uma composição. Os controles de edição que implementam o TSF devem determinar a cadeia de caracteres finalizada de EndComposition e gerar o evento quando OnEndEdit for chamado.
A cadeia de composição finalizada pode estar vazia se a composição foi cancelada ou excluída.

ConversionTargetChanged

  • ConversionTargetChanged ocorre quando o destino de conversão muda de um destino para outro.
  • Use a função UiaRaiseAutomationEvent para aumentar o evento ConversionTargetChanged (passe o identificador de evento UIA_TextEdit_ConversionTargetChangedEventId).
  • ConversionTargetChanged não deve ser gerado quando o conteúdo do destino é alterado. Se a alteração de destino ocorrer simultaneamente com uma alteração de composição, o evento de alteração de destino deverá ser gerado após quaisquer eventos de composição já terem sido gerados.
  • No TSF, o destino de conversão é definido pelo valor TF_ATTR_TARGET_CONVERTED que está sendo definido a partir da estrutura TF_DISPLAYATTRIBUTE. As alterações podem ser monitoradas usando OnEndEdit.

Conceptual

tipos de controle e seus padrões de controle suportados

Visão geral dos padrões de controle de automação da interface do do usuário

Visão geral da árvore de automação da interface do usuário

  • Last updated on