CDialogBar::Create

Článek
03/04/2013

Dialogové okno šablony prostředek určený načte lpszTemplateName nebo nIDTemplate , vytvoří panelu dialogového okna, nastaví jeho styl a přidruží jej s CDialogBar objektu.

virtual BOOL Create(
   CWnd* pParentWnd,
   LPCTSTR lpszTemplateName,
   UINT nStyle,
   UINT nID 
);
virtual BOOL Create(
   CWnd* pParentWnd,
   UINT nIDTemplate,
   UINT nStyle,
   UINT nID 
);

Parametry

pParentWnd
Ukazatel na nadřazený CWnd objektu.
lpszTemplateName
Ukazatel myši na název CDialogBar objektu dialogové okno zdroj šablony.
nStyle
Styl panelu nástrojů.Další nástrojů styly podporovány jsou:
- CBRS_TOPOvládací panel je v horní části okna rámce.
- CBRS_BOTTOMOvládací panel je v dolní části okna rámce.
- CBRS_NOALIGNOvládací panel není přemístí při změně velikosti nadřazeného objektu.
- CBRS_TOOLTIPSOvládací panel zobrazí popisy tlačítek.
- CBRS_SIZE_DYNAMIC je dynamické ovládací panel.
- CBRS_SIZE_FIXED panel ovládacího prvku je pevná.
- CBRS_FLOATING je plovoucí panel ovládacího prvku.
- CBRS_FLYBYStavový řádek zobrazuje informace o tlačítku.
- CBRS_HIDE_INPLACE uživateli není zobrazen ovládací panel.
nID
ID ovládacího panelu dialogového okna.
nIDTemplate
ID prostředků CDialogBar objektu dialogové okno šablony.

Vrácená hodnota

Nenulová hodnota, pokud je úspěšná. jinak 0.

Poznámky

Pokud zadáte CBRS_TOP nebo CBRS_BOTTOM styl zarovnání, šířku panelu dialogového okna je okno snímku a jeho výška je prostředek určen nIDTemplate .Pokud zadáte CBRS_LEFT nebo CBRS_RIGHT styl zarovnání, výška panelu dialogového okna je okno snímku a jeho šířka je prostředek určen nIDTemplate .

Příklad

int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
   if (CMDIFrameWnd::OnCreate(lpCreateStruct) == -1)
      return -1;

   EnableDocking(CBRS_ALIGN_ANY);

   // m_wndDlgBar is a CDialogBar member of CMainFrame
   // IDD_DIALOGBAR - Resource ID of the dialog 
   // template. This dialog template should be created 
   // with  the  style  WS_CHILD and no other style.
   // The template must not have the style WS_VISIBLE.
   if (!m_wndDlgBar.Create(this, IDD_DIALOGBAR,
      CBRS_LEFT|CBRS_TOOLTIPS|CBRS_FLYBY, IDD_DIALOGBAR))
   {
      TRACE0("Failed to create DlgBar\n");
      return -1;      // Fail to create.
   }

   return 0;
}