KeyRoutedEventArgs Kelas

Definisi

Menyediakan data peristiwa untuk peristiwa yang dirutekan KeyUp dan KeyDown .

public ref class KeyRoutedEventArgs sealed : RoutedEventArgs
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class KeyRoutedEventArgs final : RoutedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class KeyRoutedEventArgs : RoutedEventArgs
Public NotInheritable Class KeyRoutedEventArgs
Inherits RoutedEventArgs
Warisan
Object Platform::Object IInspectable RoutedEventArgs KeyRoutedEventArgs
Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Input tombol dipetakan ke nilai kunci yang berbeda untuk berbagai perangkat.

Tabel ini menyediakan detail pemetaan untuk game pad dan perangkat jarak jauh.

Tombol

50

GamepaddPadUp/Bawah/Kiri/KananGamepadDPadUp/Down/Left/Right atau NavigationUp/Down/Left/Right
GamePad Joystick/ThumbstickGamepadLeftThumbstickButton/Up/Down/Left/Right atau GamepadRightThumbstickButton/Up/Down/Left/RightGamepadLeftThumbstickButton/Up/Down/Left/Right atau GamepadRightThumbstickButton/Up/Down/Left/Right atau NavigationUp/Down/Left/Right
Pemicu GamepadGamePadRightTrigger/LeftTriggerGamePadRightTrigger/LeftTrigger
Bumper/Bahu GamepadGamePadrightShoulder/LeftShoulderGamePadrightShoulder/LeftShoulder
Tombol Menu GamepadGamepadMenuGamepadMenu atau NavigationMenu
Tombol Tampilan GamepadTampilan GamepadTampilan Gamepad atau Tampilan Navigasi

Riwayat versi

Versi Windows Versi SDK Nilai ditambahkan
1607 14393 DeviceId

Properti

DeviceId

Mendapatkan ID unik untuk perangkat input yang menghasilkan peristiwa kunci ini.

Gunakan DeviceId untuk membedakan antara semua perangkat yang terhubung yang dapat menghasilkan peristiwa utama, seperti beberapa pengontrol game.

DeviceId tidak didukung untuk semua perangkat input.

Handled

Mendapatkan atau menetapkan nilai yang menandai peristiwa yang dirutekan sebagai ditangani. Nilai yang benar untuk Ditangani mencegah sebagian besar handler di sepanjang rute peristiwa menangani peristiwa yang sama lagi.

Key

Mendapatkan kunci virtual yang terkait dengan peristiwa.

Tergantung pada perangkat input, ini bisa menjadi nilai yang dipetakan. Untuk data peristiwa mentah yang tidak dipetakan, lihat properti OriginalKey .

KeyStatus

Mendapatkan nilai struktur yang melaporkan berbagai karakteristik tekan tombol yang terdeteksi sistem, termasuk jumlah berulang dan status menu.

OriginalKey

Mendapatkan kunci virtual asli yang tidak dipetakan yang terkait dengan peristiwa tersebut.

Bergantung pada perangkat input, tombol input mungkin dipetakan ke nilai kunci yang berbeda. Untuk nilai peristiwa yang dipetakan, lihat properti Kunci .

OriginalSource

Mendapatkan referensi ke objek yang memunculkan peristiwa. Ini sering merupakan bagian templat dari kontrol daripada elemen yang dideklarasikan di UI aplikasi Anda.

(Diperoleh dari RoutedEventArgs)

Berlaku untuk

Lihat juga