UIElement.TextInput 이벤트

정의

이 요소가 디바이스와 별개의 방식으로 텍스트를 가져오면 발생합니다.Occurs when this element gets text in a device-independent manner.

public:
 virtual event System::Windows::Input::TextCompositionEventHandler ^ TextInput;
public event System.Windows.Input.TextCompositionEventHandler TextInput;
member this.TextInput : System.Windows.Input.TextCompositionEventHandler 
Public Custom Event TextInput As TextCompositionEventHandler 

구현

설명

중요

이 이벤트는 이미 합성 컨트롤의 내부 구현에 의해 처리 된 것으로 표시 되어 있을 수 있습니다.This event might already be marked as handled by the internal implementations of composited controls. 아래 설명을 참조 하세요.See Remark below.

TextInput 이벤트가 이미 합성 컨트롤의 내부 구현에 의해 처리 된 것으로 표시 되어 있을 수 있습니다.The TextInput event may already be marked as handled by the internal implementations of composited controls. 예를 들어 TextBoxTextInput 이벤트가 이미 처리 된 것으로 표시 된 합성 컨트롤입니다. 합성 내에서For example, a TextBox is a composited control where the TextInput event is already marked as handled; within its compositing. 컨트롤은 컨트롤에 특별 한 의미를 갖는 화살표 키와 같은 일부 형식의 입력을 해석 해야 하기 때문에이 작업을 수행 합니다.Controls do this because the control needs to interpret some types of input, such as arrow keys, as having special meaning to that control. 텍스트 입력에 대 한 처리기를 연결 하는 이벤트로 PreviewTextInput를 사용 하는 경우 더 나은 결과를 얻을 수 있습니다.If you use PreviewTextInput as the event where you attach handlers for text input, you may receive better results. 이 기술은 컨트롤 컴퍼지션이 이미이 이벤트를 처리 된 것으로 표시 하 고 처리기가 이벤트 경로를 따라 이벤트를 수신 하지 못하도록 하는 대부분의 경우를 우회 합니다.This technique circumvents most cases where control composition has already marked this event as handled and prevents your handler from receiving the event along the event route.

TextInput 이벤트 구성 요소 또는 디바이스 독립적인 방식으로 텍스트 입력에 대 한 수신 대기 하도록 애플리케이션을 허용 합니다.The TextInput event allows a component or application to listen for text input in a device-independent manner. 키보드는 방식과 TextInput, 음성, 필기 및 기타 입력된 디바이스를 발생 시킬 수 있지만 TextInput합니다.The keyboard is the primary means of TextInput, but speech, handwriting, and other input devices can also raise TextInput.

키 조합으로 인해 기본 키보드 또는 입력 메서드 편집기를 통해 여러 키 이벤트에서 하나의 텍스트 입력 이벤트만 발생 시킬 수 있습니다.Because of key combinations - either in default keyboards or through input method editors - multiple key events might raise just one text input event.

이 이벤트는이 클래스에 대해 연결 된 TextCompositionManager.TextInput 이벤트에 대 한 별칭을 만듭니다. 따라서 UIElement 기본 요소로 상속 될 때 TextInput 클래스 멤버 목록의 일부가 됩니다.This event creates an alias for the TextCompositionManager.TextInput attached event for this class, so that TextInput is part of the class members list when UIElement is inherited as a base element. TextInput 이벤트에 연결 된 이벤트 처리기는 기본 TextCompositionManager.TextInput 연결 된 이벤트에 연결 되며 동일한 이벤트 데이터 인스턴스를 수신 합니다.Event handlers that are attached to the TextInput event are attached to the underlying TextCompositionManager.TextInput attached event and receive the same event data instance.

라우팅 이벤트 정보Routed Event Information

식별자 필드Identifier field TextInputEvent
라우팅 전략Routing strategy 버블링Bubbling
대리자Delegate TextCompositionEventHandler
  • 해당 터널링 이벤트가 PreviewTextInput합니다.The corresponding tunneling event is PreviewTextInput.

  • 파생 클래스에서이 이벤트에 대 한 클래스 처리를 구현 하려면 OnTextInput를 재정의 합니다.Override OnTextInput to implement class handling for this event in derived classes.

적용 대상