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.
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
- Use a função UiaRaiseTextEditTextChangedEvent para gerar o evento TextEditTextChanged .
- A tabela a seguir lista os casos em que você deve gerar o evento e os parâmetros UiaRaiseTextEditTextChangedEvent a serem usados.
| 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.