Daftar Gambar Kontrol Pohon
Setiap item dalam kontrol pohon (CTreeCtrl) dapat memiliki sepasang gambar bitmapped yang terkait dengannya. Gambar muncul di sisi kiri label item. Satu gambar ditampilkan saat item dipilih, dan gambar lainnya ditampilkan saat item tidak dipilih. Misalnya, item mungkin menampilkan folder yang terbuka saat dipilih dan folder tertutup saat tidak dipilih.
Untuk menggunakan gambar item, Anda harus membuat daftar gambar dengan membuat objek CImageList dan menggunakan fungsi CImageList::Create untuk membuat daftar gambar terkait. Kemudian tambahkan bitmap yang diinginkan ke daftar, dan kaitkan daftar dengan kontrol pohon dengan menggunakan fungsi anggota SetImageList . Secara default, semua item menampilkan gambar pertama dalam daftar gambar untuk status yang dipilih dan tidak dipilih. Anda dapat mengubah perilaku default untuk item tertentu dengan menentukan indeks gambar yang dipilih dan tidak dipilih saat menambahkan item ke kontrol pohon menggunakan fungsi anggota InsertItem . Anda dapat mengubah indeks setelah menambahkan item dengan menggunakan fungsi anggota SetItemImage .
Daftar gambar kontrol pohon juga dapat berisi gambar overlay, yang dirancang untuk ditumbuk pada gambar item. Nilai bukan nol dalam bit 8 hingga 11 dari status item kontrol pohon menentukan indeks berbasis satu gambar overlay (0 menunjukkan tidak ada gambar overlay). Karena indeks berbasis satu 4-bit digunakan, gambar overlay harus berada di antara 15 gambar pertama dalam daftar gambar. Untuk informasi selengkapnya tentang status item kontrol pohon, lihat Gambaran Umum Status Item Kontrol Pohon sebelumnya dalam topik ini.
Jika daftar gambar status ditentukan, kontrol pohon menyimpan ruang di sebelah kiri ikon setiap item untuk gambar status. Aplikasi dapat menggunakan gambar status, seperti kotak centang yang dicentang dan dikosongkan, untuk menunjukkan status item yang ditentukan aplikasi. Nilai bukan nol dalam bit 12 hingga 15 menentukan indeks berbasis satu gambar status (0 menunjukkan tidak ada gambar status).
Dengan menentukan nilai I_IMAGECALLBACK alih-alih indeks gambar, Anda dapat menunda menentukan gambar yang dipilih atau tidak dipilih hingga item akan digambar ulang. I_IMAGECALLBACK mengarahkan kontrol pohon untuk mengkueri aplikasi untuk indeks dengan mengirim pesan pemberitahuan TVN_GETDISPINFO.
Fungsi anggota GetImageList mengambil handel daftar gambar kontrol pohon. Fungsi ini berguna jika Anda perlu menambahkan lebih banyak gambar ke daftar. Untuk informasi selengkapnya tentang daftar gambar, lihat Menggunakan CImageList, CImageList di Referensi MFC, dan Daftar Gambar di Windows SDK.