Linguaggio

UIElement.CharacterReceived Evento

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml
Modifica

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

Note

Un carattere composto è un singolo oggetto visivo derivato da una sequenza di uno o più caratteri.

CharacterReceived è un evento indirizzato. Per altre info sul concetto di evento indirizzato, vedi Panoramica degli eventi e degli eventi indirizzati.

Le app non ricevono questo evento quando è abilitato un Input Method Editor (IME). Input Method Editor (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 tipi di utente, il controllo cerca e filtra progressivamente il testo in base ai caratteri nella coda di input.

L'evento CharacterReceived può verificarsi in momenti diversi a seconda del carattere immesso, perché l'evento non viene generato fino a quando il carattere composto non viene registrato nella coda di input.

  • L'utente preme il tasto W (viene ricevuto il carattere 'w'):
    • PreviewKeyDown per W
    • KeyDown per W
    • CharacterReceived
    • PreviewKeyUp per W
    • KeyUp per W
  • L'utente preme i tasti MAIUSC+W (viene ricevuto il carattere 'W'):
    • PreviewKeyDown per Shift
    • KeyDown per MAIUSC
    • PreviewKeyDown per W
    • KeyDown per W
    • CharacterReceived
    • PreviewKeyUp per W
    • KeyUp per W
    • PreviewKeyUp per Shift
    • KeyUp per MAIUSC
  • L'utente preme ALT+164 usando NumPad (viene ricevuto il carattere 'ñ'):
    • 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