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 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
Nilai Nullable<T> jenis Boolean. Default 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 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.
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