Bagikan melalui


Control.IsFocusEngaged Properti

Definisi

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

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

void IsFocusEngaged(bool value);
public bool IsFocusEngaged { get; set; }
var boolean = control.isFocusEngaged;
control.isFocusEngaged = boolean;
Public Property IsFocusEngaged As Boolean
<control IsFocusEngaged="bool"/>

Nilai Properti

Boolean

bool

true jika fokus 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

IsFocusEngagementEnabled harus benar dan kontrol harus memiliki fokus sebelum Anda mengatur properti IsFocusEngaged ke true. Jika tidak, pengecualian runtime akan terjadi.

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 ini 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 Mendesain untuk Xbox dan TV .

Kompatibilitas versi

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

Berlaku untuk