Control.IsFocusEngagementEnabled Properti

Definisi

Ruang nama:

Windows.UI.Xaml.Controls

Mendapatkan atau menetapkan nilai yang menunjukkan apakah fokus dapat dibatasi dalam batas kontrol (untuk pad permainan/interaksi jarak jauh).

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

bool IsFocusEngagementEnabled();

void IsFocusEngagementEnabled(bool value);

public bool IsFocusEngagementEnabled { get; set; }

var boolean = control.isFocusEngagementEnabled;
control.isFocusEngagementEnabled = boolean;

Public Property IsFocusEngagementEnabled As Boolean

<control IsFocusEngagementEnabled="bool"/>

Nilai Properti

Boolean

bool

true jika fokus dapat dibatasi dalam batas kontrol; jika tidak, salah.

Persyaratan Windows

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

Keterangan

Keterlibatan fokus memudahkan penggunaan pad game atau remote control untuk berinteraksi dengan aplikasi. Pengaturan keterlibatan fokus tidak memengaruhi keyboard atau perangkat input lainnya.

Ketika properti IsFocusEngagementEnabled diatur ke true, properti menandai kontrol sebagai memerlukan keterlibatan fokus. Ini berarti bahwa pengguna harus menekan tombol A/Pilih untuk "melibatkan" kontrol dan berinteraksi dengannya. Setelah selesai, mereka dapat menekan tombol B/Back untuk melepaskan kontrol dan menavigasi menjauh darinya.

Untuk informasi selengkapnya tentang properti ini, lihat bagian Keterlibatan fokus dari artikel Merancang untuk Xbox dan TV .

Kompatibilitas versi

Properti IsFocusEngagementEnabled 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", "IsFocusEngagementEnabled"))
{
    slider1.IsFocusEngagementEnabled = true;
}