Bagikan melalui

Tipe Kotak Dialog Umum

  • Artikel

Pustaka Kotak Dialog Umum menyediakan fungsi pembuatan dan struktur untuk setiap jenis kotak dialog umum. Untuk menggunakan kotak dialog umum dalam bentuk paling sederhana, Anda memanggil fungsi pembuatannya dan menentukan penunjuk ke struktur yang berisi nilai awal dan bendera opsi. Setelah menginisialisasi kotak dialog, prosedur kotak dialog menggunakan struktur untuk mengembalikan informasi tentang input pengguna. Anda juga dapat menyesuaikan kotak dialog umum agar sesuai dengan kebutuhan aplikasi Anda.

Tabel berikut ini menyediakan deskripsi singkat tentang berbagai jenis kotak dialog umum, dan memperlihatkan fungsi dan struktur yang digunakan dengan setiap jenis.

Kotak dialog Deskripsi
Warna
 Menampilkan warna yang tersedia dan secara opsional memungkinkan pengguna membuat warna kustom. Pengguna dapat memilih warna dasar atau kustom. Gunakan fungsiChooseColor dan strukturCHOOSECOLOR. Untuk informasi selengkapnya, lihat kotak dialog warna .
Temukan
 Menampilkan kotak dialog tempat pengguna dapat mengetik string yang akan ditemukan. Pengguna juga dapat menentukan opsi pencarian, seperti arah pencarian dan apakah pencarian peka huruf besar/kecil. Gunakan fungsiFindTextdan strukturFINDREPLACE. Untuk informasi selengkapnya, lihat Temukan dan Ganti Kotak Dialog.
Font
 Menampilkan kotak dialog di mana pengguna dapat memilih keluarga font dan gaya font terkait, ukuran titik, dan atribut font lainnya seperti warna font, garis bawah, atau coretan. Gunakan fungsiChooseFont dan strukturCHOOSEFONT. Untuk informasi selengkapnya, lihat Kotak Dialog Font.
Buka
 Menampilkan kotak dialog tempat pengguna dapat mengetik atau memilih nama file atau objek spasi nama shell untuk dibuka. Kotak dialog menyertakan daftar drive, direktori, dan ekstensi ruang nama shell yang memungkinkan pengguna menelusuri ruang nama shell. Ini juga mencakup daftar ekstensi nama file yang memungkinkan pengguna untuk memfilter nama file yang ditampilkan. Gunakan fungsiGetOpenFileName dan strukturOPENFILENAME. Untuk informasi selengkapnya, lihat Buka dan Simpan Sebagai Kotak Dialog.
Penyetelan Halaman
 Menampilkan konfigurasi halaman saat ini. Pengguna dapat memilih opsi konfigurasi halaman, seperti orientasi kertas, ukuran, sumber, dan margin. Gunakan fungsiPageSetupDlg dan strukturPAGESETUPDLG. Untuk informasi selengkapnya, lihat Kotak Dialog Penyetelan Halaman .
Cetak
 Menampilkan informasi tentang pencetak yang terinstal dan konfigurasinya. Pengguna dapat memilih opsi tugas cetak, seperti rentang halaman yang akan dicetak dan jumlah salinan, dan memulai proses pencetakan. Gunakan fungsiPrintDlg dan strukturPRINTDLG. Untuk informasi selengkapnya, lihat Cetak Kotak Dialog.
Untuk menampilkan lembar properti Cetak daripada kotak dialog Cetak, gunakan fungsiPrintDlgEx dengan strukturPRINTDLGEX. Halaman Umum lembar properti mirip dengan kotak dialog Cetak. Lembar properti dapat memiliki halaman properti khusus aplikasi dan khusus driver tambahan setelah halaman Umum. Untuk informasi selengkapnya, lihat Cetak Lembar Properti.
Ganti
 Menampilkan kotak dialog di mana pengguna dapat mengetik string untuk ditemukan dan string pengganti. Pengguna dapat menentukan opsi pencarian, seperti apakah pencarian peka huruf besar/kecil, dan opsi penggantian, seperti cakupan penggantian. Gunakan fungsiReplaceText dan strukturFINDREPLACE. Untuk informasi selengkapnya, lihat Temukan dan Ganti Kotak Dialog.
Simpan Sebagai
 Menampilkan kotak dialog tempat pengguna dapat mengetik atau memilih nama untuk menyimpan file atau objek spasi nama shell. Kotak dialog menyertakan daftar drive, direktori, dan ekstensi ruang nama shell yang memungkinkan pengguna menelusuri ruang nama shell. Ini juga mencakup daftar ekstensi nama file yang memungkinkan pengguna untuk memfilter nama file yang ditampilkan. Gunakan fungsiGetSaveFileName dan strukturOPENFILENAME. Untuk informasi selengkapnya, lihat Buka dan Simpan Sebagai Kotak Dialog.

Meskipun kotak dialog Penyetelan Cetak tersedia, kotak dialog telah digantikan oleh kotak dialog Penyetelan Halaman. Aplikasi harus menggunakan kotak dialog Penyetelan Halaman daripada kotak dialog Penyetelan Cetak.

Semua kotak dialog umum bersifat modal, kecuali kotak dialog Temukan dan Ganti. Kotak dialog modal harus ditutup oleh pengguna sebelum fungsi yang digunakan untuk membuat kotak dialog dapat kembali. Kotak dialog Temukan dan Ganti tidak memiliki mode; fungsi kembali sebelum kotak dialog ditutup. Jika Anda menggunakan kotak dialog Temukan dan Ganti, Anda juga harus menggunakan fungsiIsDialogMessage dalam perulangan pesan utama aplikasi Anda untuk memastikan bahwa kotak dialog ini memproses input keyboard dengan benar, seperti tombol TAB dan ESC.