Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Window.ShowDialog ()

 

Publicado: octubre de 2016

Abre una ventana y devuelve solo cuando se cierra la ventana recién abierta.

Espacio de nombres:   System.Windows
Ensamblado:  PresentationFramework (en PresentationFramework.dll)

[SecurityCriticalAttribute]
public Nullable<bool> ShowDialog()

Valor devuelto

Type: System.Nullable<Boolean>

Un Nullable<T> valor de tipo Boolean que especifica si se aceptó la actividad (true) o cancelado (false). El valor devuelto es el valor de la DialogResult propiedad antes de cerrarse una ventana.

Exception Condition
InvalidOperationException

ShowDialog se llama en un Window que está visible

-o-

ShowDialog se llama en un visible Window que se abrió llamando a ShowDialog.

InvalidOperationException

ShowDialog se llama en una ventana que se está cerrando (Closing) o se ha cerrado (Closed).

Cuando un Window se crea una instancia de clase, no es visible de forma predeterminada. ShowDialog Muestra la ventana, deshabilita todas las demás ventanas de la aplicación y devuelve solo cuando se cierra la ventana. Este tipo de ventana se conoce como un modal ventana.

Ventanas modales se utilizan principalmente como cuadros de diálogo. Un cuadro de diálogo es un tipo especial de ventana que las aplicaciones utilizan para interactuar con los usuarios para realizar tareas, como abrir archivos o imprimir documentos. Cuadros de diálogo normalmente permiten a los usuarios Aceptar o cancelar la tarea para la que se mostraron antes de cerrar el cuadro de diálogo. ShowDialog Devuelve un Nullable<T>Boolean valor que especifica si se aceptan o se canceló la actividad. El valor devuelto es el valor de la DialogResult propiedad antes de cerrarse una ventana. Para obtener más información, consulta DialogResult.

Una ventana que se abre llamando el ShowDialog método no tiene automáticamente una relación con la ventana que la abrió; en concreto, la ventana abierta no sabe qué ventana la abrió. Esta relación se puede establecer usando el Owner propiedad y administrado usando el OwnedWindows propiedad. Para admitir IU automatización (consulte UI Automation Overview), Owner se debe establecer para una ventana abierta mediante una llamada a ShowDialog.

Cuando un estado modal WPF ventana (una ventana se abre llamando a ShowDialog) está cerrada, previamente activado se reactiva la ventana. Si un modal WPF ventana tiene una ventana propietaria (vea Owner), la ventana propietaria no es vuelve a activar cuando modal WPF se cierra la ventana a menos que sea la ventana previamente activada.

System_CAPS_noteNota

No se puede llamar a este método cuando una ventana está hospedada en un explorador.

En el ejemplo siguiente se muestra cómo abrir una ventana modal.

// 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
Disponible desde 3.0
Volver al principio
Mostrar: