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.
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.