CToolBarCtrl::Create

更新 : 2007 年 11 月

ツール バー コントロールを作成し、CToolBarCtrl オブジェクトに結び付けます。

virtual BOOL Create(
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID 
);

パラメータ

  • dwStyle
    ツール バー コントロールのスタイルを指定します。ツール バーは常に WS_CHILD スタイルを持ちます。さらに、「解説」で説明しているように、ツール バー スタイルや、ウィンドウ スタイルを組み合わせて指定できます。

  • rect
    ツール バー コントロールのサイズと位置をオプションで指定します。CRect オブジェクトまたは RECT 構造体のいずれかを指定します。

  • pParentWnd
    ツール バー コントロールの親ウィンドウを指定します。NULL は指定できません。

  • nID
    ツール バー コントロールの ID を指定します。

戻り値

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

解説

CToolBarCtrl は 2 ステップで構築します。まず、コンストラクタを呼び出します。その後、Create を呼び出してツール バー コントロールを作成し、CToolBarCtrl オブジェクトに関連付けます。ツール バー コントロールには次のウィンドウ スタイルが適用されます。

  • WS_CHILD   常時

  • WS_VISIBLE   通常

  • WS_DISABLED   まれ

ウィンドウ スタイルについては、Windows SDK の「CreateWindow」を参照してください。

オプションで、Windows SDK で説明されているコモン コントロール スタイルの組み合わせを適用できます。

ツール バー スタイルの組み合わせはコントロールまたはボタンのいずれにも適用できます。スタイルについては、Windows SDK の「Toolbar Control and Button Styles」を参照してください。

拡張ツール バー スタイルを使用するには、Create を呼び出してから SetExtendedStyle を呼び出します。拡張ウィンドウ スタイルのツール バーを作成するには、Create ではなく、CToolBarCtrl::CreateEx を呼び出します。

ツール バー コントロールは、自動的にツール バー ウィンドウのサイズと位置を設定します。高さは、ツール バーのボタンの高さを基準にします。幅は、親ウィンドウのクライアント領域の幅と同じです。CCS_TOP および CCS_BOTTOM スタイルは、ツール バーがクライアント領域の上端、または下端のどちらに配置されるかを決定します。既定で、ツール バーは CCS_TOP スタイルを持ちます。

必要条件

ヘッダー : afxcmn.h

参照

参照

CToolBarCtrl クラス

階層図

CToolBarCtrl::CToolBarCtrl

CToolBarCtrl::SetButtonStructSize

その他の技術情報

CToolBarCtrl のメンバ