THUMBBUTTON 構造体 (shobjidl_core.h)

  • [アーティクル]

ウィンドウのサムネイル表現に埋め込まれたツール バーで使用されるボタンを定義するために 、ITaskbarList3 インターフェイスのメソッドによって使用されます。

構文

typedef struct THUMBBUTTON {
  THUMBBUTTONMASK  dwMask;
  UINT             iId;
  UINT             iBitmap;
  HICON            hIcon;
  WCHAR            szTip[260];
  THUMBBUTTONFLAGS dwFlags;
} THUMBBUTTON, *LPTHUMBBUTTON;

メンバー

dwMask

型: THUMBBUTTONMASK

この構造体のどのメンバーに有効なデータが含まれているかを指定する THUMBBUTTONMASK 値の組み合わせ。iId を除き、他のメンバーは無視されます。これは常に必要です。

iId

型: UINT

ツール バー内で一意のボタンのアプリケーション定義識別子。

iBitmap

型: UINT

ITaskbarList3::ThumbBarSetImageList によって設定されたイメージ リスト内のボタン イメージの 0 から始まるインデックス。

hIcon

種類: HICON

ボタンイメージとして使用するアイコンのハンドル。

szTip[260]

種類: WCHAR[260]

マウス ポインターがボタンの上に移動したときに表示される、ボタンのヒントのテキストを含むワイド文字配列。

dwFlags

型: THUMBBUTTONFLAGS

ボタンの特定の状態と動作を制御する THUMBBUTTONFLAGS 値の組み合わせ。

解説

ボタンがクリックされると、ボタン ID を含む WM_COMMAND メッセージが関連付けられているアプリケーション ウィンドウに送信されます。 アプリケーションは、ボタンに割り当てたアクションを処理します。

ボタンの画像

hIcon メンバーで指定されたアイコンを使用すると、タスク バーはアイコンの独自のコピーを作成します。 hIcon で渡されたハンドルが不要になったときに解放するのは、呼び出し元の責任です。

ボタンの画像にアイコンと画像リストの両方を指定すると、可能であればアイコンが使用されます。 何らかの理由でアイコンの取得が失敗した場合は、イメージ リストからイメージが使用されます。

アプリケーションでは、次のボタン イメージを提供する必要があります。

  • 既定のアクティブな状態のボタン。
  • 高 dpi (1 インチあたりのドット数) ディスプレイでの使用に適した画像。

イメージは 32 ビットで、ディメンション GetSystemMetrics(SM_CXICON) x GetSystemMetrics(SM_CYICON) である必要があります。 ツール バー自体には、ボタンのクリック状態、無効状態、ホバー状態のビジュアルが表示されます。

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
Header shobjidl_core.h (Shobjidl.h を含む)

関連項目

ITaskbarList3::ThumbBarAddButtons

ITaskbarList3::ThumbBarUpdateButtons

タスク バー拡張機能

タスクバーのサムネイル ツールバーのサンプル