UIElement.CharacterReceived 이벤트

정의

네임스페이스:

Microsoft.UI.Xaml

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

// 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"/>

이벤트 유형

TypedEventHandler<UIElement,CharacterReceivedRoutedEventArgs>

설명

참고

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

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
  • PreviewKeyUp for 6
  • 6용 KeyUp
  • PreviewKeyDown for 4
  • KeyDown for 4
  • PreviewKeyUp for 4
  • 4용 KeyUp
  • CharacterReceived
  • Alt용 PreviewKeyUp
  • Alt용 KeyUp

추가 정보

• CharacterReceivedRoutedEventArgs
• IsTextSearchEnabled