Window.DialogResult Propriedade

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 Propriedade

Um Nullable<T> valor de tipo Boolean. A predefinição é false.

Atributos

TypeConverterAttribute

Exceções

Exemplos

O exemplo seguinte mostra como configurar um botão OK e um botão Cancelar para devolver o .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

Observações

DialogResult pode ser usado a partir do código que mostrava uma caixa de diálogo para determinar se um utilizador aceitou (true) ou canceloufalse () a caixa de diálogo. Se uma caixa de diálogo foi aceite, isso significa ao código que abriu a caixa de diálogo recuperar os dados recolhidos pelo utilizador e processá-los. Se uma caixa de diálogo foi cancelada, no entanto, isso significa que o código de chamada deve parar qualquer processamento adicional.

Por defeito, uma caixa de diálogo é cancelada quando um utilizador faz uma das seguintes ações:

• Carrega ALT+F4.

• Clica no botão de Fechar .

• Seleciona Fechar no menu do Sistema.

Em todos estes casos, DialogResult é false por defeito.

Uma caixa de diálogo normalmente fornece um botão especial para cancelar um diálogo, que é o botão cuja IsCancel propriedade é definida como true. Um botão configurado desta forma fecha automaticamente uma janela quando esta é pressionada ou quando a tecla ESC é pressionada. Em qualquer um destes casos, DialogResult permanece false.

Uma caixa de diálogo também fornece normalmente um botão de aceitar, que é o botão cuja IsDefault propriedade está definida como true. Um botão configurado desta forma irá ativar o seu Click evento quando ele ou a tecla ENTER for pressionada. No entanto, não fecha automaticamente a caixa de diálogo, nem define DialogResult para true. Tens de escrever este código manualmente, normalmente a partir do Click gestor de eventos para o botão padrão.

DialogResult é null quando a caixa de diálogo é mostrada, mas não é aceite nem cancelada.

Depois de uma caixa de diálogo fechar, pode obter o resultado do diálogo a partir do valor devolvido pelo ShowDialog método, ou inspecionando a DialogResult propriedade.

DialogResult só pode ser definido quando a Window é aberto, chamando o seu ShowDialog método.