CWnd::CreateEx

Artikel
02/26/2013

Stellt das angegebene Fenster erstellt und fügt es dem CWnd-Objekt.

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
);

Parameter

dwExStyle
Kombination (Bitweises OR) von erweiterte Fensterstile; andernfalls NULL für den standardmäßigen erweiterten Fensterstil.
lpszClassName
Zeiger auf eine auf NULL endende Zeichenfolge, die den Namen einer registrierten Systemfensterklasse enthält; oder der Name einer vordefinierten Systemfensterklasse.
lpszWindowName
Zeiger auf eine auf NULL endende Zeichenfolge, die den Fensteranzeigenamen enthält; andernfalls NULL für keinen Fensteranzeigenamen.
dwStyle
Kombination (Bitweises OR) von Fensterstile; andernfalls NULL für den standardmäßigen Fensterstil.
x
Der ursprüngliche horizontale Entfernung des Fensters von der linken Seite des Bildschirms oder des übergeordneten Fensters.
y
Der ursprüngliche vertikale Abstand des Fensters von der Rand des Bildschirms oder des übergeordneten Fensters.
nWidth
Die Breite, in Pixel, des Fensters.
nHeight
Die Höhe, in Pixel, des Fensters.
hwndParent
Für ein untergeordnetes Fenster das Handle für das übergeordnete Fenster; andernfalls das Handle des Besitzerfensters, wenn das Fenster einen Besitzer hat.
nIDorHMenu
Für ein untergeordnetes Fenster die Fenster ID; andernfalls die ID eines Menüs für das Fenster.
lpParam
Zeiger auf Benutzerdaten, die zur CWnd::OnCreate-Methode auf dem lpCreateParams Feld übergeben wird.
rect
Die Größe und Position des Fensters relativ zum Bildschirm oder dem übergeordneten Fenster.
pParentWnd
Für ein untergeordnetes Fenster Zeiger auf das übergeordnete Fenster; andernfalls Zeiger auf Besitzerfenster, wenn das Fenster einen Besitzer hat.
nID
Für ein untergeordnetes Fenster die Fenster ID; andernfalls die ID eines Menüs für das Fenster.

Rückgabewert

TRUE, wenn die Methode erfolgreich war; andernfalls FALSE.

Hinweise

Vorsicht
CWnd::PreCreateWindow weist jetzt den hMenu Member seines CREATESTRUCT-Parameters zum this Zeiger auf, wenn das Menü NULL ist und das Format WS_CHILD enthält.Für eine ordnungsgemäße Funktionalität stellen Sie sicher, dass das Dialogfeld-Steuerelement eine ID verfügt, die nicht NULL ist. Diese Änderung behoben einen Absturz in den verwalteten und systemeigenen Interopszenarien.Eine TRACE-Anweisung in CWnd::Create weist den Entwickler des Problems.

CWnd::PreCreateWindow weist jetzt den hMenu Member seines CREATESTRUCT-Parameters zum this Zeiger auf, wenn das Menü NULL ist und das Format WS_CHILD enthält.Für eine ordnungsgemäße Funktionalität stellen Sie sicher, dass das Dialogfeld-Steuerelement eine ID verfügt, die nicht NULL ist.

Diese Änderung behoben einen Absturz in den verwalteten und systemeigenen Interopszenarien.Eine TRACE-Anweisung in CWnd::Create weist den Entwickler des Problems.

Der Standardwert ist WS_EX_LEFT erweiterte Fensterstil.Der Standardwert ist WS_OVERLAPPED Fensterstil.

Verwenden Sie die Funktion, um AfxRegisterWndClass Fensterklassen zu registrieren.Benutzerdefinierte Fensterklassen sind im Modul verfügbar, in dem sie registriert werden.

Dimensionen für untergeordnete Fenster sind relativ zur linken oberen Ecke des Clientbereichs des übergeordneten Fensters.Dimensionen für Fenster der obersten Ebene sind relativ zur linken oberen Ecke des Bildschirms.

Die CWnd::OnCreate-Methode wird aufgerufen, bevor die CreateEx-Methode zurückgibt, und vor dem Fenster wird angezeigt.

Beispiel

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);
}