THUMBBUTTON 構造体 (shobjidl_core.h)

[アーティクル]
08/26/2023

ウィンドウのサムネイル表現に埋め込まれたツールバーで使用されるボタンを定義するために、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 を含む)

THUMBBUTTON 構造体 (shobjidl_core.h)

構文

メンバー

解説

ボタンの画像

要件

関連項目

フィードバック

フィードバック

その他のリソース