Share via

Padrão de controle TextEdit

  • Artigo

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.

Observação

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 de API, consulte Text Services Framework.

Membros necessários para ITextEditProvider

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

Membros necessários Tipo de membro Observaçõ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 marcado como TF_ATTR_TARGET_NOTCONVERTED ou TF_ATTR_TARGET_CONVERTED da estrutura TF_DISPLAYATTRIBUTE .

Os eventos TextEditTextChanged e ConversionTargetChanged devem ser gerados pela Microsoft Automação da Interface do Usuário elementos que dão suporte ao padrão TextEdit.

TextEditTextChanged

TextEditChangeType Carga do evento Observações
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.
Composição A cadeia de caracteres atualizada O conteúdo deve incluir apenas os caracteres que foram alterados (não envie toda a cadeia de caracteres de composição). 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. Os controles de edição que implementam o TSF podem monitorar essas alterações por meio da notificação OnEndEdit .
CompositionFinalized A cadeia de caracteres de composição finalizada (consulte Observações) No TSF, a cadeia de caracteres de conversão que está sendo finalizada é definida pelo sinalizador 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 acionar 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ção UiaRaiseAutomationEvent 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 simultaneamente 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 de Padrões de Controle de Automação de Interface de Usuário

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