Экспорт (0) Печать
Развернуть все
Данная статья переведена автоматически. Наведите указатель мыши на предложения статьи, чтобы просмотреть исходный текст. Дополнительные сведения.
Перевод
Текст оригинала

Window.ShowDialog - метод

Открывает окно и возвращает только в том случае, если вновь открытое окно закрыто.

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

public Nullable<bool> ShowDialog()

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

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

ИсключениеУсловие
InvalidOperationException

ShowDialog вызывает on a Window видимым

- или -

ShowDialog вызывает в видимом Window необходимо открытое путем вызова ShowDialog.

InvalidOperationException

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

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

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

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

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

ПримечаниеПримечание

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

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


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

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


.NET Framework

Поддерживается в версиях: 4.5, 4, 3.5, 3.0

.NET Framework (клиентский профиль)

Поддерживается в версиях: 4, 3.5 с пакетом обновления 1 (SP1)

  • UIPermission 

    для разрешения активировать окно. Связанное перечисление: AllWindows

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista с пакетом обновления 2 (SP2), Windows Server 2008 (роль основных серверных компонентов не поддерживается), Windows Server 2008 R2 (роль основных серверных компонентов поддерживается в пакете обновления 1 (SP1) или выше; системы на базе Itanium не поддерживаются)

Среда .NET Framework поддерживает не все версии каждой платформы. Поддерживаемые версии перечислены в разделе Требования к системе для .NET Framework.

Добавления сообщества

ДОБАВИТЬ
Показ:
© 2014 Microsoft