Window.DialogResult Vlastnost

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

Získá nebo nastaví výslednou hodnotu dialogového okna, což je hodnota vrácená z ShowDialog() metoda.

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)

Hodnota vlastnosti

Nullable<Boolean>

Hodnota Nullable<T> typu Boolean. Výchozí hodnota je false.

Atributy

TypeConverterAttribute

Výjimky

InvalidOperationException

DialogResult je nastavena před otevřením okna voláním ShowDialog().

-nebo-

DialogResult je nastaveno v okně, které je otevřeno voláním Show().

Příklady

Následující příklad ukazuje, jak nakonfigurovat tlačítko OK a tlačítko Storno vrátit odpovídající 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

Poznámky

DialogResult lze použít z kódu, který zobrazil dialogové okno k určení, zda uživatel přijal (true) nebo zrušil (false) dialogové okno. Pokud bylo dialogové okno přijato, znamená to kód, který otevřel dialogové okno, aby se načetla data shromážděná uživatelem a zpracovávala je. Pokud se však dialogové okno zrušilo, znamená to, že volání kódu by mělo zastavit jakékoli další zpracování.

Ve výchozím nastavení se dialogové okno zruší, když uživatel provede jednu z následujících věcí:

• Stiskne kombinaci kláves ALT+F4.

• Klikne na tlačítko Zavřít.

• V nabídce Systém vybere Zavřít.

Ve všech těchto případech je DialogResult ve výchozím nastavení false.

Dialogové okno obvykle poskytuje speciální tlačítko pro zrušení dialogového okna, což je tlačítko, jehož IsCancel vlastnost je nastavena na true. Tlačítko nakonfigurované tímto způsobem automaticky zavře okno, když je stisknuto, nebo když je stisknuta klávesa ESC. V obou těchto případech DialogResult zůstává false.

Dialogové okno také obvykle poskytuje tlačítko přijmout, což je tlačítko, jehož IsDefault vlastnost je nastavena na true. Tlačítko nakonfigurované tímto způsobem vyvolá Click událost při stisknutí klávesy ENTER. Dialogové okno však automaticky nezavře, ani nenastaví DialogResult na true. Tento kód potřebujete ručně napsat, obvykle z obslužné rutiny události Click pro výchozí tlačítko.

DialogResult je null při zobrazení dialogového okna, ale není přijato ani zrušeno.

Po zavření dialogového okna můžete získat výsledek dialogového okna z hodnoty vrácené metodou ShowDialog nebo kontrolou vlastnosti DialogResult.

DialogResult lze nastavit pouze při otevření Window voláním metody ShowDialog.

Poznámka

Tuto vlastnost nelze nastavit nebo získat, pokud je okno hostované v prohlížeči.