Window.ShowDialog Window.ShowDialog Window.ShowDialog Window.ShowDialog Method

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

Devoluciones

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.

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 se Window crea una instancia de una clase, no es visible de forma predeterminada.When a Window class is instantiated, it is not visible by default. ShowDialogmuestra 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 ShowDialog llamando al 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 OwnedWindows la propiedad.This relationship can be established using the Owner property and managed using the OwnedWindows property. Para admitir IUUI la automatización (consulte información generalde la Owner automatización de la interfaz de usuario), debe ShowDialogestablecerse para una ventana abierta mediante una llamada a.To support IUUI automation (see UI Automation Overview), Owner must be set for a window opened by calling ShowDialog.

Cuando se cierra WPFWPF una ventana modal (una ventana abierta ShowDialogmediante una llamada a), se vuelve a activar la ventana activada previamente.When a modal WPFWPF window (a window opened by calling ShowDialog) is closed, the previously activated window is reactivated. Si una ventana WPFWPF modal tiene una ventana propietaria (vea Owner), la ventana propietaria no se reactivará cuando se WPFWPF cierre la ventana modal a menos que sea la ventana previamente activada.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.

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.

Seguridad

UIPermission
para obtener permiso para activar una ventana.for permission to activate a window. Enumeración asociada:AllWindowsAssociated enumeration: AllWindows

Se aplica a

Consulte también: