Condividi tramite


UIElement.CharacterReceived Evento

Definizione

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

Si applica a

Vedi anche