ContentElement.OnPreviewTextInput(TextCompositionEventArgs) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 -> unitProtected Friend Overridable Sub OnPreviewTextInput (e As TextCompositionEventArgs)Parametry
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.
