Window.DialogResult Vlastnost

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

Získá nebo nastaví hodnotu výsledku 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í formát je false.

Atributy

TypeConverterAttribute

Výjimky

InvalidOperationException

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

-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 Zrušit, aby vrátilo 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, že kód, který dialogové okno otevřel, načte data shromážděná uživatelem a zpracuje je. Pokud se však dialogové okno zrušilo, znamená to, že volající kód by měl zastavit jakékoli další zpracování.

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

• Stiskněte KLÁVEST+F4.

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

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

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

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. Takto nakonfigurované tlačítko automaticky zavře okno při stisknutí nebo stisknutí klávesy 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. Tímto způsobem nakonfigurované tlačítko vyvolá událost Click při stisknutí nebo stisknutí klávesy ENTER. Toto dialogové okno se ale automaticky nezavře, ani se nenastaví DialogResult na true. Tento kód musíte napsat ručně, obvykle z obslužné Click rutiny události pro výchozí tlačítko.

DialogResult je null , když se dialogové okno zobrazí, 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 ani získat, pokud je okno hostované v prohlížeči.