RegisterClassA, fonction (winuser.h)

2024-11-20

Inscrit une classe de fenêtre pour une utilisation ultérieure dans les appels à la fonction CreateWindow ou CreateWindowEx.

Remarque La fonction RegisterClass a été remplacée par la fonction RegisterClassEx. Vous pouvez toujours utiliser RegisterClass, toutefois, si vous n’avez pas besoin de définir la petite icône de classe.

Syntaxe

ATOM RegisterClassA(
  [in] const WNDCLASSA *lpWndClass
);

Paramètres

[in] lpWndClass

Type : const WNDCLASS*

Pointeur vers une structure WNDCLASS . Vous devez remplir la structure avec les attributs de classe appropriés avant de le transmettre à la fonction.

Valeur de retour

Type : ATOM

Si la fonction réussit, la valeur de retour est un atome de classe qui identifie de façon unique la classe inscrite. Cet atome ne peut être utilisé que par l'CreateWindow , CreateWindowEx, GetClassInfo, GetClassInfoEx,, FindWindow, FindWindowExet fonctions UnregisterClass et les fonctions IActiveIMMap ::FilterClientWindows.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Si vous inscrivez la classe de fenêtre à l’aide de RegisterClassA, l’application indique au système que les fenêtres de la classe créée attendent des messages avec des paramètres de texte ou de caractère pour utiliser le jeu de caractères ANSI ; si vous l’inscrivez à l’aide de RegisterClassW, l’application demande que le système passe les paramètres de texte des messages en tant qu’Unicode. La fonction IsWindowUnicode permet aux applications d’interroger la nature de chaque fenêtre. Pour plus d’informations sur les fonctions ANSI et Unicode, consultez Conventions pour les prototypes de fonction.

Toutes les classes de fenêtre qu’une application inscrit ne sont pas inscrites lorsqu’elle se termine.

Aucune classe de fenêtre inscrite par une DLL n’est annulée lorsque la DLL est déchargée. Une DLL doit annuler explicitement l’inscription de ses classes lorsqu’elle est déchargée.

Exemples

Pour obtenir un exemple, consultez Association d’une procédure Window à une classe Window.

Note

L’en-tête winuser.h définit RegisterClass comme 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]
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-windowclass-l1-1-0 (introduit dans Windows 8)