Referensi Kontrol Umum
Bagian ini berisi informasi referensi tentang elemen pemrograman yang berlaku untuk beberapa kontrol, bukan hanya untuk kontrol tertentu. Ada fungsi, makro, pesan, pemberitahuan, dan struktur yang didukung sebagian besar kontrol. Misalnya, sebagian besar kontrol menggunakan pemberitahuan NM_HOVER untuk memproses klik mouse.
- Gambaran Umum
- Functions
- Makro
- Pesan
- Pemberitahuan
- Struktur
- Konstanta
Ikhtisar
| Topik | Isi |
|---|---|
| Tentang Kontrol Umum | Kontrol umum adalah sekumpulan jendela yang diimplementasikan oleh pustaka kontrol umum, yang merupakan DLL yang disertakan dengan sistem operasi Windows. |
| Tanya Jawab Umum Common Controls | FAQ ini memberikan jawaban atas beberapa pertanyaan umum tentang kontrol umum. |
Fungsi
| Topik | Isi |
|---|---|
| DoReaderMode | Mengaktifkan mode pembaca di jendela. |
| DPA_Clone | Menduplikasi array penunjuk dinamis (DPA). |
| DPA_Create | Membuat DPA. |
| DPA_CreateEx | Membuat DPA menggunakan ukuran dan lokasi timbunan tertentu. |
| DPA_DeleteAllPtrs | Menghapus semua item dari DPA dan menyusutkan DPA yang sesuai. |
| DPA_DeletePtr | Menghapus item dari DPA. DPA menyusut jika perlu untuk mengakomodasi item yang dihapus. |
| DPA_Destroy | Membebaskan Dynamic Pointer Array (DPA). |
| DPA_DestroyCallback | Panggilan pfnCB pada setiap elemen DPA, lalu membebaskan DPA. |
| DPA_EnumCallback | Melakukan iterasi melalui Dynamic Pointer Array (DPA) dan memanggil pfnCB pada setiap item. |
| DPA_GetPtr | Mendapatkan item dari DPA. |
| DPA_GetPtrIndex | Mendapatkan indeks item yang cocok yang ditemukan dalam DPA. |
| DPA_GetSize | Mendapatkan ukuran DPA. |
| DPA_Grow | Mengubah jumlah pointer dalam DPA. |
| DPA_InsertPtr | Menyisipkan item baru pada posisi yang ditentukan dalam DPA. Jika perlu, DPA akan diperluas untuk mengakomodasi item baru. |
| DPA_LoadStream | Memuat DPA dari aliran dengan memanggil fungsi panggilan balik yang ditentukan untuk membaca setiap elemen. |
| DPA_Merge | Menggabungkan konten dua DPU. |
| DPA_SaveStream | Menyimpan DPA ke aliran dengan menulis header, lalu memanggil fungsi panggilan balik yang ditentukan untuk menulis setiap elemen. |
| DPA_Search | Menemukan item dalam DPA. |
| DPA_SetPtr | Menetapkan nilai ke item dalam DPA. |
| DPA_Sort | Mengurutkan item dalam Array Penunjuk Dinamis (DPA). |
| DrawShadowText | Menggambar teks yang memiliki bayangan. |
| DrawTextExPrivWrap | Gambar teks yang diformat dalam persegi panjang yang ditentukan. Fungsi ini membungkus panggilan ke DrawTextEx. |
| DrawTextWrap | Gambar teks yang diformat dalam persegi panjang yang ditentukan. Ini memformat teks sesuai dengan metode yang ditentukan (memperluas tab, membenarkan karakter, garis putus, dan sebagainya). Fungsi ini membungkus panggilan ke DrawText. |
| DSA_Clone | Menduplikasi array struktur dinamis (DSA). |
| DSA_Create | Membuat DSA. |
| DSA_DeleteAllItems | Menghapus semua item dari DSA. |
| DSA_DeleteItem | Menghapus item dari DSA. |
| DSA_Destroy | Membebaskan DSA. |
| DSA_DestroyCallback | Melakukan iterasi melalui DSA, memanggil fungsi panggilan balik tertentu pada setiap item. Setelah mencapai akhir array, DSA dibebaskan. |
| DSA_EnumCallback | Melakukan iterasi melalui DSA dan panggilan pfnCB pada setiap item. |
| DSA_GetItem | Mendapatkan elemen dari DSA. |
| DSA_GetItemPtr | Mendapatkan pointer ke elemen dari DSA. |
| DSA_GetSize | Mendapatkan ukuran DSA. |
| DSA_InsertItem | Menyisipkan item baru ke DSA. Jika perlu, DSA diperluas untuk mengakomodasi item baru. |
| DSA_SetItem | Mengatur konten elemen dalam DSA. |
| DSA_Sort | Mengurutkan item dalam DSA. |
| ExtTextOutWrap | Gambar teks menggunakan font, warna latar belakang, dan warna teks yang saat ini dipilih. Anda dapat secara opsional menyediakan dimensi yang akan digunakan untuk kliping, keburaman, atau keduanya. Fungsi ini membungkus panggilan ke ExtTextOut. |
| getEffectiveClientRect | Menghitung dimensi persegi panjang di area klien yang berisi semua kontrol yang ditentukan. |
| GetMUILanguage | Mendapatkan bahasa yang saat ini digunakan oleh kontrol umum untuk proses tertentu. |
| GetTextExtentPoint32Wrap | Menghitung lebar dan tinggi string teks yang ditentukan. Fungsi ini membungkus panggilan ke GetTextExtentPoint. |
| InitCommonControls | Mendaftarkan dan menginisialisasi kelas jendela kontrol umum tertentu. Fungsi ini usang. Aplikasi baru harus menggunakan fungsiInitCommonControlsEx. |
| InitCommonControlsEx | Mendaftarkan kelas kontrol umum tertentu dari DLL kontrol umum. |
| InitMUILanguage | Memungkinkan aplikasi menentukan bahasa yang akan digunakan dengan kontrol umum yang berbeda dari bahasa sistem. |
| LoadIconMetric | Memuat sumber daya ikon tertentu dengan metrik sistem yang ditentukan klien. |
| LoadIconWithScaleDown | Memuat ikon. Jika ikon bukan ukuran standar, fungsi ini menurunkan skala gambar yang lebih besar alih-alih meningkatkan gambar yang lebih kecil. |
| MirrorIcon | Membalikkan ikon (cermin) sehingga ditampilkan dengan benar pada konteks perangkat cermin. |
| PFNDACOMPARE | Menentukan prototipe untuk fungsi perbandingan yang digunakan oleh DSA_Sort. |
| PFNDACOMPARECONST | Menentukan prototipe untuk fungsi perbandingan yang digunakan oleh DSA_Sort ketika item yang dibandingkan adalah objek konstan. |
| PFNDAENUMCALLBACK | Menentukan prototipe untuk fungsi panggilan balik yang digunakan oleh fungsi DSA dan DPA. |
| PFNDAENUMCALLBACKCONST | Menentukan prototipe untuk fungsi panggilan balik yang digunakan oleh fungsi DSA dan DPA ketika item yang terlibat adalah penunjuk ke data konstanta. |
| PFNDPACOMPARE | Menentukan prototipe untuk fungsi perbandingan yang digunakan oleh DPA_Sort dan DPA_Search. |
| PFNDPACOMPARECONST | Menentukan prototipe untuk fungsi perbandingan yang digunakan oleh DPA_Sort atau DPA_Search ketika item yang dibandingkan adalah objek konstan. |
| PFNDPAENUMCALLBACK | Menentukan prototipe untuk fungsi panggilan balik yang digunakan oleh DPA_EnumCallback. |
| PFNDPAMERGE | Menentukan prototipe untuk fungsi penggabungan yang digunakan oleh DPA_Merge. |
| PFNDPAMERGECONST | Menentukan prototipe untuk fungsi penggabungan yang digunakan oleh DPA_Merge, menggunakan nilai konstanta. |
| PFNDPASTREAM | Menentukan prototipe untuk fungsi panggilan balik yang digunakan oleh DPA_LoadStream dan DPA_SaveStream. |
| PFNDSAENUMCALLBACK | Menentukan prototipe untuk fungsi panggilan balik yang digunakan oleh DSA_DestroyCallback. |
| ReaderScroll | Fungsi panggilan balik yang ditentukan aplikasi yang digunakan ketika penunjuk mouse dipindahkan dalam bagian jendela mode pembaca yang telah dinyatakan sebagai area gulir aktif. |
| ShowHideMenuCtl | Mengatur atau menghapus atribut tanda centang item menu yang ditentukan dan memperlihatkan atau menyembunyikan kontrol yang sesuai. Fungsi menambahkan tanda centang ke item menu yang ditentukan jika tidak memilikinya lalu menampilkan kontrol yang sesuai. Jika item menu sudah memiliki tanda centang, fungsi akan menghapus tanda centang dan menyembunyikan kontrol yang sesuai. |
| Str_GetPtr | Menyalin string dari satu buffer ke buffer lainnya. |
| Str_SetPtrW | Mengatur ppszCurrent ke salinan pszNew dan membebaskan nilai sebelumnya, jika perlu. |
| TranslateDispatch | Digunakan oleh klienfungsiDoReaderMode untuk mencegat dan secara eksplisit menangani pesan jendela apa pun yang ditargetkan untuk area gulir jendela mode pembaca. Ini adalah fungsi panggilan balik yang ditentukan aplikasi. |
Macro
| Topik | Isi |
|---|---|
| DPA_AppendPtr | Menyisipkan item baru di akhir DPA. |
| DPA_FastDeleteLastPtr | Menghapus penunjuk terakhir dari DPA. |
| DPA_FastGetPtr | Mendapatkan nilai pointer yang ditentukan dalam DPA. |
| DPA_GetPtrCount | Mendapatkan jumlah pointer dalam DPA. |
| DPA_GetPtrPtr | Mendapatkan penunjuk ke array penunjuk internal DPA. |
| DPA_SetPtrCount | Mengatur jumlah pointer dalam DPA. |
| DPA_SortedInsertPtr | Sisipkan item baru sebelum atau sesudah item yang sudah ditentukan. |
| DSA_AppendItem | Menambahkan item baru ke akhir DSA. |
| DSA_GetItemCount | Mendapatkan jumlah item dalam DSA. |
| FORWARD_WM_NOTIFY | Mengirim atau memposting pesan WM_NOTIFY. |
| HANDLE_WM_NOTIFY | Memanggil fungsi yang memproses pesan WM_NOTIFY. |
| INDEXTOSTATEIMAGEMASK | Menyiapkan indeks gambar status sehingga kontrol tampilan pohon atau kontrol tampilan daftar dapat menggunakan indeks untuk mengambil gambar status untuk item. |
Pesan
| Topik | Isi |
|---|---|
| CCM_DPISCALE | Mengaktifkan penskalaan titik tinggi otomatis per inci (dpi) dalam kontrol Tree-View, kontrol List-View, kontrol ComboBoxEx, Header, Tombol , Kontrol Toolbar, kontrol Animasi , dan Daftar Gambar . |
| CCM_GETUNICODEFORMAT | Mendapatkan bendera format karakter Unicode untuk kontrol. |
| CCM_GETVERSION | Mendapatkan nomor versi untuk kontrol yang ditetapkan oleh pesan CCM_SETVERSION terbaru. |
| CCM_SETUNICODEFORMAT | Mengatur bendera format karakter Unicode untuk kontrol. Pesan ini memungkinkan Anda mengubah kumpulan karakter yang digunakan oleh kontrol pada waktu proses daripada harus membuat ulang kontrol. |
| CCM_SETVERSION | Pesan ini digunakan untuk menginformasikan kontrol bahwa Anda mengharapkan perilaku yang terkait dengan versi tertentu. |
| CCM_SETWINDOWTHEME | Mengatur gaya visual kontrol. |
| WM_NOTIFY | Dikirim oleh kontrol umum ke jendela induknya ketika suatu peristiwa telah terjadi atau kontrol memerlukan beberapa informasi. |
| WM_NOTIFYFORMAT | Menentukan apakah jendela menerima struktur ANSI atau Unicode dalam pesan pemberitahuan WM_NOTIFY.
WM_NOTIFYFORMAT pesan dikirim dari kontrol umum ke jendela induknya dan dari jendela induk ke kontrol umum. |
Pemberitahuan
| Topik | Isi |
|---|---|
| NM_CHAR | Kode pemberitahuan NM_CHAR dikirim oleh kontrol saat kunci karakter diproses. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_CUSTOMDRAW | Memberi tahu jendela induk kontrol tentang operasi gambar kustom. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_CUSTOMTEXT | Memberi tahu jendela induk kontrol tentang operasi teks kustom. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_FONTCHANGED | Dikirim oleh kontrol tampilan daftar ketika kontrol telah mengubah font. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_GETCUSTOMSPLITRECT | Dikirim oleh kontrol tombol ke induknya untuk mendapatkan pengukuran untuk dua persegi panjang yang membentuk tombol pisahkan. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_HOVER | Dikirim oleh kontrol ketika mouse mengarahkan kursor ke item. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_KEYDOWN | Dikirim oleh kontrol saat kontrol memiliki fokus keyboard dan pengguna menekan tombol. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_KILLFOCUS | Memberi tahu jendela induk kontrol bahwa kontrol telah kehilangan fokus input. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_LDOWN | Memberi tahu jendela induk kontrol bahwa tombol mouse kiri telah ditekan. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_NCHITTEST | Dikirim oleh kontrol bilah ulang saat kontrol menerima pesan WM_NCHITTEST. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_OUTOFMEMORY | Memberi tahu jendela induk kontrol bahwa kontrol tidak dapat menyelesaikan operasi karena tidak tersedia cukup memori. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_RDOWN | Saat ini tidak didukung. |
| NM_RELEASEDCAPTURE | Memberi tahu jendela induk kontrol bahwa kontrol melepaskan pengambilan mouse. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_RETURN | Memberi tahu jendela induk kontrol bahwa kontrol memiliki fokus input dan bahwa pengguna telah menekan tombol ENTER. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_SETCURSOR | Memberi tahu jendela induk kontrol bahwa kontrol mengatur kursor sebagai respons terhadap pesan NM_SETCURSOR. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_SETFOCUS | Memberi tahu jendela induk kontrol bahwa kontrol telah menerima fokus input. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_THEMECHANGED | Memberi tahu jendela induk kontrol bahwa tema telah berubah. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_TOOLTIPSCREATED | Memberi tahu jendela induk kontrol bahwa kontrol telah membuat kontrol tipsalat. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_TVSTATEIMAGECHANGING | Dikirim oleh kontrol tampilan pohon ke jendela induknya yang mengubah gambar status. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
Struktur
| Topik | Isi |
|---|---|
| COLORSCHEME | Berisi informasi untuk gambar tombol di bilah alat atau bilah-ulang. |
| DPASTREAMINFO | Berisi item aliran yang digunakan oleh fungsi panggilan balik PFNDPASTREAM. |
| INITCOMMONCONTROLSEX | Membawa informasi yang digunakan untuk memuat kelas kontrol umum dari pustaka tautan dinamis (DLL). Struktur ini digunakan dengan fungsiInitCommonControlsEx. |
| NMCHAR | Berisi informasi yang digunakan dengan pesan pemberitahuan karakter. |
| NMCUSTOMSPLITRECTINFO | Berisi informasi tentang dua persegi panjang tombol terpisah. Dikirim dengan pemberitahuan NM_GETCUSTOMSPLITRECT. |
| NMCUSTOMTEXT | Berisi informasi yang digunakan dengan pemberitahuan teks kustom. |
| NMHDR | Berisi informasi tentang pesan pemberitahuan. |
| NMKEY | Berisi informasi yang digunakan dengan pesan pemberitahuan utama. |
| NMMOUSE | Berisi informasi yang digunakan dengan pesan pemberitahuan mouse. |
| NMOBJECTNOTIFY | Berisi informasi yang digunakan dengan kode pemberitahuan TBN_GETOBJECT, TCN_GETOBJECT, dan PSN_GETOBJECT. |
| NMTOOLTIPSCREATED | Berisi informasi yang digunakan dengan kode pemberitahuan NM_TOOLTIPSCREATED. |
| READERMODEINFO | Berisi informasi yang diperlukan untuk menginisialisasi fungsiDoReaderMode. |
Konstanta
| Topik | Isi |
|---|---|
| Konstanta CDRF | Konstanta ini digunakan sebagai nilai pengembalian oleh kontrol sebagai respons terhadap kode pemberitahuan NM_CUSTOMDRAW. |
| Gaya | Bagian ini mencantumkan gaya kontrol umum. Kecuali jika dicatat, gaya ini berlaku untuk kontrol header, kontrol toolbar, dan jendela status. |
| Kelas Jendela | Bagian ini mencantumkan nama kelas jendela yang disediakan oleh pustaka kontrol umum. |