Metode ITaskbarList3::ThumbBarSetImageList (shobjidl_core.h)
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 |
Lihat juga
ITaskbarList3::ThumbBarAddButtons