Window.ShowDialog 메서드

정의

네임스페이스:

System.Windows

어셈블리:

PresentationFramework.dll

창을 연 후 새로 열린 창이 닫힌 경우에만 반환됩니다.

public:
 Nullable<bool> ShowDialog();

public bool? ShowDialog ();

member this.ShowDialog : unit -> Nullable<bool>

Public Function ShowDialog () As Nullable(Of Boolean)

반환

Nullable<Boolean>

작업이 받아들여졌는지(true 또는 취소되었는지(false) 여부를 지정하는 Nullable<T> 유형의 Boolean 값입니다. 반환 값은 창이 닫히기 전의 DialogResult 속성 값입니다.

예외

InvalidOperationException

닫히고 있는 창(ShowDialog()) 또는 닫힌 창(Closing)에서 Closed가 호출된 경우

예제

다음 샘플에서는 모달 창을 여는 방법을 보여 줍니다.

// Instantiate window
DialogBox dialogBox = new DialogBox();

// Show window modally
// NOTE: Returns only when window is closed
Nullable<bool> dialogResult = dialogBox.ShowDialog();

' Instantiate window
Dim dialogBox As New DialogBox()

' Show window modally
' NOTE: Returns only when window is closed
Dim dialogResult? As Boolean = dialogBox.ShowDialog()

설명

클래스가 Window 인스턴스화되면 기본적으로 표시되지 않습니다. ShowDialog 창을 보여 줍니다, 그리고 애플리케이션에서 다른 모든 windows를 사용 하지 않도록 설정 하 고 창이 닫혀 있는 경우에를 반환 합니다. 이 유형의 창을 모달 창이라고 합니다.

모달 창은 주로 대화 상자로 사용됩니다. 대화 상자는 특수 한 유형의 애플리케이션 파일을 열거나 문서 인쇄와 같은 작업을 완료 하는 사용자와 상호 작용 하는 데 사용할 수 있는 창입니다. 대화 상자는 일반적으로 사용자가 대화 상자를 닫기 전에 표시된 작업을 수락하거나 취소할 수 있도록 허용합니다. ShowDialog 는 Nullable<T>Boolean 작업이 수락되었는지 취소되었는지 여부를 지정하는 값을 반환합니다. 반환 값은 창이 닫히기 전의 DialogResult 속성 값입니다. 자세한 내용은 DialogResult를 참조하세요.

메서드를 호출 ShowDialog 하여 연 창은 해당 창을 연 창과 자동으로 관계가 없습니다. 특히 열린 창은 해당 창을 연 창을 알 수 없습니다. 이 관계는 속성을 사용하여 Owner 설정하고 속성을 사용하여 OwnedWindows 관리할 수 있습니다. UI 자동화를 지원하려면( UI 자동화 개요 참조) Owner 을 호출 ShowDialog하여 열린 창에 대해 설정해야 합니다.

모달 WPF 창(를 호출 ShowDialog하여 열린 창)이 닫혀 있으면 이전에 활성화된 창이 다시 활성화됩니다. 모달 WPF 창에 소유자 창(참조 Owner)이 있는 경우 이전에 활성화된 창이 아니면 모달 WPF 창이 닫혀 있을 때 소유자 창이 다시 활성화되지 않습니다.

참고

창이 브라우저에서 호스트되는 경우 이 메서드를 호출할 수 없습니다.

추가 정보

• Close()
• WindowState