Window.DialogResult Свойство

Определение

Пространство имен:

System.Windows

Сборка:

PresentationFramework.dll

Возвращает или задает результирующее значение диалоговое окна, то есть значение, которое будет возвращено методом ShowDialog().

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)

Значение свойства

Nullable<Boolean>

Значение Nullable<T> типа Boolean. Значение по умолчанию — false.

Атрибуты

TypeConverterAttribute

Исключения

InvalidOperationException

DialogResult задан, до того как окно открывается путем вызова ShowDialog().

-или-

DialogResult задан для окна, которое открывается путем вызова Show().

Примеры

В следующем примере показано, как настроить кнопки ОК и Отмена для возврата соответствующих DialogResult.

<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

Комментарии

DialogResult можно использовать из кода, отображающего диалоговое окно, чтобы определить, принял ли пользователь (true) или отменил (false) диалоговое окно. Если диалоговое окно было принято, это означает код, открывший диалоговое окно для получения данных, собранных пользователем, и их обработки. Однако если диалоговое окно было отменено, это означает, что вызывающий код должен прекратить дальнейшую обработку.

По умолчанию диалоговое окно отменяется, когда пользователь выполняет одно из следующих действий:

• Нажмите клавишиALT+F4.

• Нажимает кнопку Закрыть .

• В меню Система выбирает Закрыть .

Во всех этих случаях DialogResult имеет значение false по умолчанию.

Диалоговое окно обычно предоставляет специальную кнопку для отмены диалога. Это кнопка, свойство которой IsCancel имеет значение true. Кнопка, настроенная таким образом, автоматически закрывает окно при нажатии или при нажатии клавиши ESC. В любом из этих случаев DialogResult остается false.

Диалоговое окно также обычно предоставляет кнопку принятия, которая представляет собой кнопку, свойство которой IsDefault имеет значение true. Кнопка, настроенная таким образом, вызывает событие Click при нажатии клавиши ВВОД или ее. Однако диалоговое окно не закроется автоматически и не будет задано значение DialogResulttrue. Этот код необходимо написать вручную, обычно из обработчика Click событий для кнопки по умолчанию.

DialogResult — это null , когда диалоговое окно отображается, но не принимается и не отменено.

После закрытия диалогового окна можно получить результат диалога из значения, возвращаемого методом ShowDialog , или путем проверки DialogResult свойства .

DialogResult может быть задано Window только при открытии путем вызова метода ShowDialog .

Примечание

Невозможно задать или получить это свойство, если окно размещено в браузере.