CDialog::Create

Artykuł
06/10/2015

Wywołanie Tworzenie utworzyć okno dialogowe niemodalne okno dialogowe szablonu z zasobu.

virtual BOOL Create( 
   LPCTSTR lpszTemplateName, 
   CWnd* pParentWnd = NULL  
); 
virtual BOOL Create( 
   UINT nIDTemplate, 
   CWnd* pParentWnd = NULL  
);

Parametry

lpszTemplateName
Zawiera ciąg zakończony znakiem null, nazwy zasobu szablonu okno dialogowe.
pParentWnd
Wskazuje na obiekt nadrzędny okna (typu CWnd) do której należy obiekt okno dialogowe.Jeśli jest NULL, okna nadrzędnego obiektu okno dialogowe jest ustawiona w oknie głównym aplikacji.
nIDTemplate
Zawiera identyfikator zasobu szablon, okno dialogowe.

Wartość zwracana

Obie formy zwrotu niezerowa, jeśli okno dialogowe Tworzenie i Inicjowanie zostały pomyślnie; 0 inaczej.

Uwagi

Można umieścić wywołanie Tworzenie wewnątrz konstruktora lub wywołania po konstruktora jest wywoływana.

Dwie formy Tworzenie Członkowskich funkcji przewidziane dostępu do zasobu szablonu okno dialogowe Nazwa szablonu lub numer Identyfikatora szablonu (na przykład IDD_DIALOG1).

Dla formularza należy przekazać wskaźnik do obiektu nadrzędnego okna.Jeśli pParentWnd jest NULL, okno dialogowe zostanie utworzone z jego okna nadrzędnego lub właściciel ustaw w głównym oknie aplikacji.

Tworzenie Członkowskich funkcja zwraca niezwłocznie po tworzy okno dialogowe.

Użyj WS_VISIBLE stylów w szablonie okno dialogowe, jeśli okno dialogowe powinien pojawić się podczas tworzenia okna nadrzędnego.W przeciwnym razie należy wywołać ShowWindow.Dalsze okno dialogowe Style oraz ich stosowania, patrz DLGTEMPLATE struktury w Windows SDK i Style okna w Odniesienia MFC.

Użyj CWnd::DestroyWindow funkcji zniszczyć okno dialogowe, utworzony przez Tworzenie funkcji.

Przykład

void CMyDialog::OnMenuShowSimpleDialog()
{
   //m_pSimpleDialog initialized to NULL in the constructor of CMyDialog class
   m_pSimpleDlg = new CSimpleDlg();
   //Check if new succeeded and we got a valid pointer to a dialog object 
   if(m_pSimpleDlg != NULL)
   {
      BOOL ret = m_pSimpleDlg->Create(IDD_SIMPLEDIALOG, this);

      if(!ret)   //Create failed.
         AfxMessageBox(_T("Error creating Dialog"));

      m_pSimpleDlg->ShowWindow(SW_SHOW);
   }
   else
   {
      AfxMessageBox(_T("Error Creating Dialog Object"));
   }
}