Udostępnij za pośrednictwem


ContentElement.OnPreviewTextInput(TextCompositionEventArgs) Metoda

Definicja

Wywoływane, gdy nieobsługiwane PreviewTextInput dołączone zdarzenie osiąga element w trasie pochodzącej z tej klasy. Zaimplementuj tę metodę, aby dodać obsługę klas dla tego zdarzenia.

protected public:
 virtual void OnPreviewTextInput(System::Windows::Input::TextCompositionEventArgs ^ e);
protected internal 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 Friend Overridable Sub OnPreviewTextInput (e As TextCompositionEventArgs)

Parametry

e
TextCompositionEventArgs

Element TextCompositionEventArgs zawierający dane zdarzenia.

Uwagi

Ta metoda nie ma domyślnej implementacji. Ponieważ klasa pośrednia w dziedziczeniu może zaimplementować tę metodę, zalecamy wywołanie podstawowej implementacji w implementacji.

Cel tej metody jest podobny do wzorca zdarzeń środowiska uruchomieniowego języka wspólnego (CLR) On*: ta metoda zapewnia środki do obsługi pasującego zdarzenia z klas pochodnych przez ustanowienie procedury obsługi klas zamiast procedury obsługi wystąpień. W takim przypadku zgodne zdarzenie jest zdarzeniem kierowanym. Wzorzec implementacji metod On* różni się w przypadku zdarzeń kierowanych, ponieważ zdarzenie kierowane może być wywoływane przez element podrzędny, który niekoniecznie jest elementem, który będzie wywoływać programy obsługi. W związku z tym implementacja musi zbadać właściwości źródłowe danych zdarzenia. W większości przypadków nie należy próbować przeprowadzić ponownej oceny zdarzenia.

Przez zastąpienie tej metody lub zarejestrowanie procedur obsługi klas za RegisterClassHandlerpomocą klasy pochodnej ContentElement klasy może wywoływać metody procedury obsługi klas prywatnych, gdy zdarzenie jest odbierane wzdłuż trasy zdarzenia. Jednym ze scenariuszy, w którym obsługa klas jest odpowiednia, jest manipulowanie danymi zdarzenia i oznaczanie zdarzenia kierowanego zgodnie z obsługą. Innym scenariuszem, który jest przeznaczony dla zdarzeń w wersji zapoznawczej, jest oznaczenie ich obsłużonych tak, aby pasujące programy obsługi klas nie zostały wywołane.

Dotyczy

Zobacz też