Window.ShowDialog Метод

public:
 Nullable<bool> ShowDialog();

[System.Security.SecurityCritical]
public bool? ShowDialog();

public bool? ShowDialog();

[<System.Security.SecurityCritical>]
member this.ShowDialog : unit -> Nullable<bool>

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

Public Function ShowDialog () As Nullable(Of Boolean)

Возвращаемое значение

Nullable<T> Значение типаBoolean, указывающее, было ли действие принято (true) или отменено (false). Возвращаемое значение — DialogResult это значение свойства до закрытия окна.

Атрибуты

SecurityCriticalAttribute

Исключения

Примеры

В следующем примере показано, как открыть модальное окно.

// 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