Control.FocusEngaged Evento

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

Si verifica quando lo stato attivo è vincolato all'interno dei limiti di controllo (per l'interazione remota o il pad del gioco).

// 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"/>

Tipo evento

TypedEventHandler<Control,FocusEngagedEventArgs>

Requisiti Windows

Famiglia di dispositivi	Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)

Commenti

Per i dati degli eventi, vedere FocusEngagedEventArgs.

L'attivazione dello stato attivo semplifica l'uso di un game pad o di un telecomando per interagire con un'app. L'impostazione dell'attivazione dello stato attivo non influisce sulla tastiera o su altri dispositivi di input.

Quando la proprietà IsFocusEngagementEnabled è impostata su true, contrassegna il controllo come che richiede l'attivazione dello stato attivo. L'utente deve pertanto premere il pulsante A/Seleziona per "attivare" il controllo e interagire con esso. Al termine, possono premere il pulsante B/Indietro per allontanare il controllo e allontanarlo.

Per altre info su questa proprietà, vedi la sezione Attivazione dello stato attivo dell'articolo Progettazione per Xbox e TV .

Compatibilità tra versioni

L'evento FocusEngaged non è disponibile prima di Windows 10 versione 1607. Se l'impostazione "versione minima della piattaforma" dell'app in Microsoft Visual Studio è inferiore alla "versione introdotta" visualizzata nel blocco Requisiti più avanti in questa pagina, è necessario progettare e testare l'app per tenere conto di questo aspetto. Per altre info, vedi Codice adattivo per la versione.

Per evitare eccezioni quando l'app viene eseguita nelle versioni precedenti di Windows 10, non connettere questo evento senza prima eseguire un controllo di runtime. Questo esempio mostra come usare la classe ApiInformation per verificare la presenza di questo evento prima di usarlo.

<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;
    }
}