CMDIChildWnd::Create

Статья
06/10/2015

Эта функция-член вызывается с целью создания дочернее окно MDI Windows и вложить его к объекту CMDIChildWnd.

virtual BOOL Create( 
   LPCTSTR lpszClassName, 
   LPCTSTR lpszWindowName, 
   DWORD dwStyle = WS_CHILD | WS_VISIBLE | WS_OVERLAPPEDWINDOW, 
   const RECT& rect = rectDefault, 
   CMDIFrameWnd* pParentWnd = NULL, 
   CCreateContext* pContext = NULL  
);

Параметры

lpszClassName
Указывает на null- завершенной символьную строку, назовите класс Windows (структуру WNDCLASS ). Имя класса может быть любым именем зарегистрированных с функцией AfxRegisterWndClass глобальный. Должно быть NULL для стандартного CMDIChildWnd.
lpszWindowName
Указывает на null- завершенной символьную строку, представляющую имя окна. Используемый как текст заголовка окна.
dwStyle
Определяет атрибуты стиль окна. Стиль WS_CHILD требуется.
rect
Содержит размер и положение окна. Значение rectDefault позволяет Windows для определения того, размер и положение нового CMDIChildWnd.
pParentWnd
Определяет родительского окна. Если NULL, главное окно приложения используется.
pContext
Определяет структуру CCreateContext. Этот параметр может быть NULL.

Возвращаемое значение

Ненулевой, если успешно; в противном случае – значение 0.

Заметки

Активное в данный момент фреймовое окно mdi-приложения дочернего элемента может определить заголовок родительского фреймового окна. Эта функция отключена, чтобы отключить стиль FWS_ADDTOTITLE сдержанная фреймового окна дочернего элемента.

Платформа вызывает функцию этот функцию-член в ответ на команду создать пользователя дочернее окно и использования платформы параметр pContext правильно дочернее окно подключиться к приложению. При вызове Создать, pContext может быть NULL.

Пример

Пример 1:

// CMainFrame::OnFileNewCMdiChildWnd() is a menu command handler for the  
// CMainFrame class, which in turn is a CMDIFrameWnd-derived class. 
// It shows the creation of a standard Windows MDI child window using  
// the registered CMDIChildWnd class.   
void CMainFrame::OnFileNewMdiChildWnd()
{
   CMDIChildWnd* pMDIChildWnd = new CMDIChildWnd;
   VERIFY(pMDIChildWnd->Create(
      NULL,                                        // standard CMDIChildWnd class
      _T("My MDIChildWnd"),                        // caption of MDI child window
      WS_CHILD | WS_VISIBLE | WS_OVERLAPPEDWINDOW, // window styles
      rectDefault,                                 // default rectangle size 
      this));                                      // parent window; can be NULL 

   // the default PostNcDestroy handler will delete this object when destroyed
}

Пример 2:

// CMainFrame::OnHello() is a menu command handler for the CMainFrame 
// class, which in turn is a CMDIFrameWnd-derived class. 
// It shows the creation of a Windows MDI child window using a custom 
// window class. The custom window class is registered in  
// CHelloWnd::Create(). CHelloWnd is a CMDIChildWnd-derived class. 
void CMainFrame::OnHello()
{
   CHelloWnd *pHelloWnd = new CHelloWnd;
   if (!pHelloWnd->Create(_T("Hello"),
      WS_CHILD | WS_VISIBLE | WS_OVERLAPPEDWINDOW,
      rectDefault, this))
      return;

   // the default PostNcDestroy handler will delete this object when destroyed
}

BOOL CHelloWnd::Create(
   LPCTSTR szTitle, 
   LONG style              /* = 0 */,
   const RECT& rect        /* = rectDefault */,
   CMDIFrameWnd* parent    /* = NULL */)
{
   // Setup the shared menu
   SetHandles(::LoadMenu(AfxGetInstanceHandle(), MAKEINTRESOURCE(IDR_HELLO)),
      NULL);

   // Register a custom WndClass and create a window. 
   // This must be done because CHelloWnd has a custom icon.
   LPCTSTR lpszHelloClass =
      AfxRegisterWndClass(CS_HREDRAW | CS_VREDRAW,
      LoadCursor(NULL, IDC_ARROW),
      (HBRUSH) (COLOR_WINDOW+1),
      LoadIcon(AfxGetInstanceHandle(), MAKEINTRESOURCE(IDI_HELLO)));

   return CMDIChildWnd::Create(lpszHelloClass, szTitle, style, rect, parent);
}