Window.DialogResult Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
Hodnota Nullable<T> typu Boolean. Výchozí formát je false
.
- Atributy
Výjimky
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.
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro