Window.DialogResult Właściwość

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Pobiera lub ustawia wartość wyniku okna dialogowego, czyli wartość zwracaną z ShowDialog() metody .

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)

Wartość właściwości

Nullable<Boolean>

Nullable<T> Wartość typu Boolean. Wartość domyślna to false.

Atrybuty

TypeConverterAttribute

Wyjątki

InvalidOperationException

DialogResult jest ustawiana przed otwarciem okna przez wywołanie polecenia ShowDialog().

-lub-

DialogResult jest ustawiana w oknie otwartym przez wywołanie polecenia Show().

Przykłady

W poniższym przykładzie pokazano, jak skonfigurować przycisk OK i przycisk Anuluj, aby zwrócić odpowiedni DialogResultelement .

<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

Uwagi

DialogResult można użyć z kodu, który pokazał okno dialogowe, aby określić, czy użytkownik zaakceptował (true) lub anulował (false) okno dialogowe. Jeśli zaakceptowano okno dialogowe, oznacza to kod, który otworzył okno dialogowe, aby pobrać dane zebrane przez użytkownika i przetworzyć je. Jeśli jednak anulowano okno dialogowe, oznacza to, że wywoływanie kodu powinno zatrzymać dalsze przetwarzanie.

Domyślnie okno dialogowe jest anulowane, gdy użytkownik wykonuje jedną z następujących czynności:

• Naciśnij klawiszeALT+F4.

• Klika przycisk Zamknij .

• Wybiera pozycję Zamknij z menu System.

We wszystkich tych przypadkach DialogResult jest false domyślnie.

Okno dialogowe zazwyczaj udostępnia specjalny przycisk do anulowania okna dialogowego, który jest przyciskiem, którego IsCancel właściwość jest ustawiona na true. Przycisk skonfigurowany w ten sposób spowoduje automatyczne zamknięcie okna po naciśnięciu klawisza ESC lub naciśnięciu klawisza ESC. W jednym z tych przypadków DialogResult pozostaje wartość false.

Okno dialogowe zazwyczaj udostępnia również przycisk akceptowania, który jest przyciskiem, którego IsDefault właściwość jest ustawiona na true. Przycisk skonfigurowany w ten sposób spowoduje podniesienie jego Click zdarzenia po naciśnięciu klawisza ENTER lub klawisza ENTER. Nie spowoduje to jednak automatycznego zamknięcia okna dialogowego ani ustawienia wartości DialogResulttrue. Musisz ręcznie napisać ten kod, zwykle z Click programu obsługi zdarzeń dla przycisku domyślnego.

DialogResult jest null wtedy, gdy zostanie wyświetlone okno dialogowe, ale nie zostanie zaakceptowane ani anulowane.

Po zamknięciu okna dialogowego można uzyskać wynik okna dialogowego z wartości zwróconej przez ShowDialog metodę lub sprawdzając DialogResult właściwość.

DialogResult można ustawić tylko wtedy, gdy Window element jest otwarty, wywołując jego ShowDialog metodę.

Uwaga

Nie można ustawić ani pobrać tej właściwości, gdy okno jest hostowane w przeglądarce.