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 Pencetakan, Penyetelan Cetak, Lembar Properti Cetak, dan Penyetelan 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 mengubah perilaku dan tampilan kotak dialog umum. |
| Mengkustomisasi 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 set 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 dengan fungsiPageSetupDlg. |
| PrintDlg | MenampilkanKotak Dialog Cetak. Kotak dialog Cetak memungkinkan pengguna menentukan properti pekerjaan cetak tertentu. |
| PrintDlgEx | Menampilkan lembar properti Cetak yang memungkinkan pengguna menentukan properti tugas cetak tertentu. Lembar propertiCetakmemiliki 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 hook 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 memungkinkan 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 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, bisa 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. |
Pemberitahuan
| Nama | Deskripsi |
|---|---|
| CDN_FILEOK | Dikirim oleh kotak dialog Buka atau Simpan Sebagai gaya Explorer saat pengguna menentukan nama file dan mengklik tombol OK . |
| CDN_FOLDERCHANGE | Dikirim oleh kotak dialog Buka atau Simpan Sebagai gaya Explorer saat folder baru dibuka. |
| CDN_HELP | Dikirim oleh kotak dialog Buka atau Simpan Sebagai gaya Explorer 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 di 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 Explorer 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 Explorer 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 Explorer 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 tipe file baru dari kotak kombo tipe file. |
| COLOROKSTRING | Kotak dialog Warna mengirimkan pesan terdaftar COLOROKSTRING ke prosedur kait Anda, CCHookProc, saat pengguna memilih warna dan mengklik tombol OK . Prosedur kait dapat menerima warna dan memungkinkan kotak dialog menutup, atau menolak warna dan memaksa kotak dialog untuk tetap terbuka. |
| FILEOKSTRING | Kotak dialog Buka atau Simpan Sebagai mengirimkan pesan terdaftar FILEOKSTRING ke prosedur hook Anda, OFNHookProc, ketika pengguna menentukan nama file dan mengklik tombol OK . Prosedur hook dapat menerima nama file dan memperbolehkan kotak dialog ditutup, atau menolak nama file dan memaksa kotak dialog untuk 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 ketika pengguna mengklik tombol Bantuan . |
| LBSELCHSTRING | Kotak dialog Buka atau Simpan Sebagai mengirimkan pesan terdaftar LBSELCHSTRING ke prosedur hook Anda saat pilihan berubah dalam salah satu kotak daftar atau kotak kombo dari kotak dialog. |
| SHAREVISTRING | Kotak dialog Buka atau Simpan Sebagai mengirimkan pesan terdaftar SHAREVISTRING ke prosedur hook 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 amplop-stempel dari halaman sampel. |
| WM_PSD_FULLPAGERECT | Memberi tahu prosedur hook PagePaintHook tentang koordinat persegi halaman sampel dalam kotak dialog Penyetelan Halaman . Kotak dialog mengirimkan pesan ini saat 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 dari halaman sampel. |
| WM_PSD_MINMARGINRECT | Memberi tahu prosedur hook PagePaintHook tentang koordinat persegi 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. |
| FINDREPLACE | 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 tugas cetak. Pekerjaan cetak dapat memiliki lebih dari satu rentang halaman. Informasi ini disediakan dalam struktur PRINTDLGEX saat memanggil fungsi PrintDlgEx . |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk