다음을 통해 공유


UIElement.CharacterReceived 이벤트

정의

입력 큐에서 구성된 단일 문자를 수신할 때 발생합니다.

// Register
event_token CharacterReceived(TypedEventHandler<UIElement, CharacterReceivedRoutedEventArgs const&> const& handler) const;

// Revoke with event_token
void CharacterReceived(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::CharacterReceived_revoker CharacterReceived(auto_revoke_t, TypedEventHandler<UIElement, CharacterReceivedRoutedEventArgs const&> const& handler) const;
public event TypedEventHandler<UIElement,CharacterReceivedRoutedEventArgs> CharacterReceived;
function onCharacterReceived(eventArgs) { /* Your code */ }
uIElement.addEventListener("characterreceived", onCharacterReceived);
uIElement.removeEventListener("characterreceived", onCharacterReceived);
- or -
uIElement.oncharacterreceived = onCharacterReceived;
Public Custom Event CharacterReceived As TypedEventHandler(Of UIElement, CharacterReceivedRoutedEventArgs) 
<uiElement CharacterReceived="eventhandler"/>

이벤트 유형

Windows 요구 사항

디바이스 패밀리
Windows 10 Fall Creators Update (10.0.16299.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v5.0에서 도입되었습니다.)

설명

참고

구성된 문자는 하나 이상의 다른 문자 시퀀스에서 파생된 단일 시각적 개체입니다.

CharacterReceived는 라우트된 이벤트입니다. 라우트된 이벤트 개념에 대한 자세한 내용은 이벤트 및 라우트된 이벤트 개요를 참조하세요.

IME(입력 방법 편집기)가 사용하도록 설정된 경우 앱은 이 이벤트를 수신하지 않습니다. IME(입력 방법 편집기)는 모든 키보드 입력을 처리하고 Handled를 true로 설정합니다.

이 이벤트는 사용자가 입력할 때 컨트롤이 입력 큐의 문자에 따라 텍스트를 점진적으로 검색하고 필터링하는 "typeahead 찾기 또는 검색"(증분 검색, 증분 찾기 또는 실시간 제안이라고도 함)과 같은 텍스트 입력 시나리오에 유용합니다.

CharacterReceived 이벤트는 입력된 문자가 입력 큐에 등록될 때까지 이벤트가 발생하지 않으므로 입력된 문자에 따라 다른 시간에 발생할 수 있습니다.

  • 사용자가 W 키를 누릅니다(문자 'w'가 수신됨).
    • W용 PreviewKeyDown
    • W용 KeyDown
    • CharacterReceived
    • W용 PreviewKeyUp
    • W용 KeyUp
  • 사용자가 Shift+W 키를 누릅니다(문자 'W'가 수신됨).
    • Shift용 PreviewKeyDown
    • Shift용 KeyDown
    • W용 PreviewKeyDown
    • W용 KeyDown
    • CharacterReceived
    • W용 PreviewKeyUp
    • W용 KeyUp
    • Shift용 PreviewKeyUp
    • Shift용 KeyUp
  • 사용자가 NumPad를 사용하여 Alt+164를 누릅니다(문자 'ñ'이 수신됨).
    • Alt용 PreviewKeyDown
    • Alt에 대한 KeyDown
    • PreviewKeyDown for 1
    • KeyDown for 1
    • PreviewKeyUp for 1
    • KeyUp for 1
    • PreviewKeyDown for 6
    • KeyDown for 6
    • 6용 PreviewKeyUp
    • 6용 KeyUp
    • PreviewKeyDown for 4
    • KeyDown for 4
    • PreviewKeyUp for 4
    • 4용 KeyUp
    • CharacterReceived
    • Alt용 PreviewKeyUp
    • Alt용 KeyUp

적용 대상

추가 정보