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 der Liste der Schaltflächenbilder, die für ein Symbolleisten-Steuerelement verfügbar sind, ein oder mehrere Bitmapschaltflächenbilder hinzu.
CToolBarCtrl::AddButtons Fügt einem Symbolleisten-Steuerelement eine oder mehrere Schaltflächen hinzu.
CToolBarCtrl::AddString Fügt der internen Zeichenfolgenliste der Symbolleiste eine neue Zeichenfolge hinzu, die als Ressourcen-ID übergeben wird.
CToolBarCtrl::AddStrings Fügt der internen Zeichenfolgenliste der Symbolleiste eine neue Zeichenfolge bzw. neue Zeichenfolgen hinzu, die als Zeiger auf einen Puffer von nulltrennten Zeichenfolgen übergeben werden.
CToolBarCtrl::AutoSize Ändern der Größe eines Symbolleisten-Steuerelements.
CToolBarCtrl::ChangeBitmap Ändert die Bitmap für eine Schaltfläche im aktuellen Symbolleisten-Steuerelement.
CToolBarCtrl::CheckButton Überprüft oder löschen eine bestimmte Schaltfläche in einem Symbolleisten-Steuerelement.
CToolBarCtrl::CommandToIndex Ruft den nullbasierten Index für die Schaltfläche ab, die dem angegebenen Befehlsbezeichner zugeordnet ist.
CToolBarCtrl::Create Erstellt ein Symbolleisten-Steuerelement und hängt es an ein CToolBarCtrl -Objekt an.
CToolBarCtrl::CreateEx Erstellt ein Symbolleisten-Steuerelement mit dem Windows erweiterten Stilen und hängt es an ein CToolBarCtrl -Objekt an.
CToolBarCtrl::Customize Zeigt das Dialogfeld Symbolleiste anpassen an.
CToolBarCtrl::D eleteButton Löscht eine Schaltfläche aus dem Symbolleisten-Steuerelement.
CToolBarCtrl::EnableButton Aktiviert oder deaktiviert die angegebene Schaltfläche in einem Symbolleisten-Steuerelement.
CToolBarCtrl::GetAnchorHighlight Ruft die Einstellung für die Hervorhebung des Ankers 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 über die angegebene Schaltfläche in einem Symbolleisten-Steuerelement ab.
CToolBarCtrl::GetButtonCount Ruft die Anzahl der Schaltflächen ab, die sich derzeit im Symbolleisten-Steuerelement befindet.
CToolBarCtrl::GetButtonInfo Ruft die Informationen für eine Schaltfläche in einer Symbolleiste ab.
CToolBarCtrl::GetButtonSize Ruft die aktuelle Breite und Höhe der Symbolleistenschaltflächen in Pixel ab.
CToolBarCtrl::GetColorScheme Ruft das Farbschema des aktuellen Symbolleisten-Steuerelements ab.
CToolBarCtrl::GetDisabledImageList Ruft die Bildliste ab, die ein Symbolleisten-Steuerelement zum Anzeigen deaktivierter Schaltflächen verwendet.
CToolBarCtrl::GetDropTarget Ruft die IDropTarget-Schnittstelle für ein Symbolleisten-Steuerelement ab.
CToolBarCtrl::GetExtendedStyle Ruft die erweiterten Stile für ein Symbolleisten-Steuerelement ab.
CToolBarCtrl::GetHotImageList Ruft die Bildliste ab, die ein Symbolleisten-Steuerelement verwendet, um "heiße" Schaltflächen anzuzeigen. Eine heiße Schaltfläche 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 Symbolleisten-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 zum Zeichnen der Einfügemarke für die Symbolleiste verwendet wird.
CToolBarCtrl::GetItemRect Ruft das umgebundene Rechteck einer Schaltfläche in einem Symbolleisten-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 Auf padding des aktuellen Symbolleisten-Steuerelements ab.
CToolBarCtrl::GetPressedImageList Ruft die Bildliste ab, die das aktuelle Symbolleisten-Steuerelement verwendet, um Schaltflächen im gedrückten Zustand anzuzeigen.
CToolBarCtrl::GetRect Ruft das umgebundene Rechteck für eine angegebene Symbolleistenschaltfläche ab.
CToolBarCtrl::GetRows Ruft die Anzahl der Zeilen von Schaltflächen ab, die derzeit auf der Symbolleiste angezeigt werden.
CToolBarCtrl::GetState Ruft Informationen zum Zustand der angegebenen Schaltfläche in einem Symbolleisten-Steuerelement 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 Symbolleisten-Steuerelement verwendeten Stile ab.
CToolBarCtrl::GetToolTips Ruft das Handle des Dem Symbolleisten-Steuerelement zugeordneten Tooltipps-Steuerelements ab( sofern verfügbar).
CToolBarCtrl::HideButton Blendet die angegebene Schaltfläche in einem Symbolleisten-Steuerelement aus oder zeigt sie an.
CToolBarCtrl::HitTest Bestimmt, wo sich ein Punkt in einem Symbolleistensteuerelement befindet.
CToolBarCtrl::Unbestimmt 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ügemarkierungsinformationen 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 Hervorhebungszustand 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 Karten ein Zugriffstastenzeichen zu einer Symbolleistenschaltfläche.
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::P ressButton 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 Zustand des Symbolleistensteuerelements wieder her.
CToolBarCtrl::SaveState Speichert den Zustand 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 Schaltflächenbreite im Symbolleistensteuerelement 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 das Symbolleistensteuerelement verwendet, um deaktivierte Schaltflächen anzuzeigen.
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 Stile für ein Symbolleistensteuerelement fest.
CToolBarCtrl::SetHotImageList Legt die Bildliste fest, die das Symbolleisten-Steuerelement verwendet, um "heiße" Schaltflächen anzuzeigen.
CToolBarCtrl::SetHotItem Legt das heiße Element in einer Symbolleiste fest.
CToolBarCtrl::SetImageList Legt die Bildliste fest, die die Symbolleiste verwendet, um Schaltflächen anzuzeigen, 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, die zum Zeichnen der Einfügemarke für die Symbolleiste verwendet 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 Benachrichtigungsmeldungen 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 Symbolleisten-Steuerelement verwendet, um Schaltflächen im gedrückten Zustand darzustellen.
CToolBarCtrl::SetRows Legt die Anzahl der Zeilen von Schaltflächen fest, die auf der Symbolleiste angezeigt werden.
CToolBarCtrl::SetState Legt den Zustand für die angegebene Schaltfläche in einem Symbolleistensteuerelement fest.
CToolBarCtrl::SetStyle Legt die Stile für ein Symbolleistensteuerelement fest.
CToolBarCtrl::SetToolTips Ordnet dem Symbolleisten-Steuerelement ein QuickInfo-Steuerelement zu.
CToolBarCtrl::SetWindowTheme Legt den visuellen Stil eines Symbolleistensteuerelements fest.

Hinweise

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

Ein allgemeines Symbolleistensteuerelement Windows 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 ausgibt, 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 Bitmaps für Schaltflächenbilder oder eine Bildliste, eine Liste von Zeichenfolgen für Schaltflächenbezeichnungen und eine Liste von TBBUTTON Strukturen, die ein Bild und/oder eine Zeichenfolge der Position, dem Stil, dem Zustand und der Befehls-ID der Schaltfläche zuordnen. Auf jedes der Elemente dieser Datenstrukturen wird durch einen nullbasierten Index verwiesen. Bevor Sie ein -Objekt verwenden CToolBarCtrl können, müssen Sie diese Datenstrukturen einrichten. Die Liste der Zeichenfolgen kann nur für Schaltflächenbezeichnungen verwendet werden. Sie können keine Zeichenfolgen von der Symbolleiste abrufen.

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

  1. Erstellen Sie das CToolBarCtrl -Objekt.

  2. Rufen Sie Erstellen auf, um das Windows symbolleisten-Steuerelement zu erstellen und an das -Objekt anfügen. Geben Sie den Stil der Symbolleiste mithilfe von Stilen an, z. B. TBSTYLE_TRANSPARENT für eine transparente Symbolleiste oder TBSTYLE_DROPDOWN symbolleiste, die Dropdownformatschaltflächen unterstützt.

  3. Bestimmen Sie, wie die Schaltflächen auf der Symbolleiste angezeigt werden:

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

  5. Wenn Sie Tooltipps für eine Symbolleistenschaltfläche in einem Besitzerfenster verwenden möchten, das kein ist, müssen Sie die TTN_NEEDTEXT-Meldungen im Besitzerfenster der Symbolleiste verarbeiten, wie unter Behandeln von Tippbenachrichtigungen für Tools CFrameWndCFrameWnd Wenn das übergeordnete Fenster der Symbolleiste von abgeleitet ist, werden Tooltipps ohne zusätzlichen Aufwand von Ihnen angezeigt, da CFrameWndCFrameWnd einen Standardhandler bietet.

  6. Wenn Sie möchten, dass Ihr Benutzer die Symbolleiste anpassen kann, verarbeiten Sie Anpassungsbenachrichtigungsmeldungen im Besitzerfenster, wie unter Behandeln von Anpassungsbenachrichtigungen beschrieben.

Sie können SaveState verwenden, um den aktuellen Zustand eines Symbolleisten-Steuerelements in der Registrierung zu speichern, und RestoreState, um den Zustand basierend auf den zuvor in der Registrierung gespeicherten Informationen wiederherzustellen. Zusätzlich zum Speichern des Symbolleistenzustands zwischen den Verwendungen der Anwendung speichern Anwendungen in der Regel den Zustand, bevor der Benutzer mit dem Anpassen der Symbolleiste beginnt, falls der Benutzer die Symbolleiste später in den ursprünglichen Zustand wiederherstellen möchte.

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

Zur Unterstützung von Funktionen, die in Internet Explorer Version 4.0 und höher eingeführt wurden, bietet MFC Bildlistenunterstützung sowie transparente und flache Stile für Symbolleisten-Steuerelemente.

Mit einer transparenten Symbolleiste kann der Client unter der Symbolleiste angezeigt werden. Um eine transparente Symbolleiste zu erstellen, verwenden Sie sowohl TBSTYLE_FLAT als auch TBSTYLE_TRANSPARENT Formatvorlagen. Transparente Symbolleisten verfügen über hot tracking; Das heißt, wenn der Mauszeiger über eine heiße Schaltfläche auf der Symbolleiste bewegt wird, ändert sich die Darstellung der Schaltfläche. Symbolleisten, die nur mit dem TBSTYLE_FLAT erstellt werden, enthalten nicht transparente Schaltflächen.

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

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

Vererbungshierarchie

Cobject

CCmdTarget

CWnd

CToolBarCtrl

Anforderungen

Header: afxcmn.h

CToolBarCtrl::AddBitmap

Fügt der Liste der im Symbolleisten-Steuerelement gespeicherten Schaltflächenbilder ein oder mehrere Schaltflächenbilder 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 die hinzuzufügenden Bilder enthält.

pBitmap
Zeiger auf das CBitmap Objekt, das das hinzuzufügende Schaltflächenbild oder die hinzuzufügenden Bilder enthält.

Rückgabewert

Nullbasierter Index des ersten neuen Images, falls erfolgreich; andernfalls : 1.

Hinweise

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

CToolBarCtrl::AddButtons

Fügt einem Symbolleisten-Steuerelement 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, das Informationen zu den hinzuzufügenden Schaltflächen enthält. Im Array muss die gleiche Anzahl von Elementen wie die von nNumButtonsangegebenen Schaltflächen enthalten sein.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Der lpButtons-Zeiger zeigt auf ein Array von -Strukturen. Jede Struktur ordnet die schaltfläche, die hinzugefügt wird, dem Stil, dem Bild und/oder der Zeichenfolge, der Befehls-ID, dem Zustand und den TBBUTTON benutzerdefinierten Daten der Schaltfläche 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 Elemente lauten wie folgt:

  • iBitmap

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

  • idCommand

    Befehlsbezeichner, der der Schaltfläche zugeordnet ist. Dieser Bezeichner wird in einer WM_COMMAND gesendet, wenn die Schaltfläche ausgewählt wird. Wenn der fsStyle Member über den TBSTYLE_SEP verfügt, muss dieser Member 0 (null) sein.

  • fsState

    Schaltflächenzustandsflags. Dies kann eine Kombination der unten aufgeführten Werte sein:

    • TBSTATE_CHECKED Die Schaltfläche verfügt über TBSTYLE_CHECKED Format und wird gedrückt.

    • TBSTATE_ENABLED Die Schaltfläche akzeptiert Benutzereingaben. Eine Schaltfläche ohne diesen Zustand akzeptiert keine Benutzereingaben und ist abgeblendet.

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

    • TBSTATE_INDETERMINATE Die Schaltfläche ist grau.

    • TBSTATE_PRESSED Die Schaltfläche wird gedrückt.

    • TBSTATE_WRAP Eine Zeilenumbruch folgt auf die Schaltfläche . Die Schaltfläche muss auch den Status TBSTATE_ENABLED haben.

  • fsStyle

    Schaltflächenformat. Dies kann eine Kombination der unten aufgeführten Werte sein:

    • TBSTYLE_BUTTON Erstellt eine Standard-Pushschaltfläche.

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

    • TBSTYLE_CHECKGROUP Erstellt eine Kontrollkästchen-Schaltflä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 bietet. Eine Schaltfläche mit diesem Stil erhält keine Benutzereingaben.

  • dwData

    Benutzerdefinierte Daten.

  • iString

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

Das Bild und/oder die Zeichenfolge, deren Index Sie angeben, müssen zuvor mit addBitmap,AddStringund/oder AddStrings der Liste des Symbolleisten-Steuerelements hinzugefügt worden sein.

CToolBarCtrl::AddString

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

int AddString(UINT nStringID);

Parameter

nStringID
Ressourcenbezeichner der Zeichenfolgenressource, die der Zeichenfolgenliste des Symbolleisten-Steuerelements hinzugefügt werden soll.

Rückgabewert

Der nullbasierte Index der ersten neuen Zeichenfolge, die bei Erfolg hinzugefügt wurde. andernfalls -1.

CToolBarCtrl::AddStrings

Fügt der Liste der Zeichenfolgen, die für ein Symbolleisten-Steuerelement verfügbar sind, eine oder mehrere neue Zeichenfolgen hinzu.

int AddStrings(LPCTSTR lpszStrings);

Parameter

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

Rückgabewert

Der nullbasierte Index der ersten neuen Zeichenfolge, die bei Erfolg 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-Abschlusszeichen verfügt. Um eine konstante Zeichenfolge ordnungsgemäß zu formatieren, können Sie sie wie hier dargestellt schreiben:

// 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 kein CString -Objekt an diese Funktion übergeben, da es nicht möglich ist, mehr als ein NULL-Zeichen in einer zu CString enthalten.

CToolBarCtrl::AutoSize

Die Größe des gesamten Symbolleistensteuerelements wird geändert.

void AutoSize();

Hinweise

Sie sollten diese Funktion aufrufen, wenn sich die Größe des übergeordneten Fensters ändert oder wenn 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 Symbolleisten-Steuerelement.

BOOL ChangeBitmap(
    int idButton,
    int iBitmap);

Parameter

idButton
[in] Befehlsbezeichner der Schaltfläche, die eine neue Bitmap empfangen soll.

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

Rückgabewert

TRUE, wenn 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 Dateispeicher in die Bitmap für die Schaltfläche About 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 zu überprüfenden oder zu deaktivierenden Schaltfläche.

bCheck
TRUE, um die Schaltfläche zu überprüfen, FALSE, um sie zu löschen.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Wenn eine Schaltfläche aktiviert wurde, scheint sie gedrückt worden zu sein. Wenn Sie mehrere Schaltflächen ändern möchten, sollten Sie stattdessen SetState aufrufen.

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 den Stil des Symbolleistensteuerelements an. Symbolleisten müssen immer den stil WS_CHILD aufweisen. Darüber hinaus können Sie eine beliebige Kombination aus Symbolleistenstilen und Fensterstilenangeben, wie unter Hinweise beschrieben.

Rect
Gibt optional die Größe und Position des Symbolleistensteuerelements an. Dies kann entweder ein CRect-Objekt oder eine RECT-Struktur sein.

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

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 zunächst den Konstruktor auf, und rufen Sie dann Create auf, wodurch das Symbolleistensteuerelement erstellt und an das -Objekt angefügt CToolBarCtrl wird. Wenden Sie die folgenden Fensterstile auf ein Symbolleistensteuerelement an.

  • WS_CHILD Always

  • WS_VISIBLE in der Regel

  • selten WS_DISABLED

Eine Beschreibung der Fensterstile finden Sie unter CreateWindow im Windows SDK.

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

Wenden Sie eine Kombination von Symbolleistenstilen entweder auf das Steuerelement oder die Schaltflächen selbst an. Die Stile werden im Thema Symbolleistensteuerelement und Schaltflächenstile im Windows SDK beschrieben.

Um erweiterte Symbolleistenstile zu verwenden, rufen Sie SetExtendedStyle auf, nachdem Sie aufgerufen haben. Um eine Symbolleiste mit erweiterten Fensterstilen zu erstellen, rufen Sie CToolBarCtrl::CreateEx anstelle von auf.

Das Symbolleisten-Steuerelement 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 stile CCS_TOP und CCS_BOTTOM bestimmen, ob die Symbolleiste am oberen oder unteren Rand des Clientbereichs positioniert ist. Standardmäßig verfügt eine Symbolleiste über den CCS_TOP Stil.

CToolBarCtrl::CreateEx

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

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

Parameter

dwExStyle
Gibt den erweiterten Stil des steuerelements an, das erstellt wird. Eine Liste der erweiterten Windows-Stile finden Sie im dwExStyle-Parameter für CreateWindowEx im Windows SDK.

dwStyle
Gibt den Stil des Symbolleistensteuerelements an. Symbolleisten müssen immer den stil WS_CHILD aufweisen. Darüber hinaus können Sie eine beliebige Kombination aus Symbolleistenstilen und Fensterstilen angeben, wie im Abschnitt "Hinweise" von Erstellenbeschrieben.

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

pParentWnd
Ein Zeiger auf das Fenster, das das übergeordnete Element des Steuerelements ist.

nID
Die ID des untergeordneten Fensters des Steuerelements.

Rückgabewert

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

Hinweise

Verwenden Sie CreateEx anstelle von CreateEx um erweiterte Windows-Stile anzuwenden, die von der Windows erweiterten Formatvorlage WS_EX_angegeben werden. CreateExerstellt das -Steuerelement mit den erweiterten Windows Formatvorlagen, die von CreateExangegeben werden. Legen Sie mit SetExtendedStyleerweiterte Stile fest, die für ein Steuerelement spezifisch sind. Verwenden Sie beispielsweise , CreateEx um Stile wie WS_EX_CONTEXTHELP festzulegen, verwenden Sie jedoch SetExtendedStyle , um Stile wie TBSTYLE_EX_DRAWDDARROWS festzulegen. Weitere Informationen finden Sie in den Formatvorlagen, die unter Symbolleiste erweiterte Stile im Windows SDK beschrieben werden.

CToolBarCtrl::CToolBarCtrl

Erstellt ein CToolBarCtrl-Objekt.

CToolBarCtrl();

Hinweise

Sie müssen Erstellen aufrufen, damit die Symbolleiste verwendet werden kann.

CToolBarCtrl::Customize

Zeigt das Dialogfeld Symbolleiste anpassen an.

void Customize();

Hinweise

In diesem Dialogfeld kann der Benutzer die Symbolleiste anpassen, indem er Schaltflächen hinzufüge und lösche. Zur Unterstützung der Anpassung muss das übergeordnete Fenster der Symbolleiste die Anpassungsbenachrichtigungsmeldungen verarbeiten, wie unter Behandeln von Anpassungsbenachrichtigungen beschrieben. Die Symbolleiste muss auch mit dem Format CCS_ADJUSTABLE erstellt worden sein, wie in CToolBarCtrl::Create beschrieben.

CToolBarCtrl::D eleteButton

Löscht eine Schaltfläche aus dem Symbolleisten-Steuerelement.

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 Symbolleisten-Steuerelement.

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

Parameter

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

bEnable
TRUE, um die Schaltfläche zu aktivieren; FALSE, um die Schaltfläche zu deaktivieren.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Wenn eine Schaltfläche aktiviert wurde, kann sie gedrückt und aktiviert werden. Wenn Sie mehr als einen Schaltflächenzustand ändern möchten, können Sie stattdessen SetState aufrufen.

CToolBarCtrl::GetAnchorHighlight

Ruft die Einstellung für die Hervorhebung des Ankers für eine Symbolleiste ab.

BOOL GetAnchorHighlight() const;

Rückgabewert

Wenn nicht 0 (null) ist die Ankerhervorhebung aktiviert. Wenn 0 (null) ist die Hervorhebung des Ankers deaktiviert.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-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 erfolgreich, andernfalls 0 (null).

Hinweise

Implementiert die Funktionalität von TB_GETBITMAP im Windows SDK.

CToolBarCtrl::GetBitmapFlags

Ruft die Bitmapflags von der Symbolleiste ab.

UINT GetBitmapFlags() const;

Rückgabewert

Ein UINT, bei dem das TBBF_LARGE-Flag festgelegt ist, wenn die Anzeige große Symbolleistenbitmaps unterstützen kann, andernfalls löschen.

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 Sie diese verwenden möchten, rufen Sie SetBitmapSize und SetButtonSize auf, bevor Sie Ihre große Bitmap mit addBitmap hinzufügen.

CToolBarCtrl::GetButton

Ruft Informationen über die angegebene Schaltfläche in einem Symbolleisten-Steuerelement ab.

BOOL GetButton(
    int nIndex,
    LPTBBUTTON lpButton) const;

Parameter

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

lpButton
Adresse der TBBUTTON -Struktur, die eine Kopie der Schaltflächeninformationen empfangen soll. Informationen zur Struktur finden Sie unter CToolBarCtrl::AddButtons.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

CToolBarCtrl::GetButtonCount

Ruft die Anzahl der Schaltflächen ab, die sich derzeit im Symbolleisten-Steuerelement befindet.

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-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 LOWORD bzw. HIWORD enthält.

CToolBarCtrl::GetButtonText

Ruft den Anzeigetext einer angegebenen Schaltfläche auf dem aktuellen Symbolleisten-Steuerelement ab.

CString GetButtonText(int idButton) const;

Parameter

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

Rückgabewert

Eine CString-Klasse, die 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 Symbolleisten-Steuerelements ab.

BOOL GetColorScheme(COLORSCHEME* lpColorScheme) const;

Parameter

lpColorScheme
[out] Zeiger auf eine COLORSCHEME-Struktur, die die Farbschemainformationen empfängt. Wenn diese Methode zurückgegeben wird, beschreibt die -Struktur die Hervorhebungsfarbe und Schattenfarbe des Symbolleisten-Steuerelements.

Rückgabewert

TRUE, wenn 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 verwendet, um deaktivierte Schaltflächen anzuzeigen.

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 von GetDisabledImageList verwendet ein CImageList -Objekt, das die Schaltflächenbilder des Symbolleistensteuerelements enthält, anstatt ein Handle für eine Bildliste.

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 in dieser Adresse ein NULL-Zeiger 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 Stile für ein Symbolleistensteuerelement ab.

DWORD GetExtendedStyle() const;

Rückgabewert

Ein DWORD, das die erweiterten Stile darstellt, die derzeit für das Symbolleistensteuerelement verwendet werden. Eine Liste der Stile finden Sie unter Symbolleiste erweiterte Stileim 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 Symbolleisten-Steuerelement verwendet, um "heiße" Schaltflächen anzuzeigen. Eine hot-Schaltfläche 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-Schaltfläche 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 verwendet, um Schaltflächen im Standardzustand anzuzeigen.

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, die zum Zeichnen der Einfügemarke für die Symbolleiste verwendet wird.

COLORREF GetInsertMarkColor() const;

Rückgabewert

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

Hinweise

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

CToolBarCtrl::GetItemRect

Ruft das umgrenzende 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 nicht das umgrenzende Rechteck für Schaltflächen ab, deren Zustand auf TBSTATE_HIDDEN festgelegt ist.

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 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 die horizontale Auffüllung des Symbolleistensteuerelements in Pixel empfängt.

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

Rückgabewert

TRUE, wenn 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 Symbolleisten-Steuerelement verwendet, um Schaltflächen im gedrückten Zustand anzuzeigen.

CImageList* GetPressedImageList();

Rückgabewert

Zeiger auf eine CImageList, die 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 umgebundene 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 Informationen zum umgebundenen Rechteck zu empfangen.

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

Hinweise

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

CToolBarCtrl::GetRows

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

int GetRows() const;

Rückgabewert

Anzahl der Zeilen von Schaltflächen, die derzeit auf der Symbolleiste angezeigt werden.

Hinweise

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

CToolBarCtrl::GetState

Ruft Informationen zum Zustand der angegebenen Schaltfläche in einem Symbolleisten-Steuerelement 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.

Rückgabewert

Die Informationen zum Schaltflächenzustand, falls erfolgreich, oder – andernfalls 1. Die Informationen zum Schaltflächenzustand können eine Kombination der werte sein, die in CToolBarCtrl::AddButtons aufgeführt sind.

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 GetState ist jedoch die einzige Möglichkeit, den Zustand der TBSTATE_WRAP 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 Bytes.

str
Die Zeichenfolge.

Rückgabewert

Die Länge der Zeichenfolge, falls erfolgreich, -1, falls nicht.

Hinweise

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

CToolBarCtrl::GetStyle

Ruft die Stile ab, die derzeit auf ein Symbolleisten-Steuerelement angewendet werden.

DWORD GetStyle() const;

Rückgabewert

Ein DWORD, das eine Kombination aus Symbolleisten-Steuerelementstilenenthält, wie im Windows SDK beschrieben.

CToolBarCtrl::GetToolTips

Ruft das Handle des Dem Symbolleisten-Steuerelement zugeordneten Tooltipps-Steuerelements ab( sofern verfügbar).

CToolTipCtrl* GetToolTips() const;

Rückgabewert

Ein Zeiger auf das CToolTipCtrl-Objekt, das dieser Symbolleiste zugeordnet ist, oder NULL, wenn der Symbolleiste kein QuickInfo-Steuerelement zugeordnet ist.

Hinweise

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

CToolBarCtrl::HitTest

Bestimmt, wo sich ein Punkt in einem Symbolleisten-Steuerelement befindet.

int HitTest(LPPOINT ppt) const;

Parameter

Ppt
Ein Zeiger auf eine POINT-Struktur, die die x-Koordinate des Treffertests im Member und die y-Koordinate des Treffertests im Member y 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 0 (null) oder ein positiver Wert ist, ist dieser Rückgabewert der nullbasierte Index des Nichtseparatorelements, in dem sich der Punkt befindet.

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

Hinweise

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

CToolBarCtrl::HideButton

Blendet die angegebene Schaltfläche in einem Symbolleisten-Steuerelement aus oder zeigt sie an.

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

Parameter

nID
Befehlsbezeichner der Schaltfläche, die aus- oder einblendet werden soll.

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

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Wenn Sie mehr als einen Schaltflächenzustand ändern möchten, können Sie stattdessen SetState aufrufen.

CToolBarCtrl::Unbestimmt

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

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

Parameter

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

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

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Unbestimmte Schaltflächen werden grau dargestellt, z. B. wie die fett formatierte Schaltfläche auf der Symbolleiste eines Textprozessors aussehen würde, wenn der ausgewählte Text fette und reguläre Zeichen enthält. Wenn Sie mehr als einen Schaltflächenzustand ändern möchten, können Sie stattdessen SetState aufrufen.

CToolBarCtrl::InsertButton

Fügt eine Schaltfläche in ein Symbolleisten-Steuerelement 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 über die einzufügende Schaltfläche enthält. Eine Beschreibung der Struktur finden Sie unter CToolBarCtrl::AddButtons.

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 mit AddBitmap,AddStringund/oder AddStringshinzugefügt worden sein.

CToolBarCtrl::InsertMarkHitTest

Ruft die Einfügemarkierungsinformationen 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ügemarkierungsinformationen 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

Ungleich 0 (null), wenn die Schaltfläche aktiviert ist. andernfalls 0 (null).

Hinweise

Ziehen Sie den Aufruf von GetState in Betracht, wenn Sie mehrere Schaltflächenstatus 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

Ungleich 0 (null), wenn die Schaltfläche aktiviert ist. andernfalls 0 (null).

Hinweise

Ziehen Sie den Aufruf von GetState in Betracht, wenn Sie mehrere Schaltflächenstatus 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

Ungleich 0 (null), wenn die Schaltfläche ausgeblendet ist; andernfalls 0 (null).

Hinweise

Ziehen Sie den Aufruf von GetState in Betracht, wenn Sie mehrere Schaltflächenstatus abrufen möchten.

CToolBarCtrl::IsButtonHighlighted

Überprüft den Hervorhebungszustand 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, 0 (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 Fettdruck-Schaltfläche auf der Symbolleiste eines Textprozessors aussieht, wenn der ausgewählte Text sowohl fette als auch reguläre Zeichen enthält. Ziehen Sie den Aufruf von GetState in Betracht, wenn Sie mehrere Schaltflächenstatus 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

Ungleich 0 (null), wenn die Schaltfläche gedrückt wird, andernfalls 0 (null).

Hinweise

Ziehen Sie den Aufruf von GetState in Betracht, wenn Sie mehrere Schaltflächenstatus 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 und hInst auf NULL fest. Ihre Bitmapressource wird der Bildliste als einzelnes Bild hinzugefügt. Sie können systemdefinierte Standardbitmaps hinzufügen, indem Sie hinst auf HINST_COMMCTRL festlegen und diesen Parameter auf eine der folgenden IDs 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 HINST_COMMCTRL werden, um eine Standardimageliste zu laden.

Hinweise

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

CToolBarCtrl::MapAccelerator

Karten einer Symbolleistenschaltfläche ein Zugriffstastenzeichen zu.

BOOL MapAccelerator(
    TCHAR chAccel,
    UINT* pIDBtn);

Parameter

chAccel
Zuzuordnende Zugriffstastenzeichen. Dieses Zeichen ist das gleiche 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 chAccelangegebenen 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. Wenn false festgelegt ist, wird die Schaltfläche auf ihren 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::P ressButton

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

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

Parameter

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

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

Rückgabewert

TRUE, wenn die Methode erfolgreich ist; andernfalls FALSE.

Hinweise

Wenn Sie mehrere Schaltflächen ändern möchten, sollten Sie stattdessen SetState aufrufen.

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] Zeiger auf eine TBREPLACEBITMAP-Struktur, die die zu ersetzende Bitmap und die neue Bitmap beschreibt.

Rückgabewert

TRUE, wenn 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 Zustand des Symbolleistensteuerelements von dem Speicherort in der Registrierung wieder her, der durch die Parameter angegeben wird.

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

Parameter

hKeyRoot
Identifiziert einen derzeit geöffneten Schlüssel in der Registrierung oder einen der folgenden vordefinierten reservierten Handlewerte:

  • HKEY_CLASSES_ROOT

  • HKEY_CURRENT_USER

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

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

lpszValueName
Zeigt auf eine Zeichenfolge, die den Namen des abzurufenden Werts enthält. Wenn ein Wert mit diesem Namen nicht bereits 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 von den Parametern angegeben wird.

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

Parameter

hKeyRoot
Identifiziert einen derzeit geöffneten Schlüssel in der Registrierung oder einen der folgenden vordefinierten reservierten Handlewerte:

  • HKEY_CLASSES_ROOT

  • HKEY_CURRENT_USER

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

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

lpszValueName
Zeigt auf eine Zeichenfolge, die den Namen des festzulegenden Werts enthält. Wenn ein Wert mit diesem Namen nicht bereits 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 Ankerhervorhebung aktiviert oder deaktiviert ist. Wenn dieser Wert ungleich 0 (null) ist, wird die Ankerhervorhebung aktiviert. Wenn dieser Wert 0 (null) ist, wird die Ankerhervorhebung deaktiviert.

Rückgabewert

Die vorherige Ankereinstellung. Wenn die Hervorhebung aktiviert wurde, ist dieser Wert ungleich 0 (null). Wenn die Hervorhebung nicht aktiviert war, ist dieser Wert 0 (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 Pixel.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Diese Funktion muss nur aufgerufen werden, bevor der Symbolleiste Bitmaps hinzugefügt werden. Wenn die Anwendung die Bitmapgröße nicht explizit angibt, wird standardmäßig 16 x 15 Pixel verwendet.

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 Pixel.

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 der Symbolleiste Bitmaps hinzugefügt werden. Wenn die Anwendung die Schaltflächengröße nicht explizit angibt, wird standardmäßig 24 x 22 Pixel verwendet.

Beispiel

Sehen Sie sich das Beispiel für CToolBar::GetToolBarCtrlan.

CToolBarCtrl::SetButtonStructSize

Gibt die Größe der TBBUTTON -Struktur an.

void SetButtonStructSize(int nSize);

Parameter

nSize
Größe der -Struktur in TBBUTTON Bytes.

Hinweise

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

Weitere Informationen zur Struktur finden Sie unter CToolBarCtrl::AddButtons.

CToolBarCtrl::SetButtonWidth

Legt die minimale und maximale Schaltflächenbreite im Symbolleistensteuerelement fest.

BOOL SetButtonWidth(
    int cxMin,
    int cxMax);

Parameter

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

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 an das Besitzerfenster gesendet wird, wenn die angegebene Schaltfläche gedrückt 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 bei Erfolg einen Wert ungleich 0 (null) zurück. andernfalls 0 (null).

CToolBarCtrl::SetColorScheme

Legt das Farbschema des aktuellen Symbolleistensteuerelements fest.

void SetColorScheme(const COLORSCHEME* lpColorScheme);

Parameter

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

Hinweise

Diese Methode hat keine Auswirkungen, wenn ein visuelles Design Windows Vista 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 der rechte und untere Rand blau. Wenn der Benutzer die Schaltfläche drückt, werden die roten Ränder der Schaltfläche blau und die blauen Ränder 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 das Symbolleistensteuerelement verwendet, um deaktivierte Schaltflächen anzuzeigen.

CImageList* SetDisabledImageList(CImageList* pImageList);

Parameter

pImageList
Ein Zeiger auf ein CImageList -Objekt, das die Bilder enthält, die vom Symbolleistensteuerelement zum Anzeigen deaktivierter Schaltflächenbilder verwendet werden sollen.

Rückgabewert

Ein Zeiger auf ein CImageList-Objekt, das zuvor vom Symbolleistensteuerelement verwendet wurde, um deaktivierte Schaltflächenbilder anzuzeigen.

Hinweise

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

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 einem oder mehreren der in der Win32-Funktion DrawTextangegebenen DT_-Flags, die angibt, welche Bits in dwDTFlags beim Zeichnen des Texts verwendet werden.

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

Rückgabewert

Ein DWORD, das die vorherigen Textzeichnungsflags enthält.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-TB_SETDRAWTEXTFLAGS, wie im Windows SDK beschrieben. Diese Memberfunktion legt die Flags in der Win32-Funktion fest, die Text im angegebenen Rechteck zeichnet, das entsprechend der Art und Weise formatiert ist, wie DrawText die Flags festgelegt werden.

CToolBarCtrl::SetExtendedStyle

Legt die erweiterten Stile für ein Symbolleisten-Steuerelement fest.

DWORD SetExtendedStyle(DWORD dwExStyle);

Parameter

dwExStyle
Ein -Wert, der die neuen erweiterten Stile an gibt. Dieser Parameter kann eine Kombination der erweiterten Stile der Symbolleiste sein.

Rückgabewert

Ein DWORD, das die vorherigen erweiterten Stile darstellt. Eine Liste der Stile finden Sie unter Erweiterte Symbolleistenstileim Windows SDK.

Hinweise

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

CToolBarCtrl::SetHotImageList

Legt die Bildliste fest, die das Symbolleisten-Steuerelement zum Anzeigen von "heißen" Schaltflächen verwendet.

CImageList* SetHotImageList(CImageList* pImageList);

Parameter

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

Rückgabewert

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

Hinweise

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

Die MFC-Implementierung von verwendet ein -Objekt, das die Hot-Button-Bilder des Symbolleisten-Steuerelements enthält, anstatt ein Handle SetHotImageListCImageList für eine Bildliste. Eine hot-Schaltfläche wird hervorgehoben, wenn sich der Zeiger darüber befindet.

CToolBarCtrl::SetHotItem

Legt das heiße Element in einer Symbolleiste fest.

int SetHotItem(int nHot);

Parameter

nHot
Die nullbasierte Indexnummer des Elements, das als hot -Element verwendet wird. Wenn dieser Wert -1 ist, ist keines der Elemente heiß.

Rückgabewert

Der Index des vorherigen hot-Elements oder -1, wenn kein hot-Element vor lag.

Hinweise

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

CToolBarCtrl::SetImageList

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

CImageList* SetImageList(CImageList* pImageList);

Parameter

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

Rückgabewert

Ein Zeiger auf ein CImageList-Objekt, das zuvor vom Symbolleisten-Steuerelement verwendet wurde, um Schaltflächenbilder im Standardzustand anzuzeigen.

Hinweise

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

Die MFC-Implementierung von verwendet ein -Objekt, das die Schaltflächenbilder des Symbolleisten-Steuerelements enthält, anstatt ein Handle SetImageListCImageList für eine Bildliste.

CToolBarCtrl::SetIndent

Legt den Einzug für die erste Schaltfläche in einem Symbolleisten-Steuerelement fest.

BOOL SetIndent(int iIndent);

Parameter

iIndent
Der -Wert, der den Einzug in Pixel an gibt.

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 TBINSERTMARK-Struktur, die die Einfügemarke enthält.

Hinweise

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

CToolBarCtrl::SetInsertMarkColor

Legt die Farbe fest, die zum Zeichnen der Einfügemarke für die Symbolleiste verwendet wird.

COLORREF SetInsertMarkColor(COLORREF clrNew);

Parameter

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

Rückgabewert

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

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-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 -Objekts CToolBarCtrl fest.

void SetMetrics(LPTBMETRICS ptbm);

Parameter

ptbm
Ein Zeiger auf die TBMETRICS-Struktur des -Objekts.

Hinweise

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

CToolBarCtrl::SetOwner

Legt das Besitzerfenster für das Symbolleisten-Steuerelement fest.

void SetOwner(CWnd* pWnd);

Parameter

pWnd
Zeiger auf das CWnd von oder CWnd abgeleitete Objekt, das das neue Besitzerfenster für das Symbolleisten-Steuerelement sein wird.

Hinweise

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

CToolBarCtrl::SetPadding

Legt die horizontale und vertikale Auf padding des aktuellen Symbolleisten-Steuerelements fest.

DWORD SetPadding(
    int nHorzPadding,
    int nVertPadding);

Parameter

nHorzPadding
[in] Gibt die horizontale Auf padding des Symbolleisten-Steuerelements in Pixel an.

nVertPadding
[in] Gibt die vertikale Auf padding des Symbolleisten-Steuerelements in Pixel an.

Rückgabewert

Ein DWORD, dessen niedriges Wort den vorherigen horizontalen Auf padding-Wert enthält und dessen hohes Wort den vorherigen vertikalen Auf padding-Wert enthält. Die Auf padding-Werte werden in Pixeln gemessen.

Hinweise

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

Beispiel

Im folgenden Codebeispiel wird die horizontale und vertikale Auf padding des aktuellen Symbolleisten-Steuerelements 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 Symbolleisten-Steuerelement verwendet, um Schaltflächen im gedrückten Zustand anzuzeigen.

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

Parameter

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

pImageList
[in] Zeiger auf eine CImageList, die 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 Symbolleisten-Steuerelement auf, sich selbst auf 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 oder weniger Zeilen verwendet werden sollen, wenn die Größe der Symbolleiste nicht auf die angeforderte Anzahl von Zeilen geändert werden kann.

lpRect
Zeigt auf das CRect-Objekt oder die RECT-Struktur, das bzw. die das neue umgebundene Rechteck der Symbolleiste erhält.

Hinweise

Wenn sich die Größe der Symbolleiste nicht auf die angeforderte Anzahl oder die angeforderten Zeilen ändern kann, wird die Größe je nach Wert von bLargerentweder auf die nächste größere oder die nächste kleinere gültige Größe geändert. Wenn bLarger true ist, ist die neue Anzahl von Zeilen größer als die angeforderte Anzahl. Wenn bLarger FALSE ist, ist die neue Anzahl von Zeilen kleiner als die angeforderte Anzahl.

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

Wenn die Symbolleiste Trennzeichen enthält, 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 der ersten und letzten Schaltfläche in der Gruppe) nie auf mehrere 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. Mit dieser Regel soll die Trennung zwischen großen Gruppen deutlicher werden. Die resultierenden vertikalen Trennzeichen werden als Zeilen gezählt.

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

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

CToolBarCtrl::SetState

Legt den Zustand für die angegebene Schaltfläche in einem Symbolleisten-Steuerelement fest.

BOOL SetState(
    int nID,
    UINT nState);

Parameter

nID
Befehlsbezeichner der Schaltfläche.

nState
Zustandsflags. Es kann eine Kombination der Werte sein, die für Schaltflächenzustände in CToolBarCtrl::AddButtons aufgelistet sind.

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. Verwenden Sie zum Festlegen eines Zustands eine der folgenden Memberfunktionen: EnableButton,CheckButton,HideButton,Indeterminateoder PressButton.

CToolBarCtrl::SetStyle

Legt die Stile für ein Symbolleisten-Steuerelement fest.

void SetStyle(DWORD dwStyle);

Parameter

dwStyle
Ein DWORD, das eine Kombination aus Symbolleisten-Steuerelementstilenenthält, wie im Windows SDK beschrieben.

CToolBarCtrl::SetToolTips

Ordnet einem Symbolleisten-Steuerelement ein Tooltipp-Steuerelement zu.

void SetToolTips(CToolTipCtrl* pTip);

Parameter

pTip
Zeiger auf das CToolTipCtrl-Objekt.

CToolBarCtrl::SetWindowTheme

Legt den visuellen Stil des -Objekts CToolBarCtrl fest.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parameter

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

Rückgabewert

Der Rückgabewert wird nicht verwendet.

Hinweise

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

Siehe auch

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