Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

Window.ShowDialog (Método)

Abra una ventana y devuelve sólo cuando se cierra la ventana recién abierta.

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

public Nullable<bool> ShowDialog()

Valor devuelto

Tipo: System.Nullable<Boolean>
Un valor de Nullable<T> de Boolean tipo que especifica si la actividad se aceptada (true) o cancela (false). El valor devuelto es el valor de la propiedad de DialogResult antes de que se cierre una ventana.

ExcepciónCondición
InvalidOperationException

ShowDialog se llama Window que está visible

- o

ShowDialog se llama Window visible que se abre llamando a ShowDialog.

InvalidOperationException

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

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

Las 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 completar tareas, como archivos de apertura o documentos de impresión. Los cuadros de diálogo permiten normalmente que los usuarios acepta o que cancelar la tarea para la que se mostraron antes de cerrar el cuadro de diálogo. ShowDialog devuelve un valor de Nullable<T>Boolean que especifica si la actividad se aceptada o cancelado. El valor devuelto es el valor de la propiedad de DialogResult antes de que se cierre una ventana. Para obtener más información, vea DialogResult.

Una ventana que se abre llamando al método de ShowDialog automáticamente no tiene una relación con la ventana que abrió; específicamente, la ventana abierta no sabe abrió la ventana de él. Esta relación se puede establecer utilizando la propiedad de Owner y administrar mediante la propiedad de OwnedWindows . Para admitir la automatización de interfaz de usuario (vea Información general sobre UI Automation), Owner establecido para una ventana abrió llamando a ShowDialog.

Cuando se cierra una ventana modal de WPF(ventana abrió llamando a ShowDialog), se reactiva la ventana activada previamente. Si una ventana modal de WPF tiene una ventana propietaria (vea Owner), la ventana propietaria no se reactiva cuando se cierra la ventana modal de WPF a menos que fuera la ventana activada previamente.

NotaNota

Este método no puede llamarse a una ventana se hospeda en un explorador.

El ejemplo siguiente 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();


.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft