CWnd::CreateEx

Article
03/04/2013

Crée la fenêtre spécifiée et la attaché à l'objet d' CWnd .

virtual BOOL CreateEx(
   DWORD dwExStyle,
   LPCTSTR lpszClassName,
   LPCTSTR lpszWindowName,
   DWORD dwStyle,
   int x,
   int y,
   int nWidth,
   int nHeight,
   HWND hWndParent,
   HMENU nIDorHMenu,
   LPVOID lpParam = NULL 
);
virtual BOOL CreateEx(
   DWORD dwExStyle,
   LPCTSTR lpszClassName,
   LPCTSTR lpszWindowName,
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID,
   LPVOID lpParam = NULL
);

Paramètres

dwExStyle
Combinaison d'opérations de bits (OR) de styles de fenêtre étendus; sinon NULL du style de fenêtre étendu par défaut.
lpszClassName
Pointeur vers une chaîne terminée par le caractère NULL qui contient le nom d'une classe de fenêtre stockée de système ; ou le nom d'une classe windows intégrée du système.
lpszWindowName
Pointeur vers une chaîne terminée par le caractère NULL qui contient le nom complet de la fenêtre ; sinon NULL pour tout nom complet de la fenêtre.
dwStyle
Combinaison d'opérations de bits (OR) de styles de fenêtre; sinon NULL du style de fenêtre par défaut.
x
La distance horizontale initiale de la fenêtre sur le côté gauche de l'écran ou de la fenêtre parente.
y
La distance verticale initiale de la fenêtre du supérieur de l'écran ou de la fenêtre parente.
nWidth
La largeur, en pixels, de la fenêtre.
nHeight
La hauteur, en pixels, de la fenêtre.
hwndParent
Pour une fenêtre enfant, le handle à la fenêtre parente ; sinon, le handle de la fenêtre propriétaire si la fenêtre possède un propriétaire.
nIDorHMenu
Pour une fenêtre enfant, l'ID de fenêtre ; sinon, l'ID d'un menu de la fenêtre.
lpParam
Pointeur vers les données utilisateur qui sont passées à la méthode de CWnd::OnCreate dans le domaine de lpCreateParams .
rect
La taille et l'emplacement de la fenêtre relatif à l'écran ou la fenêtre parente.
pParentWnd
Pour une fenêtre enfant, pointeur vers la fenêtre parente ; sinon, pointeur vers la fenêtre propriétaire si la fenêtre possède un propriétaire.
nID
Pour une fenêtre enfant, l'ID de fenêtre ; sinon, l'ID d'un menu de la fenêtre.

Valeur de retour

TRUE si la méthode a réussi ; sinon FALSE.

Notes

Attention
CWnd::PreCreateWindow affecte maintenant le membre de hMenu de son paramètre d' CREATESTRUCT au pointeur d' this si le menu est NULL et le style contient WS_CHILD.Pour la fonctionnalité appropriée, assurez -vous que votre contrôle de boîte de dialogue a un ID qui n'est pas NULL. Cette modification résout un incident dans scénarios d'interopérabilité managés/natifs.Une instruction d' TRACE dans CWnd::Create alerte le développeur du problème.

CWnd::PreCreateWindow affecte maintenant le membre de hMenu de son paramètre d' CREATESTRUCT au pointeur d' this si le menu est NULL et le style contient WS_CHILD.Pour la fonctionnalité appropriée, assurez -vous que votre contrôle de boîte de dialogue a un ID qui n'est pas NULL.

Cette modification résout un incident dans scénarios d'interopérabilité managés/natifs.Une instruction d' TRACE dans CWnd::Create alerte le développeur du problème.

Le style de fenêtre étendu par défaut est WS_EX_LEFT.Le style de fenêtre par défaut est WS_OVERLAPPED.

Utilisez la fonction d' AfxRegisterWndClass pour stocker des classes de fenêtres.Les classes de fenêtres définies par l'utilisateur sont disponibles dans le module dans lequel elles sont enregistrées.

Les dimensions pour les fenêtres enfants sont par rapport à l'angle supérieur gauche de la zone cliente de la fenêtre parente.Les dimensions des fenêtres de niveau supérieur sont par rapport à l'angle supérieur gauche de l'écran.

La méthode de CWnd::OnCreate est appelée avant que la méthode d' CreateEx retourne, et avant que la fenêtre devient visible.

Exemple

void CMyDlg::OnCreateExtendedControl() 
{
   // m_pWndStaticEx is a CWnd* member of CMyDlg
   m_pWndStaticEx = new CStatic;
   m_pWndStaticEx->CreateEx(WS_EX_CLIENTEDGE, // Make a client edge label.
      _T("STATIC"), _T("Hi"),
      WS_CHILD | WS_TABSTOP | WS_VISIBLE,
      5, 5, 30, 30, m_hWnd, (HMENU)2345);
}