Window.DialogResult Tulajdonság

Definíció

Névtér:

System.Windows

Szerelvény:

PresentationFramework.dll

Lekéri vagy beállítja a párbeszédpanel eredményértékét, amely a metódusból ShowDialog() visszaadott érték.

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)

Tulajdonság értéke

Nullable<Boolean>

Típusérték Nullable<T>Boolean. Az alapértelmezett érték a false.

Attribútumok

TypeConverterAttribute

Kivételek

InvalidOperationException

DialogResult az ablak megnyitása előtt be van állítva hívással ShowDialog().

-vagy-

DialogResult a egy hívással Show()megnyitott ablakban van beállítva.

Példák

Az alábbi példa bemutatja, hogyan konfigurálhat egy OK gombot és egy Mégse gombot a megfelelő DialogResultvisszatéréshez.

<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

Megjegyzések

DialogResult a párbeszédpanelt megjelenítő kódból használható annak megállapítására, hogy egy felhasználó elfogadta-e (true) vagy megszakította -e (false) a párbeszédpanelt. Ha egy párbeszédpanelt elfogadtak, ez azt jelzi, hogy a párbeszédpanelt megnyitó kód lekéri a felhasználó által gyűjtött és feldolgozott adatokat. Ha azonban egy párbeszédpanel megszakadt, ez azt jelzi, hogy a hívási kódnak le kell állítania a további feldolgozást.

Alapértelmezés szerint egy párbeszédpanel megszakad, ha egy felhasználó az alábbiak egyikét hajtja végre:

• Nyomja le az ALT+F4 billentyűkombinációt.

• Kattintson a Bezárás gombra.

• A Rendszer menü Bezárás elemét választja.

Az összes ilyen esetben DialogResult alapértelmezés szerint.false

A párbeszédpanelek általában egy speciális gombot biztosítanak a párbeszédpanel megszakításához, amely az a gomb, amelynek IsCancel tulajdonsága a következőre truevan állítva. Az így konfigurált gombok automatikusan bezárnak egy ablakot, ha megnyomják vagy lenyomják az ESC-kulcsot. Az ilyen esetek DialogResult egyikében továbbra is false.

A párbeszédpanelek általában egy elfogadás gombot is biztosítanak, amely az a gomb, amelynek IsDefault a tulajdonsága be van állítva true. Az ilyen módon konfigurált gomb akkor aktiválja az eseményt Click , ha az vagy az ENTER billentyűt lenyomja. Azonban nem zárja be automatikusan a párbeszédpanelt, és nem is lesz beállítva DialogResulttrue. Ezt a kódot manuálisan kell írnia, általában az Click alapértelmezett gomb eseménykezelőjének használatával.

DialogResult ekkor null jelenik meg a párbeszédpanel, de sem elfogadva, sem megszakítva.

Miután bezárult egy párbeszédpanel, a párbeszédpanel eredménye a metódus vagy a ShowDialog tulajdonság vizsgálata alapján DialogResult visszaadott értékből származik.

DialogResult csak akkor állítható be, ha egy Window meg van nyitva a metódus meghívásával ShowDialog .

Note

Ezt a tulajdonságot nem lehet beállítani vagy lekérni, ha egy ablakot böngészőben üzemeltetnek.