CreateToolbarEx, fonction (commctrl.h)

Crée une fenêtre de barre d’outils et ajoute les boutons spécifiés à la barre d’outils.

Note Cette fonction est déconseillée, car elle ne prend pas en charge toutes les fonctionnalités des barres d’outils. Utilisez Plutôt CreateWindowEx . Pour obtenir des exemples, consultez Utilisation des contrôles de barre d’outils.

 

Syntaxe

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
);

Paramètres

hwnd

Type : HWND

Gérez vers la fenêtre parente de la barre d’outils.

ws

Type : DWORD

Styles de fenêtre pour la barre d’outils. Le style WS_CHILD est inclus par défaut. Ce paramètre peut également inclure une combinaison de styles, comme indiqué dans Contrôles de barre d’outils et Styles de bouton.

wID

Type : UINT

Identificateur de contrôle pour la barre d’outils.

nBitmaps

Type : int

Nombre d’images de bouton contenues dans la bitmap spécifiée par hBMInst et wBMID.

hBMInst

Type : HINSTANCE

Module instance avec le fichier exécutable qui contient la ressource bitmap.

wBMID

Type : UINT_PTR

Identificateur de ressource pour la ressource bitmap. Si hBMInst a la valeur NULL, ce paramètre doit être un handle bitmap valide.

lpButtons

Type : LPCTBBUTTON

Pointeur vers un tableau de structures TBBUTTON qui contiennent des informations sur les boutons à ajouter à la barre d’outils.

iNumButtons

Type : int

Nombre de boutons à ajouter à la barre d’outils.

dxButton

Type : int

Largeur, en pixels, des boutons à ajouter à la barre d’outils.

dyButton

Type : int

Hauteur, en pixels, des boutons à ajouter à la barre d’outils.

dxBitmap

Type : int

Largeur, en pixels, des images de bouton à ajouter aux boutons dans la barre d’outils.

dyBitmap

Type : int

Hauteur, en pixels, des images de bouton à ajouter aux boutons dans la barre d’outils.

uStructSize

Type : UINT

Taille d’une structure TBBUTTON .

Valeur retournée

Type : HWND

Retourne le handle de fenêtre à la barre d’outils en cas de réussite, ou NULL dans le cas contraire. Pour récupérer des informations d’erreur étendues, appelez GetLastError.

Remarques

Windows 95 : le système peut prendre en charge un maximum de 16 364 descripteurs de fenêtre.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	commctrl.h
Bibliothèque	Comctl32.lib
DLL	Comctl32.dll
Ensemble d’API	ext-ms-win-shell-comctl32-window-l1-1-0 (introduit dans Windows 10, version 10.0.14393)