Window.DialogResult Proprietà

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)

Valore della proprietà

Valore Nullable<T> di tipo Boolean. Il valore predefinito è false.

Attributi

TypeConverterAttribute

Eccezioni

Esempio

Nell'esempio seguente viene illustrato come configurare un pulsante OK e un pulsante Annulla per restituire l'oggetto appropriato 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

Commenti

DialogResult può essere usato dal codice che mostra una finestra di dialogo per determinare se un utente ha accettato (true) o annullato (false) la finestra di dialogo. Se è stata accettata una finestra di dialogo, significa il codice che ha aperto la finestra di dialogo per recuperare i dati raccolti dall'utente ed elaborarli. Se una finestra di dialogo è stata annullata, tuttavia, significa che il codice chiamante deve arrestare qualsiasi ulteriore elaborazione.

Per impostazione predefinita, una finestra di dialogo viene annullata quando un utente esegue una delle operazioni seguenti:

• Preme ALT+F4.

• Fa clic sul pulsante Chiudi .

• Seleziona Chiudi dal menu Sistema.

In tutti questi casi, DialogResult è false per impostazione predefinita.

Una finestra di dialogo fornisce in genere un pulsante speciale per annullare una finestra di dialogo, ovvero il pulsante la cui IsCancel proprietà è impostata su true. Un pulsante configurato in questo modo chiude automaticamente una finestra quando viene premuto o quando viene premuto IL tasto ESC. In uno di questi casi, DialogResult rimane false.

Una finestra di dialogo fornisce in genere anche un pulsante accept, ovvero il pulsante la cui IsDefault proprietà è impostata su true. Un pulsante configurato in questo modo genererà l'evento Click quando viene premuto o il tasto INVIO. Tuttavia, non chiuderà automaticamente la finestra di dialogo, né verrà impostata su DialogResulttrue. È necessario scrivere manualmente questo codice, in genere dal Click gestore eventi per il pulsante predefinito.

DialogResult è null quando la finestra di dialogo viene visualizzata ma non accettata né annullata.

Dopo la chiusura di una finestra di dialogo, è possibile ottenere il risultato della finestra di dialogo dal valore restituito dal ShowDialog metodo o esaminando la DialogResult proprietà .

DialogResult può essere impostato solo quando un oggetto Window viene aperto chiamando il relativo ShowDialog metodo.