Udostępnij za pośrednictwem


UIElement.OnTextInput(TextCompositionEventArgs) Metoda

Definicja

Wywoływane, gdy nieobsługiwane TextInput 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:
 virtual void OnTextInput(System::Windows::Input::TextCompositionEventArgs ^ e);
protected virtual void OnTextInput (System.Windows.Input.TextCompositionEventArgs e);
abstract member OnTextInput : System.Windows.Input.TextCompositionEventArgs -> unit
override this.OnTextInput : System.Windows.Input.TextCompositionEventArgs -> unit
Protected Overridable Sub OnTextInput (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 UIElement 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ą.

Dotyczy

Zobacz też