CreateIconIndirect, fonction (winuser.h)

Crée une icône ou un curseur à partir d’une structure ICONINFO .

Syntaxe

HICON CreateIconIndirect(
  [in] PICONINFO piconinfo
);

Paramètres

[in] piconinfo

Type : PICONINFO

Pointeur vers une structure ICONINFO que la fonction utilise pour créer l’icône ou le curseur.

Valeur retournée

Type : HICON

Si la fonction réussit, la valeur de retour est un handle vers l’icône ou le curseur créé.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Le système copie les bitmaps dans la structure ICONINFO avant de créer l’icône ou le curseur. Étant donné que le système peut sélectionner temporairement les bitmaps dans un contexte d’appareil, les membres hbmMask et hbmColor de la structure ICONINFO ne doivent pas déjà être sélectionnés dans un contexte d’appareil. L’application doit continuer à gérer les bitmaps d’origine et les supprimer lorsqu’elles ne sont plus nécessaires.

Lorsque vous avez terminé d’utiliser l’icône, détruisez-la à l’aide de la fonction DestroyIcon .

Exemples

Pour obtenir un exemple, consultez Création d’un curseur.

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-3-0 (introduit dans Windows 10, version 10.0.10240)

Voir aussi

Conceptuel

DestroyIcon

ICONINFO

Icônes