Compartilhar via

Padrão de controle TextEdit

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 o texto, por exemplo, um controle que executa a correção automática ou habilita a composição de entrada.

Nota

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

Membros necessários para ITextEditProvider

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

Membros necessários Tipo de membro Anotações
GetActiveComposition Método Retorna o intervalo da conversão atual (nenhum se não houver conversão). Retornar a composição ativa (no TSF, esse é o intervalo marcado por GUID_PROP_COMPOSING). Por exemplo, com o IME (Editor de Método de Entrada) japonês da Microsoft, esse seria o texto sublinhado completo.
GetConversionTarget Método Retorna o intervalo de destino de conversão atual (nenhum se nenhuma conversão). No TSF, esse é o intervalo de caracteres marcados como TF_ATTR_TARGET_NOTCONVERTED ou TF_ATTR_TARGET_CONVERTED da estrutura TF_DISPLAYATTRIBUTE.

Os TextEditTextChanged e ConversionTargetChanged são necessários para serem gerados por elementos da Automação da Interface do Usuário da Microsoft que dão suporte ao padrão de TextEdit.

TextEditTextChanged

  • Use a funçãoUiaRaiseTextEditTextChangedEvent para gerar o evento TextEditTextChanged.
  • A tabela a seguir lista os casos em que você deve gerar o evento e os parâmetrosUiaRaiseTextEditTextChangedEvent a serem usados.
TextEditChangeType Conteúdo do evento Anotações
de AutoCorreção Nova cadeia de caracteres corrigida Gerado quando uma correção automática é feita pelo controle. Ou sempre que uma substituição é feita por meio de TSF e o intervalo tem um valor GUID_PROP_TKB_ALTERNATES de TKB_ALTERNATES_AUTOCORRECTION_APPLIED.
de composição A cadeia de caracteres atualizada O conteúdo deve incluir apenas os caracteres que foram alterados (não enviar a cadeia de caracteres de composição inteira). Gerado sempre que uma substituição de composição é feita. No TSF, uma substituição de composição é definida como uma substituição que tem o sinalizador GUID_PROP_COMPOSING definido. Editar controles que implementam o TSF pode monitorar essas alterações por meio da notificação OnEndEdit.
CompositionFinalized A cadeia de caracteres de composição finalizada (consulte Anotações) No TSF, a cadeia de caracteres de conversão que está sendo finalizada é definida pelo sinalizador GUID_PROP_COMPOSING sendo removido de uma composição. Editar controles que implementam o TSF deve determinar a cadeia de caracteres finalizada de EndComposition e gerar o evento quando OnEndEdit for chamado.
A cadeia de caracteres de composição finalizada poderá estar vazia se a composição tiver sido cancelada ou excluída.

ConversionTargetChanged

  • ConversionTargetChanged ocorre quando o destino de conversão é alterado de um destino para outro.
  • Use a funçãoUiaRaiseAutomationEvent para gerar 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 simultânea com uma alteração de composição, o evento de alteração de destino deverá ser gerado após qualquer evento de composição já ter sido gerado.
  • No TSF, o destino de conversão é definido pelo valor TF_ATTR_TARGET_CONVERTED sendo definido da estrutura TF_DISPLAYATTRIBUTE. As alterações podem ser monitoradas usando OnEndEdit.

Conceitual

tipos de controle e seus padrões de controle com suporte

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

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

  • Last updated on