GetIconInfo, fonction (winuser.h)
Récupère des informations sur l’icône ou le curseur spécifiés.
Syntaxe
BOOL GetIconInfo(
[in] HICON hIcon,
[out] PICONINFO piconinfo
);
Paramètres
[in] hIcon
Type : HICON
Handle de l’icône ou du curseur.
Pour récupérer des informations sur une icône ou un curseur standard, spécifiez l’identificateur commençant par le préfixe IDI_ ou l’identificateur commençant par le préfixe IDC_ dans ce paramètre.
[out] piconinfo
Type : PICONINFO
Pointeur vers une structure ICONINFO . La fonction remplit les membres de la structure.
Valeur retournée
Type : BOOL
Si la fonction réussit, la valeur de retour est différente de zéro et la fonction remplit les membres de la structure ICONINFO spécifiée.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
GetIconInfo crée des bitmaps pour les hbmMask et hbmColor ou les membres d’ICONINFO. L’application appelante doit gérer ces bitmaps et les supprimer avec l’appel DeleteObject lorsqu’elles ne sont plus nécessaires.
Virtualisation DPI
Cette API ne participe pas à la virtualisation DPI. La sortie retournée n’est pas affectée par le ppp du thread appelant.Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winuser.h (inclure Windows.h) |
| Bibliothèque | User32.lib |
| DLL | User32.dll |
| Ensemble d’API | ext-ms-win-ntuser-gui-l1-1-0 (introduit dans Windows 8) |
Voir aussi
Conceptuel