Structure THUMBBUTTON (shobjidl_core.h)

  • Article

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

Extensions de la barre des tâches

Barre d’outils de miniatures de barre des tâches, exemple