pesan TB_SETPRESSEDIMAGELIST

Mengatur daftar gambar yang digunakan toolbar untuk menampilkan tombol yang dalam keadaan ditekan.

Parameter

wParam

Indeks daftar gambar. Jika Anda hanya menggunakan satu daftar gambar, atur parameter ini 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 keadaan ditekan, atau NULL jika tidak ada daftar gambar tersebut yang sebelumnya diatur.

Keterangan

Catatan

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

Pesan TB_SETPRESSEDIMAGELIST tidak dapat digabungkan 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_SETPRESSEDIMAGELIST memiliki konsekuensi yang tidak dapat diprediksi.

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_SETPRESSEDIMAGELIST . 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_SETPRESSEDIMAGELIST, 0, (LPARAM)ahiml[0]);
    SendMessage(hwndTB, TB_SETPRESSEDIMAGELIST, 1, (LPARAM)ahiml[1]);
    SendMessage(hwndTB, TB_SETPRESSEDIMAGELIST, 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 2008 [hanya aplikasi desktop]
Header	Commctrl.h

Baca juga

Referensi

TB_GETPRESSEDIMAGELIST

Sumber Daya Lainnya

MAKELONG