THUMBBUTTON-Struktur (shobjidl_core.h)
Wird von Methoden der ITaskbarList3-Schnittstelle verwendet, um Schaltflächen zu definieren, die in einer Symbolleiste verwendet werden, die in die Miniaturansicht eines Fensters eingebettet ist.
Syntax
typedef struct THUMBBUTTON {
THUMBBUTTONMASK dwMask;
UINT iId;
UINT iBitmap;
HICON hIcon;
WCHAR szTip[260];
THUMBBUTTONFLAGS dwFlags;
} THUMBBUTTON, *LPTHUMBBUTTON;
Member
dwMask
Typ: THUMBBUTTONMASK
Eine Kombination aus THUMBBUTTONMASK-Werten , die angeben, welche Member dieser Struktur gültige Daten enthalten; Andere Member werden ignoriert, mit Ausnahme von iId, die immer erforderlich ist.
iId
Typ: UINT
Der anwendungsdefinierte Bezeichner der Schaltfläche, eindeutig innerhalb der Symbolleiste.
iBitmap
Typ: UINT
Der nullbasierte Index des Schaltflächenbilds innerhalb der Bildliste, der über ITaskbarList3::ThumbBarSetImageList festgelegt ist.
hIcon
Typ: HICON
Das Handle eines Symbols, das als Schaltflächenbild verwendet werden soll.
szTip[260]
Typ: WCHAR[260]
Ein Breitzeichenarray, das den Text der QuickInfo der Schaltfläche enthält, die angezeigt wird, wenn der Mauszeiger über die Schaltfläche bewegt wird.
dwFlags
Typ: THUMBBUTTONFLAGS
Eine Kombination aus THUMBBUTTONFLAGS-Werten , die bestimmte Zustände und Verhaltensweisen der Schaltfläche steuern.
Hinweise
Wenn auf eine Schaltfläche geklickt wird, wird eine WM_COMMAND Nachricht, die die Schaltflächen-ID enthält, an das zugeordnete Anwendungsfenster gesendet. Die Anwendung verarbeitet jede Aktion, die sie der Schaltfläche zugewiesen hat.
Schaltflächenbilder
Bei Verwendung eines Symbols, das über den hIcon-Member angegeben wird, erstellt die Taskleiste eine eigene Kopie des Symbols. Es liegt in der Verantwortung des Aufrufers, den in hIcon übergebenen Handle frei zu geben, wenn er nicht mehr benötigt wird.Wenn sowohl ein Symbol als auch eine Bildliste für das Bild einer Schaltfläche angegeben sind, wird das Symbol nach Möglichkeit verwendet. Wenn der Versuch, das Symbol abzurufen, aus irgendeinem Grund fehlschlägt, wird das Bild aus der Bildliste verwendet.
Anwendungen müssen die folgenden Schaltflächenbilder bereitstellen:
- Die Schaltfläche im aktiven Standardzustand.
- Bilder, die für die Verwendung mit Displays mit hoher DPI-Auflösung (Punkt pro Zoll) geeignet sind.
Bilder müssen 32-Bit und die Dimensionen GetSystemMetrics(SM_CXICON) x GetSystemMetrics(SM_CYICON) aufweisen. Die Symbolleiste selbst stellt Visuals für den Klick-, Deaktiviert- und Hoverstatus einer Schaltfläche bereit.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Kopfzeile | shobjidl_core.h (shobjidl.h einschließen) |
Weitere Informationen
ITaskbarList3::ThumbBarAddButtons