Freigeben über


CToolBarCtrl-Klasse

Stellt die Funktionalität des allgemeinen Windows-Symbolleisten-Steuerelements bereit.

Syntax

class CToolBarCtrl : public CWnd

Member

Öffentliche Konstruktoren

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

Öffentliche Methoden

Name Beschreibung
CToolBarCtrl::AddBitmap Fügt eine oder mehrere Bitmapschaltflächenbilder zur Liste der Schaltflächenbilder hinzu, die für ein Symbolleistensteuerelement verfügbar sind.
CToolBarCtrl::AddButtons Fügt einem Symbolleistensteuerelement eine oder mehrere Schaltflächen hinzu.
CToolBarCtrl::AddString Fügt der internen Liste der Zeichenfolgen eine neue Zeichenfolge hinzu, die als Ressourcen-ID übergeben wird.
CToolBarCtrl::AddStrings Fügt eine neue Zeichenfolge oder Zeichenfolge hinzu, die als Zeiger an einen Puffer mit NULLdurch Trennzeichen getrennten Zeichenfolgen übergeben wird, zur internen Liste der Zeichenfolgen der Symbolleiste.
CToolBarCtrl::AutoSize Ändert die Größe eines Symbolleistensteuerelements.
CToolBarCtrl::ChangeBitmap Ändert die Bitmap für eine Schaltfläche im aktuellen Symbolleistensteuerelement.
CToolBarCtrl::CheckButton Überprüft oder löscht eine bestimmte Schaltfläche in einem Symbolleistensteuerelement.
CToolBarCtrl::CommandToIndex Ruft den nullbasierten Index für die Schaltfläche ab, die dem angegebenen Befehlsbezeichner zugeordnet ist.
CToolBarCtrl::Create Erstellt ein Symbolleistensteuerelement und fügt es an ein CToolBarCtrl Objekt an.
CToolBarCtrl::CreateEx Erstellt ein Symbolleistensteuerelement mit den angegebenen erweiterten Windows-Formatvorlagen und fügt es an ein CToolBarCtrl Objekt an.
CToolBarCtrl::Customize Zeigt das Dialogfeld Symbolleiste anpassen an.
CToolBarCtrl::DeleteButton Löscht eine Schaltfläche aus dem Symbolleistensteuerelement.
CToolBarCtrl::EnableButton Aktiviert oder deaktiviert die angegebene Schaltfläche in einem Symbolleistensteuerelement.
CToolBarCtrl::GetAnchorHighlight Ruft die Ankermarkierungseinstellung für eine Symbolleiste ab.
CToolBarCtrl::GetBitmap Ruft den Index der Bitmap ab, die einer Schaltfläche in einer Symbolleiste zugeordnet ist.
CToolBarCtrl::GetBitmapFlags Ruft Flags ab, die der Bitmap der Symbolleiste zugeordnet sind.
CToolBarCtrl::GetButton Ruft Informationen zur angegebenen Schaltfläche in einem Symbolleistensteuerelement ab.
CToolBarCtrl::GetButtonCount Ruft die Anzahl der Schaltflächen ab, die sich derzeit im Symbolleistensteuerelement befinden.
CToolBarCtrl::GetButtonInfo Ruft die Informationen für eine Schaltfläche in einer Symbolleiste ab.
CToolBarCtrl::GetButtonSize Ruft die aktuelle Breite und Höhe von Symbolleistenschaltflächen in Pixeln ab.
CToolBarCtrl::GetColorScheme Ruft das Farbschema des aktuellen Symbolleistensteuerelements ab.
CToolBarCtrl::GetDisabledImageList Ruft die Bildliste ab, die ein Symbolleistensteuerelement zum Anzeigen deaktivierter Schaltflächen verwendet.
CToolBarCtrl::GetDropTarget Ruft die IDropTarget Schnittstelle für ein Symbolleistensteuerelement ab.
CToolBarCtrl::GetExtendedStyle Ruft die erweiterten Formatvorlagen für ein Symbolleistensteuerelement ab.
CToolBarCtrl::GetHotImageList Ruft die Bildliste ab, die ein Symbolleistensteuerelement zum Anzeigen von "heißen" Schaltflächen verwendet. Eine Hot Button wird hervorgehoben, wenn sich der Mauszeiger darüber befindet.
CToolBarCtrl::GetHotItem Ruft den Index des heißen Elements in einer Symbolleiste ab.
CToolBarCtrl::GetImageList Ruft die Bildliste ab, die ein Symbolleistensteuerelement zum Anzeigen von Schaltflächen im Standardzustand verwendet.
CToolBarCtrl::GetInsertMark Ruft die aktuelle Einfügemarke für die Symbolleiste ab.
CToolBarCtrl::GetInsertMarkColor Ruft die Farbe ab, mit der die Einfügemarke für die Symbolleiste gezeichnet wird.
CToolBarCtrl::GetItemRect Ruft das umgebende Rechteck einer Schaltfläche in einem Symbolleistensteuerelement 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 Symbolleistensteuerelements ab.
CToolBarCtrl::GetPadding Ruft den horizontalen und vertikalen Abstand des aktuellen Symbolleistensteuerelements ab.
CToolBarCtrl::GetPressedImageList Ruft die Bildliste ab, die das aktuelle Symbolleistensteuerelement verwendet, um Schaltflächen im gedrückten Zustand darzustellen.
CToolBarCtrl::GetRect Ruft das umgebende Rechteck für eine angegebene Symbolleistenschaltfläche ab.
CToolBarCtrl::GetRows Ruft die Anzahl der Derzeit in der Symbolleiste angezeigten Schaltflächenzeilen ab.
CToolBarCtrl::GetState Ruft Informationen zum Status der angegebenen Schaltfläche in einem Symbolleistensteuerelement ab, z. B. ob sie aktiviert, gedrückt oder aktiviert ist.
CToolBarCtrl::GetString Ruft eine Symbolleistenzeichenfolge ab.
CToolBarCtrl::GetStyle Ruft die derzeit für ein Symbolleistensteuerelement verwendeten Formatvorlagen ab.
CToolBarCtrl::GetToolTips Ruft den Ziehpunkt des QuickInfo-Steuerelements ab, falls vorhanden, das dem Symbolleistensteuerelement zugeordnet ist.
CToolBarCtrl::HideButton Blendet die angegebene Schaltfläche in einem Symbolleistensteuerelement aus oder zeigt sie an.
CToolBarCtrl::HitTest Bestimmt, wo sich ein Punkt in einem Symbolleistensteuerelement befindet.
CToolBarCtrl::Indeterminate Legt den unbestimmten (grauen) Zustand der angegebenen Schaltfläche in einem Symbolleistensteuerelement fest oder löscht sie.
CToolBarCtrl::InsertButton Fügt eine Schaltfläche in ein Symbolleistensteuerelement ein.
CToolBarCtrl::InsertMarkHitTest Ruft die Einfügemarkeinformationen für einen Punkt in einer Symbolleiste ab.
CToolBarCtrl::IsButtonChecked Gibt an, ob die angegebene Schaltfläche in einem Symbolleistensteuerelement aktiviert ist.
CToolBarCtrl::IsButtonEnabled Gibt an, ob die angegebene Schaltfläche in einem Symbolleistensteuerelement aktiviert ist.
CToolBarCtrl::IsButtonHidden Gibt an, ob die angegebene Schaltfläche in einem Symbolleistensteuerelement ausgeblendet ist.
CToolBarCtrl::IsButtonHighlighted Überprüft den Hervorhebungsstatus der Symbolleistenschaltfläche.
CToolBarCtrl::IsButtonIndeterminate Gibt an, ob der Zustand der angegebenen Schaltfläche in einem Symbolleistensteuerelement unbestimmt (grau) ist.
CToolBarCtrl::IsButtonPressed Gibt an, ob die angegebene Schaltfläche in einem Symbolleistensteuerelement gedrückt wird.
CToolBarCtrl::LoadImages Lädt Bitmaps in die Bildliste eines Symbolleistensteuerelements.
CToolBarCtrl::MapAccelerator Ordnet einer Symbolleistenschaltfläche ein Zugriffstastenzeichen zu.
CToolBarCtrl::MarkButton Legt den Hervorhebungszustand einer bestimmten Schaltfläche in einem Symbolleistensteuerelement fest.
CToolBarCtrl::MoveButton Verschiebt eine Schaltfläche von einem Index in einen anderen.
CToolBarCtrl::PressButton Drückt oder gibt die angegebene Schaltfläche in einem Symbolleistensteuerelement frei.
CToolBarCtrl::ReplaceBitmap Ersetzt die vorhandene Bitmap im aktuellen Symbolleistensteuerelement durch eine neue Bitmap.
CToolBarCtrl::RestoreState Stellt den Status des Symbolleistensteuerelements wieder her.
CToolBarCtrl::SaveState Speichert den Status des Symbolleistensteuerelements.
CToolBarCtrl::SetAnchorHighlight Legt die Einstellung für die Ankermarkierung für eine Symbolleiste fest.
CToolBarCtrl::SetBitmapSize Legt die Größe der Bitmapbilder fest, die einem Symbolleistensteuerelement hinzugefügt werden sollen.
CToolBarCtrl::SetButtonInfo Legt die Informationen für eine vorhandene Schaltfläche in einer Symbolleiste fest.
CToolBarCtrl::SetButtonSize Legt die Größe der Schaltflächen fest, die einem Symbolleistensteuerelement hinzugefügt werden sollen.
CToolBarCtrl::SetButtonStructSize Gibt die Größe der TBBUTTON Struktur an.
CToolBarCtrl::SetButtonWidth Legt die minimale und maximale Breite der Schaltflächen im Symbolleisten-Steuerelement fest.
CToolBarCtrl::SetCmdID Legt den Befehlsbezeichner fest, der an das Besitzerfenster gesendet werden soll, wenn die angegebene Schaltfläche gedrückt wird.
CToolBarCtrl::SetColorScheme Legt das Farbschema des aktuellen Symbolleistensteuerelements fest.
CToolBarCtrl::SetDisabledImageList Legt die Bildliste fest, die vom Symbolleistensteuerelement zum Anzeigen deaktivierter Schaltflächen verwendet wird.
CToolBarCtrl::SetDrawTextFlags Legt die Flags in der Win32-Funktion DrawTextfest, die verwendet wird, um den Text im angegebenen Rechteck zu zeichnen, formatiert entsprechend der Festlegung der Flags.
CToolBarCtrl::SetExtendedStyle Legt die erweiterten Formatvorlagen für ein Symbolleistensteuerelement fest.
CToolBarCtrl::SetHotImageList Legt die Bildliste fest, die vom Symbolleistensteuerelement zum Anzeigen von "heißen" Schaltflächen verwendet wird.
CToolBarCtrl::SetHotItem Legt das heiße Element in einer Symbolleiste fest.
CToolBarCtrl::SetImageList Legt die Bildliste fest, die von der Symbolleiste zum Anzeigen von Schaltflächen verwendet wird, die sich im Standardzustand befinden.
CToolBarCtrl::SetIndent Legt den Einzug für die erste Schaltfläche in einem Symbolleistensteuerelement fest.
CToolBarCtrl::SetInsertMark Legt die aktuelle Einfügemarke für die Symbolleiste fest.
CToolBarCtrl::SetInsertMarkColor Legt die Farbe fest, mit der die Einfügemarke für die Symbolleiste gezeichnet wird.
CToolBarCtrl::SetMaxTextRows Legt die maximale Anzahl von Textzeilen fest, die auf einer Symbolleistenschaltfläche angezeigt werden.
CToolBarCtrl::SetMetrics Legt die Metriken eines Symbolleistensteuerelements fest.
CToolBarCtrl::SetOwner Legt das Fenster fest, um Benachrichtigungen vom Symbolleistensteuerelement zu empfangen.
CToolBarCtrl::SetPadding Legt den horizontalen und vertikalen Abstand des aktuellen Symbolleistensteuerelements fest.
CToolBarCtrl::SetPressedImageList Legt die Bildliste fest, die das aktuelle Symbolleistensteuerelement verwendet, um Schaltflächen im gedrückten Zustand darzustellen.
CToolBarCtrl::SetRows Legt die Anzahl der Zeilen von Schaltflächen fest, die in der Symbolleiste angezeigt werden.
CToolBarCtrl::SetState Legt den Zustand für die angegebene Schaltfläche in einem Symbolleistensteuerelement fest.
CToolBarCtrl::SetStyle Legt die Formatvorlagen für ein Symbolleistensteuerelement fest.
CToolBarCtrl::SetToolTips Ordnet ein QuickInfo-Steuerelement dem Symbolleistensteuerelement zu.
CToolBarCtrl::SetWindowTheme Legt den visuellen Stil eines Symbolleistensteuerelements fest.

Hinweise

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

Ein allgemeines Windows-Symbolleistensteuerelement ist ein rechteckiges untergeordnetes Fenster, das eine oder mehrere Schaltflächen enthält. Diese Schaltflächen können ein Bitmapbild, eine Zeichenfolge oder beides anzeigen. Wenn der Benutzer eine Schaltfläche auswähbt, sendet er eine Befehlsmeldung an das Besitzerfenster der Symbolleiste. In der Regel entsprechen die Schaltflächen in einer Symbolleiste Elementen im Menü der Anwendung; sie bieten dem Benutzer eine direktere Möglichkeit, auf die Befehle einer Anwendung zuzugreifen.

CToolBarCtrl Objekte enthalten mehrere wichtige interne Datenstrukturen: eine Liste von Schaltflächenbildbitmaps oder eine Bildliste, eine Liste mit Schaltflächenbezeichnungszeichenfolgen und eine Liste von TBBUTTON Strukturen, die ein Bild und/oder eine Zeichenfolge mit der Position, dem Format, dem Zustand und der Befehls-ID der Schaltfläche verknüpfen. Jedes der Elemente dieser Datenstrukturen wird durch einen nullbasierten Index bezeichnet. Bevor Sie ein CToolBarCtrl Objekt verwenden können, müssen Sie diese Datenstrukturen einrichten. Die Liste der Zeichenfolgen kann nur für Schaltflächenbeschriftungen verwendet werden; Zeichenfolgen können nicht von der Symbolleiste abgerufen werden.

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

  1. Erstellen Sie das CToolBarCtrl Objekt.

  2. Rufen Sie auf Create , um das allgemeine Steuerelement der Windows-Symbolleiste zu erstellen und an das CToolBarCtrl Objekt anzufügen. Geben Sie die Formatvorlage der Symbolleiste mithilfe von Formatvorlagen an, z TBSTYLE_TRANSPARENT . B. 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 sollen:

    • Um Bitmapbilder für Schaltflächen zu verwenden, fügen Sie die Schaltflächenbitmaps durch Aufrufen von Aufrufen AddBitmapzur Symbolleiste hinzu.

    • Um Bilder zu verwenden, die aus einer Bildliste für Schaltflächen angezeigt werden, geben Sie die Bildliste durch Aufrufen SetImageList, oder SetHotImageListSetDisabledImageList.

    • Um Zeichenfolgenbeschriftungen für Schaltflächen zu verwenden, fügen Sie die Zeichenfolgen durch Aufrufen AddString und/oder .AddStrings

  4. Fügen Sie der Symbolleiste Schaltflächenstrukturen hinzu, indem Sie aufrufen AddButtons.

  5. Wenn Sie QuickInfos für eine Symbolleistenschaltfläche in einem Besitzerfenster verwenden möchten, das nicht der CFrameWndFall ist, müssen Sie die TTN_NEEDTEXT Nachrichten im Besitzerfenster der Symbolleiste behandeln, wie in der Behandlung von QuickInfobenachrichtigungen beschrieben. Wenn das übergeordnete Fenster der Symbolleiste abgeleitet CFrameWndist, werden QuickInfos ohne zusätzlichen Aufwand von Ihnen angezeigt, da CFrameWnd ein Standardhandler bereitgestellt wird.

  6. Wenn Sie möchten, dass Der Benutzer die Symbolleiste anpassen kann, behandeln Sie Anpassungsbenachrichtigungen im Besitzerfenster, wie in der Behandlung von Anpassungsbenachrichtigungen beschrieben.

Sie können den SaveState aktuellen Status eines Symbolleistensteuerelements in der Registrierung speichern und RestoreState den Zustand basierend auf informationen wiederherstellen, die zuvor in der Registrierung gespeichert wurden. Neben dem Speichern des Symbolleistenzustands zwischen der Verwendung der Anwendung speichern Anwendungen den Zustand in der Regel, bevor der Benutzer mit der Anpassung der Symbolleiste beginnt, falls der Benutzer später die Symbolleiste in seinen ursprünglichen Zustand wiederherstellen möchte.

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

Um Funktionen zu unterstützen, die in Internet Explorer, Version 4.0 und höher, eingeführt wurden, bietet MFC Bildlistenunterstützung und transparente und flache Formatvorlagen für Symbolleistensteuerelemente.

Mit einer transparenten Symbolleiste kann der Client unter der Symbolleiste angezeigt werden. Verwenden Sie zum Erstellen einer transparenten Symbolleiste sowohl als auch TBSTYLE_FLAT TBSTYLE_TRANSPARENT Formatvorlagen. Transparente Symbolleisten bieten hot tracking; d. h., wenn sich der Mauszeiger über eine Hot Button auf der Symbolleiste bewegt, ändert sich die Darstellung der Schaltfläche. Symbolleisten, die nur mit der TBSTYLE_FLAT Formatvorlage erstellt wurden, enthalten Schaltflächen, die nicht transparent sind.

Die Unterstützung von Bildlisten ermöglicht eine bessere Flexibilität bei Standardverhalten, Hot Images und deaktivierten Bildern. Verwenden Sie GetImageList, GetHotImageListund GetDisabledImageList mit der transparenten Symbolleiste, um das Bild gemäß seinem Zustand zu bearbeiten:

Weitere Informationen zur Verwendung CToolBarCtrlfinden Sie unter "Steuerelemente und Verwenden" CToolBarCtrl.

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CToolBarCtrl

Anforderungen

Header: afxcmn.h

CToolBarCtrl::AddBitmap

Fügt der Liste der Schaltflächenbilder, die im Symbolleistensteuerelement gespeichert sind, mindestens ein Schaltflächenbild hinzu.

int AddBitmap(
    int nNumButtons,
    UINT nBitmapID);

int AddBitmap(
    int nNumButtons,
    CBitmap* pBitmap);

Parameter

nNumButtons
Anzahl der Schaltflächenbilder in der Bitmap.

nBitmapID
Ressourcenbezeichner der Bitmap, die das hinzuzufügende Schaltflächenbild oder Bilder enthält.

pBitmap
Zeigen Sie auf das CBitmap Objekt, das das Hinzuzufügende Schaltflächenbild oder Bilder enthält.

Rückgabewert

Nullbasierter Index des ersten neuen Bilds bei erfolgreicher Ausführung; andernfalls - 1.

Hinweise

Sie können die Windows-API CreateMappedBitmap verwenden, um Farben zuzuordnen, bevor Sie die Bitmap zur Symbolleiste hinzufügen. Wenn Sie einen Zeiger an ein CBitMap Objekt übergeben, müssen Sie sicherstellen, dass die Bitmap erst zerstört wird, nachdem die Symbolleiste zerstört wurde.

CToolBarCtrl::AddButtons

Fügt einem Symbolleistensteuerelement eine oder mehrere Schaltflächen hinzu.

BOOL AddButtons(
    int nNumButtons,
    LPTBBUTTON lpButtons);

Parameter

nNumButtons
Anzahl der hinzuzufügenden Schaltflächen.

lpButtons
Adresse eines Arrays von TBBUTTON Strukturen, die Informationen zu den hinzuzufügenden Schaltflächen enthalten. Es muss dieselbe Anzahl von Elementen im Array vorhanden sein, wie schaltflächen angegeben.nNumButtons

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Der lpButtons Zeiger zeigt auf ein Array von TBBUTTON Strukturen. Jede TBBUTTON Struktur ordnet die Schaltfläche, die dem Stil, bild und/oder der Zeichenfolge, befehls-ID, dem Status und den benutzerdefinierten Daten der Schaltfläche hinzugefügt wird, zu:

typedef struct _TBBUTTON {
    int iBitmap;    // zero-based index of button image
    int idCommand;  // command to be sent when button pressed
    BYTE fsState;   // button state--see below
    BYTE fsStyle;   // button style--see below
    DWORD dwData;   // application-defined value
    int iString;    // zero-based index of button label string
} TBBUTTON;

Die Mitglieder sind wie folgt:

  • iBitmap

    Nullbasierter Index des Schaltflächenbilds, -1, wenn kein Bild für diese Schaltfläche.

  • idCommand

    Befehlsbezeichner, der der Schaltfläche zugeordnet ist. Dieser Bezeichner wird in einer WM_COMMAND Nachricht gesendet, wenn die Schaltfläche ausgewählt wird. Wenn das fsStyle Element den TBSTYLE_SEP Wert hat, muss dieses Element null sein.

  • fsState

    Schaltflächenstatuskennzeichnungen. Dabei kann es sich um eine Kombination der unten aufgeführten Werte handeln:

    • TBSTATE_CHECKED Die Schaltfläche weist den TBSTYLE_CHECKED Stil auf und wird gedrückt.

    • TBSTATE_ENABLED Die Schaltfläche akzeptiert Benutzereingaben. Eine Schaltfläche, die diesen Zustand nicht aufweist, akzeptiert keine Benutzereingaben und ist abgeblentet.

    • TBSTATE_HIDDEN Die Schaltfläche ist nicht sichtbar und kann keine Benutzereingaben empfangen.

    • TBSTATE_INDETERMINATE Die Schaltfläche ist grau dargestellt.

    • TBSTATE_PRESSED Die Schaltfläche wird gedrückt.

    • TBSTATE_WRAP Ein Zeilenumbruch folgt der Schaltfläche. Die Schaltfläche muss auch den TBSTATE_ENABLED Zustand aufweisen.

  • fsStyle

    Schaltflächenformatvorlage. Dabei kann es sich um eine Kombination der unten aufgeführten Werte handeln:

    • TBSTYLE_BUTTON Erstellt eine Standard-Knopfdrucktaste.

    • TBSTYLE_CHECK Erstellt eine Schaltfläche, die jedes Mal, wenn der Benutzer darauf klickt, zwischen den gedrückten und nicht gedrückten Zuständen umschaltet. Die Schaltfläche hat eine andere Hintergrundfarbe, wenn sie sich im gedrückten Zustand befindet.

    • TBSTYLE_CHECKGROUP Erstellt eine Kontrollkästchenschaltfläche, die gedrückt bleibt, bis eine andere Schaltfläche in der Gruppe gedrückt wird.

    • TBSTYLE_GROUP Erstellt eine Schaltfläche, die gedrückt bleibt, bis eine andere Schaltfläche in der Gruppe gedrückt wird.

    • TBSTYLE_SEP Erstellt ein Trennzeichen, das eine kleine Lücke zwischen Schaltflächengruppen bereitstellt. Eine Schaltfläche mit dieser Formatvorlage empfängt keine Benutzereingabe.

  • dwData

    Benutzerdefinierte Daten.

  • iString

    Nullbasierter Index der Zeichenfolge, die als Bezeichnung der Schaltfläche verwendet werden soll, -1, wenn für diese Schaltfläche keine Zeichenfolge vorhanden ist.

Das Bild und/oder die Zeichenfolge, deren Index Sie angeben, müssen zuvor der Liste des Symbolleistensteuerelements mithilfe AddBitmapvon , AddStringund/oder hinzugefügt AddStringsworden sein.

CToolBarCtrl::AddString

Fügt der internen Liste der Zeichenfolgen eine neue Zeichenfolge hinzu, die als Ressourcen-ID übergeben wird.

int AddString(UINT nStringID);

Parameter

nStringID
Ressourcenbezeichner der Zeichenfolgenressource, die der Zeichenfolgenliste des Symbolleistensteuerelements hinzugefügt werden soll.

Rückgabewert

Der nullbasierte Index der ersten neuen Zeichenfolge, die bei erfolgreicher Ausführung hinzugefügt wurde; andernfalls -1.

CToolBarCtrl::AddStrings

Fügt der Liste der für ein Symbolleistensteuerelement verfügbaren Zeichenfolgen eine neue Zeichenfolge oder Zeichenfolge hinzu.

int AddStrings(LPCTSTR lpszStrings);

Parameter

lpszStrings
Adresse eines Puffers, der eine oder NULLmehrere beendete Zeichenfolgen enthält, die der Zeichenfolgenliste der Symbolleiste hinzugefügt werden sollen. Die letzte Zeichenfolge muss mit zwei NULL Zeichen beendet werden.

Rückgabewert

Der nullbasierte Index der ersten neuen Zeichenfolge, die bei erfolgreicher Ausführung hinzugefügt wurde; andernfalls -1.

Hinweise

Zeichenfolgen im Puffer müssen durch ein NULL Zeichen getrennt werden. Sie müssen sicherstellen, dass die letzte Zeichenfolge über zwei NULL Terminatoren verfügt. Um eine konstante Zeichenfolge ordnungsgemäß zu formatieren, schreiben Sie sie möglicherweise wie:

// one null added automatically
lpszStrings = _T("Only one string to add\0");

oder:

// adds three strings with one call
lpszStrings = _T("String 1\0String 2\0String 3\0");

Sie sollten ein CString Objekt nicht an diese Funktion übergeben, da es nicht möglich ist, mehr als ein NULL Zeichen in einem CString.

CToolBarCtrl::AutoSize

Ändert die Größe des gesamten Symbolleistensteuerelements.

void AutoSize();

Hinweise

Sie sollten diese Funktion aufrufen, wenn sich die Größe des übergeordneten Fensters ändert oder sich die Größe der Symbolleiste ändert (z. B. wenn Sie die Schaltfläche oder Bitmapgröße festlegen oder Zeichenfolgen hinzufügen).

CToolBarCtrl::ChangeBitmap

Ändert die Bitmap für eine Schaltfläche im aktuellen Symbolleistensteuerelement.

BOOL ChangeBitmap(
    int idButton,
    int iBitmap);

Parameter

idButton
[in] Befehlsbezeichner der Schaltfläche, die eine neue Bitmap empfängt.

iBitmap
[in] Nullbasierter Index eines Bilds in der Bildliste des aktuellen Symbolleistensteuerelements.

Rückgabewert

TRUEwenn diese Methode erfolgreich ist; andernfalls . FALSE

Hinweise

Wenn diese Methode erfolgreich ist, zeigt das System das angegebene Bild in der angegebenen Schaltfläche an.

Diese Methode sendet die TB_CHANGEBITMAP Nachricht, die im Windows SDK beschrieben wird.

Beispiel

Im folgenden Codebeispiel wird die Bitmap für die Schaltfläche "Datei speichern " in die Bitmap für die Schaltfläche "Info " geändert.

{
   // Change the bitmap for the File Save button, whose
   // command ID is ID_FILE_SAVE, to the bitmap for the
   // About button, whose index is 7.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ChangeBitmap(ID_FILE_SAVE, 7);
}

CToolBarCtrl::CheckButton

Überprüft oder löscht eine bestimmte Schaltfläche in einem Symbolleistensteuerelement.

BOOL CheckButton(
    int nID,
    BOOL bCheck = TRUE);

Parameter

nID
Befehlsbezeichner der Schaltfläche, die überprüft oder deaktiviert werden soll.

bCheck
TRUE um die Schaltfläche zu überprüfen, FALSE um sie zu deaktivieren.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Wenn eine Schaltfläche aktiviert wurde, scheint sie gedrückt zu sein. Wenn Sie mehr als einen Schaltflächenzustand ändern möchten, sollten Sie stattdessen anrufen SetState .

CToolBarCtrl::CommandToIndex

Ruft den nullbasierten Index für die Schaltfläche ab, die dem angegebenen Befehlsbezeichner zugeordnet ist.

UINT CommandToIndex(UINT nID) const;

Parameter

nID
Befehls-ID, deren Schaltflächenindex Sie suchen möchten.

Rückgabewert

Der nullbasierte Index für die Schaltfläche, die der Befehls-ID zugeordnet ist.

Hinweise

CToolBarCtrl::Create

Erstellt ein Symbolleistensteuerelement und fügt es an ein CToolBarCtrl Objekt an.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwStyle
Gibt die Formatvorlage des Symbolleistensteuerelements an. Symbolleisten müssen immer über die WS_CHILD Formatvorlage verfügen. Darüber hinaus können Sie eine beliebige Kombination aus Symbolleistenformatvorlagen und Fensterformatvorlagen angeben, wie unter "Hinweise" beschrieben.

rect
Gibt optional die Größe und Position des Symbolleistensteuerelements an. Dabei kann es sich um ein CRect Objekt oder eine RECT Struktur handeln.

pParentWnd
Gibt das übergeordnete Fenster des Symbolleistensteuerelements an. Es darf nicht sein NULL.

nID
Gibt die ID des Symbolleistensteuerelements an.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Sie erstellen eine CToolBarCtrl in zwei Schritten. Rufen Sie zuerst den Konstruktor auf, und rufen Sie dann auf Create, wodurch das Symbolleistensteuerelement erstellt und an das CToolBarCtrl Objekt angefügt wird. Wenden Sie die folgenden Fensterformatvorlagen auf ein Symbolleistensteuerelement an.

  • WS_CHILD Immer

  • WS_VISIBLE Gewöhnlich

  • WS_DISABLED Selten

Eine Beschreibung der Fensterstile finden Sie CreateWindow im Windows SDK.

Wenden Sie optional eine Kombination allgemeiner Steuerelementstile an, wie im Windows SDK beschrieben.

Wenden Sie eine Kombination aus Symbolleistenformatvorlagen entweder auf das Steuerelement oder die Schaltflächen selbst an. Die Formatvorlagen werden im Thema Symbolleisten-Steuerelement- und Schaltflächenformatvorlagen im Windows SDK beschrieben.

Um erweiterte Symbolleistenformate zu verwenden, rufen SetExtendedStyle Sie nach dem Anruf Createauf. Um eine Symbolleiste mit erweiterten Fensterformatvorlagen zu erstellen, rufen Sie CToolBarCtrl::CreateEx anstelle von Create.

Das Symbolleistensteuerelement legt automatisch die Größe und Position des Symbolleistenfensters fest. Die Höhe basiert auf der Höhe der Schaltflächen in der Symbolleiste. Die Breite entspricht der Breite des Clientbereichs des übergeordneten Fensters. Die CCS_TOP Formatvorlagen CCS_BOTTOM bestimmen, ob die Symbolleiste am oberen oder unteren Rand des Clientbereichs positioniert ist. Standardmäßig weist eine Symbolleiste den CCS_TOP Stil auf.

CToolBarCtrl::CreateEx

Erstellt ein Steuerelement (ein untergeordnetes Fenster) und ordnet es dem Objekt zu CToolBarCtrl .

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwExStyle
Gibt die erweiterte Formatvorlage des zu erstellenden Steuerelements an. Eine Liste der erweiterten Windows-Stile finden Sie im dwExStyle Parameter für CreateWindowEx das Windows SDK.

dwStyle
Gibt die Formatvorlage des Symbolleistensteuerelements an. Symbolleisten müssen immer über die WS_CHILD Formatvorlage verfügen. Darüber hinaus können Sie eine beliebige Kombination aus Symbolleistenformatvorlagen und Fensterformatvorlagen angeben, wie im Abschnitt "Hinweise" beschriebenCreate.

rect
Ein Verweis auf eine RECT Struktur, die die Größe und Position des zu erstellenden Fensters in Clientkoordinaten pParentWndbeschreibt.

pParentWnd
Ein Zeiger auf das Fenster, das das übergeordnete Steuerelement ist.

nID
Die Untergeordnete Fenster-ID des Steuerelements.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Verwenden Sie CreateEx anstelle von Create erweiterten Windows-Formatvorlagen, die durch die Erweiterte Formatvorlage WS_EX_von Windows angegeben werden. CreateEx erstellt das Steuerelement mit den erweiterten Windows-Formatvorlagen, die durch dwExStyle. Festlegen erweiterter Formatvorlagen, die für ein Steuerelement spezifisch sind.SetExtendedStyle Verwenden Sie CreateEx z. B. zum Festlegen von Formatvorlagen wie WS_EX_CONTEXTHELP, aber zum SetExtendedStyle Festlegen von Formatvorlagen wie TBSTYLE_EX_DRAWDDARROWS. Weitere Informationen finden Sie in den formatvorlagen, die in den erweiterten Formatvorlagen der Symbolleiste im Windows SDK beschrieben werden.

CToolBarCtrl::CToolBarCtrl

Erstellt ein CToolBarCtrl-Objekt.

CToolBarCtrl();

Hinweise

Sie müssen aufrufen Create , um die Symbolleiste nutzbar zu machen.

CToolBarCtrl::Customize

Zeigt das Dialogfeld Symbolleiste anpassen an.

void Customize();

Hinweise

In diesem Dialogfeld kann der Benutzer die Symbolleiste anpassen, indem Schaltflächen hinzugefügt und gelöscht werden. Zur Unterstützung der Anpassung muss das übergeordnete Fenster der Symbolleiste die Anpassungsbenachrichtigungen verarbeiten, wie in der Behandlung von Anpassungsbenachrichtigungen beschrieben. Ihre Symbolleiste muss auch mit der CCS_ADJUSTABLE Formatvorlage erstellt worden sein, wie in CToolBarCtrl::Create.

CToolBarCtrl::DeleteButton

Löscht eine Schaltfläche aus dem Symbolleistensteuerelement.

BOOL DeleteButton(int nIndex);

Parameter

nIndex
Nullbasierter Index der zu löschenden Schaltfläche.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

CToolBarCtrl::EnableButton

Aktiviert oder deaktiviert die angegebene Schaltfläche in einem Symbolleistensteuerelement.

BOOL EnableButton(
    int nID,
    BOOL bEnable = TRUE);

Parameter

nID
Befehlsbezeichner der Schaltfläche, die aktiviert oder deaktiviert werden soll.

bEnable
TRUE, wenn die Schaltfläche aktiviert ist; FALSE, wenn die Schaltfläche deaktiviert ist.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Wenn eine Schaltfläche aktiviert wurde, kann sie gedrückt und überprüft werden. Wenn Sie mehr als einen Schaltflächenzustand ändern möchten, sollten Sie stattdessen anrufen SetState .

CToolBarCtrl::GetAnchorHighlight

Ruft die Ankermarkierungseinstellung für eine Symbolleiste ab.

BOOL GetAnchorHighlight() const;

Rückgabewert

Wenn kein Zero aktiviert ist, ist die Ankermarkierung aktiviert. Wenn Null, ist die Ankermarkierung deaktiviert.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_GETANCHORHIGHLIGHT, wie im Windows SDK beschrieben.

CToolBarCtrl::GetBitmap

Ruft den Index der Bitmap ab, die einer Schaltfläche in einer Symbolleiste zugeordnet ist.

int GetBitmap(int nID) const;

Parameter

nID
Befehlsbezeichner der Schaltfläche, deren Bitmapindex abgerufen werden soll.

Rückgabewert

Gibt den Index der Bitmap zurück, wenn die Bitmap erfolgreich oder null ist.

Hinweise

Implementiert die Funktionalität im TB_GETBITMAP Windows SDK.

CToolBarCtrl::GetBitmapFlags

Ruft die Bitmapkennzeichnungen von der Symbolleiste ab.

UINT GetBitmapFlags() const;

Rückgabewert

A UINT that has the TBBF_LARGE flag set if the display can support large toolbar bitmaps, clear otherwise.

Hinweise

Sie sollten sie nach dem Erstellen der Symbolleiste aufrufen, aber bevor Sie der Symbolleiste Bitmaps hinzufügen. Der Rückgabewert gibt an, ob die Anzeige große Bitmaps unterstützt oder nicht. Wenn die Anzeige große Bitmaps unterstützt und wenn Sie diese verwenden möchten, rufen SetBitmapSize Sie und SetButtonSize vor dem Hinzufügen der großen Bitmap mit AddBitmap.

CToolBarCtrl::GetButton

Ruft Informationen zur angegebenen Schaltfläche in einem Symbolleistensteuerelement ab.

BOOL GetButton(
    int nIndex,
    LPTBBUTTON lpButton) const;

Parameter

nIndex
Nullbasierter Index der Schaltfläche, für die Informationen abgerufen werden sollen.

lpButton
Adresse der TBBUTTON Struktur, die eine Kopie der Schaltflächeninformationen empfängt. Informationen zur Struktur finden Sie unter.See CToolBarCtrl::AddButtons for information about the TBBUTTON structure.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

CToolBarCtrl::GetButtonCount

Ruft die Anzahl der Schaltflächen ab, die sich derzeit im Symbolleistensteuerelement befinden.

int GetButtonCount() const;

Rückgabewert

Die Anzahl der Schaltflächen.

CToolBarCtrl::GetButtonInfo

Ruft die Informationen für eine Schaltfläche in einer Symbolleiste ab.

int GetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi) const;

Parameter

nID
Der Schaltflächenbezeichner.

ptbbi
Ein Zeiger auf eine TBBUTTONINFO Struktur, die die Schaltflächeninformationen empfängt.

Rückgabewert

Der nullbasierte Index der Schaltfläche, falls erfolgreich; andernfalls -1.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_GETBUTTONINFO, wie im Windows SDK beschrieben.

CToolBarCtrl::GetButtonSize

Ruft die Größe einer Symbolleistenschaltfläche ab.

DWORD GetButtonSize() const;

Rückgabewert

Ein DWORD Wert, der die Werte für Breite und Höhe in bzwHIWORDLOWORD.

CToolBarCtrl::GetButtonText

Ruft den Anzeigetext einer angegebenen Schaltfläche im aktuellen Symbolleistensteuerelement ab.

CString GetButtonText(int idButton) const;

Parameter

idButton
[in] Der Bezeichner für die Schaltfläche, deren Anzeigetext abgerufen wird.

Rückgabewert

A CString , das den Anzeigetext der angegebenen Schaltfläche enthält.

Hinweise

Diese Methode sendet die TB_GETBUTTONTEXT Nachricht, die im Windows SDK beschrieben wird.

CToolBarCtrl::GetColorScheme

Ruft das Farbschema des aktuellen Symbolleistensteuerelements ab.

BOOL GetColorScheme(COLORSCHEME* lpColorScheme) const;

Parameter

lpColorScheme
[out] Zeigen Sie auf eine COLORSCHEME Struktur, die die Farbschemainformationen empfängt. Wenn diese Methode zurückgegeben wird, beschreibt die Struktur die Hervorhebungsfarbe und Schattenfarbe des Symbolleistensteuerelements.

Rückgabewert

TRUEwenn diese Methode erfolgreich ist; andernfalls . FALSE

Hinweise

Diese Methode sendet die TB_GETCOLORSCHEME Nachricht, die im Windows SDK beschrieben wird.

CToolBarCtrl::GetDisabledImageList

Ruft die Bildliste ab, die ein Symbolleistensteuerelement zum Anzeigen deaktivierter Schaltflächen verwendet.

CImageList* GetDisabledImageList() const;

Rückgabewert

Ein Zeiger auf ein CImageList Objekt oder NULL wenn keine deaktivierte Bildliste festgelegt ist.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_GETDISABLEDIMAGELIST, wie im Windows SDK beschrieben. Die MFC-Implementierung GetDisabledImageList verwendet ein CImageList Objekt, das die Schaltflächenbilder des Symbolleistensteuerelements anstelle eines Handles für eine Bildliste enthält.

CToolBarCtrl::GetDropTarget

Ruft die IDropTarget Schnittstelle für ein Symbolleistensteuerelement ab.

HRESULT GetDropTarget(IDropTarget** ppDropTarget) const;

Parameter

ppDropTarget
Ein Zeiger auf einen IDropTarget Schnittstellenzeiger. Wenn ein Fehler auftritt, wird ein NULL Zeiger in dieser Adresse platziert.

Rückgabewert

Gibt einen HRESULT Wert zurück, der den Erfolg oder Fehler des Vorgangs angibt.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_GETOBJECT, wie im Windows SDK beschrieben.

CToolBarCtrl::GetExtendedStyle

Ruft die erweiterten Formatvorlagen für ein Symbolleistensteuerelement ab.

DWORD GetExtendedStyle() const;

Rückgabewert

A DWORD that represents the extended styles currently in use for the toolbar control. Eine Liste der Formatvorlagen finden Sie unter "Erweiterte Formatvorlagen der Symbolleiste" im Windows SDK.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_GETEXTENDEDSTYLE, wie im Windows SDK beschrieben.

CToolBarCtrl::GetHotImageList

Ruft die Bildliste ab, die ein Symbolleistensteuerelement zum Anzeigen von "heißen" Schaltflächen verwendet. Eine Hot Button wird hervorgehoben, wenn sich der Mauszeiger darüber befindet.

CImageList* GetHotImageList() const;

Rückgabewert

Ein Zeiger auf ein CImageList Objekt oder NULL wenn keine deaktivierte Bildliste festgelegt ist.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_GETHOTIMAGELIST, wie im Windows SDK beschrieben. Eine Hot Button wird hervorgehoben, wenn sich der Mauszeiger darüber befindet.

CToolBarCtrl::GetHotItem

Ruft den Index des heißen Elements in einer Symbolleiste ab.

int GetHotItem() const;

Rückgabewert

Der nullbasierte Index des heißen Elements in einer Symbolleiste.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_GETHOTITEM, wie im Windows SDK beschrieben.

CToolBarCtrl::GetImageList

Ruft die Bildliste ab, die ein Symbolleistensteuerelement zum Anzeigen von Schaltflächen im Standardzustand verwendet.

CImageList* GetImageList() const;

Rückgabewert

Ein Zeiger auf ein CImageList Objekt oder NULL wenn keine Bildliste festgelegt ist.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_GETIMAGELIST, wie im Windows SDK beschrieben.

CToolBarCtrl::GetInsertMark

Ruft die aktuelle Einfügemarke für die Symbolleiste ab.

void GetInsertMark(TBINSERTMARK* ptbim) const;

Parameter

ptbim
Ein Zeiger auf eine TBINSERTMARK Struktur, die die Einfügemarke empfängt.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_GETINSERTMARK, wie im Windows SDK beschrieben.

CToolBarCtrl::GetInsertMarkColor

Ruft die Farbe ab, mit der die Einfügemarke für die Symbolleiste gezeichnet wird.

COLORREF GetInsertMarkColor() const;

Rückgabewert

Ein COLORREF Wert, der die aktuelle Einfügemarkesfarbe enthält.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_GETINSERTMARKCOLOR, wie im Windows SDK beschrieben.

CToolBarCtrl::GetItemRect

Ruft das umgebende Rechteck einer Schaltfläche in einem Symbolleistensteuerelement ab.

BOOL GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parameter

nIndex
Nullbasierter Index der Schaltfläche, für die Informationen abgerufen werden sollen.

lpRect
Adresse einer RECT Struktur oder eines CRect Objekts, das die Koordinaten des umgebenden Rechtecks empfängt.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Diese Funktion ruft das umgebende Rechteck nicht für Schaltflächen ab, deren Zustand auf TBSTATE_HIDDEN

CToolBarCtrl::GetMaxSize

Ruft die Gesamtgröße aller sichtbaren Schaltflächen und Trennzeichen in der Symbolleiste ab.

BOOL GetMaxSize(LPSIZE pSize) const;

Parameter

pSize
Ein Zeiger auf eine SIZE Struktur, die die Größe der Elemente empfängt.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_GETMAXSIZE, wie im Windows SDK beschrieben.

CToolBarCtrl::GetMaxTextRows

Ruft die maximale Anzahl von Textzeilen ab, die auf einer Symbolleistenschaltfläche angezeigt werden.

int GetMaxTextRows() const;

Rückgabewert

Die maximale Anzahl von Textzeilen, die auf einer Symbolleistenschaltfläche angezeigt werden.

CToolBarCtrl::GetMetrics

Ruft die Metriken des CToolBarCtrl Objekts ab.

void GetMetrics(LPTBMETRICS ptbm) const;

Parameter

ptbm
Ein Zeiger auf die TBMETRICS Struktur des CToolBarCtrl Objekts.

Hinweise

Diese Memberfunktion emuliert die Funktionalität der TB_GETMETRICS Nachricht, wie im Windows SDK beschrieben.

CToolBarCtrl::GetPadding

Ruft den horizontalen und vertikalen Abstand des aktuellen Symbolleistensteuerelements ab.

BOOL GetPadding(
    int* pnHorzPadding,
    int* pnVertPadding) const;

Parameter

pnHorzPadding
[out] Eine ganze Zahl, die den horizontalen Abstand des Symbolleistensteuerelements in Pixeln empfängt.

pnVertPadding
[out] Eine ganze Zahl, die den vertikalen Abstand des Symbolleistensteuerelements in Pixeln empfängt.

Rückgabewert

TRUEwenn diese Methode erfolgreich ist; andernfalls . FALSE

Hinweise

Diese Methode sendet die TB_GETPADDING Nachricht, die im Windows SDK beschrieben wird.

CToolBarCtrl::GetPressedImageList

Ruft die Bildliste ab, die das aktuelle Symbolleistensteuerelement verwendet, um Schaltflächen im gedrückten Zustand darzustellen.

CImageList* GetPressedImageList();

Rückgabewert

Zeigen Sie auf ein CImageList Steuerelement, das die Bildliste für das aktuelle Steuerelement enthält oder NULL wenn keine solche Bildliste festgelegt ist.

Hinweise

Diese Methode sendet die TB_GETPRESSEDIMAGELIST Nachricht, die im Windows SDK beschrieben wird.

CToolBarCtrl::GetRect

Ruft das umgebende Rechteck für eine angegebene Symbolleistenschaltfläche ab.

BOOL GetRect(
    int nID,
    LPRECT lpRect) const;

Parameter

nID
Der Schaltflächenbezeichner.

lpRect
Ein Zeiger auf eine RECT Struktur, um die umgebenden Rechteckinformationen zu empfangen.

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_GETRECT, wie im Windows SDK beschrieben.

CToolBarCtrl::GetRows

Ruft die Anzahl der Zeilen von Schaltflächen ab, die derzeit vom Symbolleistensteuerelement angezeigt werden.

int GetRows() const;

Rückgabewert

Anzahl der Derzeit auf der Symbolleiste angezeigten Schaltflächenzeilen.

Hinweise

Beachten Sie, dass die Anzahl der Zeilen immer eins ist, es sei denn, die Symbolleiste wurde mit der TBSTYLE_WRAPABLE Formatvorlage erstellt.

CToolBarCtrl::GetState

Ruft Informationen zum Status der angegebenen Schaltfläche in einem Symbolleistensteuerelement ab, z. B. ob sie aktiviert, gedrückt oder aktiviert ist.

int GetState(int nID) const;

Parameter

nID
Befehlsbezeichner der Schaltfläche, für die Informationen abgerufen werden sollen.

Rückgabewert

Die Schaltflächenstatusinformationen, falls erfolgreich oder -1 andernfalls. Die Schaltflächenstatusinformationen können eine Kombination der werte sein, die in CToolBarCtrl::AddButtons.

Hinweise

Diese Funktion ist besonders praktisch, wenn Sie mehr als einen der Schaltflächenzustände abrufen möchten. Um nur einen Zustand abzurufen, verwenden Sie eine der folgenden Memberfunktionen: IsButtonEnabled, , IsButtonChecked, , IsButtonPressed, IsButtonHiddenoder IsButtonIndeterminate. Die Memberfunktion ist jedoch die einzige Möglichkeit, GetState den TBSTATE_WRAP Schaltflächenzustand zu erkennen.

CToolBarCtrl::GetString

Ruft eine Symbolleistenzeichenfolge ab.

int GetString(
    int nString,
    LPTSTR lpstrString,
    int cchMaxLen) const;

int GetString(
    int nString,
    CString& str) const;

Parameter

nString
Index der Zeichenfolge.

lpstrString
Zeiger auf einen Puffer, der zum Zurückgeben der Zeichenfolge verwendet wird.

cchMaxLen
Länge des Puffers in Byte.

str
Die -Zeichenfolge.

Rückgabewert

Die Länge der Zeichenfolge, wenn dies erfolgreich ist, -1, wenn nicht.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_GETSTRING, wie im Windows SDK beschrieben.

CToolBarCtrl::GetStyle

Ruft die derzeit auf ein Symbolleistensteuerelement angewendeten Formatvorlagen ab.

DWORD GetStyle() const;

Rückgabewert

Eine DWORD Kombination aus Symbolleisten-Steuerelementstilen, wie im Windows SDK beschrieben.

CToolBarCtrl::GetToolTips

Ruft den Ziehpunkt des QuickInfo-Steuerelements ab, falls vorhanden, das dem Symbolleistensteuerelement zugeordnet ist.

CToolTipCtrl* GetToolTips() const;

Rückgabewert

Ein Zeiger auf das Objekt, das CToolTipCtrl dieser Symbolleiste zugeordnet ist, oder NULL wenn die Symbolleiste kein Zugehöriges QuickInfo-Steuerelement aufweist.

Hinweise

Da das Symbolleistensteuerelement normalerweise ein eigenes QuickInfo-Steuerelement erstellt und verwaltet, müssen die meisten Programme diese Funktion nicht aufrufen.

CToolBarCtrl::HitTest

Bestimmt, wo sich ein Punkt in einem Symbolleistensteuerelement befindet.

int HitTest(LPPOINT ppt) const;

Parameter

ppt
Ein Zeiger auf eine POINT Struktur, die die X-Koordinate des Treffertests im x Element und die y-Koordinate des Treffertests im y Element enthält. Die Koordinaten sind relativ zum Clientbereich der Symbolleiste.

Rückgabewert

Ein ganzzahliger Wert, der die Position eines Punkts auf einer Symbolleiste angibt. Wenn der Wert null oder ein positiver Wert ist, ist dieser Rückgabewert der nullbasierte Index des nichtseparatorischen Elements, in dem der Punkt liegt.

Wenn der Rückgabewert negativ ist, liegt der Punkt nicht innerhalb einer Schaltfläche. Der absolute Wert des Rückgabewerts ist der Index eines Trennzeichenelements oder des nächstgelegenen Nichtseparatorelements.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_HITTEST, wie im Windows SDK beschrieben.

CToolBarCtrl::HideButton

Blendet die angegebene Schaltfläche in einem Symbolleistensteuerelement aus oder zeigt sie an.

BOOL HideButton(
    int nID,
    BOOL bHide = TRUE);

Parameter

nID
Befehlsbezeichner der aus- oder einzublendenden Schaltfläche.

bHide
TRUE um die Schaltfläche auszublenden, FALSE um sie anzuzeigen.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Wenn Sie mehr als einen Schaltflächenzustand ändern möchten, sollten Sie stattdessen anrufen SetState .

CToolBarCtrl::Indeterminate

Legt den unbestimmten Zustand der angegebenen Schaltfläche in einem Symbolleistensteuerelement fest oder löscht sie.

BOOL Indeterminate(
    int nID,
    BOOL bIndeterminate = TRUE);

Parameter

nID
Befehlsbezeichner der Schaltfläche, deren unbestimmter Zustand festgelegt oder gelöscht werden soll.

bIndeterminate
TRUE um den unbestimmten Zustand für die angegebene Schaltfläche festzulegen, FALSE um ihn zu löschen.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Unbestimmte Schaltflächen werden abgeblendet angezeigt, z. B. wie die Fett-Schaltfläche auf der Symbolleiste eines Textverarbeitungsprogramms aussehen würde, wenn der ausgewählte Text sowohl fett als auch normale Zeichen enthält. Wenn Sie mehr als einen Schaltflächenzustand ändern möchten, sollten Sie stattdessen anrufen SetState .

CToolBarCtrl::InsertButton

Fügt eine Schaltfläche in ein Symbolleistensteuerelement ein.

BOOL InsertButton(
    int nIndex,
    LPTBBUTTON lpButton);

Parameter

nIndex
Nullbasierter Index einer Schaltfläche. Diese Funktion fügt die neue Schaltfläche links neben dieser Schaltfläche ein.

lpButton
Adresse einer TBBUTTON Struktur, die Informationen zu der einzufügenden Schaltfläche enthält. Eine Beschreibung der Struktur finden Sie unter.See CToolBarCtrl::AddButtons for a description of the TBBUTTON structure.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Das Bild und/oder die Zeichenfolge, deren Index Sie angeben, müssen zuvor der Liste des Symbolleistensteuerelements mithilfe AddBitmapvon , AddStringund/oder hinzugefügt AddStringsworden sein.

CToolBarCtrl::InsertMarkHitTest

Ruft die Einfügemarkeinformationen für einen Punkt in einer Symbolleiste ab.

BOOL InsertMarkHitTest(
    LPPOINT ppt,
    LPTBINSERTMARK ptbim) const;

Parameter

ppt
Ein Zeiger auf eine POINT Struktur, die die Treffertestkoordinaten relativ zum Clientbereich der Symbolleiste enthält.

ptbim
Ein Zeiger auf eine TBINSERTMARK Struktur, die die Einfügemarkeinformationen empfängt.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_INSERTMARKHITTEST, wie im Windows SDK beschrieben.

CToolBarCtrl::IsButtonChecked

Bestimmt, ob die angegebene Schaltfläche in einem Symbolleistensteuerelement aktiviert ist.

BOOL IsButtonChecked(int nID) const;

Parameter

nID
Befehlsbezeichner der Schaltfläche in der Symbolleiste.

Rückgabewert

Nonzero, wenn die Schaltfläche aktiviert ist; andernfalls 0.

Hinweise

Erwägen Sie das Aufrufen GetState , wenn Sie mehr als einen Schaltflächenzustand abrufen möchten.

CToolBarCtrl::IsButtonEnabled

Bestimmt, ob die angegebene Schaltfläche in einem Symbolleistensteuerelement aktiviert ist.

BOOL IsButtonEnabled(int nID) const;

Parameter

nID
Befehlsbezeichner der Schaltfläche in der Symbolleiste.

Rückgabewert

Nonzero, wenn die Schaltfläche aktiviert ist; andernfalls 0.

Hinweise

Erwägen Sie das Aufrufen GetState , wenn Sie mehr als einen Schaltflächenzustand abrufen möchten.

CToolBarCtrl::IsButtonHidden

Bestimmt, ob die angegebene Schaltfläche in einem Symbolleistensteuerelement ausgeblendet ist.

BOOL IsButtonHidden(int nID) const;

Parameter

nID
Befehlsbezeichner der Schaltfläche in der Symbolleiste.

Rückgabewert

Nonzero, wenn die Schaltfläche ausgeblendet ist; andernfalls 0.

Hinweise

Erwägen Sie das Aufrufen GetState , wenn Sie mehr als einen Schaltflächenzustand abrufen möchten.

CToolBarCtrl::IsButtonHighlighted

Überprüft den Hervorhebungsstatus einer Symbolleistenschaltfläche.

BOOL IsButtonHighlighted(int nID) const;

Parameter

nID
[in] Die Befehls-ID für die Symbolleistenschaltfläche.

Rückgabewert

Positive ganze Zahl, wenn die Schaltfläche hervorgehoben ist, 0, wenn die Schaltfläche nicht hervorgehoben ist, oder -1, wenn ein Fehler auftritt.

CToolBarCtrl::IsButtonIndeterminate

Bestimmt, ob die angegebene Schaltfläche in einem Symbolleistensteuerelement unbestimmt ist.

BOOL IsButtonIndeterminate(int nID) const;

Parameter

nID
[in] Befehlsbezeichner der Schaltfläche in der Symbolleiste.

Rückgabewert

Positive ganze Zahl, wenn die Schaltfläche unbestimmt ist, null, wenn die Schaltfläche nicht unbestimmt ist, oder -1, wenn ein Fehler auftritt.

Hinweise

Unbestimmte Schaltflächen werden abgeblendet angezeigt, z. B. wie die fett formatierte Schaltfläche auf der Symbolleiste eines Textprozessors aussieht, wenn der markierte Text sowohl fett als auch normale Zeichen enthält. Erwägen Sie das Aufrufen GetState , wenn Sie mehr als einen Schaltflächenzustand abrufen möchten.

CToolBarCtrl::IsButtonPressed

Bestimmt, ob die angegebene Schaltfläche in einem Symbolleistensteuerelement gedrückt wird.

BOOL IsButtonPressed(int nID) const;

Parameter

nID
Befehlsbezeichner der Schaltfläche in der Symbolleiste.

Rückgabewert

Nonzero, wenn die Taste gedrückt wird, andernfalls Null.

Hinweise

Erwägen Sie das Aufrufen GetState , wenn Sie mehr als einen Schaltflächenzustand abrufen möchten.

CToolBarCtrl::LoadImages

Lädt Bitmaps in die Bildliste eines Symbolleistensteuerelements.

void LoadImages(
    int iBitmapID,
    HINSTANCE hinst);

Parameter

iBitmapID
ID einer Bitmap, die die zu ladenden Bilder enthält. Um Ihre eigene Bitmapressource anzugeben, legen Sie diesen Parameter auf die ID einer Bitmapressource fest und legen Sie sie hInst auf NULL. Ihre Bitmapressource wird der Bildliste als einzelnes Bild hinzugefügt. Sie können standardmäßige, systemdefinierte Bitmaps hinzufügen, indem Sie diesen Parameter auf HINST_COMMCTRL eine der folgenden IDs festlegen hinst und festlegen:

Bitmap-ID Beschreibung
IDB_HIST_LARGE_COLOR Explorer-Bitmaps in großer Größe
IDB_HIST_SMALL_COLOR Explorer-Bitmaps in kleiner Größe
IDB_STD_LARGE_COLOR Standardbitmaps in großer Größe
IDB_STD_SMALL_COLOR Standardbitmaps in kleiner Größe
IDB_VIEW_LARGE_COLOR Anzeigen von Bitmaps in großer Größe
IDB_VIEW_SMALL_COLOR Anzeigen von Bitmaps in kleiner Größe

hinst
Programminstanzhandle für die aufrufende Anwendung. Dieser Parameter kann das Laden einer Standardbildliste sein HINST_COMMCTRL .

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_LOADIMAGES, wie im Windows SDK beschrieben.

CToolBarCtrl::MapAccelerator

Ordnet einer Symbolleistenschaltfläche ein Zugriffstastenzeichen zu.

BOOL MapAccelerator(
    TCHAR chAccel,
    UINT* pIDBtn);

Parameter

chAccel
Zugriffstastenzeichen, das zugeordnet werden soll. Dieses Zeichen ist dasselbe Zeichen, das im Text der Schaltfläche unterstrichen ist.

pIDBtn
Ein Zeiger auf einen UINT , der den Befehlsbezeichner der Schaltfläche empfängt, die der in chAccelder Betreffenden angegebenen Zugriffstaste entspricht.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_MAPACCELERATOR, wie im Windows SDK beschrieben.

CToolBarCtrl::MarkButton

Legt den Hervorhebungszustand einer bestimmten Schaltfläche in einem Symbolleistensteuerelement fest.

BOOL MarkButton(
    int nID,
    BOOL fHighlight = TRUE);

Parameter

nID
Der Schaltflächenbezeichner.

fHighlight
Gibt den festzulegenden Hervorhebungszustand an. Standardmäßig TRUE. Bei Festlegung auf FALSE, wird die Schaltfläche auf den Standardzustand festgelegt.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_MARKBUTTON, wie im Windows SDK beschrieben.

CToolBarCtrl::MoveButton

Verschiebt eine Schaltfläche von einem Index in einen anderen.

BOOL MoveButton(
    UINT nOldPos,
    UINT nNewPos);

Parameter

nOldPos
Der nullbasierte Index der zu verschiebenden Schaltfläche.

nNewPos
Der nullbasierte Index des Ziels der Schaltfläche.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_MOVEBUTTON, wie im Windows SDK beschrieben.

CToolBarCtrl::PressButton

Drückt oder gibt die angegebene Schaltfläche in einem Symbolleistensteuerelement frei.

BOOL PressButton(int nID, BOOL bPress = TRUE);

Parameter

nID
[in] Befehlsbezeichner der Taste, die gedrückt oder losgelassen werden soll.

bPress
[in] TRUE um die angegebene Taste zu drücken; FALSE um die angegebene Schaltfläche freizugeben. Der Standardwert ist TRUE.

Rückgabewert

TRUE, wenn die Methode erfolgreich ausgeführt wurde, andernfalls FALSE.

Hinweise

Wenn Sie mehr als einen Schaltflächenzustand ändern möchten, sollten Sie stattdessen anrufen SetState .

Diese Methode sendet die TB_PRESSBUTTON Nachricht, die im Windows SDK beschrieben wird.

CToolBarCtrl::ReplaceBitmap

Ersetzt die vorhandene Bitmap im aktuellen Symbolleistensteuerelement durch eine neue Bitmap.

BOOL ReplaceBitmap(LPTBREPLACEBITMAP pReplaceBitmap);

Parameter

pReplaceBitmap
[in] Zeigen Sie auf eine TBREPLACEBITMAP Struktur, die die zu ersetzende Bitmap und die neue Bitmap beschreibt.

Rückgabewert

TRUEwenn diese Methode erfolgreich ist; andernfalls . FALSE

Hinweise

Diese Methode sendet die TB_REPLACEBITMAP Nachricht, die im Windows SDK beschrieben wird.

Beispiel

Im folgenden Codebeispiel wird die Bitmap für die Standardsymbolleiste durch eine andere Bitmap ersetzt.

{
   // Replace one toolbar bitmap with another.
   TBREPLACEBITMAP tbrb;
   tbrb.hInstOld = ::AfxGetInstanceHandle();
   tbrb.nIDOld = IDR_MAINFRAME;
   tbrb.hInstNew = ::AfxGetInstanceHandle();
   tbrb.nIDNew = IDR_MAINFRAME1;
   tbrb.nButtons = 8;
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ReplaceBitmap(&tbrb);
}

CToolBarCtrl::RestoreState

Stellt den Status des Symbolleistensteuerelements von der Position in der registrierung wieder her, die durch die Parameter angegeben wird.

void RestoreState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

Parameter

hKeyRoot
Gibt einen aktuell geöffneten Schlüssel in der Registrierung oder einen der folgenden vordefinierten reservierten Handlewerte an:

  • HKEY_CLASSES_ROOT

  • HKEY_CURRENT_USER

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

lpszSubKey
Verweist auf eine NULLbeendete Zeichenfolge, die den Namen des Unterschlüssels enthält, dem ein Wert zugeordnet ist. Dieser Parameter kann oder ein Zeiger auf eine leere Zeichenfolge sein NULL . Wenn der Parameter lautet NULL, wird der Wert dem durch den hKeyRoot Parameter identifizierten Schlüssel hinzugefügt.

lpszValueName
Verweist auf eine Zeichenfolge, die den Namen des abzurufenden Werts enthält. Wenn ein Wert mit diesem Namen noch nicht im Schlüssel vorhanden ist, fügt die Funktion ihn dem Schlüssel hinzu.

CToolBarCtrl::SaveState

Speichert den Status des Symbolleistensteuerelements an der Position in der registrierung, die durch die Parameter angegeben wird.

void SaveState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

Parameter

hKeyRoot
Gibt einen aktuell geöffneten Schlüssel in der Registrierung oder einen der folgenden vordefinierten reservierten Handlewerte an:

  • HKEY_CLASSES_ROOT

  • HKEY_CURRENT_USER

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

lpszSubKey
Verweist auf eine NULLbeendete Zeichenfolge, die den Namen des Unterschlüssels enthält, dem ein Wert zugeordnet ist. Dieser Parameter kann oder ein Zeiger auf eine leere Zeichenfolge sein NULL . Wenn der Parameter lautet NULL, wird der Wert dem durch den hKeyRoot Parameter identifizierten Schlüssel hinzugefügt.

lpszValueName
Verweist auf eine Zeichenfolge, die den Namen des festzulegenden Werts enthält. Wenn ein Wert mit diesem Namen noch nicht im Schlüssel vorhanden ist, fügt die Funktion ihn dem Schlüssel hinzu.

CToolBarCtrl::SetAnchorHighlight

Legt die Einstellung für die Ankermarkierung für eine Symbolleiste fest.

BOOL SetAnchorHighlight(BOOL fAnchor = TRUE);

Parameter

fAnchor
[in] Gibt an, ob die Ankermarkierung aktiviert oder deaktiviert ist. Wenn dieser Wert nicht null ist, wird die Ankermarkierung aktiviert. Wenn dieser Wert null ist, wird die Ankermarkierung deaktiviert.

Rückgabewert

Die vorherige Verankerungseinstellung. Wenn die Hervorhebung aktiviert war, ist dieser Wert nicht null. Wenn die Hervorhebung nicht aktiviert war, ist dieser Wert null.

Hinweise

Diese Methode implementiert das Verhalten der Win32-Nachricht TB_SETANCHORHIGHLIGHT, wie im Windows SDK beschrieben.

CToolBarCtrl::SetBitmapSize

Legt die Größe der tatsächlichen Bitmapbilder fest, die einem Symbolleistensteuerelement hinzugefügt werden sollen.

BOOL SetBitmapSize(CSize size);

Parameter

size
Breite und Höhe der Bitmapbilder in Pixeln.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Diese Funktion muss nur aufgerufen werden, bevor Sie der Symbolleiste Bitmaps hinzufügen. Wenn die Anwendung die Bitmapgröße nicht explizit festgelegt hat, wird sie standardmäßig auf 16 x 15 Pixel festgelegt.

CToolBarCtrl::SetButtonInfo

Legt die Informationen für eine vorhandene Schaltfläche in einer Symbolleiste fest.

BOOL SetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi);

Parameter

nID
Der Schaltflächenbezeichner.

ptbbi
Ein Zeiger auf eine TBBUTTONINFO Struktur, die die Schaltflächeninformationen empfängt.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Die Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_SETBUTTONINFO, wie im Windows SDK beschrieben.

CToolBarCtrl::SetButtonSize

Legt die Größe der Schaltflächen im Symbolleistensteuerelement fest.

BOOL SetButtonSize(CSize size);

Parameter

size
Breite und Höhe der Schaltflächen in Pixeln.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Die Schaltflächengröße muss immer mindestens so groß sein, wie die eingeschlossene Bitmapgröße. Diese Funktion muss nur aufgerufen werden, bevor Sie der Symbolleiste Bitmaps hinzufügen. Wenn die Anwendung die Schaltflächengröße nicht explizit festgelegt hat, wird sie standardmäßig auf 24 x 22 Pixel festgelegt.

Beispiel

Ein Beispiel hierfür finden Sie unter CToolBar::GetToolBarCtrl.

CToolBarCtrl::SetButtonStructSize

Gibt die Größe der TBBUTTON Struktur an.

void SetButtonStructSize(int nSize);

Parameter

nSize
Größe der TBBUTTON Struktur in Byte.

Hinweise

Wenn Sie zusätzliche Daten in der Struktur speichern möchten, können Sie entweder eine neue Struktur ableitenTBBUTTON, die benötigten Elemente hinzufügen oder eine neue Struktur erstellen, die TBBUTTON eine TBBUTTON Struktur als erstes Element enthält. Anschließend rufen Sie diese Funktion auf, um der Symbolleiste die Größe der neuen Struktur mitzuteilen.

Weitere Informationen zur Struktur finden Sie unter.See CToolBarCtrl::AddButtons for more information on the TBBUTTON structure.

CToolBarCtrl::SetButtonWidth

Legt die minimale und maximale Breite der Schaltflächen im Symbolleisten-Steuerelement fest.

BOOL SetButtonWidth(
    int cxMin,
    int cxMax);

Parameter

cxMin
Minimale Schaltflächenbreite in Pixel. Symbolleistenschaltflächen werden nie schmaler als dieser Wert sein.

cxMax
Maximale Schaltflächenbreite in Pixel. Wenn der Schaltflächentext zu breit ist, zeigt das Steuerelement ihn mit Auslassungspunkten an.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_SETBUTTONWIDTH, wie im Windows SDK beschrieben.

CToolBarCtrl::SetCmdID

Legt den Befehlsbezeichner fest, der beim Drücken der angegebenen Schaltfläche an das Besitzerfenster gesendet wird.

BOOL SetCmdID(
    int nIndex,
    UINT nID);

Parameter

nIndex
Der nullbasierte Index der Schaltfläche, deren Befehls-ID festgelegt werden soll.

nID
Die Befehls-ID, auf die die ausgewählte Schaltfläche festgelegt werden soll.

Rückgabewert

Gibt nonzero zurück, wenn dies erfolgreich ist; andernfalls 0.

CToolBarCtrl::SetColorScheme

Legt das Farbschema des aktuellen Symbolleistensteuerelements fest.

void SetColorScheme(const COLORSCHEME* lpColorScheme);

Parameter

lpColorScheme
[in] Zeigen Sie auf eine COLORSCHEME Struktur, die die Hervorhebungsfarbe und Schattenfarbe des Symbolleistensteuerelements beschreibt.

Hinweise

Diese Methode hat keine Auswirkung, wenn ein visuelles Windows Vista-Design festgelegt ist.

Diese Methode sendet die TB_SETCOLORSCHEME Nachricht, die im Windows SDK beschrieben wird.

Beispiel

Im folgenden Codebeispiel wird das Farbschema für das aktuelle Symbolleistensteuerelement festgelegt. Im Codebeispiel werden die linken und oberen Ränder der einzelnen Toolschaltflächen rot und die rechten und unteren Ränder blau dargestellt. Wenn der Benutzer die Schaltfläche drückt, wird die rote Kante der Schaltfläche blau, und seine blauen Kanten werden rot.

//Set color scheme for the current toolbar control.
//Make the left and top edges of the tool button red,
//and the right and bottom edges blue. The colors
//reverse when a button is pressed.
//This method has no effect if the Vista visual theme
//is set.
{
   COLORSCHEME cs;
   cs.dwSize = sizeof(COLORSCHEME);
   cs.clrBtnHighlight = RGB(255, 0, 0);
   cs.clrBtnShadow = RGB(0, 0, 255);
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetColorScheme(&cs);
}

CToolBarCtrl::SetDisabledImageList

Legt die Bildliste fest, die vom Symbolleistensteuerelement zum Anzeigen deaktivierter Schaltflächen verwendet wird.

CImageList* SetDisabledImageList(CImageList* pImageList);

Parameter

pImageList
Ein Zeiger auf ein CImageList Objekt, das die Bilder enthält, die vom Symbolleistensteuerelement verwendet werden sollen, um deaktivierte Schaltflächenbilder anzuzeigen.

Rückgabewert

Ein Zeiger auf ein CImageList Objekt, das zuvor vom Symbolleistensteuerelement zum Anzeigen deaktivierter Schaltflächenbilder verwendet wurde.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_SETDISABLEDIMAGELIST, wie im Windows SDK beschrieben. Die MFC-Implementierung verwendet SetDisabledImageList ein CImageList Objekt, das die deaktivierten Schaltflächenbilder des Symbolleistensteuerelements anstelle eines Handles für eine Bildliste enthält.

CToolBarCtrl::SetDrawTextFlags

Legt die Flags in der Win32-Funktion DrawTextfest, die verwendet wird, um den Text im angegebenen Rechteck zu zeichnen, formatiert entsprechend der Festlegung der Flags.

DWORD SetDrawTextFlags(
    DWORD dwMask,
    DWORD dwDTFlags);

Parameter

dwMask
Eine Kombination aus einer oder mehreren Flags DT_ , die in der Win32-Funktion DrawTextangegeben sind, die angibt, welche Bits dwDTFlags beim Zeichnen des Texts verwendet werden.

dwDTFlags
Eine Kombination aus einer oder mehreren Flags DT_ , die in der Win32-Funktion DrawTextangegeben sind, die angeben, wie der Schaltflächentext gezeichnet wird. Dieser Wert wird übergeben DrawText , wenn der Schaltflächentext gezeichnet wird.

Rückgabewert

A DWORD containing the previous text drawing flags.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_SETDRAWTEXTFLAGS, wie im Windows SDK beschrieben. Diese Memberfunktion legt die Flags in der Win32-Funktion DrawTextfest, die Text im angegebenen Rechteck zeichnet, das entsprechend der Festlegung der Flags formatiert ist.

CToolBarCtrl::SetExtendedStyle

Legt die erweiterten Formatvorlagen für ein Symbolleistensteuerelement fest.

DWORD SetExtendedStyle(DWORD dwExStyle);

Parameter

dwExStyle
Ein Wert, der die neuen erweiterten Formatvorlagen angibt. Dieser Parameter kann eine Kombination aus erweiterten Formatvorlagen der Symbolleiste sein.

Rückgabewert

A DWORD , das die vorherigen erweiterten Formatvorlagen darstellt. Eine Liste der Formatvorlagen finden Sie unter "Erweiterte Formatvorlagen der Symbolleiste" im Windows SDK.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_SETEXTENDEDSTYLE, wie im Windows SDK beschrieben.

CToolBarCtrl::SetHotImageList

Legt die Bildliste fest, die vom Symbolleistensteuerelement zum Anzeigen von "heißen" Schaltflächen verwendet wird.

CImageList* SetHotImageList(CImageList* pImageList);

Parameter

pImageList
Ein Zeiger auf ein CImageList Objekt, das die Bilder enthält, die vom Symbolleistensteuerelement zum Anzeigen von Hot Button-Bildern verwendet werden sollen.

Rückgabewert

Ein Zeiger auf ein CImageList Objekt, das zuvor vom Symbolleistensteuerelement zum Anzeigen von Hot Button-Bildern verwendet wurde.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_SETHOTIMAGELIST, wie im Windows SDK beschrieben.

Die MFC-Implementierung SetHotImageList verwendet ein CImageList Objekt, das die Hot Button-Bilder des Symbolleistensteuerelements anstelle eines Handles für eine Bildliste enthält. Wenn sich der Mauszeiger darüber befindet, wird eine Schaltfläche hervorgehoben.

CToolBarCtrl::SetHotItem

Legt das heiße Element in einer Symbolleiste fest.

int SetHotItem(int nHot);

Parameter

nHot
Die nullbasierte Indexnummer des Elements, das heiß gemacht wird. Wenn dieser Wert -1 ist, wird keines der Elemente heiß sein.

Rückgabewert

Der Index des vorherigen Hot-Elements oder -1, wenn kein heißes Element vorhanden war.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_SETHOTITEM, wie im Windows SDK beschrieben.

CToolBarCtrl::SetImageList

Legt die Bildliste fest, die von der Symbolleiste zum Anzeigen von Schaltflächen verwendet wird, die sich im Standardzustand befinden.

CImageList* SetImageList(CImageList* pImageList);

Parameter

pImageList
Ein Zeiger auf ein CImageList Objekt, das die Bilder enthält, die vom Symbolleistensteuerelement zum Anzeigen von Schaltflächenbildern im Standardzustand verwendet werden sollen.

Rückgabewert

Ein Zeiger auf ein CImageList Objekt, das zuvor vom Symbolleistensteuerelement zum Anzeigen von Schaltflächenbildern im Standardzustand verwendet wurde.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_SETIMAGELIST, wie im Windows SDK beschrieben.

Die MFC-Implementierung SetImageList verwendet ein CImageList Objekt, das die Schaltflächenbilder des Symbolleistensteuerelements anstelle eines Handles für eine Bildliste enthält.

CToolBarCtrl::SetIndent

Legt den Einzug für die erste Schaltfläche in einem Symbolleistensteuerelement fest.

BOOL SetIndent(int iIndent);

Parameter

iIndent
Der Wert, der den Einzug in Pixel angibt.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

CToolBarCtrl::SetInsertMark

Legt die aktuelle Einfügemarke für die Symbolleiste fest.

void SetInsertMark(TBINSERTMARK* ptbim);

Parameter

ptbim
Ein Zeiger auf die Struktur, die TBINSERTMARK die Einfügemarke enthält.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_SETINSERTMARK, wie im Windows SDK beschrieben.

CToolBarCtrl::SetInsertMarkColor

Legt die Farbe fest, mit der die Einfügemarke für die Symbolleiste gezeichnet wird.

COLORREF SetInsertMarkColor(COLORREF clrNew);

Parameter

clrNew
Ein COLORREF Wert, der die neue Einfügemarkesfarbe enthält.

Rückgabewert

Ein COLORREF Wert, der die vorherige Einfügemarkesfarbe enthält.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TB_SETINSERTMARKCOLOR, wie im Windows SDK beschrieben.

CToolBarCtrl::SetMaxTextRows

Legt die maximale Anzahl von Textzeilen fest, die auf einer Symbolleistenschaltfläche angezeigt werden.

BOOL SetMaxTextRows(int iMaxRows);

Parameter

iMaxRows
Maximale Anzahl von Zeilen, die festgelegt werden sollen.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

CToolBarCtrl::SetMetrics

Legt die Metriken des CToolBarCtrl Objekts fest.

void SetMetrics(LPTBMETRICS ptbm);

Parameter

ptbm
Ein Zeiger auf die TBMETRICS Struktur des CToolBarCtrl Objekts.

Hinweise

Diese Memberfunktion emuliert die Funktionalität der TB_SETMETRICS Nachricht, wie im Windows SDK beschrieben.

CToolBarCtrl::SetOwner

Legt das Besitzerfenster für das Symbolleistensteuerelement fest.

void SetOwner(CWnd* pWnd);

Parameter

pWnd
Zeigen Sie auf das CWnd oder CWndvom Objekt abgeleitete Objekt, das das neue Besitzerfenster für das Symbolleistensteuerelement ist.

Hinweise

Das Besitzerfenster ist das Fenster, das Benachrichtigungen von der Symbolleiste empfängt.

CToolBarCtrl::SetPadding

Legt den horizontalen und vertikalen Abstand des aktuellen Symbolleistensteuerelements fest.

DWORD SetPadding(
    int nHorzPadding,
    int nVertPadding);

Parameter

nHorzPadding
[in] Gibt den horizontalen Abstand des Symbolleistensteuerelements in Pixel an.

nVertPadding
[in] Gibt den vertikalen Abstand des Symbolleistensteuerelements in Pixel an.

Rückgabewert

A DWORD , dessen niedriges Wort den vorherigen horizontalen Abstandswert enthält und dessen hohes Wort den vorherigen vertikalen Abstandswert enthält. Die Abstandswerte werden in Pixeln gemessen.

Hinweise

Diese Methode sendet die TB_SETPADDING Nachricht, die im Windows SDK beschrieben wird.

Beispiel

Im folgenden Codebeispiel wird der horizontale und vertikale Abstand des aktuellen Symbolleistensteuerelements auf 20 Pixel festgelegt.

{
   // Set the horizontal and vertical padding of the current
   // toolbar control.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetPadding(50, 50);
}

CToolBarCtrl::SetPressedImageList

Legt die Bildliste fest, die das aktuelle Symbolleistensteuerelement verwendet, um Schaltflächen im gedrückten Zustand darzustellen.

CImagelist* SetPressedImageList(
    int iImageID,
    CImageList* pImageList);

Parameter

iImageID
[in] Der nullbasierte Index der Bildliste. Legen Sie diesen Parameter auf Null fest, wenn Sie nur eine Bildliste verwenden.

pImageList
[in] Zeigen Sie auf ein CImageList Element, das die neue Bildliste enthält.

Rückgabewert

Zeiger auf eine CImageList , die die vorherige Bildliste für das aktuelle Steuerelement enthält oder NULL wenn keine solche Bildliste festgelegt wurde.

Hinweise

Diese Methode sendet die TB_SETPRESSEDIMAGELIST Nachricht, die im Windows SDK beschrieben wird.

Beispiel

Im folgenden Codebeispiel wird festgelegt, dass die gedrückte Bildliste mit der Standardbildliste identisch ist.

{
   // SetPressedImageList
   // Set the pressed image list to be the same as the
   // normal image list.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   CImageList *pNormalCil = m_toolBarCtrl.GetImageList();
   CImageList *pPressedCil = m_toolBarCtrl.GetPressedImageList();
   m_toolBarCtrl.SetPressedImageList(0, pNormalCil);
}

CToolBarCtrl::SetRows

Fordert das Symbolleistensteuerelement auf, die Größe selbst an die angeforderte Anzahl von Zeilen zu ändern.

void SetRows(
    int nRows,
    BOOL bLarger,
    LPRECT lpRect);

Parameter

nRows
Angeforderte Anzahl von Zeilen.

bLarger
Gibt an, ob mehr Zeilen oder weniger Zeilen verwendet werden sollen, wenn die Symbolleiste nicht in die angeforderte Anzahl von Zeilen geändert werden kann.

lpRect
Verweist auf das Objekt oder RECT die CRect Struktur, das das neue umgebende Rechteck der Symbolleiste erhält.

Hinweise

Wenn sich die Symbolleiste nicht selbst an die angeforderte Zahl oder Zeile anpassen kann, wird sie je nach Wert bLargervon . Wenn bLarger dies der Wert ist TRUE, ist die neue Anzahl von Zeilen größer als die angeforderte Zahl. Wenn bLarger ja FALSE, ist die neue Anzahl von Zeilen kleiner als die angeforderte Zahl.

Eine bestimmte Anzahl von Zeilen ist für die Symbolleiste gültig, wenn die Schaltflächen so angeordnet werden können, dass alle Zeilen dieselbe Anzahl von Schaltflächen haben (mit Ausnahme der letzten Zeile). Beispielsweise konnte eine Symbolleiste, die vier Schaltflächen enthält, nicht auf drei Zeilen angepasst werden, da die letzten beiden Zeilen kürzer sein müssten. Wenn Sie versucht haben, die Größe auf drei Zeilen zu ändern, würden Sie vier Zeilen erhalten, wenn bLarger dies der Vorgang war TRUE , und zwei Zeilen, wenn bLarger dies der Fehler war FALSE.

Wenn auf der Symbolleiste Trennzeichen vorhanden sind, sind die Regeln für die Gültigkeit einer bestimmten Anzahl von Zeilen komplizierter. Das Layout wird so berechnet, dass Schaltflächengruppen (Schaltflächen mit einem Trennzeichen vor dem ersten und der letzten Schaltfläche in der Gruppe) niemals auf mehreren Zeilen aufgeteilt werden, es sei denn, die Gruppe kann nicht in eine Zeile passen.

Wenn eine Gruppe nicht in eine Zeile passt, beginnt die nächste Gruppe mit der nächsten Zeile, auch wenn sie in die Zeile passt, in der die große Gruppe beendet wurde. Der Zweck dieser Regel besteht darin, die Trennung zwischen großen Gruppen spürbarer zu machen. Die resultierenden vertikalen Trennzeichen werden als Zeilen gezählt.

Beachten Sie auch, dass die SetRows Memberfunktion immer das Layout auswäht, das zu der kleinsten Symbolleistengröße führt. Wenn Sie eine Symbolleiste mit der TBSTYLE_WRAPABLE Formatvorlage erstellen und dann die Größe des Steuerelements ändern, wird einfach die oben beschriebene Methode angewendet, wenn die Breite des Steuerelements angegeben ist.

Diese Funktion kann nur für Symbolleisten aufgerufen werden, die mit der TBSTYLE_WRAPABLE Formatvorlage erstellt wurden.

CToolBarCtrl::SetState

Legt den Zustand für die angegebene Schaltfläche in einem Symbolleistensteuerelement fest.

BOOL SetState(
    int nID,
    UINT nState);

Parameter

nID
Befehlsbezeichner der Schaltfläche.

nState
Statuskennzeichnungen. Dabei kann es sich um eine Kombination der Werte handeln, die für Schaltflächenzustände in CToolBarCtrl::AddButtons.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Diese Funktion ist besonders praktisch, wenn Sie mehr als einen der Schaltflächenzustände festlegen möchten. Um nur einen Zustand festzulegen, verwenden Sie eine der folgenden Memberfunktionen: EnableButton, , CheckButton, , HideButton, Indeterminateoder PressButton.

CToolBarCtrl::SetStyle

Legt die Formatvorlagen für ein Symbolleistensteuerelement fest.

void SetStyle(DWORD dwStyle);

Parameter

dwStyle
Eine DWORD Kombination aus Symbolleisten-Steuerelementstilen, wie im Windows SDK beschrieben.

CToolBarCtrl::SetToolTips

Ordnet ein QuickInfo-Steuerelement einem Symbolleistensteuerelement zu.

void SetToolTips(CToolTipCtrl* pTip);

Parameter

pTip
Zeiger auf das CToolTipCtrl Objekt.

CToolBarCtrl::SetWindowTheme

Legt den visuellen Stil des CToolBarCtrl Objekts fest.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parameter

pszSubAppName
Ein Zeiger auf eine Unicode-Zeichenfolge, die den festzulegenden visuellen Symbolleistenstil enthält.

Rückgabewert

Der Rückgabewert wird nicht verwendet.

Hinweise

Diese Memberfunktion emuliert die Funktionalität der TB_SETWINDOWTHEME Nachricht, wie im Windows SDK beschrieben.

Siehe auch

MFC-Beispiel CMNCTRL1
MFC-Beispiel MFCIE
CWnd Klasse
Hierarchiediagramm
CToolBar Klasse