CreateToolbarEx-Funktion (commctrl.h)

Erstellt ein Symbolleistenfenster und fügt die angegebenen Schaltflächen der Symbolleiste hinzu.

Hinweis Diese Funktion ist veraltet, da sie nicht alle Funktionen von Symbolleisten unterstützt. Verwenden Sie stattdessen CreateWindowEx . Beispiele finden Sie unter Verwenden von Symbolleistensteuerelementen.

 

Syntax

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

Parameter

hwnd

Typ: HWND

Handle mit dem übergeordneten Fenster für die Symbolleiste.

ws

Typ: DWORD

Fensterstile für die Symbolleiste. Der WS_CHILD-Stil ist standardmäßig enthalten. Dieser Parameter kann auch eine Kombination von Formatvorlagen enthalten, wie unter Symbolleistensteuerelement und Schaltflächenstile erläutert.

wID

Typ: UINT

Steuerbezeichner für die Symbolleiste.

nBitmaps

Typ: int

Anzahl der Schaltflächenbilder, die in der von hBMInst und wBMID angegebenen Bitmap enthalten sind.

hBMInst

Typ: HINSTANCE

Das Modul instance mit der ausführbaren Datei, die die Bitmapressource enthält.

wBMID

Typ: UINT_PTR

Ressourcenbezeichner für die Bitmapressource. Wenn hBMInstNULL ist, muss es sich bei diesem Parameter um ein gültiges Bitmaphandle handeln.

lpButtons

Typ: LPCTBBUTTON

Zeiger auf ein Array von TBBUTTON-Strukturen , die Informationen zu den Schaltflächen enthalten, die der Symbolleiste hinzugefügt werden sollen.

iNumButtons

Typ: int

Anzahl der Schaltflächen, die der Symbolleiste hinzugefügt werden sollen.

dxButton

Typ: int

Breite der Schaltflächen, die der Symbolleiste hinzugefügt werden sollen, in Pixel.

dyButton

Typ: int

Höhe der Schaltflächen, die der Symbolleiste hinzugefügt werden sollen, in Pixel.

dxBitmap

Typ: int

Breite der Schaltflächenbilder in Pixel, die den Schaltflächen in der Symbolleiste hinzugefügt werden sollen.

dyBitmap

Typ: int

Höhe der Schaltflächenbilder in Pixel, die den Schaltflächen in der Symbolleiste hinzugefügt werden sollen.

uStructSize

Typ: UINT

Größe einer TBBUTTON-Struktur .

Rückgabewert

Typ: HWND

Gibt bei erfolgreicher Ausführung das Fensterhandle an die Symbolleiste zurück, andernfalls NULL . Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Windows 95: Das System kann maximal 16.364 Fensterhandles unterstützen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commctrl.h
Bibliothek	Comctl32.lib
DLL	Comctl32.dll
APIs	ext-ms-win-shell-comctl32-window-l1-1-0 (eingeführt in Windows 10, Version 10.0.14393)