UIElement.CharacterReceived Evento

Definición

Espacio de nombres:

Microsoft.UI.Xaml

Se produce cuando la cola de entrada recibe un carácter compuesto único.

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

Comentarios

Nota

Un carácter compuesto es un único objeto visual derivado de una secuencia de uno o varios caracteres.

CharacterReceived es un evento enrutado. Para obtener más información sobre el concepto de eventos enrutados, consulta Información general sobre eventos y eventos enrutados.

Las aplicaciones no reciben este evento cuando se habilita un Editor de métodos de entrada (IME). El Editor de métodos de entrada (IME) controla todas las entradas de teclado y establece Handled en true.

Este evento es útil para escenarios de entrada de texto, como "búsqueda anticipada de tipo" (también conocido como búsqueda incremental, búsqueda incremental o sugerencias en tiempo real), donde, a medida que el usuario escribe, el control busca y filtra progresivamente el texto en función de los caracteres de la cola de entrada.

El evento CharacterReceived puede producirse en momentos diferentes según el carácter especificado, ya que el evento no se desencadena hasta que el carácter compuesto se registra en la cola de entrada.

• El usuario presiona la tecla W (se recibe el carácter "w"):
  • PreviewKeyDown para W
  • KeyDown para W
  • CharacterReceived
  • PreviewKeyUp para W
  • KeyUp para W
• El usuario presiona las teclas Mayús+W (se recibe el carácter "W"):
  • PreviewKeyDown para Mayús
  • KeyDown para Mayús
  • PreviewKeyDown para W
  • KeyDown para W
  • CharacterReceived
  • PreviewKeyUp para W
  • KeyUp para W
  • PreviewKeyUp para Mayús
  • KeyUp para Mayús
• El usuario presiona Alt+164 con el NumPad (se recibe el carácter "ñ"):
  • 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

Consulte también

• CharacterReceivedRoutedEventArgs
• IsTextSearchEnabled