Metode ITaskbarList3::ThumbBarUpdateButtons (shobjidl_core.h)

Artikel
03/04/2024

Menampilkan, mengaktifkan, menonaktifkan, atau menyembunyikan tombol dalam bilah alat gambar mini seperti yang diperlukan oleh status jendela saat ini. Toolbar gambar mini adalah toolbar yang disematkan dalam gambar mini jendela di flyout tombol taskbar.

Sintaks

HRESULT ThumbBarUpdateButtons(
  [in] HWND          hwnd,
  [in] UINT          cButtons,
  [in] LPTHUMBBUTTON pButton
);

Parameter

[in] hwnd

Jenis: HWND

Handel jendela yang representasi gambar mininya berisi toolbar.

[in] cButtons

Jenis: UINT

Jumlah tombol yang ditentukan dalam array yang ditunjukkan oleh pButton. Jumlah maksimum tombol yang diizinkan adalah 7. Array ini hanya berisi struktur yang mewakili tombol yang ada yang sedang diperbarui.

[in] pButton

Jenis: LPTHUMBBUTTON

Penunjuk ke array struktur THUMBBUTTON . Setiap THUMBBUTTON mendefinisikan tombol individual. Jika tombol sudah ada (nilai iId sudah ditentukan), maka tombol yang ada diperbarui dengan informasi yang disediakan dalam struktur.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Karena ada sejumlah ruang terbatas untuk menampilkan gambar mini, serta jumlah gambar mini yang terus berubah untuk ditampilkan, aplikasi tidak dijamin ukuran toolbar tertentu. Jika ruang tampilan rendah, tombol di toolbar dipotok dari kanan ke kiri sesuai kebutuhan. Oleh karena itu, aplikasi harus memprioritaskan perintah yang terkait dengan tombolnya untuk memastikan bahwa yang memiliki prioritas tertinggi ada di sebelah kiri dan karenanya paling tidak mungkin dipotok.

Bilah alat gambar mini hanya ditampilkan saat gambar mini ditampilkan pada bilah tugas. Misalnya, jika tombol taskbar mewakili grup dengan jendela yang lebih terbuka daripada ruang untuk menampilkan gambar mini, UI kembali ke menu warisan daripada gambar mini.

Contoh

Contoh berikut menunjukkan cara menggunakan ThumbBarUpdateButtons untuk mengubah teks dan gambar pada tombol yang ada di toolbar gambar mini pada taskbar yang diperluas.

HRESULT UpdateThumbarButton(HWND hwnd)
{
    // Define a single structure for the button to update. The ID is that
    // of an existing button, so the other information (bitmap index and 
    // tooltip) overwrites the existing values, updating the button.
    THUMBBUTON thbButton;
    thbButton.dwMask = THB_BITMAP | THB_TOOLTIP;
    thbButtons[0].iId = 1;
    thbButton.iBitmap = 3;
    thbButton.pszTip = TEXT("Different Text");
    
    // Create an instance of ITaskbarList3
    ITaskBarList3 *ptbl;
    HRESULT hr = CoCreateInstance(CLSID_TaskbarList, 
                                  NULL, 
                                  CLSCTX_INPROC_SERVER, 
                                  IID_PPV_ARGS(&ptbl);

    if (SUCCEEDED(hr))
    {
        // Update the toolbar. In this case, only the single button is updated.
        hr = ptbl->ThumbBarUpdateButtons(hwnd, 1, &thbButton);
        ptbl->Release();
    }
    return hr;
}

Persyaratan

Persyaratan	Nilai
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