Partager via


CFrameWnd::SetTaskbarOverlayIcon

Surchargé. Applique une superposition à un bouton de la barre des tâches pour indiquer l'état de l'application ou pour signaler à l'utilisateur.

BOOL SetTaskbarOverlayIcon(
   UINT nIDResource,
   LPCTSTR lpcszDescr
);
BOOL SetTaskbarOverlayIcon(
   HICON hIcon,
   LPCTSTR lpcszDescr
);

Paramètres

  • nIDResource
    Spécifie l'ID de ressource d'une icône à utiliser comme chevauchement. Consultez la description de hIcon pour plus d'informations.

  • lpcszDescr
    Un pointeur vers une chaîne qui fournit une version de texte de remplacement des informations fourni par un chevauchement, pour l'accessibilité.

  • hIcon
    Le handle d'une icône à utiliser comme chevauchement. Cela doit être une petite icône mesure, les 16x16 pixels à 96 points par pouce (dpi). Si une icône de chevauchement est déjà appliquée au bouton de la barre des tâches, cette superposition existante est substituée. Cette valeur peut être NULL. Comment une valeur d' NULL est gérée varie selon que le bouton de la barre des tâches représente un guichet unique ou un groupe windows. Il est de la responsabilité de l'application appelante de libérer hIcon lorsque vous n'en avez plus besoin.

Valeur de retour

TRUE si l'opération a réussi ; FALSE si la version du système d'exploitation est moins que Windows 7 ou si une erreur se produit définissant l'icône.

Configuration requise

en-tête : afxwin.h

Voir aussi

Référence

CFrameWnd, classe