Данная статья переведена с помощью средств машинного перевода. Чтобы просмотреть ее на английском языке, установите флажок Английский. Вы также можете просматривать английский текст во всплывающем окне, наводя указатель мыши на переведенный текст.
Перевод
Английский

Метод Window.ShowDialog ()

 

Опубликовано: Октябрь 2016

Открывает окно и возвращается только после закрытия нового открытого окна.

Пространство имен:   System.Windows
Сборка:  PresentationFramework (в PresentationFramework.dll)

[SecurityCriticalAttribute]
public Nullable<bool> ShowDialog()

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

Type: System.Nullable<Boolean>

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

Exception Condition
InvalidOperationException

ShowDialog вызывается для Window который является видимым

-или-

ShowDialog вызывается в видимое Window был открыт путем вызова ShowDialog.

InvalidOperationException

ShowDialog вызывается в окне, которое закрывает (Closing) или был закрыт (Closed).

Когда Window создается экземпляр класса, она не отображается по умолчанию. ShowDialog показано окно, отключает все остальные окна приложения и возвращает только при закрытии окна. Такой тип окон называется модального окна.

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

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

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

System_CAPS_noteПримечание

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

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

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

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

UIPermission

for permission to activate a window. Associated enumeration: F:System.Security.Permissions.UIPermissionWindow.AllWindows

.NET Framework
Доступно с 3.0
Вернуться в начало
Показ: