Fonction RegisterClassExW (winuser.h)

Article
03/04/2024

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

Syntaxe

ATOM RegisterClassExW(
  [in] const WNDCLASSEXW *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 le transmettre à 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 inscrite. Cet atome ne peut être utilisé que par les fonctions CreateWindow, CreateWindowEx, GetClassInfoInfo ,FindWindow , FindWindowEx et UnregisterClass, ainsi que 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 inscrites par une application ne sont pas enregistrées 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 annuler explicitement l’inscription de 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 comme un 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.

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)