Window.ShowDialog Método

Definición

Abre una ventana y devuelve un valor sólo cuando se cierra la ventana que acaba de abrirse.Opens a window and returns only when the newly opened window is closed.

public:
 Nullable<bool> ShowDialog();
public bool? ShowDialog ();
[System.Security.SecurityCritical]
public bool? ShowDialog ();
member this.ShowDialog : unit -> Nullable<bool>
[<System.Security.SecurityCritical>]
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).A Nullable<T> value of type Boolean that specifies whether the activity was accepted (true) or canceled (false). El valor devuelto es el valor de la propiedad DialogResult antes de que se cierre una ventana.The return value is the value of the DialogResult property before a window closes.

Atributos

Excepciones

Se llama a ShowDialog() en una ventana que se está cerrando (Closing) o se ha cerrado (Closed).ShowDialog() is called on a window that is closing (Closing) or has been closed (Closed).

Ejemplos

En el ejemplo siguiente se muestra cómo abrir una ventana modal.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()

Comentarios

Cuando Window se crea una instancia de una clase, no es visible de forma predeterminada.When a Window class is instantiated, it is not visible by default. ShowDialog muestra la ventana, deshabilita todas las demás ventanas de la aplicación y solo devuelve cuando se cierra la ventana.ShowDialog shows the window, disables all other windows in the application, and returns only when the window is closed. Este tipo de ventana se conoce como ventana modal .This type of window is known as a modal window.

Las ventanas modales se utilizan principalmente como cuadros de diálogo.Modal windows are primarily used as dialog boxes. Un cuadro de diálogo es un tipo especial de ventana que las aplicaciones utilizan para interactuar con los usuarios para completar tareas, como abrir archivos o imprimir documentos.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. Los cuadros de diálogo normalmente permiten a los usuarios aceptar o cancelar la tarea para la que se mostraron antes de que se cierre el cuadro de diálogo.Dialog boxes commonly allow users to accept or cancel the task for which they were shown before the dialog box is closed. ShowDialogDevuelve un Nullable<T> Boolean valor que especifica si la actividad se aceptó o se canceló.ShowDialog returns a Nullable<T>Boolean value that specifies whether the activity was accepted or canceled. El valor devuelto es el valor de la propiedad DialogResult antes de que se cierre una ventana.The return value is the value of the DialogResult property before a window closes. Para obtener más información, vea DialogResult.For more information, see 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ó.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. Esta relación se puede establecer utilizando la Owner propiedad y administrada mediante la OwnedWindows propiedad.This relationship can be established using the Owner property and managed using the OwnedWindows property. Para admitir la automatización de la interfaz de usuario (consulte información general sobre la automatizaciónde la interfaz de usuario), Owner debe establecerse para una ventana abierta mediante una llamada a ShowDialog .To support UI automation (see UI Automation Overview), Owner must be set for a window opened by calling ShowDialog.

Cuando se cierra una ventana de WPF modal (una ventana abierta mediante una llamada a ShowDialog ), se reactiva la ventana previamente activada.When a modal WPF window (a window opened by calling ShowDialog) is closed, the previously activated window is reactivated. Si una ventana de WPF modal tiene una ventana de propietario (vea Owner ), la ventana propietaria no se reactivará cuando se cierre la ventana de WPF modal a menos que sea la ventana previamente activada.If a modal WPF window has an owner window (see Owner), the owner window is not reactivated when the modal WPF window is closed unless it was the previously activated window.

Nota

No se puede llamar a este método cuando una ventana está hospedada en un explorador.This method cannot be called when a window is hosted in a browser.

Se aplica a

Consulte también