Window.DialogResult Propriété

public:
 property Nullable<bool> DialogResult { Nullable<bool> get(); void set(Nullable<bool> value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.DialogResultConverter))]
public bool? DialogResult { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.DialogResultConverter))>]
member this.DialogResult : Nullable<bool> with get, set

Public Property DialogResult As Nullable(Of Boolean)

Valeur de propriété

Valeur Nullable<T> de type Boolean. La valeur par défaut est false.

Attributs

TypeConverterAttribute

Exceptions

Exemples

L’exemple suivant montre comment configurer un bouton OK et un bouton Annuler pour retourner le approprié DialogResult.

<Button IsDefault="True" Click="acceptButton_Click">OK (IsDefault=True)</Button>
<Button IsCancel="True">Cancel (IsCancel=True)</Button>

using System;
using System.Windows;
using System.Windows.Controls;

namespace CSharp
{
    public partial class DialogBox : Window
    {
        public DialogBox()
        {
            InitializeComponent();
        }

        // The accept button is a button whose IsDefault property is set to true.
        // This event is raised whenever this button is clicked, or the ENTER key
        // is pressed.
        void acceptButton_Click(object sender, RoutedEventArgs e)
        {
            // Accept the dialog and return the dialog result
            this.DialogResult = true;
        }
    }
}

Imports System.Windows
Imports System.Windows.Controls

Namespace VisualBasic
    Partial Public Class DialogBox
        Inherits Window
        Public Sub New()
            InitializeComponent()
        End Sub

        ' The accept button is a button whose IsDefault property is set to true.
        ' This event is raised whenever this button is clicked, or the ENTER key
        ' is pressed.
        Private Sub acceptButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
            ' Accept the dialog and return the dialog result
            Me.DialogResult = True
        End Sub
    End Class
End Namespace

Remarques

DialogResult peut être utilisé à partir du code qui a affiché une boîte de dialogue pour déterminer si un utilisateur a accepté (true) ou annulé (false) la boîte de dialogue. Si une boîte de dialogue a été acceptée, cela signifie que le code qui a ouvert la boîte de dialogue pour récupérer les données collectées par l’utilisateur et les traiter. Toutefois, si une boîte de dialogue a été annulée, cela signifie que le code appelant doit arrêter tout traitement ultérieur.

Par défaut, une boîte de dialogue est annulée lorsqu’un utilisateur effectue l’une des opérations suivantes :

• Appuyez surALT+F4.

• Clique sur le bouton Fermer .

• Sélectionne Fermer dans le menu Système.

Dans tous ces cas, DialogResult est false par défaut.

Une boîte de dialogue fournit généralement un bouton spécial pour annuler un dialogue, qui est le bouton dont IsCancel la propriété est définie sur true. Un bouton configuré de cette façon ferme automatiquement une fenêtre lorsqu’elle est enfoncée ou lorsque la touche Échap est enfoncée. Dans l’un ou l’autre de ces cas, DialogResult reste false.

Une boîte de dialogue fournit également généralement un bouton d’acceptation, qui est le bouton dont IsDefault la propriété a la valeur true. Un bouton configuré de cette façon déclenche son Click événement lorsque vous appuyez sur la touche Entrée ou lui. Toutefois, il ne ferme pas automatiquement la boîte de dialogue, et n’a pas la truevaleur DialogResult . Vous devez écrire manuellement ce code, généralement à partir du Click gestionnaire d’événements pour le bouton par défaut.

DialogResult est null lorsque la boîte de dialogue s’affiche, mais n’est ni acceptée ni annulée.

Après la fermeture d’une boîte de dialogue, vous pouvez obtenir le résultat de la boîte de dialogue à partir de la valeur retournée par ShowDialog la méthode ou en inspectant la DialogResult propriété .

DialogResult ne peut être défini que lorsqu’un Window est ouvert en appelant sa ShowDialog méthode.

S’applique à