Structure THUMBBUTTON (shobjidl_core.h)
Utilisé par les méthodes de l’interface ITaskbarList3 pour définir les boutons utilisés dans une barre d’outils incorporée dans la représentation miniature d’une fenêtre.
Syntaxe
typedef struct THUMBBUTTON {
THUMBBUTTONMASK dwMask;
UINT iId;
UINT iBitmap;
HICON hIcon;
WCHAR szTip[260];
THUMBBUTTONFLAGS dwFlags;
} THUMBBUTTON, *LPTHUMBBUTTON;
Membres
dwMask
Type : THUMBBUTTONMASK
Combinaison de valeurs THUMBBUTTONMASK qui spécifient les membres de cette structure qui contiennent des données valides ; les autres membres sont ignorés, à l’exception de l’iId, qui est toujours requis.
iId
Type : UINT
Identificateur défini par l’application du bouton, unique dans la barre d’outils.
iBitmap
Type : UINT
Index de base zéro de l’image de bouton dans la liste d’images définie via ITaskbarList3::ThumbBarSetImageList.
hIcon
Type : HICON
Poignée d’une icône à utiliser comme image de bouton.
szTip[260]
Type : WCHAR[260]
Large tableau de caractères qui contient le texte de l’info-bulle du bouton, affiché lorsque le pointeur de la souris pointe sur le bouton.
dwFlags
Type : THUMBBUTTONFLAGS
Combinaison de valeurs THUMBBUTTONFLAGS qui contrôlent des états et des comportements spécifiques du bouton.
Remarques
Lorsque vous cliquez sur un bouton, un message WM_COMMAND contenant l’ID de bouton est envoyé à la fenêtre d’application associée. L’application gère l’action qu’elle a affectée au bouton.
Images de bouton
Lors de l’utilisation d’une icône, spécifiée par le biais du membre hIcon , la barre des tâches crée sa propre copie de l’icône. Il incombe à l’appelant de libérer le handle passé dans hIcon lorsqu’il n’est plus nécessaire.Si une icône et une liste d’images sont spécifiées pour l’image d’un bouton, l’icône est utilisée si possible. Si, pour une raison quelconque, la tentative de récupération de l’icône échoue, l’image de la liste d’images est utilisée.
Les applications doivent fournir ces images de bouton :
- Bouton dans son état actif par défaut.
- Images adaptées à une utilisation avec des affichages à ppp élevés (points par pouce).
Les images doivent être 32 bits et de dimensions GetSystemMetrics(SM_CXICON) x GetSystemMetrics(SM_CYICON). La barre d’outils elle-même fournit des visuels pour les états de clic, de désactivation et de pointage d’un bouton.
Configuration requise
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| En-tête | shobjidl_core.h (incluez Shobjidl.h) |
Voir aussi
ITaskbarList3::ThumbBarAddButtons
ITaskbarList3::ThumbBarUpdateButtons