CreateToolbarEx 函数 (commctrl.h)

创建工具栏窗口，并将指定的按钮添加到工具栏。

注意 此函数已弃用，因为它不支持工具栏的所有功能。 请改用 CreateWindowEx 。 有关示例，请参阅 使用工具栏控件。

 

语法

HWND CreateToolbarEx(
  HWND        hwnd,
  DWORD       ws,
  UINT        wID,
  int         nBitmaps,
  HINSTANCE   hBMInst,
  UINT_PTR    wBMID,
  LPCTBBUTTON lpButtons,
  int         iNumButtons,
  int         dxButton,
  int         dyButton,
  int         dxBitmap,
  int         dyBitmap,
  UINT        uStructSize
);

参数

hwnd

类型： HWND

工具栏的父窗口的句柄。

ws

类型： DWORD

工具栏的窗口样式。 默认包含 WS_CHILD 样式。 此参数还可以包括工具栏 控件和按钮样式中所述的样式组合。

wID

类型： UINT

工具栏的控件标识符。

nBitmaps

类型： int

hBMInst 和 wBMID 指定的位图中包含的按钮图像数。

hBMInst

类型： HINSTANCE

包含包含位图资源的可执行文件的模块实例。

wBMID

类型： UINT_PTR

位图资源的资源标识符。 如果 hBMInst 为 NULL，则此参数必须是有效的位图句柄。

lpButtons

类型： LPCTBBUTTON

指向 TBBUTTON 结构的数组的指针，该数组包含有关要添加到工具栏的按钮的信息。

iNumButtons

类型： int

要添加到工具栏的按钮数。

dxButton

类型： int

要添加到工具栏的按钮的宽度（以像素为单位）。

dyButton

类型： int

要添加到工具栏的按钮的高度（以像素为单位）。

dxBitmap

类型： int

要添加到工具栏中的按钮的按钮图像的宽度（以像素为单位）。

dyBitmap

类型： int

要添加到工具栏中的按钮的按钮图像的高度（以像素为单位）。

uStructSize

类型： UINT

TBBUTTON 结构的大小。

返回值

类型： HWND

如果成功，则返回工具栏的窗口句柄，否则返回 NULL 。 若要检索扩展的错误信息，请调用 GetLastError。

注解

Windows 95：系统最多可支持 16,364 个窗口句柄。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	commctrl.h
Library	Comctl32.lib
DLL	Comctl32.dll
API 集	Windows 10版本 10.0.14393 中引入的 ext-ms-win-shell-comctl32-window-l1-1-0 ()