UIElement.CharacterReceived Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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