Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Proprietà Window.DialogResult

 

Data di pubblicazione: novembre 2016

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

Spazio dei nomi:   System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

[TypeConverterAttribute(typeof(DialogResultConverter))]
public Nullable<bool> DialogResult { get; set; }

Valore proprietà

Type: System.Nullable<Boolean>

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

Exception Condition
InvalidOperationException

DialogResult viene impostata prima apertura di una finestra chiamando ShowDialog.

-oppure-

DialogResult è impostata su una finestra che viene aperto, chiamando Show.

DialogResult può essere utilizzato dal codice che mostrano una finestra di dialogo per determinare se un utente ha accettato (true) o annullato (false) nella finestra di dialogo. Se una finestra di dialogo è stata accettata, ciò significa che per 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, ciò significa che il codice chiamante deve arrestare l'ulteriore elaborazione.

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

  • Le pressioniALT + F4.

  • Seleziona il Chiudi pulsante.

  • Seleziona Chiudi dal menu di sistema.

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

Una finestra di dialogo in genere disponibile un pulsante speciale per annullare una finestra di dialogo, che corrisponde al pulsante la cui IsCancel è impostata su true. Un pulsante configurato in questo modo verrà chiusa automaticamente una finestra quando è premuto o quando viene premuto il tasto ESC. In entrambi i casi, DialogResult rimane false.

Una finestra di dialogo in genere disponibile anche un pulsante di conferma, che corrisponde al pulsante la cui IsDefault è impostata su true. Un pulsante configurato in questo modo verrà generato il Click evento quando viene premuto, o il tasto INVIO. Tuttavia, non verrà chiusa automaticamente la finestra di dialogo non verrà impostata DialogResult a 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 non viene accettata né annullata.

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

DialogResult può essere impostata solo quando un Window è aperto, chiamando il relativo ShowDialog metodo.

System_CAPS_noteNota

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

Nell'esempio seguente viene illustrato come configurare un pulsante OK e un pulsante Cancel 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;
        }
    }
}

.NET Framework
Disponibile da 3.0
Torna all'inizio
Mostra: