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::SetButtonStructSize