CToolBar::Create

[アーティクル]
08/09/2011

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

virtual BOOL Create(
   CWnd* pParentWnd,
   DWORD dwStyle = WS_CHILD |  WS_VISIBLE | CBRS_TOP,
   UINT nID = AFX_IDW_TOOLBAR 
);

パラメーター

pParentWnd
ツールバーの親ウィンドウへのポインター。
dwStyle
ツールバーのスタイルです。追加のスタイルとして次のものがあります。
- CBRS_TOP コントロールバーはフレームウィンドウの上端に配置されます。
- CBRS_BOTTOM コントロールバーはフレームウィンドウの下端に配置されます。
- CBRS_NOALIGN 親ウィンドウのサイズが変更されても、コントロールバーは再配置されません。
- CBRS_TOOLTIPS コントロールバーはツールヒントを表示します。
- CBRS_SIZE_DYNAMIC コントロールバーのサイズ変更スタイルは動的です。
- CBRS_SIZE_FIXED コントロールバーのサイズ変更スタイルは固定されています。
- CBRS_FLOATING コントロールバーは浮動型です。
- CBRS_FLYBY ステータスバーは、ボタンについての情報を表示します。
- CBRS_HIDE_INPLACE コントロールバーはユーザーには表示されません。
nID
ツールバーの子ウィンドウの ID。

戻り値

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

解説

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

使用例

// This code fragment is taken from CMainFrame::OnCreate
// CMainFrame is derived from CMDIFrameWnd.

//This example creates a dockable toolbar.
if (!m_wndToolBar.Create(this) ||
   !m_wndToolBar.LoadToolBar(IDR_MAINFRAME))
{
   TRACE0("Failed to create toolbar\n");
   return -1;      // fail to create
}

//Make the toolbar dockable
m_wndToolBar.EnableDocking(CBRS_ALIGN_ANY);
EnableDocking(CBRS_ALIGN_ANY);
DockControlBar(&m_wndToolBar);