Udostępnij za pośrednictwem


ContentElement.OnPreviewStylusOutOfRange(StylusEventArgs) Metoda

Definicja

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

protected public:
 virtual void OnPreviewStylusOutOfRange(System::Windows::Input::StylusEventArgs ^ e);
protected internal virtual void OnPreviewStylusOutOfRange (System.Windows.Input.StylusEventArgs e);
abstract member OnPreviewStylusOutOfRange : System.Windows.Input.StylusEventArgs -> unit
override this.OnPreviewStylusOutOfRange : System.Windows.Input.StylusEventArgs -> unit
Protected Friend Overridable Sub OnPreviewStylusOutOfRange (e As StylusEventArgs)

Parametry

e
StylusEventArgs

Element StylusEventArgs zawierający dane zdarzenia.

Uwagi

Ta metoda nie ma implementacji domyślnej. Ponieważ klasa pośrednia w dziedziczeniu może zaimplementować tę metodę, zalecamy wywołanie implementacji podstawowej 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ących zdarzeń z klas pochodnych przez ustanowienie procedury obsługi klas zamiast programu 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 nie musi być 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 podejmować próby ponownego odzyskania wydarzenia.

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

Dotyczy

Zobacz też