UIElement.TextInput UIElement.TextInput UIElement.TextInput UIElement.TextInput Event

정의

이 요소가 디바이스와 별개의 방식으로 텍스트를 가져오면 발생합니다.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. 예를 들어를 TextBox 복합 컨트롤은 여기서는 TextInput 이벤트는 처리로 해당 합치기 내에 이미 표시 됩니다.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 이 클래스에 대 한 이벤트를 연결 되도록 TextInput 일부인 클래스의 멤버 때 목록을 UIElement 기본 요소로 상속 됩니다.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.

적용 대상