Udostępnij za pośrednictwem


CToolBar::CreateEx

Wywołanie tej funkcji do tworzenia narzędzi systemu Windows (okna podrzędnego) i skojarzyć go z CToolBar obiektu.

virtual BOOL CreateEx(
   CWnd* pParentWnd,
   DWORD dwCtrlStyle = TBSTYLE_FLAT,
   DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_ALIGN_TOP,
   CRect rcBorders = CRect(
   0,
   0,
   0,
   0
),
   UINT nID = AFX_IDW_TOOLBAR
);

Parametry

  • pParentWnd
    Wskaźnik do okna, które jest nadrzędny na pasku narzędzi.

  • dwCtrlStyle
    Dodatkowe style dla tworzenia osadzonego CToolBarCtrl obiektu.Domyślnie ta wartość jest ustawiona TBSTYLE_FLAT.Aby uzyskać pełną listę narzędzi style, zobacz dwStyle.

  • dwStyle
    Styl paska narzędzi.Zobacz formantu Toolbar i przycisk style w Windows SDK listę odpowiednie style.

  • rcBorders
    A CRect obiektu, który definiuje szerokości obramowania okna pasek narzędzi.Granice te są domyślnie do 0,0,0,0, powodując tym samym oknie narzędzi z bez obramowania.

  • nID
    Identyfikator pasku narzędzi okna podrzędnego.

Wartość zwracana

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

Uwagi

Ustawia również wysokość paska narzędzi na wartość domyślną.

Użyj CreateEx, zamiast Tworzenie, gdy niektóre style musi być obecny podczas tworzenia formantu pasek narzędzie osadzone.Na przykład ustawić dwCtrlStyle do TBSTYLE_FLAT | TBSTYLE_TRANSPARENT utworzyć pasek narzędzi, który jest podobny do pasków narzędzi programu Internet Explorer 4.

Przykład

// This example demonstrates CToolBar::CreateEx by creating a 
// toolbar as part of a child frame window. It also calls the 
// LoadToolbar and EnableDocking functions
int CChildFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
   if (CMDIChildWnd::OnCreate(lpCreateStruct) == -1)
      return -1;

   if (!m_wndMyToolBar.CreateEx(this, TBSTYLE_FLAT, WS_CHILD | WS_VISIBLE | CBRS_TOP
      | CBRS_GRIPPER | CBRS_TOOLTIPS | CBRS_FLYBY | CBRS_SIZE_DYNAMIC) ||
      !m_wndMyToolBar.LoadToolBar(IDR_MYTOOLBAR))
   {
      TRACE0("Failed to create toolbar\n");
      return -1;      // fail to create
   }

   m_wndMyToolBar.EnableDocking(CBRS_ALIGN_ANY);
   EnableDocking(CBRS_ALIGN_ANY);
   DockControlBar(&m_wndMyToolBar);

   return 0;
}

Wymagania

Nagłówek: afxext.h

Zobacz też

Informacje

Klasa CToolBar

Wykres hierarchii