Window.ShowDialog Metode

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Membuka jendela dan mengembalikan hanya ketika jendela yang baru dibuka ditutup.

public:
 Nullable<bool> ShowDialog();

public bool? ShowDialog ();

member this.ShowDialog : unit -> Nullable<bool>

Public Function ShowDialog () As Nullable(Of Boolean)

Mengembalikan

Nullable<Boolean>

Nilai Nullable<T> jenis Boolean yang menentukan apakah aktivitas diterima (true) atau dibatalkan (false). Nilai yang dikembalikan adalah nilai DialogResult properti sebelum jendela ditutup.

Pengecualian

InvalidOperationException

ShowDialog() dipanggil pada jendela yang menutup (Closing) atau telah ditutup (Closed).

Contoh

Contoh berikut menunjukkan cara membuka jendela modal.

// Instantiate window
DialogBox dialogBox = new DialogBox();

// Show window modally
// NOTE: Returns only when window is closed
Nullable<bool> dialogResult = dialogBox.ShowDialog();

' Instantiate window
Dim dialogBox As New DialogBox()

' Show window modally
' NOTE: Returns only when window is closed
Dim dialogResult? As Boolean = dialogBox.ShowDialog()

Keterangan

Window Saat kelas dibuat, kelas tidak terlihat secara default. ShowDialog menampilkan jendela, menonaktifkan semua jendela lain dalam aplikasi, dan hanya mengembalikan saat jendela ditutup. Jenis jendela ini dikenal sebagai jendela modal .

Jendela modal terutama digunakan sebagai kotak dialog. Kotak dialog adalah jenis jendela khusus yang digunakan aplikasi untuk berinteraksi dengan pengguna untuk menyelesaikan tugas, seperti membuka file atau mencetak dokumen. Kotak dialog biasanya memperbolehkan pengguna menerima atau membatalkan tugas yang diperlihatkan sebelum kotak dialog ditutup. ShowDialog Nullable<T> Boolean mengembalikan nilai yang menentukan apakah aktivitas diterima atau dibatalkan. Nilai yang dikembalikan adalah nilai DialogResult properti sebelum jendela ditutup. Untuk informasi selengkapnya, lihat DialogResult.

Jendela yang dibuka dengan memanggil ShowDialog metode tidak secara otomatis memiliki hubungan dengan jendela yang membukanya; khususnya, jendela yang dibuka tidak tahu jendela mana yang membukanya. Hubungan ini dapat dibuat menggunakan Owner properti dan dikelola menggunakan OwnedWindows properti . Untuk mendukung otomatisasi UI (lihat Gambaran Umum Automasi UI), Owner harus diatur untuk jendela yang dibuka dengan memanggil ShowDialog.

Ketika jendela WPF modal (jendela yang dibuka dengan memanggil ShowDialog) ditutup, jendela yang diaktifkan sebelumnya diaktifkan kembali. Jika jendela WPF modal memiliki jendela pemilik (lihat Owner), jendela pemilik tidak diaktifkan kembali ketika jendela WPF modal ditutup kecuali jendela itu adalah jendela yang diaktifkan sebelumnya.

Catatan

Metode ini tidak dapat dipanggil ketika jendela dihosting di browser.

Lihat juga

• Close()
• WindowState