정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

UIElement.TextInput 이벤트

2013-12-13

UI 요소가 장치 독립적인 방식으로 텍스트를 가져올 때 발생합니다.

Namespace:  System.Windows
어셈블리:  System.Windows(System.Windows.dll)
XMLNS for XAML: xmlns에 매핑되지 않습니다.

public event TextCompositionEventHandler TextInput
<uiElement TextInput="eventhandler"/>

이 이벤트는 비동기적으로 발생합니다.

TextCompositionEventHandler를 기반으로 처리기를 사용하여 이 이벤트를 처리합니다.

TextInputKeyUp 또는 KeyDown을 사용하고 TextBox 같은 결과를 결합하여 키 단위로 키 입력을 이미 처리하고 있는 요소에 의해서만 발생됩니다. TextInput는 버블링되는 라우트 이벤트이기 때문에 TextBox에 특정한 것보다 UIElement에 일반적인 이벤트이며 합성 컨테이너에서 처리할 수 있습니다. 예를 들어, 사용자 지정 컨트롤은 텍스트 상자 구성 요소의 하나 이상을 업데이트할 수 있으며 OnApplyTemplate 구현에서 작업의 하나로 구성 요소 루트 수준에서 TextInput를 후크할 수 있습니다.

TextInput 이벤트를 사용하면 구성 요소나 응용프로그램이 장치 독립적인 방식으로 텍스트 입력을 수신할 수 있습니다. 키보드는 텍스트를 입력하는 기본 수단이지만 IME(입력기)를 포함한 사용자 지정 터치 동작과 기타 입력 기술도 TextInput을 발생시킬 수 있습니다.

이 이벤트는 버블링 이벤트입니다. 이는 개체 트리에서 부모-자식 관계로 연결된 일련의 개체에 대해 여러 개의 TextInput 처리기가 등록되어 있을 경우 이동 경로가 부모 방향인 관계에 포함된 각 개체에서 이벤트를 수신함을 의미합니다. 이벤트 처리기에서 사용할 수 있는 sender는 이벤트가 처리되는 개체를 식별합니다. 이 개체는 이벤트가 시작된 입력 조건을 실제로 받는 개체가 아닐 수도 있습니다. 이벤트를 시작한 개체를 가져오려면 이벤트의 RoutedEventArgs 이벤트 데이터에서 OriginalSource 값을 사용합니다. 라우트된 이벤트 개념에 대한 자세한 내용은 Windows Phone의 텍스트를 참조하세요.

Windows Phone의 IME 지원은 TextBox에 설정할 수 있는 IME 처리 및 동작에 영향을 미칠 수 있는 연결된 속성도 포함합니다. InputMethod를 참조하세요.

TextInput 및 OnTextInput

컨트롤 클래스의 경우(Control에서 파생되는 모든 클래스) OnTextInput에 정의된 대로 텍스트 입력에 대해 할당된 가상/재정의 처리기가 있을 수 있습니다.

Windows Phone OS

지원되는 버전: 8.0, 7.1

Windows Phone

표시: