TBADDBITMAP-Struktur (commctrl.h)

Artikel
03/01/2024

Fügt einer Symbolleiste eine Bitmap hinzu, die Schaltflächenbilder enthält.

Syntax

typedef struct tagTBADDBITMAP {
  HINSTANCE hInst;
  UINT_PTR  nID;
} TBADDBITMAP, *LPTBADDBITMAP;

Member

hInst

Typ: HINSTANCE

Verarbeiten Sie das Modul instance mit der ausführbaren Datei, die eine Bitmapressource enthält. Wenn Sie Bitmaphandles anstelle von Ressourcen-IDs verwenden möchten, legen Sie diesen Member auf NULL fest.

Sie können der Liste die systemdefinierte Schaltflächen-Bitmaps hinzufügen, indem Sie HINST_COMMCTRL als hInst-Member und einen der folgenden Werte als nID-Member angeben.

Wert	Bedeutung
IDB_STD_LARGE_COLOR	Große, farbige Standard-Bitmaps.
IDB_STD_SMALL_COLOR	Kleine, farbige Standard-Bitmaps.
IDB_VIEW_LARGE_COLOR	Kleine große Bitmaps in der Farbansicht.
IDB_VIEW_SMALL_COLOR	Kleine Bitmaps in der Farbansicht.
IDB_HIST_NORMAL	Windows Explorer Reiseschaltflächen und Favoriten-Bitmaps im normalen Zustand.
IDB_HIST_HOT	Windows Explorer Reiseschaltflächen und Favoriten-Bitmaps im heißen Zustand.
IDB_HIST_DISABLED	Windows Explorer Reiseschaltflächen und Favoriten-Bitmaps im deaktivierten Zustand.
IDB_HIST_PRESSED	Windows Explorer Reiseschaltflächen und Favoriten-Bitmaps im gedrückten Zustand.

nID

Typ: UINT_PTR

Wenn hInstNULL ist, legen Sie dieses Element auf das Bitmaphandle der Bitmap mit den Schaltflächenbildern fest. Legen Sie andernfalls den Ressourcenbezeichner der Bitmap mit den Schaltflächenbildern fest.

Hinweise

Wenn nID ein Bitmaphandle anstelle einer Ressourcen-ID enthält, zerstören Sie die Bitmap erst, wenn sie durch TB_REPLACEBITMAP ersetzt wurde. Andernfalls wird die Symbolleiste zerstört.

Definierte Werte können als Indizes für die Standard-Bitmaps verwendet werden. Weitere Informationen finden Sie unter Symbolindexwerte der Symbolleisten-Standardschaltfläche.

Die TBADDBITMAP-Struktur wird mit der TB_ADDBITMAP-Nachricht verwendet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	commctrl.h

Share via