Metode ITaskbarList3::ThumbBarSetImageList (shobjidl_core.h)

Artikel
08/26/2023

Menentukan daftar gambar yang berisi gambar tombol untuk toolbar yang disematkan dalam gambar mini jendela di flyout tombol taskbar.

Sintaks

HRESULT ThumbBarSetImageList(
  [in] HWND       hwnd,
  [in] HIMAGELIST himl
);

Parameter

[in] hwnd

Jenis: HWND

Handel jendela yang representasi gambar mininya berisi toolbar yang akan diperbarui. Handel ini harus termasuk dalam proses panggilan.

[in] himl

Jenis: HIMAGELIST

Handel daftar gambar yang berisi semua gambar tombol yang akan digunakan di toolbar.

Menampilkan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Aplikasi harus menyediakan gambar tombol ini:

Tombol dalam status aktif defaultnya.
Gambar yang cocok untuk digunakan dengan tampilan dpi tinggi (titik per inci).

Gambar harus 32-bit dan dimensi GetSystemMetrics(SM_CXICON) x GetSystemMetrics(SM_CYICON). Toolbar itu sendiri menyediakan visual untuk status tombol yang diklik, dinonaktifkan, dan diarahkan.

Contoh

Contoh berikut menunjukkan cara membuat toolbar gambar mini dengan dua tombol yang gambarnya berasal dari daftar gambar.


HRESULT AddThumbarButtons(HWND hwnd, HIMAGELIST himl, HIMAGELIST himlHot)
{
    // Define an array of two buttons. These buttons provide images through an 
    // image list and also provide tooltips.
    DWORD dwMask = THB_BITMAP | THB_TOOLTIP | THB_FLAGS;
    
    THUMBBUTON thbButtons[2];
    thbButtons[0].dwMask = dwMask;
    thbButtons[0].iId = 0;
    thbButtons[0].iBitmap = 0;
    thbButtons[0].pszTip = TEXT("Button 1");
    thbButtons[0].dwFlags = THBF_DISMISSONCLICK;

    dwMask = THB_BITMAP | THB_TOOLTIP;
    thbButtons[1].dwMask = dwMask;
    thbButtons[1].iId = 1;
    thbButtons[1].iBitmap = 1;
    thbButtons[1].pszTip = TEXT("Button 2");
    
    // Create an instance of ITaskbarList3
    ITaskBarList3 *ptbl;
    HRESULT hr = CoCreateInstance(CLSID_TaskbarList, 
                                  NULL, 
                                  CLSCTX_INPROC_SERVER, 
                                  IID_PPV_ARGS(&ptbl);

    if (SUCCEEDED(hr))
    {
        // Declare the image list that contains the button images.
        hr = ptbl->ThumbBarSetImageList(hwnd, himl);
        
        if (SUCCEEDED(hr))
        {
            // Attach the toolbar to the thumbnail.
            hr = ptbl->ThumbBarAddButtons(hwnd, ARRAYSIZE(thbButtons), &thbButtons);
        }
        ptbl->Release();
    }
    return hr;
}

Persyaratan


Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
Pustaka	Explorerframe.lib
DLL	Explorerframe.dll