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
程式庫	Comctl32.lib
Dll	Comctl32.dll
API 集合	ext-ms-win-shell-comctl32-window-l1-1-0 (於 Windows 10 10.0.14393 版中引進)