Control.FocusEngaged Kejadian

Definisi

Ruang nama:

Windows.UI.Xaml.Controls

Terjadi ketika fokus dibatasi dalam batas kontrol (untuk pad permainan/interaksi jarak jauh).

// Register
event_token FocusEngaged(TypedEventHandler<Control, FocusEngagedEventArgs const&> const& handler) const;

// Revoke with event_token
void FocusEngaged(event_token const* cookie) const;

// Revoke with event_revoker
Control::FocusEngaged_revoker FocusEngaged(auto_revoke_t, TypedEventHandler<Control, FocusEngagedEventArgs const&> const& handler) const;

public event TypedEventHandler<Control,FocusEngagedEventArgs> FocusEngaged;

function onFocusEngaged(eventArgs) { /* Your code */ }
control.addEventListener("focusengaged", onFocusEngaged);
control.removeEventListener("focusengaged", onFocusEngaged);
- or -
control.onfocusengaged = onFocusEngaged;

Public Custom Event FocusEngaged As TypedEventHandler(Of Control, FocusEngagedEventArgs) 

<control FocusEngaged="eventhandler"/>

Jenis Acara

TypedEventHandler<Control,FocusEngagedEventArgs>

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 data peristiwa, lihat FocusEngagedEventArgs.

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

Peristiwa FocusEngaged 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 sambungkan peristiwa ini tanpa terlebih dahulu melakukan pemeriksaan runtime. Contoh ini menunjukkan cara menggunakan kelas ApiInformation untuk memeriksa keberadaan peristiwa ini sebelum Anda menggunakannya.

<Slider x:Name="slider1" Loaded="Slider_Loaded"/>

private void Slider_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsEventPresent("Windows.UI.Xaml.Controls.Control", "FocusEngaged"))
    {
        slider1.FocusEngaged += Slider1_FocusEngaged;
    }
}