Window.DialogResult 속성

정의

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 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 값입니다.A Nullable<T> value of type Boolean. 기본값은 false입니다.The default is false.

특성

예외

DialogResultShowDialog()를 호출하여 창이 열리기 전에 설정됩니다.DialogResult is set before a window is opened by calling ShowDialog().

또는-or- DialogResultShow()를 호출하여 창이 열릴 때 설정됩니다.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:

  • PressesALT + F4.PressesALT+F4.

  • 닫기 단추를 클릭 합니다.Clicks the Close button.

  • 시스템 메뉴에서 닫기 를 선택 합니다.Selects Close from the System menu.

이러한 모든 경우에 DialogResultfalse 기본적으로입니다.In 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 유지 됩니다 false .In 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 하거나 ENTER 키를 누를 때 이벤트를 발생 시킵니다.A button configured this way will raise its Click event when either it or the ENTER key is pressed. 그러나 대화 상자를 자동으로 닫지 않으며로 설정 하지도 않습니다 DialogResult true .However, 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.

DialogResultnull대화 상자가 표시 되었지만 승인 되거나 취소 되지 않은 경우입니다.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.

적용 대상