CToolBarCtrl::Create

创建一个工具栏控件并将它附加到 CToolBarCtrl 对象。

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

参数

  • dwStyle
    指定工具栏控件的样式。工具栏必须始终有 WS_CHILD 样式。此外,还可以指定工具栏样式和窗口样式的任意组合所介绍 Remarks下。

  • rect
    (可选)指定工具栏控件的大小和位置。它可以是 CRect 对象或 RECT 结构。

  • pParentWnd
    指定工具栏控件的父窗口。不能为 NULL

  • nID
    指定工具栏控件的ID.

返回值

非零,如果成功;否则零。

备注

在构造在两个步骤的 CToolBarCtrl。首先,调用构造函数,然后调用 Create,创建工具栏控件并将它附加到 CToolBarCtrl 对象。将以下窗口样式应用于工具栏控件。

  • 始终WS_CHILD

  • 通常WS_VISIBLE

  • 少见WS_DISABLED

为窗口样式的声明参见。Windows SDK 的 CreateWindow

或者,请将 公共控件的样式的组合,如 Windows SDK所述。

适用于工具栏样式的组合控件或按钮。样式在 Windows SDK的主题 工具栏控件和按钮样式 所述。

在调用 Create后,若要使用扩展工具栏样式,请调用 SetExtendedStyle。用扩展窗口样式若要创建工具栏,请调用 CToolBarCtrl::CreateEx 而不是 Create

工具栏控件自动设置工具栏窗口的大小和位置。该高度基于按钮高度工具栏上的。此宽度相当于父窗口工作区的宽度。CCS_TOPCCS_BOTTOM 样式确定工具栏是否沿工作区的顶部或底部。默认情况下,工具栏具有 CCS_TOP 样式。

要求

Header: afxcmn.h

请参见

参考

CToolBarCtrl选件类

层次结构图

服务

CToolBarCtrl::SetButtonStructSize