UIElement.CharacterReceived Evento

Definição

Namespace:

Windows.UI.Xaml

Ocorre quando um único caractere composto é recebido pela fila de entrada.

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

Tipo de evento

TypedEventHandler<UIElement,CharacterReceivedRoutedEventArgs>

Requisitos do Windows

Família de dispositivos	Windows 10 Fall Creators Update (introduzida na 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v5.0)

Comentários

Observação

Um caractere composto é um único objeto visual derivado de uma sequência de um ou mais outros caracteres.

CharacterReceived é um evento roteado. Para obter mais informações sobre o conceito de evento roteado, consulte Visão geral de eventos e eventos roteado.

Os aplicativos não recebem esse evento quando um IME (Editor de Método de Entrada) está habilitado. O IME (Editor de Método de Entrada) manipula todas as entradas de teclado e define Handled como true.

Esse evento é útil para cenários de entrada de texto, como "localização ou pesquisa de typeahead" (também conhecido como pesquisa incremental, localização incremental ou sugestões em tempo real), em que, conforme o usuário digita, o controle pesquisa progressivamente e filtra o texto com base nos caracteres na fila de entrada.

O evento CharacterReceived pode ocorrer em momentos diferentes dependendo do caractere inserido, pois o evento não é acionado até que o caractere composto seja registrado na fila de entrada.

• O usuário pressiona a tecla W (o caractere 'w' é recebido):
  • PreviewKeyDown para W
  • KeyDown para W
  • CharacterReceived
  • PreviewKeyUp para W
  • KeyUp para W
• O usuário pressiona as teclas Shift+W (o caractere 'W' é recebido):
  • PreviewKeyDown para Shift
  • KeyDown para Shift
  • PreviewKeyDown para W
  • KeyDown para W
  • CharacterReceived
  • PreviewKeyUp para W
  • KeyUp para W
  • PreviewKeyUp para Shift
  • KeyUp para Shift
• O usuário pressiona Alt+164 usando o NumPad (o caractere 'ñ' é recebido):
  • PreviewKeyDown para Alt
  • KeyDown para Alt
  • PreviewKeyDown para 1
  • KeyDown para 1
  • PreviewKeyUp para 1
  • KeyUp para 1
  • PreviewKeyDown para 6
  • KeyDown para 6
  • PreviewKeyUp para 6
  • KeyUp para 6
  • PreviewKeyDown para 4
  • KeyDown para 4
  • PreviewKeyUp para 4
  • KeyUp para 4
  • CharacterReceived
  • PreviewKeyUp para Alt
  • KeyUp para Alt

Confira também

• CharacterReceivedRoutedEventArgs
• IsTextSearchEnabled