CDialogBar::Create

Artykuł
02/27/2013

Ładuje szablonu zasobu okno dialogowe określonej przez lpszTemplateName lub nIDTemplate, tworzy okno dialogowe pasek, ustawia styl i kojarzy ją z CDialogBar obiektu.

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

Parametry

pParentWnd
Wskaźnik do obiektu nadrzędnego CWnd obiektu.
lpszTemplateName
Wskaźnik do nazwy CDialogBar obiektu okno dialogowe zasób szablonu.
nStyle
Styl paska narzędzi.Style dodatkowych narzędzi obsługiwane są:
- CBRS_TOPPasek sterowania jest u góry okna ramki.
- CBRS_BOTTOMPasek sterowania jest u dołu okna ramki.
- CBRS_NOALIGNPasek sterowania nie jest ponownie, gdy zmieniany jest rozmiar obiektu nadrzędnego.
- CBRS_TOOLTIPSPasek sterowania wyświetla podpowiedzi.
- CBRS_SIZE_DYNAMIC pasek sterowania jest dynamiczny.
- CBRS_SIZE_FIXED ustala się pasek sterowania.
- CBRS_FLOATING pasek sterowania jest przestawne.
- CBRS_FLYBYPasek stanu wyświetla informacje o przycisku.
- CBRS_HIDE_INPLACE do użytkownika nie jest wyświetlany pasek sterowania.
nID
Identyfikator formantu paska okno dialogowe.
nIDTemplate
Identyfikator zasobu CDialogBar obiektu okno dialogowe szablonu.

Wartość zwracana

Niezerowa, jeśli kończy się pomyślnie; 0 inaczej.

Uwagi

Jeśli określisz CBRS_TOP lub CBRS_BOTTOM wyrównanie, szerokość słupka okno dialogowe jest okno ramki i jej wysokość jest zasób określony przez nIDTemplate.Jeśli określisz CBRS_LEFT lub CBRS_RIGHT styl wyrównanie wysokość paska okno dialogowe jest okno ramki i jej szerokość jest zasób określony przez nIDTemplate.

Przykład

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;
}