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

DialogResultpuò essere usato dal codice che mostra una finestra di dialogo per determinare se un utente ha accettato () o annullato (truefalse) la finestra di dialogo. Se è stata accettata una finestra di dialogo, questo significa il codice che ha aperto la finestra di dialogo per recuperare i dati raccolti dall'utente e elaborarlo. Se una finestra di dialogo è stata annullata, tuttavia, indica 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:

• PressesALT+F4.

• Fare clic sul pulsante Chiudi .

• Seleziona Chiudi dal menu Sistema.

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

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 un pulsante di accettazione, ovvero il pulsante la cui IsDefault proprietà è impostata su true. Un pulsante configurato in questo modo genererà Click l'evento quando viene premuto o il tasto INVIO. Tuttavia, non chiuderà automaticamente la finestra di dialogo, né verrà impostato DialogResult su true. È necessario scrivere manualmente questo codice, in genere dal Click gestore eventi per il pulsante predefinito.

DialogResult è null quando viene visualizzata la finestra di dialogo, ma non è stata 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 oppure esaminando la DialogResult proprietà.

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

Si applica a