pesan TB_SETIMAGELIST

Mengatur daftar gambar yang digunakan toolbar untuk menampilkan tombol yang berada dalam status defaultnya.

Parameter

wParam

Versi 5.80. Indeks daftar. Jika Anda hanya menggunakan satu daftar gambar, atau versi kontrol umum yang lebih lama, atur wParam ke nol. Lihat Keterangan untuk detail tentang menggunakan beberapa daftar gambar.

lParam

Tangani ke daftar gambar yang akan diatur. Jika parameter ini NULL, tidak ada gambar yang ditampilkan di tombol.

Nilai hasil

Mengembalikan handel ke daftar gambar yang sebelumnya digunakan untuk menampilkan tombol dalam status defaultnya, atau NULL jika tidak ada daftar gambar yang sebelumnya diatur.

Keterangan

Catatan

Aplikasi Anda bertanggung jawab untuk membebaskan daftar gambar setelah toolbar dihancurkan.

Pesan TB_SETIMAGELIST tidak dapat dikombinasikan dengan TB_ADDBITMAP. Ini juga tidak dapat digunakan dengan toolbar yang dibuat dengan CreateToolbarEx, yang memanggil TB_ADDBITMAP secara internal. Saat Anda membuat toolbar dengan CreateToolbarEx atau menggunakan TB_ADDBITMAP untuk menambahkan gambar, toolbar mengelola daftar gambar secara internal. Mencoba memodifikasinya dengan TB_SETIMAGELIST memiliki konsekuensi yang tidak dapat diprediksi.

Dengan versi 5.80 atau yang lebih baru dari kontrol umum, gambar tombol tidak perlu berasal dari daftar gambar yang sama. Untuk menggunakan beberapa daftar gambar untuk gambar tombol toolbar Anda:

1. Aktifkan beberapa daftar gambar dengan mengirim toolbar mengontrol pesan CCM_SETVERSION dengan wParam (nomor versi) yang diatur ke 5.
2. Untuk setiap daftar gambar yang ingin Anda gunakan, kirim toolbar mengontrol pesan TB_SETIMAGELIST . Atur wParam ke nilai wParam yang ditentukan aplikasi yang akan digunakan untuk mengidentifikasi daftar. Atur lParam ke handel HIMAGELIST daftar.
3. Untuk setiap tombol, atur anggota iBitmap dari struktur TBBUTTON tombol ke MAKELONG(iIndex, iImageID). Nilai iImageID adalah ID dari daftar gambar yang sesuai yang ditentukan di langkah kedua. Nilai iIndex adalah indeks gambar tertentu dalam daftar tersebut.
4. Tambahkan tombol dengan mengirim toolbar mengontrol pesan TB_ADDBUTTONS.

Fragmen kode berikut mengilustrasikan cara menambahkan lima tombol ke toolbar, dengan gambar dari tiga daftar gambar yang berbeda. Dukungan untuk beberapa daftar gambar diaktifkan dengan pesan CCM_SETVERSION. Daftar gambar kemudian diatur dan ditetapkan ID 0-2. Tombol diberi gambar dari daftar gambar sebagai berikut:

• Tombol 0 berasal dari daftar gambar nol (ahim[0]) dengan indeks 1.
• Tombol 1 berasal dari daftar gambar satu (ahim[1]) dengan indeks 1.
• Tombol 2 berasal dari daftar gambar dua (ahim[2]) dengan indeks 1.
• Tombol 3 berasal dari daftar gambar nol (ahim[0]) dengan indeks 2.
• Tombol 4 berasal dari daftar gambar satu (ahim[1]) dengan indeks 3.

Terakhir, tombol ditambahkan ke kontrol toolbar dengan pesan TB_ADDBUTTONS.

//Enable multiple image lists
    SendMessage(hwndTB, CCM_SETVERSION, (WPARAM) 5, 0); 

    //Set the image lists and assign them IDs of 0-2
    SendMessage(hwndTB, TB_SETIMAGELIST, 0, (LPARAM)ahiml[0]);
    SendMessage(hwndTB, TB_SETIMAGELIST, 1, (LPARAM)ahiml[1]);
    SendMessage(hwndTB, TB_SETIMAGELIST, 2, (LPARAM)ahiml[2]);

    // Create the five buttons
    TBBUTTON rgtb[5];
    
    //... initialize the TBBUTTON structures as usual ...
    
    //Assign images to each button
    rgtb[0].iBitmap = MAKELONG(1, 0);
    rgtb[1].iBitmap = MAKELONG(1, 1);
    rgtb[2].iBitmap = MAKELONG(1, 2);
    rgtb[3].iBitmap = MAKELONG(2, 0);
    rgtb[4].iBitmap = MAKELONG(3, 1);

    // Add the five buttons to the toolbar control
    SendMessage(hwndTB, TB_ADDBUTTONS, 5, (LPARAM)(&rgtb);

Persyaratan

Persyaratan	Value
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	Commctrl.h

Baca juga

MAKELONG