Partilhar via


UIElement.CharacterReceived Evento

Definição

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

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

Aplica-se a

Confira também