AfxRegisterWndClass

Article
06/10/2015

Permet d'enregistrer vos propres classes windows.

LPCTSTR AFXAPI AfxRegisterWndClass( 
   UINT nClassStyle, 
   HCURSOR hCursor = 0, 
   HBRUSH hbrBackground = 0, 
   HICON hIcon = 0  
);

Paramètres

nClassStyle
Spécifie le style de la classe windows ou une combinaison des styles, créée à l'aide de bits OR (|) opérateur, pour la classe windows. Pour une liste des styles de la classe, consultez la structure WNDCLASS dans Kit de développement logiciel Windows. Si NULL, les valeurs par défaut seront définies comme suit :
- Définit le style de la souris sur CS_DBLCLKS, qui envoie des messages de double-cliquez sur la procédure d'affichage lorsque l'utilisateur sur la souris.
- Définit le style de curseur flèche vers standard IDC_ARROWwindows.
- Définit le pinceau d'arrière-plan à NULL, la fenêtre n'effacera pas son arrière-plan.
- Définit l'icône du standard, l'icône de logo windows pour onduler- indicateur.
hCursor
Spécifie un descripteur de la ressource curseur à installer dans chaque fenêtre création de la classe windows. Si vous utilisez la valeur par défaut de 0, vous obtiendrez le curseur standard IDC_ARROW.
hbrBackground
Spécifie un descripteur de la ressource brosse à installer dans chaque fenêtre création de la classe windows. Si vous utilisez la valeur par défaut de 0, vous avez un pinceau d'arrière-plan de NULL, et votre fenêtre, par défaut, n'effacera pas son arrière-plan lors de le traitement WM_ERASEBKGND.
hIcon
Spécifie un descripteur de la ressource icone à installer dans chaque fenêtre création de la classe windows. Si vous utilisez la valeur par défaut de 0, vous obtiendrez standard, icône de logo windows pour onduler- indicateur.

Valeur de retour

Une chaîne de caractères se terminant par null contenant le nom de la classe. Vous pouvez passer le nom de classe de la fonction membre du Créer dans CWnd ou d'autres classes dérivées par CWnd-pour créer une fenêtre. Le nom est généré par la bibliothèque MFC.

Notes

La valeur de retour est un pointeur vers une mémoire tampon statique.Pour enregistrer cette chaîne, attribuez -lui la valeur à une variable CString.

Notes

La bibliothèque MFC stocke automatiquement plusieurs classes windows standard pour vous. Appelez cette fonction si vous souhaitez stocker vos propres classes windows.

Nom enregistré pour une classe par AfxRegisterWndClass dépend uniquement les paramètres. Si vous appelez AfxRegisterWndClass plusieurs fois avec des paramètres identiques, mais uniquement une classe sur le premier appel. Les appels suivants à AfxRegisterWndClass avec des paramètres identiques retournent simplement le nom de classe déjà enregistré.

Si vous appelez AfxRegisterWndClass pour les classes dérivées CWnd- plusieurs des paramètres identiques, au lieu d'obtenir une classe de fenêtre distincte pour chaque classe, les partages de chaque classe la même classe windows. Cela peut poser des problèmes si le style de la classe de CS_CLASSDC est utilisé. Au lieu de plusieurs classes windows CS_CLASSDC, vous achevez à une classe windows de CS_CLASSDC, et toutes les fenêtres C++ qui utilisent le partage de la classe sur le contrôleur de domaine. Pour éviter ce problème, appelez AfxRegisterClass pour stocker la classe.

Consultez la remarque technique TN001 : Inscription de la classe de fenêtre pour plus d'informations sur l'inscription de la classe windows et la fonction AfxRegisterWndClass.

Exemple

CString strMyClass;

// load stock cursor, brush, and icon for 
// my own window class 

try
{
   strMyClass = AfxRegisterWndClass(
      CS_VREDRAW | CS_HREDRAW,
      ::LoadCursor(NULL, IDC_ARROW),
      (HBRUSH) ::GetStockObject(WHITE_BRUSH),
      ::LoadIcon(NULL, IDI_APPLICATION));
}
catch (CResourceException* pEx)
{
   AfxMessageBox(_T("Couldn't register class! (Already registered?)"));
   pEx->Delete();
}