CreateToolbarEx, fonction (commctrl.h)
Crée une fenêtre de barre d’outils et ajoute les boutons spécifiés à la 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) |