RegisterClassExA, fonction (winuser.h)

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

Syntaxe

ATOM RegisterClassExA(
  [in] const WNDCLASSEXA *unnamedParam1
);

Paramètres

[in] unnamedParam1

Type : const WNDCLASSEX*

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

Valeur retournée

Type : ATOM

Si la fonction réussit, la valeur de retour est un atome de classe qui identifie de manière unique la classe en cours d’inscription. Cet atome ne peut être utilisé que par les fonctions CreateWindow, CreateWindowEx, GetClassInfo, GetClassInfoEx, FindWindowEx, FindWindowEx et UnregisterClass et par la méthode IActiveIMMap ::FilterClientWindows .

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

Si vous inscrivez la classe window à l’aide de RegisterClassExA, l’application indique au système que les fenêtres de la classe créée s’attendent à ce que les messages avec des paramètres de texte ou de caractères utilisent le jeu de caractères ANSI . si vous l’inscrivez à l’aide de RegisterClassExW, l’application demande que le système passe les paramètres de texte des messages au format 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 sont désinscrits lorsqu’elle se termine.

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

Exemples

Pour obtenir un exemple, consultez Utilisation de classes de fenêtre.

Notes

L’en-tête winuser.h définit RegisterClassEx 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. La combinaison 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.

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-windowclass-l1-1-0 (introduit dans Windows 8)

Voir aussi

Conceptuel

CreateWindow

CreateWindowEx

FindWindow

FindWindowEx

GetClassInfo

GetClassInfoEx

GetClassName

Référence

RegisterClass

UnregisterClass

WNDCLASSEX

classes de fenêtre

WindowProc