Window.DialogResult Proprietà

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Ottiene o imposta il valore del risultato della finestra di dialogo, ovvero il valore restituito dal metodo ShowDialog().

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à

Nullable<Boolean>

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

Attributi

TypeConverterAttribute

Eccezioni

InvalidOperationException

DialogResult viene impostato prima dell'apertura di una finestra chiamando ShowDialog().

-o-

DialogResult è impostato su una finestra aperta chiamando Show().

Esempio

Nell'esempio seguente viene illustrato come configurare un pulsante OK e un pulsante Annulla per restituire il DialogResultappropriato.

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

DialogResult viene null quando viene visualizzata la finestra di dialogo, 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 metodo ShowDialog oppure esaminando la proprietà DialogResult.

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

Nota

Non è possibile impostare o ottenere questa proprietà quando una finestra è ospitata in un browser.