Kotak Dialog (Kotak Dialog)

Kotak dialog adalah jendela sementara yang dibuat aplikasi untuk mengambil input pengguna. Aplikasi biasanya menggunakan kotak dialog untuk meminta informasi tambahan kepada pengguna untuk item menu. Kotak dialog biasanya berisi satu atau beberapa kontrol (jendela anak) tempat pengguna memasukkan teks, memilih opsi, atau mengarahkan tindakan.

Windows juga menyediakan kotak dialog yang telah ditentukan sebelumnya yang mendukung item menu umum seperti Buka dan Cetak. Aplikasi yang menggunakan item menu ini harus menggunakan kotak dialog umum untuk meminta input pengguna ini, terlepas dari jenis aplikasinya.

Di Bagian Ini

Nama	Deskripsi
Tentang Kotak Dialog	Membahas menggunakan kotak dialog di antarmuka pengguna untuk aplikasi Anda.
Pertimbangan Pemrograman Kotak Dialog	Gambaran umum ini membahas beberapa pertimbangan pemrograman mengenai kotak dialog.
Menggunakan Kotak Dialog	Anda menggunakan kotak dialog untuk menampilkan informasi dan meminta input dari pengguna.
Referensi Kotak Dialog	Referensi API
Pustaka Kotak Dialog Umum	Membahas menggunakan kotak dialog umum di antarmuka pengguna untuk aplikasi Anda.

Fungsi Kotak Dialog

Nama	Deskripsi
BuatDialog	Membuat kotak dialog tanpa mode dari sumber daya templat kotak dialog.
CreateDialogIndirect	Membuat kotak dialog tanpa mode dari templat kotak dialog dalam memori.
CreateDialogIndirectParam	Membuat kotak dialog tanpa mode dari templat kotak dialog dalam memori. Sebelum menampilkan kotak dialog, fungsi meneruskan nilai yang ditentukan aplikasi ke prosedur kotak dialog sebagai parameter lParam dari pesan WM_INITDIALOG . Aplikasi dapat menggunakan nilai ini untuk menginisialisasi kontrol kotak dialog.
CreateDialogParam	Membuat kotak dialog tanpa mode dari sumber daya templat kotak dialog. Sebelum menampilkan kotak dialog, fungsi meneruskan nilai yang ditentukan aplikasi ke prosedur kotak dialog sebagai parameter lParam dari pesan WM_INITDIALOG . Aplikasi dapat menggunakan nilai ini untuk menginisialisasi kontrol kotak dialog.
DefDlgProc	Memanggil prosedur jendela kotak dialog default untuk menyediakan pemrosesan default untuk pesan jendela apa pun yang tidak diproses oleh kotak dialog dengan kelas jendela privat.
Kotak Dialog	Membuat kotak dialog modal dari sumber daya templat kotak dialog. Kotak Dialog tidak mengembalikan kontrol hingga fungsi panggilan balik yang ditentukan mengakhiri kotak dialog modal dengan memanggil fungsi EndDialog .
DialogBoxIndirect	Membuat kotak dialog modal dari templat kotak dialog dalam memori. DialogBoxIndirect tidak mengembalikan kontrol hingga fungsi panggilan balik yang ditentukan mengakhiri kotak dialog modal dengan memanggil fungsi EndDialog .
DialogBoxIndirectParam	Membuat kotak dialog modal dari templat kotak dialog dalam memori. Sebelum menampilkan kotak dialog, fungsi meneruskan nilai yang ditentukan aplikasi ke prosedur kotak dialog sebagai parameter lParam dari pesan WM_INITDIALOG . Aplikasi dapat menggunakan nilai ini untuk menginisialisasi kontrol kotak dialog.
DialogBoxParam	Membuat kotak dialog modal dari sumber daya templat kotak dialog. Sebelum menampilkan kotak dialog, fungsi meneruskan nilai yang ditentukan aplikasi ke prosedur kotak dialog sebagai parameter lParam dari pesan WM_INITDIALOG . Aplikasi dapat menggunakan nilai ini untuk menginisialisasi kontrol kotak dialog.
DialogProc	Fungsi panggilan balik yang ditentukan aplikasi yang digunakan dengan keluarga fungsi CreateDialog dan DialogBox . Ini memproses pesan yang dikirim ke kotak dialog modal atau tanpa mode. Jenis DLGPROC mendefinisikan penunjuk ke fungsi panggilan balik ini. DialogProc adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.
EndDialog	Menghancurkan kotak dialog modal, menyebabkan sistem mengakhiri pemrosesan apa pun untuk kotak dialog.
GetDialogBaseUnits	Mengambil unit dasar dialog sistem, yang merupakan lebar rata-rata dan tinggi karakter dalam font sistem. Untuk kotak dialog yang menggunakan font sistem, Anda bisa menggunakan nilai-nilai ini untuk mengonversi antara unit templat dialog, seperti yang ditentukan dalam templat kotak dialog, dan piksel. Untuk kotak dialog yang tidak menggunakan font sistem, konversi dari unit templat dialog ke piksel bergantung pada font yang digunakan oleh kotak dialog.
GetDlgCtrlID	Mengambil pengidentifikasi kontrol yang ditentukan.
GetDlgItem	Mengambil handel ke kontrol dalam kotak dialog yang ditentukan.
GetDlgItemInt	Menerjemahkan teks kontrol tertentu dalam kotak dialog ke dalam nilai bilangan bulat.
GetDlgItemText	Mengambil judul atau teks yang terkait dengan kontrol dalam kotak dialog.
GetNextDlgGroupItem	Mengambil handel ke kontrol pertama dalam sekelompok kontrol yang mendahului (atau mengikuti) kontrol yang ditentukan dalam kotak dialog.
GetNextDlgTabItem	Mengambil handel ke kontrol pertama yang memiliki gaya WS_TABSTOP yang mendahului (atau mengikuti) kontrol yang ditentukan.
IsDialogMessage	Menentukan apakah pesan ditujukan untuk kotak dialog yang ditentukan dan, jika ya, memproses pesan.
MapDialogRect	Mengonversi unit kotak dialog yang ditentukan menjadi unit layar (piksel). Fungsi menggantikan koordinat dalam struktur RECT yang ditentukan dengan koordinat yang dikonversi, yang memungkinkan struktur digunakan untuk membuat kotak dialog atau memosisikan kontrol dalam kotak dialog.
Kotak Pesan	Menampilkan kotak dialog modal yang berisi ikon sistem, sekumpulan tombol, dan pesan khusus aplikasi singkat, seperti informasi status atau kesalahan. Kotak pesan mengembalikan nilai bilangan bulat yang menunjukkan tombol mana yang diklik pengguna.
MessageBoxEx	Membuat, menampilkan, dan mengoperasikan kotak pesan. Kotak pesan berisi pesan dan judul yang ditentukan aplikasi, ditambah kombinasi ikon dan tombol dorong yang telah ditentukan sebelumnya. Tombol berada dalam bahasa antarmuka pengguna sistem.
MessageBoxIndirect	Membuat, menampilkan, dan mengoperasikan kotak pesan. Kotak pesan berisi teks dan judul pesan yang ditentukan aplikasi, ikon apa pun, dan kombinasi tombol push yang telah ditentukan sebelumnya.
SendDlgItemMessage	Mengirim pesan ke kontrol yang ditentukan dalam kotak dialog.
SetDlgItemInt	Mengatur teks kontrol dalam kotak dialog ke representasi string dari nilai bilangan bulat tertentu.
SetDlgItemText	Mengatur judul atau teks kontrol dalam kotak dialog.

Pesan Kotak Dialog

Nama	Deskripsi
DM_GETDEFID	Mengambil pengidentifikasi kontrol tombol dorong default untuk kotak dialog.
DM_REPOSITION	Memposisikan ulang kotak dialog tingkat atas agar pas di dalam area desktop. Aplikasi dapat mengirim pesan ini ke kotak dialog setelah mengubah ukurannya untuk memastikan bahwa seluruh kotak dialog tetap terlihat.
DM_SETDEFID	Mengubah pengidentifikasi tombol dorong default untuk kotak dialog.

Pemberitahuan Kotak Dialog

Nama	Deskripsi
WM_CTLCOLORDLG	Dikirim ke kotak dialog sebelum sistem menggambar kotak dialog. Dengan merespons pesan ini, kotak dialog dapat mengatur teks dan warna latar belakangnya menggunakan handel konteks perangkat tampilan yang ditentukan.
WM_ENTERIDLE	Dikirim ke jendela pemilik kotak dialog modal atau menu yang memasukkan status menganggur. Kotak dialog modal atau menu memasuki status menganggur ketika tidak ada pesan yang menunggu dalam antreannya setelah memproses satu atau beberapa pesan sebelumnya.
WM_GETDLGCODE	Dikirim ke prosedur jendela yang terkait dengan kontrol. Secara default, sistem menangani semua input keyboard ke kontrol; sistem menafsirkan jenis input keyboard tertentu sebagai tombol navigasi kotak dialog. Untuk mengambil alih perilaku default ini, kontrol dapat merespons pesan WM_GETDLGCODE untuk menunjukkan jenis input yang ingin diproses sendiri.
WM_INITDIALOG	Dikirim ke prosedur kotak dialog segera sebelum kotak dialog ditampilkan. Prosedur kotak dialog biasanya menggunakan pesan ini untuk menginisialisasi kontrol dan melakukan tugas inisialisasi lain yang memengaruhi tampilan kotak dialog.
WM_NEXTDLGCTL	Dikirim ke prosedur kotak dialog untuk mengatur fokus keyboard ke kontrol lain dalam kotak dialog.

Struktur Kotak Dialog

Nama	Deskripsi
DLGITEMTEMPLATE	Menentukan dimensi dan gaya kontrol dalam kotak dialog. Satu atau beberapa struktur ini dikombinasikan dengan struktur DLGTEMPLATE untuk membentuk templat standar untuk kotak dialog.
DLGITEMTEMPLATEEX	Menjelaskan kotak dialog yang diperluas. Untuk deskripsi format templat kotak dialog yang diperluas, lihat DLGTEMPLATEEX.
DLGTEMPLATE	Menentukan dimensi dan gaya kotak dialog. Struktur ini, selalu yang pertama dalam templat standar untuk kotak dialog, juga menentukan jumlah kontrol dalam kotak dialog dan karena itu menentukan jumlah struktur DLGITEMTEMPLATE berikutnya dalam templat.
DLGTEMPLATEEX	Templat kotak dialog yang diperluas dimulai dengan header DLGTEMPLATEEX yang menjelaskan kotak dialog dan menentukan jumlah kontrol dalam kotak dialog. Untuk setiap kontrol dalam kotak dialog, templat kotak dialog yang diperluas memiliki blok data yang menggunakan format DLGITEMTEMPLATEEX untuk menjelaskan kontrol.
MSGBOXPARAMS	Berisi informasi yang digunakan untuk menampilkan kotak pesan. Fungsi MessageBoxIndirect menggunakan struktur ini.