DrawIconEx, fonction (winuser.h)

Article
03/11/2023

Dessine une icône ou un curseur dans le contexte d’appareil spécifié, en effectuant les opérations raster spécifiées et en étirant ou en compressant l’icône ou le curseur comme spécifié.

Syntaxe

BOOL DrawIconEx(
  [in]           HDC    hdc,
  [in]           int    xLeft,
  [in]           int    yTop,
  [in]           HICON  hIcon,
  [in]           int    cxWidth,
  [in]           int    cyWidth,
  [in]           UINT   istepIfAniCur,
  [in, optional] HBRUSH hbrFlickerFreeDraw,
  [in]           UINT   diFlags
);

Paramètres

[in] hdc

Type : HDC

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

[in] xLeft

Type : int

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

[in] yTop

Type : int

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

[in] hIcon

Type : HICON

Poignée de l’icône ou du curseur à dessiner. Ce paramètre peut identifier un curseur animé.

[in] cxWidth

Type : int

Largeur logique de l’icône ou du curseur. Si ce paramètre est égal à zéro et que le paramètre diFlags est DI_DEFAULTSIZE, la fonction utilise la valeur de métrique système SM_CXICON pour définir la largeur. Si ce paramètre est égal à zéro et que DI_DEFAULTSIZE n’est pas utilisé, la fonction utilise la largeur de ressource réelle.

[in] cyWidth

Type : int

Hauteur logique de l’icône ou du curseur. Si ce paramètre est égal à zéro et que le paramètre diFlags est DI_DEFAULTSIZE, la fonction utilise la valeur de métrique système SM_CYICON pour définir la largeur. Si ce paramètre est égal à zéro et que DI_DEFAULTSIZE n’est pas utilisé, la fonction utilise la hauteur de ressource réelle.

[in] istepIfAniCur

Type : UINT

Index du cadre à dessiner, si hIcon identifie un curseur animé. Ce paramètre est ignoré si hIcon n’identifie pas de curseur animé.

[in, optional] hbrFlickerFreeDraw

Type : HBRUSH

Poignée à un pinceau que le système utilise pour le dessin sans scintillement. Si hbrFlickerFreeDraw est une poignée de pinceau valide, le système crée une image bitmap hors écran à l’aide du pinceau spécifié pour la couleur d’arrière-plan, dessine l’icône ou le curseur dans la bitmap, puis copie l’image bitmap dans le contexte de l’appareil identifié par hdc. Si hbrFlickerFreeDraw a la valeur NULL, le système dessine l’icône ou le curseur directement dans le contexte de l’appareil.

[in] diFlags

Type : UINT

Indicateurs de dessin. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
DI_COMPAT 0x0004	Cet indicateur est ignoré.
DI_DEFAULTSIZE 0x0008	Dessine l’icône ou le curseur à l’aide de la largeur et de la hauteur spécifiées par les valeurs de métrique système pour les icônes, si les paramètres cxWidth et cyWidth sont définis sur zéro. Si cet indicateur n’est pas spécifié et que cxWidth et cyWidth sont définis sur zéro, la fonction utilise la taille de ressource réelle.
DI_IMAGE 0x0002	Dessine l’icône ou le curseur à l’aide de l’image. Consultez la section Notes.
DI_MASK 0x0001	Dessine l’icône ou le curseur à l’aide du masque. Consultez la section Notes.
DI_NOMIRROR 0x0010	Dessine l’icône sous la forme d’une icône non en forme de texte. Par défaut, l’icône est dessinée en tant qu’icône mise en miroir si hdc est mis en miroir.
DI_NORMAL 0x0003	Combinaison de DI_IMAGE et de DI_MASK. Consultez la section Notes.

Valeur de retour

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

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

Si un seul des indicateurs DI_IMAGE et DI_MASK est défini, l’image bitmap correspondante est dessinée avec le code d’opération rasterSRCCOPY.

Si les indicateurs DI_IMAGE et DI_MASK sont définis :

Si l’icône ou le curseur est une icône ou un curseur de fusion alpha 32 bits, l’image est dessinée avec AC_SRC_OVERfonction de fusion et le masque est ignoré.
Pour toutes les autres icônes ou curseurs, le masque est dessiné avec le code d’opération rasterSRCAND, et l’image est dessinée avec le code d’opération rasterSRCINVERT

Pour dupliquer DrawIcon (hDC, X, Y, hIcon), appelez DrawIconEx comme suit :

DrawIconEx (hDC, X, Y, hIcon, 0, 0, 0, NULL, DI_NORMAL | DI_COMPAT | DI_DEFAULTSIZE);

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)