Aracılığıyla paylaş


UIElement.OnPreviewTextInput(TextCompositionEventArgs) Yöntem

Tanım

İşlenmeyen PreviewTextInput bir ekli olay, bu sınıftan türetilen yolundaki bir öğeye ulaştığında çağrılır. Bu olay için sınıf işleme eklemek için bu yöntemi uygulayın.

protected:
 virtual void OnPreviewTextInput(System::Windows::Input::TextCompositionEventArgs ^ e);
protected virtual void OnPreviewTextInput (System.Windows.Input.TextCompositionEventArgs e);
abstract member OnPreviewTextInput : System.Windows.Input.TextCompositionEventArgs -> unit
override this.OnPreviewTextInput : System.Windows.Input.TextCompositionEventArgs -> unit
Protected Overridable Sub OnPreviewTextInput (e As TextCompositionEventArgs)

Parametreler

Açıklamalar

Bu yöntemin varsayılan uygulaması yoktur. Devralmadaki bir ara sınıf bu yöntemi uygulayabileceğinden, uygulamanızda temel uygulamayı çağırmanızı öneririz.

Bu yöntemin amacı, ortak dil çalışma zamanı (CLR) olay deseni On* yöntemlerine benzer: Bu yöntem, örnek işleyicisi yerine bir sınıf işleyicisi oluşturarak türetilmiş sınıflardan eşleşen olayı işlemek için araçlar sağlar. Bu durumda eşleşen olay yönlendirilmiş bir olaydır. Yönlendirilen bir olay, işleyicileri çağıracak öğe olması gerekmeyen bir alt öğe tarafından oluşturulabileceğinden, On* yöntemlerinin uygulama deseni yönlendirilen olaylar için farklıdır. Bu nedenle uygulamanızın olay verilerinin kaynak özelliklerini incelemesi gerekir. Çoğu durumda olayı yeniden değere döndürmeye çalışmamalıdır.

Bu yöntemi geçersiz kılarak veya ile RegisterClassHandlersınıf işleyicileri kaydederek, türetilmiş sınıfları UIElement olay yolu boyunca olay alındığında özel sınıf işleyici yöntemlerini çağırabilir. Sınıf işlemenin uygun olduğu senaryolardan biri, olay verilerini işlemek ve yönlendirilen olayı işlenmiş olarak işaretlemektir. Özellikle Önizleme olaylarına yönelik bir diğer senaryo da eşleşen kabarcık oluşturan sınıf işleyicilerinin çağrılmaması için bunların işlendiğini işaretlemektir.

Şunlara uygulanır

Ayrıca bkz.