Control.RequiresPointer Properti

Definisi

Ruang nama:

Windows.UI.Xaml.Controls

Mendapatkan atau mengatur apakah elemen UI mendukung mode mouse, yang meniru pengalaman interaksi pointer dengan perangkat input non-pointer seperti game pad atau remote control.

public:
 property RequiresPointer RequiresPointer { RequiresPointer get(); void set(RequiresPointer value); };

RequiresPointer RequiresPointer();

void RequiresPointer(RequiresPointer value);

public RequiresPointer RequiresPointer { get; set; }

var requiresPointer = control.requiresPointer;
control.requiresPointer = requiresPointer;

Public Property RequiresPointer As RequiresPointer

<control RequiresPointer="requiresPointerMemberName"/>

Nilai Properti

RequiresPointer

Mode emulasi pointer. Defaultnya adalah Tidak Pernah.

Persyaratan Windows

Rangkaian perangkat	Windows 10 Anniversary Edition (diperkenalkan dalam 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v3.0)

Keterangan

Untuk perangkat input non-pointer, fokus dipindahkan di antara kontrol melalui berbagai metode, seperti tombol Tab dan panah pada keyboard, tombol arah (D-pad) pada remote, atau tongkat jempol pada pengontrol game. Untuk beberapa pengalaman pengguna, seperti peta dan permukaan gambar, tidak mungkin atau praktis untuk menggunakan navigasi fokus XY. RequiresPointer memungkinkan aplikasi untuk memberikan pengalaman interaksi yang lebih seperti pointer melalui kursor yang dapat dipindahkan secara bebas menggunakan perangkat input game.

RequiresPointer hanya didukung pada keluarga perangkat Xbox, dan hanya saat menggunakan pad game atau remote control. Properti diabaikan sebaliknya.

RequiresPointerMode mengatur mode mouse di tingkat aplikasi.

Untuk informasi selengkapnya, lihat bagian Mode mouse dari Merancang untuk Xbox dan TV.

Kompatibilitas versi

Properti RequiresPointer tidak tersedia sebelum Windows 10, versi 1607. Jika pengaturan 'versi platform minimum' aplikasi Anda di Microsoft Visual Studio kurang dari 'versi yang diperkenalkan' yang ditunjukkan di blok Persyaratan nanti di halaman ini, Anda harus merancang dan menguji aplikasi Anda untuk mempertanyakan hal ini. Untuk informasi selengkapnya, lihat Kode adaptif versi.

Untuk menghindari pengecualian saat aplikasi Anda berjalan pada versi Windows 10 sebelumnya, jangan atur properti ini di XAML atau gunakan tanpa melakukan pemeriksaan runtime. Contoh ini menunjukkan cara menggunakan kelas ApiInformation untuk memeriksa keberadaan properti ini sebelum Anda mengaturnya.

if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Control", "RequiresPointer"))
{
    mapControl1.RequiresPointer = RequiresPointer.WhenEngaged;
}

Lihat juga

• RequiresPointerMode