Window.DialogResult Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Ergebniswert des Dialogfelds ab, d. h. den von der ShowDialog()-Methode zurückgegebenen Wert, oder legt diesen fest.
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
Ausnahmen
DialogResult wird festgelegt, bevor ein Fenster durch Aufrufen von ShowDialog() geöffnet wird.
- oder -
DialogResult wird in einem Fenster festgelegt, das durch Aufrufen von Show() geöffnet wird.
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 true
festgelegt 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 true
festgelegt 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 true
festgelegtDialogResult. 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.
Hinweis
Sie können diese Eigenschaft nicht festlegen oder abrufen, wenn ein Fenster in einem Browser gehostet wird.
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für