CToolBarCtrl-Klasse

Artikel
06/10/2015

Stellt die Funktionalität der Windows-Symbolleistengemeinsamen allgemeinen ToolTip-Steuerelement bereit.

class CToolBarCtrl : public CWnd

Mitglieder

Öffentliche Konstruktoren

Name	Description
CToolBarCtrl::CToolBarCtrl	Erstellt ein CToolBarCtrl-Objekt.

Öffentliche Methoden

Name	Description
CToolBarCtrl::AddBitmap	Fügt eine oder mehrere Bit-Übersichtsschaltflächensymbole der Liste der Schaltflächenbilder hinzu, die für ein ToolBar-Steuerelement verfügbar sind.
CToolBarCtrl::AddButtons	Fügt eine oder mehrere Schaltflächen einem ToolBar-Steuerelement hinzu.
CToolBarCtrl::AddString	Fügt eine neue Zeichenfolge hinzu, übergeben als Ressourcen-ID, der internen Liste der Symbolleiste von Zeichenfolgen.
CToolBarCtrl::AddStrings	Fügt eine neue Zeichenfolge oder Zeichenfolgen hinzu, übergeben wie ein Zeiger einem Puffer von NULL-getrennten Zeichenfolgen, zur internen Liste der Symbolleiste von Zeichenfolgen.
CToolBarCtrl::AutoSize	Ändert ein ToolBar-Steuerelement Größe.
CToolBarCtrl::ChangeBitmap	Ändert die Bitmap für eine Schaltfläche im aktuellen ToolBar-Steuerelement.
CToolBarCtrl::CheckButton	Überprüfungen oder freie Räume eine angegebene Schaltfläche in einem ToolBar-Steuerelement.
CToolBarCtrl::CommandToIndex	Ruft den nullbasierten Index für die Schaltfläche ab, die dem angegebenen Befehlskennzeichen zugeordnet ist.
CToolBarCtrl::Create	Erstellt ein ToolBar-Steuerelement und fügt es zu einem CToolBarCtrl-Objekt.
CToolBarCtrl::CreateEx	Erstellt ein ToolBar-Steuerelement mit den angegebenen Windows-erweitertenFormaten und fügt es zu einem CToolBarCtrl-Objekt.
CToolBarCtrl::Customize	Zeigt das Anpassens-Symbolleistendialogfeld an.
CToolBarCtrl::DeleteButton	Löscht eine Schaltfläche aus ToolBar-Steuerelement.
CToolBarCtrl::EnableButton	Aktiviert oder deaktiviert die angegebene Schaltfläche in einem ToolBar-Steuerelement.
CToolBarCtrl::GetAnchorHighlight	Ruft die Anker-Hervorhebungseinstellung für eine Symbolleiste ab.
CToolBarCtrl::GetBitmap	Ruft den Index der Bitmap ab, die mit einer Schaltfläche in einer Symbolleiste zugeordnet ist.
CToolBarCtrl::GetBitmapFlags	Ruft die Flags ab, die mit der Bitmap der Symbolleiste zugeordnet werden.
CToolBarCtrl::GetButton	Ruft Informationen über die angegebene Schaltfläche in einem ToolBar-Steuerelement ab.
CToolBarCtrl::GetButtonCount	Ruft eine Anzahl der Schaltflächen derzeit im ToolBar-Steuerelement ab.
CToolBarCtrl::GetButtonInfo	Ruft die Informationen für eine Schaltfläche in einer Symbolleiste ab.
CToolBarCtrl::GetButtonSize	Ruft die aktuelle Breite und Höhe Symbolleisten-Schaltflächen, in Pixel ab.
CToolBarCtrl::GetColorScheme	Ruft das Farbschema des aktuellen Symbolleisten-Steuerelements ab.
CToolBarCtrl::GetDisabledImageList	Ruft die Bildliste ab, die ein ToolBar-Steuerelement verwendet, um deaktivierte Schaltflächen anzuzeigen.
CToolBarCtrl::GetDropTarget	Ruft die IDropTarget-Schnittstelle für ein ToolBar-Steuerelement ab.
CToolBarCtrl::GetExtendedStyle	Ruft die erweiterten Formate für ein ToolBar-Steuerelement ab.
CToolBarCtrl::GetHotImageList	Ruft die Bildliste ab, die ein ToolBar-Steuerelement verwendet, um "heiße" Schaltflächen anzuzeigen. Eine aktive Schaltfläche wird hervorgehoben, wenn der Mauszeiger darüber befindet.
CToolBarCtrl::GetHotItem	Ruft den Index des hervorgehobenen Elements in einer Symbolleiste ab.
CToolBarCtrl::GetImageList	Ruft die Bildliste ab, die ein ToolBar-Steuerelement verwendet, um Schaltflächen im Standardzustand anzuzeigen.
CToolBarCtrl::GetInsertMark	Ruft die aktuelle Einfügemarke für die Symbolleiste ab.
CToolBarCtrl::GetInsertMarkColor	Ruft die Farbe ab, die verwendet wird, um die Einfügemarke für die Symbolleiste zu zeichnen.
CToolBarCtrl::GetItemRect	Ruft das umschließende Rechteck einer Schaltfläche in einem ToolBar-Steuerelement ab.
CToolBarCtrl::GetMaxSize	Ruft die Gesamtgröße aller sichtbaren Schaltflächen und Trennzeichen in der Symbolleiste ab.
CToolBarCtrl::GetMaxTextRows	Ruft die maximale Anzahl von Textzeilen ab, die auf einer Symbolleistenschaltfläche angezeigt werden.
CToolBarCtrl::GetMetrics	Ruft die Metriken eines Symbolleisten-Steuerelements ab.
CToolBarCtrl::GetPadding	Ruft die horizontale und vertikale Abstand des aktuellen Symbolleisten-Steuerelements ab.
CToolBarCtrl::GetPressedImageList	Ruft die Bildliste ab, der das aktuelle ToolBar-Steuerelement verwendet, um Schaltflächen im gedrückten Zustand darzustellen.
CToolBarCtrl::GetRect	Ruft das umschließende Rechteck für eine angegebene Symbolleisten-Schaltfläche ab.
CToolBarCtrl::GetRows	Ruft die Anzahl von Zeilen aus den Schaltflächen ab, die derzeit in der Symbolleiste angezeigt werden.
CToolBarCtrl::GetState	Ruft Informationen über den Zustand der angegebenen Schaltfläche in einem ToolBar-Steuerelement, wie ab, ob es aktiviert, gedrückt oder überprüft wird.
CToolBarCtrl::GetString	Ruft eine Symbolleistenzeichenfolge ab.
CToolBarCtrl::GetStyle	Ruft die Stile derzeit für ein ToolBar-Steuerelement ab.
CToolBarCtrl::GetToolTips	Ruft das Handle des ToolTip-Steuerelements ggf. ab, mit dem ToolBar-Steuerelement zugeordnet.
CToolBarCtrl::HideButton	blendet oder zeigt die angegebene Schaltfläche in einem ToolBar-Steuerelement.
CToolBarCtrl::HitTest	Bestimmt, wo ein Punkt in einem ToolBar-Steuerelement liegt.
CToolBarCtrl::Indeterminate	Setzt oder freie Räume der unbestimmte (graue) Zustand der angegebenen Schaltfläche in einem ToolBar-Steuerelement.
CToolBarCtrl::InsertButton	Fügt eine Schaltfläche in einem ToolBar-Steuerelement ein.
CToolBarCtrl::InsertMarkHitTest	Ruft die Einfügemarkeninformationen für einen Punkt in einer Symbolleiste ab.
CToolBarCtrl::IsButtonChecked	Teilt mit, ob die angegebene Schaltfläche in einem ToolBar-Steuerelement überprüft wird.
CToolBarCtrl::IsButtonEnabled	Teilt mit, ob die angegebene Schaltfläche in einem ToolBar-Steuerelement aktiviert ist.
CToolBarCtrl::IsButtonHidden	Teilt mit, ob die angegebene Schaltfläche in einem ToolBar-Steuerelement ausgeblendet ist.
CToolBarCtrl::IsButtonHighlighted	Überprüft den Hervorhebungszustand der Symbolleisten-Schaltfläche.
CToolBarCtrl::IsButtonIndeterminate	Teilt mit, dass der Zustand der angegebenen Schaltfläche in einem ToolBar-Steuerelement unbestimmt ist (grau).
CToolBarCtrl::IsButtonPressed	Teilt mit, ob die angegebene Schaltfläche in einem ToolBar-Steuerelement gedrückt wird.
CToolBarCtrl::LoadImages	Lastbitmaps in die Bildliste eines Symbolleisten-Steuerelements.
CToolBarCtrl::MapAccelerator	Ordnet ein Zugriffstastenzeichen zu einer Symbolleistenschaltfläche zu.
CToolBarCtrl::MarkButton	Legt den Hervorhebungszustand einer angegebenen Schaltfläche in einem ToolBar-Steuerelement fest.
CToolBarCtrl::MoveButton	Verschiebt eine Schaltfläche von einem Index auf andere.
CToolBarCtrl::PressButton	Pressen oder Versionen die angegebene Schaltfläche in einem ToolBar-Steuerelement.
CToolBarCtrl::ReplaceBitmap	Ersetzt die vorhandene Bitmap im aktuellen ToolBar-Steuerelement durch eine neue Bitmap.
CToolBarCtrl::RestoreState	Stellt den Zustand des Symbolleisten-Steuerelements wiederher.
CToolBarCtrl::SaveState	Rettet den Zustand des Symbolleisten-Steuerelements.
CToolBarCtrl::SetAnchorHighlight	Legt die Anker-Hervorhebungseinstellung für eine Symbolleiste fest.
CToolBarCtrl::SetBitmapSize	Legt die Größe der zu einem ToolBar-Steuerelement fest hinzugefügt werden Bitmapbilder.
CToolBarCtrl::SetButtonInfo	Legt die Informationen für eine vorhandene Schaltfläche in einer Symbolleiste fest.
CToolBarCtrl::SetButtonSize	Legt die Größe der zu einem ToolBar-Steuerelement fest hinzugefügt werden, Schaltflächen.
CToolBarCtrl::SetButtonStructSize	Gibt die Größe der TBBUTTON-Struktur an.
CToolBarCtrl::SetButtonWidth	Legt die minimalen und maximalen Schaltflächenbreiten im ToolBar-Steuerelement fest.
CToolBarCtrl::SetCmdID	Legt das dem fest Besitzerfenster gesendet werden Befehlskennzeichen, wenn die angegebene Schaltfläche gedrückt wird.
CToolBarCtrl::SetColorScheme	Legt das Farbschema des aktuellen Symbolleisten-Steuerelements fest.
CToolBarCtrl::SetDisabledImageList	Legt die Bildliste fest, der das ToolBar-Steuerelement verwendet, um deaktivierte Schaltflächen anzuzeigen.
CToolBarCtrl::SetDrawTextFlags	Legt die Flags in der Win32-Funktion DrawText, die verwendet wird, um den Text im angegebenen Rechteck gezeichnet, formatiert entsprechend fest, wie die Flags festgelegt werden.
CToolBarCtrl::SetExtendedStyle	Legt die erweiterten Formate für ein ToolBar-Steuerelement fest.
CToolBarCtrl::SetHotImageList	Legt die Bildliste fest, der das ToolBar-Steuerelement verwendet, um "heiße" Schaltflächen anzuzeigen.
CToolBarCtrl::SetHotItem	Legt das hervorgehobene Element in einer Symbolleiste fest.
CToolBarCtrl::SetImageList	Legt die Bildliste fest, der die Symbolleiste verwendet, um Schaltflächen anzuzeigen, die im Standardzustand sind.
CToolBarCtrl::SetIndent	Legt den Einzug für die erste Schaltfläche in einem ToolBar-Steuerelement fest.
CToolBarCtrl::SetInsertMark	Legt die aktuelle Einfügemarke für die Symbolleiste fest.
CToolBarCtrl::SetInsertMarkColor	Legt die Farbe fest, die verwendet wird, um die Einfügemarke für die Symbolleiste zu zeichnen.
CToolBarCtrl::SetMaxTextRows	Legt die maximale Anzahl von Textzeilen fest, die auf einer Symbolleistenschaltfläche angezeigt werden.
CToolBarCtrl::SetMetrics	Legt die Eigenschaften eines Symbolleisten-Steuerelements fest.
CToolBarCtrl::SetOwner	Legt das Fenster, um Benachrichtigungsmeldungen vom ToolBar-Steuerelement zu empfangen.
CToolBarCtrl::SetPadding	Legt die horizontale und vertikale Abstand des aktuellen Symbolleisten-Steuerelements fest.
CToolBarCtrl::SetPressedImageList	Legt die Bildliste fest, der das aktuelle ToolBar-Steuerelement verwendet, um Schaltflächen im gedrückten Zustand darzustellen.
CToolBarCtrl::SetRows	Legt die Anzahl von Zeilen aus den Schaltflächen fest, die auf der Symbolleiste angezeigt werden.
CToolBarCtrl::SetState	Legt den Zustand für die angegebene Schaltfläche in einem ToolBar-Steuerelement fest.
CToolBarCtrl::SetStyle	Legt die Stile für ein ToolBar-Steuerelement fest.
CToolBarCtrl::SetToolTips	Ordnet ein QuickInfo-Steuerelement mit dem ToolBar-Steuerelement zu.
CToolBarCtrl::SetWindowTheme	Legt den visuellen Stil eines Symbolleisten-Steuerelements fest.

Hinweise

Dieses Steuerelement (und daher die CToolBarCtrl-Klasse) ist nur für - Programmen verfügbar, die unter Windows 95/98- und Windows NT 3,51 und höher ausgeführt werden.

Eine Windows-Symbolleistengemeinsame allgemeinen ToolTip-Steuerelement ist ein rechteckiges untergeordnetes Fenster, das eine oder mehrere Schaltflächen enthält. Diese Schaltflächen können ein Bitmapbild, eine Zeichenfolge oder beide anzeigen. Wenn der Benutzer eine Schaltfläche auswählt, sendet sie eine Befehlsmeldung auf Besitzerfenster der Symbolleiste. In der Regel entsprechen die Schaltflächen in einer Symbolleiste an Elementen im Menü der Anwendung; Sie stellen eine direktere Möglichkeit, sodass der Benutzer auf die Befehle einer Anwendung zugreift.

CToolBarCtrl-Objekte enthalten einige wichtige interne Datenstrukturen: eine Liste von Schaltflächensymbolbitmaps oder Bildliste, Liste von Schaltflächenbezeichnungszeichenfolgen und Liste von TBBUTTON-Strukturen, die ein Bild zuordnen und/oder Zeichenfolge mit der Position, formatieren, angeben und von Befehls-ID der Schaltfläche. Jedes der Elemente dieser Datenstrukturen wird durch einen nullbasierten Index bezeichnet. Bevor Sie ein Objekt CToolBarCtrl verwenden können, müssen Sie diese Datenstrukturen installieren. Die Liste der Zeichenfolgen für Schaltflächenbezeichnungen kann nur verwendet werden, Sie können Zeichenfolgen nicht von der Symbolleiste abrufen.

Um ein CToolBarCtrl-Objekt zu verwenden, führen Sie in der Regel folgende Schritte aus:

Erstellen Sie das CToolBarCtrl-Objekt.
Rufen Sie Erstellen Sie auf, um die Windows-Symbolleistengemeinsame allgemeinen ToolTip-Steuerelement zu erstellen und diese dem CToolBarCtrl-Objekt anzufügen. Geben Sie das Format der Symbolleiste an, indem Sie Formate, wie TBSTYLE_TRANSPARENT für eine transparente Symbolleiste oder TBSTYLE_DROPDOWN für eine Symbolleiste verwenden, die Dropdown-Formatschaltflächen unterstützt.
Bestimmen Sie, wie Sie die Schaltflächen auf der Symbolleiste angezeigt werden soll:
- Um Bitmapbilder für Schaltflächen zu verwenden, fügen Sie die Schaltflächenbitmaps der Symbolleiste hinzu AddBitmap indem Sie aufrufen.
- Um die Bilder zu verwenden, die von einer Bildliste für Schaltflächen angezeigt werden, geben Sie die Bildliste an, indem Sie SetImageList SetHotImageList oder SetDisabledImageList aufrufen.
- Um Zeichenfolgenbezeichnungen für Schaltflächen zu verwenden, fügen Sie die Zeichenfolgen der Symbolleiste hinzu indem Sie AddString und/oder AddStrings aufrufen.
Fügen Sie Schaltflächenstrukturen der Symbolleiste hinzu, indem Sie AddButtons aufrufen.
Wenn Sie QuickInfos für eine Symbolleisten-Schaltfläche in einem Besitzerfenster möchten, das nicht CFrameWnd ist, müssen Sie die TTN_NEEDTEXT Meldungen im Besitzerfenster der Symbolleiste bearbeiten, wie in Behandlungs-QuickInfo-Benachrichtigungen beschrieben. Wenn das übergeordnete Fenster der Symbolleiste von CFrameWnd abgeleitet ist, werden QuickInfos ohne zusätzlichen Aufwand von Ihnen angezeigt, da CFrameWnd einen Standardhandler bereitstellt.
Wenn Sie den Benutzern ermöglichen möchten, die Symbolleiste anzupassen, Handleanpassungsbenachrichtigungsmeldungen im Besitzerfenster, wie in Behandlungs-Anpassungs-Benachrichtigungen beschrieben.

Sie können SaveState verwenden, um den aktuellen Zustand eines Symbolleisten-Steuerelements in der Registrierung und in RestoreState zu speichern, um den Zustand auf Grundlage der Informationen wiederherzustellen, die zuvor in der Registrierung gespeichert werden. Zusätzlich zu den Symbolleistenzustand zwischen Verwendungsmöglichkeiten von der Anwendung in der Regel speichern, Speicher der Anwendungen der Zustand, bevor der Benutzer beginnt, Symbolleiste Anpassen, falls der Benutzer später die Symbolleiste in ihren ursprünglichen Zustand wiederherstellen möchte.

Unterstützung für Internet Explorer 4,0 und höher

Um die Funktionalität unterstützen, die in Internet Explorer eingegeben wird, stellt Version 4.0 und höher, MFC Bildlistenunterstützung und die transparente und Ebenenformate für Symbolleisten-Steuerelemente bereit.

Eine transparente Symbolleiste ermöglicht den Clients unter der Symbolleiste zum Anzeigen von. Um eine transparente Symbolleiste zu erstellen, verwenden Sie TBSTYLE_FLAT und TBSTYLE_TRANSPARENT Stile. Transparente Symbolleisten kennzeichnen das Hottracking; das heißt, wenn der Mauszeiger über eine aktive Schaltfläche auf der Symbolleiste bewegt wird, ändert sich die Darstellung der Schaltfläche. Die Symbolleisten, die nur mit dem TBSTYLE_FLAT Format erstellt werden, enthalten Schaltflächen, die nicht transparent sind.

Bildlistenunterstützung können einem Steuerelement größere Flexibilität Standardverhalten, heiße Bilder und deaktivierte Bilder zu. Verwenden Sie GetImageList, GetHotImageList und GetDisabledImageList mit der transparenten Symbolleiste, um das Bild gemäß seinem Zustands bearbeiten:

Weitere Informationen zur Verwendung von CToolBarCtrl, finden Sie unter Steuerelemente und Verwenden CToolBarCtrl.