CToolBar-Klasse

Artikel
02/26/2013

Steuerleisten, die eine Zeile von geherstellten Schaltflächen und von optionalen Trennzeichen haben.

class CToolBar : public CControlBar

Mitglieder

Öffentliche Konstruktoren

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

Öffentliche Methoden

Name	Description
CToolBar::CommandToIndex	Gibt den Index einer Schaltfläche mit der angegebenen Befehl ID zurück
CToolBar::Create	Stellt die Windows-Symbolleiste erstellt und fügt sie dem CToolBar-Objekt.
CToolBar::CreateEx	Erstellt ein Objekt CToolBar mit zusätzlichen Formaten für das eingebettete CToolBarCtrl-Objekt.
CToolBar::GetButtonInfo	Ruft die ID, das Format und die Imagezahl einer Schaltfläche ab.
CToolBar::GetButtonStyle	Ruft das Format für eine Schaltfläche ab.
CToolBar::GetButtonText	Ruft den Text ab, der auf einer Schaltfläche angezeigt wird.
CToolBar::GetItemID	Gibt die Befehls-ID einer Schaltfläche oder eines Trennzeichens am angegebenen Index zurück.
CToolBar::GetItemRect	Ruft das Anzeigenrechteck für das Element am angegebenen Index ab.
CToolBar::GetToolBarCtrl	Ermöglicht Zugriff auf die zugrunde liegenden allgemeine Steuerelemente.
CToolBar::LoadBitmap	Lädt die Bitmap, die BitmapSchaltfläche Bilder enthält.
CToolBar::LoadToolBar	Lädt eine Symbolleistenressource, die mit dem Ressourcen-Editor erstellt wird.
CToolBar::SetBitmap	Legt ein Bitmapbild fest.
CToolBar::SetButtonInfo	Legt die ID, das Format und die Imagezahl einer Schaltfläche fest.
CToolBar::SetButtons	Sätze Schaltfläche Formate und einen Index von Schaltflächenbilder innerhalb der Bitmaps.
CToolBar::SetButtonStyle	Legt das Format für eine Schaltfläche fest.
CToolBar::SetButtonText	Legt den Text fest, der auf einer Schaltfläche angezeigt wird.
CToolBar::SetHeight	Gibt die Höhe der Symbolleiste fest.
CToolBar::SetSizes	Legt die Größen von Schaltflächen und deren Bitmaps fest.

Hinweise

Die Schaltflächen können wie Pushbuttone, Kontrollkästchenschaltflächen oder Optionsfelder verhalten.CToolBar-Objekte sind normalerweise eingebettete Member von den Rahmenfensterobjekten, die von der Klasse CFrameWnd oder CMDIFrameWnd abgeleitet werden.

CToolBar::GetToolBarCtrl, eine Memberfunktion, die MFC 4.0 neu ist, ermöglicht es Ihnen, die Unterstützung des allgemeinen Windows-Steuerelements für Symbolleistenanpassung und -zusätzliche Funktionen zu nutzen.CToolBar-Memberfunktionen geben Sie den Großteil der Funktionalität der allgemeinen Windows-Steuerelemente; Wenn Sie jedoch GetToolBarCtrl aufrufen, können Sie den Symbolleisten noch mehr der Eigenschaften von Windows 95/98-Symbolleisten geben.Wenn Sie GetToolBarCtrl aufrufen, gibt es einen Verweis auf ein Objekt CToolBarCtrl zurück.Siehe CToolBarCtrl weitere Informationen zum Entwerfen von Symbolleisten mithilfe der allgemeinen Windows-Steuerelemente.Weitere allgemeine Informationen über allgemeine Steuerelemente finden Sie unter Allgemeine Steuerelemente in Windows SDK.

Visual C++ stellt Ihnen zwei Methoden, um eine Symbolleiste zu erstellen.Um eine Symbolleistenressource mit dem Ressourcen-Editor zu erstellen, führen Sie folgende Schritte aus:

Erstellen Sie eine Symbolleistenressource.
Erstellen Sie das CToolBar-Objekt.
Rufen Sie die Funktion Erstellen Sie (oder CreateEx) auf, um die Windows-Symbolleiste erstellen und sie zum CToolBar-Objekt anzufügen.
Aufruf LoadToolBar, um die Symbolleistenressource zu laden.

Führen Sie andernfalls folgende Schritte aus:

Erstellen Sie das CToolBar-Objekt.
Rufen Sie die Funktion Erstellen Sie (oder CreateEx) auf, um die Windows-Symbolleiste erstellen und sie zum CToolBar-Objekt anzufügen.
Rufen Sie LoadBitmap auf, um die Bitmap zu laden, die die Symbolleistenschaltflächenimages enthält.
Rufen Sie SetButtons auf, um das Schaltflächenformat festzulegen und jede Schaltfläche mit einem Bild in der Bitmap zuzuordnen.

Alle Schaltflächenbilder kann in der Symbolleiste werden von einer Bitmap übernommen, die ein Bild für jede Schaltfläche enthalten muss.Alle Bilder müssen die gleiche Größe sein; Standard ist 16 Pixel breit und 15 Pixel hoch.Bilder müssen in der Bitmap parallel sein.

Die SetButtons-Funktion nimmt einen Zeiger auf ein Array von Steuer-IDs und ganzer Zahl, die die Anzahl der Elemente im Array angibt.Die Funktion legt die ID jeder Schaltfläche auf den Wert des entsprechenden Elements des Arrays fest und weist jeder Schaltfläche einen Bildindex zu, der die Position des Bilds der Schaltfläche in der Bitmap angibt.Wenn ein Arrayelement den Wert ID_SEPARATOR verfügt, wird kein Bildindex zugewiesen.

Die Reihenfolge der Bilder in der Bitmap ist in der Regel die Reihenfolge, in der sie auf dem Bildschirm gezeichnet werden, aber Sie können die SetButtonInfo-Funktion verwenden, um die Beziehung zwischen Imagereihenfolge und Zeichnungsreihenfolge zu ändern.

Alle Schaltflächen in einer Symbolleiste sind die gleiche Größe.Der Standardwert entspricht 24 x 22 Pixel, in Übereinstimmung mit Windows-Oberflächen-Richtlinien für Softwareentwurf aus.Jedes zusätzliche Leerzeichen zwischen dem Bild und den Schaltflächendimensionen wird verwendet, um einen Rahmen um das Bild zu bilden.

Jede Schaltfläche verfügt über ein Bild.Die verschiedene Schaltfläche zeigt an und die Formate (gedrückt, oben unten deaktiviert, unten deaktiviert und unbegrenzt) werden von diesem einem Bild generiert.Obwohl Bitmaps jede Farbe sein können, können Sie die besten Ergebnisse mit Bildern in Schwarz und in den in erreichen.

Vorsicht
CToolBar unterstützt Bitmaps mit maximal 16 Farben.Wenn Sie ein Bild in einen Symbolleisteneditor laden, konvertiert Visual Studio automatisch das Bild in einer Farbe 16, die ggf. Bitmapdatei ist und zeigt eine Warnmeldung an, wenn das Bild konvertiert wurde.Wenn Sie ein Bild mit mehr als 16 Farben (mithilfe eines externen Editor, um des Bilds zu bearbeiten) verwenden, Vorkommnisse die Anwendung möglicherweise unerwartetes.

CToolBar unterstützt Bitmaps mit maximal 16 Farben.Wenn Sie ein Bild in einen Symbolleisteneditor laden, konvertiert Visual Studio automatisch das Bild in einer Farbe 16, die ggf. Bitmapdatei ist und zeigt eine Warnmeldung an, wenn das Bild konvertiert wurde.Wenn Sie ein Bild mit mehr als 16 Farben (mithilfe eines externen Editor, um des Bilds zu bearbeiten) verwenden, Vorkommnisse die Anwendung möglicherweise unerwartetes.

Symbolleisten-Schaltflächen ahmen Pushbuttone standardmäßig nach.Sie können jedoch Symbolleisten-Schaltflächen Kontrollkästchenschaltflächen oder -Optionsfelder auch imitieren.Kontrollkästchenschaltflächen haben drei Zustände: überprüft, gelöscht und unbestimmt.Optionsfelder haben nur zwei Zustände: überprüft und gelöscht.

Um ein einzelnes Schaltflächen- oder Trennzeichenformat ohne zu zeigen festzulegen zu einem Array, rufen Sie GetButtonStyle um das Format ab, und rufen Sie dann SetButtonStyle anstelle SetButtons auf.SetButtonStyle ist besonders hilfreich, wenn Sie das Format einer Schaltfläche zur Laufzeit ändern möchten.

Um Text zuzuweisen um auf einer Schaltfläche anzuzeigen, rufen Sie auf GetButtonText um den Text abzurufen um auf der Schaltfläche angezeigt wird, und rufen Sie dann auf SetButtonText um den Text festzulegen.

Um eine Kontrollkästchenschaltfläche zu erstellen, und weisen Sie ihr das Format TBBS_CHECKBOX zu oder verwenden Sie SetCheck-Memberfunktion eines CCmdUI-Objekts in einem ON_UPDATE_COMMAND_UI-Handler.Das Aufrufen von SetCheck macht einen Pushbutton auf eine Kontrollkästchenschaltfläche.Führen Sie SetCheck ein Argument von 0 für deaktiviertes, 1 für überprüft oder 2 für die.

Um ein Optionsfeld zu erstellen, rufen Sie SetRadio-Memberfunktion CCmdUI eines Objekts aus einem ON_UPDATE_COMMAND_UI-Handler auf.Führen Sie SetRadio ein Argument von 0 für deaktiviertes oder ungleich 0 (null) für überprüft.So fügen Sie einer Optionsfeldgruppe gegenseitig - exklusives Verhalten bereitstellen, müssen Sie ON_UPDATE_COMMAND_UI-Handler für alle Schaltflächen in der Gruppe haben.

Weitere Informationen zur Verwendung von CToolBar, finden Sie im Artikel MFC-Symbolleisten-Implementierung und Technischer Hinweis 31: Steuerleisten.