Control.FocusDisengaged Événement

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Se produit lorsque le focus est libéré des limites de contrôle (pour l’interaction entre la manette de jeu et l’interaction à distance).

// Register
event_token FocusDisengaged(TypedEventHandler<Control, FocusDisengagedEventArgs const&> const& handler) const;

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

// Revoke with event_revoker
Control::FocusDisengaged_revoker FocusDisengaged(auto_revoke_t, TypedEventHandler<Control, FocusDisengagedEventArgs const&> const& handler) const;

public event TypedEventHandler<Control,FocusDisengagedEventArgs> FocusDisengaged;

function onFocusDisengaged(eventArgs) { /* Your code */ }
control.addEventListener("focusdisengaged", onFocusDisengaged);
control.removeEventListener("focusdisengaged", onFocusDisengaged);
- or -
control.onfocusdisengaged = onFocusDisengaged;

Public Custom Event FocusDisengaged As TypedEventHandler(Of Control, FocusDisengagedEventArgs) 

<control FocusDisengaged="eventhandler"/>

Type d'événement

TypedEventHandler<Control,FocusDisengagedEventArgs>

Configuration requise pour Windows

Famille d’appareils	Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v3.0)

Remarques

Pour les données d’événement, consultez FocusDisengagedEventArgs.

L’engagement du focus facilite l’utilisation d’une manette de jeu ou d’une télécommande pour interagir avec une application. La définition de l’engagement du focus n’affecte pas le clavier ou d’autres périphériques d’entrée.

Lorsque la propriété IsFocusEngagementEnabled a la valeur true, elle marque le contrôle comme nécessitant l’engagement du focus. Cela signifie que l’utilisateur doit appuyer sur le bouton A/Sélectionner pour activer le contrôle et interagir avec ce dernier. Lorsqu’ils ont terminé, ils peuvent appuyer sur le bouton B/Précédent pour désengager le contrôle et s’en éloigner.

Pour plus d’informations, consultez la section Engagement focus de l’article Conception pour Xbox et TV .

Compatibilité des versions

L’événement FocusDisengaged n’est pas disponible avant Windows 10 version 1607. Si le paramètre « version de plateforme minimale » de votre application dans Microsoft Visual Studio est inférieur à la « version introduite » indiquée dans le bloc Configuration requise plus loin dans cette page, vous devez concevoir et tester votre application pour tenir compte de cela. Pour plus d’informations, consultez Code adaptatif de version.

Pour éviter les exceptions lorsque votre application s’exécute sur des versions antérieures de Windows 10, ne connectez pas cet événement sans avoir d’abord effectué une case activée d’exécution. Cet exemple montre comment utiliser la classe ApiInformation pour case activée la présence de cet événement avant de l’utiliser.

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

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