UIElement.CharacterReceived Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Si verifica quando un singolo carattere composto viene ricevuto dalla coda di input.
// 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 evento
Requisiti Windows
| Famiglia di dispositivi |
Windows 10 Fall Creators Update (è stato introdotto in 10.0.16299.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v5.0)
|
Commenti
Nota
Un carattere composto è un singolo oggetto visivo derivato da una sequenza di uno o più caratteri.
CharacterReceived è un evento instradato. Per altre informazioni sul concetto di evento indirizzato, vedere Panoramica degli eventi e degli eventi indirizzati.
Le app non ricevono questo evento quando un editor di metodi di input (IME) è abilitato. L'editor di metodi di input (IME) gestisce tutti gli input della tastiera e imposta Handled su true.
Questo evento è utile per gli scenari di input di testo, ad esempio "typeahead find or search" (noto anche come ricerca incrementale, ricerca incrementale o suggerimenti in tempo reale) in cui, come i tipi utente, il controllo cerca progressivamente e filtra il testo in base ai caratteri nella coda di input.
L'evento CharacterReceived può verificarsi in momenti diversi a seconda del carattere immesso, poiché l'evento non viene attivato finché il carattere composto non viene registrato nella coda di input.
- L'utente preme il tasto W (il carattere 'w' viene ricevuto):
- PreviewKeyDown per W
- KeyDown per W
- CharacterReceived
- PreviewKeyUp per W
- KeyUp per W
- L'utente preme i tasti MAIUSC+W (il carattere 'W' viene ricevuto):
- PreviewKeyDown per Maiusc
- KeyDown per MAIUSC
- PreviewKeyDown per W
- KeyDown per W
- CharacterReceived
- PreviewKeyUp per W
- KeyUp per W
- PreviewKeyUp for Shift
- KeyUp per maiusc
- L'utente preme ALT+164 usando NumPad (il carattere 'ñ' viene ricevuto):
- PreviewKeyDown per ALT
- KeyDown per ALT
- PreviewKeyDown per 1
- KeyDown per 1
- PreviewKeyUp per 1
- KeyUp per 1
- PreviewKeyDown per 6
- KeyDown per 6
- PreviewKeyUp per 6
- KeyUp per 6
- PreviewKeyDown per 4
- KeyDown per 4
- PreviewKeyUp per 4
- KeyUp per 4
- CharacterReceived
- PreviewKeyUp per ALT
- KeyUp per ALT