UIElement.CharacterReceived Evento

Definición

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

Requisitos de Windows

Familia de dispositivos
Windows 10 Fall Creators Update (se introdujo en la versión 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v5.0)

Comentarios

Nota

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

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

Las aplicaciones no reciben este evento cuando está habilitado 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 o búsqueda de tipos" (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 texto en función de los caracteres de la cola de entrada.

El evento CharacterReceived puede producirse en diferentes momentos según el carácter especificado, ya que el evento no se activa 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

Se aplica a

Consulte también