Partager via


WM_GETICON message

Envoyé à une fenêtre pour récupérer un handle à la grande ou petite icône associée à une fenêtre. Le système affiche la grande icône dans la boîte de dialogue ALT+TAB, et la petite icône dans la fenêtre légende.

Une fenêtre reçoit ce message via sa fonction WindowProc.

#define WM_GETICON                      0x007F

Paramètres

wParam

Type d’icône récupérée. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
ICON_BIG
1
Récupérez la grande icône de la fenêtre.
ICON_SMALL
0
Récupérez la petite icône de la fenêtre.
ICON_SMALL2
2
Récupère la petite icône fournie par l’application. Si l’application n’en fournit pas, le système utilise l’icône générée par le système pour cette fenêtre.

 

lParam

Ppp de l’icône en cours de récupération. Cela peut être utilisé pour fournir différentes icônes en fonction de la taille de l’icône.

Valeur retournée

Type : HICON

La valeur de retour est un handle de l’icône grande ou petite, en fonction de la valeur de wParam. Lorsqu’une application reçoit ce message, elle peut retourner un handle à une icône petite ou grande, ou transmettre le message à la fonction DefWindowProc .

Remarques

Lorsqu’une application reçoit ce message, elle peut retourner un handle à une grande ou petite icône, ou transmettre le message à DefWindowProc.

DefWindowProc retourne un handle à la grande ou petite icône associée à la fenêtre, en fonction de la valeur de wParam.

Une fenêtre qui n’a pas d’icône définie explicitement (avec WM_SETICON) utilise l’icône pour la classe de fenêtre inscrite, et dans ce cas , DefWindowProc retourne 0 pour un message WM_GETICON . Si l’envoi d’un message WM_GETICON à une fenêtre retourne 0, essayez ensuite d’appeler la fonction GetClassLongPtr pour la fenêtre. Si cette valeur renvoie 0, essayez la fonction LoadIcon .

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]
En-tête
Winuser.h (include Windows.h)

Voir aussi

Référence

DefWindowProc

WM_SETICON

Conceptuel

Windows