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 値の組み合わせ。iId を除き、他のメンバーは無視されます。これは常に必要です。
iId
型: UINT
ツール バー内で一意のボタンのアプリケーション定義識別子。
iBitmap
型: UINT
ITaskbarList3::ThumbBarSetImageList によって設定されたイメージ リスト内のボタン イメージの 0 から始まるインデックス。
hIcon
種類: HICON
ボタンイメージとして使用するアイコンのハンドル。
szTip[260]
種類: WCHAR[260]
マウス ポインターがボタンの上に移動したときに表示される、ボタンのヒントのテキストを含むワイド文字配列。
dwFlags
ボタンの特定の状態と動作を制御する 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