Window.DialogResult Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает результирующее значение диалоговое окна, то есть значение, которое будет возвращено методом 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<T> типа Boolean. Значение по умолчанию — false
.
- Атрибуты
Исключения
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 .
Примечание
Невозможно задать или получить это свойство, если окно размещено в браузере.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по