Window.ShowDialog Método

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

Abre una ventana y devuelve un valor sólo cuando se cierra la ventana que acaba de abrirse.

public:
 Nullable<bool> ShowDialog();

public bool? ShowDialog ();

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

Public Function ShowDialog () As Nullable(Of Boolean)

Devoluciones

Nullable<Boolean>

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

Excepciones

InvalidOperationException

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

Ejemplos

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

' Instantiate window
Dim dialogBox As New DialogBox()

' Show window modally
' NOTE: Returns only when window is closed
Dim dialogResult? As Boolean = dialogBox.ShowDialog()

Comentarios

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

Las ventanas modales se usan principalmente como cuadros de diálogo. Un cuadro de diálogo es un tipo especial de ventana que las aplicaciones usan para interactuar con los usuarios para completar tareas, como abrir archivos o imprimir documentos. Normalmente, los cuadros de diálogo 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 la actividad se aceptó o canceló. El valor devuelto es el valor de la propiedad DialogResult antes de que se cierre una ventana. Para obtener más información, vea DialogResult.

Una ventana que se abre llamando al 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 mediante la Owner propiedad y administrarla mediante la OwnedWindows propiedad . Para admitir la automatización de la interfaz de usuario (consulte Información general de automatización de la interfaz de usuario), Owner debe establecerse para una ventana abierta mediante una llamada a ShowDialog.

Cuando se cierra una ventana modal de WPF (una ventana abierta mediante una llamada a ShowDialog), se reactiva la ventana activada previamente. Si una ventana modal de WPF tiene una ventana de propietario (vea Owner), la ventana de propietario no se reactiva cuando se cierra la ventana modal de WPF a menos que se haya activado anteriormente.

Nota

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

Consulte también

• Close()
• WindowState