Freigeben über


Symbolleistensteuerelemente und Schaltflächenformate

Die folgenden Fensterstile sind spezifisch für Symbolleisten. Sie werden beim Erstellen der Symbolleiste mit anderen Fensterformaten kombiniert.

Hinweis Wenn für allgemeine Steuerelemente Version 6.00 ein visueller Stil mit der Symbolleiste verwendet wird, sind Schaltflächen unabhängig von der Stileinstellung immer transparent. Andernfalls ist das Transparenzverhalten normal, wie durch die Verwendung des TBSTYLE_FLAT- oder TBSTYLE_TRANSPARENT-Stils angegeben.

Hinweis

Comctl32.dll Version 6 ist nicht verteilbar, aber in Windows enthalten. Um Comctl32.dll Version 6 zu verwenden, geben Sie sie in einem Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

Konstante BESCHREIBUNG
TBSTYLE_ALTDRAG
Ermöglicht Benutzern, die Position einer Symbolleistenschaltfläche zu ändern, indem Sie sie ziehen, während Sie die ALT-TASTE gedrückt halten. Wenn diese Formatvorlage nicht angegeben ist, muss der Benutzer die UMSCHALTTASTE gedrückt halten, während er eine Schaltfläche zieht. Beachten Sie, dass die CCS_ADJUSTABLE Stil angegeben werden muss, damit Symbolleistenschaltflächen gezogen werden können.
TBSTYLE_CUSTOMERASE
Version 4.70. Generiert NM_CUSTOMDRAW Benachrichtigungscodes, wenn die Symbolleiste WM_ERASEBKGND Nachrichten verarbeitet.
TBSTYLE_FLAT
Version 4.70. Erstellt eine flache Symbolleiste. In einer flachen Symbolleiste sind sowohl die Symbolleiste als auch die Schaltflächen transparent, und die Hot-Tracking-Funktion ist aktiviert. Schaltflächentext wird unter Schaltflächen bitmaps angezeigt. Um Probleme beim Neulackieren zu vermeiden, sollte diese Formatvorlage festgelegt werden, bevor das Symbolleistensteuerelement sichtbar wird.
TBSTYLE_LIST
Version 4.70. Erstellt eine flache Symbolleiste mit Schaltflächentext rechts neben der Bitmap. Andernfalls ist dieser Stil mit TBSTYLE_FLAT identisch. Um Probleme beim Neulackieren zu vermeiden, sollte diese Formatvorlage festgelegt werden, bevor das Symbolleistensteuerelement sichtbar wird.
TBSTYLE_REGISTERDROP
Version 4.71. Generiert TBN_GETOBJECT Benachrichtigungscodes, um das Löschen von Zielobjekten anzufordern, wenn der Cursor symbolleistenschaltflächen übergeht.
TBSTYLE_TOOLTIPS
Erstellt ein QuickInfo-Steuerelement, das eine Anwendung verwenden kann, um beschreibenden Text für die Schaltflächen in der Symbolleiste anzuzeigen.
TBSTYLE_TRANSPARENT
Version 4.71. Erstellt eine transparente Symbolleiste. In einer transparenten Symbolleiste ist die Symbolleiste transparent, die Schaltflächen jedoch nicht. Schaltflächentext wird unter Schaltflächen bitmaps angezeigt. Um Probleme beim Neulackieren zu vermeiden, sollte diese Formatvorlage festgelegt werden, bevor das Symbolleistensteuerelement sichtbar wird.
TBSTYLE_WRAPABLE
Erstellt eine Symbolleiste, die mehrere Schaltflächenzeilen aufweisen kann. Symbolleistenschaltflächen können in die nächste Zeile "umschließen", wenn die Symbolleiste zu schmal wird, um alle Schaltflächen in derselben Zeile einzuschließen. Wenn die Symbolleiste umschlossen ist, tritt der Umbruch entweder auf dem Trennzeichen ganz rechts oder auf der schaltfläche ganz rechts auf, wenn keine Trennzeichen auf der Leiste vorhanden sind. Diese Formatvorlage muss so festgelegt werden, dass ein vertikales Symbolleistensteuerelement angezeigt wird, wenn die Symbolleiste Teil eines vertikalen Leistensteuerelements ist. Dieser Stil kann nicht mit CCS_VERT kombiniert werden.

Hinweis: Eine Symbolleistenschaltfläche kann eine Kombination der folgenden Stile aufweisen. Um eine Schaltflächenart anzugeben, legen Sie die entsprechenden Flags im fsStyle-Member der TBBUTTON-Struktur der Schaltfläche fest. Nicht alle Stile können kombiniert werden.

Für Shell version 4.72 und früher hatten sowohl Fenster- als auch Schaltflächenformatflags das Formular TBSTYLE_XXX. Wenn Sie eine Anwendung mit Version 4.72 oder früher von Commctrl.h kompilieren, müssen Sie die TBSTYLE_XXX-Schaltflächenformatflags verwenden. Ab Version 5.80 verfügen alle Schaltflächenformatvorlagen über das Formular BTNS_XXX. Alle TBSTYLE_XXX-Werte verfügen über gleichwertige BTNS_XXX-Werte mit der gleichen Bedeutung und demselben numerischen Wert. Der Einfachheit halber sind beide Formulare in der folgenden Tabelle aufgeführt.

Konstante BESCHREIBUNG
BTNS_AUTOSIZE
Version 5.80. Gibt an, dass das Symbolleistensteuerelement der Schaltfläche nicht die Standardbreite zuweisen soll. Stattdessen wird die Breite der Schaltfläche basierend auf der Breite des Texts und dem Bild der Schaltfläche berechnet. Verwenden Sie das entsprechende Formatflag TBSTYLE_AUTOSIZE für Version 4.72 und früher.
BTNS_BUTTON
Version 5.80. Erstellt eine Standardschaltfläche. Verwenden Sie das entsprechende Formatflag TBSTYLE_BUTTON für Version 4.72 und früher. Dieses Flag ist als 0 definiert und sollte verwendet werden, um zu signalisieren, dass keine anderen Flags festgelegt sind.
BTNS_CHECK
Version 5.80. Erstellt eine Drucktaste mit zwei Zustanden, die jedes Mal zwischen dem gedrückten und dem nicht komprimierten Zustand umschaltet, wenn der Benutzer darauf klickt. Die Schaltfläche hat eine andere Hintergrundfarbe, wenn sie sich im gedrückten Zustand befindet. Verwenden Sie das entsprechende Formatflag TBSTYLE_CHECK für Version 4.72 und früher.
BTNS_CHECKGROUP
Version 5.80. Erstellt eine Schaltfläche, die gedrückt bleibt, bis eine andere Schaltfläche in der Gruppe gedrückt wird, ähnlich wie Optionsschaltflächen (auch als Optionsfelder bezeichnet). Es entspricht der Kombination von BTNS_CHECK und BTNS_GROUP. Verwenden Sie das entsprechende Formatflag TBSTYLE_CHECKGROUP für Version 4.72 und früher.
BTNS_DROPDOWN
Version 5.80. Erstellt eine Dropdownformatschaltfläche, die eine Liste anzeigen kann, wenn auf die Schaltfläche geklickt wird. Anstelle der WM_COMMAND Nachricht, die für normale Schaltflächen verwendet wird, senden Dropdownschaltflächen einen TBN_DROPDOWN Benachrichtigungscode. Eine Anwendung kann dann eine Liste von Optionen im Benachrichtigungshandler anzeigen lassen. Verwenden Sie das entsprechende Formatflag TBSTYLE_DROPDOWN für Version 4.72 und früher.
Wenn die Symbolleiste den TBSTYLE_EX_DRAWDDARROWS erweiterten Stil aufweist, wird in Dropdownschaltflächen ein Dropdownpfeil in einem separaten Abschnitt auf der rechten Seite angezeigt. Wenn auf den Pfeil geklickt wird, wird ein TBN_DROPDOWN Benachrichtigungscode gesendet. Wenn auf die zugeordnete Schaltfläche geklickt wird, wird eine WM_COMMAND Nachricht gesendet.
BTNS_GROUP
Version 5.80. Erstellt in Kombination mit BTNS_CHECK eine Schaltfläche, die gedrückt bleibt, bis eine andere Schaltfläche in der Gruppe gedrückt wird. Verwenden Sie das entsprechende Formatflag TBSTYLE_GROUP für Version 4.72 und früher.
BTNS_NOPREFIX
Version 5.80. Gibt an, dass dem Schaltflächentext kein Beschleunigerpräfix zugeordnet ist. Verwenden Sie das entsprechende Formatflag TBSTYLE_NOPREFIX für Version 4.72 und früher.
BTNS_SEP
Version 5.80. Erstellt ein Trennzeichen, das eine kleine Lücke zwischen Schaltflächengruppen bereitstellt. Eine Schaltfläche mit diesem Stil empfängt keine Benutzereingabe. Verwenden Sie das entsprechende Formatflag TBSTYLE_SEP für Version 4.72 und früher.
BTNS_SHOWTEXT
Version 5.81. Gibt an, dass Schaltflächentext angezeigt werden soll. Alle Schaltflächen können Text haben, aber nur die Schaltflächen mit der BTNS_SHOWTEXT Schaltflächenformat werden angezeigt. Diese Schaltflächenart muss mit der TBSTYLE_LIST-Formatvorlage und der erweiterten TBSTYLE_EX_MIXEDBUTTONS verwendet werden. Wenn Sie Text für Schaltflächen festlegen, die nicht über das BTNS_SHOWTEXT Format verfügen, zeigt das Symbolleistensteuerelement diesen automatisch als QuickInfo an, wenn der Cursor über die Schaltfläche bewegt wird. Mit diesem Feature kann Ihre Anwendung die Verarbeitung des TBN_GETINFOTIP oder TTN_GETDISPINFO Benachrichtigungscodes für die Symbolleiste vermeiden.
BTNS_WHOLEDROPDOWN
Version 5.80. Gibt an, dass die Schaltfläche über einen Dropdownpfeil verfügt, aber nicht als separater Abschnitt. Schaltflächen mit dieser Formatvorlage verhalten sich gleich, unabhängig davon, ob die TBSTYLE_EX_DRAWDDARROWS erweiterten Formatvorlage festgelegt ist.
TBSTYLE_AUTOSIZE
Entspricht BTNS_AUTOSIZE. Verwenden Sie TBSTYLE_AUTOSIZE für Version 4.72 und früher.
TBSTYLE_BUTTON
Entspricht BTNS_BUTTON. Verwenden Sie TBSTYLE_BUTTON für Version 4.72 und früher.
TBSTYLE_CHECK
Entspricht BTNS_CHECK. Verwenden Sie TBSTYLE_CHECK für Version 4.72 und früher.
TBSTYLE_CHECKGROUP
Entspricht BTNS_CHECKGROUP. Verwenden Sie TBSTYLE_CHECKGROUP für Version 4.72 und früher.
TBSTYLE_DROPDOWN
Entspricht BTNS_DROPDOWN. Verwenden Sie TBSTYLE_DROPDOWN für Version 4.72 und früher.
TBSTYLE_GROUP
Entspricht BTNS_GROUP. Verwenden Sie TBSTYLE_GROUP für Version 4.72 und früher.
TBSTYLE_NOPREFIX
Entspricht BTNS_NOPREFIX. Verwenden Sie TBSTYLE_NOPREFIX für Version 4.72 und früher.
TBSTYLE_SEP
Entspricht BTNS_SEP. Verwenden Sie TBSTYLE_SEP für Version 4.72 und früher.

Anforderungen

Anforderung Wert
Header
CommCtrl.h