Funzione CreateToolbarEx (commctrl.h)

Crea una finestra della barra degli strumenti e aggiunge i pulsanti specificati alla barra degli strumenti.

Nota Questa funzione è deprecata perché non supporta tutte le funzionalità delle barre degli strumenti. Usare invece CreateWindowEx . Per esempi, vedere Uso dei controlli della barra degli strumenti.

 

Sintassi

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

Parametri

hwnd

Tipo: HWND

Handle nella finestra padre della barra degli strumenti.

ws

Tipo: DWORD

Stili di finestra per la barra degli strumenti. Lo stile WS_CHILD è incluso per impostazione predefinita. Questo parametro può includere anche una combinazione di stili, come descritto in Controllo barra degli strumenti e Stili pulsante.

wID

Tipo: UINT

Identificatore di controllo per la barra degli strumenti.

nBitmaps

Tipo: int

Numero di immagini pulsante contenute nella bitmap specificata da hBMInst e wBMID.

hBMInst

Tipo: HINSTANCE

Istanza del modulo con il file eseguibile che contiene la risorsa bitmap.

wBMID

Tipo: UINT_PTR

Identificatore di risorsa per la risorsa bitmap. Se hBMInst è NULL, questo parametro deve essere un handle bitmap valido.

lpButtons

Tipo: LPCTBBUTTON

Puntatore a una matrice di strutture TBBUTTON che contengono informazioni sui pulsanti da aggiungere alla barra degli strumenti.

iNumButtons

Tipo: int

Numero di pulsanti da aggiungere alla barra degli strumenti.

dxButton

Tipo: int

Larghezza, in pixel, dei pulsanti da aggiungere alla barra degli strumenti.

dyButton

Tipo: int

Altezza, in pixel, dei pulsanti da aggiungere alla barra degli strumenti.

dxBitmap

Tipo: int

Larghezza, in pixel, delle immagini del pulsante da aggiungere ai pulsanti nella barra degli strumenti.

dyBitmap

Tipo: int

Altezza, in pixel, delle immagini dei pulsanti da aggiungere ai pulsanti nella barra degli strumenti.

uStructSize

Tipo: UINT

Dimensioni di una struttura TBBUTTON .

Valore restituito

Tipo: HWND

Restituisce l'handle della finestra sulla barra degli strumenti, se l'operazione ha esito positivo o NULL in caso contrario. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

Windows 95: il sistema può supportare un massimo di 16.364 handle di finestra.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commctrl.h
Libreria	Comctl32.lib
DLL	Comctl32.dll
Set di API	ext-ms-win-shell-comctl32-window-l1-1-0 (introdotto in Windows 10, versione 10.0.14393)