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

ITaskbarList3::ThumbBarUpdateButtons

Taskleistenerweiterungen

Symbolleistenbeispiel für die Miniaturbild-Taskleiste