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>

Значение Nullable<T> типа Boolean, определяющее было действие принято (true) или отменено (false). Возвращаемое значение представляет собой значение свойства 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 отображает окно, отключает все остальные окна в приложении и возвращает значение только при закрытии окна. Этот тип окна называется модальным окном .

Модальные окна в основном используются в качестве диалоговых окон. Диалоговое окно — это особый тип окна, который приложения используют для взаимодействия с пользователями для выполнения задач, таких как открытие файлов или печать документов. Диалоговые окна обычно позволяют пользователям принимать или отменять задачу, для которой они были показаны до закрытия диалогового окна. ShowDialog Nullable<T> Boolean возвращает значение, указывающее, было ли действие принято или отменено. Возвращаемое значение представляет собой значение свойства DialogResult перед закрытием окна. Для получения дополнительной информации см. DialogResult.

Окно, которое открывается путем вызова ShowDialog метода , не имеет связи с окном, которое его открыло. В частности, открытое окно не знает, какое окно его открыло. Эту связь можно установить с помощью Owner свойства и управлять с помощью OwnedWindows свойства . Для поддержки автоматизации пользовательского интерфейса (см. обзор автоматизации пользовательского интерфейса) Owner необходимо задать для окна, открытого путем вызова ShowDialog.

При закрытии модального окна WPF (открытого путем вызова ShowDialog) ранее активированное окно повторно активируется. Если модальное окно WPF имеет окно владельца (см. Owner), окно владельца не активируется повторно при закрытии модального окна WPF, если оно не было ранее активированным окном.

Примечание

Этот метод не может вызываться, если окно размещено в браузере.

См. также раздел

• Close()
• WindowState