Window.DialogResult Propiedad

Definición

Obtiene o establece el valor del resultado del cuadro de diálogo, que es el valor devuelto por el método ShowDialog().Gets or sets the dialog result value, which is the value that is returned from the ShowDialog() method.

public:
 property Nullable<bool> DialogResult { Nullable<bool> get(); void set(Nullable<bool> value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.DialogResultConverter))]
public bool? DialogResult { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Windows.DialogResultConverter))>]
member this.DialogResult : Nullable<bool> with get, set
Public Property DialogResult As Nullable(Of Boolean)

Valor de propiedad

Nullable<Boolean>

Valor Nullable<T> de tipo Boolean.A Nullable<T> value of type Boolean. De manera predeterminada, es false.The default is false.

Atributos

Excepciones

Se establece DialogResult antes de que se abra una ventana al llamar a ShowDialog().DialogResult is set before a window is opened by calling ShowDialog().

o bien-or- DialogResult se establece en una ventana que se abre al llamar a Show().DialogResult is set on a window that is opened by calling Show().

Ejemplos

En el ejemplo siguiente se muestra cómo configurar un botón Aceptar y un botón Cancelar para devolver el correspondiente DialogResult .The following example shows how to configure an OK button and a Cancel button to return the appropriate DialogResult.

<Button IsDefault="True" Click="acceptButton_Click">OK (IsDefault=True)</Button>
<Button IsCancel="True">Cancel (IsCancel=True)</Button>
using System;
using System.Windows;
using System.Windows.Controls;

namespace CSharp
{
    public partial class DialogBox : Window
    {
        public DialogBox()
        {
            InitializeComponent();
        }

        // The accept button is a button whose IsDefault property is set to true.
        // This event is raised whenever this button is clicked, or the ENTER key
        // is pressed.
        void acceptButton_Click(object sender, RoutedEventArgs e)
        {
            // Accept the dialog and return the dialog result
            this.DialogResult = true;
        }
    }
}

Imports System.Windows
Imports System.Windows.Controls

Namespace VisualBasic
    Partial Public Class DialogBox
        Inherits Window
        Public Sub New()
            InitializeComponent()
        End Sub

        ' The accept button is a button whose IsDefault property is set to true.
        ' This event is raised whenever this button is clicked, or the ENTER key
        ' is pressed.
        Private Sub acceptButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
            ' Accept the dialog and return the dialog result
            Me.DialogResult = True
        End Sub
    End Class
End Namespace

Comentarios

DialogResult se puede usar desde el código que mostró un cuadro de diálogo para determinar si un usuario aceptó ( true ) o canceló ( false ) el cuadro de diálogo.DialogResult can be used from the code that showed a dialog box to determine whether a user accepted (true) or canceled (false) the dialog box. Si se aceptó un cuadro de diálogo, esto significa el código que abrió el cuadro de diálogo para recuperar los datos recopilados por el usuario y procesarlos.If a dialog box was accepted, this signifies to the code that opened the dialog box to retrieve the data that was collected by the user and process it. Sin embargo, si se ha cancelado un cuadro de diálogo, esto significa que el código de llamada debe detener el procesamiento posterior.If a dialog box was canceled, however, this signifies that calling code should stop any further processing.

De forma predeterminada, un cuadro de diálogo se cancela cuando un usuario realiza una de las acciones siguientes:By default, a dialog box is canceled when a user does one of the following:

  • PressesALT + F4.PressesALT+F4.

  • Hace clic en el botón cerrar .Clicks the Close button.

  • Selecciona cerrar en el menú sistema.Selects Close from the System menu.

En todos estos casos, DialogResult es de false forma predeterminada.In all of these cases, DialogResult is false by default.

Normalmente, un cuadro de diálogo proporciona un botón especial para cancelar un diálogo, que es el botón cuya IsCancel propiedad está establecida en true .A dialog box typically provides a special button to cancel a dialog, which is the button whose IsCancel property is set to true. Un botón configurado de esta manera cerrará automáticamente una ventana cuando se presione o cuando se presione la tecla ESC.A button configured this way will automatically close a window when either it is pressed, or when the ESC key is pressed. En cualquiera de estos casos, DialogResult permanece false .In either of these cases, DialogResult remains false.

Un cuadro de diálogo también proporciona normalmente un botón Aceptar, que es el botón cuya IsDefault propiedad está establecida en true .A dialog box also typically provides an accept button, which is the button whose IsDefault property is set to true. Un botón configurado de esta manera generará su Click evento cuando se presione la tecla entrar o la tecla entrar.A button configured this way will raise its Click event when either it or the ENTER key is pressed. Sin embargo, no se cerrará automáticamente el cuadro de diálogo ni se establecerá DialogResult en true .However, it won't automatically close the dialog box, nor will it set DialogResult to true. Debe escribir manualmente este código, normalmente desde el Click controlador de eventos para el botón predeterminado.You need to manually write this code, usually from the Click event handler for the default button.

DialogResult es null cuando se muestra el cuadro de diálogo pero no se acepta ni se cancela.DialogResult is null when the dialog box is shown but neither accepted nor canceled.

Una vez que se cierra un cuadro de diálogo, puede obtener el resultado del cuadro de diálogo del valor devuelto por el ShowDialog método o inspeccionando la DialogResult propiedad.After a dialog box closes, you can get the dialog result from the value returned by ShowDialog method, or by inspecting the DialogResult property.

DialogResult solo se puede establecer cuando Window se abre una llamando a su ShowDialog método.DialogResult can only be set when a Window is opened by calling its ShowDialog method.

Nota

No se puede establecer u obtener esta propiedad cuando una ventana está hospedada en un explorador.You cannot set or get this property when a window is hosted in a browser.

Se aplica a