Bagikan melalui

Gaya Kotak Dialog

  • Artikel

Tabel berikut ini mencantumkan gaya kotak dialog yang bisa Anda tentukan saat Membuat kotak dialog. Anda dapat menggunakan gaya ini dalam panggilan ke fungsi CreateWindow dan CreateWindowEx , di anggota gaya struktur DLGTEMPLATE dan DLGTEMPLATEEX , dan dalam pernyataan definisi kotak dialog dalam file sumber daya.

Terus-menerus Deskripsi
DS_3DLOOK
 Kedaluwarsa. Sistem secara otomatis menerapkan tampilan tiga dimensi ke kotak dialog yang dibuat oleh aplikasi.
DS_ABSALIGN
 Menunjukkan bahwa koordinat kotak dialog adalah koordinat layar. Jika gaya ini tidak ditentukan, koordinatnya adalah koordinat klien.
DS_CENTER
 Tengahkan kotak dialog di area kerja monitor yang berisi jendela pemilik. Jika tidak ada jendela pemilik yang ditentukan, kotak dialog dipusatkan di area kerja monitor yang ditentukan oleh sistem. Area kerja adalah area yang tidak dikaburkan oleh taskbar atau appbar apa pun.
DS_CENTERMOUSE
 Tengahkan kotak dialog pada kursor mouse.
DS_CONTEXTHELP
 Menyertakan tanda tanya di bilah judul kotak dialog. Saat pengguna mengklik tanda tanya, kursor berubah menjadi tanda tanya dengan penunjuk. Jika pengguna kemudian mengklik kontrol dalam kotak dialog, kontrol menerima pesan WM_HELP . Kontrol harus meneruskan pesan ke prosedur kotak dialog, yang harus memanggil fungsi menggunakan perintah HELP_WM_HELP . Aplikasi bantuan menampilkan jendela pop-up yang biasanya berisi bantuan untuk kontrol.
Perhatikan bahwa DS_CONTEXTHELP hanya tempat penampung. Saat kotak dialog dibuat, sistem memeriksa DS_CONTEXTHELP dan, jika ada, menambahkan WS_EX_CONTEXTHELP ke gaya kotak dialog yang diperluas. WS_EX_CONTEXTHELP tidak dapat digunakan dengan gaya WS_MAXIMIZEBOX atau WS_MINIMIZEBOX .
DS_CONTROL
 Membuat kotak dialog yang berfungsi dengan baik sebagai jendela anak dari kotak dialog lain, sama seperti halaman dalam lembar properti. Gaya ini memungkinkan pengguna untuk tab di antara jendela kontrol kotak dialog anak, menggunakan tombol akseleratornya, dan sebagainya.
DS_FIXEDSYS
 Menyebabkan kotak dialog menggunakan SYSTEM_FIXED_FONT alih-alih SYSTEM_FONT default. Ini adalah font monospace yang kompatibel dengan font Sistem di Windows versi 16-bit yang lebih lama dari 3.0.
DS_LOCALEDIT
 Hanya berlaku untuk aplikasi 16-bit. Gaya ini mengarahkan kontrol edit dalam kotak dialog untuk mengalokasikan memori dari segmen data aplikasi. Jika tidak, edit kontrol mengalokasikan penyimpanan dari objek memori global.
DS_MODALFRAME
 Membuat kotak dialog dengan bingkai kotak dialog modal yang dapat digabungkan dengan bilah judul dan menu jendela dengan menentukan gaya WS_CAPTION dan WS_SYSMENU .
DS_NOFAILCREATE
 Membuat kotak dialog meskipun terjadi kesalahan misalnya, jika jendela anak tidak dapat dibuat atau jika sistem tidak dapat membuat segmen data khusus untuk kontrol pengeditan.
DS_NOIDLEMSG
 Menyembunyikan WM_ENTERIDLE pesan yang akan dikirim sistem kepada pemilik kotak dialog saat kotak dialog ditampilkan.
DS_SETFONT
 Menunjukkan bahwa header templat kotak dialog (baik standar atau diperluas) berisi data tambahan yang menentukan font yang akan digunakan untuk teks di area klien dan kontrol kotak dialog. Jika memungkinkan, sistem memilih font sesuai dengan data font yang ditentukan. Sistem meneruskan handel ke font ke kotak dialog dan ke setiap kontrol dengan mengirimi mereka pesan WM_SETFONT . Untuk deskripsi format data font ini, lihat DLGTEMPLATE dan DLGTEMPLATEEX.
Jika tidak ada DS_SETFONT atau DS_SHELLFONT yang ditentukan, templat kotak dialog tidak menyertakan data font.
DS_SETFOREGROUND
 Menyebabkan sistem menggunakan fungsi SetForegroundWindow untuk membawa kotak dialog ke latar depan. Gaya ini berguna untuk kotak dialog modal yang memerlukan perhatian segera dari pengguna terlepas dari apakah jendela pemilik adalah jendela latar depan.
Sistem membatasi proses mana yang dapat mengatur jendela latar depan. Untuk informasi selengkapnya, lihat Windows Latar Depan dan Latar Belakang.
DS_SHELLFONT
 Menunjukkan bahwa kotak dialog harus menggunakan font sistem. Anggota typeface dari templat kotak dialog yang diperluas harus diatur ke MS Shell Dlg. Jika tidak, gaya ini tidak berpengaruh. Disarankan juga agar Anda menggunakan Sumber Daya DIALOGEX, bukan Sumber Daya DIALOG. Untuk informasi selengkapnya, lihat Font Kotak Dialog.
Sistem memilih font menggunakan data font yang ditentukan dalam anggota pointize, bobot, dan miring . Sistem meneruskan handel ke font ke kotak dialog dan ke setiap kontrol dengan mengirimi mereka pesan WM_SETFONT . Untuk deskripsi format data font ini, lihat DLGTEMPLATEEX.
Jika tidak ada DS_SHELLFONT atau DS_SETFONT yang ditentukan, templat kotak dialog yang diperluas tidak menyertakan data font.
DS_SYSMODAL
 Gaya ini usang dan disertakan untuk kompatibilitas dengan Windows versi 16-bit. Jika Anda menentukan gaya ini, sistem akan membuat kotak dialog dengan gaya WS_EX_TOPMOST . Gaya ini tidak mencegah pengguna mengakses jendela lain pada desktop.
Jangan gabungkan gaya ini dengan gaya DS_CONTROL .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung
 Windows 2000 Server [hanya aplikasi desktop]
Header
Winuser.h (termasuk Windows.h)