다음을 통해 공유


UIElement3D.OnPreviewTextInput(TextCompositionEventArgs) 메서드

정의

처리되지 않은 PreviewTextInput 연결 이벤트가 해당 경로에서 이 클래스로부터 파생된 요소에 도달할 경우 호출됩니다. 이 이벤트에 대한 클래스 처리를 추가하려면 이 메서드를 구현합니다.

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)

매개 변수

e
TextCompositionEventArgs

이벤트 데이터를 포함하는 TextCompositionEventArgs입니다.

설명

이 메서드에는 기본 구현이 없습니다. 상속의 중간 클래스가 이 메서드를 구현할 수 있으므로 구현에서 기본 구현을 호출하는 것이 좋습니다.

이 메서드의 목적은 CLR(공용 언어 런타임) 이벤트 패턴 On* 메서드와 유사합니다. 이 메서드는 instance 처리기 대신 클래스 처리기를 설정하여 파생 클래스에서 일치하는 이벤트를 처리하는 수단을 제공합니다. 이 경우 일치하는 이벤트는 라우트된 이벤트입니다. 라우트된 이벤트는 처리기를 호출할 요소가 아닌 자식 요소에 의해 발생할 수 있으므로 On* 메서드의 구현 패턴은 라우트된 이벤트에 대해 다릅니다. 따라서 구현은 이벤트 데이터의 원본 속성을 검사해야 합니다. 대부분의 경우 이벤트를 다시 평가해서는 안 됩니다.

이 메서드를 재정의하거나 에 클래스 처리기를 RegisterClassHandler등록하여 의 UIElement3D 파생 클래스는 이벤트 경로를 따라 이벤트가 수신될 때 프라이빗 클래스 처리기 메서드를 호출할 수 있습니다. 클래스 처리가 적절한 시나리오 중 하나는 이벤트 데이터를 조작하고 라우트된 이벤트를 처리된 것으로 표시하는 것입니다. 특히 미리 보기 이벤트에 대한 또 다른 시나리오는 일치하는 버블링 클래스 처리기가 호출되지 않도록 처리된 것으로 표시하는 것입니다.

적용 대상

추가 정보