UIElement.CharacterReceived Kejadian

  • Referensi

Definisi

Ruang nama:
Windows.UI.Xaml
Edit

Terjadi ketika karakter tunggal yang disusur diterima oleh antrean 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"/>

Jenis Acara

TypedEventHandler<UIElement,CharacterReceivedRoutedEventArgs>

Persyaratan Windows

Rangkaian perangkat
Windows 10 Fall Creators Update (diperkenalkan dalam 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v5.0)

Keterangan

Catatan

Karakter yang disusur adalah satu objek visual yang berasal dari urutan satu atau beberapa karakter lainnya.

CharacterReceived adalah peristiwa yang dirutekan. Untuk informasi selengkapnya tentang konsep peristiwa yang dirutekan, lihat Gambaran umum peristiwa dan peristiwa yang dirutekan.

Aplikasi tidak menerima peristiwa ini saat Editor Metode Input (IME) diaktifkan. Editor Metode Input (IME) menangani semua input dan set keyboard yang Ditangani ke true.

Kejadian ini berguna untuk skenario input teks seperti "typeahead find or search" (juga dikenal sebagai pencarian inkremental, inkremental find, atau saran real-time) di mana, sebagai jenis pengguna, kontrol secara progresif mencari dan memfilter teks berdasarkan karakter dalam antrean input.

Peristiwa CharacterReceived dapat terjadi pada waktu yang berbeda tergantung pada karakter yang dimasukkan, karena peristiwa tidak dipicu sampai karakter yang dikomposisikan terdaftar dalam antrean input.

  • Pengguna menekan tombol W (karakter 'w' diterima):
    • PreviewKeyDown untuk W
    • KeyDown untuk W
    • CharacterReceived
    • PreviewKeyUp untuk W
    • KeyUp untuk W
  • Pengguna menekan tombol Shift+W (karakter 'W' diterima):
    • PreviewKeyDown untuk Shift
    • KeyDown untuk Shift
    • PreviewKeyDown untuk W
    • KeyDown untuk W
    • CharacterReceived
    • PreviewKeyUp untuk W
    • KeyUp untuk W
    • PreviewKeyUp untuk Shift
    • KeyUp untuk Shift
  • Pengguna menekan Alt+164 menggunakan NumPad (karakter 'ñ' diterima):
    • PreviewKeyDown untuk Alt
    • KeyDown untuk Alt
    • PreviewKeyDown untuk 1
    • KeyDown untuk 1
    • PreviewKeyUp untuk 1
    • KeyUp untuk 1
    • PreviewKeyDown untuk 6
    • KeyDown untuk 6
    • PreviewKeyUp untuk 6
    • KeyUp untuk 6
    • PreviewKeyDown untuk 4
    • KeyDown untuk 4
    • PreviewKeyUp untuk 4
    • KeyUp untuk 4
    • CharacterReceived
    • PreviewKeyUp untuk Alt
    • KeyUp untuk Alt

Berlaku untuk

Lihat juga