UIElement.CharacterReceived Evento

Definição

Namespace:

Microsoft.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>

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 cabeçalho" (também conhecido como pesquisa incremental, localização incremental ou sugestões em tempo real), em que, à medida que 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