Pattern di controllo TextEdit

  • Articolo

Introduce linee guida e convenzioni per l'implementazione di ITextEditProvider, incluse informazioni sulle proprietà e sui metodi. Il pattern di controllo TextEdit viene utilizzato per l'accesso a livello di codice a un controllo che modifica il testo, ad esempio un controllo che esegue la correzione automatica o abilita la composizione di input.

Nota

Le note sull'implementazione in questo argomento fanno riferimento alle API provenienti da Text Services Framework (TSF). Per altre informazioni su TSF e informazioni di riferimento sull'API, vedi Framework di Servizi di testo.

Membri obbligatori per ITextEditProvider

Queste proprietà e metodi sono necessari per implementare l'interfaccia ITextEditProvider .

Membri obbligatori Tipo di membro Note
GetActiveComposition Metodo Restituisce l'intervallo della conversione corrente (nessuno se non è presente alcuna conversione). Restituisce la composizione attiva (in TSF, questo è l'intervallo contrassegnato da GUID_PROP_COMPOSING). Ad esempio, con l'IME (Microsoft Japanese Input Method Editor), si tratta del testo sottolineato completo.
GetConversionTarget Metodo Restituisce l'intervallo di destinazione di conversione corrente (nessuna conversione). In TSF si tratta dell'intervallo di caratteri contrassegnati come TF_ATTR_TARGET_NOTCONVERTED o TF_ATTR_TARGET_CONVERTED dalla struttura TF_DISPLAYATTRIBUTE .

Gli eventi TextEditTextChanged e ConversionTargetChanged devono essere generati da Microsoft Automazione interfaccia utente elementi che supportano il modello TextEdit.

TextEditTextChanged

TextEditChangeType Payload dell'evento Note
Correzione automatica Nuova stringa corretta Generato quando viene eseguita una correzione automatica dal controllo . Oppure ogni volta che viene effettuata una sostituzione tramite TSF e l'intervallo ha un valore GUID_PROP_TKB_ALTERNATES di TKB_ALTERNATES_AUTOCORRECTION_APPLIED.
Composizione Stringa aggiornata Il payload deve includere solo i caratteri modificati (non inviare l'intera stringa di composizione). Generato ogni volta che viene effettuata una sostituzione di composizione. In TSF, una sostituzione di composizione viene definita come sostituzione con il flag GUID_PROP_COMPOSING impostato. I controlli di modifica che implementano TSF possono monitorare queste modifiche tramite la notifica OnEndEdit .
CompositionFinalized Stringa di composizione finalizzata (vedere Note) In TSF la stringa di conversione da finalizzare viene definita dal flag GUID_PROP_COMPOSING rimosso da una composizione. Modificare i controlli che implementano TSF deve determinare la stringa finalizzata da EndComposition e generare l'evento quando viene chiamato OnEndEdit .
La stringa di composizione finalizzata può essere vuota se la composizione è stata annullata o eliminata.

ConversionTargetChanged

  • ConversionTargetChanged si verifica quando la destinazione di conversione cambia da una destinazione a un'altra.
  • Usare la funzione UiaRaiseAutomationEvent per generare l'evento ConversionTargetChanged (passare l'identificatore dell'evento UIA_TextEdit_ConversionTargetChangedEventId ).
  • ConversionTargetChanged non deve essere generato quando il contenuto della destinazione cambia. Se la modifica di destinazione si verifica contemporaneamente a una modifica di composizione, l'evento di modifica di destinazione deve essere generato dopo la generazione di eventi di composizione.
  • In TSF la destinazione di conversione viene definita dal valore TF_ATTR_TARGET_CONVERTED impostato dalla struttura TF_DISPLAYATTRIBUTE . Le modifiche possono essere monitorate tramite OnEndEdit.

Informazioni concettuali

Tipi di controllo e modelli di controllo supportati

Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente

Panoramica dell'albero di automazione dell'interfaccia utente