Window.DialogResult Eigenschap

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)

Waarde van eigenschap

Een Nullable<T> waarde van het type Boolean. De standaardwaarde is false.

Kenmerken

TypeConverterAttribute

Uitzonderingen

Voorbeelden

In het volgende voorbeeld ziet u hoe u een KNOP OK en een knop Annuleren configureert om de juiste DialogResultknop te retourneren.

<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

Opmerkingen

DialogResult kan worden gebruikt vanuit de code die een dialoogvenster heeft weergegeven om te bepalen of een gebruiker het dialoogvenster heeft geaccepteerd (true) of geannuleerd (false). Als een dialoogvenster is geaccepteerd, wordt hiermee de code aangegeven waarmee het dialoogvenster is geopend om de gegevens op te halen die door de gebruiker zijn verzameld en verwerkt. Als een dialoogvenster is geannuleerd, betekent dit echter dat het aanroepen van code verdere verwerking moet stoppen.

Standaard wordt een dialoogvenster geannuleerd wanneer een gebruiker een van de volgende handelingen doet:

• Druk op Alt+F4.

• Klik op de knop Sluiten .

• Selecteert Sluiten in het menu Systeem.

In al deze gevallen DialogResult is false dit standaard.

Een dialoogvenster bevat doorgaans een speciale knop om een dialoogvenster te annuleren. Dit is de knop waarvan IsCancel de eigenschap is ingesteld trueop. Een knop die op deze manier is geconfigureerd, sluit automatisch een venster wanneer deze wordt ingedrukt of wanneer de ESC-toets wordt ingedrukt. In beide gevallen DialogResult blijft falsehet .

Een dialoogvenster bevat meestal ook een knop Accepteren, de knop waarvan IsDefault de eigenschap is ingesteld op true. Een knop die op deze manier is geconfigureerd, genereert de Click gebeurtenis wanneer deze of de ENTER-toets wordt ingedrukt. Het dialoogvenster wordt echter niet automatisch gesloten en wordt ook niet ingesteld op DialogResulttrue. U moet deze code handmatig schrijven, meestal vanuit de Click gebeurtenishandler voor de standaardknop.

DialogResult is null wanneer het dialoogvenster wordt weergegeven, maar niet geaccepteerd of geannuleerd.

Nadat een dialoogvenster is gesloten, kunt u het resultaat van het dialoogvenster ophalen uit de waarde die wordt geretourneerd door ShowDialog de methode of door de DialogResult eigenschap te inspecteren.

DialogResult kan alleen worden ingesteld wanneer een wordt Window geopend door de methode aan ShowDialog te roepen.