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() metody.

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 nastaven 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 možnost Zavřít .

Ve všech těchtopřípadechch DialogResultfalse

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 některém z těchto případů zůstává DialogResultfalse.

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á událost Click při stisknutí klávesy ENTER. Toto dialogové okno ale automaticky nezavře, ani ho nenastaví DialogResult na truehodnotu . Tento kód potřebujete ručně napsat, obvykle z Click obslužné rutiny události pro výchozí tlačítko.

DialogResult je null zobrazena dialogové okno, 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 DialogResult vlastnosti.

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

Poznámka

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