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
Référence