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