Window.DialogResult Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur nilai hasil dialog, yang merupakan nilai yang dikembalikan dari ShowDialog() metode .

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)

Nilai Properti

Nullable<Boolean>

Nilai Nullable<T> jenis Boolean. Default adalah false.

Atribut

TypeConverterAttribute

Pengecualian

InvalidOperationException

DialogResult diatur sebelum jendela dibuka dengan memanggil ShowDialog().

-atau-

DialogResult diatur pada jendela yang dibuka dengan memanggil Show().

Contoh

Contoh berikut menunjukkan cara mengonfigurasi tombol OK dan tombol Batal untuk mengembalikan yang sesuai 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

Keterangan

DialogResult dapat digunakan dari kode yang memperlihatkan kotak dialog untuk menentukan apakah pengguna menerima (true) atau membatalkan (false) kotak dialog. Jika kotak dialog diterima, ini menandakan kode yang membuka kotak dialog untuk mengambil data yang dikumpulkan oleh pengguna dan memprosesnya. Namun, jika kotak dialog dibatalkan, ini menandakan bahwa kode panggilan harus menghentikan pemrosesan lebih lanjut.

Secara default, kotak dialog dibatalkan saat pengguna melakukan salah satu hal berikut ini:

• TekanALT+F4.

• Klik tombol Tutup .

• Pilih Tutup dari menu Sistem.

Dalam semua kasus ini, DialogResult secara false default.

Kotak dialog biasanya menyediakan tombol khusus untuk membatalkan dialog, yang merupakan tombol yang propertinya IsCancel diatur ke true. Tombol yang dikonfigurasi dengan cara ini akan secara otomatis menutup jendela saat ditekan, atau ketika tombol ESC ditekan. Dalam salah satu kasus ini, DialogResult tetap false.

Kotak dialog juga biasanya menyediakan tombol terima, yang merupakan tombol yang propertinya IsDefault diatur ke true. Tombol yang dikonfigurasi dengan cara ini akan menaikkan peristiwanya Click saat tombol atau tombol ENTER ditekan. Namun, itu tidak akan secara otomatis menutup kotak dialog, juga tidak akan diatur DialogResult ke true. Anda perlu menulis kode ini secara manual, biasanya dari penanganan Click aktivitas untuk tombol default.

DialogResult adalah null ketika kotak dialog ditampilkan tetapi tidak diterima atau dibatalkan.

Setelah kotak dialog ditutup, Anda bisa mendapatkan hasil dialog dari nilai yang dikembalikan oleh ShowDialog metode, atau dengan memeriksa DialogResult properti .

DialogResult hanya dapat diatur ketika Window dibuka dengan memanggil metodenya ShowDialog .

Catatan

Anda tidak dapat mengatur atau mendapatkan properti ini ketika jendela dihosting di browser.