Window.DialogResult Eigenschaft

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)

Eigenschaftswert

Ein Nullable<T>-Wert vom Typ Boolean. Der Standardwert ist false.

Attribute

TypeConverterAttribute

Ausnahmen

Beispiele

Das folgende Beispiel zeigt, wie sie eine OK-Schaltfläche und eine Schaltfläche Abbrechen konfigurieren, um die entsprechende DialogResultzurückzugeben.

<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

Hinweise

DialogResult kann aus dem Code verwendet werden, der ein Dialogfeld angezeigt hat, um zu bestimmen, ob ein Benutzer das Dialogfeld akzeptiert (true) oder abgebrochen hat (false). Wenn ein Dialogfeld akzeptiert wurde, bedeutet dies den Code, der das Dialogfeld geöffnet hat, um die vom Benutzer gesammelten Daten abzurufen und zu verarbeiten. Wenn ein Dialogfeld abgebrochen wurde, bedeutet dies jedoch, dass aufrufende Code die weitere Verarbeitung beenden sollte.

Standardmäßig wird ein Dialogfeld abgebrochen, wenn ein Benutzer eine der folgenden Aktionen ausführt:

• Drücken SIEALT+F4.

• Klickt auf die Schaltfläche Schließen .

• Wählen Sie im Menü System schließen aus.

In all diesen Fällen DialogResult ist false standardmäßig festgelegt.

Ein Dialogfeld bietet in der Regel eine spezielle Schaltfläche zum Abbrechen eines Dialogfelds. Dies ist die Schaltfläche, deren IsCancel Eigenschaft auf truefestgelegt ist. Eine auf diese Weise konfigurierte Schaltfläche schließt automatisch ein Fenster, wenn es entweder gedrückt oder die ESC-TASTE gedrückt wird. In beiden Fällen DialogResult bleibt false.

Ein Dialogfeld stellt in der Regel auch eine Annahmeschaltfläche bereit. Dies ist die Schaltfläche, deren IsDefault Eigenschaft auf truefestgelegt ist. Eine auf diese Weise konfigurierte Schaltfläche löst ihr Click Ereignis aus, wenn entweder sie oder die EINGABETASTE gedrückt wird. Das Dialogfeld wird jedoch nicht automatisch geschlossen, und es wird auch nicht auf truefestgelegtDialogResult. Sie müssen diesen Code manuell schreiben, normalerweise aus dem Click Ereignishandler für die Standardschaltfläche.

DialogResult ist null , wenn das Dialogfeld angezeigt, aber weder akzeptiert noch abgebrochen wird.

Nachdem ein Dialogfeld geschlossen wurde, können Sie das Dialogfeldergebnis aus dem von ShowDialog der -Methode zurückgegebenen Wert abrufen oder die DialogResult Eigenschaft überprüfen.

DialogResult kann nur festgelegt werden, wenn eine Window durch Aufrufen der - ShowDialog Methode geöffnet wird.

Gilt für: