Pustaka Kotak Dialog Umum
Pustaka Kotak Dialog Umum berisi sekumpulan kotak dialog untuk melakukan tugas aplikasi umum, seperti membuka file, memilih nilai warna, dan mencetak dokumen. Kotak dialog umum memungkinkan Anda menerapkan pendekatan yang konsisten ke antarmuka pengguna aplikasi Anda. Ini mengurangi jumlah upaya yang dihabiskan pengguna dalam mempelajari perilaku antarmuka pengguna untuk aplikasi Anda.
Bagian ini menjelaskan kotak dialog umum yang menyertakan kotak dialog Buka dan Simpan Sebagai file; kotak dialog Temukan dan Ganti pengeditan; kotak dialog Cetak, Penyetelan Cetak, Cetak Lembar Properti, dan Pencetakan Halaman ; dan kotak dialog Warna dan Font .
Catatan
Dimulai dengan Windows Vista, kotak dialog Buka dan Simpan Sebagai umum telah digantikan oleh Dialog Item Umum. Kami menyarankan agar Anda menggunakan API Dialog Item Umum alih-alih kotak dialog ini dari Pustaka Kotak Dialog Umum.
Di Bagian Ini
| Nama | Deskripsi |
|---|---|
| Tipe Kotak Dialog Umum | Membahas kotak dialog yang berbeda. |
| Bendera Inisialisasi Kotak Dialog Umum | Membahas bagaimana bendera digunakan untuk memodifikasi perilaku dan tampilan kotak dialog umum. |
| Menyesuaikan Kotak Dialog Umum | Membahas cara menggunakan kotak dialog umum. |
| Menggunakan Kotak Dialog Umum | Mencakup tugas yang memanggil kotak dialog umum. |
| Referensi Kotak Dialog Umum | Berisi referensi API. |
Fungsi
| Nama | Deskripsi |
|---|---|
| CCHookProc | Menerima pesan atau pemberitahuan yang ditujukan untuk prosedur kotak dialog default kotak dialog Warna . Ini adalah fungsi panggilan balik yang ditentukan aplikasi atau yang ditentukan pustaka yang digunakan dengan fungsi ChooseColor. |
| CFHookProc | Menerima pesan atau pemberitahuan yang ditujukan untuk prosedur kotak dialog default kotak dialog Font . Ini adalah prosedur panggilan balik yang ditentukan aplikasi atau yang ditentukan pustaka yang digunakan dengan fungsi ChooseFont. |
| Pilih Warna | Membuat kotak dialog Warna yang memungkinkan pengguna memilih warna. |
| PilihFont | Membuat kotak dialog Font yang memungkinkan pengguna memilih atribut untuk font logis. Atribut ini mencakup keluarga font dan gaya font terkait, ukuran titik, efek (garis bawah, coretan, dan warna teks), dan skrip (atau kumpulan karakter). |
| CommDlgExtendedError | Mengembalikan kode kesalahan kotak dialog umum. Kode ini menunjukkan kesalahan terbaru yang terjadi selama eksekusi salah satu fungsi kotak dialog umum. |
| FindText | Membuat kotak dialog Temukan tanpa mode yang ditentukan sistem yang memungkinkan pengguna menentukan string untuk mencari opsi dan yang akan digunakan saat mencari teks dalam dokumen. |
| FRHookProc | Menerima pesan atau pemberitahuan yang ditujukan untuk prosedur kotak dialog default kotak dialog Temukan atau Ganti . Ini adalah fungsi panggilan balik yang ditentukan aplikasi atau yang ditentukan pustaka yang digunakan dengan fungsi FindText atau ReplaceText. |
| GetFileTitle | Mengambil nama file yang ditentukan. |
| GetOpenFileName | Membuat kotak dialog Buka yang memungkinkan pengguna menentukan drive, direktori, dan nama file atau sekumpulan file untuk dibuka. |
| GetSaveFileName | Membuat kotak dialog Simpan yang memungkinkan pengguna menentukan drive, direktori, dan nama file untuk disimpan. |
| OFNHookProc | Menerima pesan pemberitahuan yang dikirim dari kotak dialog. Fungsi ini juga menerima pesan untuk kontrol tambahan apa pun yang Anda tentukan dengan menentukan templat dialog anak. Ini adalah fungsi panggilan balik yang ditentukan aplikasi atau yang ditentukan pustaka yang digunakan dengan kotak dialog Buka dan Simpan Sebagai gaya Penjelajah. |
| OFNHookProcOldStyle | Menerima pesan atau pemberitahuan yang ditujukan untuk prosedur kotak dialog. Ini adalah fungsi panggilan balik yang ditentukan aplikasi atau yang ditentukan pustaka yang digunakan dengan kotak dialog Buka dan Simpan Sebagai . |
| PagePaintHook | Menerima pesan yang memungkinkan Anda mengkustomisasi gambar halaman sampel dalam kotak dialog Penyetelan Halaman. Ini adalah fungsi panggilan balik yang ditentukan aplikasi atau yang ditentukan pustaka yang digunakan dengan fungsi PageSetupDlg. |
| PageSetupDlg | Membuat kotak dialog Penyetelan Halaman yang memungkinkan pengguna menentukan atribut halaman cetak. Atribut ini mencakup ukuran dan sumber kertas, orientasi halaman (potret atau lanskap), dan lebar margin halaman. |
| PageSetupHook | Menerima pesan atau pemberitahuan yang ditujukan untuk prosedur kotak dialog default kotak dialog Penyetelan Halaman. Ini adalah fungsi panggilan balik yang ditentukan aplikasi atau yang ditentukan pustaka yang digunakan denganfungsi PageSetupDlg. |
| PrintDlg | Menampilkan Kotak Dialog Cetak. Kotak dialog Cetak memungkinkan pengguna menentukan properti pekerjaan cetak tertentu. |
| PrintDlgEx | Menampilkan lembar properti Cetak yang memungkinkan pengguna menentukan properti pekerjaan cetak tertentu. Lembarproperti Cetakmemiliki halaman Umum yang berisi kontrol yang mirip dengan kotak dialog Cetak. Lembar properti juga dapat memiliki halaman properti khusus aplikasi dan driver tambahan serta halaman Umum . |
| PrintHookProc | Menerima pesan atau pemberitahuan yang ditujukan untuk prosedur kotak dialog default kotak dialog Cetak . Ini adalah fungsi panggilan balik yang ditentukan aplikasi atau yang ditentukan pustaka yang digunakan dengan fungsi PrintDlg. |
| ReplaceText | Membuat kotak dialog tanpa mode yang ditentukan sistem yang memungkinkan pengguna menentukan string untuk dicari dan string pengganti, serta opsi untuk mengontrol operasi temukan dan ganti. |
| SetupHookProc | Fungsi panggilan balik yang ditentukan aplikasi atau yang ditentukan pustaka yang digunakan dengan fungsi PrintDlg. Prosedur kait menerima pesan atau pemberitahuan yang ditujukan untuk prosedur kotak dialog default kotak dialog Penyetelan Cetak. |
Antarmuka
| Nama | Deskripsi |
|---|---|
| IPrintDialogCallback | Menyediakan metode yang memungkinkan aplikasi menerima pemberitahuan dan pesan dari fungsi PrintDlgEx saat Lembar Properti Cetak ditampilkan. |
| IPrintDialogServices | Menyediakan metode yang mengaktifkan aplikasi menggunakan fungsi PrintDlgEx untuk mengambil informasi tentang printer yang saat ini dipilih. |
Pesan
| Nama | Deskripsi |
|---|---|
| CDM_GETFILEPATH | Mengambil jalur dan nama file file yang dipilih dalam kotak dialog Buka atau Simpan Sebagai gaya Penjelajah. Kotak dialog harus dibuat dengan bendera OFN_EXPLORER; jika tidak, pesan gagal. |
| CDM_GETFOLDERIDLIST | Mengambil alamat daftar pengidentifikasi item yang terkait dengan folder yang saat ini dibuka oleh kotak dialog Buka atau Simpan Sebagai Sebagai gaya Penjelajah. Kotak dialog harus dibuat dengan bendera OFN_EXPLORER ; jika tidak, pesan gagal. |
| CDM_GETFOLDERPATH | Mengambil jalur folder atau direktori yang saat ini terbuka untuk kotak dialog Buka atau Simpan Sebagai gaya Penjelajah. Kotak dialog harus dibuat dengan bendera OFN_EXPLORER ; jika tidak, pesan gagal. |
| CDM_GETSPEC | Mengambil nama file (tidak termasuk jalur) dari file yang saat ini dipilih dalam kotak dialog Buka atau Simpan Sebagai Gaya Penjelajah. Kotak dialog harus dibuat dengan bendera OFN_EXPLORER ; jika tidak, pesan gagal. |
| CDM_HIDECONTROL | Menyembunyikan kontrol yang ditentukan dalam kotak dialog Buka atau Simpan Sebagai Gaya Penjelajah. Kotak dialog harus dibuat dengan bendera OFN_EXPLORER ; jika tidak, pesan gagal. |
| CDM_SETCONTROLTEXT | Mengatur teks untuk kontrol yang ditentukan dalam kotak dialog Buka atau Simpan Sebagai gaya Penjelajah. Kotak dialog harus dibuat dengan bendera OFN_EXPLORER ; jika tidak, pesan gagal. |
| CDM_SETDEFEXT | Mengatur ekstensi nama file default untuk kotak dialog Buka atau Simpan Sebagai gaya Penjelajah. Kotak dialog harus dibuat dengan bendera OFN_EXPLORER ; jika tidak, pesan gagal. |
| SETRGBSTRING | Prosedur kait kotak dialog Warna, CCHookProc, dapat mengirim pesan terdaftar SETRGBSTRING ke kotak dialog untuk mengatur pilihan warna saat ini. |
| WM_CHOOSEFONT_GETLOGFONT | Aplikasi mengirim pesan WM_CHOOSEFONT_GETLOGFONT ke kotak dialog Font untuk mengambil informasi tentang pilihan font pengguna saat ini. |
| WM_CHOOSEFONT_SETFLAGS | Aplikasi mengirim pesan WM_CHOOSEFONT_SETFLAGS ke kotak dialog Font untuk mengatur opsi tampilan untuk kotak dialog. |
| WM_CHOOSEFONT_SETLOGFONT | Aplikasi mengirim pesan WM_CHOOSEFONT_SETLOGFONT ke kotak dialog Font untuk mengatur informasi font logis saat ini. |
Notifications
| Nama | Deskripsi |
|---|---|
| CDN_FILEOK | Dikirim oleh kotak dialog Buka atau Simpan Sebagai gaya Penjelajah saat pengguna menentukan nama file dan mengklik tombol OK. |
| CDN_FOLDERCHANGE | Dikirim oleh kotak dialog Buka atau Simpan Sebagai gaya Penjelajah saat folder baru dibuka. |
| CDN_HELP | Dikirim oleh kotak dialog Buka atau Simpan Sebagai gaya Penjelajah saat pengguna mengklik tombol Bantuan. |
| CDN_INCLUDEITEM | Dikirim oleh kotak dialog Buka atau Simpan Sebagai untuk menentukan apakah kotak dialog harus menampilkan item dalam daftar item folder shell. Saat pengguna membuka folder, kotak dialog mengirimkan pemberitahuan CDN_INCLUDEITEM untuk setiap item dalam folder. Kotak dialog mengirimkan pemberitahuan ini hanya jika bendera OFN_ENABLEINCLUDENOTIFY diatur saat kotak dialog dibuat. |
| CDN_INITDONE | Dikirim oleh kotak dialog Buka atau Simpan Sebagai gaya Penjelajah ketika sistem telah selesai mengatur kontrol dalam kotak dialog. Sistem memindahkan kontrol standar untuk memberi ruang bagi kontrol kotak dialog anak. |
| CDN_SELCHANGE | Dikirim oleh kotak dialog Buka atau Simpan Sebagai gaya Penjelajah saat pilihan berubah dalam kotak daftar yang menampilkan konten folder atau direktori yang saat ini dibuka. |
| CDN_SHAREVIOLATION | Dikirim oleh kotak dialog Buka atau Simpan Sebagai gaya Penjelajah saat pengguna mengklik tombol OK dan pelanggaran berbagi jaringan terjadi untuk file yang dipilih. |
| CDN_TYPECHANGE | Dikirim oleh kotak dialog Buka atau Simpan Sebagai gaya Penjelajah saat pengguna memilih jenis file baru dari kotak kombo tipe file. |
| COLOROKSTRING | Kotak dialog Warna mengirimkan pesan terdaftar COLOROKSTRING ke prosedur kait Anda, CCHookProc, ketika pengguna memilih warna dan mengklik tombol OK. Prosedur kait dapat menerima warna dan memungkinkan kotak dialog menutup, atau menolak warna dan memaksa kotak dialog tetap terbuka. |
| FILEOKSTRING | Kotak dialog Buka atau Simpan Sebagai mengirimkan pesan terdaftar FILEOKSTRING ke prosedur kait Anda, OFNHookProc, ketika pengguna menentukan nama file dan mengklik tombol OK. Prosedur kait dapat menerima nama file dan mengizinkan kotak dialog untuk menutup, atau menolak nama file dan memaksa kotak dialog tetap terbuka. |
| FINDMSGSTRING | Kotak dialog Temukan atau Ganti mengirimkan pesan terdaftar FINDMSGSTRING ke prosedur jendela jendela pemiliknya saat pengguna mengklik tombol Temukan Berikutnya, Ganti, atau Ganti Semua, atau menutup kotak dialog. |
| HELPMSGSTRING | Kotak dialog umum mengirimkan pesan terdaftar HELPMSGSTRING ke prosedur jendela jendela pemiliknya saat pengguna mengklik tombol Bantuan. |
| LBSELCHSTRING | Kotak dialog Buka atau Simpan Sebagai mengirimkan pesan terdaftar LBSELCHSTRING ke prosedur kait Anda saat pilihan berubah dalam salah satu kotak daftar atau kotak kombo kotak dialog. |
| SHAREVISTRING | Kotak dialog Buka atau Simpan Sebagai mengirimkan pesan terdaftar SHAREVISTRING ke prosedur kait Anda, OFNHookProc, jika pelanggaran berbagi terjadi untuk file yang dipilih saat pengguna mengklik tombol OK. |
| WM_PSD_ENVSTAMPRECT | Memberi tahu prosedur kait kotak dialog Penyetelan Halaman, PagePaintHook, bahwa kotak dialog akan menggambar persegi panjang stempel amplop dari halaman sampel. |
| WM_PSD_FULLPAGERECT | Memberi tahu prosedur hook PagePaintHook tentang koordinat persegi panjang halaman sampel dalam kotak dialog Penyetelan Halaman. Kotak dialog mengirimkan pesan ini ketika akan menggambar isi halaman sampel. |
| WM_PSD_GREEKTEXTRECT | Memberi tahu prosedur kait kotak dialog Penyetelan Halaman, PagePaintHook, bahwa kotak dialog akan menggambar teks Yunani di dalam persegi margin halaman sampel. |
| WM_PSD_MARGINRECT | Memberi tahu prosedur kait kotak dialog Penyetelan Halaman, PagePaintHook, bahwa kotak dialog akan menggambar persegi margin halaman sampel. |
| WM_PSD_MINMARGINRECT | Memberi tahu prosedur hook PagePaintHook tentang koordinat persegi panjang margin di halaman sampel. Kotak dialog Penyetelan Halaman mengirimkan pesan ini ketika akan menggambar isi halaman sampel. |
| WM_PSD_PAGESETUPDLG | Memberi tahu prosedur hook PagePaintHook bahwa kotak dialog Penyetelan Halaman akan menggambar konten halaman sampel. Prosedur kait dapat menggunakan pesan ini untuk melakukan tugas inisialisasi yang terkait dengan menggambar konten halaman sampel. |
| WM_PSD_YAFULLPAGERECT | Memberi tahu prosedur kait kotak dialog Penyetelan Halaman, PagePaintHook, bahwa kotak dialog akan menggambar bagian alamat pengirim dari halaman sampel amplop. |
Struktur
| Nama | Deskripsi |
|---|---|
| PILIH WARNA | Berisi informasi yang digunakan fungsi ChooseColor untuk menginisialisasi kotak dialog Warna. Setelah pengguna menutup kotak dialog, sistem mengembalikan informasi tentang pilihan pengguna dalam struktur ini. |
| PILIHFONT | Berisi informasi yang digunakan fungsi ChooseFont untuk menginisialisasi kotak dialog Font. Setelah pengguna menutup kotak dialog, sistem mengembalikan informasi tentang pilihan pengguna dalam struktur ini. |
| DEVNAMES | Berisi string yang mengidentifikasi nama driver, perangkat, dan port output untuk printer. Fungsi PrintDlgEx dan PrintDlg menggunakan string ini untuk menginisialisasi Lembar Properti Cetak yang ditentukan sistem atau Kotak Dialog Cetak. Ketika pengguna menutup lembar properti atau kotak dialog, informasi tentang printer terpilih dikembalikan dalam struktur ini. |
| TEMUKAN TEMPAT | Berisi informasi yang digunakan fungsi FindText dan ReplaceText untuk menginisialisasi kotak dialog Temukan dan Ganti. Pesan terdaftar FINDMSGSTRING menggunakan struktur ini untuk meneruskan input pencarian atau penggantian pengguna ke jendela pemilik kotak dialog Temukan atau Ganti . |
| OFNOTIFY | Ccontains informasi tentang pesan WM_NOTIFY yang dikirim ke prosedur hook OFNHookProc untuk kotak dialog Buka atau Simpan Sebagai. Parameter lParam dari pesan WM_NOTIFY adalah penunjuk ke struktur OFNOTIFY. |
| OFNOTIFYEX | Berisi informasi tentang pesan pemberitahuan CDN_INCLUDEITEM . |
| OPENFILENAME | Berisi informasi yang digunakan fungsi GetOpenFileName dan GetSaveFileName untuk menginisialisasi kotak dialog Buka atau Simpan Sebagai. Setelah pengguna menutup kotak dialog, sistem mengembalikan informasi tentang pilihan pengguna dalam struktur ini. |
| OPENFILENAME_NT4 | Identik dengan OPENFILENAME dengan _WIN32_WINNT diatur ke 0x0400. |
| PAGESETUPDLG | Berisi informasi yang digunakan fungsi PageSetupDlg untuk menginisialisasi kotak dialog Penyetelan Halaman. Setelah pengguna menutup kotak dialog, sistem mengembalikan informasi tentang parameter halaman yang ditentukan pengguna dalam struktur ini. |
| PRINTDLG | Berisi informasi yang digunakan fungsi PrintDlg untuk menginisialisasi Kotak Dialog Cetak. Setelah pengguna menutup kotak dialog, sistem menggunakan struktur ini untuk mengembalikan informasi tentang pilihan pengguna. |
| PRINTDLGEX | Berisi informasi yang digunakan fungsi PrintDlgEx untuk menginisialisasi lembar properti Cetak. Setelah pengguna menutup lembar properti, sistem menggunakan struktur ini untuk mengembalikan informasi tentang pilihan pengguna. |
| PRINTPAGERANGE | Menentukan rentang halaman dalam pekerjaan cetak. Pekerjaan cetak dapat memiliki lebih dari satu rentang halaman. Informasi ini disediakan dalam struktur PRINTDLGEX saat memanggil fungsi PrintDlgEx. |