Control.RemoveFocusEngagement Metode

Definisi

Merilis fokus dari batas kontrol untuk kontrol yang memiliki keterlibatan fokus (untuk pad game/interaksi jarak jauh).

public:
 virtual void RemoveFocusEngagement() = RemoveFocusEngagement;
void RemoveFocusEngagement();
public void RemoveFocusEngagement();
function removeFocusEngagement()
Public Sub RemoveFocusEngagement ()

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. Anda dapat memanggil RemoveFocusEngagement untuk melepaskan kontrol secara terprogram.

Untuk informasi selengkapnya, lihat bagian Keterlibatan fokus dari artikel Mendesain untuk Xbox dan TV .

Kompatibilitas versi

Metode RemoveFocusEngagement 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 panggil metode ini tanpa terlebih dahulu melakukan pemeriksaan runtime. Contoh ini menunjukkan cara menggunakan kelas ApiInformation untuk memeriksa keberadaan metode ini sebelum Anda menggunakannya.

if (ApiInformation.IsMethodPresent("Windows.UI.Xaml.Controls.Control", "RemoveFocusEngagement"))
{
    control1.RemoveFocusEngagement();
}

Berlaku untuk