Window.DialogResult Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia wartość wyniku okna dialogowego, czyli wartość zwracaną 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)
Wartość właściwości
Nullable<T> Wartość typu Boolean. Wartość domyślna to false
.
- Atrybuty
Wyjątki
DialogResult jest ustawiana przed otwarciem okna przez wywołanie polecenia ShowDialog().
-lub-
DialogResult jest ustawiana w oknie otwartym przez wywołanie polecenia Show().
Przykłady
W poniższym przykładzie pokazano, jak skonfigurować przycisk OK i przycisk Anuluj, aby zwrócić odpowiedni DialogResultelement .
<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
Uwagi
DialogResult można użyć z kodu, który pokazał okno dialogowe, aby określić, czy użytkownik zaakceptował (true
) lub anulował (false
) okno dialogowe. Jeśli zaakceptowano okno dialogowe, oznacza to kod, który otworzył okno dialogowe, aby pobrać dane zebrane przez użytkownika i przetworzyć je. Jeśli jednak anulowano okno dialogowe, oznacza to, że wywoływanie kodu powinno zatrzymać dalsze przetwarzanie.
Domyślnie okno dialogowe jest anulowane, gdy użytkownik wykonuje jedną z następujących czynności:
Naciśnij klawiszeALT+F4.
Klika przycisk Zamknij .
Wybiera pozycję Zamknij z menu System.
We wszystkich tych przypadkach DialogResult jest false
domyślnie.
Okno dialogowe zazwyczaj udostępnia specjalny przycisk do anulowania okna dialogowego, który jest przyciskiem, którego IsCancel właściwość jest ustawiona na true
. Przycisk skonfigurowany w ten sposób spowoduje automatyczne zamknięcie okna po naciśnięciu klawisza ESC lub naciśnięciu klawisza ESC. W jednym z tych przypadków DialogResult pozostaje wartość false
.
Okno dialogowe zazwyczaj udostępnia również przycisk akceptowania, który jest przyciskiem, którego IsDefault właściwość jest ustawiona na true
. Przycisk skonfigurowany w ten sposób spowoduje podniesienie jego Click zdarzenia po naciśnięciu klawisza ENTER lub klawisza ENTER. Nie spowoduje to jednak automatycznego zamknięcia okna dialogowego ani ustawienia wartości DialogResulttrue
. Musisz ręcznie napisać ten kod, zwykle z Click programu obsługi zdarzeń dla przycisku domyślnego.
DialogResult jest null
wtedy, gdy zostanie wyświetlone okno dialogowe, ale nie zostanie zaakceptowane ani anulowane.
Po zamknięciu okna dialogowego można uzyskać wynik okna dialogowego z wartości zwróconej przez ShowDialog metodę lub sprawdzając DialogResult właściwość.
DialogResult można ustawić tylko wtedy, gdy Window element jest otwarty, wywołując jego ShowDialog metodę.
Uwaga
Nie można ustawić ani pobrać tej właściwości, gdy okno jest hostowane w przeglądarce.
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla