ContentDialog.DefaultButton Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Obtient ou définit une valeur qui indique quel bouton de la boîte de dialogue est l’action par défaut.

public:
 property ContentDialogButton DefaultButton { ContentDialogButton get(); void set(ContentDialogButton value); };

ContentDialogButton DefaultButton();

void DefaultButton(ContentDialogButton value);

public ContentDialogButton DefaultButton { get; set; }

var contentDialogButton = contentDialog.defaultButton;
contentDialog.defaultButton = contentDialogButton;

Public Property DefaultButton As ContentDialogButton

Valeur de propriété

ContentDialogButton

Valeur de l’énumération. La valeur par défaut est None.

Configuration requise pour Windows

Famille d’appareils	Windows 10 Creators Update (introduit dans 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v4.0)

Remarques

Vous pouvez éventuellement choisir de différencier l’un des trois boutons comme bouton par défaut. La spécification d’un bouton par défaut déclenche les événements suivants :

• Le bouton reçoit le traitement visuel du bouton d’accent
• Le bouton répond automatiquement à la touche ENTRÉE
  • Lorsque l’utilisateur appuie sur la touche ENTRÉE du clavier, le gestionnaire de clic associé au bouton par défaut se déclenche et contentDialogResult retourne la valeur associée au bouton par défaut.
  • Si l’utilisateur a placé le focus sur un contrôle qui gère entrée, le bouton par défaut ne répond pas aux pressions entrée
• Le bouton reçoit automatiquement le focus lorsque le dialogue est ouvert, sauf si le contenu du dialogue contient une interface utilisateur pouvant être mise au point

Compatibilité des versions

La propriété DefaultButton n’est pas disponible avant Windows 10, version 1703. 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 définissez pas cette propriété en XAML ou ne l’utilisez pas sans effectuer de case activée d’exécution. Cet exemple montre comment utiliser la classe ApiInformation pour case activée la présence de cette propriété avant de la définir.

<ContentDialog x:Name="contentDialog1" Loaded="ContentDialog_Loaded">
    ...
</ContentDialog>

private void ContentDialog_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.ContentDialog", "DefaultButton"))
    {
        contentDialog1.DefaultButton = ContentDialogButton.Primary;
    }
}