Window.DialogResult Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Dient zum Abrufen oder Festlegen des Dialogergebniswerts, bei dem es sich um den Wert handelt, der von der ShowDialog()-Methode zurückgegeben wird.

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

Nullable<Boolean>

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

Attribute

TypeConverterAttribute

Ausnahmen

InvalidOperationException

DialogResult wird festgelegt, bevor ein Fenster geöffnet wird, indem ShowDialog()aufgerufen wird.

-oder-

DialogResult wird für ein Fenster festgelegt, das durch Aufrufen von Show()geöffnet wird.

Beispiele

Das folgende Beispiel zeigt, wie Sie eine SCHALTFLÄCHE "OK" 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, in dem ein Dialogfeld angezeigt wurde, um zu bestimmen, ob ein Benutzer das Dialogfeld akzeptiert (true) oder abgebrochen (false) hat. 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 der aufrufende Code die weitere Verarbeitung beenden sollte.

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

• Drücken Sie ALT+F4.

• Klickt auf die Schaltfläche schließen.

• Wählt im Menü "System" " schließen" aus.

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

Ein Dialogfeld bietet in der Regel eine spezielle Schaltfläche zum Abbrechen eines Dialogfelds, bei dem es sich um die Schaltfläche handelt, deren IsCancel-Eigenschaft auf truefestgelegt ist. Eine auf diese Weise konfigurierte Schaltfläche schließt automatisch ein Fenster, wenn es gedrückt wird, oder wenn die ESC-Taste gedrückt wird. In einem dieser Fälle bleibt DialogResultfalse.

Ein Dialogfeld enthält in der Regel auch eine Schaltfläche "Annehmen", die die Schaltfläche ist, deren IsDefault Eigenschaft auf truefestgelegt ist. Eine auf diese Weise konfigurierte Schaltfläche löst das Click-Ereignis aus, wenn sie oder die EINGABETASTE gedrückt wird. Das Dialogfeld wird jedoch nicht automatisch geschlossen, und es wird DialogResult auf truefestgelegt. Sie müssen diesen Code manuell schreiben, in der Regel aus dem Click-Ereignishandler für die Standardschaltfläche.

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

Nach dem Schließen eines Dialogfelds können Sie das Dialogfeldergebnis aus dem von ShowDialog Methode zurückgegebenen Wert abrufen oder die eigenschaft DialogResult prüfen.

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

Anmerkung

Sie können diese Eigenschaft nicht festlegen oder abrufen, wenn ein Fenster in einem Browser gehostet wird.