ITaskbarList3::ThumbBarUpdateButtons メソッド (shobjidl_core.h)

ウィンドウの現在の状態で必要に応じて、サムネイルツールバーのボタンを表示、有効化、無効化、または非表示にします。サムネイルツールバーは、タスクバーボタンのポップアップ内のウィンドウのサムネイル画像に埋め込まれたツールバーです。

構文

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

パラメーター

[in] hwnd

型: HWND

サムネイル表示にツールバーが含まれるウィンドウのハンドル。

[in] cButtons

型: UINT

pButton が指す配列で定義されているボタンの数。使用できるボタンの最大数は 7 です。この配列には、更新中の既存のボタンを表す構造体のみが含まれます。

[in] pButton

型: LPTHUMBBUTTON

THUMBBUTTON 構造体の配列へのポインター。各 THUMBBUTTON は、個々のボタンを定義します。ボタンが既に存在する場合 ( iId 値が既に定義されている場合)、その既存のボタンは構造体で指定された情報で更新されます。

戻り値

型: HRESULT

このメソッドが成功すると、S_OKが返 されます。それ以外の場合は、 HRESULT エラーコードが返されます。

注釈

サムネイルを表示する領域が限られているだけでなく、表示するサムネイルの数も絶えず変化するため、アプリケーションでは特定のツールバーサイズが保証されません。表示領域が小さい場合、ツールバーのボタンは必要に応じて右から左に切り捨てられます。そのため、アプリケーションでは、ボタンに関連付けられているコマンドに優先順位を付けて、最も優先度の高いコマンドが左側にあり、切り捨てられる可能性が最も低いことを確認する必要があります。

サムネイルツールバーは、タスクバーにサムネイルが表示されている場合にのみ表示されます。たとえば、タスクバーボタンが、サムネイルを表示する領域よりも多くのウィンドウが開いているグループを表している場合、UI はサムネイルではなく従来のメニューに戻ります。

Accessibility

サムバーボタンの画像でのアクセシビリティの詳細については、 ThumbBarSetImageList の「解説」セクションを参照してください。

例示

次の例は、 ThumbBarUpdateButtons を使用して、拡張タスクバーのサムネイルツールバーにある既存のボタンのテキストと画像を変更する方法を示しています。

HRESULT UpdateThumbBarButton(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.
    THUMBBUTTON 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;
}

Requirements

Requirement	価値
サポートされる最小クライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
Header	shobjidl_core.h (Shobjidl.h を含む)
Library	Explorerframe.lib
DLL	Explorerframe.dll