Structure WNDCLASSA (winuser.h)

Article
11/20/2024

Contient les attributs de classe de fenêtre inscrits par la fonction RegisterClass.

Cette structure a été remplacée par la structure WNDCLASSEX utilisée avec la fonction RegisterClassEx. Vous pouvez toujours utiliser WNDCLASS et RegisterClass si vous n’avez pas besoin de définir la petite icône associée à la classe de fenêtre.

Syntaxe

typedef struct tagWNDCLASSA {
  UINT      style;
  WNDPROC   lpfnWndProc;
  int       cbClsExtra;
  int       cbWndExtra;
  HINSTANCE hInstance;
  HICON     hIcon;
  HCURSOR   hCursor;
  HBRUSH    hbrBackground;
  LPCSTR    lpszMenuName;
  LPCSTR    lpszClassName;
} WNDCLASSA, *PWNDCLASSA, *NPWNDCLASSA, *LPWNDCLASSA;

Membres

style

Type : uiNT

Style(s) de classe. Ce membre peut être n’importe quelle combinaison des styles de classe .

lpfnWndProc

Type : WNDPROC

Pointeur vers la procédure de fenêtre. Vous devez utiliser la fonction CallWindowProc pour appeler la procédure de fenêtre. Pour plus d’informations, consultez windowProc.

cbClsExtra

Type : int

Nombre d’octets supplémentaires à allouer à la suite de la structure de classe de fenêtre. Le système initialise les octets à zéro.

cbWndExtra

Type : int

Nombre d’octets supplémentaires à allouer après l’instance de fenêtre. Le système initialise les octets à zéro. Si une application utilise WNDCLASS pour inscrire une boîte de dialogue créée à l’aide de la directive CLASS dans le fichier de ressources, elle doit définir ce membre sur DLGWINDOWEXTRA.

hInstance

Type : HINSTANCE

Handle de l’instance qui contient la procédure de fenêtre pour la classe.

hIcon

Type : HICON

Handle vers l’icône de classe. Ce membre doit être un handle vers une ressource d’icône. Si ce membre est NULL, le système fournit une icône par défaut.

hCursor

Type : HCURSOR

Handle vers le curseur de classe. Ce membre doit être un handle vers une ressource de curseur. Si ce membre est NULL, une application doit définir explicitement la forme du curseur chaque fois que la souris se déplace dans la fenêtre de l’application.

hbrBackground

Type : HBRUSH

Handle vers le pinceau d’arrière-plan de classe. Ce membre peut être un handle vers le pinceau physique à utiliser pour peindre l’arrière-plan, ou il peut s’agir d’une valeur de couleur. Une valeur de couleur doit être l’une des couleurs système standard suivantes (la valeur 1 doit être ajoutée à la couleur choisie). Si une valeur de couleur est donnée, vous devez la convertir en l’un des types HBRUSH suivants :

COLOR_ACTIVEBORDER
COLOR_ACTIVECAPTION
COLOR_APPWORKSPACE
COLOR_BACKGROUND
COLOR_BTNFACE
COLOR_BTNSHADOW
COLOR_BTNTEXT
COLOR_CAPTIONTEXT
COLOR_GRAYTEXT
COLOR_HIGHLIGHT
COLOR_HIGHLIGHTTEXT
COLOR_INACTIVEBORDER
COLOR_INACTIVECAPTION
COLOR_MENU
COLOR_MENUTEXT
COLOR_SCROLLBAR
COLOR_WINDOW
COLOR_WINDOWFRAME
COLOR_WINDOWTEXT

Le système supprime automatiquement les pinceaux d’arrière-plan de classe lorsque la classe n’est pas inscrite à l’aide de UnregisterClass. Une application ne doit pas supprimer ces pinceaux.

Lorsque ce membre est NULL, une application doit peindre son propre arrière-plan chaque fois qu’elle est demandée pour peindre dans sa zone cliente. Pour déterminer si l’arrière-plan doit être peint, une application peut traiter le message WM_ERASEBKGND ou tester le membre fErase de la structure PAINTSTRUCT remplie par la fonction BeginPaint.

lpszMenuName

Type : LPCTSTR

Nom de la ressource du menu de classe, tel que le nom apparaît dans le fichier de ressources. Si vous utilisez un entier pour identifier le menu, utilisez la macro MAKEINTRESOURCE. Si ce membre est NULL, les fenêtres appartenant à cette classe n’ont pas de menu par défaut.

lpszClassName

Type : LPCTSTR

Pointeur vers une chaîne terminée par null ou est un atome. Si ce paramètre est un atome, il doit s’agir d’un atome de classe créé par un appel précédent à la fonction RegisterClass ou RegisterClassEx. L’atome doit être dans le mot de bas ordre de lpszClassName; le mot de haut ordre doit être égal à zéro.

Si lpszClassName est une chaîne, elle spécifie le nom de la classe de fenêtre. Le nom de classe peut être n’importe quel nom inscrit auprès de RegisterClass ou RegisterClassEx, ou l’un des noms de classe de contrôle prédéfinis.

La longueur maximale de lpszClassName est 256. Si lpszClassName est supérieur à la longueur maximale, la fonction RegisterClass échoue.

Remarques

Note

L’en-tête winuser.h définit WNDCLASS en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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]
d’en-tête	winuser.h (include Windows.h)