Window.DialogResult Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

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

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. Defaultnya 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 DialogResultyang sesuai.

<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 diterima (true) atau dibatalkan (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:

• Menekan ALT+F4.

• Klik tombol Tutup .

• Memilih Tutup dari menu Sistem.

Dalam semua kasus ini, DialogResultfalse secara default.

Kotak dialog biasanya menyediakan tombol khusus untuk membatalkan dialog, yang merupakan tombol yang properti IsCancel-nya 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 properti IsDefault-nya diatur ke true. Tombol yang dikonfigurasi dengan cara ini akan menaikkan peristiwa Click saat tombol tersebut atau tombol ENTER ditekan. Namun, itu tidak akan secara otomatis menutup kotak dialog, juga tidak akan mengatur DialogResult ke true. Anda perlu menulis kode ini secara manual, biasanya dari penanganan aktivitas Click untuk tombol default.

DialogResult null saat kotak dialog ditampilkan tetapi tidak diterima atau dibatalkan.

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

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

Nota

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