`CMFCToolBar`-Klasse

Artikel
10/12/2023

Die CMFCToolBar Klasse ähnelt der Klasse, bietet aber zusätzliche Unterstützung für BenutzeroberflächenfeaturesCToolBar. Dazu gehören flache Symbolleisten, Symbolleisten mit hervorgehobenen Bilder, große Symbole, Pagerschaltflächen, gesperrte Symbolleisten, Grundleisten-Steuerelemente, Texte unter Bildern, Hintergrundbilder und Symbolleisten im Registerkartenformat. Die CMFCToolBar -Klasse enthält auch integrierte Unterstützung zur Anpassung folgender Elemente und Funktionen: Symbolleisten und Menüs, Drag & Drop zwischen Symbolleisten und Menüs, Schaltflächen für Kombinations- und Bearbeitungsfelder, Farbwähler und Rollup-Schaltflächen.

Weitere Details finden Sie im Quellcode in Ihrer Visual Studio-Installation, z %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc. B. .

Syntax

class CMFCToolBar : public CMFCBaseToolBar

Member

Öffentliche Konstruktoren

Name	Beschreibung
`CMFCToolBar::CMFCToolBar`	Der Standardkonstruktor.
`CMFCToolBar::~CMFCToolBar`	Destruktor.

Öffentliche Methoden

Name	Beschreibung
`CMFCToolBar::AddBasicCommand`	Fügt der Liste der Befehle, die immer angezeigt werden, wenn ein Benutzer ein Menü öffnet, einen Menübefehl hinzu.
`CMFCToolBar::AddCommandUsage`	Erhöht sich um einen der Zähler, der dem angegebenen Befehl zugeordnet ist.
`CMFCToolBar::AddToolBarForImageCollection`	Fügt der Sammlung von Bildern in der Anwendung Bilder aus den Benutzeroberflächenressourcen hinzu.
`CMFCToolBar::AdjustLayout`	Berechnet die Größe und Position einer Symbolleiste neu. (Überschreibt `CBasePane::AdjustLayout`)
`CMFCToolBar::AdjustSize`	Berechnet die Größe der Symbolleiste neu.
`CMFCToolBar::AllowChangeTextLabels`	Gibt an, ob Textbeschriftungen unter Bildern auf den Symbolleistenschaltflächen angezeigt werden können.
`CMFCToolBar::AreTextLabels`	Gibt an, ob Textbeschriftungen unter Bildern derzeit auf den Symbolleistenschaltflächen angezeigt werden.
`CMFCToolBar::AutoGrayInactiveImages`	Aktivieren oder Deaktivieren der automatischen Generierung von inaktiven Schaltflächenbildern.
`CMFCToolBar::ButtonToIndex`	Gibt den Index eines angegebenen `CMFCToolBarButton` Class - Objekts in dieser Symbolleiste zurück.
`CMFCToolBar::CalcFixedLayout`	Berechnet die horizontale Größe der Symbolleiste. (Überschreibt `CBasePane::CalcFixedLayout`.)
`CMFCToolBar::CalcSize`	Vom Framework als Teil des Layoutberechnungsprozesses aufgerufen. (Überschreibt `CPane::CalcSize`.)
`CMFCToolBar::CanHandleSiblings`	Bestimmt, ob sich die Symbolleiste und gleichgeordnete Elemente im gleichen Bereich befinden.
`CMFCToolBar::CleanUpImages`	Gibt die Systemressourcen frei, die für Symbolleistenbilder zugeordnet sind.
`CMFCToolBar::CleanUpLockedImages`	Gibt die Systemressourcen frei, die gesperrten Symbolleistenbildern zugeordnet sind.
`CMFCToolBar::CanBeClosed`	Gibt an, ob ein Benutzer die Symbolleiste schließen kann. (Überschreibt `CBasePane::CanBeClosed`.)
`CMFCToolBar::CanBeRestored`	Bestimmt, ob das System eine Symbolleiste nach der Anpassung in den ursprünglichen Zustand wiederherstellen kann.
`CMFCToolBar::CanFocus`	Gibt an, ob der Bereich den Fokus erhalten kann. (Überschreibt `CBasePane::CanFocus`.)
`CMFCToolBar::CanHandleSiblings`	Bestimmt, ob sich die Symbolleiste und gleichgeordnete Elemente im gleichen Bereich befinden.
`CMFCToolBar::CommandToIndex`	Gibt den Index der Schaltfläche in der Symbolleiste mit einer angegebenen Befehls-ID zurück.
`CMFCToolBar::Create`	Erstellt ein `CMFCToolBar`-Objekt.
`CMFCToolBar::CreateEx`	Erstellt ein `CMFCToolBar` Objekt, das zusätzliche Formatoptionen verwendet, z. B. große Symbole.
`CMFCToolBar::Deactivate`	Deaktiviert die Symbolleiste.
`CMFCToolBar::EnableCustomizeButton`	Aktiviert oder deaktiviert die Schaltfläche "Schaltflächen hinzufügen" oder "Entfernen", die am Ende der Symbolleiste angezeigt wird.
`CMFCToolBar::EnableDocking`	Aktiviert das Andocken des Bereichs an den Hauptrahmen. (Überschreibt `CBasePane::EnableDocking`.)
`CMFCToolBar::EnableLargeIcons`	Aktiviert oder deaktiviert große Symbole auf Symbolleistenschaltflächen.
`CMFCToolBar::EnableQuickCustomization`	Aktiviert oder deaktiviert die schnelle Anpassung von Symbolleisten, damit der Benutzer die ALT-TASTE drücken und eine Schaltfläche an eine neue Position ziehen kann.
`CMFCToolBar::EnableReflections`	Aktiviert oder deaktiviert die Befehlsreflexion.
`CMFCToolBar::EnableTextLabels`	Aktiviert oder deaktiviert Textbeschriftungen unter Symbolleistenschaltflächenbildern.
`CMFCToolBar::FromHandlePermanent`	Ruft einen Zeiger auf das `CMFCToolBar` Objekt ab, das das angegebene Fensterhandle enthält.
`CMFCToolBar::GetAllButtons`	Gibt eine schreibgeschützte Liste von Schaltflächen in einer Symbolleiste zurück.
`CMFCToolBar::GetAllToolbars`	Gibt eine schreibgeschützte Liste aller Symbolleisten in der Anwendung zurück.
`CMFCToolBar::GetBasicCommands`	Gibt eine schreibgeschützte Liste der grundlegenden Befehle zurück, die in der Anwendung definiert sind.
`CMFCToolBar::GetButton`	Gibt einen Zeiger auf das Objekt zurück, das `CMFCToolBarButton` einen angegebenen Index für Symbolleistenschaltflächen enthält.
`CMFCToolBar::GetButtonInfo`	Gibt die Befehls-ID, das Format und den Bildindex der Schaltfläche an einem angegebenen Index zurück.
`CMFCToolBar::GetButtonSize`	Gibt die Abmessungen der einzelnen Schaltflächen auf der Symbolleiste zurück.
`CMFCToolBar::GetButtonStyle`	Gibt die aktuelle Formatvorlage der Symbolleistenschaltfläche zurück, die sich am angegebenen Index befindet.
`CMFCToolBar::GetButtonText`	Gibt die Textbezeichnung einer Schaltfläche zurück, die einen angegebenen Index enthält.
`CMFCToolBar::GetColdImages`	Gibt einen Zeiger auf die Auflistung der Bilder der kalten Symbolleistenschaltfläche in der Anwendung zurück.
`CMFCToolBar::GetColumnWidth`	Gibt die Breite der Symbolleistenschaltflächen zurück.
`CMFCToolBar::GetCommandButtons`	Gibt eine Liste von Schaltflächen zurück, die über eine angegebene Befehls-ID aus allen Symbolleisten in der Anwendung verfügen.
`CMFCToolBar::GetCount`	Gibt die Anzahl der Schaltflächen und Trennzeichen auf der Symbolleiste zurück.
`CMFCToolBar::GetCustomizeButton`	Ruft einen Zeiger auf das `CMFCCustomizeButton` Objekt ab, das der Symbolleiste zugeordnet ist.
`CMFCToolBar::GetDefaultImage`	Gibt den Index des Standardbilds für eine Symbolleistenschaltfläche mit einer angegebenen Befehls-ID zurück.
`CMFCToolBar::GetDisabledImages`	Gibt einen Zeiger auf die Auflistung von Bildern zurück, die für deaktivierte Symbolleistenschaltflächen in der Anwendung verwendet werden.
`CMFCToolBar::GetDisabledMenuImages`	Gibt einen Zeiger auf die Auflistung von Bildern zurück, die für deaktivierte Menüschaltflächen in der Anwendung verwendet werden.
`CMFCToolBar::GetDroppedDownMenu`	Ruft einen Zeiger auf das Menüschaltflächenobjekt ab, das derzeit sein Untermenü anzeigt.
`CMFCToolBar::GetGrayDisabledButtons`	Gibt an, ob die Bilder deaktivierter Schaltflächen abgeblendete Versionen der regulären Schaltflächenbilder sind oder aus der Auflistung deaktivierter Schaltflächenbilder stammen.
`CMFCToolBar::GetHighlightedButton`	Gibt einen Zeiger auf die Symbolleistenschaltfläche zurück, die derzeit hervorgehoben ist.
`CMFCToolBar::GetHotBorder`	Bestimmt, ob die Symbolleistenschaltflächen hot-tracked sind.
`CMFCToolBar::GetHotTextColor`	Gibt die Textfarbe der hervorgehobenen Symbolleistenschaltflächen zurück.
`CMFCToolBar::GetHwndLastFocus`	Gibt ein Handle an das Fenster zurück, das den Eingabefokus direkt vor der Symbolleiste hatte.
`CMFCToolBar::GetIgnoreSetText`	Gibt an, ob Aufrufe zum Festlegen von Schaltflächenbeschriftungen ignoriert werden.
`CMFCToolBar::GetImageSize`	Gibt die aktuelle Größe der Schaltflächenbilder der Symbolleiste zurück.
`CMFCToolBar::GetImages`	Gibt einen Zeiger auf die Auflistung der Standardschaltflächenbilder in der Anwendung zurück.
`CMFCToolBar::GetImagesOffset`	Gibt den Indexoffset zurück, der verwendet wird, um die Symbolleistenschaltflächenbilder für diese Symbolleiste in der globalen Liste der Schaltflächenbilder der Symbolleiste zu finden.
`CMFCToolBar::GetInvalidateItemRect`	Ruft den Bereich des Clientbereichs ab, der für die Schaltfläche im angegebenen Index neu gezeichnet werden muss.
`CMFCToolBar::GetItemID`	Gibt die Befehls-ID der Symbolleistenschaltfläche an einem angegebenen Index zurück.
`CMFCToolBar::GetItemRect`	Gibt das umgebende Rechteck der Schaltfläche an einem angegebenen Index zurück.
`CMFCToolBar::GetLargeColdImages`	Gibt einen Zeiger auf die Auflistung großer kalter Symbolleistenschaltflächenbilder in der Anwendung zurück.
`CMFCToolBar::GetLargeDisabledImages`	Gibt einen Zeiger auf die Auflistung großer deaktivierter Schaltflächenbilder in der Anwendung zurück.
`CMFCToolBar::GetLargeImages`	Gibt einen Zeiger auf die Auflistung großer Symbolleistenschaltflächenbilder in der Anwendung zurück.
`CMFCToolBar::GetLockedColdImages`	Gibt einen Zeiger auf die Auflistung gesperrter kalter Bilder in der Symbolleiste zurück.
`CMFCToolBar::GetLockedDisabledImages`	Gibt einen Zeiger auf die Auflistung gesperrter deaktivierter Bilder in der Symbolleiste zurück.
`CMFCToolBar::GetLockedImages`	Gibt einen Zeiger auf die Auflistung gesperrter Schaltflächenbilder in der Symbolleiste zurück.
`CMFCToolBar::GetLockedImageSize`	Gibt die Standardgröße von gesperrten Symbolleistenbildern zurück.
`CMFCToolBar::GetLockedMenuImages`	Gibt einen Zeiger auf die Auflistung gesperrter Symbolleistenmenübilder in der Symbolleiste zurück.
`CMFCToolBar::GetMenuButtonSize`	Gibt die Größe von Menüschaltflächen in der Anwendung zurück.
`CMFCToolBar::GetMenuImageSize`	Gibt die Größe von Menüschaltflächenbildern in der Anwendung zurück.
`CMFCToolBar::GetMenuImages`	Gibt einen Zeiger auf die Auflistung von Menüschaltflächenbildern in der Anwendung zurück.
`CMFCToolBar::GetOrigButtons`	Ruft die Auflistung nicht angepasster Schaltflächen der Symbolleiste ab.
`CMFCToolBar::GetOrigResetButtons`	Ruft die Auflistung nicht angepasster Zurücksetzungsschaltflächen der Symbolleiste ab.
`CMFCToolBar::GetResourceID`	Ruft die Ressourcen-ID der Symbolleiste ab.
`CMFCToolBar::GetRouteCommandsViaFrame`	Bestimmt, welches Objekt, der übergeordnete Frame oder der Besitzer, Befehle an die Symbolleiste sendet.
`CMFCToolBar::GetRowHeight`	Gibt die Höhe der Symbolleistenschaltflächen zurück.
`CMFCToolBar::GetShowTooltips`	Gibt an, ob QuickInfos für Symbolleistenschaltflächen angezeigt werden.
`CMFCToolBar::GetSiblingToolBar`	Ruft das gleichgeordnete Element der Symbolleiste ab.
`CMFCToolBar::GetUserImages`	Gibt einen Zeiger auf die Auflistung benutzerdefinierter Symbolleistenschaltflächenbilder in der Anwendung zurück.
`CMFCToolBar::HitTest`	Gibt den Index der Symbolleistenschaltfläche zurück, die sich an der angegebenen Position befindet.
`CMFCToolBar::InsertButton`	Fügt eine Schaltfläche in die Symbolleiste ein.
`CMFCToolBar::InsertSeparator`	Fügt ein Trennzeichen in die Symbolleiste ein.
`CMFCToolBar::InvalidateButton`	Ungültig wird der Clientbereich der Symbolleistenschaltfläche, die im angegebenen Index vorhanden ist.
`CMFCToolBar::IsAddRemoveQuickCustomize`	Bestimmt, ob ein Benutzer Mithilfe der Menüoption "Anpassen " Symbolleistenschaltflächen hinzufügen oder entfernen kann.
`CMFCToolBar::IsAltCustomizeMode`	Gibt an, ob schnelle Anpassungen zum Ziehen einer Schaltfläche verwendet werden.
`CMFCToolBar::IsAutoGrayInactiveImages`	Gibt an, ob die automatische Generierung von inaktiven (nicht hervorgehobenen) Schaltflächenbildern aktiviert ist.
`CMFCToolBar::IsBasicCommand`	Bestimmt, ob sich ein Befehl in der Liste der grundlegenden Befehle befindet.
`CMFCToolBar::IsButtonExtraSizeAvailable`	Bestimmt, ob die Symbolleiste Schaltflächen mit erweiterten Rahmen anzeigen kann.
`CMFCToolBar::IsButtonHighlighted`	Bestimmt, ob eine Schaltfläche auf der Symbolleiste hervorgehoben ist.
`CMFCToolBar::IsCommandPermitted`	Bestimmt, ob ein Befehl zulässig ist.
`CMFCToolBar::IsCommandRarelyUsed`	Bestimmt, ob ein Befehl selten verwendet wird (siehe `CMFCToolBar::SetCommandUsageOptions`).
`CMFCToolBar::IsCustomizeMode`	Gibt an, ob sich das Symbolleistenframework im Anpassungsmodus befindet.
`CMFCToolBar::IsDragButton`	Bestimmt, ob eine Symbolleistenschaltfläche gezogen wird.
`CMFCToolBar::IsExistCustomizeButton`	Bestimmt, ob die Symbolleiste die Schaltfläche "Anpassen " enthält.
`CMFCToolBar::IsFloating`	Bestimmt, ob die Symbolleiste unverankert ist.
`CMFCToolBar::IsLargeIcons`	Gibt an, ob Symbolleisten in der Anwendung derzeit große Symbole anzeigen.
`CMFCToolBar::IsLastCommandFromButton`	Bestimmt, ob der zuletzt ausgeführte Befehl von der angegebenen Symbolleistenschaltfläche gesendet wurde.
`CMFCToolBar::IsLocked`	Bestimmt, ob die Symbolleiste gesperrt ist.
`CMFCToolBar::IsOneRowWithSibling`	Bestimmt, ob die Symbolleiste und die zugehörige gleichgeordnete Symbolleiste in derselben Zeile positioniert sind.
`CMFCToolBar::IsUserDefined`	Gibt an, ob die Symbolleiste benutzerdefiniert ist.
`CMFCToolBar::LoadBitmap`	Lädt Symbolleistenbilder aus Anwendungsressourcen.
`CMFCToolBar::LoadBitmapEx`	Lädt Symbolleistenbilder aus Anwendungsressourcen. Enthält große Bilder.
`CMFCToolBar::LoadParameters`	Lädt globale Symbolleistenoptionen aus der Windows-Registrierung.
`CMFCToolBar::LoadState`	Lädt die Statusinformationen der Symbolleiste aus der Windows-Registrierung. (Überschreibt `CPane::LoadState`.)
`CMFCToolBar::LoadToolBar`	Lädt die Symbolleiste aus Anwendungsressourcen.
`CMFCToolBar::LoadToolBarEx`	Lädt die Symbolleiste aus Anwendungsressourcen mithilfe der `CMFCToolBarInfo` Hilfsklasse, damit die Anwendung große Bilder verwenden kann.
`CMFCToolBar::OnChangeHot`	Wird vom Framework aufgerufen, wenn ein Benutzer eine Schaltfläche auf der Symbolleiste auswählt.
`CMFCToolBar::OnFillBackground`	Vom Framework aufgerufen, um `CBasePane::DoPaint` den Symbolleistenhintergrund auszufüllen.
`CMFCToolBar::OnReset`	Stellt die Symbolleiste im ursprünglichen Zustand wieder her.
`CMFCToolBar::OnSetAccData`	(Überschreibt `CBasePane::OnSetAccData`.)
`CMFCToolBar::OnSetDefaultButtonText`	Stellt den Text einer Symbolleistenschaltfläche im Standardzustand wieder her.
`CMFCToolBar::OnUpdateCmdUI`	Wird intern verwendet.
`CMFCToolBar::RemoveAllButtons`	Entfernt alle Schaltflächen aus der Symbolleiste.
`CMFCToolBar::RemoveButton`	Entfernt die Schaltfläche mit dem angegebenen Index aus der Symbolleiste.
`CMFCToolBar::RemoveStateFromRegistry`	Löscht die Statusinformationen für die Symbolleiste aus der Windows-Registrierung.
`CMFCToolBar::ReplaceButton`	Ersetzt eine Symbolleistenschaltfläche durch eine andere Symbolleistenschaltfläche.
`CMFCToolBar::ResetAll`	Stellt alle Symbolleisten in ihren ursprünglichen Zuständen wieder her.
`CMFCToolBar::ResetAllImages`	Löscht alle Symbolleistenbildsammlungen in der Anwendung.
`CMFCToolBar::RestoreOriginalState`	Stellt den originalen Zustand einer Symbolleiste wieder her.
`CMFCToolBar::SaveState`	Speichert die Statusinformationen für die Symbolleiste in der Windows-Registrierung. (Überschreibt `CPane::SaveState`.)
`CMFCToolBar::Serialize`	(Überschreibt `CBasePane::Serialize`.)
`CMFCToolBar::SetBasicCommands`	Legt die Liste der Befehle fest, die immer angezeigt werden, wenn ein Benutzer ein Menü öffnet.
`CMFCToolBar::SetButtonInfo`	Legt die Befehls-ID, den Stil und die Bild-ID einer Symbolleistenschaltfläche fest.
`CMFCToolBar::SetButtonStyle`	Legt die Formatvorlage der Symbolleistenschaltfläche am angegebenen Index fest.
`CMFCToolBar::SetButtonText`	Legt die Textbezeichnung einer Symbolleistenschaltfläche fest.
`CMFCToolBar::SetButtons`	Legt die Schaltflächen für die Symbolleiste fest.
`CMFCToolBar::SetCommandUsageOptions`	Gibt an, wann selten verwendete Befehle nicht im Menü der Anwendung angezeigt werden.
`CMFCToolBar::SetCustomizeMode`	Aktiviert oder deaktiviert den Anpassungsmodus für alle Symbolleisten in der Anwendung.
`CMFCToolBar::SetGrayDisabledButtons`	Gibt an, ob die deaktivierten Schaltflächen auf der Symbolleiste abgeblendet sind oder ob deaktivierte Bilder für die deaktivierten Schaltflächen verwendet werden.
`CMFCToolBar::SetHeight`	Legt die Höhe der Symbolleiste fest.
`CMFCToolBar::SetHotBorder`	Gibt an, ob Symbolleistenschaltflächen heiß nachverfolgt werden.
`CMFCToolBar::SetHotTextColor`	Legt die Textfarbe für Hot Toolbar-Schaltflächen fest.
`CMFCToolBar::SetLargeIcons`	Gibt an, ob Symbolleistenschaltflächen große Symbole anzeigen.
`CMFCToolBar::SetLockedSizes`	Legt die Größe von gesperrten Schaltflächen und gesperrten Bildern auf der Symbolleiste fest.
`CMFCToolBar::SetMenuSizes`	Legt die Größe der Symbolleistenmenüschaltflächen und deren Bilder fest.
`CMFCToolBar::SetNonPermittedCommands`	Legt die Liste der Befehle fest, die vom Benutzer nicht ausgeführt werden können.
`CMFCToolBar::SetOneRowWithSibling`	Positioniert die Symbolleiste und das gleichgeordnete Element in derselben Zeile.
`CMFCToolBar::SetPermament`	Gibt an, ob ein Benutzer die Symbolleiste schließen kann.
`CMFCToolBar::SetRouteCommandsViaFrame`	Gibt an, ob der übergeordnete Frame oder der Besitzer Befehle an die Symbolleiste sendet.
`CMFCToolBar::SetShowTooltips`	Gibt an, ob das Framework QuickInfos anzeigt.
`CMFCToolBar::SetSiblingToolBar`	Gibt das gleichgeordnete Element der Symbolleiste an.
`CMFCToolBar::SetSizes`	Gibt die Größe von Schaltflächen und Bildern auf allen Symbolleisten an.
`CMFCToolBar::SetToolBarBtnText`	Gibt die Eigenschaften einer Schaltfläche auf der Symbolleiste an.
`CMFCToolBar::SetTwoRowsWithSibling`	Positioniert die Symbolleiste und das gleichgeordnete Element in separaten Zeilen.
`CMFCToolBar::SetUserImages`	Legt die Auflistung benutzerdefinierter Bilder in der Anwendung fest.
`CMFCToolBar::StretchPane`	Gestreckt die Symbolleiste vertikal oder horizontal. (Überschreibt `CBasePane::StretchPane`.)
`CMFCToolBar::TranslateChar`	Führt einen Schaltflächenbefehl aus, wenn der angegebene Tastencode einer gültigen Tastenkombination entspricht.
`CMFCToolBar::UpdateButton`	Aktualisiert den Status der angegebenen Schaltfläche.
`CMFCToolBar::WrapToolBar`	Positioniert Symbolleistenschaltflächen innerhalb der angegebenen Dimensionen neu.

Geschützte Methoden

Name	Beschreibung
`CMFCToolBar::AllowShowOnList`	Bestimmt, ob die Symbolleiste in der Liste im Symbolleistenbereich des Dialogfelds Anpassen angezeigt wird.
`CMFCToolBar::CalcMaxButtonHeight`	Berechnet die maximale Höhe einer Schaltfläche in der Symbolleiste.
`CMFCToolBar::DoPaint`	Stellt eine Symbolleiste neu dar.
`CMFCToolBar::DrawButton`	Überschreibt eine Symbolleistenschaltfläche.
`CMFCToolBar::DrawSeparator`	Blättern Sie ein Trennzeichen auf einer Symbolleiste neu.
`CMFCToolBar::OnUserToolTip`	Wird vom Framework aufgerufen, wenn die QuickInfo für eine Schaltfläche angezeigt werden soll.

Datenelemente

Name	Beschreibung
`CMFCToolBar::m_bDontScaleImages`	Gibt an, ob Symbolleistenbilder im Modus mit hohem DPI-Wert skaliert werden sollen.
`CMFCToolBar::m_dblLargeImageRatio`	Gibt das Verhältnis zwischen der Dimension (Höhe oder Breite) großer Bilder und der Dimension normaler Bilder an.

Hinweise

Führen Sie die folgenden Schritte aus, um ein CMFCToolBar Objekt in Ihre Anwendung zu integrieren:

Fügen Sie dem Hauptrahmenfenster ein CMFCToolBar Objekt hinzu.
Wenn Sie die WM_CREATE Nachricht für das Hauptrahmenfenster verarbeiten, rufen Sie entweder CMFCToolBar::Create die Symbolleiste auf, oder CMFCToolBar::CreateEx erstellen Sie die Symbolleiste, und geben Sie dessen Format an.
Rufen Sie auf CBasePane::EnableDocking , um den Andockstil anzugeben.

Zum Einfügen einer speziellen Schaltfläche, z. B. eines Kombinationsfelds oder einer Dropdownsymbolleiste, reservieren Sie eine Dummy-Schaltfläche in der übergeordneten Ressource, und ersetzen Sie die Dummy-Schaltfläche zur Laufzeit mithilfe von CMFCToolBar::ReplaceButton. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Einfügen von Steuerelementen auf Symbolleisten.

CMFCToolBarist die Basisklasse für die MFC-Bibliotheksklassen "CMFCMenuBarKlasse",CMFCPopupMenuBar "Klasse" und CMFCDropDownToolBar "Klasse".

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung verschiedener Methoden in der CMFCToolBar -Klasse. Das Beispiel zeigt, wie sie den Text der Fensterbezeichnung der Symbolleiste festlegen, die Rahmen festlegen, die Formatvorlage des Bereichs festlegen und die Schaltfläche "Schaltflächen hinzufügen" oder "Schaltflächen entfernen" aktivieren, die am Ende der Symbolleiste angezeigt wird. Dieser Codeausschnitt ist Teil des IE-Demobeispiels.

CMFCToolBar m_wndToolBar;

m_wndToolBar.SetWindowText(_T("Standard"));
m_wndToolBar.SetBorders();

//------------------------------------
// Remove toolbar gripper and borders:
//------------------------------------
m_wndToolBar.SetPaneStyle(m_wndToolBar.GetPaneStyle() &
                          ~(CBRS_GRIPPER | CBRS_BORDER_TOP | CBRS_BORDER_BOTTOM | CBRS_BORDER_LEFT | CBRS_BORDER_RIGHT));

m_wndToolBar.EnableCustomizeButton(TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."));

Anforderungen

Header: afxtoolbar.h

Vererbungshierarchie

CMFCToolBar

`CMFCToolBar::AddBasicCommand`

Fügt der Liste der Befehle, die immer angezeigt werden, wenn ein Benutzer ein Menü öffnet, einen Menübefehl hinzu.

static void __stdcall AddBasicCommand(UINT uiCmd);

Parameter

uiCmd
[in] Gibt den hinzuzufügenden Befehl an.

Hinweise

Beim Öffnen des Menüs wird immer ein einfacher Befehl angezeigt. Diese Methode ist aussagekräftig, wenn der Benutzer die zuletzt verwendeten Befehle anzeigen möchte.

Verwenden Sie die CMFCToolBar::SetBasicCommands Methode, um die Liste der Befehle festzulegen, die immer angezeigt werden, wenn ein Benutzer ein Menü öffnet. Verwenden Sie die CMFCToolBar::GetBasicCommands Methode, um die Liste der grundlegenden Befehle abzurufen, die von Ihrer Anwendung verwendet werden.

`CMFCToolBar::AddCommandUsage`

Erhöht sich um einen der Zähler, der dem angegebenen Befehl zugeordnet ist.

static void __stdcall AddCommandUsage(UINT uiCommand);

Parameter

uiCommand
[in] Gibt den Befehlszähler an, der erhöht werden soll.

Hinweise

Das Framework ruft diese Methode auf, wenn der Benutzer ein Menüelement auswählt.

Das Framework verwendet Befehlszähler, um zuletzt verwendete Menüelemente anzuzeigen.

Diese Methode erhöht den Befehlszähler mithilfe der CMFCCmdUsageCount::AddCmd Methode.

`CMFCToolBar::AddToolBarForImageCollection`

Fügt der Sammlung von Bildern in der Anwendung Bilder aus den Benutzeroberflächenressourcen hinzu.

static BOOL __stdcall AddToolBarForImageCollection(
    UINT uiResID,
    UINT uiBmpResID=0,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

Parameter

uiResID
[in] Ressourcen-ID einer Symbolleiste mit zu ladenden Bildern.

uiBmpResID
[in] Ressourcen-ID einer Bitmap mit Symbolleistenbildern.

uiColdResID
[in] Ressourcen-ID einer Bitmap mit "kalten" Symbolleistenbildern.

uiMenuResID
[in] Ressourcen-ID einer Bitmap mit Menübildern.

uiDisabledResID
[in] Ressourcen-ID einer Bitmap mit deaktivierten Symbolleistenbildern.

uiMenuDisabledResID
[in] Ressourcen-ID einer Bitmap mit deaktivierten Menübildern.

Rückgabewert

TRUE wenn die Methode erfolgreich ist; FALSE wenn uiResID gültige Ressourcen nicht angegeben werden oder uiBmpResID ein anderer Fehler auftritt.

Hinweise

Rufen Sie diese Methode auf, um eine Bitmap mit Symbolleistenbildern zu laden und sie der Sammlung von Symbolleistenbildern hinzuzufügen. Diese Methode erstellt ein temporäres Symbolleistenobjekt und ruft auf CMFCToolBar::LoadToolBar.

`CMFCToolBar::AdjustLayout`

Berechnet die Größe und Position einer Symbolleiste neu.

virtual void AdjustLayout();

Hinweise

Rufen Sie diese Methode auf, wenn die Symbolleiste erstellt wurde, um die Größe und Position neu zu berechnen.

Das Framework ruft diese Methode jedes Mal auf, wenn das Layout der Symbolleiste geändert werden muss. Beispielsweise muss sich das Layout ändern, wenn der Benutzer eine andere Steuerelementleiste verschiebt, die Größe eines Anwendungsfensters ändert oder die Symbolleiste angepasst.

Überschreiben Sie diese Methode, um Ihr eigenes dynamisches Layout in Klassen bereitzustellen, von CMFCToolbardenen Sie abgeleitet sind.

`CMFCToolBar::AdjustSize`

Berechnet die Größe der Symbolleiste neu.

void AdjustSize();

Hinweise

Diese Methode stellt sicher, dass die Symbolleiste in die Grenzen des übergeordneten Frames passt. Diese Methode führt nichts aus, wenn die Symbolleiste keinen übergeordneten Frame aufweist.

Die CMFCToolBar::AdjustLayout Methode ruft diese Methode auf, um die Größe neu zu berechnen, wenn das übergeordnete Element der Symbolleiste kein CMFCReBar Objekt ist.

`CMFCToolBar::AllowChangeTextLabels`

Gibt an, ob Textbeschriftungen unter Bildern auf den Symbolleistenschaltflächen angezeigt werden können.

virtual BOOL AllowChangeTextLabels() const;

Rückgabewert

TRUE wenn textbeschriftungen unterhalb von Bildern angezeigt werden dürfen; andernfalls FALSE.

Hinweise

Diese Methode wird vom Dialogfeld "Anpassung" aufgerufen, um zu bestimmen, ob auf der Symbolleistenseite für die ausgewählte Symbolleiste ein Kontrollkästchen "Beschriftungen anzeigen" aktiviert werden soll.

Die Standardimplementierung gibt TRUE zurück.

Überschreiben Sie diese Methode in einem objekt, das von CMFCToolBar einem objekt abgeleitet wurde, und geben Sie zurück FALSE , wenn Sie nicht möchten, dass der Benutzer entscheiden soll, ob Textbeschriftungen auf Symbolleistenschaltflächen unter den Bildern angezeigt werden.

`CMFCToolBar::AllowShowOnList`

Bestimmt, ob die Symbolleiste in der Liste der Symbolleisten im Bereich "Symbolleisten" des Dialogfelds "Anpassen" angezeigt wird.

virtual BOOL AllowShowOnList() const;

Rückgabewert

TRUE wenn das Symbolleistenobjekt im Listenfeld auf der Symbolleistenanpassungsseite angezeigt werden kann; andernfalls FALSE.

Hinweise

Diese Methode wird vom Framework aufgerufen, um zu bestimmen, ob die Liste auf der Symbolleistenanpassungsseite ein bestimmtes Objekt enthalten soll, das von CMFCToolBar.

Die Standardimplementierung gibt immer zurück TRUE. Überschreiben Sie diese Methode, wenn keine Symbolleiste in der Symbolleistenliste im Anpassungsdialogfeld angezeigt werden soll.

`CMFCToolBar::AreTextLabels`

Gibt an, ob Textbeschriftungen unter Bildern derzeit auf den Symbolleistenschaltflächen angezeigt werden.

BOOL AreTextLabels() const;

Rückgabewert

TRUE wenn auf den Symbolleistenschaltflächen Textbeschriftungen unterhalb der Bilder angezeigt werden; andernfalls FALSE.

Hinweise

Hier können Sie CMFCToolBar::EnableTextLabels angeben, ob der Text angezeigt wird. Der Standardwert ist FALSE. Rufen Sie CMFCToolBar::AllowChangeTextLabels auf, um anzugeben, ob der Benutzer diese Einstellung im Anpassungsdialogfeld ändern kann.

`CMFCToolBar::AutoGrayInactiveImages`

Aktivieren oder Deaktivieren der automatischen Generierung von inaktiven Schaltflächenbildern.

static void AutoGrayInactiveImages(
    BOOL bEnable=TRUE,
    int nGrayImagePercentage=0,
    BOOL bRedrawAllToolbars=TRUE);

Parameter

bEnable
[in] Ein boolescher Wert, der angibt, ob inaktive Bilder abgeblendet werden sollen. Wenn dieser Parameter lautet TRUE, werden inaktive Bilder abgeblendet. Andernfalls werden inaktive Bilder nicht abgeblendet.

nGrayImagePercentage
[in] Gibt den Leuchtdichteprozentsatz für inaktive Bilder an. Ist bEnable dies FALSEder Fall, wird dieser Wert ignoriert.

bRedrawAllToolbars
[in] Ein boolescher Wert, der angibt, ob alle Symbolleisten in der Anwendung neu gezeichnet werden sollen. Wenn dieser Parameter lautet TRUE, werden mit dieser Methode alle Symbolleisten neu gezeichnet.

Hinweise

Wenn bEnable ja TRUE, verwendet nGrayImagePercentage das Framework, um inaktive Bilder aus den regulären Bildern zu generieren. Andernfalls müssen Sie den Satz von inaktiven Bildern mithilfe der CMFCToolBar::GetColdImages Methode bereitstellen. Diese Option ist standardmäßig deaktiviert.

Weitere Informationen zum nGrayImagePercentage-Parameter finden Sie unter CMFCToolBarImages::GrayImages.

`CMFCToolBar::ButtonToIndex`

Gibt den Index eines angegebenen CMFCToolBarButton Class - Objekts in dieser Symbolleiste zurück.

int ButtonToIndex(const CMFCToolBarButton* pButton) const;

Parameter

pButton
[in] Ein Zeiger auf das Symbolleistenschaltflächenobjekt.

Rückgabewert

Index der pButton internen Liste der Symbolleistenschaltflächen oder -1, wenn sich die angegebene Schaltfläche nicht auf dieser Symbolleiste befindet.

`CMFCToolBar::CalcFixedLayout`

Berechnet die horizontale Größe der Symbolleiste.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parameter

bStretch
[in] TRUE um die Symbolleiste auf die Größe des übergeordneten Frames zu strecken.

bHorz
[in] TRUE horizontale Ausrichtung der Symbolleiste; FALSE um die Symbolleiste vertikal auszurichten.

Rückgabewert

Ein CSize Objekt, das die Größe der Symbolleiste angibt.

Hinweise

Diese Methode berechnet die Größe der Symbolleiste mithilfe der CMFCToolBar::CalcLayout Methode. Es übergibt das LM_STRETCH Flag für den dwMode Parameter, falls bStretch vorhanden.TRUE Es übergibt die LM_HORZ Kennzeichnung, falls bHorz vorhanden.TRUE

Ein Beispiel, das diese Methode verwendet, finden Sie im VisualStudioDemo-Beispiel.

`CMFCToolBar::CalcMaxButtonHeight`

Berechnet die maximale Höhe von Schaltflächen in der Symbolleiste.

virtual int CalcMaxButtonHeight();

Rückgabewert

Die maximale Höhe von Schaltflächen.

Hinweise

Diese Methode berechnet die maximale Höhe zwischen allen Symbolleistenschaltflächen auf der Symbolleiste. Die Höhe kann je nach Faktoren wie dem aktuellen Andockzustand der Symbolleiste variieren.

Überschreiben Sie diese Methode in einer Von einer Klasse abgeleiteten CMFCToolBar Klasse, um eine eigene Höhenberechnung bereitzustellen.

`CMFCToolBar::CalcSize`

Vom Framework als Teil des Layoutberechnungsprozesses aufgerufen.

virtual CSize CalcSize(BOOL bVertDock);

Parameter

bVertDock
[in] TRUE um anzugeben, dass die Symbolleiste vertikal verankert ist; FALSE um anzugeben, dass die Symbolleiste horizontal angedockt wird.

Rückgabewert

Ein CSize Objekt, das die Gesamtgröße der Schaltflächen auf der Symbolleiste angibt.

Hinweise

Diese Methode berücksichtigt die Attribute, die sich auf die Größe der einzelnen Schaltflächen auswirken, z. B. den Bereich der Textbezeichnung und die Rahmengröße.

Wenn die Symbolleiste keine Schaltflächen enthält, gibt diese Methode die reservierte Größe einer einzelnen Schaltfläche mithilfe der CMFCToolBar::GetButtonSize Methode zurück.

`CMFCToolBar::CanBeClosed`

Gibt an, ob ein Benutzer die Symbolleiste schließen kann.

virtual BOOL CanBeClosed() const;

Rückgabewert

TRUE wenn die Symbolleiste vom Benutzer geschlossen werden kann; andernfalls FALSE.

Hinweise

Das Framework ruft diese Methode auf, um zu bestimmen, ob der Benutzer eine Symbolleiste schließen kann. Wenn die Methode zurückgegeben wird TRUE, aktiviert das Framework den SC_CLOSE Befehl im Systemmenü der Symbolleiste, und der Benutzer kann die Symbolleiste mithilfe eines Kontrollkästchens in der Liste der Symbolleisten im Anpassungsdialogfeld schließen.

Die Standardimplementierung gibt TRUE zurück. Überschreiben Sie diese Methode in einer Von einer Klasse abgeleiteten CMFCToolBar Klasse, um Symbolleistenobjekte zu erstellen, die vom Benutzer nicht geschlossen werden können.

`CMFCToolBar::CanBeRestored`

Bestimmt, ob das System eine Symbolleiste nach der Anpassung in den ursprünglichen Zustand wiederherstellen kann.

virtual BOOL CanBeRestored() const;

Rückgabewert

TRUE wenn die Symbolleiste aus den Anwendungsressourcen wiederhergestellt werden kann; andernfalls FALSE.

Hinweise

Das Framework ruft diese Methode auf, um zu bestimmen, ob eine Symbolleiste nach der Anpassung an den ursprünglichen Zustand zurückgegeben werden kann. Der ursprüngliche Zustand wird aus den Anwendungsressourcen geladen.

Wenn CanBeRestored diese Option zurückgegeben TRUEwird, aktiviert die Seite "Symbolleisten" des Dialogfelds "Anpassung" die Schaltfläche "Zurücksetzen " für die ausgewählte Symbolleiste.

Die Standardimplementierung gibt zurück TRUE , wenn die ursprüngliche Ressourcen-ID der Symbolleiste, wenn sie geladen wurde, ungleich Null ist. In der Regel können nur benutzerdefinierte Symbolleisten wiederhergestellt werden.

Sie können die CanBeRestored Methode überschreiben, um dieses Verhalten in abgeleiteten Klassen anzupassen.

`CMFCToolBar::CanFocus`

Gibt an, ob der Bereich den Fokus erhalten kann.

virtual BOOL CanFocus() const;

Rückgabewert

Diese Methode gibt FALSEzurück.

Hinweise

Diese Methode setzt die Implementierung der Basisklasse außer Kraft, CBasePane::CanFocusda Symbolleistenobjekte den Fokus nicht erhalten können.

`CMFCToolBar::CanHandleSiblings`

Bestimmt, ob sich die Symbolleiste und gleichgeordnete Elemente im gleichen Bereich befinden.

BOOL CanHandleSiblings();

Rückgabewert

TRUE wenn die Symbolleiste über ein gleichgeordnetes Element verfügt und die Symbolleiste und die gleichgeordnete Symbolleiste im selben Bereich positioniert sind; andernfalls FALSE.

Hinweise

Die interne CMFCCustomizeButton::CreatePopupMenu Methode ruft diese Methode auf, um zu bestimmen, wie das Popupmenü "Anpassen" angezeigt wird. Wenn diese Methode zurückgegeben wird TRUE, zeigt das Framework die Schaltflächen in einer Zeile anzeigen oder Schaltflächen auf zwei Zeilenschaltflächen anzeigen an.

Sie müssen dieser Methode normalerweise nicht verwenden. Rufen Sie die Methode aufCMFCToolBar::EnableCustomizeButton, um die Schaltfläche "Anpassen" zu aktivieren, die auf der Symbolleiste angezeigt wird. Zum Aktivieren der Schaltflächen "Schaltflächen anzeigen" in einer Zeile oder "Schaltflächen anzeigen" auf zwei Zeilenschaltflächen rufen Sie CMFCToolBar::SetSiblingToolBarauf.

`CMFCToolBar::CleanUpImages`

Gibt die Systemressourcen frei, die für Symbolleistenbilder zugeordnet sind.

static void CMFCToolBar::CleanUpImages();

Hinweise

Das Framework ruft diese Methode auf, wenn eine Anwendung heruntergefahren wird.

`CMFCToolBar::CleanUpLockedImages`

Gibt die Systemressourcen frei, die gesperrten Symbolleistenbildern zugeordnet sind.

void CleanUpLockedImages();

Hinweise

Rufen Sie diese Methode auf, wenn sich der visuelle Stil Ihrer Anwendung ändert. Ein Beispiel, das diese Methode verwendet, finden Sie im VisualStudioDemo-Beispiel.

`CMFCToolBar::CommandToIndex`

Gibt den Index der Schaltfläche in der Symbolleiste mit einer angegebenen Befehls-ID zurück.

int CommandToIndex(
    UINT nIDFind,
    int iIndexFirst=0) const;

Parameter

nIDFind
[in] Gibt die Befehls-ID an.

iIndexFirst
[in] Gibt den anfangs zu startenden Index an.

Rückgabewert

Nullbasierter Index der Symbolleistenschaltfläche, wenn die Methode erfolgreich war; -1, wenn keine Schaltfläche mit der angegebenen ID vorhanden ist.

Hinweise

Ein CMFCToolBar Objekt verwaltet eine interne Liste der Schaltflächen auf der Symbolleiste. Rufen Sie diese Funktion auf, um den Index einer Schaltfläche in der Liste abzurufen, die die Befehls-ID der Schaltfläche enthält.

Wenn iIndex größer als 0 ist, ignoriert diese Methode jede Schaltfläche auf der Symbolleiste, die einen Index kleiner als hat iIndex.

`CMFCToolBar::Create`

Erstellt ein CMFCToolBar-Objekt.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT nID=AFX_IDW_TOOLBAR);

Parameter

pParentWnd
[in] Ein Zeiger auf das übergeordnete Fenster der Symbolleiste.

dwStyle
[in] Die Symbolleistenformatvorlage. Eine Liste der Formatvorlagen finden Sie unter Symbolleisten-Steuerelement- und Schaltflächenformatvorlagen im Windows SDK.

nID
[in] Die ID des untergeordneten Fensters der Symbolleiste.

Rückgabewert

TRUE wenn diese Methode erfolgreich ist; andernfalls FALSE.

Hinweise

Diese Methode erstellt eine Steuerelementleiste und fügt sie an die Symbolleiste an. Sie erstellt die Steuerelementleiste mit der TBSTYLE_FLAT Formatvorlage. Rufen Sie auf CMFCToolBar::CreateEx , wenn Sie eine andere Steuerelementleistenart verwenden möchten.

`CMFCToolBar::CreateEx`

Erstellt ein CMFCToolBar Objekt, das zusätzliche Formatoptionen verwendet, z. B. große Symbole.

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle=TBSTYLE_FLAT,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    CRect rcBorders=CRect(1,
    1,
    1,
    1),
    UINT nID=AFX_IDW_TOOLBAR);

Parameter

pParentWnd
[in] Ein Zeiger auf das übergeordnete Fenster der Symbolleiste.

dwCtrlStyle
[in] Zusätzliche Formatvorlagen zum Erstellen des eingebetteten Steuerelementleistenobjekts.

dwStyle
[in] Die Symbolleistenformatvorlage. Eine Liste der geeigneten Formatvorlagen finden Sie unter Symbolleisten-Steuerelement- und Schaltflächenformatvorlagen .

rcBorders
[in] Ein CRect Objekt, das die Breite der Symbolleistenfensterrahmen angibt.

nID
[in] Die ID des untergeordneten Fensters der Symbolleiste.

Rückgabewert

Nonzero, wenn diese Methode erfolgreich ist; andernfalls 0.

Hinweise

Diese Methode erstellt eine Steuerelementleiste und fügt sie an die Symbolleiste an.

Rufen Sie diese Methode auf, anstatt CMFCToolBar::Create bestimmte Formatvorlagen bereitzustellen. Legen Sie dwCtrlStyle beispielsweise fest, dass TBSTYLE_FLAT | TBSTYLE_TRANSPARENT eine Symbolleiste erstellt wird, die den von Internet Explorer 4 verwendeten Symbolleisten ähnelt.

Beispiel

Im folgenden Beispiel wird die Verwendung der CreateEx Methode der CMFCToolBar Klasse veranschaulicht. Dieser Codeausschnitt ist Teil des IE-Demobeispiels.

CMFCToolBar m_wndToolBar;

// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

`CMFCToolBar::Deactivate`

Deaktiviert die Symbolleiste.

virtual void Deactivate();

Hinweise

Mit dieser Methode wird die Symbolleiste deaktiviert, indem der Fokus aus der hervorgehobenen Symbolleistenschaltfläche entfernt wird. Das Framework ruft diese Methode auf, wenn die Symbolleiste den Fokus verliert oder zerstört wird.

`CMFCToolBar::DoPaint`

Stellt eine Symbolleiste neu dar.

virtual void DoPaint(CDC* pDC);

Parameter

pDC
[in] Ein Zeiger auf einen Gerätekontext.

Hinweise

Diese Methode wird vom Framework aufgerufen, wenn ein Teil der Symbolleiste aktualisiert werden muss.

Überschreiben Sie diese Methode, um die Darstellung eines objekts anzupassen, das von CMFCToolBar.

`CMFCToolBar::DrawButton`

Überschreibt eine Symbolleistenschaltfläche.

virtual BOOL DrawButton(
    CDC* pDC,
    CMFCToolBarButton* pButton,
    CMFCToolBarImages* pImages,
    BOOL bHighlighted,
    BOOL bDrawDisabledImages);

Parameter

pDC
[in] Ein Zeiger auf einen Gerätekontext.

pButton
[in] Ein Zeiger auf eine Schaltfläche, die gezeichnet werden soll.

pImages
[in] Ein Zeiger auf die Symbolleistenbilder.

bHighlighted
[in] TRUE wenn die Schaltfläche hervorgehoben ist; andernfalls FALSE.

bDrawDisabledImages
[in] TRUE wenn deaktivierte Schaltflächen abgeblendet sind; andernfalls FALSE.

Rückgabewert

TRUE wenn die Schaltfläche aktualisiert wurde; FALSE wenn die Schaltfläche ausgeblendet ist.

Hinweise

Die CMFCToolBar::DrawButton Methode ruft diese Methode auf, wenn eine Symbolleistenschaltfläche aktualisiert werden muss.

Überschreiben Sie diese Methode, wenn Sie die Darstellung von Schaltflächen auf der Symbolleiste anpassen möchten.

`CMFCToolBar::DrawSeparator`

Blättern Sie ein Trennzeichen auf einer Symbolleiste neu.

virtual void DrawSeparator(
    CDC* pDC,
    const CRect& rect,
    BOOL bHorz);

Parameter

pDC
[in] Ein Zeiger auf einen Gerätekontext.

rect
[in] Das umgebende Rechteck der Position, an der das Trennzeichen gezeichnet wird, in Pixeln.

bHorz
[in] TRUE wenn das Trennzeichen horizontal ist, FALSE wenn das Trennzeichen vertikal ist.

Hinweise

CMFCToolBar::DoPaint ruft diese Methode für jedes CMFCToolBar::DrawSeparator Objekt mit der TBBS_SEPARATOR Formatvorlage auf, anstatt diese Schaltflächen aufzurufen CMFCToolBar::DrawButton .

Überschreiben Sie diese Methode in einer Klasse, die von CMFCToolBar der Anpassung der Darstellung von Trennzeichen auf der Symbolleiste abgeleitet wurde. Die standardmäßigen Implementierungsaufrufe CMFCVisualManager::OnDrawSeparator zum Zeichnen eines Trennzeichens, dessen Darstellung vom aktuellen visuellen Manager bestimmt wird.

`CMFCToolBar::EnableCustomizeButton`

Aktiviert oder deaktiviert die Schaltfläche "Anpassen", die auf der Symbolleiste angezeigt wird.

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    const CString& strCustomizeText,
    BOOL bQuickCustomize=TRUE);

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    UINT uiCustomizeTextResId,
    BOOL bQuickCustomize=TRUE);

Parameter

bEnable
[in] Aktiviert oder deaktiviert die Schaltfläche "Anpassen".

iCustomizeCmd
[in] Die Befehls-ID der Schaltfläche "Anpassen".

strCustomizeText
[in] Die Textbezeichnung der Schaltfläche "Anpassen".

uiCustomizeTextResId
[in] Die Ressourcenzeichenfolgen-ID der Schaltflächenbezeichnung anpassen.

bQuickCustomize
[in] Aktiviert oder deaktiviert die Option "Schaltflächen hinzufügen" oder "Entfernen" im Menü, das aus der Schaltfläche abweicht.

Hinweise

Wenn iCustomizeCmd -1 ist, zeigt das Framework die Schaltfläche "Anpassen", wenn mehrere Symbolleistenschaltflächen nicht in den Symbolleistenbereich passen. Die Schaltfläche zeigt einen doppelseitigen Pfeil nach links oder Chevron an, der angibt, dass weitere Schaltflächen vorhanden sind.

Wenn iCustomizeCmd eine gültige Befehls-ID angegeben ist und bEnable ist TRUE, wird die Schaltfläche "Anpassen" immer angezeigt. Die Schaltfläche verfügt über einen kleinen Pfeil nach unten und öffnet ein Menü, das einen Befehl enthält. Dieser Befehl verwendet die durch strCustomizeText. Wenn bQuickCustomize auch TRUE, zeigt das Menü die Option "Schaltflächen hinzufügen" oder "Entfernen" an.

Das Framework fügt dem Menü dynamisch alle Schaltflächen hinzu, die nicht in den Symbolleistenbereich passen, bevor das element iCustomizeCmd, durch das angegeben wird. Das Chevron wird neben dem Pfeil nach unten angezeigt.

`CMFCToolBar::EnableDocking`

Aktiviert das Andocken des Bereichs an den Hauptrahmen.

virtual void EnableDocking(DWORD dwAlignment);

Parameter

dwAlignment
[in] Gibt die zu aktivierende Andockausrichtung an.

Hinweise

Diese Methode erweitert die Basisklassenimplementierung, CBasePane::EnableDockingindem das CBasePane::m_dwControlBarStyle Datenmemmemm festgelegt wird AFX_CBRS_FLOAT. Diese Methode wird dann an die Basisklassenimplementierung übergeben dwAlignment .

`CMFCToolBar::EnableLargeIcons`

Aktiviert oder deaktiviert große Symbole auf Symbolleistenschaltflächen.

void EnableLargeIcons(BOOL bEnable);

Parameter

bEnable
[in] TRUE um große Symbole zu aktivieren, FALSE um große Symbole zu deaktivieren.

Hinweise

Standardmäßig sind große Symbole aktiviert.

`CMFCToolBar::EnableQuickCustomization`

Aktiviert oder deaktiviert die schnelle Anpassung von Symbolleisten, damit der Benutzer die ALT-TASTE drücken und eine Schaltfläche an eine neue Position ziehen kann.

static void EnableQuickCustomization(BOOL bEnable=TRUE);

Parameter

bEnable
[in] TRUE um schnelle Anpassungen zu ermöglichen, FALSE um schnelle Anpassungen zu deaktivieren.

`CMFCToolBar::EnableReflections`

Aktiviert oder deaktiviert die Befehlsreflexion.

void EnableReflections(BOOL bEnable = TRUE);

Parameter

bEnable
[in] TRUE um Befehlsreflektion zu ermöglichen; FALSE zum Deaktivieren der Befehlsreflektion.

Hinweise

Rufen Sie diese Methode auf, um Befehlsspiegelung für Symbolleistenschaltflächen zu aktivieren, die eingebettete Steuerelemente enthalten, z. B. Kombinationsfelder.

Weitere Informationen zur Befehlsreflektion finden Sie unter TN062: Message Reflection for Windows Controls.

`CMFCToolBar::EnableTextLabels`

Aktiviert oder deaktiviert Textbeschriftungen unter Symbolleistenschaltflächenbildern.

void EnableTextLabels(BOOL bEnable=TRUE);

Parameter

bEnable
TRUE wenn Textbeschriftungen unter Schaltflächensymbolleistenbildern angezeigt werden; andernfalls FALSE.

Hinweise

Wenn Textbeschriftungen aktiviert sind, werden alle Schaltflächen auf der Symbolleiste vergrößert, um Platz für die Anzeige der Beschriftungen unter den Bildern bereitzustellen. Das Dialogfeld "Anpassung" enthält ein Kontrollkästchen "Beschriftung anzeigen" auf der Seite "Symbolleisten ". Wenn der Benutzer eine Symbolleiste auswählt und diese Option überprüft, ruft das Framework die ausgewählte Symbolleiste auf EnableTextLabels . Sie können das Kontrollkästchen für ein von einem Objekt abgeleitetes CMFCToolBar Objekt deaktivieren, indem Sie von CMFCToolBar::AllowChangeTextLabels .FALSE

`CMFCToolBar::FromHandlePermanent`

Ruft einen Zeiger auf das CMFCToolBar Objekt ab, das das angegebene Fensterhandle enthält.

static CMFCToolBar* __stdcall FromHandlePermanent(HWND hwnd);

Parameter

hwnd
[in] Der Fensterziehpunkt, nach dem gesucht werden soll.

Rückgabewert

Ein Zeiger auf das CMFCToolBar Objekt, das das angegebene Fensterhandle enthält, oder NULL wenn kein entsprechendes CMFCToolBar Objekt vorhanden ist.

Hinweise

Diese freigegebene Methode untersucht jede Symbolleiste in der Anwendung auf das CMFCToolBar Objekt, das das angegebene Fensterhandle enthält.

`CMFCToolBar::GetAllButtons`

Gibt eine schreibgeschützte Liste von Schaltflächen in einer Symbolleiste zurück.

const CObList& GetAllButtons() const;

Rückgabewert

Ein Konstantenverweis auf ein CObList Class-Objekt , das eine Auflistung von CMFCToolBarButton Class-Objekten enthält.

`CMFCToolBar::GetAllToolbars`

Gibt eine schreibgeschützte Liste aller Symbolleisten in der Anwendung zurück.

static const CObList& GetAllToolbars();

Rückgabewert

Ein Konstverweis auf ein CObList Class-Objekt , das eine Auflistung von CMFCToolBar Objekten enthält.

`CMFCToolBar::GetBasicCommands`

Gibt eine schreibgeschützte Liste der grundlegenden Befehle zurück, die in der Anwendung definiert sind.

static const CList<UINT,UINT>& GetBasicCommands();

Rückgabewert

Ein Konstverweis auf ein CList Class-Objekt , das eine Auflistung grundlegender Befehle enthält.

Hinweise

Fügen Sie grundlegende Befehle hinzu, indem Sie aufrufen CMFCToolBar::AddBasicCommand oder CMFCToolBar::SetBasicCommands.

`CMFCToolBar::GetButton`

Gibt einen Zeiger auf das CMFCToolBarButton Class - Objekt an einem angegebenen Index zurück.

CMFCToolBarButton* GetButton(int iIndex) const;

Parameter

iIndex
[in] Gibt den Index der zurückzugebenden Schaltfläche an.

Rückgabewert

Ein Zeiger auf die Symbolleistenschaltfläche, falls vorhanden; oder NULL wenn keine solche Schaltfläche vorhanden ist.

`CMFCToolBar::GetButtonInfo`

Gibt die Befehls-ID, das Format und den Bildindex der Schaltfläche an einem angegebenen Index zurück.

void GetButtonInfo(
    int nIndex,
    UINT& nID,
    UINT& nStyle,
    int& iImage) const;

Parameter

nIndex
[in] Gibt den Index der Schaltfläche in der Liste der Schaltflächen auf der Symbolleiste an.

nID
[out] Die Befehls-ID einer Schaltfläche.

nStyle
[out] Die Formatvorlage der Schaltfläche.

iImage
[out] Der Index des Bilds für die Schaltfläche.

Hinweise

Die GetButtonInfo Methode findet eine Symbolleistenschaltfläche am angegebenen Index und ruft die Befehls-ID, den Stil und den Bildindex der Schaltfläche ab.

Wenn die Schaltfläche am angegebenen Index nicht vorhanden ist, wird das Framework auf 0 und iImage auf -1 festgelegt nID nStyle, wenn die Methode zurückgegeben wird.

`CMFCToolBar::GetButtonSize`

Gibt die Abmessungen der einzelnen Schaltflächen auf der Symbolleiste zurück.

CSize GetButtonSize() const;

Rückgabewert

Ein CSize Class-Objekt , das die Abmessungen der einzelnen Schaltflächen auf der Symbolleiste angibt.

Hinweise

Rufen Sie CMFCToolBar::SetSizes die Abmessungen der einzelnen Schaltflächen auf der Symbolleiste auf, oder CMFCToolBar::SetLockedSizes legen Sie sie fest.

`CMFCToolBar::GetButtonStyle`

Gibt die aktuelle Formatvorlage der Symbolleistenschaltfläche zurück, die sich am angegebenen Index befindet.

UINT GetButtonStyle(int nIndex) const;

Parameter

nIndex
[in] Gibt den Index einer Symbolleistenschaltfläche an.

Rückgabewert

Ein Wert, der die Formatvorlage der Symbolleistenschaltfläche angibt. . Eine Liste möglicher Formatvorlagen finden Sie unter ToolBar-Steuerelementstile .

Hinweise

Aufrufen CMFCToolBar::SetButtonStyle zum Festlegen des Stils einer Symbolleistenschaltfläche

`CMFCToolBar::GetButtonText`

Gibt die Textbezeichnung einer Schaltfläche zurück, die einen angegebenen Index enthält.

CString GetButtonText(int nIndex) const;

void GetButtonText(
    int nIndex,
    CString& rString) const;

`CMFCToolBar::GetCommandButtons`

Gibt eine Liste von Schaltflächen zurück, die über eine angegebene Befehls-ID aus allen Symbolleisten in der Anwendung verfügen.

static int GetCommandButtons(
    UINT uiCmd,
    CObList& listButtons);

Parameter

uiCmd
[in] Die Befehls-ID der Schaltflächen.

listButtons
[out] Ein Verweis auf ein CObList Class-Objekt , das die Liste der Symbolleistenschaltflächen empfängt.

Rückgabewert

Die Anzahl der Schaltflächen mit der angegebenen Befehls-ID.

`CMFCToolBar::GetCount`

Gibt die Anzahl der Schaltflächen und Trennzeichen auf der Symbolleiste zurück.

int GetCount() const;

Rückgabewert

Die Anzahl der Schaltflächen und Trennzeichen auf der Symbolleiste.

`CMFCToolBar::GetCustomizeButton`

Ruft einen Zeiger auf das CMFCCustomizeButton Objekt ab, das der Symbolleiste zugeordnet ist.

CMFCCustomizeButton* GetCustomizeButton();

Rückgabewert

Ein Zeiger auf das CMFCCustomizeButton Objekt, das der Symbolleiste zugeordnet ist.

Hinweise

Mit dieser Methode wird die Schaltfläche "Anpassen" abgerufen, die am Ende der Symbolleiste angezeigt wird. Verwenden Sie die CMFCToolBar::EnableCustomizeButton Methode, um der Symbolleiste die Schaltfläche "Anpassen" hinzuzufügen.

Sie können die CMFCToolBar::IsExistCustomizeButton Methode aufrufen, um zu bestimmen, ob die Symbolleiste ein gültiges CMFCCustomizeButton Objekt enthält.

`CMFCToolBar::GetDefaultImage`

Gibt den Index des Standardbilds für eine Symbolleistenschaltfläche mit einer angegebenen Befehls-ID zurück.

static int GetDefaultImage(UINT uiID);

Parameter

BOOL GetIgnoreSetText() const;

Rückgabewert

TRUEwenn Aufrufe zum Festlegen von Schaltflächenbeschriftungen ignoriert werden; andernfalls . FALSE

Hinweise

`CMFCToolBar::GetImages`

Gibt einen Zeiger auf die Auflistung der Standardschaltflächenbilder in der Anwendung zurück.

static CMFCToolBarImages* GetImages();

Rückgabewert

Ein Zeiger auf das CMFCToolBarImages Class-Objekt , das die Auflistung der Standardbilder für alle Symbolleisten in der Anwendung enthält.

Hinweise

Diese freigegebene Methode bietet Zugriff auf die Sammlung aller Standardsymbolleistenbilder für die Anwendung. Rufen Sie die CMFCToolBar::LoadBitmap Methode auf, um der Auflistung Bilder hinzuzufügen.

`CMFCToolBar::GetImageSize`

Gibt die aktuelle Größe der Schaltflächenbilder der Symbolleiste zurück.

CSize GetImageSize() const;

Rückgabewert

Ein CSize Class-Objekt , das die aktuelle Größe von Schaltflächenbildern der Symbolleiste darstellt.

`CMFCToolBar::GetImagesOffset`

Gibt den Indexoffset zurück, der verwendet wird, um die Symbolleistenschaltflächenbilder für diese Symbolleiste in der globalen Liste der Schaltflächenbilder der Symbolleiste zu finden.

int GetImagesOffset() const;

Rückgabewert

Der Indexoffset der Symbolleistenbilder.

Hinweise

Alle Standardbilder der Symbolleiste werden in der globalen CMFCToolBarImages Klassenliste gespeichert. Die Bilder für jede Schaltfläche in der Symbolleiste werden in dieser Liste aufeinander folgenden gespeichert. Um den Index des Bilds zu berechnen, fügen Sie den Index der Schaltfläche in der Symbolleiste zum Offset des Anfangs der Liste der Bilder für diese Symbolleistenschaltfläche hinzu.

Rufen Sie CMFCToolBar::ButtonToIndex auf, um den Index einer Symbolleistenschaltfläche abzurufen, die einen Zeiger auf die Schaltfläche erhält.

Rufen Sie CMFCToolBar::GetImages auf, um einen Zeiger auf die Sammlung von Symbolleistenbildern abzurufen.

`CMFCToolBar::GetInvalidateItemRect`

Ruft den Bereich des Clientbereichs ab, der für die Schaltfläche im angegebenen Index neu gezeichnet werden muss.

virtual void GetInvalidateItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parameter

nIndex
[in] Der Index der Schaltfläche, für die der Clientbereich abgerufen werden soll.

lpRect
[out] Ein Zeiger auf ein RECT Objekt, das den Bereich des Clientbereichs empfängt.

Hinweise

Der lpRect Parameter darf nicht sein NULL. Wenn keine Schaltfläche im bereitgestellten Index vorhanden ist, empfängt ein RECT Objekt, lpRect das auf Null initialisiert wird.

`CMFCToolBar::GetItemID`

Gibt die Befehls-ID der Symbolleistenschaltfläche an einem angegebenen Index zurück.

UINT GetItemID(int nIndex) const;

Parameter

nIndex
[in] Gibt den Index der Symbolleistenschaltfläche an.

Rückgabewert

Die Befehls-ID der Symbolleistenschaltfläche; oder Null, wenn die Schaltfläche mit dem angegebenen Index nicht vorhanden ist.

`CMFCToolBar::GetItemRect`

Gibt das umgebende Rechteck der Schaltfläche an einem angegebenen Index zurück.

virtual void GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parameter

nIndex
[in] Gibt den Index einer Symbolleistenschaltfläche an.

lpRect
[out] Ein Zeiger auf CRect ein Objekt, das die Koordinaten des umgebenden Rechtecks des Bilds empfängt.

Hinweise

Das CRect Objekt, auf das lpRect Punkte festgelegt ist, wenn eine Schaltfläche am angegebenen Index nicht vorhanden ist.

Beispiel

Im folgenden Beispiel wird die Verwendung der GetItemRect Methode der CMFCToolBar Klasse veranschaulicht. Dieser Codeausschnitt ist Teil des IE-Demobeispiels.

CMFCToolBar m_wndToolBar;

CRect rectToolBar;
m_wndToolBar.GetItemRect(0, &rectToolBar);

`CMFCToolBar::GetLargeColdImages`

Gibt einen Zeiger auf die Auflistung großer kalter Symbolleistenschaltflächenbilder in der Anwendung zurück.

static CMFCToolBarImages* GetLargeColdImages();

Rückgabewert

Ein Zeiger auf die Sammlung großer kalter Bilder.

Hinweise

Kalte Bilder sind die Bilder, die verwendet werden, wenn der Benutzer nicht mit den Symbolleistenschaltflächen interagiert. Rufen Sie auf CMFCToolBar::LoadBitmapEx , um die großen kalten Bilder zu laden.

`CMFCToolBar::GetLargeDisabledImages`

Gibt einen Zeiger auf die Auflistung großer deaktivierter Schaltflächenbilder in der Anwendung zurück.

static CMFCToolBarImages* GetLargeDisabledImages();

Rückgabewert

Ein Zeiger auf die Sammlung großer deaktivierter Symbolleistenschaltflächenbilder.

Hinweise

Große Bilder sind große Versionen der normalen Symbolleistenschaltflächenbilder. Rufen Sie CMFCToolBar::LoadBitmapEx die großen Bilder auf, oder CMFCToolBar::LoadBitmap laden Sie sie.

`CMFCToolBar::GetLargeImages`

Gibt einen Zeiger auf die Auflistung großer Symbolleistenschaltflächenbilder in der Anwendung zurück.

static CMFCToolBarImages* GetLargeImages();

Rückgabewert

Ein Zeiger auf die Sammlung großer Symbolleistenschaltflächenbilder.

Hinweise

Große Bilder sind große Versionen der normalen Symbolleistenschaltflächenbilder. Rufen Sie auf CMFCToolBar::LoadBitmapEx , um die großen Bilder zu laden.

`CMFCToolBar::GetLockedColdImages`

Gibt einen Zeiger auf die Auflistung gesperrter kalter Bilder in der Symbolleiste zurück.

CMFCToolBarImages* GetLockedColdImages();

Rückgabewert

Ein Zeiger auf die Sammlung gesperrter kalter Bilder oder NULL wenn die Symbolleiste nicht gesperrt ist.

Hinweise

Gesperrte Bilder sind Versionen der normalen Schaltflächenbilder der Symbolleiste, die das Framework verwendet, wenn der Benutzer die Symbolleiste nicht anpassen kann. Kalte Bilder sind die Bilder, die verwendet werden, wenn der Benutzer nicht mit den Symbolleistenschaltflächen interagiert.

Diese Methode gibt zurück NULL , wenn die Symbolleiste nicht gesperrt ist. Diese Methode generiert auch einen Assertionsfehler in Debugbuilds, wenn die Symbolleiste nicht gesperrt ist. Weitere Informationen zu gesperrten Symbolleisten finden Sie unter CMFCToolBar::IsLocked.

Rufen Sie die CMFCToolBar::LoadBitmapEx Methode auf, um die gesperrten kalten Bilder zu laden.

`CMFCToolBar::GetLockedDisabledImages`

Gibt einen Zeiger auf die Auflistung gesperrter deaktivierter Bilder in der Symbolleiste zurück.

CMFCToolBarImages* GetLockedDisabledImages();

Rückgabewert

Ein Zeiger auf die Sammlung gesperrter deaktivierter Bilder oder NULL wenn die Symbolleiste nicht gesperrt ist.

Hinweise

Gesperrte Bilder sind Versionen der normalen Schaltflächenbilder der Symbolleiste, die das Framework verwendet, wenn der Benutzer die Symbolleiste nicht anpassen kann. Deaktivierte Bilder sind die Bilder, die das Framework verwendet, wenn eine Schaltfläche über die TBBS_DISABLED Formatvorlage verfügt.

Rufen Sie die CMFCToolBar::LoadBitmapEx Methode auf, um die gesperrten deaktivierten Bilder zu laden.

`CMFCToolBar::GetLockedImages`

Gibt einen Zeiger auf die Auflistung gesperrter Schaltflächenbilder in der Symbolleiste zurück.

CMFCToolBarImages* GetLockedImages();

Rückgabewert

Ein Zeiger auf die Sammlung gesperrter Symbolleistenschaltflächenbilder oder NULL wenn die Symbolleiste nicht gesperrt ist.

Hinweise

Gesperrte Bilder sind Versionen der normalen Schaltflächenbilder der Symbolleiste, die das Framework verwendet, wenn der Benutzer die Symbolleiste nicht anpassen kann.

`CMFCToolBar::GetLockedImageSize`

Gibt die Standardgröße von gesperrten Symbolleistenbildern zurück.

CSize GetLockedImageSize() const;

Rückgabewert

Eine CSize Struktur, die die Größe von gesperrten Symbolleistenbildern oder eine leere CSize Struktur angibt, wenn die Symbolleiste nicht gesperrt ist.

Hinweise

Gesperrte Bilder sind Versionen der normalen Schaltflächenbilder der Symbolleiste, die das Framework verwendet, wenn der Benutzer die Symbolleiste nicht anpassen kann.

Diese Methode gibt eine CSize Struktur mit Nullbreite und Nullhöhe zurück, wenn die Symbolleiste nicht gesperrt ist. Diese Methode generiert auch einen Assertionsfehler in Debugbuilds, wenn die Symbolleiste nicht gesperrt ist. Weitere Informationen zu gesperrten Symbolleisten finden Sie unter CMFCToolBar::IsLocked.

Rufen Sie die CMFCToolBar::SetLockedSizes Methode auf, um die gesperrte Bildgröße anzugeben.

`CMFCToolBar::GetLockedMenuImages`

Gibt einen Zeiger auf die Auflistung gesperrter Symbolleistenmenübilder in der Symbolleiste zurück.

CMFCToolBarImages* GetLockedMenuImages();

Rückgabewert

Ein Zeiger auf die Sammlung gesperrter Symbolleistenmenübilder oder NULL wenn die Symbolleiste nicht gesperrt ist.

Hinweise

Gesperrte Bilder sind Versionen der normalen Symbolleistenmenübilder, die das Framework verwendet, wenn der Benutzer die Symbolleiste nicht anpassen kann.

Rufen Sie die CMFCToolBar::LoadBitmapEx Methode auf, um die gesperrten Menübilder zu laden.

`CMFCToolBar::GetMenuButtonSize`

Gibt die Größe von Menüschaltflächen in der Anwendung zurück.

static CSize GetMenuButtonSize();

Rückgabewert

Ein CSize Objekt, das die Größe von Menüschaltflächen in Pixel darstellt.

Hinweise

Die Größe von Menüschaltflächen auf Symbolleisten wird als globale Variable verwaltet und kann von dieser statischen Methode abgerufen werden.

Aufrufen CMFCToolBar::SetMenuSizes , um diese globale Variable festzulegen.

`CMFCToolBar::GetMenuImages`

Gibt einen Zeiger auf die Auflistung von Menüschaltflächenbildern in der Anwendung zurück.

static CMFCToolBarImages* GetMenuImages();

Rückgabewert

Ein Zeiger auf die Sammlung von Menübildern.

Hinweise

Rufen Sie die CMFCToolBar::LoadBitmapEx Methode auf, um die Menübilder zu laden.

Rufen Sie die CMFCToolBar::SetMenuSizes Methode auf, um die Größe von Schaltflächen und deren Bildern festzulegen.

`CMFCToolBar::GetMenuImageSize`

Gibt die Größe von Menüschaltflächenbildern in der Anwendung zurück.

static CSize GetMenuImageSize();

Rückgabewert

Ein CSize Objekt, das die Größe von Menübildern darstellt.

Hinweise

Diese Methode gibt die Größe von Bildern auf Symbolleistenmenüschaltflächen zurück, die als globale Variable verwaltet werden. Aufrufen CMFCToolBar::SetMenuSizes , um diese globale Variable festzulegen.

`CMFCToolBar::GetOrigButtons`

Ruft die Auflistung nicht angepasster Schaltflächen der Symbolleiste ab.

const CObList& GetOrigButtons() const;

Rückgabewert

Ein Verweis auf die Liste der nicht angepassten Schaltflächen der Symbolleiste.

Hinweise

Das Framework erstellt eine Kopie von Symbolleistenschaltflächen, bevor sie vom Benutzer angepasst werden. Die CMFCToolBar::SetButtons Methode fügt der Liste der ursprünglichen Schaltflächen eine Kopie der einzelnen Schaltflächen im bereitgestellten Array hinzu. Die CMFCToolBar::RestoreOriginalState Methode stellt den ursprünglichen Zustand der Symbolleiste wieder her, indem sie aus der Ressourcendatei geladen wird.

Rufen Sie die Methode auf CMFCToolBar::SetOrigButtons , um die Liste der ursprünglichen Schaltflächen für die Symbolleiste festzulegen.

`CMFCToolBar::GetOrigResetButtons`

Ruft die Auflistung nicht angepasster Zurücksetzungsschaltflächen der Symbolleiste ab.

const CObList& GetOrigResetButtons() const;

Rückgabewert

Ein Verweis auf die Liste der nicht angepassten Zurücksetzungsschaltflächen der Symbolleiste.

Hinweise

Wenn der Benutzer die Schaltfläche "Zurücksetzen" während des Anpassungsmodus auswählt, verwendet das Framework diese Methode, um Schaltflächen wiederherzustellen, die von der Symbolleiste entfernt wurden.

Die CMFCToolBar::SetButtons Methode fügt eine Kopie jeder Symbolleistenschaltfläche zur Liste der ursprünglichen Zurücksetzungsschaltflächen hinzu, nachdem sie die Methode aufgerufen hat CMFCToolBar::OnReset . Sie können die CMFCToolBar::OnReset Methode überschreiben, um die Darstellung von Schaltflächen anzupassen, nachdem der Benutzer die Schaltfläche "Zurücksetzen " drückt.

`CMFCToolBar::GetResourceID`

Ruft die Ressourcen-ID der Symbolleiste ab.

UINT GetResourceID() const;

Rückgabewert

Die Ressourcen-ID der Symbolleiste.

Hinweise

Rufen Sie die CMFCToolBar::LoadToolBarEx Methode auf, um die Ressourcen-ID der Symbolleiste festzulegen.

`CMFCToolBar::GetRouteCommandsViaFrame`

Bestimmt, welches Objekt, der übergeordnete Frame oder der Besitzer, Befehle an die Symbolleiste sendet.

BOOL GetRouteCommandsViaFrame();

Rückgabewert

Nonzero, wenn der übergeordnete Frame Befehle an die Symbolleiste sendet; 0, wenn der Besitzer Befehle an die Symbolleiste sendet.

Hinweise

Standardmäßig sendet der übergeordnete Frame Befehle an die Symbolleiste. Rufen Sie auf CMFCToolBar::SetRouteCommandsViaFrame , um dieses Verhalten zu ändern.

Wenn diese Methode einen Wert ungleich Null zurückgibt, können Sie mithilfe der CMFCToolBar::GetCommandTarget Methode einen Zeiger auf das übergeordnete Frameobjekt abrufen. Ein Beispiel, das diese Methode verwendet, finden Sie im VisualStudioDemo-Beispiel.

`CMFCToolBar::GetRowHeight`

Gibt die Höhe der Symbolleistenschaltflächen zurück.

virtual int GetRowHeight() const;

Rückgabewert

Die Höhe der Symbolleistenschaltflächen in Pixeln.

Hinweise

Das Framework ruft diese Methode zum Berechnen des Symbolleistenlayouts auf. Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um eine andere Höhe für die Symbolleiste anzugeben.

`CMFCToolBar::GetShowTooltips`

Gibt an, ob QuickInfos für Symbolleistenschaltflächen angezeigt werden.

static BOOL GetShowTooltips();

Rückgabewert

TRUE wenn QuickInfos für Symbolleistenschaltflächen angezeigt werden; andernfalls FALSE.

Hinweise

Standardmäßig werden QuickInfos angezeigt. Sie können dieses statische Flag ändern, indem Sie aufrufen CMFCToolBar::SetShowTooltips.

`CMFCToolBar::GetSiblingToolBar`

Ruft das gleichgeordnete Element der Symbolleiste ab.

CMFCToolBar* GetSiblingToolBar();

Rückgabewert

Ein Zeiger auf die gleichgeordnete Symbolleiste.

Hinweise

Weitere Informationen zum Aktivieren der Schaltflächen "Schaltflächen anzeigen" in einer Zeile und "Schaltflächen anzeigen" auf zwei Zeilenschaltflächen finden Sie unter CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::GetUserImages`

Gibt einen Zeiger auf die Auflistung benutzerdefinierter Symbolleistenschaltflächenbilder in der Anwendung zurück.

static CMFCToolBarImages* GetUserImages();

Rückgabewert

Ein Zeiger auf die Sammlung benutzerdefinierter Symbolleistenschaltflächenbilder für alle Symbolleisten in der Anwendung.

Hinweise

Rufen Sie die CMFCToolBar::SetUserImages Methode auf, um die Sammlung benutzerdefinierter Bilder in der Anwendung festzulegen.

`CMFCToolBar::HitTest`

Gibt den Index der Symbolleistenschaltfläche zurück, die sich an der angegebenen Position befindet.

virtual int HitTest(CPoint point);

Parameter

point
[in] Der zu testende Punkt in Clientkoordinaten.

Rückgabewert

Der Index der Schaltfläche, die sich an der angegebenen Position befindet, oder -1, wenn keine solche Schaltfläche vorhanden ist oder die Schaltfläche ein Trennzeichen ist.

`CMFCToolBar::InsertButton`

Fügt eine Schaltfläche in die Symbolleiste ein.

virtual int InsertButton(
    const CMFCToolBarButton& button,
    INT_PTR iInsertAt=-1);

virtual int InsertButton(
    CMFCToolBarButton* pButton,
    int iInsertAt=-1);

Parameter

button
[in] Gibt die einzufügende Schaltfläche an.

iInsertAt
[in] Gibt die nullbasierte Position an, an der die Schaltfläche eingefügt werden soll.

Rückgabewert

Die Position, an der die Schaltfläche eingefügt wurde, oder -1, wenn ein Fehler auftritt.

Hinweise

Wenn iInsertAt -1 ist, fügt diese Methode die Schaltfläche am Ende der Liste der Symbolleistenschaltflächen hinzu.

Rufen Sie die CMFCToolBar::InsertSeparator Methode auf, um ein Trennzeichen in die Symbolleiste einzufügen.

`CMFCToolBar::InsertSeparator`

Fügt ein Trennzeichen in die Symbolleiste ein.

virtual int InsertSeparator(INT_PTR iInsertAt=-1);

Parameter

iInsertAt
[in] Gibt die nullbasierte Position an, an der das Trennzeichen eingefügt werden soll. Dieser Parameter muss größer als 0 sein.

Rückgabewert

Die Position, an der das Trennzeichen eingefügt wurde, oder -1, wenn ein Fehler auftritt.

Hinweise

Rufen Sie diese Methode auf, um ein Trennzeichen zwischen zwei vorhandenen Schaltflächen einzufügen. Wenn iInsertAt -1 ist, fügt diese Methode das Trennzeichen am Ende der Liste der Symbolleistenschaltflächen hinzu.

Sie können diese Methode nicht verwenden, um einer leeren Symbolleiste ein Trennzeichen hinzuzufügen.

Rufen Sie die CMFCToolBar::InsertButton Methode auf, um eine Schaltfläche in die Symbolleiste einzufügen.

`CMFCToolBar::InvalidateButton`

Ungültig wird der Clientbereich der Symbolleistenschaltfläche, die im angegebenen Index vorhanden ist.

CMFCToolBarButton* InvalidateButton(int nIndex);

Parameter

nIndex
[in] Der nullbasierte Index der Schaltfläche in der Symbolleiste.

Rückgabewert

Ein Zeiger auf das CMFCToolBarButton Objekt, das im angegebenen Index vorhanden ist oder NULL wenn kein solches Objekt vorhanden ist.

Hinweise

Das Framework ruft diese Methode auf, wenn er den Clientbereich aktualisiert, der einer Symbolleistenschaltfläche zugeordnet ist. Sie ruft die CWnd::InvalidateRect Methode mit dem Clientrechteck des CMFCToolBarButton Objekts auf, das im bereitgestellten Index vorhanden ist.

`CMFCToolBar::IsAddRemoveQuickCustomize`

Bestimmt, ob ein Benutzer Mithilfe der Menüoption "Anpassen " Symbolleistenschaltflächen hinzufügen oder entfernen kann.

BOOL IsAddRemoveQuickCustomize();

Rückgabewert

TRUEwenn ein Benutzer die Menüoption Anpassen verwenden kann, um die Symbolleiste zu ändern; andernfalls . FALSE

Hinweise

`CMFCToolBar::IsAltCustomizeMode`

Gibt an, ob schnelle Anpassungen zum Ziehen einer Schaltfläche verwendet werden. Wenn die schnelle Anpassung aktiviert ist, kann ein Benutzer die ALT-TASTE drücken und halten und eine Schaltfläche an eine neue Position ziehen.

static BOOL __stdcall IsAltCustomizeMode();

Rückgabewert

TRUEwenn schnelle Anpassung verwendet wird, um eine Schaltfläche zu ziehen; andernfalls . FALSE

Hinweise

`CMFCToolBar::IsAutoGrayInactiveImages`

Gibt an, ob die automatische Generierung von inaktiven (nicht hervorgehobenen) Schaltflächenbildern aktiviert ist.

static BOOL IsAutoGrayInactiveImages();

Rückgabewert

TRUE wenn die Option zum automatischen Abblenden inaktiver Bilder aktiviert ist; andernfalls FALSE.

Hinweise

Sie können die automatische Dimmung inaktiver Bilder durch Aufrufen CMFCToolBar::AutoGrayInactiveImagesaktivieren oder deaktivieren.

`CMFCToolBar::IsBasicCommand`

Bestimmt, ob sich ein Befehl in der Liste der grundlegenden Befehle befindet.

static BOOL IsBasicCommand(UINT uiCmd);

Parameter

uiCmd
[in] Gibt den zu überprüfenden Befehl an.

Rückgabewert

TRUE wenn der angegebene Befehl zur Liste der grundlegenden Befehle gehört; andernfalls FALSE.

Hinweise

Diese statische Methode bestimmt, ob der angegebene uiCmd Befehl zur globalen Liste der grundlegenden Befehle gehört. Sie können die Liste der grundlegenden Befehle durch Aufrufen oder CMFCToolBar::SetBasicCommands.CMFCToolBar::AddBasicCommand

`CMFCToolBar::IsButtonExtraSizeAvailable`

Bestimmt, ob die Symbolleiste Schaltflächen mit erweiterten Rahmen anzeigen kann.

virtual BOOL IsButtonExtraSizeAvailable() const;

Rückgabewert

TRUE wenn die Leiste Schaltflächen mit der zusätzlichen Rahmengröße anzeigen kann; andernfalls FALSE.

Hinweise

Das Symbolleistenobjekt gibt zurück TRUE , wenn Schaltflächen mit erweiterten Rahmen angezeigt werden können. Eine Symbolleistenschaltfläche ruft diese Methode auf, wenn sie die CMFCToolBarButton::OnChangeParentWnd Benachrichtigung verarbeitet und die interne zusätzliche Rahmengröße entsprechend festgelegt. Diese interne Kennzeichnung kann später durch Aufrufen CMFCToolBarButton::IsExtraSizeabgerufen werden.

Überschreiben Sie diese Methode in einer von einer klasse abgeleiteten CMFCToolBar und zurückgeben TRUE , wenn ihre Leiste die Symbolleistenschaltflächen mit der zusätzlichen Rahmengröße anzeigen und andernfalls zurückgeben FALSE kann. Die Standardimplementierung gibt TRUE zurück.

`CMFCToolBar::IsButtonHighlighted`

Bestimmt, ob die angegebene Schaltfläche hervorgehoben ist.

BOOL IsButtonHighlighted(int iButton) const;

Parameter

iButton
[in] Gibt den Index einer Symbolleistenschaltfläche an.

Rückgabewert

TRUEwenn die angegebene Schaltfläche hervorgehoben ist; andernfalls . FALSE

Hinweise

`CMFCToolBar::IsCommandPermitted`

Bestimmt, ob ein Befehl zulässig ist.

static BOOL IsCommandPermitted(UINT uiCmd);

Parameter

uiCmd
[in] Gibt den zu überprüfenden Befehl an.

Rückgabewert

TRUE wenn der angegebene Befehl zulässig ist; andernfalls FALSE.

Hinweise

Diese statische Methode bestimmt, ob der angegebene uiCmd Befehl zur globalen Liste der nicht zulässigen Befehle gehört.

Sie können die Liste der nicht zulässigen Befehle durch Aufrufen CMFCToolBar::SetNonPermittedCommandsändern.

`CMFCToolBar::IsCommandRarelyUsed`

Bestimmt, ob ein Befehl selten verwendet wird.

static BOOL IsCommandRarelyUsed(UINT uiCmd);

Parameter

uiCmd
[in] Gibt den zu überprüfenden Befehl an.

Rückgabewert

TRUE wenn der angegebene Befehl selten verwendet wird; andernfalls FALSE.

Hinweise

Die IsCommandRarelyUsed Methode gibt zurück FALSE , wenn eine oder mehrere der folgenden Bedingungen auftreten:

Der angegebene Befehl gehört zur Liste der grundlegenden Befehle.
Der angegebene Befehl ist einer der Standardbefehle.
Das Framework befindet sich im Anpassungsmodus
Die Liste der grundlegenden Befehle ist leer.
Mehr als 20 % der Befehlsaufrufe sind Aufrufe an den angegebenen Befehl.

`CMFCToolBar::IsCustomizeMode`

Gibt an, ob sich das Symbolleistenframework im Anpassungsmodus befindet.

static BOOL IsCustomizeMode();

Rückgabewert

TRUE wenn sich das Framework im Anpassungsmodus befindet; andernfalls FALSE.

Hinweise

Sie können den Anpassungsmodus umschalten, indem Sie aufrufen CMFCToolBar::SetCustomizeMode.

Das Framework ändert den Modus, wenn der Benutzer das Anpassungsdialogfeld aufruft ( CMFCToolBarsCustomizeDialog Klasse).

`CMFCToolBar::IsDragButton`

Bestimmt, ob eine Symbolleistenschaltfläche gezogen wird.

BOOL IsDragButton(const CMFCToolBarButton* pButton) const;

Parameter

pButton
[in] Zeigen Sie auf eine Symbolleistenschaltfläche.

Rückgabewert

TRUEwenn die angegebene Schaltfläche gezogen wird; andernfalls . FALSE

Hinweise

`CMFCToolBar::IsExistCustomizeButton`

Bestimmt, ob die Symbolleiste die Schaltfläche "Anpassen " enthält.

BOOL IsExistCustomizeButton();

Rückgabewert

TRUE wenn die Symbolleiste die Schaltfläche "Anpassen " enthält; andernfalls FALSE.

Hinweise

Wenn diese Methode zurückgegeben wirdTRUE, gibt die CMFCToolBar::GetCustomizeButton Methode einen Zeiger auf die Schaltfläche Anpassen zurück, die am Ende der Symbolleiste angezeigt wird.

Verwenden Sie die CMFCToolBar::EnableCustomizeButton Methode, um der Symbolleiste die Schaltfläche "Anpassen" hinzuzufügen.

`CMFCToolBar::IsFloating`

Bestimmt, ob die Symbolleiste unverankert ist.

virtual BOOL IsFloating() const;

Rückgabewert

TRUEwenn die Symbolleiste unverankert ist; andernfalls . FALSE

`CMFCToolBar::IsLargeIcons`

Gibt an, ob Symbolleisten in der Anwendung derzeit große Symbole anzeigen.

static BOOL IsLargeIcons();

Rückgabewert

TRUE wenn die Anwendung große Symbole verwendet; andernfalls FALSE.

Hinweise

Rufen Sie CMFCToolBar::SetLargeIcons auf, um zwischen großen Symbolen und regulären Symbolen umzuschalten.

Das Framework ändert den Modus automatisch, wenn der Benutzer das Kontrollkästchen "Große Symbole " auf der Seite "Optionen " des Dialogfelds "Anpassung " umschaltt.

`CMFCToolBar::IsLastCommandFromButton`

Bestimmt, ob der zuletzt ausgeführte Befehl von der angegebenen Symbolleistenschaltfläche gesendet wurde.

static BOOL IsLastCommandFromButton(CMFCToolBarButton* pButton);

Parameter

pButton
[in] Zeiger auf Schaltfläche.

Rückgabewert

TRUE wenn der letzte Befehl von der Schaltfläche gesendet wurde, die pButton angibt; andernfalls FALSE.

Hinweise

Diese Methode ruft einen Zeiger auf eine MSG Struktur durch Aufrufen ab CWnd::GetCurrentMessage. Anschließend wird die HWND Schaltfläche mit den MSG::lParam Elementen verglichen MSG::hwnd , um festzustellen, ob die Schaltfläche die Quelle des Befehls war.

`CMFCToolBar::IsLocked`

Bestimmt, ob die Symbolleiste gesperrt ist.

BOOL IsLocked() const;

Rückgabewert

TRUEwenn die Symbolleiste gesperrt ist; andernfalls . FALSE

Hinweise

Diese Methode gibt zurück TRUE , wenn der Benutzer keine Anpassungsaufgaben ausführen kann, z. B. das Ändern der Symbolleistenschaltflächen.

Gesperrte Symbolleisten verwenden separate Bildlisten. Weitere Informationen zu diesen Bildlisten finden Sie unter CMFCToolBar::LoadBitmapEx.

`CMFCToolBar::IsOneRowWithSibling`

Bestimmt, ob die Symbolleiste und die zugehörige gleichgeordnete Symbolleiste in derselben Zeile positioniert sind.

BOOL IsOneRowWithSibling();

Rückgabewert

TRUE wenn die Symbolleiste und die gleichgeordneten Elemente in derselben Zeile positioniert sind; andernfalls FALSE.

Hinweise

Die CMFCCustomizeButton::CreatePopupMenu Methode ruft diese Methode auf, um zu bestimmen, wie das Popupmenü "Anpassen" angezeigt wird. Wenn diese Methode zurückgegeben wird TRUE, zeigt das Framework die Schaltflächen in einer Zeile anzeigen an. Andernfalls zeigt das Framework die Schaltfläche "Schaltflächen anzeigen" auf der Schaltfläche "Zwei Zeilen " an.

Sie müssen dieser Methode normalerweise nicht verwenden. Zum Aktivieren der Schaltflächen "Schaltflächen anzeigen" in einer Zeile oder "Schaltflächen anzeigen" auf zwei Zeilenschaltflächen rufen Sie CMFCToolBar::SetSiblingToolBarauf.

`CMFCToolBar::IsResourceChanged`

virtual BOOL IsResourceChanged() const;

Rückgabewert

Bemerkungen

`CMFCToolBar::IsSibling`

BOOL IsSibling();

Rückgabewert

Bemerkungen

`CMFCToolBar::IsUserDefined`

Gibt an, ob die Symbolleiste benutzerdefiniert ist.

BOOL IsUserDefined() const;

Rückgabewert

TRUE wenn die Symbolleiste vom Benutzer erstellt wurde; andernfalls FALSE.

`CMFCToolBar::LoadBitmap`

Lädt Symbolleistenbilder aus Anwendungsressourcen.

virtual BOOL LoadBitmap(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

Parameter

uiResID
[in] Die Ressourcen-ID der Bitmap, die auf die Heißen Symbolleistenbilder verweist.

uiColdResID
[in] Die Ressourcen-ID der Bitmap, die auf die Kaltsymbolleistenbilder verweist.

uiMenuResID
[in] Die Ressourcen-ID der Bitmap, die sich auf die normalen Menübilder bezieht.

bLocked
[in] TRUE um die Symbolleiste zu sperren; andernfalls FALSE.

uiDisabledResID
[in] Die Ressourcen-ID der Bitmap, die auf die deaktivierten Symbolleistenbilder verweist.

uiMenuDisabledResID
[in] Die Ressourcen-ID der Bitmap, die sich auf die deaktivierten Menübilder bezieht.

Rückgabewert

Ein Wert ungleich 0 (null), wenn die Methode erfolgreich ausgeführt wird, andernfalls 0 (null).

Hinweise

Die CMFCToolBar::LoadToolBarEx Methode ruft diese Methode auf, um die Bilder zu laden, die der Symbolleiste zugeordnet sind. Setzen Sie diese Methode außer Kraft, um die Bildressourcen benutzerdefiniert zu laden.

Rufen Sie die LoadBitmapEx -Methode auf, um nach der Erstellung der Symbolleiste weitere Bilder zu laden.

`CMFCToolBar::LoadBitmapEx`

virtual BOOL LoadBitmapEx(
    CMFCToolBarInfo& params,
    BOOL bLocked = FALSE);

Parameter

[in] params
[in] bLocked\

Rückgabewert

Bemerkungen

`CMFCToolBar::LoadLargeIconsState`

static BOOL __stdcall LoadLargeIconsState(LPCTSTR lpszProfileName = NULL);

Parameter

[in] lpszProfileName\

Rückgabewert

Bemerkungen

`CMFCToolBar::LoadParameters`

Lädt globale Symbolleistenoptionen aus der Windows-Registrierung.

static BOOL LoadParameters(LPCTSTR lpszProfileName=NULL);

Parameter

lpszProfileName
[in] Gibt den relativen Pfad des Windows-Registrierungsschlüssels an.

Rückgabewert

Ein Wert ungleich 0 (null), wenn die Methode erfolgreich ausgeführt wird, andernfalls 0 (null).

Hinweise

Diese Methode lädt globale Parameter wie den Menüanimationstyp, den Menüschattenstil und ob große Symbole aus der Windows-Registrierung angezeigt werden sollen.

Die CWinAppEx::LoadState Methode ruft diese Methode als Teil des Initialisierungsprozesses der Anwendung auf.

`CMFCToolBar::LoadState`

Lädt die Statusinformationen der Symbolleiste aus der Windows-Registrierung.

virtual BOOL LoadState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parameter

lpszProfileName
[in] Gibt den relativen Pfad des Windows-Registrierungsschlüssels an.

nIndex
[in] Gibt die Steuerelement-ID der Symbolleiste an.

uiID
[in] Gibt die Ressourcen-ID der Symbolleiste an.

Rückgabewert

Ein Wert ungleich 0 (null), wenn die Methode erfolgreich ausgeführt wird, andernfalls 0 (null).

Hinweise

Das Framework ruft diese Methode als Teil des Initialisierungsprozesses der Anwendung auf. Weitere Informationen finden Sie unter CWinAppEx::LoadState.

`CMFCToolBar::LoadToolBar`

Lädt die Symbolleiste aus Anwendungsressourcen.

virtual BOOL LoadToolBar(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0,
    UINT uiHotResID=0);

Parameter

uiResID
[in] Die Ressourcen-ID der Symbolleiste.

uiColdResID
[in] Die Ressourcen-ID der Bitmap, die auf die Kaltsymbolleistenbilder verweist.

uiMenuResID
[in] Die Ressourcen-ID der Bitmap, die sich auf die normalen Menübilder bezieht.

bLocked
[in] Ein boolescher Wert, der angibt, ob die Symbolleiste gesperrt ist oder nicht. Wenn dieser Parameter lautet, ist TRUEdie Symbolleiste gesperrt. Andernfalls ist die Symbolleiste nicht gesperrt.

uiDisabledResID
[in] Die Ressourcen-ID der Bitmap, die auf die deaktivierten Symbolleistenbilder verweist.

uiMenuDisabledResID
[in] Die Ressourcen-ID der Bitmap, die sich auf die deaktivierten Menübilder bezieht.

uiHotResID
[in] Die Ressourcen-ID der Bitmap, die auf die Heißen Symbolleistenbilder verweist.

Rückgabewert

Ein Wert ungleich 0 (null), wenn die Methode erfolgreich ausgeführt wird, andernfalls 0 (null).

Hinweise

Das Framework ruft diese Methode während der Initialisierung auf, um die Bilder zu laden, die der Symbolleiste zugeordnet sind.

Beispiel

Im folgenden Beispiel wird die Verwendung der LoadToolBar Methode in der CMFCToolBar Klasse veranschaulicht. Dieser Codeausschnitt ist Teil des IE-Demobeispiels.

CMFCToolBar m_wndToolBar;

// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

`CMFCToolBar::LoadToolBarEx`

Lädt die Symbolleiste aus Anwendungsressourcen mithilfe der CMFCToolBarInfo Hilfsklasse, damit die Anwendung große Bilder verwenden kann.

virtual BOOL LoadToolBarEx(
    UINT uiToolbarResID,
    CMFCToolBarInfo& params,
    BOOL bLocked=FALSE);

Parameter

uiToolbarResID
[in] Die Ressourcen-ID der Symbolleiste.

params
[in] Ein Verweis auf ein CMFCToolBarInfo Objekt, das die Ressourcen-IDs für die Symbolleistenbilder enthält.

bLocked
[in] Ein boolescher Wert, der angibt, ob die Symbolleiste gesperrt ist oder nicht. Wenn dieser Parameter lautet, ist TRUEdie Symbolleiste gesperrt. Andernfalls ist die Symbolleiste nicht gesperrt.

Rückgabewert

Ein Wert ungleich 0 (null), wenn die Methode erfolgreich ausgeführt wird, andernfalls 0 (null).

Hinweise

Rufen Sie diese Methode auf, um Symbolleistenbilder aus den Anwendungsressourcen zu laden.

`CMFCToolBar::m_dblLargeImageRatio`

Gibt das Verhältnis zwischen der Dimension (Höhe oder Breite) großer Bilder und der Dimension normaler Bilder an.

AFX_IMPORT_DATA static double m_dblLargeImageRatio;

Hinweise

Das Standardverhältnis ist 2. Sie können diesen Wert ändern, um große Symbolleistenbilder zu vergrößern oder zu verkleineren.

Das Framework verwendet dieses Datenelement, wenn Sie keine Gruppe großer Bilder angeben. Wenn Sie beispielsweise nur die Gruppe kleiner Bilder mit einer Größe von 16 x 16 bereitstellen und möchten, dass die großen Bilder die Größe 24 x 24 aufweisen, legen Sie dieses Datenelement auf 1,5 fest.

`CMFCToolBar::NextMenu`

virtual BOOL NextMenu();

Rückgabewert

Bemerkungen

`CMFCToolBar::OnBeforeRemoveButton`

virtual BOOL OnBeforeRemoveButton(
    CMFCToolBarButton* pButton,
    DROPEFFECT dropEffect);

Parameter

pButton
[in] Nicht verwendet.

dropEffect
[in] Nicht verwendet.

Rückgabewert

Bemerkungen

`CMFCToolBar::OnChangeHot`

Wird vom Framework aufgerufen, wenn ein Benutzer eine Schaltfläche auf der Symbolleiste auswählt.

virtual void OnChangeHot(int iHot);

Parameter

iHot
[in] Gibt den Index der ausgewählten Symbolleistenschaltfläche an. oder -1, wenn keine Symbolleistenschaltfläche ausgewählt ist.

Hinweise

Überschreiben Sie diese Methode, um Benachrichtigungen zu verarbeiten, die der Benutzer auf einer Symbolleiste ausgewählt hat.

`CMFCToolBar::OnChangeVisualManager`

virtual void OnChangeVisualManager();

Hinweise

`CMFCToolBar::OnFillBackground`

Vom Framework aufgerufen, um CBasePane::DoPaint den Symbolleistenhintergrund auszufüllen.

virtual void OnFillBackground(CDC* pDC);

Parameter

pDC
[in] Ein Zeiger auf einen Gerätekontext.

Hinweise

CMFCToolBar::DoPaint ruft diese Methode auf, wenn der Hintergrund einer Symbolleiste gefüllt wurde. Bei der Standardimplementierung wird keine Aktion ausgeführt.

Überschreiben Sie diese Methode, um benutzerdefinierten Hintergrund in abgeleiteten Klassen zu zeichnen.

`CMFCToolBar::OnGlobalFontsChanged`

virtual void OnGlobalFontsChanged();

Hinweise

`CMFCToolBar::OnReset`

Stellt die Symbolleiste im ursprünglichen Zustand wieder her.

virtual void OnReset();

Hinweise

Überschreiben Sie diese Methode, um Benachrichtigungen über eine Symbolleistenzurücksetzung zu behandeln.

Bei der Standardimplementierung wird keine Aktion ausgeführt. Überschreiben OnReset in einer Klasse, die abgeleitet wird CMFCToolBar , wenn die Symbolleiste Dummy-Schaltflächen enthält, die ersetzt werden müssen, wenn die Symbolleiste in den ursprünglichen Zustand zurückkehrt.

`CMFCToolBar::OnSetAccData`

virtual BOOL OnSetAccData(long lVal);

Parameter

[in] lVal\

Rückgabewert

Bemerkungen

`CMFCToolBar::OnSetDefaultButtonText`

Stellt den Text einer Symbolleistenschaltfläche im Standardzustand wieder her.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

Parameter

pButton
[in] Verweist auf eine Schaltfläche, deren Text festgelegt wird.

Rückgabewert

TRUE wenn der Text erfolgreich wiederhergestellt wurde; andernfalls FALSE.

Hinweise

Überschreiben Sie diese Methode zum Verarbeiten von Benachrichtigungen, dass der Text einer Symbolleistenschaltfläche in den Standardwert geändert wird.

Die Standardimplementierung lädt den Text einer Schaltfläche aus den Anwendungsressourcen.

`CMFCToolBar::OnUserToolTip`

Wird vom Framework aufgerufen, wenn die QuickInfo für eine Schaltfläche angezeigt werden soll.

virtual BOOL OnUserToolTip(
    CMFCToolBarButton* pButton,
    CString& strTTText) const;

Parameter

pButton
[in] Zeigt auf eine Symbolleistenschaltfläche, für die eine QuickInfo angezeigt werden soll.

strTTText
[out] Ein Verweis auf CString ein Objekt, das den Text der QuickInfo empfängt.

Rückgabewert

TRUE wenn strTTText mit QuickInfo-Text aufgefüllt wurde; andernfalls FALSE.

Hinweise

Das Framework ruft diese Methode auf, wenn die QuickInfo für eine Symbolleistenschaltfläche angezeigt wird. Wenn OnUserToolTip das Framework zurückgegeben TRUEwird, zeigt das Framework eine QuickInfo an, die den text enthält, der von OnUserToolTip in strTTText. Andernfalls enthält die QuickInfo den Schaltflächentext.

Überschreiben OnUserToolTip , um QuickInfos von Symbolleistenschaltflächen anzupassen. Die standardmäßigen Implementierungsaufrufe CMFCToolBar::OnUserToolTip zum Abrufen des QuickInfo-Texts.

`CMFCToolBar::PrevMenu`

virtual BOOL PrevMenu();

Rückgabewert

Bemerkungen

`CMFCToolBar::ProcessCommand`

Sendet eine WM_COMMAND Nachricht in das Fenster, das die Symbolleiste besitzt.

BOOL ProcessCommand(CMFCToolBarButton* pButton);

Parameter

pButton
[in] Zeigen Sie auf eine Schaltfläche auf der Symbolleiste.

Rückgabewert

Diese Methode sollte immer zurückgegeben werden TRUE. MFC verwendet FALSE Intern Werte.

Hinweise

Diese Methode sendet eine WM_COMMAND Nachricht an das Fenster, das die Symbolleiste besitzt, indem die Befehls-ID der angegebenen Schaltfläche als Parameter aufgerufen CWnd::PostMessage und übergeben wird wParam .

Verwenden Sie das ON_COMMAND Makro, um die WM_COMMAND Nachricht einer Memberfunktion zuzuordnen.

`CMFCToolBar::RemoveAllButtons`

Entfernt alle Schaltflächen und Trennzeichen aus der Symbolleiste.

virtual void RemoveAllButtons();

Hinweise

Das Framework ruft diese Methode auf, wenn sie eine Symbolleiste neu erstellt oder zerstört.

`CMFCToolBar::RemoveButton`

Entfernt die Schaltfläche, die den angegebenen Index enthält, aus der Symbolleiste.

virtual BOOL RemoveButton(int iIndex);

Parameter

iIndex
[in] Gibt den nullbasierten Index der zu entfernenden Schaltfläche an.

Rückgabewert

TRUE wenn die Methode erfolgreich ist oder FALSE der angegebene Index ungültig ist oder sich der Index auf die Schaltfläche "Anpassen" bezieht.

Hinweise

Diese Methode aktualisiert zusätzliche Symbolleistenattribute, die von der Entfernung der Schaltfläche betroffen sind. Mit dieser Methode werden beispielsweise nicht wesentliche Trennzeichen aus der Symbolleiste entfernt und die Tabelle mit Tastenkombinationen neu erstellt.

Weitere Informationen zur Schaltfläche "Anpassen " finden Sie unter CMFCToolBar::EnableCustomizeButton.

`CMFCToolBar::RemoveStateFromRegistry`

Löscht die Statusinformationen für die Symbolleiste aus der Windows-Registrierung.

virtual BOOL RemoveStateFromRegistry(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parameter

lpszProfileName
[in] Gibt den Registrierungsschlüssel an, in dem sich die Statusinformationen befinden.

nIndex
[in] Die Steuerelement-ID der Symbolleiste.

uiID
[in] Die Ressourcen-ID der Symbolleiste. Wenn dieser Parameter -1 lautet, verwendet diese Methode die CWnd::GetDlgCtrlID Methode, um die Ressourcen-ID abzurufen.

Rückgabewert

Ein Wert ungleich 0 (null), wenn die Methode erfolgreich ausgeführt wird, andernfalls 0 (null).

Hinweise

Das Framework ruft diese Methode auf, wenn sie eine benutzerdefinierte Symbolleiste löscht.

Überschreiben Sie diese Methode, wenn Sie zusätzliche Statusinformationen in der Windows-Registrierung speichern.

`CMFCToolBar::ReplaceButton`

Ersetzt eine Symbolleistenschaltfläche durch eine andere Symbolleistenschaltfläche.

int ReplaceButton(
    UINT uiCmd,
    const CMFCToolBarButton& button,
    BOOL bAll=FALSE);

Parameter

uiCmd
[in] Die Befehls-ID der zu ersetzenden Schaltfläche.

button
[in] Ein Verweis auf das CMFCToolBarButton einzufügende Objekt.

bAll
[in] Ein boolescher Wert, der angibt, ob alle Schaltflächen ersetzt werden sollen, für die die Befehls-ID angegeben ist uiCmd. Wenn dieser Parameter lautet TRUE, werden alle Schaltflächen mit der angegebenen Befehls-ID ersetzt. Andernfalls wird die erste Schaltfläche ersetzt.

Rückgabewert

Die Anzahl der Schaltflächen, die ersetzt werden. Diese Methode gibt 0 zurück, wenn auf der Symbolleiste keine Schaltfläche mit der angegebenen Befehls-ID vorhanden ist.

Hinweise

Rufen Sie diese Methode auf, wenn Sie Symbolleistenschaltflächen hinzufügen möchten, die nicht aus Ressourcen geladen werden können. Sie können zur Entwurfszeit eine Platzhalterschaltfläche erstellen und diese Schaltfläche durch eine benutzerdefinierte Schaltfläche ersetzen, wenn Sie die Symbolleiste initialisieren. Ein Beispiel, das diese Methode verwendet, finden Sie im VisualStudioDemo-Beispiel.

Beispiel

Im folgenden Beispiel wird die Verwendung der ReplaceButton Methode in der CMFCToolBar Klasse veranschaulicht. Dieser Codeausschnitt ist Teil des IE-Demobeispiels.

CMFCToolBar m_wndToolBar;

// CMenu menuHistory
// CString str
m_wndToolBar.ReplaceButton(ID_GO_BACK,
                           CMFCToolBarMenuButton(ID_GO_BACK, menuHistory,
                                                 GetCmdMgr()->GetCmdImage(ID_GO_BACK), str));

`CMFCToolBar::ResetAll`

Stellt alle Symbolleisten in ihren ursprünglichen Zuständen wieder her.

static void __stdcall ResetAll();

Hinweise

Diese Methode ruft die CMFCToolBar::RestoreOriginalState Methode auf jeder Symbolleiste in der Anwendung auf, die wiederhergestellt werden kann. Sie verwendet die CMFCToolBar::CanBeRestored Methode, um zu bestimmen, ob eine Symbolleiste wiederhergestellt werden kann.

`CMFCToolBar::ResetAllImages`

Löscht alle Symbolleistenbildsammlungen in der Anwendung.

static void __stdcall ResetAllImages();

Hinweise

Mit dieser Methode werden die Bildauflistungen gelöscht, die von den CMFCToolBar::LoadToolBar Methoden CMFCToolBar::LoadBitmap initialisiert werden.

`CMFCToolBar::ResetImages`

virtual void ResetImages();

Hinweise

`CMFCToolBar::RestoreFocus`

virtual void RestoreFocus();

Hinweise

`CMFCToolBar::RestoreOriginalState`

Stellt den originalen Zustand einer Symbolleiste wieder her.

virtual BOOL RestoreOriginalState();

Rückgabewert

TRUE wenn die Methode erfolgreich ist oder FALSE wenn die Methode fehlschlägt oder die Symbolleiste benutzerdefinierter ist.

Hinweise

Diese Methode lädt die Symbolleiste aus der Ressourcendatei mithilfe der CMFCToolBar::LoadToolBar Methode.

Das Framework ruft diese Methode auf, wenn der Benutzer auf der Symbolleistenseite eines Anpassungsdialogfelds die Schaltfläche "Alle zurücksetzen" auswähnt.

`CMFCToolBar::SaveParameters`

static BOOL __stdcall SaveParameters(LPCTSTR lpszProfileName = NULL);

Parameter

[in] lpszProfileName\

Rückgabewert

Bemerkungen

`CMFCToolBar::SaveState`

Speichert die Statusinformationen für die Symbolleiste in der Windows-Registrierung.

virtual BOOL SaveState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parameter

lpszProfileName
[in] Gibt den relativen Pfad des Windows-Registrierungsschlüssels an.

nIndex
[in] Die Steuerelement-ID der Symbolleiste.

uiID
[in] Die Ressourcen-ID der Symbolleiste.

Rückgabewert

Ein Wert ungleich 0 (null), wenn die Methode erfolgreich ausgeführt wird, andernfalls 0 (null).

Hinweise

Das Framework ruft diese Methode auf, wenn der Anwendungsstatus in der Registrierung gespeichert wird. Weitere Informationen finden Sie unter CWinAppEx::SaveState.

`CMFCToolBar::SetBasicCommands`

Legt die Liste der Befehle fest, die immer angezeigt werden, wenn ein Benutzer ein Menü öffnet.

static void __stdcall SetBasicCommands(CList<UINT,UINT>& lstCommands);

Parameter

lstCommands
[in] Ein Verweis auf ein CList Objekt, das eine Auflistung von Befehlen enthält.

Hinweise

Beim Öffnen des Menüs wird immer ein einfacher Befehl angezeigt. Diese Methode ist aussagekräftig, wenn der Benutzer die zuletzt verwendeten Befehle anzeigen möchte.

Verwenden Sie die CMFCToolBar::AddBasicCommand Methode, um der Liste der grundlegenden Befehle einen Befehl hinzuzufügen. Verwenden Sie die CMFCToolBar::GetBasicCommands Methode, um die Liste der grundlegenden Befehle abzurufen, die von Ihrer Anwendung verwendet werden.

Ein Beispiel, das diese Methode verwendet, finden Sie im Explorer-Beispiel.

`CMFCToolBar::SetButtonInfo`

Legt die Befehls-ID, den Stil und die Bild-ID einer Symbolleistenschaltfläche fest.

void SetButtonInfo(
    int nIndex,
    UINT nID,
    UINT nStyle,
    int iImage);

Parameter

nIndex
[in] Der nullbasierte Index der Schaltfläche, deren Eigenschaften festgelegt sind.

nID
[in] Die Befehls-ID der Schaltfläche.

nStyle
[in] Die Formatvorlage der Schaltfläche. Siehe Symbolleisten-Steuerelementformatvorlagen für die Liste der verfügbaren Symbolleistenschaltflächenformate.

iImage
[in] Der nullbasierte Bildindex der Schaltfläche (d. a. der Index in der Auflistung von Symbolleistenbildern).

Hinweise

Rufen Sie diese Methode auf, um die Eigenschaften einer Symbolleistenschaltfläche festzulegen.

In Debugbuilds generiert diese Methode einen Assertionsfehler, wenn der angegebene nIndex Index ungültig ist.

Rufen Sie die CMFCToolBar::SetButtonStyle Methode auf, um nur die Formatvorlage der Schaltfläche festzulegen.

`CMFCToolBar::SetButtons`

Legt die Schaltflächen für die Symbolleiste fest.

virtual BOOL SetButtons(
    const UINT* lpIDArray,
    int nIDCount,
    BOOL bRemapImages=TRUE);

Parameter

lpIDArray
[in] Ein Zeiger auf das Array von Befehls-IDs der einzufügenden Schaltflächen.

nIDCount
[in] Die Anzahl der Elemente in lpIDArray.

bRemapImages
[in] Ein boolescher Wert, der angibt, ob die vorhandenen Schaltflächenbilder den eingefügten Schaltflächen zugeordnet werden sollen. Wenn dieser Parameter lautet TRUE, werden die Bilder neu zugeordnet.

Rückgabewert

Ein Wert ungleich 0 (null), wenn die Methode erfolgreich ausgeführt wird, andernfalls 0 (null).

Hinweise

Rufen Sie diese Methode auf, um vorhandene Schaltflächen aus einer Symbolleiste zu entfernen und eine Sammlung neuer Schaltflächen einzufügen.

Diese Methode fügt der Symbolleiste die Schaltfläche "Anpassen " hinzu und sendet die AFX_WM_RESETTOOLBAR Nachricht an das übergeordnete Fenster der Symbolleiste. Weitere Informationen zur Schaltfläche "Anpassen " finden Sie unter CMFCToolBar::EnableCustomizeButton.

`CMFCToolBar::SetButtonStyle`

Legt die Formatvorlage der Symbolleistenschaltfläche am angegebenen Index fest.

virtual void SetButtonStyle(
    int nIndex,
    UINT nStyle);

Parameter

nIndex
[in] Der nullbasierte Index der Symbolleistenschaltfläche, deren Formatvorlage festgelegt werden soll.

nStyle
[in] Die Formatvorlage der Schaltfläche. Siehe Symbolleisten-Steuerelementformatvorlagen für die Liste der verfügbaren Symbolleistenschaltflächenformate.

Hinweise

Diese Methode entfernt die TBBS_PRESSED Formatvorlage, wenn nStyle dies der Fall ist TBBS_DISABLED , weil der Benutzer keine deaktivierte Schaltfläche auswählen kann.

`CMFCToolBar::SetButtonText`

Legt die Textbezeichnung einer Symbolleistenschaltfläche fest.

BOOL SetButtonText(
    int nIndex,
    LPCTSTR lpszText);

Parameter

nIndex
[in] Der Index der Symbolleistenschaltfläche.

lpszText
[in] Die Textbezeichnung der Symbolleistenschaltfläche. Darf nicht Null sein.

Rückgabewert

TRUE wenn die Methode erfolgreich ist; andernfalls FALSE.

Hinweise

Diese Methode gibt zurück FALSE , wenn der angegebene Index nicht auf eine gültige Symbolleistenschaltfläche verweist.

`CMFCToolBar::SetCommandUsageOptions`

Gibt an, wann selten verwendete Befehle nicht im Menü der Anwendung angezeigt werden.

static BOOL SetCommandUsageOptions(
    UINT nStartCount,
    UINT nMinUsagePercentage=5);

Parameter

nStartCount
[in] Gibt an, wie oft Befehle ausgeführt werden müssen, bevor das Framework nur die grundlegenden und zuletzt verwendeten Befehle anzeigt.

nMinUsagePercentage
[in] Der Prozentsatz der Zeit, in der ein Befehl ausgeführt werden muss, um als zuletzt verwendeter Befehl betrachtet zu werden.

Rückgabewert

FALSE ist nMinUsagePercentage gleich oder größer als 100; andernfalls TRUE.

Hinweise

Rufen Sie diese Methode auf, um den Algorithmus anzupassen, den das Framework verwendet, um zu bestimmen, wie einfache und zuletzt verwendete Menüelemente angezeigt werden. Weitere Informationen zu grundlegenden Befehlen finden Sie unter CMFCToolBar::AddBasicCommand.

Diese Klasse verwendet die CMFCCmdUsageCount Klasse, um die Anzahl der Befehle nachzuverfolgen. Weitere Informationen zu dieser Klasse finden Sie unter CMFCCmdUsageCount "Klasse".

`CMFCToolBar::SetCustomizeMode`

Aktiviert oder deaktiviert den Anpassungsmodus für alle Symbolleisten in der Anwendung.

static BOOL __stdcall SetCustomizeMode(BOOL bSet=TRUE);

Parameter

bSet
[in] Ein boolescher Wert, der angibt, ob der Anpassungsmodus aktiviert oder deaktiviert werden soll. Legen Sie diesen Parameter fest, um den Anpassungsmodus zu TRUE aktivieren oder FALSE ihn zu deaktivieren.

Rückgabewert

TRUE wenn durch Aufrufen dieser Methode der Anpassungsmodus geändert wird; andernfalls FALSE.

Hinweise

Mit dieser Methode wird das Layout der einzelnen Symbolleisten in der Anwendung angepasst und neu gezeichnet. Rufen Sie die CMFCToolBar::IsCustomizeMode Methode auf, um zu bestimmen, ob sich die Anwendung im Anpassungsmodus befindet.

`CMFCToolBar::SetGrayDisabledButtons`

Gibt an, ob nicht verfügbare Schaltflächen auf der Symbolleiste abgeblendet sind oder ob schaltflächenlose Bilder verwendet werden.

void SetGrayDisabledButtons(BOOL bGrayDisabledButtons);

Parameter

bGrayDisabledButtons
[in] Ein boolescher Wert, der angibt, wie nicht verfügbare Schaltflächen angezeigt werden. Wenn dieser Parameter lautet TRUE, werden die Schaltflächen vom Framework abgeblendet. Andernfalls verwendet das Framework die Sammlung von Schaltflächen nicht verfügbaren Bildern.

Hinweise

Standardmäßig sind nicht verfügbare Schaltflächen abgeblendet.

`CMFCToolBar::SetHeight`

Legt die Höhe der Symbolleiste fest.

void SetHeight(int cyHeight);

Parameter

cyHeight
[in] Die Höhe der Symbolleiste in Pixeln.

Hinweise

Mit dieser Methode wird die Symbolleiste neu gezeichnet, nachdem die Höhe festgelegt wurde.

`CMFCToolBar::SetHelpMode`

static void __stdcall SetHelpMode(BOOL bOn = TRUE);

Parameter

[in] bOn\

Hinweise

`CMFCToolBar::SetHot`

BOOL SetHot(CMFCToolBarButton* pMenuButton);

Parameter

[in] pMenuButton\

Rückgabewert

Bemerkungen

`CMFCToolBar::SetHotBorder`

Gibt an, ob Symbolleistenschaltflächen heiß nachverfolgt werden.

void SetHotBorder(BOOL bShowHotBorder);

Parameter

bShowHotBorder
[in] Ein boolescher Wert, der angibt, ob Symbolleistenschaltflächen im Hot-Track-Format nachverfolgt werden sollen. Wenn dieser Parameter lautet TRUE, verfolgt die Symbolleiste die zugehörigen Schaltflächen. Andernfalls verfolgt die Symbolleiste ihre Schaltflächen nicht mit dem Hottrack.

Hinweise

Wenn eine Schaltfläche hot-tracked ist, hebt das Framework die Schaltfläche hervor, wenn die Maus darauf bewegt wird. Standardmäßig verfolgt jede Symbolleiste ihre Schaltflächen.

Rufen Sie die CMFCToolBar::GetHotBorder Methode auf, um zu bestimmen, ob die Symbolleiste ihre Schaltflächen nachverfolgt.

`CMFCToolBar::SetHotTextColor`

Legt die Textfarbe für Hot Toolbar-Schaltflächen fest.

static void SetHotTextColor(COLORREF clrText);

Parameter

clrText
[in] Gibt die Textfarbe für Symbolleistenschaltflächen an, die heiß nachverfolgt werden.

Hinweise

Weitere Informationen zu Hot-Tracked-Symbolleistenschaltflächen finden Sie unter CMFCToolBar::GetHotBorder und CMFCToolBar::SetHotBorder.

`CMFCToolBar::SetIgnoreSetText`

void SetIgnoreSetText(BOOL bValue);

Parameter

[in] bValue\

Hinweise

`CMFCToolBar::SetLargeIcons`

Gibt an, ob Symbolleistenschaltflächen große Symbole anzeigen.

static void SetLargeIcons(BOOL bLargeIcons=TRUE);

Parameter

bLargeIcons
[in] Ein boolescher Wert, der angibt, welche Symbole verwendet werden sollen. Wenn dieser Parameter lautet TRUE, zeigt das Framework große Symbole an. Andernfalls zeigt das Framework reguläre Symbole an.

Hinweise

Das Framework ruft diese Methode auf, wenn der Benutzer den Status des Kontrollkästchens "Große Symbole " auf der Registerkarte "Optionen " des Dialogfelds "Anpassen " ändert. Diese Methode ändert die Größe aller Symbolleisten in der Anwendung.

Standardmäßig zeigt das Framework normale Symbole an.

Weitere Informationen zum Dialogfeld "Anpassen " finden Sie unter CMFCToolBarsCustomizeDialog "Klasse".

`CMFCToolBar::SetLockedSizes`

Legt die Größe von gesperrten Schaltflächen und gesperrten Bildern auf der Symbolleiste fest.

void SetLockedSizes(
    SIZE sizeButton,
    SIZE sizeImage,
    BOOL bDontScale = FALSE);

Parameter

sizeButton
[in] Gibt die Größe von gesperrten Symbolleistenschaltflächen an.

sizeImage
[in] Gibt die Größe von gesperrten Symbolleistenbildern an.

bDontScale
Gibt an, ob gesperrte Symbolleistenbilder im Modus mit hohem DPI-Wert skaliert werden sollen.

Hinweise

Die Standardgröße von gesperrten Schaltflächen beträgt 23 x 22 Pixel. Die Standardgröße gesperrter Bilder beträgt 16 x 15 Pixel.

Rufen Sie die CMFCToolBar::GetLockedImageSize Methode auf, um die Größe gesperrter Bilder abzurufen. Rufen Sie die CMFCToolBar::GetButtonSize Methode auf, um die Größe von gesperrten Symbolleistenschaltflächen abzurufen.

`CMFCToolBar::SetMaskMode`

void SetMaskMode(BOOL bMasked);

Parameter

[in] bMasked\

Hinweise

`CMFCToolBar::SetMenuSizes`

Legt die Größe der Symbolleistenmenüschaltflächen und deren Bilder fest.

static void __stdcall SetMenuSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Parameter

sizeButton
[in] Gibt die Größe von Symbolleistenschaltflächen in Pixel an.

sizeImage
[in] Gibt die Größe von Symbolleistenbildern in Pixeln an.

Hinweise

Standardmäßig weisen Menüschaltflächen und deren Bilder eine nicht definierte Größe auf.

Rufen Sie die CMFCToolBar::GetMenuButtonSize Methode auf, um die Größe von Menüschaltflächen und die CMFCToolBar::GetMenuImageSize Methode zum Bestimmen der Größe von Menüschaltflächenbildern zu bestimmen.

Beispiele, die diese Methode verwenden, finden Sie in den IEDemo- und MSMoneyDemo-Beispielen.

`CMFCToolBar::SetNonPermittedCommands`

Legt die Liste der Befehle fest, die vom Benutzer nicht ausgeführt werden können.

static void SetNonPermittedCommands(CList<UINT,UINT>& lstCommands);

Parameter

lstCommands
[in] Ein Verweis auf ein CList Objekt, das die Befehle enthält, die vom Benutzer nicht ausgeführt werden können.

Hinweise

Rufen Sie diese Methode auf, um zu verhindern, dass der Benutzer bestimmte Befehle auswählt. Sie können z. B. verhindern, dass der Benutzer bestimmte Befehle aus Sicherheitsgründen auswählt. Beispiele, die diese Methode verwenden, finden Sie in den Beispielen "MDITabsDemo" und "MenuSubSet".

Diese Methode löscht die vorherige Liste der nicht zulässigen Befehle. Standardmäßig ist die Liste der nicht zulässigen Befehle leer.

`CMFCToolBar::SetOneRowWithSibling`

Positioniert die Symbolleiste und das gleichgeordnete Element in derselben Zeile.

void SetOneRowWithSibling();

Hinweise

Das Framework ruft diese Methode auf, wenn der Benutzer die Schaltfläche "Schaltflächen anzeigen" in einer Zeile auswählt.

Rufen Sie die CMFCToolBar::SetSiblingToolBar Methode auf, um die Schaltflächen "Anzeigen" in einer Zeile oder "Schaltflächen anzeigen" auf zwei Zeilenschaltflächen zu aktivieren. Wenn Sie diese Symbolleiste aufrufen CMFCToolBar::SetSiblingToolBar , wird die gleichgeordnete Symbolleiste in die Zeile dieser Symbolleiste verschoben. Andernfalls wird diese Symbolleiste in die Zeile des gleichgeordneten Element verschoben.

Das Framework ruft die CMFCToolBar::SetTwoRowsWithSibling Methode auf, wenn der Benutzer die Schaltflächen anzeigen in zwei Zeilen auswählt.

`CMFCToolBar::SetOrigButtons`

void SetOrigButtons(const CObList& lstOrigButtons);

Parameter

[in] lstOrigButtons\

Hinweise

`CMFCToolBar::SetPermament`

Gibt an, ob ein Benutzer die Symbolleiste schließen kann.

void SetPermament(BOOL bPermament=TRUE);

Parameter

bPermament
[in] Ein boolescher Wert, der angibt, ob ein Benutzer die Symbolleiste schließen kann. Wenn dieser Parameter lautet TRUE, kann ein Benutzer die Symbolleiste nicht schließen. Andernfalls kann ein Benutzer die Symbolleiste schließen.

Hinweise

Standardmäßig kann ein Benutzer jede Symbolleiste schließen.

Rufen Sie die CMFCToolBar::CanBeClosed Methode auf, um zu ermitteln, ob ein Benutzer die Symbolleiste schließen kann.

`CMFCToolBar::SetRouteCommandsViaFrame`

Gibt an, ob der übergeordnete Frame oder der Besitzer Befehle an die Symbolleiste sendet.

void SetRouteCommandsViaFrame(BOOL bValue);

Parameter

bValue
[in] Wenn dieser Parameter lautet TRUE, sendet der übergeordnete Frame Befehle an die Symbolleiste. Andernfalls sendet der Besitzer Befehle an die Symbolleiste.

Hinweise

Standardmäßig sendet der übergeordnete Frame Befehle an die Symbolleiste. Rufen Sie die CMFCToolBar::GetRouteCommandsViaFrame Methode auf, um zu bestimmen, ob der übergeordnete Frame oder der Besitzer Befehle an die Symbolleiste sendet.

`CMFCToolBar::SetShowTooltips`

Gibt an, ob das Framework QuickInfos anzeigt.

static void SetShowTooltips(BOOL bValue);

Parameter

bValue
[in] Wenn dieser Parameter lautet TRUE, zeigt das Framework QuickInfos an. Andernfalls blendet das Framework QuickInfos aus.

Hinweise

Standardmäßig zeigt das Framework QuickInfos an.

Rufen Sie die CMFCToolBar::GetShowTooltips Methode auf, um zu ermitteln, ob das Framework QuickInfos anzeigt.

`CMFCToolBar::SetSiblingToolBar`

Gibt das gleichgeordnete Element der Symbolleiste an.

void SetSiblingToolBar(CMFCToolBar* pBrotherToolbar);

Parameter

pBrotherToolbar
[in] Ein Zeiger auf die gleichgeordnete Symbolleiste.

Hinweise

Diese Methode aktiviert die Schaltflächen "Schaltflächen anzeigen" in einer Zeile oder "Schaltflächen anzeigen" auf zwei Zeilenschaltflächen , die angezeigt werden, wenn der Benutzer das Popupmenü "Anpassen " anzeigt. Rufen Sie diese Methode auf, wenn Sie es dem Benutzer ermöglichen möchten, anzugeben, ob verwandte Symbolleisten in derselben Zeile oder in verschiedenen Zeilen angezeigt werden.

Rufen Sie diese Methode auf, nachdem Sie die Schaltfläche "Anpassen " aktiviert haben, die auf der Symbolleiste angezeigt wird. Rufen Sie die Methode auf, um die CMFCToolBar::EnableCustomizeButton Schaltfläche "Anpassen" zu aktivieren.

Rufen Sie auf CMFCToolBar::GetSiblingToolBar, um das gleichgeordnete Element einer Symbolleiste abzurufen.

`CMFCToolBar::SetSizes`

Gibt die Größe von Schaltflächen und Bildern auf allen Symbolleisten an.

static void __stdcall SetSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Parameter

sizeButton
[in] Die Größe von Symbolleistenschaltflächen in Pixeln.

sizeImage
[in] Die Größe der Schaltflächenbilder der Symbolleiste in Pixel.

Hinweise

Die Standardgröße von Symbolleistenschaltflächen beträgt 23 x 22 Pixel. Die Standardgröße von Symbolsymbolsymbolen beträgt 16 x 15 Pixel.

Rufen Sie die CMFCToolBar::GetImageSize Methode auf, um die Größe von Schaltflächenbildern der Symbolleiste abzurufen. Rufen Sie die CMFCToolBar::GetButtonSize Methode auf, um die Größe von Symbolleistenschaltflächen abzurufen.

`CMFCToolBar::SetToolBarBtnText`

Gibt die Eigenschaften einer Schaltfläche auf der Symbolleiste an.

void SetToolBarBtnText(
    UINT nBtnIndex,
    LPCTSTR szText=NULL,
    BOOL bShowText=TRUE,
    BOOL bShowImage=TRUE);

Parameter

nBtnIndex
[in] Der nullbasierte Index der Symbolleistenschaltfläche in der Liste der Symbolleistenschaltflächen.

szText
[in] Gibt die Textbezeichnung der Symbolleistenschaltfläche an.

bShowText
[in] Wenn dieser Parameter lautet TRUE, zeigt das Framework die Beschriftung an. Andernfalls blendet das Framework die Beschriftung aus.

bShowImage
[in] Wenn dieser Parameter lautet TRUE, zeigt das Framework das Symbol für die Symbolleistenschaltfläche an. Andernfalls blendet das Framework das Symbol für die Symbolleistenschaltfläche aus.

Hinweise

Standardmäßig zeigt das Framework die Bilder von Symbolleistenschaltflächen an, zeigt jedoch nicht die Beschriftung von Symbolleistenschaltflächen an.

In Debugbuilds generiert diese Methode einen Assertionsfehler, wenn nBtnIndex kein Verweis auf eine gültige Symbolleistenschaltfläche oder die Symbolleistenschaltfläche ein Trennzeichen ist.

`CMFCToolBar::SetTwoRowsWithSibling`

Positioniert die Symbolleiste und das gleichgeordnete Element in separaten Zeilen.

void SetTwoRowsWithSibling();

Hinweise

Das Framework ruft diese Methode auf, wenn der Benutzer die Schaltfläche "Schaltflächen anzeigen" auf der Schaltfläche "Zwei Zeilen " auswählt.

Rufen Sie die CMFCToolBar::SetSiblingToolBar Methode auf, um die Schaltflächen "Anzeigen" in einer Zeile oder "Schaltflächen anzeigen" auf zwei Zeilenschaltflächen zu aktivieren. Wenn Sie diese Symbolleiste aufrufen CMFCToolBar::SetSiblingToolBar , wird die gleichgeordnete Symbolleiste in eine separate Zeile verschoben. Andernfalls wird diese Symbolleiste in eine separate Zeile verschoben.

Das Framework ruft die CMFCToolBar::SetOneRowWithSibling Methode auf, wenn der Benutzer die Schaltflächen anzeigen in einer Zeile auswählt.

`CMFCToolBar::SetUserImages`

Legt die Auflistung benutzerdefinierter Bilder in der Anwendung fest.

static BOOL SetUserImages(CMFCToolBarImages* pUserImages);

Parameter

pUserImages
[in] Ein Zeiger auf die Sammlung von benutzerdefinierten Bildern.

Rückgabewert

Nonzero, wenn die Methode erfolgreich ist; andernfalls 0, wenn das angegebene CMFCToolBarImages Objekt ungültig ist oder eine Bildgröße aufweist, die sich von der Standardbildgröße der Symbolleiste unterscheidet.

Hinweise

Das Framework verwendet benutzerdefinierte Bilder, um Symbolleistenschaltflächen zu zeichnen, die vom Benutzer angepasst werden. Die von pUserImages ihnen angegebene Bildliste wird für alle Symbolleisten in der Anwendung freigegeben.

Diese Methode generiert einen Assertionsfehler in Debugbuilds, wenn das angegebene CMFCToolBarImages Objekt ungültig ist oder eine Bildgröße aufweist, die sich von der Standardbildgröße der Symbolleiste unterscheidet.

Die Beispiele "OutlookDemo", "ToolTipDemo" und "VisualStudioDemo" verwenden diese Methode, um die globale Sammlung von benutzerdefinierten Bildern festzulegen. Sie laden die Datei mit dem Namen UserImages.bmp, die sich im Arbeitsverzeichnis der Anwendung befindet.

Rufen Sie die 'CMFCToolBar::GetUserImages-Methode auf, um die Sammlung von benutzerdefinierten Bildern in der Anwendung abzurufen.

`CMFCToolBar::StretchPane`

Streckt die Symbolleiste vertikal oder horizontal und positioniert die Schaltflächen bei Bedarf neu.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Parameter

nLength
[in] Die Menge in Pixel, um die der Bereich gestreckt werden soll.

bVert
[in] Wenn TRUE, wird der Bereich vertikal gestreckt. Wenn FALSE, wird der Bereich horizontal gestreckt.

Rückgabewert

Ein CSize Objekt, das die Größe des Symbolleistenclientbereichs angibt.

Hinweise

Diese Methode ruft CMFCToolBar::WrapToolBar auf, um die Schaltflächen in der gestreckten Symbolleiste neu zu positionieren.

Der Rückgabewert wird durch Aufrufen CMFCToolBar::CalcSizebestimmt.

`CMFCToolBar::TranslateChar`

Führt einen Schaltflächenbefehl aus, wenn der angegebene Tastencode einer gültigen Tastenkombination entspricht.

virtual BOOL TranslateChar(UINT nChar);

Parameter

nChar
[in] Gibt einen virtuellen Schlüsselcode an. Eine Liste der standardmäßigen virtuellen Schlüsselcodes finden Sie unter Winuser.h

Rückgabewert

FALSE wenn der angegebene Tastencode entweder nicht druckbar ist oder nicht einer gültigen Tastenkombination entspricht; TRUE wenn der angegebene Schlüsselcode einer Dropdownmenüoption entspricht; andernfalls der Rückgabewert von CMFCToolBar::ProcessCommand.

Hinweise

Das Framework ruft diese Methode auf, wenn eine Taste zusammen mit der ALT-TASTE gedrückt wird.

`CMFCToolBar::UpdateButton`

Aktualisiert den Status der angegebenen Schaltfläche.

void UpdateButton(int nIndex);

Parameter

nIndex
[in] Gibt den nullbasierten Index der zu aktualisierenden Schaltfläche an.

Hinweise

`CMFCToolBar::WrapToolBar`

Positioniert Symbolleistenschaltflächen innerhalb der angegebenen Dimensionen neu.

int WrapToolBar(
    int nWidth,
    int nHeight = 32767,
    CDC* pDC = NULL,
    int nColumnWidth = -1,
    int nRowHeight = -1);

Parameter

nWidth
[in] Maximale Breite der Symbolleiste.

nHeight
[in] Maximale Höhe der Symbolleiste. Wird nicht verwendet, wenn die Symbolleiste unverankert ist.

pDC
[in] Zeiger auf einen Gerätekontext. Wenn NULLder Gerätekontext für die Symbolleiste verwendet wird.

nColumnWidth
[in] Schaltflächenbreite. Bei -1 wird die aktuelle Breite verwendet.

[in] m nRowHeight Schaltflächenhöhe. Bei -1 wird die aktuelle Höhe verwendet.

Rückgabewert

Die Anzahl der Zeilen mit Schaltflächen auf der Symbolleiste.

Hinweise

Mit dieser Methode werden Schaltflächen innerhalb der Symbolleiste neu positioniert, schaltflächen werden bei Bedarf in zusätzliche Zeilen umbrochen.

`CMFCToolBar::m_bDontScaleImages`

Gibt an, ob Symbolleistenbilder im Modus mit hohem DPI-Wert skaliert werden sollen. Legen Sie fest, um die Bildskalierung zu TRUE verhindern, wenn eine Bildgröße nicht mit einer Schaltflächengröße übereinstimmt.

AFX_IMPORT_DATA static BOOL m_bDontScaleImages;

Siehe auch

Hierarchiediagramm
Klassen
CMFCMenuBar Klasse
CMFCPopupMenuBar Klasse
CMFCDropDownToolBar Klasse
Exemplarische Vorgehensweise: Steuerelemente in eine Symbolleiste einfügen

Freigeben über

CMFCToolBar-Klasse

Syntax

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Geschützte Methoden

Datenelemente

Hinweise

Beispiel

Anforderungen

Vererbungshierarchie

CMFCToolBar::AddBasicCommand

Parameter

Hinweise

CMFCToolBar::AddCommandUsage

Parameter

Hinweise

CMFCToolBar::AddToolBarForImageCollection

Parameter

Rückgabewert

Hinweise

CMFCToolBar::AdjustLayout

Hinweise

CMFCToolBar::AdjustSize

Hinweise

CMFCToolBar::AllowChangeTextLabels

Rückgabewert

Hinweise

CMFCToolBar::AllowShowOnList

Rückgabewert

Hinweise

CMFCToolBar::AreTextLabels

Rückgabewert

Hinweise

CMFCToolBar::AutoGrayInactiveImages

Parameter

Hinweise

CMFCToolBar::ButtonToIndex

Parameter

Rückgabewert

CMFCToolBar::CalcFixedLayout

Parameter

Rückgabewert

Hinweise

CMFCToolBar::CalcMaxButtonHeight

Rückgabewert

Hinweise

CMFCToolBar::CalcSize

Parameter

Rückgabewert

Hinweise

CMFCToolBar::CanBeClosed

Rückgabewert

Hinweise

CMFCToolBar::CanBeRestored

Rückgabewert

Hinweise

CMFCToolBar::CanFocus

Rückgabewert

Hinweise

CMFCToolBar::CanHandleSiblings

Rückgabewert

Hinweise

CMFCToolBar::CleanUpImages

Hinweise

CMFCToolBar::CleanUpLockedImages

Hinweise

CMFCToolBar::CommandToIndex

Parameter

Rückgabewert

Hinweise

CMFCToolBar::Create

Parameter

Rückgabewert

Hinweise

CMFCToolBar::CreateEx

Parameter

Rückgabewert

Hinweise

`CMFCToolBar`-Klasse

`CMFCToolBar::AddBasicCommand`

`CMFCToolBar::AddCommandUsage`

`CMFCToolBar::AddToolBarForImageCollection`

`CMFCToolBar::AdjustLayout`

`CMFCToolBar::AdjustSize`

`CMFCToolBar::AllowChangeTextLabels`

`CMFCToolBar::AllowShowOnList`

`CMFCToolBar::AreTextLabels`

`CMFCToolBar::AutoGrayInactiveImages`

`CMFCToolBar::ButtonToIndex`

`CMFCToolBar::CalcFixedLayout`

`CMFCToolBar::CalcMaxButtonHeight`

`CMFCToolBar::CalcSize`

`CMFCToolBar::CanBeClosed`

`CMFCToolBar::CanBeRestored`

`CMFCToolBar::CanFocus`

`CMFCToolBar::CanHandleSiblings`

`CMFCToolBar::CleanUpImages`

`CMFCToolBar::CleanUpLockedImages`

`CMFCToolBar::CommandToIndex`

`CMFCToolBar::Create`

`CMFCToolBar::CreateEx`

`CMFCToolBar::Deactivate`

`CMFCToolBar::DoPaint`

`CMFCToolBar::DrawButton`

`CMFCToolBar::DrawSeparator`

`CMFCToolBar::EnableCustomizeButton`

`CMFCToolBar::EnableDocking`

`CMFCToolBar::EnableLargeIcons`

`CMFCToolBar::EnableQuickCustomization`

`CMFCToolBar::EnableReflections`

`CMFCToolBar::EnableTextLabels`

`CMFCToolBar::FromHandlePermanent`

`CMFCToolBar::GetAllButtons`

`CMFCToolBar::GetAllToolbars`

`CMFCToolBar::GetBasicCommands`

`CMFCToolBar::GetButton`

`CMFCToolBar::GetButtonInfo`

`CMFCToolBar::GetButtonSize`

`CMFCToolBar::GetButtonStyle`

`CMFCToolBar::GetButtonText`

`CMFCToolBar::GetColdImages`

`CMFCToolBar::GetColumnWidth`

`CMFCToolBar::GetCommandButtons`

`CMFCToolBar::GetCount`