Questa documentazione è stata archiviata e non viene gestita.

Metodo UIElement.OnTextInput

Aggiornamento: novembre 2007

Viene richiamato quando un evento associato TextCompositionManager.TextInput non gestito raggiunge un elemento nella propria route derivato da questa classe. Implementare questo metodo per aggiungere la gestione di classi per questo evento.

Spazio dei nomi:  System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)

protected virtual void OnTextInput(
	TextCompositionEventArgs e
)
protected void OnTextInput(
	TextCompositionEventArgs e
)
protected function OnTextInput(
	e : TextCompositionEventArgs
)
Non è possibile utilizzare metodi in XAML.

Parametri

e
Tipo: System.Windows.Input.TextCompositionEventArgs

Classe TextCompositionEventArgs che contiene i dati dell'evento.

Questo metodo non ha un'implementazione predefinita. Poiché una classe intermedia nell'ereditarietà potrebbe implementare questo metodo, è consigliabile chiamare l'implementazione di base.

Lo scopo di questo metodo è simile ai metodi On* del modello di eventi Common Language Runtime (CLR): il metodo consente di gestire l'evento corrispondente proveniente dalle classi derivate stabilendo un gestore di classi anziché un gestore di istanze. In questo caso, l'evento corrispondente è un evento indirizzato. Il modello di implementazione dei metodi On* è diverso per gli eventi indirizzati perché un evento indirizzato può essere generato da un elemento figlio, che non è necessariamente l'elemento che richiamerà i gestori. L'implementazione, dunque, deve esaminare le proprietà di origine dei dati degli eventi senza tentare, nella maggior parte dei casi, di generare di nuovo l'evento.

Le classi derivate di UIElement possono chiamare metodi del gestore di classi private quando l'evento viene ricevuto lungo la route dell'evento, eseguendo l'override di questo metodo o registrando gestori di classi con RegisterClassHandler. La gestione delle classi è appropriata nel caso in cui si manipolano i dati degli eventi e si contrassegna l'evento indirizzato come gestito.

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0
Mostra: