ContentElement.TextInput 이벤트

정의

이 요소가 디바이스 독립적 방식으로 텍스트를 가져올 때 발생합니다.

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 

이벤트 유형

구현

설명

Important

이 이벤트는 복합 컨트롤의 내부 구현에 의해 처리된 것으로 이미 표시될 수 있습니다. 아래의 비고를 참조하세요.

복합 TextInput 컨트롤의 내부 구현에서 처리된 것으로 이벤트가 이미 표시될 수 있습니다. 예를 들어 a TextBox 는 이벤트가 이미 처리된 것으로 표시된 복합 컨트롤이며, 이 컨트롤 TextInput 은 해당 작성 내에서 처리됩니다. 컨트롤은 컨트롤이 화살표 키와 같은 일부 유형의 입력을 해당 컨트롤에 특별한 의미를 갖는 것으로 해석해야 하기 때문에 이 작업을 수행합니다. 텍스트 입력에 대한 처리기를 연결하는 이벤트로 사용하는 PreviewTextInput 경우 더 나은 결과를 얻을 수 있습니다. 이 기술은 컨트롤 컴퍼지션이 이미 이 이벤트를 처리된 것으로 표시하고 처리기가 이벤트 경로를 따라 이벤트를 수신하지 못하게 하는 대부분의 경우를 우회합니다.

TextInput 이벤트를 사용하면 구성 요소 또는 애플리케이션이 디바이스 독립적 방식으로 텍스트 입력을 수신 대기할 수 있습니다. 키보드는 기본 수단 TextInput이지만 음성, 필기 및 기타 입력 장치도 발생 TextInput합니다.

기본 키보드 또는 입력 메서드 편집기를 통한 키 조합으로 인해 여러 키 이벤트가 하나의 텍스트 입력 이벤트만 발생할 수 있습니다.

이 이벤트는 기본 요소로 상속될 때 TextCompositionManager.TextInput 클래스 멤버 목록의 일부이므로 TextInput 이 클래스에 연결된 이벤트에 대한 ContentElement 별칭을 만듭니다. 이벤트에 연결된 TextInput 이벤트 처리기는 기본 TextCompositionManager.TextInput 연결된 이벤트에 연결되고 동일한 이벤트 데이터 인스턴스를 받습니다.

라우트된 이벤트 정보

항목 가치
식별자 필드 TextInputEvent
라우팅 전략 버블링
대리자 TextCompositionEventHandler
  • 해당 터널링 이벤트는 PreviewTextInput.

  • 파생 클래스에서 이 이벤트에 대한 클래스 처리를 구현하려면 재정 OnTextInput 의합니다.

적용 대상