Share via

CContainedWindowT::CContainedWindowT

  • Article

 

The constructor initializes data members.

Syntax

      CContainedWindowT(
   LPTSTR lpszClassName,
   CMessageMap* pObject,
   DWORD dwMsgMapID = 0 
);
CContainedWindowT( CMessageMap* pObject, DWORD dwMsgMapID = 0 )
CContainedWindowT( );

Parameters

  • lpszClassName
    [in] The name of an existing window class on which the contained window will be based.

  • pObject
    [in] A pointer to the containing object that declares the message map. This object's class must derive from CMessageMap.

  • dwMsgMapID
    [in] Identifies the message map that will process the contained window's messages. The default value, 0, specifies the default message map declared with BEGIN_MSG_MAP. To use an alternate message map declared with ALT_MSG_MAP(msgMapID), pass msgMapID.

Remarks

If you want to create a new window through Create, you must pass the name of an existing window class for the lpszClassName parameter. For an example, see the CContainedWindow overview.

There are three constructors:

  • The constructor with three arguments is the one typically called.

  • The constructor with two arguments uses the class name from TBase::GetWndClassName.

  • The constructor with no arguments is used if you want to supply the arguments later. You must supply the window class name, message map object, and message map ID when you later call Create.

If you subclass an existing window through SubclassWindow, the lpszClassName value will not be used; therefore, you can pass NULL for this parameter.

Requirements

Header: atlwin.h

See Also

CContainedWindowT Class
CContainedWindowT::m_lpszClassName
CContainedWindowT::m_pObject
CContainedWindowT::m_pfnSuperWindowProc
CContainedWindowT::SwitchMessageMap