UIElement.CharacterReceived Evento

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml

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

TypedEventHandler<UIElement,CharacterReceivedRoutedEventArgs>

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

Vedi anche

• CharacterReceivedRoutedEventArgs
• IsTextSearchEnabled