DrawIconEx, fonction (winuser.h)
Dessine une icône ou un curseur dans le contexte d’appareil spécifié, effectuant les opérations raster spécifiées et étirant ou 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 vers le 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
Handle vers l’icône ou le 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
[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 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 la bitmap dans le contexte de l’appareil identifié par hdc. Si hbrFlickerFreeDraw est 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 être l’une des valeurs suivantes.
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’erreur étendues, appelez GetLastError.
Remarques
La fonction
Si un seul des indicateurs DI_IMAGE et DI_MASK est défini, la bitmap correspondante est dessinée avec le code d’opération de SRCCOPYraster.
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 à 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 de SRCANDraster, et l’image est dessinée avec le code d’opération SRCINVERTraster
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);
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winuser.h (include 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
conceptuelle
de référence