CContainedWindowT::Create

Artikel
06/09/2015

Ruft RegisterWndSuperclass auf, um eine Fensterklasse zu registrieren, die basierend auf einer vorhandenen Klasse verwendet jedoch CContainedWindowT::WindowProc ist.

HWND Create( 
   HWND hWndParent, 
   _U_RECT rect, 
   LPCTSTR szWindowName = NULL, 
   DWORD dwStyle = 0, 
   DWORD dwExStyle = 0, 
   _U_MENUorID MenuOrID = 0U,  
   LPVOID lpCreateParam = NULL  
); 
HWND Create( 
   CMessageMap* pObject,  
   DWORD dwMsgMapID,  
   HWND hWndParent, 
   _U_RECT rect, 
   LPCTSTR szWindowName = NULL, 
   DWORD dwStyle = 0, 
   DWORD dwExStyle = 0, 
   _U_MENUorID MenuOrID = 0U,  
   LPVOID lpCreateParam = NULL  
); 
HWND Create( 
   LPCTSTR lpszClassName,  
   CMessageMap* pObject,  
   DWORD dwMsgMapID,  
   HWND hWndParent, 
   _U_RECT rect, 
   LPCTSTR szWindowName = NULL, 
   DWORD dwStyle = 0, 
   DWORD dwExStyle = 0, 
   _U_MENUorID MenuOrID = 0U,  
   LPVOID lpCreateParam = NULL  
);

Parameter

lpszClassName
[in] Der Name einer vorhandenen Fensterklasse, auf der das enthaltende Fenster basiert.
pObject
[in] Ein Zeiger auf das enthaltende Objekt, das die Meldungszuordnung deklariert. Der dieser Objekts muss von CMessageMap berechnen.
dwMsgMapID
[in] Identifiziert die Meldungszuordnung, die die enthaltenen Meldungen des Fensters verarbeitet. Der Standardwert, 0, gibt die Standardmeldungszuordnung an, die mit BEGIN_MSG_MAP deklariert wird. Um eine alternative Meldungszuordnung zu verwenden, die mit ALT_MSG_MAP (msgMapID) deklariert wird, führen Sie msgMapID.
hWndParent
[in] Das Handle für den übergeordneten oder auf Besitzerfenster.
rect
[in] Struktur A RECT, die die Position des Fensters angibt. RECT kann durch Zeiger oder durch einen Verweis übergeben werden.
szWindowName
[in] gibt den Namen des Fensters angezeigt. Der Standardwert ist NULL.
dwStyle
[in] Das Format des Fensters. Der Standardwert ist WS_CHILD | WS_VISIBLE. Eine Liste der möglichen Werten, finden Sie unter CreateWindow in Windows SDK.
dwExStyle
[in] Der erweiterte Fensterstil. Der Standardwert ist 0 und setzt keine erweiterten Format. Eine Liste der möglichen Werten, finden Sie unter CreateWindowEx in Windows SDK.
MenuOrID
[in] für ein untergeordnetes Fenster, der Fensterbezeichner. Für ein Fenster der obersten Ebene ein Menühandle für das Fenster. Der Standardwert ist 0U.
lpCreateParam
[in] Ein Zeiger auf FensterErstellung Daten. Eine vollständige Beschreibung finden Sie die Beschreibung für den abschließenden Parameter auf CreateWindowEx.

Rückgabewert

Wenn erfolgreich, das Handle für den neu erstellten Fenster; andernfalls NULL.

Hinweise

Der vorhandene Fensterklassenname wird in m_lpszClassName gespeichert. Create erstellt dann ein Fenster auf Grundlage dieser neue Klasse erstellt. Das neu erstellte Fenster wird automatisch dem CContainedWindowT-Objekt angefügt.

Hinweis

Rufen Sie nicht Create auf, wenn Sie bereits SubclassWindow aufgerufen haben.

Hinweis

Wenn 0 als Wert für den Parameter MenuOrID verwendet wird, muss er als 0U (der Standardwert) angegeben werden um einen Compilerfehler zu vermeiden.

Anforderungen

Header: atlwin.h

Siehe auch

Referenz

CContainedWindowT Class

CWindow::m_hWnd

Freigeben über