CoreTextEditContext Classe

Definizione

Spazio dei nomi:

Windows.UI.Text.Core

Oggetto primario utilizzato dai controlli di input di testo per comunicare con il server di input di testo.

public ref class CoreTextEditContext sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreTextEditContext final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class CoreTextEditContext

Public NotInheritable Class CoreTextEditContext

Ereditarietà

Object Platform::Object IInspectable CoreTextEditContext

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Per ottenere un oggetto di questo tipo, chiamare CoreTextServicesManager.CreateEditContext.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1511	10586	NotifyFocusLeaveCompleted

Proprietà

InputPaneDisplayPolicy	Ottiene o imposta un valore che indica se il riquadro di input deve essere visualizzato automaticamente quando lo stato attivo entra nel controllo input di testo. Il valore predefinito è Automatico, che indica che il riquadro di input verrà visualizzato automaticamente. Il valore Manual indica che l'app sarà responsabile di visualizzare e nascondere il riquadro di input usando InputPane.TryShow e TryHide.
InputScope	Ottiene o imposta un valore che indica l'ambito di input del controllo input di testo.
IsReadOnly	Ottiene o imposta un valore che indica se il controllo di modifica è modificabile.
Name	Ottiene o imposta un nome descrittivo per il controllo input di testo. Un framework applicazione usa in genere proprietà come "name" o "id" per identificare un controllo, quindi è consigliabile impostare questa proprietà di conseguenza nel server di input di testo in modo che i processori di input possano mantenere meglio il contesto di input e fornire suggerimenti migliori.

Metodi

NotifyFocusEnter()	Notifica al server di input di testo che lo stato attivo ha immesso il controllo input di testo.
NotifyFocusLeave()	Notifica al server di input di testo che lo stato attivo ha lasciato il controllo input di testo.
NotifyLayoutChanged()	Notifica al server di input di testo che il layout del testo all'interno del controllo input di testo è stato modificato.
NotifySelectionChanged(CoreTextRange)	Notifica al server di input di testo qualsiasi modifica che il controllo input di testo deve apportare all'intervallo di selezione. Questo è importante per mantenere sincronizzato lo stato interno del controllo e lo stato interno del server.
NotifyTextChanged(CoreTextRange, Int32, CoreTextRange)	Notifica al server di input di testo qualsiasi modifica che il controllo input di testo deve apportare al testo. Questo è importante per mantenere sincronizzato lo stato interno del controllo e lo stato interno del server. Poiché è anche probabile che una modifica al testo influisca sull'intervallo di selezione, il metodo accetta l'intervallo di selezione come parametro.

Eventi

CompositionCompleted	Si verifica al termine della composizione.
CompositionStarted	Si verifica all'avvio della composizione.
FocusRemoved	Si verifica quando lo stato attivo è stato rimosso forzatamente da un controllo di input di testo. L'applicazione deve gestire questo evento per rimuovere di conseguenza lo stato attivo per il controllo di input di testo.
FormatUpdating	Si verifica quando il server di input di testo deve applicare un formato diverso a un determinato intervallo di testo. Questo avviene in genere durante la composizione.
LayoutRequested	Si verifica quando il server di input di testo deve ottenere il rettangolo di selezione di un intervallo di testo e del controllo input di testo stesso. L'applicazione deve gestire questo evento e restituire le informazioni geometry richieste.
NotifyFocusLeaveCompleted	Si verifica dopo che lo stato attivo ha lasciato il controllo input di testo.
SelectionRequested	Si verifica quando il server di input di testo deve ottenere l'intervallo di testo che rappresenta il testo attualmente selezionato nel controllo input di testo. L'applicazione deve gestire questo evento e restituire l'intervallo richiesto.
SelectionUpdating	Si verifica quando il server di input di testo deve modificare l'intervallo di testo attualmente selezionato nel controllo input di testo. Questo evento può essere il risultato di un processore di input che deve selezionare un testo o spostare il cursore. Il controllo input di testo deve impostare di conseguenza l'intervallo di selezione.
TextRequested	Si verifica quando il server di input di testo deve ottenere un intervallo di testo dal controllo input di testo. L'applicazione deve gestire questo evento e restituire l'intervallo richiesto.
TextUpdating	Si verifica quando il server di input di testo deve modificare il testo all'interno del controllo input di testo. Questo evento può essere il risultato di un evento chiave, ad esempio l'inserimento di un singolo carattere, o il risultato dell'elaborazione eseguita da un processore di input, ad esempio la correzione automatica e la stima. Quando si gestisce l'evento, il controllo input di testo deve sostituire un intervallo con il nuovo testo fornito dal server e spostare anche il cursore alla fine del nuovo testo.

Vedi anche

• Esempio di controllo di modifica personalizzato