Window.DialogResult Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
Nilai Nullable<T> jenis Boolean. Defaultnya adalah false
.
- Atribut
Pengecualian
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.
Berlaku untuk
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk