Window.ShowDialog Метод

Определение

Открывает окно и возвращается только после его закрытия.Opens a window and returns only when the newly opened window is closed.

public:
 Nullable<bool> ShowDialog();
[System.Security.SecurityCritical]
public Nullable<bool> ShowDialog ();
member this.ShowDialog : unit -> Nullable<bool>
Public Function ShowDialog () As Nullable(Of Boolean)

Возвраты

Значение Nullable<T> типа Boolean, определяющее было действие принято (true) или отменено (false).A Nullable<T> value of type Boolean that specifies whether the activity was accepted (true) or canceled (false). Возвращаемое значение представляет собой значение свойства DialogResult перед закрытием окна.The return value is the value of the DialogResult property before a window closes.

Атрибуты

Исключения

Метод ShowDialog() вызывается для окна, которое закрывается (Closing) или закрыто (Closed).ShowDialog() is called on a window that is closing (Closing) or has been closed (Closed).

Примеры

В следующем примере показано, как открыть модальное окно.The following sample demonstrates how to open a modal window.

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

Комментарии

При создании экземпляра класса он не отображается по умолчанию. WindowWhen a Window class is instantiated, it is not visible by default. ShowDialogпоказывает окно, отключает все остальные окна в приложении и возвращает, только когда окно закрыто.ShowDialog shows the window, disables all other windows in the application, and returns only when the window is closed. Этот тип окна называется модальным окном.This type of window is known as a modal window.

Модальные окна в основном используются в качестве диалоговых окон.Modal windows are primarily used as dialog boxes. Диалоговое окно — это специальный тип окна, с помощью которого приложения взаимодействуют с пользователями для выполнения задач, таких как открытие файлов или печать документов.A dialog box is a special type of window that applications use to interact with users to complete tasks, such as opening files or printing documents. Диалоговые окна обычно позволяют пользователям принимать или отменять задачи, для которых они отображались до закрытия диалогового окна.Dialog boxes commonly allow users to accept or cancel the task for which they were shown before the dialog box is closed. ShowDialogNullable<T> возвращаетзначение,указывающее,былолидействиеBoolean принято или отменено.ShowDialog returns a Nullable<T>Boolean value that specifies whether the activity was accepted or canceled. Возвращаемое значение представляет собой значение свойства DialogResult перед закрытием окна.The return value is the value of the DialogResult property before a window closes. Для получения дополнительной информации см. DialogResult.For more information, see DialogResult.

Окно, которое открывается путем вызова ShowDialog метода, не имеет автоматически связи с окном, которое его открыло; в частности, открытое окно не знает, какое окно открыло его.A window that is opened by calling the ShowDialog method does not automatically have a relationship with the window that opened it; specifically, the opened window does not know which window opened it. Эту связь можно установить с помощью Owner свойства и управлять ими OwnedWindows с помощью свойства.This relationship can be established using the Owner property and managed using the OwnedWindows property. Для поддержки ИПUI автоматизации (см. раздел Общие сведения о модели автоматизации пользовательского интерфейса) для окна, открытого ShowDialogпутем вызова метода, Owner необходимо задать значение.To support ИПUI automation (see UI Automation Overview), Owner must be set for a window opened by calling ShowDialog.

При закрытии WPFWPF модального окна (окна, открытого ShowDialogс помощью вызова) ранее активированное окно активируется повторно.When a modal WPFWPF window (a window opened by calling ShowDialog) is closed, the previously activated window is reactivated. Если модальное WPFWPF окно содержит окно-владелец (см Owner.), окно владельца не активируется повторно, когда модальное WPFWPF окно закрывается, если оно не было ранее активированным окном.If a modal WPFWPF window has an owner window (see Owner), the owner window is not reactivated when the modal WPFWPF window is closed unless it was the previously activated window.

Примечание

Этот метод не может быть вызван, если окно размещается в браузере.This method cannot be called when a window is hosted in a browser.

Безопасность

UIPermission
разрешение на активацию окна.for permission to activate a window. Связанное перечисление:AllWindowsAssociated enumeration: AllWindows

Применяется к

Дополнительно