DrawIcon, fonction (winuser.h)

Article
02/01/2024

Dessine une icône ou un curseur dans le contexte d’appareil spécifié.

Pour spécifier des options de dessin supplémentaires, utilisez la fonction DrawIconEx .

Syntaxe

BOOL DrawIcon(
  [in] HDC   hDC,
  [in] int   X,
  [in] int   Y,
  [in] HICON hIcon
);

Paramètres

[in] hDC

Type : HDC

Handle du contexte de l’appareil dans lequel l’icône ou le curseur sera dessiné.

[in] X

Type : int

Coordonnée x logique du coin supérieur gauche de l’icône.

[in] Y

Type : int

Coordonnée y logique du coin supérieur gauche de l’icône.

[in] hIcon

Type : HICON

Poignée de l’icône à dessiner.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

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

DrawIcon place le coin supérieur gauche de l’icône à l’emplacement spécifié par les paramètres X et Y . L’emplacement est soumis au mode de mappage actuel du contexte de l’appareil.

DrawIcon dessine l’icône ou le curseur à l’aide de la largeur et de la hauteur spécifiées par les valeurs de métriques système pour les icônes ; Pour plus d’informations, consultez GetSystemMetrics.

La fonction DrawIcon appelle DrawIconEx en passant DI_NORMAL|DI_DEFAULTSIZE en tant qu’indicateurs.

Exemples

Pour obtenir un exemple, consultez Affichage d’une icône.

Configuration requise


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-1 (introduit dans Windows 10, version 10.0.14393)