次の方法で共有


CToolBar::CreateEx

Windows ツール バー (子ウィンドウ) を作成し、CToolBar のオブジェクトに関連付けるには、この関数を呼び出します。

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

パラメーター

  • pParentWnd
    ツール バーの親ペインへのポインター。

  • dwCtrlStyle
    埋め込み CToolBarCtrl の作成の追加スタイルを追加します。既定では、この値は TBSTYLE_FLATに設定されます。ツール バー スタイルの一覧については、dwStyleを参照してください。

  • dwStyle
    ツール バーのスタイルです。適切なスタイルの一覧については、Windows SDK の ツール バー コントロール ボタンとボタンのスタイル を参照してください。

  • rcBorders
    ツール バー ウィンドウ境界線の幅を定義する CRect のオブジェクト。これらの境界は境界線なしのツール バー ペインにより、既定で 0,0,0,0 に設定されます。

  • nID
    ツール バーの子ウィンドウ ID。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

また、既定では、ツール バーの高さを設定します。

特定のスタイルが埋め込みツール バー コントロールの作成時にする必要がある場合、[作成]の代わりに CreateExを使用します。たとえば、Internet Explorer 4 のツール バーに似ているツール バーを作成するために TBSTYLE_FLAT | TBSTYLE_TRANSPARENT に dwCtrlStyle を設定します。

使用例

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

必要条件

ヘッダー: afxext.h

参照

関連項目

CToolBar クラス

階層図