CMFCToolBar-Klasse

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 Standard Frame. (Ü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:

1. Fügen Sie dem Standard Rahmenfenster ein CMFCToolBar Objekt hinzu.

2. Wenn Sie die WM_CREATE Nachricht für das Standard Framefenster verarbeiten, rufen Sie entweder CMFCToolBar::Create die Symbolleiste auf, oder CMFCToolBar::CreateEx erstellen Sie die Symbolleiste, und geben Sie die Formatvorlage an.

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

Headerafxtoolbar.h:

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

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 Standard enthält 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 Standard Frame.

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 nIDnStyle, 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;

Parameter

nIndex
[in] Der Index einer Symbolleistenschaltfläche.

rString
[out] Der Beschriftungstext der Symbolleistenschaltfläche.

Rückgabewert

Der Beschriftungstext der Symbolleistenschaltfläche.

Hinweise

Rufen Sie CMFCToolBar::SetButtonText die Beschriftung auf, oder CMFCToolBar::SetToolBarBtnText legen Sie sie fest.

CMFCToolBar::GetColdImages

Gibt einen Zeiger auf die Auflistung der Bilder der kalten Symbolleistenschaltfläche in der Anwendung zurück.

static CMFCToolBarImages* GetColdImages();

Rückgabewert

Ein Zeiger auf die Sammlung von Bildern mit kalten Symbolleistenschaltflächen.

Hinweise

Kalte Bilder sind die Bilder, die verwendet werden, wenn der Benutzer nicht mit den Symbolleistenschaltflächen interagiert. Rufen Sie CMFCToolBar::LoadBitmapEx die kalten Bilder auf, oder CMFCToolBar::LoadBitmap laden Sie sie.

CMFCToolBar::GetColumnWidth

Gibt die Breite der Symbolleistenschaltflächen zurück.

virtual int GetColumnWidth() const;

Rückgabewert

Ein Wert, der die Breite von Symbolleistenschaltflächen angibt.

Hinweise

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

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

uiID
[in] Gibt die Befehls-ID der Schaltfläche an.

Rückgabewert

Der Index des Symbolleistenbilds in der freigegebenen Liste der Bilder.

Hinweise

Verwenden Sie diese freigegebene Methode, um den Index des Standardbilds für eine Symbolleistenschaltfläche mit der angegebenen Befehls-ID abzurufen. Der Rückgabewert ist ein Index in der freigegebenen Sammlung von Symbolleistenschaltflächenbildern für alle Symbolleisten in der Anwendung. Rufen Sie die CMFCToolBar::GetImages Methode auf, um einen Zeiger auf diese Auflistung abzurufen.

CMFCToolBar::GetDisabledImages

Gibt einen Zeiger auf die Auflistung von Bildern zurück, die für deaktivierte Symbolleistenschaltflächen in der Anwendung verwendet werden.

static CMFCToolBarImages* __stdcall GetDisabledImages();

Rückgabewert

Ein Zeiger auf die Sammlung deaktivierter Symbolleistenschaltflächenbilder.

Hinweise

Laden Sie die Bilder der deaktivierten Symbolleistenschaltfläche mithilfe der CMFCToolBarEditBoxButton Klassen- und CMFCToolBar::LoadBitmap Methoden.

CMFCToolBar::GetDisabledMenuImages

Gibt einen Zeiger auf die Auflistung von Bildern zurück, die für deaktivierte Menüschaltflächen in der Anwendung verwendet werden.

static CMFCToolBarImages* __stdcall GetDisabledMenuImages();

Rückgabewert

Ein Zeiger auf die Sammlung deaktivierter Menübilder.

Hinweise

Laden Sie die deaktivierten Bilder mithilfe der CMFCToolBarEditBoxButton Class-Methode .

CMFCToolBar::GetDroppedDownMenu

Ruft einen Zeiger auf das Menüschaltflächenobjekt ab, das derzeit sein Untermenü anzeigt.

CMFCToolBarMenuButton* GetDroppedDownMenu(int* pIndex = NULL) const;

Parameter

pIndex
[out] Empfängt den Index der Schaltfläche in der Sammlung von Symbolleistenschaltflächen.

Rückgabewert

Ein Zeiger auf das Menüschaltfläche-Objekt, das das Untermenü anzeigt oder NULL wenn kein Menü das Untermenü anzeigt.

Hinweise

Wenn diese Methode einen Ungleich-Null-Wert zurückgibt und pIndex nicht NULL, wird der wert, auf den verwiesen pIndex wird, auf den Index der Menüschaltfläche in der Auflistung der Symbolleistenschaltflächen festgelegt.

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.

BOOL GetGrayDisabledButtons() const;

Rückgabewert

TRUE um die Bilder deaktivierter Schaltflächen abzublenden; FALSE um Bilder aus der Sammlung deaktivierter Bilder abzurufen.

Hinweise

Wird verwendet CMFCToolBar::SetGrayDisabledButtons , um zwischen abgeblendeten Bildern und den Bildern aus der Sammlung deaktivierter Bilder zu wechseln.

CMFCToolBar::GetHighlightedButton

Gibt einen Zeiger auf die Symbolleistenschaltfläche zurück, die derzeit hervorgehoben ist.

CMFCToolBarButton* GetHighlightedButton() const;

Rückgabewert

Ein Zeiger auf ein Symbolleistenschaltflächenobjekt; oder NULL wenn keine Schaltfläche hervorgehoben ist.

Hinweise

Eine Symbolleistenschaltfläche wird hervorgehoben, wenn sie den Tastaturfokus hat. Außerdem wird eine Symbolleistenschaltfläche hervorgehoben, wenn die Symbolleistenschaltflächen in dieser Anwendung (weitere Informationen, siehe CMFCToolBar::GetHotBorder und CMFCToolBar::SetHotBorder) nachverfolgt werden und die Maus darauf zeigt, wenn keine Symbolleistenschaltfläche oder kein Menüelement den Tastaturfokus hat.

CMFCToolBar::GetHotBorder

Bestimmt, ob die Symbolleistenschaltflächen hot-tracked sind. Wenn eine Schaltfläche hot-tracked ist, wird sie hervorgehoben, wenn die Maus über sie bewegt wird.

BOOL GetHotBorder() const;

Rückgabewert

TRUEwenn die Symbolleistenschaltflächen hot-tracked sind; andernfalls . FALSE

Hinweise

Standardmäßig sind Symbolleistenschaltflächen hottracked.

CMFCToolBar::GetHotTextColor

Gibt die Textfarbe der hervorgehobenen Symbolleistenschaltflächen zurück.

static COLORREF GetHotTextColor();

Rückgabewert

Ein COLORREF Wert, der die aktuelle hervorgehobene Textfarbe darstellt.

Hinweise

Rufen Sie auf CMFCToolBar::SetHotTextColor , um eine neue Textfarbe für hervorgehobene Symbolleistenschaltflächen festzulegen.

CMFCToolBar::GetHwndLastFocus

Gibt ein Handle an das Fenster zurück, das den Eingabefokus direkt vor der Symbolleiste hatte.

HWND GetHwndLastFocus() const;

Rückgabewert

Ein Handle zu Fenstern, das nicht von CMFCBaseToolBar der Klasse abgeleitet ist, die zuvor den Eingabefokus hatte, oder NULL wenn kein solches Fenster vorhanden ist.

Hinweise

Wenn ein CMFCToolBar Steuerelement den Eingabefokus empfängt, speichert es ein Handle für das Fenster, das den Fokus verloren hat, damit es später wiederhergestellt werden kann.

CMFCToolBar::GetIgnoreSetText

Gibt an, ob Aufrufe zum Festlegen von Schaltflächenbeschriftungen ignoriert werden.

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.

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

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.

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.

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 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 Standard als globale Variable beibehalten 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 Standard enthalten sind. 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] mnRowHeight 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