UIElement.TextInput Evento

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationCore.dll

Si verifica in seguito all'input di testo per l'elemento in modo indipendente dalla periferica.

public:
 virtual event System::Windows::Input::TextCompositionEventHandler ^ TextInput;

public event System.Windows.Input.TextCompositionEventHandler TextInput;

member this.TextInput : System.Windows.Input.TextCompositionEventHandler 

Public Custom Event TextInput As TextCompositionEventHandler 

Tipo evento

TextCompositionEventHandler

Implementazioni

TextInput

Commenti

Importante

Questo evento potrebbe essere già contrassegnato come gestito dalle implementazioni interne dei controlli compositi. Vedere Il commento riportato di seguito.

L'evento TextInput può essere già contrassegnato come gestito dalle implementazioni interne dei controlli compositi. Ad esempio, un TextBox è un controllo composito in cui l'evento è già contrassegnato come gestito; all'interno della TextInput composizione. I controlli eseguono questa operazione perché il controllo deve interpretare alcuni tipi di input, ad esempio i tasti di direzione, come il significato speciale per tale controllo. Se si usa PreviewTextInput come evento in cui si allegano gestori per l'input di testo, è possibile ricevere risultati migliori. Questa tecnica consente di aggirare la maggior parte dei casi in cui la composizione del controllo ha già contrassegnato questo evento come gestito e impedisce al gestore di ricevere l'evento lungo la route dell'evento.

L'evento TextInput consente a un componente o a un'applicazione di ascoltare l'input di testo in modo indipendente dal dispositivo. La tastiera è il mezzo principale di , ma voce, scrittura a mano e altri dispositivi di TextInputinput possono anche generare TextInput.

A causa delle combinazioni di tasti, ovvero nelle tastiere predefinite o tramite editor di metodi di input, più eventi chiave potrebbero generare un solo evento di input di testo.

Questo evento crea un alias per l'evento collegato per questa classe, in modo che TextInput faccia parte dell'elenco TextCompositionManager.TextInput dei membri della classe quando UIElement viene ereditato come elemento di base. I gestori eventi collegati all'evento vengono collegati all'evento TextInput collegato sottostante TextCompositionManager.TextInput e ricevono la stessa istanza dei dati dell'evento.

Informazioni evento indirizzato

Campo Identificatore	TextInputEvent
Strategia di routing	Bubbling
Delegato	TextCompositionEventHandler

• L'evento di tunneling corrispondente è PreviewTextInput.

• Eseguire l'override per implementare OnTextInput la gestione delle classi per questo evento nelle classi derivate.