Window.DialogResult Window.DialogResult Window.DialogResult Window.DialogResult Property

Определение

Возвращает или задает результирующее значение диалоговое окна, то есть значение, которое будет возвращено методом ShowDialog().Gets or sets the dialog result value, which is the value that is returned from the ShowDialog() method.

public:
 property Nullable<bool> DialogResult { Nullable<bool> get(); void set(Nullable<bool> value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.DialogResultConverter))]
public Nullable<bool> DialogResult { get; set; }
member this.DialogResult : Nullable<bool> with get, set
Public Property DialogResult As Nullable(Of Boolean)

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

Значение Nullable<T> типа Boolean.A Nullable<T> value of type Boolean. Значение по умолчанию — false.The default is false.

Исключения

DialogResult задан, до того как окно открывается путем вызова ShowDialog().DialogResult is set before a window is opened by calling ShowDialog().

- или --or- DialogResult задан для окна, которое открывается путем вызова Show().DialogResult is set on a window that is opened by calling Show().

Примеры

В следующем примере показано, как настроить кнопку ОК и кнопку Отмена для возврата соответствующего DialogResultзначения.The following example shows how to configure an OK button and a Cancel button to return the appropriate 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() это диалоговое окно.DialogResult can be used from the code that showed a dialog box to determine whether a user accepted (true) or canceled (false) the dialog box. Если диалоговое окно было принято, это означает код, который открыл диалоговое окно для получения данных, собранных пользователем, и его обработки.If a dialog box was accepted, this signifies to the code that opened the dialog box to retrieve the data that was collected by the user and process it. Однако если диалоговое окно было отменено, это означает, что вызывающий код должен закончить дальнейшую обработку.If a dialog box was canceled, however, this signifies that calling code should stop any further processing.

По умолчанию диалоговое окно отменяется, когда пользователь выполняет одно из следующих действий:By default, a dialog box is canceled when a user does one of the following:

  • Прессесалт + F4.PressesALT+F4.

  • Нажатие кнопки Закрыть .Clicks the Close button.

  • Выбирает пункт Закрыть в системном меню.Selects Close from the System menu.

Во всех этих случаях DialogResult по умолчанию имеет значение. falseIn all of these cases, DialogResult is false by default.

Диалоговое окно обычно предоставляет специальную кнопку для отмены диалогового окна, которое является кнопкой, IsCancel свойство которой имеет trueзначение.A dialog box typically provides a special button to cancel a dialog, which is the button whose IsCancel property is set to true. Кнопка, настроенная таким образом, автоматически закрывает окно при нажатии или при нажатии клавиши ESC.A button configured this way will automatically close a window when either it is pressed, or when the ESC key is pressed. В любом из этих случаев DialogResult остается. falseIn either of these cases, DialogResult remains false.

Диалоговое окно также обычно содержит кнопку принять, которая является кнопкой, свойство которой IsDefault имеет trueзначение.A dialog box also typically provides an accept button, which is the button whose IsDefault property is set to true. Кнопка, настроенная таким образом, вызывает Click событие при нажатии клавиши ВВОД.A button configured this way will raise its Click event when either it or the ENTER key is pressed. Однако он не закроет диалоговое окно автоматически и не будет иметь значение DialogResult. trueHowever, it won't automatically close the dialog box, nor will it set DialogResult to true. Необходимо вручную написать этот код, обычно из Click обработчика событий для кнопки по умолчанию.You need to manually write this code, usually from the Click event handler for the default button.

DialogResultимеет null значение, если диалоговое окно отображается, но ни одно из них не принято или отменено.DialogResult is null when the dialog box is shown but neither accepted nor canceled.

После закрытия диалогового окна можно получить результат диалогового окна из значения, возвращаемого ShowDialog методом, или путем проверки DialogResult свойства.After a dialog box closes, you can get the dialog result from the value returned by ShowDialog method, or by inspecting the DialogResult property.

DialogResultможет быть задан только при Window открытии с помощью вызова его ShowDialog метода.DialogResult can only be set when a Window is opened by calling its ShowDialog method.

Примечание

Невозможно задать или получить это свойство, если окно размещается в браузере.You cannot set or get this property when a window is hosted in a browser.

Применяется к