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 セット ext-ms-win-shell-comctl32-window-l1-1-0 (Windows 10 バージョン 10.0.14393 で導入)