CToolBarCtrl

Die CToolBarCtrl -Klasse stellt die Funktionalität des gemeinsamen Windows Toolbar-Steuerelements. Dieses Steuerelement (und somit die CToolBarCtrl -Klasse) ist nur für Programme, die unter Windows 95 und Windows NT Version 3.51 und höher.

Ein allgemeines Windows-Symbolleiste-Steuerelement ist eine rechteckige untergeordnete Fenster, die eine oder mehrere Schaltflächen enthält. Diese Schaltflächen können ein Bitmap-Bild, eine Zeichenfolge oder beides anzeigen. Wenn der Benutzer eine Schaltfläche auswählt, sendet er eine Befehlsnachricht an der Symbolleiste Besitzerfenster. In der Regel entsprechen die Schaltflächen in einer Symbolleiste Elemente im Menü der Anwendung; Sie bieten eine direktere Möglichkeit für den Benutzer auf eine Anwendung Befehle zugreifen.

CToolBarCtrl Objekte enthalten mehrere wichtige interne Datenstrukturen: eine Liste der Schaltfläche Bild Bitmaps oder einer Bildliste, eine Liste der Schaltfläche Bezeichnung Stiche und eine Liste von TBUTTON -Strukturen, die ein Bild zuordnen oder die Zeichenfolge, in die Position, Stil, staatliche und Befehls-ID der Schaltfläche. Jedes der Elemente der diese Datenstrukturen bezeichnet man einen nullbasierten Index. Bevor Sie ein CToolBarCtrl -Objekt verwenden können, müssen Sie diese Datenstrukturen einrichten. Die Liste von Zeichenfolgen kann nur für die Schaltflächenbezeichnungen verwendet werden; Sie können keine Zeichenfolgen aus der Symbolleiste abrufen.

Um ein CToolBarCtrl -Objekt verwenden, werden Sie in der Regel diese Schritte ausführen.:

1. Erstellen Sie das CToolBarCtrl -Objekt.
   
   
2. Rufen Sie Erstellen , um das gemeinsame Windows-Symbolleisten-Steuerelement erstellen und die CToolBarCtrl -Objekt zuordnen. Geben Sie den Stil der Symbolleiste mithilfe von Formatvorlagen, wie z. B. TBSTYLE_TRANSPARENT für eine transparente Symbolleiste oder TBSTYLE_DROPDOWN für eine Symbolleiste, die Dropdown-Schaltflächen unterstützt.
   
   
3. Identifizieren Sie, wie die Schaltflächen auf der Symbolleiste angezeigt werden soll:
   • Bitmap-Bilder für die Schaltflächen verwenden, fügen Sie die Schaltfläche Bitmaps der Symbolleiste durch Aufrufen von AddBitmap.
     
     
   • Um aus einer Bildliste für Schaltflächen angezeigten Bilder verwenden, geben Sie die Bildliste durch Aufrufen von SetImageList, SetHotImageListoder SetDisabledImageList.
     
     
   • Zeichenfolge Beschriftungen für die Schaltflächen verwenden, fügen Sie die Zeichenfolgen in die Symbolleiste durch Aufrufen von AddString und/oder AddStrings.
4. Fügen Sie Schaltfläche Strukturen zur Symbolleiste hinzu, indem Sie AddButtons.
   
   
5. Wenn Sie QuickInfos für eine Symbolleisten-Schaltfläche in ein Besitzerfenster möchten, die kein CFrameWndist, müssen Sie die TTN_NEEDTEXT -Nachrichten in der Symbolleiste Besitzerfenster verarbeiten, wie in beschrieben CToolBarCtrl: Handling Tool Tipp-Benachrichtigungen. Wenn das übergeordnete Fenster der Symbolleiste von CFrameWndabgeleitet ist, werden QuickInfos ohne zusätzlichen Aufwand von Ihnen angezeigt, weil CFrameWnd einen Standardhandler bietet.
   
   
6. Wenn Sie möchten, dass Ihre Benutzer die Symbolleiste anpassen können, behandeln Anpassung von Benachrichtigungen in das Besitzerfenster, wie in beschrieben CToolBarCtrl: Behandeln von Anpassungsbenachrichtigungen.

SaveState können Sie speichern Sie den aktuellen Status eines Symbolleiste-Steuerelements in der Registrierung und RestoreState , den auf der Grundlage von Informationen, die zuvor in der Registrierung gespeicherten Zustand wiederherzustellen. Zusätzlich zu den Symbolleiste Status zwischen Verwendungen der Anwendung speichern, speichern Anwendungen in der Regel den Zustand vor Beginn der Nutzer anpassen der Symbolleiste, wenn der Benutzer später die Symbolleiste in seinen ursprünglichen Zustand wiederherstellen möchte.

Unterstützung für Internet Explorer ab Version 4.0 und höher

Zur Unterstützung der Funktionalität in Internet Explorer, Version 4.0 und höher, eingeführt bietet MFC Bild Liste Support und transparente und flache Stile für Toolbar-Steuerelemente.

Eine transparente Symbolleiste ermöglicht dem Client unter der Symbolleiste durchscheinen. Um eine transparente Symbolleiste zu erstellen, verwenden Sie TBSTYLE_FLAT und TBSTYLE_TRANSPARENT Stile. Transparente Symbolleisten verfügen über Heiße Verfolgung; Das heißt, wenn der Mauszeiger über ein Button auf der Symbolleiste bewegt, ändert sich die Darstellung der Schaltfläche. Mit nur der Formatvorlage TBSTYLE_FLAT erstellte Symbolleisten enthalten Schaltflächen, die nicht transparent sind.

Bildunterstützung Liste ermöglicht eine Steuerelement größere Flexibilität für Standardverhalten, heiße Bilder und Behinderte Bilder. Verwenden Sie GetImageList, GetHotImageListund GetDisabledImageList mit der transparente Symbolleiste bearbeiten das Bild entsprechend den Zustand:

Weitere Informationen zum Verwenden von CToolBarCtrl, finden Sie unter Kontrolle Themen und Verwenden von CToolBarCtrl im Visual C++ Programmer's Guide.

# include lt;afxcmn.h>

Klasse&nmember |nbsp; Basisklasse | Hierarchiediagramm

Proben&Nbsp; MFC-Beispiel CMNCTRL1 | MFC MFCIE-Beispiel

Siehe auch&Nbsp;CToolBar