CMFCToolBar-klasse

De CMFCToolBar klasse lijkt op CToolBar Klasse, maar biedt extra ondersteuning voor functies van de gebruikersinterface. Deze omvatten platte werkbalken, werkbalken met dynamische afbeeldingen, grote pictogrammen, pagerknoppen, vergrendelde werkbalken, besturingselementen voor opnieuw balken, tekst onder afbeeldingen, achtergrondafbeeldingen en werkbalken met tabbladen. De CMFCToolBar-klasse bevat ook ingebouwde ondersteuning voor het aanpassen van werkbalken en menu's door gebruikers, slepen en neerzetten tussen werkbalken en menu's, keuzelijstknoppen met invoervak, knoppen voor invoervak, kleurkiezers en samengetelde knoppen.

Zie de broncode in uw Visual Studio-installatie voor meer informatie, bijvoorbeeld %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Syntaxis

class CMFCToolBar : public CMFCBaseToolBar

Leden

Openbare constructors

Naam	Beschrijving
CMFCToolBar::CMFCToolBar	Standaardconstructor.
CMFCToolBar::~CMFCToolBar	Destructor.

Openbare methoden

Naam	Beschrijving
CMFCToolBar::AddBasicCommand	Hiermee voegt u een menuopdracht toe aan de lijst met opdrachten die altijd worden weergegeven wanneer een gebruiker een menu opent.
CMFCToolBar::AddCommandUsage	Hiermee wordt één teller verhoogd die is gekoppeld aan de opgegeven opdracht.
CMFCToolBar::AddToolBarForImageCollection	Voegt afbeeldingen van de resources van de gebruikersinterface toe aan de verzameling afbeeldingen in de toepassing.
CMFCToolBar::AdjustLayout	Berekent de grootte en positie van een werkbalk opnieuw. (Onderdrukkingen CBasePane::AdjustLayout).
CMFCToolBar::AdjustSize	Berekent de grootte van de werkbalk opnieuw.
CMFCToolBar::AllowChangeTextLabels	Hiermee geeft u op of tekstlabels kunnen worden weergegeven onder afbeeldingen op de werkbalkknoppen.
CMFCToolBar::AreTextLabels	Hiermee geeft u op of tekstlabels onder afbeeldingen momenteel worden weergegeven op de werkbalkknoppen.
CMFCToolBar::AutoGrayInactiveImages	Hiermee schakelt u het automatisch genereren van inactieve knopafbeeldingen in of uit.
CMFCToolBar::ButtonToIndex	Retourneert de index van een opgegeven CMFCToolBarButton Class-object in deze werkbalk.
CMFCToolBar::CalcFixedLayout	Berekent de horizontale grootte van de werkbalk. (Overschrijft CBasePane::CalcFixedLayout.)
CMFCToolBar::CalcSize	Aangeroepen door het framework als onderdeel van het indelingsberekeningsproces. (Overschrijft CPane::CalcSize.)
CMFCToolBar::CanHandleSiblings	Hiermee bepaalt u of de werkbalk en het bijbehorende niveau op hetzelfde deelvenster staan.
CMFCToolBar::CleanUpImages	Hiermee worden de systeembronnen vrijgemaakt die zijn toegewezen voor werkbalkafbeeldingen.
CMFCToolBar::CleanUpLockedImages	Hiermee worden de systeembronnen vrijgemaakt die zijn toegewezen voor vergrendelde werkbalkinstallatiekopieën.
CMFCToolBar::CanBeClosed	Hiermee geeft u op of een gebruiker de werkbalk kan sluiten. (Overschrijft CBasePane::CanBeClosed.)
CMFCToolBar::CanBeRestored	Bepaalt of het systeem na aanpassing een werkbalk naar de oorspronkelijke staat kan herstellen.
CMFCToolBar::CanFocus	Hiermee geeft u op of het deelvenster de focus kan ontvangen. (Overschrijft CBasePane::CanFocus.)
CMFCToolBar::CanHandleSiblings	Hiermee bepaalt u of de werkbalk en het bijbehorende niveau op hetzelfde deelvenster staan.
CMFCToolBar::CommandToIndex	Retourneert de index van de knop op de werkbalk met een opgegeven opdracht-id.
CMFCToolBar::Create	Hiermee maakt u een CMFCToolBar-object.
CMFCToolBar::CreateEx	Hiermee maakt u een CMFCToolBar-object dat gebruikmaakt van extra stijlopties, zoals grote pictogrammen.
CMFCToolBar::Deactivate	Hiermee wordt de werkbalk gedeactiveerd.
CMFCToolBar::EnableCustomizeButton	Hiermee schakelt u de knoppen toevoegen of verwijderen in of uit knop die wordt weergegeven aan het einde van de werkbalk.
CMFCToolBar::EnableDocking	Hiermee kunt u het deelvenster aan het hoofdframe koppelen. (Overschrijft CBasePane::EnableDocking.)
CMFCToolBar::EnableLargeIcons	Hiermee schakelt u grote pictogrammen op werkbalkknoppen in of uit.
CMFCToolBar::EnableQuickCustomization	Hiermee schakelt u de snelle aanpassing van werkbalken in of uit, zodat de gebruiker op de Alt-toets kan drukken en een knop naar een nieuwe locatie kan slepen.
CMFCToolBar::EnableReflections	Hiermee schakelt u de weerspiegeling van opdrachten in of uit.
CMFCToolBar::EnableTextLabels	Hiermee schakelt u tekstlabels onder afbeeldingen van werkbalkknoppen in of uit.
CMFCToolBar::FromHandlePermanent	Hiermee wordt een aanwijzer opgehaald naar het CMFCToolBar-object dat de opgegeven venstergreep bevat.
CMFCToolBar::GetAllButtons	Retourneert een alleen-lezen lijst met knoppen op een werkbalk.
CMFCToolBar::GetAllToolbars	Retourneert een alleen-lezen lijst met alle werkbalken in de toepassing.
CMFCToolBar::GetBasicCommands	Retourneert een lijst met alleen-lezen opdrachten die zijn gedefinieerd in de toepassing.
CMFCToolBar::GetButton	Retourneert een aanwijzer naar het CMFCToolBarButton-object met een opgegeven werkbalkknopindex.
CMFCToolBar::GetButtonInfo	Retourneert de opdracht-id, stijl en afbeeldingsindex van de knop bij een opgegeven index.
CMFCToolBar::GetButtonSize	Retourneert de afmetingen van elke knop op de werkbalk.
CMFCToolBar::GetButtonStyle	Retourneert de huidige stijl van de werkbalkknop die zich in de opgegeven index bevindt.
CMFCToolBar::GetButtonText	Retourneert het tekstlabel van een knop met een opgegeven index.
CMFCToolBar::GetColdImages	Hiermee wordt een aanwijzer geretourneerd naar de verzameling koude werkbalkknopafbeeldingen in de toepassing.
CMFCToolBar::GetColumnWidth	Retourneert de breedte van de werkbalkknoppen.
CMFCToolBar::GetCommandButtons	Retourneert een lijst met knoppen met een opgegeven opdracht-id van alle werkbalken in de toepassing.
CMFCToolBar::GetCount	Retourneert het aantal knoppen en scheidingstekens op de werkbalk.
CMFCToolBar::GetCustomizeButton	Hiermee wordt een aanwijzer opgehaald naar het CMFCCustomizeButton-object dat is gekoppeld aan de werkbalk.
CMFCToolBar::GetDefaultImage	Retourneert de index van de standaardafbeelding voor een werkbalkknop met een opgegeven opdracht-id.
CMFCToolBar::GetDisabledImages	Hiermee wordt een aanwijzer geretourneerd naar de verzameling afbeeldingen die worden gebruikt voor uitgeschakelde werkbalkknoppen in de toepassing.
CMFCToolBar::GetDisabledMenuImages	Hiermee wordt een aanwijzer geretourneerd naar de verzameling afbeeldingen die worden gebruikt voor uitgeschakelde menuknoppen in de toepassing.
CMFCToolBar::GetDroppedDownMenu	Hiermee wordt een aanwijzer opgehaald naar het menuknopobject dat momenteel het submenu weergeeft.
CMFCToolBar::GetGrayDisabledButtons	Hiermee geeft u op of de afbeeldingen van uitgeschakelde knoppen grijs worden weergegeven versies van de normale knopafbeeldingen of worden genomen uit de verzameling uitgeschakelde knopafbeeldingen.
CMFCToolBar::GetHighlightedButton	Hiermee wordt een aanwijzer geretourneerd naar de werkbalkknop die momenteel is gemarkeerd.
CMFCToolBar::GetHotBorder	Bepaalt of de werkbalkknoppen dynamisch worden bijgehouden.
CMFCToolBar::GetHotTextColor	Retourneert de tekstkleur van de gemarkeerde werkbalkknoppen.
CMFCToolBar::GetHwndLastFocus	Hiermee wordt een ingang geretourneerd naar het venster met de invoerfocus net voordat de werkbalk werd uitgevoerd.
CMFCToolBar::GetIgnoreSetText	Hiermee geeft u op of aanroepen voor het instellen van knoplabels worden genegeerd.
CMFCToolBar::GetImageSize	Retourneert de huidige grootte van werkbalkknopafbeeldingen.
CMFCToolBar::GetImages	Retourneert een aanwijzer naar de verzameling standaardknopafbeeldingen in de toepassing.
CMFCToolBar::GetImagesOffset	Retourneert de index offset die wordt gebruikt om de afbeeldingen van de werkbalkknop voor deze werkbalk te vinden in de algemene lijst met werkbalkknopafbeeldingen.
CMFCToolBar::GetInvalidateItemRect	Hiermee wordt de regio opgehaald van het clientgebied dat opnieuw moet worden getekend voor de knop in de opgegeven index.
CMFCToolBar::GetItemID	Retourneert de opdracht-id van de werkbalkknop in een opgegeven index.
CMFCToolBar::GetItemRect	Retourneert de begrenzingsrechthoek van de knop in een opgegeven index.
CMFCToolBar::GetLargeColdImages	Retourneert een aanwijzer naar de verzameling grote koude werkbalkknopafbeeldingen in de toepassing.
CMFCToolBar::GetLargeDisabledImages	Retourneert een aanwijzer naar de verzameling grote uitgeschakelde werkbalkknopafbeeldingen in de toepassing.
CMFCToolBar::GetLargeImages	Hiermee wordt een aanwijzer geretourneerd naar de verzameling grote afbeeldingen van werkbalkknoppen in de toepassing.
CMFCToolBar::GetLockedColdImages	Hiermee wordt een aanwijzer geretourneerd naar de verzameling vergrendelde koude afbeeldingen op de werkbalk.
CMFCToolBar::GetLockedDisabledImages	Hiermee wordt een aanwijzer geretourneerd naar de verzameling vergrendelde uitgeschakelde afbeeldingen op de werkbalk.
CMFCToolBar::GetLockedImages	Hiermee wordt een aanwijzer geretourneerd naar de verzameling vergrendelde knopafbeeldingen op de werkbalk.
CMFCToolBar::GetLockedImageSize	Retourneert de standaardgrootte van vergrendelde werkbalkafbeeldingen.
CMFCToolBar::GetLockedMenuImages	Retourneert een aanwijzer naar de verzameling vergrendelde werkbalkmenuafbeeldingen op de werkbalk.
CMFCToolBar::GetMenuButtonSize	Retourneert de grootte van menuknoppen in de toepassing.
CMFCToolBar::GetMenuImageSize	Retourneert de grootte van menuknopafbeeldingen in de toepassing.
CMFCToolBar::GetMenuImages	Retourneert een aanwijzer naar de verzameling menuknopafbeeldingen in de toepassing.
CMFCToolBar::GetOrigButtons	Hiermee haalt u de verzameling niet-aangepaste knoppen van de werkbalk op.
CMFCToolBar::GetOrigResetButtons	Hiermee haalt u de verzameling niet-aangepaste resetknoppen van de werkbalk op.
CMFCToolBar::GetResourceID	Haalt de resource-id van de werkbalk op.
CMFCToolBar::GetRouteCommandsViaFrame	Bepaalt welk object, het bovenliggende frame of de eigenaar, opdrachten naar de werkbalk verzendt.
CMFCToolBar::GetRowHeight	Retourneert de hoogte van werkbalkknoppen.
CMFCToolBar::GetShowTooltips	Hiermee geeft u op of knopinfo wordt weergegeven voor werkbalkknoppen.
CMFCToolBar::GetSiblingToolBar	Hiermee haalt u het niveau van de werkbalk op.
CMFCToolBar::GetUserImages	Hiermee wordt een aanwijzer geretourneerd naar de verzameling door de gebruiker gedefinieerde werkbalkknopafbeeldingen in de toepassing.
CMFCToolBar::HitTest	Retourneert de index van de werkbalkknop die zich op de opgegeven positie bevindt.
CMFCToolBar::InsertButton	Hiermee voegt u een knop in de werkbalk in.
CMFCToolBar::InsertSeparator	Hiermee voegt u een scheidingsteken in de werkbalk in.
CMFCToolBar::InvalidateButton	Ongeldig het clientgebied van de werkbalkknop die aanwezig is in de opgegeven index.
CMFCToolBar::IsAddRemoveQuickCustomize	Bepaalt of een gebruiker werkbalkknoppen kan toevoegen of verwijderen met behulp van de menuoptie Aanpassen.
CMFCToolBar::IsAltCustomizeMode	Hiermee geeft u op of snelle aanpassing wordt gebruikt om een knop te slepen.
CMFCToolBar::IsAutoGrayInactiveImages	Hiermee geeft u op of het automatisch genereren van inactieve (niet-gemarkeerde) knopafbeeldingen is ingeschakeld.
CMFCToolBar::IsBasicCommand	Bepaalt of een opdracht in de lijst met basisopdrachten staat.
CMFCToolBar::IsButtonExtraSizeAvailable	Bepaalt of de werkbalk knoppen met uitgebreide randen kan weergeven.
CMFCToolBar::IsButtonHighlighted	Bepaalt of een knop op de werkbalk is gemarkeerd.
CMFCToolBar::IsCommandPermitted	Bepaalt of een opdracht is toegestaan.
CMFCToolBar::IsCommandRarelyUsed	Bepaalt of een opdracht zelden wordt gebruikt (zie CMFCToolBar::SetCommandUsageOptions).
CMFCToolBar::IsCustomizeMode	Hiermee geeft u op of het werkbalkframework zich in de aanpassingsmodus bevindt.
CMFCToolBar::IsDragButton	Bepaalt of een werkbalkknop wordt gesleept.
CMFCToolBar::IsExistCustomizeButton	Bepaalt of de werkbalk de knop Aanpassen bevat.
CMFCToolBar::IsFloating	Bepaalt of de werkbalk zwevend is.
CMFCToolBar::IsLargeIcons	Hiermee geeft u op of werkbalken in de toepassing momenteel grote pictogrammen weergeven.
CMFCToolBar::IsLastCommandFromButton	Bepaalt of de laatst uitgevoerde opdracht is verzonden vanaf de opgegeven werkbalkknop.
CMFCToolBar::IsLocked	Bepaalt of de werkbalk is vergrendeld.
CMFCToolBar::IsOneRowWithSibling	Bepaalt of de werkbalk en de bijbehorende werkbalk op hetzelfde niveau in dezelfde rij staan.
CMFCToolBar::IsUserDefined	Hiermee geeft u op of de werkbalk door de gebruiker is gedefinieerd.
CMFCToolBar::LoadBitmap	Hiermee worden werkbalkafbeeldingen uit toepassingsbronnen geladen.
CMFCToolBar::LoadBitmapEx	Hiermee worden werkbalkafbeeldingen uit toepassingsbronnen geladen. Bevat grote afbeeldingen.
CMFCToolBar::LoadParameters	Hiermee worden algemene werkbalkopties uit het Windows-register geladen.
CMFCToolBar::LoadState	Laadt de informatie over de status van de werkbalk uit het Windows-register. (Overschrijft CPane::LoadState.)
CMFCToolBar::LoadToolBar	Laadt de werkbalk van toepassingsbronnen.
CMFCToolBar::LoadToolBarEx	Laadt de werkbalk van toepassingsresources met behulp van de CMFCToolBarInfo helperklasse om de toepassing in staat te stellen grote installatiekopieën te gebruiken.
CMFCToolBar::OnChangeHot	Aangeroepen door het framework wanneer een gebruiker een knop op de werkbalk selecteert.
CMFCToolBar::OnFillBackground	Aangeroepen door het framework van CBasePane::DoPaint om de achtergrond van de werkbalk te vullen.
CMFCToolBar::OnReset	Hiermee wordt de werkbalk terugzet naar de oorspronkelijke staat.
CMFCToolBar::OnSetAccData	(Overschrijft CBasePane::OnSetAccData.)
CMFCToolBar::OnSetDefaultButtonText	Hiermee herstelt u de tekst van een werkbalkknop naar de standaardstatus.
CMFCToolBar::OnUpdateCmdUI	Intern gebruikt.
CMFCToolBar::RemoveAllButtons	Hiermee verwijdert u alle knoppen uit de werkbalk.
CMFCToolBar::RemoveButton	Hiermee verwijdert u de knop met de opgegeven index uit de werkbalk.
CMFCToolBar::RemoveStateFromRegistry	Hiermee verwijdert u de statusinformatie voor de werkbalk uit het Windows-register.
CMFCToolBar::ReplaceButton	Hiermee vervangt u een werkbalkknop door een andere werkbalkknop.
CMFCToolBar::ResetAll	Hiermee worden alle werkbalken terugzet naar de oorspronkelijke status.
CMFCToolBar::ResetAllImages	Hiermee wist u alle verzamelingen van werkbalkafbeeldingen in de toepassing.
CMFCToolBar::RestoreOriginalState	Hiermee wordt de oorspronkelijke status van een werkbalk hersteld.
CMFCToolBar::SaveState	Hiermee wordt de statusinformatie voor de werkbalk opgeslagen in het Windows-register. (Overschrijft CPane::SaveState.)
CMFCToolBar::Serialize	(Overschrijft CBasePane::Serialize.)
CMFCToolBar::SetBasicCommands	Hiermee stelt u de lijst met opdrachten in die altijd worden weergegeven wanneer een gebruiker een menu opent.
CMFCToolBar::SetButtonInfo	Hiermee stelt u de opdracht-id, stijl en afbeeldings-id van een werkbalkknop in.
CMFCToolBar::SetButtonStyle	Hiermee stelt u de stijl van de werkbalkknop in op de opgegeven index.
CMFCToolBar::SetButtonText	Hiermee stelt u het tekstlabel van een werkbalkknop in.
CMFCToolBar::SetButtons	Hiermee stelt u de knoppen voor de werkbalk in.
CMFCToolBar::SetCommandUsageOptions	Hiermee geeft u op wanneer zelden gebruikte opdrachten niet worden weergegeven in het menu van de toepassing.
CMFCToolBar::SetCustomizeMode	Hiermee schakelt u de aanpassingsmodus voor alle werkbalken in de toepassing in of uit.
CMFCToolBar::SetGrayDisabledButtons	Hiermee geeft u op of de uitgeschakelde knoppen op de werkbalk grijs worden weergegeven of als uitgeschakelde afbeeldingen worden gebruikt voor de uitgeschakelde knoppen.
CMFCToolBar::SetHeight	Hiermee stelt u de hoogte van de werkbalk in.
CMFCToolBar::SetHotBorder	Hiermee geeft u op of werkbalkknoppen dynamisch worden bijgehouden.
CMFCToolBar::SetHotTextColor	Hiermee stelt u de tekstkleur in voor knoppen met dynamische werkbalken.
CMFCToolBar::SetLargeIcons	Hiermee geeft u op of op werkbalkknoppen grote pictogrammen worden weergegeven.
CMFCToolBar::SetLockedSizes	Hiermee stelt u de grootte van vergrendelde knoppen en vergrendelde afbeeldingen op de werkbalk in.
CMFCToolBar::SetMenuSizes	Hiermee stelt u de grootte van werkbalkmenuknoppen en de bijbehorende afbeeldingen in.
CMFCToolBar::SetNonPermittedCommands	Hiermee stelt u de lijst met opdrachten in die niet door de gebruiker kunnen worden uitgevoerd.
CMFCToolBar::SetOneRowWithSibling	Hiermee plaatst u de werkbalk en het bijbehorende niveau op dezelfde rij.
CMFCToolBar::SetPermament	Hiermee geeft u op of een gebruiker de werkbalk kan sluiten.
CMFCToolBar::SetRouteCommandsViaFrame	Hiermee geeft u op of het bovenliggende frame of de eigenaar opdrachten naar de werkbalk verzendt.
CMFCToolBar::SetShowTooltips	Hiermee geeft u op of in het framework knopinfo wordt weergegeven.
CMFCToolBar::SetSiblingToolBar	Hiermee geeft u het niveau van de werkbalk op.
CMFCToolBar::SetSizes	Hiermee geeft u de grootte van knoppen en afbeeldingen op alle werkbalken.
CMFCToolBar::SetToolBarBtnText	Hiermee geeft u eigenschappen van een knop op de werkbalk.
CMFCToolBar::SetTwoRowsWithSibling	Hiermee plaatst u de werkbalk en het bijbehorende niveau op afzonderlijke rijen.
CMFCToolBar::SetUserImages	Hiermee stelt u de verzameling door de gebruiker gedefinieerde installatiekopieën in de toepassing in.
CMFCToolBar::StretchPane	Hiermee wordt de werkbalk verticaal of horizontaal uitgerekt. (Overschrijft CBasePane::StretchPane.)
CMFCToolBar::TranslateChar	Hiermee voert u een knopopdracht uit als de opgegeven sleutelcode overeenkomt met een geldige sneltoets.
CMFCToolBar::UpdateButton	Hiermee wordt de status van de opgegeven knop bijgewerkt.
CMFCToolBar::WrapToolBar	Werkbalkknoppen binnen de opgegeven dimensies verplaatsen.

Beveiligde methoden

Naam	Beschrijving
CMFCToolBar::AllowShowOnList	Bepaalt of de werkbalk wordt weergegeven in de lijst in het deelvenster Werkbalken van het dialoogvenster aanpassen.
CMFCToolBar::CalcMaxButtonHeight	Berekent de maximale hoogte van een knop op de werkbalk.
CMFCToolBar::DoPaint	Een werkbalk opnieuw schilderen.
CMFCToolBar::DrawButton	Een werkbalkknop opnieuw schilderen.
CMFCToolBar::DrawSeparator	Een scheidingsteken op een werkbalk opnieuw schilderen.
CMFCToolBar::OnUserToolTip	Aangeroepen door het framework wanneer de knopinfo voor een knop op het punt staat te worden weergegeven.

Gegevensleden

Naam	Beschrijving
CMFCToolBar::m_bDontScaleImages	Hiermee geeft u op of u werkbalkafbeeldingen wilt schalen in de modus hoge DPI.
CMFCToolBar::m_dblLargeImageRatio	Hiermee geeft u de verhouding tussen de dimensie (hoogte of breedte) van grote afbeeldingen en de dimensie van reguliere afbeeldingen.

Opmerkingen

Voer de volgende stappen uit om een CMFCToolBar-object in uw toepassing op te nemen:

1. Voeg een CMFCToolBar-object toe aan het hoofdframevenster.

2. Wanneer u het WM_CREATE bericht voor het hoofdframevenster verwerkt, roept u CMFCToolBar::Create of CMFCToolBar::CreateEx aan om de werkbalk te maken en de stijl op te geven.

3. Roep CBasePane::EnableDocking aan om de dockingstijl op te geven.

Als u een speciale knop wilt invoegen, zoals een keuzelijst met invoervak of vervolgkeuzelijst, reserveert u een dummyknop in de bovenliggende resource en vervangt u de dummyknop tijdens runtime met behulp van CMFCToolBar::ReplaceButton. Zie Overzicht: Besturingselementen op werkbalken plaatsenvoor meer informatie.

CMFCToolBar is de basisklasse voor de MFC-bibliotheekklassen CMFCMenuBar Klasse, CMFCPopupMenuBar Klasseen CMFCDropDownToolBar Klasse.

Voorbeeld

In het volgende voorbeeld ziet u hoe u verschillende methoden gebruikt in de klasse CMFCToolBar. In het voorbeeld ziet u hoe u de tekst van het vensterlabel van de werkbalk instelt, de randen instelt, de stijl van het deelvenster instelt en de knoppen toevoegen of verwijderen inschakelt knop die wordt weergegeven aan het einde van de werkbalk. Dit codefragment maakt deel uit van het IE Demo-voorbeeld.

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..."));

Eisen

koptekst:afxtoolbar.h

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCToolBar::AddBasicCommand

Hiermee voegt u een menuopdracht toe aan de lijst met opdrachten die altijd worden weergegeven wanneer een gebruiker een menu opent.

static void __stdcall AddBasicCommand(UINT uiCmd);

Parameters

uiCmd
[in] Hiermee geeft u de opdracht toe te voegen.

Opmerkingen

Er wordt altijd een basisopdracht weergegeven wanneer het menu wordt geopend. Deze methode is zinvol wanneer de gebruiker ervoor kiest onlangs gebruikte opdrachten weer te geven.

Gebruik de methode CMFCToolBar::SetBasicCommands om de lijst met opdrachten in te stellen die altijd worden weergegeven wanneer een gebruiker een menu opent. Gebruik de methode CMFCToolBar::GetBasicCommands om de lijst met basisopdrachten op te halen die door uw toepassing worden gebruikt.

CMFCToolBar::AddCommandUsage

Hiermee wordt één teller verhoogd die is gekoppeld aan de opgegeven opdracht.

static void __stdcall AddCommandUsage(UINT uiCommand);

Parameters

uiCommand
[in] Hiermee geeft u de opdrachtteller te verhogen.

Opmerkingen

Dit framework roept deze methode aan wanneer de gebruiker een menu-item selecteert.

Het framework maakt gebruik van opdrachttellers om recent gebruikte menu-items weer te geven.

Met deze methode wordt de opdrachtteller verhoogd met behulp van de methode CMFCCmdUsageCount::AddCmd.

CMFCToolBar::AddToolBarForImageCollection

Voegt afbeeldingen van de resources van de gebruikersinterface toe aan de verzameling afbeeldingen in de toepassing.

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

Parameters

uiResID
[in] Resource-id van een werkbalk met afbeeldingen die moeten worden geladen.

uiBmpResID
[in] Resource-id van een bitmap met werkbalkafbeeldingen.

uiColdResID
[in] Resource-id van een bitmap met 'koude' werkbalkafbeeldingen.

uiMenuResID
[in] Resource-id van een bitmap met menuafbeeldingen.

uiDisabledResID
[in] Resource-id van een bitmap met uitgeschakelde werkbalkafbeeldingen.

uiMenuDisabledResID
[in] Resource-id van een bitmap met uitgeschakelde menuafbeeldingen.

Retourwaarde

TRUE als de methode slaagt; FALSE als uiResID of uiBmpResID geen geldige resources opgeeft of er een andere fout optreedt.

Opmerkingen

Roep deze methode aan om een bitmap met werkbalkafbeeldingen te laden en toe te voegen aan de verzameling werkbalkafbeeldingen. Met deze methode maakt u een tijdelijk werkbalkobject en roept u CMFCToolBar::LoadToolBaraan.

CMFCToolBar::AdjustLayout

Berekent de grootte en positie van een werkbalk opnieuw.

virtual void AdjustLayout();

Opmerkingen

Roep deze methode aan wanneer de werkbalk is gemaakt om de grootte en positie opnieuw te berekenen.

In het framework wordt deze methode telkens aangeroepen wanneer de indeling van de werkbalk moet worden gewijzigd. De indeling moet bijvoorbeeld worden gewijzigd wanneer de gebruiker een andere besturingsbalk verplaatst, het formaat van een toepassingsvenster wijzigt of de werkbalk aanpast.

Overschrijf deze methode om uw eigen dynamische indeling te bieden in klassen die u hebt afgeleid van CMFCToolbar.

CMFCToolBar::AdjustSize

Berekent de grootte van de werkbalk opnieuw.

void AdjustSize();

Opmerkingen

Deze methode zorgt ervoor dat de werkbalk binnen de grenzen van het bovenliggende frame past. Deze methode doet niets als de werkbalk geen bovenliggend frame heeft.

Met de methode CMFCToolBar::AdjustLayout wordt deze methode aangeroepen om de grootte opnieuw te berekenen als het bovenliggende element van de werkbalk geen CMFCReBar object is.

CMFCToolBar::AllowChangeTextLabels

Hiermee geeft u op of tekstlabels kunnen worden weergegeven onder afbeeldingen op de werkbalkknoppen.

virtual BOOL AllowChangeTextLabels() const;

Retourwaarde

TRUE als het is toegestaan om tekstlabels onder afbeeldingen weer te geven; anders FALSE.

Opmerkingen

Deze methode wordt aangeroepen door het dialoogvenster Aanpassing om te bepalen of een Tekstlabels weergeven selectievakje op de werkbalken pagina voor de geselecteerde werkbalk moet inschakelen.

De standaard implementatie retourneert TRUE.

Overschrijf deze methode in een object dat is afgeleid van CMFCToolBar en retourneer FALSE wanneer u niet wilt dat de gebruiker besluit of tekstlabels worden weergegeven op werkbalkknoppen onder de afbeeldingen.

CMFCToolBar::AllowShowOnList

Bepaalt of de werkbalk wordt weergegeven in de lijst met werkbalken in het deelvenster Werkbalken van het dialoogvenster aanpassen.

virtual BOOL AllowShowOnList() const;

Retourwaarde

TRUE als het werkbalkobject kan worden weergegeven in de keuzelijst op de werkbalkaanpassingspagina; anders FALSE.

Opmerkingen

Deze methode wordt aangeroepen door het framework om te bepalen of de lijst op de werkbalkaanpassingspagina een bepaald object moet bevatten dat is afgeleid van CMFCToolBar.

De standaard implementatie retourneert altijd TRUE. Overschrijf deze methode als u niet wilt dat een werkbalk wordt weergegeven in de lijst met werkbalken in het dialoogvenster Aanpassing.

CMFCToolBar::AreTextLabels

Hiermee geeft u op of tekstlabels onder afbeeldingen momenteel worden weergegeven op de werkbalkknoppen.

BOOL AreTextLabels() const;

Retourwaarde

TRUE als de werkbalkknoppen tekstlabels onder afbeeldingen weergeven; anders FALSE.

Opmerkingen

Gebruik CMFCToolBar::EnableTextLabels om op te geven of de tekst wordt weergegeven. De standaardwaarde is FALSE. Roep CMFCToolBar::AllowChangeTextLabels aan om op te geven of de gebruiker deze instelling in het aanpassingsdialoogvenster kan wijzigen.

CMFCToolBar::AutoGrayInactiveImages

Hiermee schakelt u het automatisch genereren van inactieve knopafbeeldingen in of uit.

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

Parameters

bEnable
[in] Een Booleaanse waarde die aangeeft of inactieve afbeeldingen moeten worden gedimd. Als deze parameter is TRUE, worden inactieve afbeeldingen grijs weergegeven. Anders worden inactieve afbeeldingen niet grijs weergegeven.

nGrayImagePercentage
[in] Hiermee geeft u het luminantiepercentage voor inactieve afbeeldingen. Als bEnable is FALSE, wordt deze waarde genegeerd.

bRedrawAllToolbars
[in] Een Booleaanse waarde die aangeeft of alle werkbalken in de toepassing opnieuw moeten worden getekend. Als deze parameter is TRUE, worden met deze methode alle werkbalken opnieuw getekend.

Opmerkingen

Als bEnable is TRUE, gebruikt het framework nGrayImagePercentage om inactieve afbeeldingen te genereren op basis van de normale installatiekopieën. Anders moet u de set inactieve installatiekopieën opgeven met behulp van de methode CMFCToolBar::GetColdImages. Deze optie is standaard uitgeschakeld.

Zie CMFCToolBarImages::GrayImagesvoor meer informatie over de parameter nGrayImagePercentage.

CMFCToolBar::ButtonToIndex

Retourneert de index van een opgegeven CMFCToolBarButton Class-object in deze werkbalk.

int ButtonToIndex(const CMFCToolBarButton* pButton) const;

Parameters

pButton
[in] Een aanwijzer naar het werkbalkknopobject.

Retourwaarde

Index van pButton in de interne lijst met werkbalkknoppen; of -1 als de opgegeven knop zich niet op deze werkbalk bevindt.

CMFCToolBar::CalcFixedLayout

Berekent de horizontale grootte van de werkbalk.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parameters

bStretch
[in] TRUE om de werkbalk uit te rekken tot de grootte van het bovenliggende frame.

bHorz
[in] TRUE om de werkbalk horizontaal te oriënteren; FALSE om de werkbalk verticaal te richten.

Retourwaarde

Een CSize-object dat de grootte van de werkbalk aangeeft.

Opmerkingen

Met deze methode wordt de grootte van de werkbalk berekend met behulp van de methode CMFCToolBar::CalcLayout. De LM_STRETCH vlag wordt doorgegeven voor de parameter dwMode als bStretch is TRUE. De LM_HORZ vlag wordt doorgegeven als bHorz is TRUE.

Zie het VisualStudioDemo-voorbeeld voor een voorbeeld waarin deze methode wordt gebruikt.

CMFCToolBar::CalcMaxButtonHeight

Berekent de maximale hoogte van knoppen op de werkbalk.

virtual int CalcMaxButtonHeight();

Retourwaarde

De maximale hoogte van knoppen.

Opmerkingen

Met deze methode wordt de maximale hoogte van alle werkbalkknoppen op de werkbalk berekend. De hoogte kan variëren, afhankelijk van factoren zoals de huidige dockingstatus van de werkbalk.

Overschrijf deze methode in een klasse die is afgeleid van CMFCToolBar om uw eigen hoogteberekening op te geven.

CMFCToolBar::CalcSize

Aangeroepen door het framework als onderdeel van het indelingsberekeningsproces.

virtual CSize CalcSize(BOOL bVertDock);

Parameters

bVertDock
[in] TRUE om op te geven dat de werkbalk verticaal is gedokt; FALSE om op te geven dat de werkbalk horizontaal is gedokt.

Retourwaarde

Een CSize-object dat de totale grootte van de knoppen op de werkbalk aangeeft.

Opmerkingen

Deze methode beschouwt de kenmerken die van invloed zijn op de grootte van elke knop, zoals het gebied van het tekstlabel en de randgrootte.

Als de werkbalk geen knoppen bevat, retourneert deze methode de gereserveerde grootte van één knop met behulp van de methode CMFCToolBar::GetButtonSize.

CMFCToolBar::CanBeClosed

Hiermee geeft u op of een gebruiker de werkbalk kan sluiten.

virtual BOOL CanBeClosed() const;

Retourwaarde

TRUE als de werkbalk door de gebruiker kan worden gesloten; anders FALSE.

Opmerkingen

In het framework wordt deze methode aangeroepen om te bepalen of de gebruiker een werkbalk kan sluiten. Als de methode TRUEretourneert, schakelt het framework de opdracht SC_CLOSE in het systeemmenu van de werkbalk in en kan de gebruiker de werkbalk sluiten met behulp van een selectievakje in de lijst met werkbalken in het dialoogvenster Aanpassing.

De standaard implementatie retourneert TRUE. Overschrijf deze methode in een klasse die is afgeleid van CMFCToolBar om werkbalkobjecten te maken die niet door de gebruiker kunnen worden gesloten.

CMFCToolBar::CanBeRestored

Bepaalt of het systeem na aanpassing een werkbalk naar de oorspronkelijke staat kan herstellen.

virtual BOOL CanBeRestored() const;

Retourwaarde

TRUE of de werkbalk kan worden hersteld vanuit de toepassingsbronnen; anders FALSE.

Opmerkingen

In het framework wordt deze methode aangeroepen om te bepalen of een werkbalk na aanpassing kan worden teruggezet naar de oorspronkelijke staat. De oorspronkelijke status wordt geladen vanuit de toepassingsbronnen.

Als CanBeRestoredTRUEretourneert, schakelt de werkbalken pagina van het aanpassingsdialoogvenster de knop opnieuw instellen voor de geselecteerde werkbalk in.

De standaard implementatie retourneert TRUE als de oorspronkelijke resource-id van de werkbalk toen deze werd geladen, niet nul is. Normaal gesproken kunnen alleen door de gebruiker gedefinieerde werkbalken niet worden hersteld.

U kunt de methode CanBeRestored overschrijven om dit gedrag in afgeleide klassen aan te passen.

CMFCToolBar::CanFocus

Hiermee geeft u op of het deelvenster de focus kan ontvangen.

virtual BOOL CanFocus() const;

Retourwaarde

Deze methode retourneert FALSE.

Opmerkingen

Met deze methode wordt de implementatie van de basisklasse, CBasePane::CanFocus, overschreven, omdat werkbalkobjecten de focus niet kunnen ontvangen.

CMFCToolBar::CanHandleSiblings

Hiermee bepaalt u of de werkbalk en het bijbehorende niveau op hetzelfde deelvenster staan.

BOOL CanHandleSiblings();

Retourwaarde

TRUE als de werkbalk een hetzelfde niveau heeft en de werkbalk en het bijbehorende niveau in hetzelfde deelvenster worden weergegeven; anders FALSE.

Opmerkingen

Met de interne methode CMFCCustomizeButton::CreatePopupMenu wordt deze methode aangeroepen om te bepalen hoe u het snelmenu Aanpassen kunt weergeven. Als deze methode TRUEretourneert, worden in het framework de knoppen Knoppen weergeven weergegeven op één rij of Knoppen weergeven op twee rijen knoppen.

Normaal gesproken hoeft u deze methode niet te gebruiken. Als u de knop Aanpassen wilt inschakelen die op de werkbalk wordt weergegeven, roept u de methode CMFCToolBar::EnableCustomizeButton aan. Als u de Knoppen weergeven op één rij of knoppen weergeven op twee rijen knoppen wilt inschakelen, roept u CMFCToolBar::SetSiblingToolBaraan.

CMFCToolBar::CleanUpImages

Hiermee worden de systeembronnen vrijgemaakt die zijn toegewezen voor werkbalkafbeeldingen.

static void CMFCToolBar::CleanUpImages();

Opmerkingen

Dit framework roept deze methode aan wanneer een toepassing wordt afgesloten.

CMFCToolBar::CleanUpLockedImages

Hiermee worden de systeembronnen vrijgemaakt die zijn toegewezen voor vergrendelde werkbalkinstallatiekopieën.

void CleanUpLockedImages();

Opmerkingen

Roep deze methode aan wanneer de visuele stijl van uw toepassing wordt gewijzigd. Zie het VisualStudioDemo-voorbeeld voor een voorbeeld waarin deze methode wordt gebruikt.

CMFCToolBar::CommandToIndex

Retourneert de index van de knop op de werkbalk met een opgegeven opdracht-id.

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

Parameters

nIDFind
[in] Hiermee geeft u de opdracht-id.

iIndexFirst
[in] Hiermee geeft u de initiële index op waaruit moet worden gestart.

Retourwaarde

Op nul gebaseerde index van de werkbalkknop als de methode is geslaagd; -1 als er geen knop is met de opgegeven id.

Opmerkingen

Een CMFCToolBar-object onderhoudt een interne lijst met de knoppen op de werkbalk. Roep deze functie aan om de index van een knop in de lijst op te halen op basis van de opdracht-id van de knop.

Als iIndex groter is dan 0, negeert deze methode een knop op de werkbalk met een index die kleiner is dan iIndex.

CMFCToolBar::Create

Hiermee maakt u een CMFCToolBar-object.

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

Parameters

pParentWnd
[in] Een aanwijzer naar het bovenliggende venster van de werkbalk.

dwStyle
[in] De werkbalkstijl. Zie werkbalkbesturing en knopstijlen in de Windows SDK voor de lijst met stijlen.

nID
[in] De id van het onderliggende venster van de werkbalk.

Retourwaarde

TRUE als deze methode slaagt; anders FALSE.

Opmerkingen

Met deze methode maakt u een besturingsbalk en koppelt u deze aan de werkbalk. Hiermee maakt u de besturingsbalk met de stijl TBSTYLE_FLAT. Roep CMFCToolBar::CreateEx aan als u een andere stijl voor de besturingsbalk wilt.

CMFCToolBar::CreateEx

Hiermee maakt u een CMFCToolBar-object dat gebruikmaakt van extra stijlopties, zoals grote pictogrammen.

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);

Parameters

pParentWnd
[in] Een aanwijzer naar het bovenliggende venster van de werkbalk.

dwCtrlStyle
[in] Aanvullende stijlen voor het maken van het ingesloten besturingsbalkobject.

dwStyle
[in] De werkbalkstijl. Zie werkbalkbesturing en knopstijlen voor een lijst met geschikte stijlen.

rcBorders
[in] Een CRect-object dat de breedte van de randen van het werkbalkvenster aangeeft.

nID
[in] De id van het onderliggende venster van de werkbalk.

Retourwaarde

Niet-nul als deze methode slaagt; anders 0.

Opmerkingen

Met deze methode maakt u een besturingsbalk en koppelt u deze aan de werkbalk.

Roep deze methode aan in plaats van CMFCToolBar::Create wanneer u specifieke stijlen wilt opgeven. Stel bijvoorbeeld dwCtrlStyle in op TBSTYLE_FLAT | TBSTYLE_TRANSPARENT om een werkbalk te maken die lijkt op de werkbalken die worden gebruikt door Internet Explorer 4.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de CreateEx methode van de klasse CMFCToolBar gebruikt. Dit codefragment maakt deel uit van het IE Demo-voorbeeld.

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

Hiermee wordt de werkbalk gedeactiveerd.

virtual void Deactivate();

Opmerkingen

Met deze methode wordt de werkbalk gedeactiveerd door de focus van de gemarkeerde werkbalkknop te verwijderen. In het framework wordt deze methode aangeroepen wanneer de werkbalk de focus verliest of wordt vernietigd.

CMFCToolBar::DoPaint

Een werkbalk opnieuw schilderen.

virtual void DoPaint(CDC* pDC);

Parameters

pDC
[in] Een aanwijzer naar een apparaatcontext.

Opmerkingen

Deze methode wordt aangeroepen door het framework wanneer een deel van de werkbalk opnieuw moet worden geschilderd.

Overschrijf deze methode om het uiterlijk van een object dat is afgeleid van CMFCToolBaraan te passen.

CMFCToolBar::DrawButton

Een werkbalkknop opnieuw schilderen.

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

Parameters

pDC
[in] Een aanwijzer naar een apparaatcontext.

pButton
[in] Een aanwijzer naar een knop om te tekenen.

pImages
[in] Een aanwijzer naar de werkbalkafbeeldingen.

bHighlighted
[in] TRUE als de knop is gemarkeerd; anders FALSE.

bDrawDisabledImages
[in] TRUE als uitgeschakelde knoppen grijs zijn; anders FALSE.

Retourwaarde

TRUE als de knop opnieuw is geschilderd; FALSE als de knop verborgen is.

Opmerkingen

De methode CMFCToolBar::DrawButton roept deze methode aan wanneer een werkbalkknop opnieuw moet worden geschilderd.

Overschrijf deze methode als u het uiterlijk van knoppen op de werkbalk wilt aanpassen.

CMFCToolBar::DrawSeparator

Een scheidingsteken op een werkbalk opnieuw schilderen.

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

Parameters

pDC
[in] Een aanwijzer naar een apparaatcontext.

rect
[in] De begrenzingsrechthoek van de locatie waar het scheidingsteken wordt getekend, in pixels.

bHorz
[in] TRUE als het scheidingsteken horizontaal is, FALSE als het scheidingsteken verticaal is.

Opmerkingen

CMFCToolBar::DoPaint roept deze methode aan voor elk CMFCToolBar::DrawSeparator-object met de stijl TBBS_SEPARATOR, in plaats van CMFCToolBar::DrawButton aan te roepen voor deze knoppen.

Overschrijf deze methode in een klasse die is afgeleid van CMFCToolBar om het uiterlijk van scheidingstekens op de werkbalk aan te passen. De standaard implementatie roept CMFCVisualManager::OnDrawSeparator aan om een scheidingsteken te tekenen waarvan het uiterlijk wordt bepaald door de huidige visualmanager.

CMFCToolBar::EnableCustomizeButton

Hiermee schakelt u de knop Aanpassen in of uit die wordt weergegeven op de werkbalk.

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

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

Parameters

bEnable
[in] Hiermee schakelt u de knop Aanpassen in of uit.

iCustomizeCmd
[in] De opdracht-id van de knop Aanpassen.

strCustomizeText
[in] Het tekstlabel van de knop Aanpassen.

uiCustomizeTextResId
[in] De resourcereeks-id van het knoplabel Aanpassen.

bQuickCustomize
[in] Hiermee schakelt u de optie Knoppen toevoegen of verwijderen in of uit in het menu dat van de knop wordt weergegeven.

Opmerkingen

Als iCustomizeCmd -1 is, wordt in het framework de knop Aanpassen weergegeven wanneer meerdere werkbalkknoppen niet in het werkbalkgebied passen. Op de knop wordt een dubbele pijl naar links of dubbele punthaak weergegeven, die aangeeft dat er meer knoppen zijn.

Als iCustomizeCmd een geldige opdracht-id opgeeft en bEnable is TRUE, wordt de knop Aanpassen altijd weergegeven. De knop heeft een kleine pijl-omlaag en opent een menu met een opdracht. Deze opdracht maakt gebruik van het tekstlabel dat is opgegeven door strCustomizeText. Als bQuickCustomize ook is TRUE, wordt in het menu de optie Knoppen toevoegen of verwijderen weergegeven.

Het framework voegt dynamisch toe aan het menu knoppen die niet in het werkbalkgebied passen vóór het item dat is opgegeven door iCustomizeCmd. De dubbele punthaak wordt naast de pijl-omlaag weergegeven.

CMFCToolBar::EnableDocking

Hiermee kunt u het deelvenster aan het hoofdframe koppelen.

virtual void EnableDocking(DWORD dwAlignment);

Parameters

dwAlignment
[in] Hiermee geeft u de dockinguitlijning op die moet worden ingeschakeld.

Opmerkingen

Met deze methode wordt de basisklasse-implementatie, CBasePane::EnableDocking, uitgebreid door het CBasePane::m_dwControlBarStyle gegevenslid in te stellen op AFX_CBRS_FLOAT. Deze methode geeft vervolgens dwAlignment door aan de basisklasse-implementatie.

CMFCToolBar::EnableLargeIcons

Hiermee schakelt u grote pictogrammen op werkbalkknoppen in of uit.

void EnableLargeIcons(BOOL bEnable);

Parameters

bEnable
[in] TRUE om grote pictogrammen in te schakelen FALSE om grote pictogrammen uit te schakelen.

Opmerkingen

Standaard zijn grote pictogrammen ingeschakeld.

CMFCToolBar::EnableQuickCustomization

Hiermee schakelt u de snelle aanpassing van werkbalken in of uit, zodat de gebruiker op de Alt-toets kan drukken en een knop naar een nieuwe locatie kan slepen.

static void EnableQuickCustomization(BOOL bEnable=TRUE);

Parameters

bEnable
[in] TRUE om snelle aanpassingen mogelijk te maken FALSE snelle aanpassing uit te schakelen.

CMFCToolBar::EnableReflections

Hiermee schakelt u de weerspiegeling van opdrachten in of uit.

void EnableReflections(BOOL bEnable = TRUE);

Parameters

bEnable
[in] TRUE om opdrachtspiegeling in te schakelen; FALSE om opdrachtspiegeling uit te schakelen.

Opmerkingen

Roep deze methode aan om opdrachtspiegeling in te schakelen voor werkbalkknoppen die ingesloten besturingselementen bevatten, zoals keuzelijsten met invoervak.

Zie TN062: Berichtspiegeling voor Windows-besturingselementenvoor meer informatie over opdrachtspiegeling.

CMFCToolBar::EnableTextLabels

Hiermee schakelt u tekstlabels onder afbeeldingen van werkbalkknoppen in of uit.

void EnableTextLabels(BOOL bEnable=TRUE);

Parameters

bEnable
TRUE als tekstlabels worden weergegeven onder afbeeldingen van werkbalkknopen; anders FALSE.

Opmerkingen

Als tekstlabels zijn ingeschakeld, worden alle knoppen op de werkbalk vergroot om ruimte te bieden voor de labels die onder de afbeeldingen moeten worden weergegeven. Het dialoogvenster Aanpassing bevat een Tekstlabel weergeven selectievakje op de werkbalken pagina. Wanneer de gebruiker een werkbalk selecteert en deze optie controleert, roept het framework EnableTextLabels aan voor de geselecteerde werkbalk. U kunt het selectievakje voor een object dat is afgeleid van CMFCToolBar uitschakelen door FALSE van CMFCToolBar::AllowChangeTextLabels te retourneren.

CMFCToolBar::FromHandlePermanent

Hiermee wordt een aanwijzer opgehaald naar het CMFCToolBar-object dat de opgegeven venstergreep bevat.

static CMFCToolBar* __stdcall FromHandlePermanent(HWND hwnd);

Parameters

hwnd
[in] De venstergreep die moet worden gezocht.

Retourwaarde

Een aanwijzer naar het CMFCToolBar-object dat de opgegeven venstergreep bevat of NULL als er geen overeenkomend CMFCToolBar object bestaat.

Opmerkingen

Deze gedeelde methode onderzoekt elke werkbalk in de toepassing voor het CMFCToolBar-object dat de opgegeven venstergreep bevat.

CMFCToolBar::GetAllButtons

Retourneert een alleen-lezen lijst met knoppen op een werkbalk.

const CObList& GetAllButtons() const;

Retourwaarde

Een constante verwijzing naar een CObList Class-object, dat een verzameling CMFCToolBarButton klasse--objecten bevat.

CMFCToolBar::GetAllToolbars

Retourneert een alleen-lezen lijst met alle werkbalken in de toepassing.

static const CObList& GetAllToolbars();

Retourwaarde

Een constverwijzing naar een CObList Class-object dat een verzameling CMFCToolBar objecten bevat.

CMFCToolBar::GetBasicCommands

Retourneert een lijst met alleen-lezen opdrachten die zijn gedefinieerd in de toepassing.

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

Retourwaarde

Een const-verwijzing naar een CList Class-object dat een verzameling basisopdrachten bevat.

Opmerkingen

Voeg basisopdrachten toe door CMFCToolBar::AddBasicCommand of CMFCToolBar::SetBasicCommandsaan te roepen.

CMFCToolBar::GetButton

Retourneert een aanwijzer naar het CMFCToolBarButton Class-object op een opgegeven index.

CMFCToolBarButton* GetButton(int iIndex) const;

Parameters

iIndex
[in] Hiermee geeft u de index van de knop die moet worden geretourneerd.

Retourwaarde

Een aanwijzer naar de werkbalkknop als deze bestaat; of NULL als er geen dergelijke knop is.

CMFCToolBar::GetButtonInfo

Retourneert de opdracht-id, stijl en afbeeldingsindex van de knop bij een opgegeven index.

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

Parameters

nIndex
[in] Hiermee geeft u de index van de knop in de lijst met knoppen op de werkbalk.

nID
[uit] De opdracht-id van een knop.

nStyle
[uit] De stijl van de knop.

iImage
[uit] De index van de afbeelding voor de knop.

Opmerkingen

De methode GetButtonInfo zoekt een werkbalkknop in de opgegeven index en haalt de opdracht-id, stijl en afbeeldingsindex van de knop op.

Als de knop in de opgegeven index niet bestaat, stelt het framework nID en nStyle in op 0 en iImage op -1 wanneer de methode wordt geretourneerd.

CMFCToolBar::GetButtonSize

Retourneert de afmetingen van elke knop op de werkbalk.

CSize GetButtonSize() const;

Retourwaarde

Een CSize Class-object dat de afmetingen van elke knop op de werkbalk aangeeft.

Opmerkingen

Roep CMFCToolBar::SetSizes of CMFCToolBar::SetLockedSizes aan om de afmetingen van elke knop op de werkbalk in te stellen.

CMFCToolBar::GetButtonStyle

Retourneert de huidige stijl van de werkbalkknop die zich in de opgegeven index bevindt.

UINT GetButtonStyle(int nIndex) const;

Parameters

nIndex
[in] Hiermee geeft u de index van een werkbalkknop.

Retourwaarde

Een waarde die de stijl van de werkbalkknop aangeeft. . Zie besturingsstijlen op de werkbalk voor een lijst met mogelijke stijlen.

Opmerkingen

CMFCToolBar::SetButtonStyle aanroepen om de stijl van een werkbalkknop in te stellen

CMFCToolBar::GetButtonText

Retourneert het tekstlabel van een knop met een opgegeven index.

CString GetButtonText(int nIndex) const;

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

Parameters

nIndex
[in] De index van een werkbalkknop.

rString
[uit] De labeltekst van de werkbalkknop.

Retourwaarde

De labeltekst van de werkbalkknop.

Opmerkingen

Roep CMFCToolBar::SetButtonText of CMFCToolBar::SetToolBarBtnText aan om het tekstlabel in te stellen.

CMFCToolBar::GetColdImages

Hiermee wordt een aanwijzer geretourneerd naar de verzameling koude werkbalkknopafbeeldingen in de toepassing.

static CMFCToolBarImages* GetColdImages();

Retourwaarde

Een aanwijzer naar de verzameling koude werkbalkknopafbeeldingen.

Opmerkingen

Koude afbeeldingen zijn de afbeeldingen die worden gebruikt wanneer de gebruiker niet communiceert met de werkbalkknoppen. Roep CMFCToolBar::LoadBitmapEx of CMFCToolBar::LoadBitmap aan om de koude afbeeldingen te laden.

CMFCToolBar::GetColumnWidth

Retourneert de breedte van de werkbalkknoppen.

virtual int GetColumnWidth() const;

Retourwaarde

Een waarde die de breedte van werkbalkknoppen aangeeft.

Opmerkingen

In het framework wordt deze methode aangeroepen om de indeling van de werkbalk te berekenen. Overschrijf deze methode in een afgeleide klasse om een andere kolombreedte voor de werkbalk op te geven.

CMFCToolBar::GetCommandButtons

Retourneert een lijst met knoppen met een opgegeven opdracht-id van alle werkbalken in de toepassing.

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

Parameters

uiCmd
[in] De opdracht-id van de knoppen.

listButtons
[uit] Een verwijzing naar een CObList Class-object dat de lijst met werkbalkknoppen ontvangt.

Retourwaarde

Het aantal knoppen met de opgegeven opdracht-id.

CMFCToolBar::GetCount

Retourneert het aantal knoppen en scheidingstekens op de werkbalk.

int GetCount() const;

Retourwaarde

Het aantal knoppen en scheidingstekens op de werkbalk.

CMFCToolBar::GetCustomizeButton

Hiermee wordt een aanwijzer opgehaald naar het CMFCCustomizeButton-object dat is gekoppeld aan de werkbalk.

CMFCCustomizeButton* GetCustomizeButton();

Retourwaarde

Een aanwijzer naar het CMFCCustomizeButton-object dat is gekoppeld aan de werkbalk.

Opmerkingen

Met deze methode wordt de knop Aanpassen opgehaald die wordt weergegeven aan het einde van de werkbalk. Gebruik de methode CMFCToolBar::EnableCustomizeButton om de knop Aanpassen toe te voegen aan de werkbalk.

U kunt de methode CMFCToolBar::IsExistCustomizeButton aanroepen om te bepalen of de werkbalk een geldig CMFCCustomizeButton-object bevat.

CMFCToolBar::GetDefaultImage

Retourneert de index van de standaardafbeelding voor een werkbalkknop met een opgegeven opdracht-id.

static int GetDefaultImage(UINT uiID);

Parameters

uiID
[in] Hiermee geeft u de opdracht-id van de knop.

Retourwaarde

De index van de werkbalkafbeelding in de gedeelde lijst met afbeeldingen.

Opmerkingen

Gebruik deze gedeelde methode om de index van de standaardafbeelding voor een werkbalkknop op te halen met de opgegeven opdracht-id. De retourwaarde is een index in de gedeelde verzameling werkbalkknopafbeeldingen voor alle werkbalken in de toepassing. Roep de methode CMFCToolBar::GetImages aan om een aanwijzer naar deze verzameling te verkrijgen.

CMFCToolBar::GetDisabledImages

Hiermee wordt een aanwijzer geretourneerd naar de verzameling afbeeldingen die worden gebruikt voor uitgeschakelde werkbalkknoppen in de toepassing.

static CMFCToolBarImages* __stdcall GetDisabledImages();

Retourwaarde

Een aanwijzer naar de verzameling uitgeschakelde afbeeldingen van werkbalkknoppen.

Opmerkingen

Laad de afbeeldingen van de uitgeschakelde werkbalkknop met behulp van de methoden CMFCToolBarEditBoxButton Class en CMFCToolBar::LoadBitmap.

CMFCToolBar::GetDisabledMenuImages

Hiermee wordt een aanwijzer geretourneerd naar de verzameling afbeeldingen die worden gebruikt voor uitgeschakelde menuknoppen in de toepassing.

static CMFCToolBarImages* __stdcall GetDisabledMenuImages();

Retourwaarde

Een aanwijzer naar de verzameling uitgeschakelde menuafbeeldingen.

Opmerkingen

Laad de uitgeschakelde installatiekopieën met behulp van de methode CMFCToolBarEditBoxButton Class.

CMFCToolBar::GetDroppedDownMenu

Hiermee wordt een aanwijzer opgehaald naar het menuknopobject dat momenteel het submenu weergeeft.

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

Parameters

pIndex
[uit] Hiermee ontvangt u de index van de knop in de verzameling werkbalkknoppen.

Retourwaarde

Een aanwijzer naar het menuknopobject dat het submenu of NULL weergeeft als het submenu niet wordt weergegeven.

Opmerkingen

Als deze methode een niet-null-waarde retourneert en pIndex niet is NULL, wordt de waarde die door pIndex wordt verwezen, ingesteld op de index van de menuknop in de verzameling werkbalkknoppen.

CMFCToolBar::GetGrayDisabledButtons

Hiermee geeft u op of de afbeeldingen van uitgeschakelde knoppen grijs worden weergegeven versies van de normale knopafbeeldingen of worden genomen uit de verzameling uitgeschakelde knopafbeeldingen.

BOOL GetGrayDisabledButtons() const;

Retourwaarde

TRUE om de afbeeldingen van uitgeschakelde knoppen te dimmen; FALSE om afbeeldingen te verkrijgen uit de verzameling uitgeschakelde afbeeldingen.

Opmerkingen

Gebruik CMFCToolBar::SetGrayDisabledButtons om te schakelen tussen grijs weergegeven afbeeldingen en de afbeeldingen uit de verzameling uitgeschakelde afbeeldingen.

CMFCToolBar::GetHighlightedButton

Hiermee wordt een aanwijzer geretourneerd naar de werkbalkknop die momenteel is gemarkeerd.

CMFCToolBarButton* GetHighlightedButton() const;

Retourwaarde

Een aanwijzer naar een werkbalkknopobject; of NULL als er geen knop is gemarkeerd.

Opmerkingen

Een werkbalkknop is gemarkeerd als deze de toetsenbordfocus heeft. Een werkbalkknop wordt ook gemarkeerd als de werkbalkknoppen dynamisch worden bijgehouden in deze toepassing (zie CMFCToolBar::GetHotBorder en CMFCToolBar::SetHotBorder) en de muis wijst ernaar wanneer er geen werkbalkknop of menu-item de toetsenbordfocus heeft.

CMFCToolBar::GetHotBorder

Bepaalt of de werkbalkknoppen zijn hot-tracked. Als een knop dynamisch wordt bijgehouden, wordt deze gemarkeerd wanneer de muis er overheen beweegt.

BOOL GetHotBorder() const;

Retourwaarde

TRUE als de werkbalkknoppen dynamisch worden bijgehouden; anders, FALSE.

Opmerkingen

Werkbalkknoppen zijn standaard dynamisch bijgehouden.

CMFCToolBar::GetHotTextColor

Retourneert de tekstkleur van de gemarkeerde werkbalkknoppen.

static COLORREF GetHotTextColor();

Retourwaarde

Een COLORREF waarde die de huidige gemarkeerde tekstkleur vertegenwoordigt.

Opmerkingen

Roep CMFCToolBar::SetHotTextColor aan om een nieuwe tekstkleur in te stellen voor gemarkeerde werkbalkknoppen.

CMFCToolBar::GetHwndLastFocus

Hiermee wordt een ingang geretourneerd naar het venster met de invoerfocus net voordat de werkbalk werd uitgevoerd.

HWND GetHwndLastFocus() const;

Retourwaarde

Een ingang naar het venster dat niet is afgeleid van CMFCBaseToolBar Klasse, die eerder de invoerfocus had; of NULL als er geen dergelijk venster is.

Opmerkingen

Wanneer een CMFCToolBar besturingselement de invoerfocus ontvangt, wordt er een ingang opgeslagen in het venster dat de focus heeft verloren, zodat het later kan worden hersteld.

CMFCToolBar::GetIgnoreSetText

Hiermee geeft u op of aanroepen voor het instellen van knoplabels worden genegeerd.

BOOL GetIgnoreSetText() const;

Retourwaarde

TRUE als oproepen om knoplabels in te stellen worden genegeerd; anders, FALSE.

Opmerkingen

CMFCToolBar::GetImages

Retourneert een aanwijzer naar de verzameling standaardknopafbeeldingen in de toepassing.

static CMFCToolBarImages* GetImages();

Retourwaarde

Een aanwijzer naar het CMFCToolBarImages Class-object met de verzameling standaardafbeeldingen voor alle werkbalken in de toepassing.

Opmerkingen

Deze gedeelde methode biedt toegang tot de verzameling van alle standaardwerkbalkafbeeldingen voor de toepassing. Roep de methode CMFCToolBar::LoadBitmap aan om afbeeldingen toe te voegen aan de verzameling.

CMFCToolBar::GetImageSize

Retourneert de huidige grootte van werkbalkknopafbeeldingen.

CSize GetImageSize() const;

Retourwaarde

Een CSize Class-object dat de huidige grootte van werkbalkknopafbeeldingen vertegenwoordigt.

CMFCToolBar::GetImagesOffset

Retourneert de index offset die wordt gebruikt om de afbeeldingen van de werkbalkknop voor deze werkbalk te vinden in de algemene lijst met werkbalkknopafbeeldingen.

int GetImagesOffset() const;

Retourwaarde

De indexverschil van de werkbalkafbeeldingen.

Opmerkingen

Alle standaardafbeeldingen van de werkbalk worden opgeslagen in de algemene lijst CMFCToolBarImages Class. De afbeeldingen voor elke knop op de werkbalk worden opeenvolgend opgeslagen in die lijst. Als u de index van de afbeelding wilt berekenen, voegt u de index van de knop in de werkbalk toe aan de verschuiving van het begin van de lijst met afbeeldingen voor die werkbalkknop.

Roep CMFCToolBar::ButtonToIndex aan om de index van een werkbalkknop te verkrijgen met een aanwijzer naar de knop.

Roep CMFCToolBar::GetImages aan om een aanwijzer te verkrijgen naar de verzameling werkbalkafbeeldingen.

CMFCToolBar::GetInvalidateItemRect

Hiermee wordt de regio opgehaald van het clientgebied dat opnieuw moet worden getekend voor de knop in de opgegeven index.

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

Parameters

nIndex
[in] De index van de knop waarvoor het clientgebied moet worden opgehaald.

lpRect
[uit] Een aanwijzer naar een RECT-object dat de regio van het clientgebied ontvangt.

Opmerkingen

De parameter lpRect mag niet NULLzijn. Als er geen knop bestaat in de opgegeven index, ontvangt lpRect een RECT object dat is geïnitialiseerd tot nul.

CMFCToolBar::GetItemID

Retourneert de opdracht-id van de werkbalkknop in een opgegeven index.

UINT GetItemID(int nIndex) const;

Parameters

nIndex
[in] Hiermee geeft u de index van de werkbalkknop.

Retourwaarde

De opdracht-id van de werkbalkknop; of nul als de knop met de opgegeven index niet bestaat.

CMFCToolBar::GetItemRect

Retourneert de begrenzingsrechthoek van de knop in een opgegeven index.

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

Parameters

nIndex
[in] Hiermee geeft u de index van een werkbalkknop.

lpRect
[uit] Een aanwijzer naar CRect object dat de coördinaten van de begrenzingsrechthoek van de afbeelding ontvangt.

Opmerkingen

Het CRect-object waarop lpRect punten is ingesteld op 0 als er geen knop op de opgegeven index bestaat.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de GetItemRect methode van de klasse CMFCToolBar gebruikt. Dit codefragment maakt deel uit van het IE Demo-voorbeeld.

CMFCToolBar m_wndToolBar;

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

CMFCToolBar::GetLargeColdImages

Retourneert een aanwijzer naar de verzameling grote koude werkbalkknopafbeeldingen in de toepassing.

static CMFCToolBarImages* GetLargeColdImages();

Retourwaarde

Een aanwijzer naar de verzameling grote koude afbeeldingen.

Opmerkingen

Koude afbeeldingen zijn de afbeeldingen die worden gebruikt wanneer de gebruiker niet communiceert met de werkbalkknoppen. Roep CMFCToolBar::LoadBitmapEx aan om de grote koude afbeeldingen te laden.

CMFCToolBar::GetLargeDisabledImages

Retourneert een aanwijzer naar de verzameling grote uitgeschakelde werkbalkknopafbeeldingen in de toepassing.

static CMFCToolBarImages* GetLargeDisabledImages();

Retourwaarde

Een aanwijzer naar de verzameling grote uitgeschakelde werkbalkknopafbeeldingen.

Opmerkingen

Grote afbeeldingen zijn grote versies van de normale werkbalkknopafbeeldingen. Roep CMFCToolBar::LoadBitmapEx of CMFCToolBar::LoadBitmap aan om de grote afbeeldingen te laden.

CMFCToolBar::GetLargeImages

Hiermee wordt een aanwijzer geretourneerd naar de verzameling grote afbeeldingen van werkbalkknoppen in de toepassing.

static CMFCToolBarImages* GetLargeImages();

Retourwaarde

Een aanwijzer naar de verzameling grote afbeeldingen van werkbalkknoppen.

Opmerkingen

Grote afbeeldingen zijn grote versies van de normale werkbalkknopafbeeldingen. Roep CMFCToolBar::LoadBitmapEx aan om de grote afbeeldingen te laden.

CMFCToolBar::GetLockedColdImages

Hiermee wordt een aanwijzer geretourneerd naar de verzameling vergrendelde koude afbeeldingen op de werkbalk.

CMFCToolBarImages* GetLockedColdImages();

Retourwaarde

Een aanwijzer naar de verzameling vergrendelde koude afbeeldingen of NULL als de werkbalk niet is vergrendeld.

Opmerkingen

Vergrendelde installatiekopieën zijn versies van de normale werkbalkknopafbeeldingen die door het framework worden gebruikt wanneer de gebruiker de werkbalk niet kan aanpassen. Koude afbeeldingen zijn de afbeeldingen die worden gebruikt wanneer de gebruiker niet communiceert met de werkbalkknoppen.

Deze methode retourneert NULL als de werkbalk niet is vergrendeld. Met deze methode wordt ook een assertiefout gegenereerd in builds voor foutopsporing als de werkbalk niet is vergrendeld. Zie CMFCToolBar::IsLockedvoor meer informatie over vergrendelde werkbalken.

Roep de CMFCToolBar::LoadBitmapEx methode aan om de vergrendelde koude installatiekopieën te laden.

CMFCToolBar::GetLockedDisabledImages

Hiermee wordt een aanwijzer geretourneerd naar de verzameling vergrendelde uitgeschakelde afbeeldingen op de werkbalk.

CMFCToolBarImages* GetLockedDisabledImages();

Retourwaarde

Een aanwijzer naar de verzameling vergrendelde uitgeschakelde afbeeldingen of NULL als de werkbalk niet is vergrendeld.

Opmerkingen

Vergrendelde installatiekopieën zijn versies van de normale werkbalkknopafbeeldingen die door het framework worden gebruikt wanneer de gebruiker de werkbalk niet kan aanpassen. Uitgeschakelde installatiekopieën zijn de afbeeldingen die door het framework worden gebruikt wanneer een knop de stijl TBBS_DISABLED heeft.

Deze methode retourneert NULL als de werkbalk niet is vergrendeld. Met deze methode wordt ook een assertiefout gegenereerd in builds voor foutopsporing als de werkbalk niet is vergrendeld. Zie CMFCToolBar::IsLockedvoor meer informatie over vergrendelde werkbalken.

Roep de CMFCToolBar::LoadBitmapEx methode aan om de vergrendelde uitgeschakelde installatiekopieën te laden.

CMFCToolBar::GetLockedImages

Hiermee wordt een aanwijzer geretourneerd naar de verzameling vergrendelde knopafbeeldingen op de werkbalk.

CMFCToolBarImages* GetLockedImages();

Retourwaarde

Een aanwijzer naar de verzameling afbeeldingen van vergrendelde werkbalkknoppen of NULL als de werkbalk niet is vergrendeld.

Opmerkingen

Vergrendelde installatiekopieën zijn versies van de normale werkbalkknopafbeeldingen die door het framework worden gebruikt wanneer de gebruiker de werkbalk niet kan aanpassen.

Deze methode retourneert NULL als de werkbalk niet is vergrendeld. Met deze methode wordt ook een assertiefout gegenereerd in builds voor foutopsporing als de werkbalk niet is vergrendeld. Zie CMFCToolBar::IsLockedvoor meer informatie over vergrendelde werkbalken.

CMFCToolBar::GetLockedImageSize

Retourneert de standaardgrootte van vergrendelde werkbalkafbeeldingen.

CSize GetLockedImageSize() const;

Retourwaarde

Een CSize structuur die de grootte van vergrendelde werkbalkafbeeldingen of een lege CSize structuur aangeeft als de werkbalk niet is vergrendeld.

Opmerkingen

Vergrendelde installatiekopieën zijn versies van de normale werkbalkknopafbeeldingen die door het framework worden gebruikt wanneer de gebruiker de werkbalk niet kan aanpassen.

Deze methode retourneert een CSize structuur met nulbreedte en nulhoogte als de werkbalk niet is vergrendeld. Met deze methode wordt ook een assertiefout gegenereerd in builds voor foutopsporing als de werkbalk niet is vergrendeld. Zie CMFCToolBar::IsLockedvoor meer informatie over vergrendelde werkbalken.

Roep de methode CMFCToolBar::SetLockedSizes aan om de grootte van de vergrendelde installatiekopieën op te geven.

CMFCToolBar::GetLockedMenuImages

Retourneert een aanwijzer naar de verzameling vergrendelde werkbalkmenuafbeeldingen op de werkbalk.

CMFCToolBarImages* GetLockedMenuImages();

Retourwaarde

Een aanwijzer naar de verzameling vergrendelde werkbalkmenuafbeeldingen of NULL als de werkbalk niet is vergrendeld.

Opmerkingen

Vergrendelde installatiekopieën zijn versies van de normale werkbalkmenuafbeeldingen die door het framework worden gebruikt wanneer de gebruiker de werkbalk niet kan aanpassen.

Deze methode retourneert NULL als de werkbalk niet is vergrendeld. Met deze methode wordt ook een assertiefout gegenereerd in builds voor foutopsporing als de werkbalk niet is vergrendeld. Zie CMFCToolBar::IsLockedvoor meer informatie over vergrendelde werkbalken.

Roep de CMFCToolBar::LoadBitmapEx methode aan om de vergrendelde menuafbeeldingen te laden.

CMFCToolBar::GetMenuButtonSize

Retourneert de grootte van menuknoppen in de toepassing.

static CSize GetMenuButtonSize();

Retourwaarde

Een CSize-object dat de grootte van menuknoppen in pixels vertegenwoordigt.

Opmerkingen

De grootte van menuknoppen op werkbalken wordt gehandhaafd als een globale variabele en kan worden opgehaald door deze statische methode.

Roep CMFCToolBar::SetMenuSizes aan om deze globale variabele in te stellen.

CMFCToolBar::GetMenuImages

Retourneert een aanwijzer naar de verzameling menuknopafbeeldingen in de toepassing.

static CMFCToolBarImages* GetMenuImages();

Retourwaarde

Een aanwijzer naar de verzameling menuafbeeldingen.

Opmerkingen

Roep de methode CMFCToolBar::LoadBitmapEx aan om de menuafbeeldingen te laden.

Roep de methode CMFCToolBar::SetMenuSizes aan om de grootte van knoppen en de bijbehorende afbeeldingen in te stellen.

CMFCToolBar::GetMenuImageSize

Retourneert de grootte van menuknopafbeeldingen in de toepassing.

static CSize GetMenuImageSize();

Retourwaarde

Een CSize-object dat de grootte van menuafbeeldingen vertegenwoordigt.

Opmerkingen

Deze methode retourneert de grootte van afbeeldingen op werkbalkmenuknoppen die worden onderhouden als een globale variabele. Roep CMFCToolBar::SetMenuSizes aan om deze globale variabele in te stellen.

CMFCToolBar::GetOrigButtons

Hiermee haalt u de verzameling niet-aangepaste knoppen van de werkbalk op.

const CObList& GetOrigButtons() const;

Retourwaarde

Een verwijzing naar de lijst met niet-aangepaste knoppen van de werkbalk.

Opmerkingen

Het framework maakt een kopie van werkbalkknoppen voordat deze door de gebruiker worden aangepast. Met de methode CMFCToolBar::SetButtons wordt een kopie van elke knop in de opgegeven matrix toegevoegd aan de lijst met oorspronkelijke knoppen. Met de methode CMFCToolBar::RestoreOriginalState wordt de oorspronkelijke status van de werkbalk hersteld door deze uit het resourcebestand te laden.

Als u de lijst met oorspronkelijke knoppen voor de werkbalk wilt instellen, roept u de methode CMFCToolBar::SetOrigButtons aan.

CMFCToolBar::GetOrigResetButtons

Hiermee haalt u de verzameling niet-aangepaste resetknoppen van de werkbalk op.

const CObList& GetOrigResetButtons() const;

Retourwaarde

Een verwijzing naar de lijst met niet-aangepaste resetknoppen van de werkbalk.

Opmerkingen

Wanneer de gebruiker de knop Opnieuw instellen selecteert tijdens de aanpassingsmodus, gebruikt het framework deze methode om knoppen te herstellen die zijn verwijderd uit de werkbalk.

Met de methode CMFCToolBar::SetButtons wordt een kopie van elke werkbalkknop toegevoegd aan de lijst met oorspronkelijke resetknoppen nadat de methode CMFCToolBar::OnReset is aangeroepen. U kunt de methode CMFCToolBar::OnReset overschrijven om het uiterlijk van knoppen aan te passen nadat de gebruiker op de knop Opnieuw instellen drukt.

CMFCToolBar::GetResourceID

Haalt de resource-id van de werkbalk op.

UINT GetResourceID() const;

Retourwaarde

De resource-id van de werkbalk.

Opmerkingen

Roep de methode CMFCToolBar::LoadToolBarEx aan om de resource-id van de werkbalk in te stellen.

CMFCToolBar::GetRouteCommandsViaFrame

Bepaalt welk object, het bovenliggende frame of de eigenaar, opdrachten naar de werkbalk verzendt.

BOOL GetRouteCommandsViaFrame();

Retourwaarde

Niet-nul als het bovenliggende frame opdrachten naar de werkbalk verzendt; 0 als de eigenaar opdrachten naar de werkbalk verzendt.

Opmerkingen

Standaard verzendt het bovenliggende frame opdrachten naar de werkbalk. Roep CMFCToolBar::SetRouteCommandsViaFrame aan om dit gedrag te wijzigen.

Als deze methode een niet-nulwaarde retourneert, kunt u een aanwijzer ophalen naar het bovenliggende frameobject met behulp van de methode CMFCToolBar::GetCommandTarget. Zie het VisualStudioDemo-voorbeeld voor een voorbeeld waarin deze methode wordt gebruikt.

CMFCToolBar::GetRowHeight

Retourneert de hoogte van werkbalkknoppen.

virtual int GetRowHeight() const;

Retourwaarde

De hoogte van werkbalkknoppen, in pixels.

Opmerkingen

In het framework wordt deze methode aangeroepen om de indeling van de werkbalk te berekenen. Overschrijf deze methode in een afgeleide klasse om een andere hoogte voor de werkbalk op te geven.

CMFCToolBar::GetShowTooltips

Hiermee geeft u op of knopinfo wordt weergegeven voor werkbalkknoppen.

static BOOL GetShowTooltips();

Retourwaarde

TRUE als knopinfo wordt weergegeven voor werkbalkknoppen; anders FALSE.

Opmerkingen

Standaard worden knopinfo weergegeven. U kunt deze statische vlag wijzigen door CMFCToolBar::SetShowTooltipsaan te roepen.

CMFCToolBar::GetSiblingToolBar

Hiermee haalt u het niveau van de werkbalk op.

CMFCToolBar* GetSiblingToolBar();

Retourwaarde

Een aanwijzer naar de werkbalk op hetzelfde niveau.

Opmerkingen

Zie CMFCToolBar::SetSiblingToolBarvoor meer informatie over het inschakelen van de Knoppen weergeven op één rij en Knoppen weergeven op twee rijen.

CMFCToolBar::GetUserImages

Hiermee wordt een aanwijzer geretourneerd naar de verzameling door de gebruiker gedefinieerde werkbalkknopafbeeldingen in de toepassing.

static CMFCToolBarImages* GetUserImages();

Retourwaarde

Een aanwijzer naar de verzameling door de gebruiker gedefinieerde werkbalkknopafbeeldingen voor alle werkbalken in de toepassing.

Opmerkingen

Roep de methode CMFCToolBar::SetUserImages aan om de verzameling door de gebruiker gedefinieerde installatiekopieën in de toepassing in te stellen.

CMFCToolBar::HitTest

Retourneert de index van de werkbalkknop die zich op de opgegeven positie bevindt.

virtual int HitTest(CPoint point);

Parameters

point
[in] Het punt dat moet worden getest, in clientcoördinaten.

Retourwaarde

De index van de knop die zich op de opgegeven positie bevindt of -1 als er geen dergelijke knop is of als de knop een scheidingsteken is.

CMFCToolBar::InsertButton

Hiermee voegt u een knop in de werkbalk in.

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

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

Parameters

button
[in] Hiermee geeft u de knop die moet worden ingevoegd.

iInsertAt
[in] Hiermee geeft u de op nul gebaseerde positie op om de knop in te voegen.

Retourwaarde

De positie waarop de knop is ingevoegd of -1 als er een fout optreedt.

Opmerkingen

Als iInsertAt -1 is, wordt met deze methode de knop toegevoegd aan het einde van de lijst met werkbalkknoppen.

Roep de methode CMFCToolBar::InsertSeparator aan om een scheidingsteken in de werkbalk in te voegen.

CMFCToolBar::InsertSeparator

Hiermee voegt u een scheidingsteken in de werkbalk in.

virtual int InsertSeparator(INT_PTR iInsertAt=-1);

Parameters

iInsertAt
[in] Hiermee geeft u de positie op basis van nul op om het scheidingsteken in te voegen. Deze parameter moet groter zijn dan 0.

Retourwaarde

De positie waarop het scheidingsteken is ingevoegd of -1 als er een fout optreedt.

Opmerkingen

Roep deze methode aan om een scheidingsteken tussen twee bestaande knoppen in te voegen. Als iInsertAt -1 is, voegt deze methode het scheidingsteken toe aan het einde van de lijst met werkbalkknoppen.

U kunt deze methode niet gebruiken om een scheidingsteken toe te voegen aan een lege werkbalk.

Roep de methode CMFCToolBar::InsertButton aan om een knop in de werkbalk in te voegen.

CMFCToolBar::InvalidateButton

Ongeldig het clientgebied van de werkbalkknop die aanwezig is in de opgegeven index.

CMFCToolBarButton* InvalidateButton(int nIndex);

Parameters

nIndex
[in] De op nul gebaseerde index van de knop op de werkbalk.

Retourwaarde

Een aanwijzer naar het CMFCToolBarButton-object dat bestaat in de opgegeven index of NULL als er geen dergelijk object bestaat.

Opmerkingen

Dit framework roept deze methode aan wanneer het clientgebied dat is gekoppeld aan een werkbalkknop, wordt bijgewerkt. Hiermee wordt de CWnd::InvalidateRect methode aangeroepen met de clientrechthoek van het CMFCToolBarButton-object dat bestaat in de opgegeven index.

CMFCToolBar::IsAddRemoveQuickCustomize

Bepaalt of een gebruiker werkbalkknoppen kan toevoegen of verwijderen met behulp van de menuoptie Aanpassen.

BOOL IsAddRemoveQuickCustomize();

Retourwaarde

TRUE als een gebruiker de menuoptie Aanpassen kan gebruiken om de werkbalk te wijzigen; anders, FALSE.

Opmerkingen

CMFCToolBar::IsAltCustomizeMode

Hiermee geeft u op of snelle aanpassing wordt gebruikt om een knop te slepen. Wanneer snelle aanpassing is ingeschakeld, kan een gebruiker de Alt-toets ingedrukt houden en een knop naar een nieuwe locatie slepen.

static BOOL __stdcall IsAltCustomizeMode();

Retourwaarde

TRUE als snelle aanpassing wordt gebruikt om een knop te slepen; anders, FALSE.

Opmerkingen

CMFCToolBar::IsAutoGrayInactiveImages

Hiermee geeft u op of het automatisch genereren van inactieve (niet-gemarkeerde) knopafbeeldingen is ingeschakeld.

static BOOL IsAutoGrayInactiveImages();

Retourwaarde

TRUE als de optie voor het automatisch dimen van inactieve afbeeldingen is ingeschakeld; anders FALSE.

Opmerkingen

U kunt automatisch dimmen van inactieve afbeeldingen in- of uitschakelen door CMFCToolBar::AutoGrayInactiveImagesaan te roepen.

CMFCToolBar::IsBasicCommand

Bepaalt of een opdracht in de lijst met basisopdrachten staat.

static BOOL IsBasicCommand(UINT uiCmd);

Parameters

uiCmd
[in] Hiermee geeft u de opdracht te controleren.

Retourwaarde

TRUE als de opgegeven opdracht behoort tot de lijst met basisopdrachten; anders FALSE.

Opmerkingen

Deze statische methode bepaalt of de opdracht die is opgegeven door uiCmd deel uitmaakt van de algemene lijst met basisopdrachten. U kunt de lijst met basisopdrachten wijzigen door CMFCToolBar::AddBasicCommand of CMFCToolBar::SetBasicCommandsaan te roepen.

CMFCToolBar::IsButtonExtraSizeAvailable

Bepaalt of de werkbalk knoppen met uitgebreide randen kan weergeven.

virtual BOOL IsButtonExtraSizeAvailable() const;

Retourwaarde

TRUE als de balk knoppen met de extra randgrootte kan weergeven; anders FALSE.

Opmerkingen

Het werkbalkobject retourneert TRUE als deze knoppen met uitgebreide randen kan weergeven. Met een werkbalkknop wordt deze methode aangeroepen wanneer deze de melding CMFCToolBarButton::OnChangeParentWnd verwerkt en wordt de vlag voor de interne extra randgrootte dienovereenkomstig ingesteld. Deze interne vlag kan later worden opgehaald door CMFCToolBarButton::IsExtraSizeaan te roepen.

Overschrijf deze methode in een klasse die is afgeleid van CMFCToolBar en retourneer TRUE als de balk de werkbalkknoppen met de extra randgrootte kan weergeven en FALSE anders kan retourneren. De standaard implementatie retourneert TRUE.

CMFCToolBar::IsButtonHighlighted

Bepaalt of de opgegeven knop is gemarkeerd.

BOOL IsButtonHighlighted(int iButton) const;

Parameters

iButton
[in] Hiermee geeft u de index van een werkbalkknop.

Retourwaarde

TRUE als de opgegeven knop is gemarkeerd; anders, FALSE.

Opmerkingen

CMFCToolBar::IsCommandPermitted

Bepaalt of een opdracht is toegestaan.

static BOOL IsCommandPermitted(UINT uiCmd);

Parameters

uiCmd
[in] Hiermee geeft u de opdracht te controleren.

Retourwaarde

TRUE als de opgegeven opdracht is toegestaan; anders FALSE.

Opmerkingen

Deze statische methode bepaalt of de opdracht die is opgegeven door uiCmd behoort tot de globale lijst met niet-toegestane opdrachten.

U kunt de lijst met niet-toegestane opdrachten wijzigen door CMFCToolBar::SetNonPermittedCommandsaan te roepen.

CMFCToolBar::IsCommandRarelyUsed

Bepaalt of een opdracht zelden wordt gebruikt.

static BOOL IsCommandRarelyUsed(UINT uiCmd);

Parameters

uiCmd
[in] Hiermee geeft u de opdracht te controleren.

Retourwaarde

TRUE als de opgegeven opdracht zelden wordt gebruikt; anders FALSE.

Opmerkingen

De methode IsCommandRarelyUsed retourneert FALSE wanneer een of meer van de volgende voorwaarden optreden:

• De opgegeven opdracht behoort tot de lijst met basisopdrachten

• De opgegeven opdracht is een van de standaardopdrachten

• Het framework bevindt zich in de aanpassingsmodus

• De lijst met basisopdrachten is leeg

• Meer dan 20% opdrachtoproepen worden aanroepen naar de opgegeven opdracht.

CMFCToolBar::IsCustomizeMode

Hiermee geeft u op of het werkbalkframework zich in de aanpassingsmodus bevindt.

static BOOL IsCustomizeMode();

Retourwaarde

TRUE als het framework zich in de aanpassingsmodus bevindt; anders FALSE.

Opmerkingen

U kunt de aanpassingsmodus in-/uitschakelen door CMFCToolBar::SetCustomizeModeaan te roepen.

Het framework wijzigt de modus wanneer de gebruiker het dialoogvenster aanpassing aanroept (CMFCToolBarsCustomizeDialog Class).

CMFCToolBar::IsDragButton

Bepaalt of een werkbalkknop wordt gesleept.

BOOL IsDragButton(const CMFCToolBarButton* pButton) const;

Parameters

pButton
[in] Aanwijzer naar een werkbalkknop.

Retourwaarde

TRUE als de opgegeven knop wordt gesleept; anders, FALSE.

Opmerkingen

CMFCToolBar::IsExistCustomizeButton

Bepaalt of de werkbalk de knop Aanpassen bevat.

BOOL IsExistCustomizeButton();

Retourwaarde

TRUE als de werkbalk de knop Aanpassen bevat; anders FALSE.

Opmerkingen

Als deze methode TRUEretourneert, retourneert de CMFCToolBar::GetCustomizeButton methode een aanwijzer naar de knop Aanpassen die wordt weergegeven aan het einde van de werkbalk.

Gebruik de methode CMFCToolBar::EnableCustomizeButton om de knop Aanpassen toe te voegen aan de werkbalk.

CMFCToolBar::IsFloating

Bepaalt of de werkbalk zwevend is.

virtual BOOL IsFloating() const;

Retourwaarde

TRUE als de werkbalk zwevend is; anders, FALSE.

CMFCToolBar::IsLargeIcons

Hiermee geeft u op of werkbalken in de toepassing momenteel grote pictogrammen weergeven.

static BOOL IsLargeIcons();

Retourwaarde

TRUE als de toepassing gebruikmaakt van grote pictogrammen; anders FALSE.

Opmerkingen

Roep CMFCToolBar::SetLargeIcons aan om tussen grote pictogrammen en reguliere pictogrammen te schakelen.

In het framework wordt de modus automatisch gewijzigd wanneer de gebruiker de Grote pictogrammen selectievakje inschakelt op de pagina Opties van het dialoogvenster Aanpassing.

CMFCToolBar::IsLastCommandFromButton

Bepaalt of de laatst uitgevoerde opdracht is verzonden vanaf de opgegeven werkbalkknop.

static BOOL IsLastCommandFromButton(CMFCToolBarButton* pButton);

Parameters

pButton
[in] Aanwijzer naar knop.

Retourwaarde

TRUE als de laatste opdracht is verzonden vanaf de knop die pButton specificeert; anders FALSE.

Opmerkingen

Met deze methode wordt een aanwijzer naar een MSG Structuur- verkregen door CWnd::GetCurrentMessageaan te roepen. Vervolgens worden de HWND van de knop vergeleken met de MSG::lParam en MSG::hwnd leden om te bepalen of de knop de bron van de opdracht was.

CMFCToolBar::IsLocked

Bepaalt of de werkbalk is vergrendeld.

BOOL IsLocked() const;

Retourwaarde

TRUE als de werkbalk is vergrendeld; anders, FALSE.

Opmerkingen

Deze methode retourneert TRUE wanneer de gebruiker geen aanpassingstaken kan uitvoeren, zoals werkbalkknoppen verplaatsen.

Vergrendelde werkbalken maken gebruik van afzonderlijke afbeeldingslijsten. Zie CMFCToolBar::LoadBitmapExvoor meer informatie over deze afbeeldingslijsten.

CMFCToolBar::IsOneRowWithSibling

Bepaalt of de werkbalk en de bijbehorende werkbalk op hetzelfde niveau in dezelfde rij staan.

BOOL IsOneRowWithSibling();

Retourwaarde

TRUE als de werkbalk en het bijbehorende niveau op dezelfde rij staan; anders FALSE.

Opmerkingen

Met de methode CMFCCustomizeButton::CreatePopupMenu wordt deze methode aangeroepen om te bepalen hoe u het snelmenu Aanpassen kunt weergeven. Als deze methode TRUEretourneert, wordt in het framework de knop Knoppen weergeven op één rij weergegeven. Anders wordt in het framework de knop Knoppen weergeven weergegeven op twee rijen.

Normaal gesproken hoeft u deze methode niet te gebruiken. Als u de Knoppen weergeven op één rij of knoppen weergeven op twee rijen knoppen wilt inschakelen, roept u CMFCToolBar::SetSiblingToolBaraan.

CMFCToolBar::IsResourceChanged

virtual BOOL IsResourceChanged() const;

Retourwaarde

Opmerkingen

CMFCToolBar::IsSibling

BOOL IsSibling();

Retourwaarde

Opmerkingen

CMFCToolBar::IsUserDefined

Hiermee geeft u op of de werkbalk door de gebruiker is gedefinieerd.

BOOL IsUserDefined() const;

Retourwaarde

TRUE als de werkbalk door de gebruiker is gemaakt; anders FALSE.

CMFCToolBar::LoadBitmap

Hiermee worden werkbalkafbeeldingen uit toepassingsbronnen geladen.

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

Parameters

uiResID
[in] De resource-id van de bitmap die verwijst naar de dynamische werkbalkafbeeldingen.

uiColdResID
[in] De resource-id van de bitmap die verwijst naar de afbeeldingen van de koude werkbalk.

uiMenuResID
[in] De resource-id van de bitmap die verwijst naar de normale menuafbeeldingen.

bLocked
[in] TRUE om de werkbalk te vergrendelen; anders FALSE.

uiDisabledResID
[in] De resource-id van de bitmap die verwijst naar de uitgeschakelde werkbalkafbeeldingen.

uiMenuDisabledResID
[in] De resource-id van de bitmap die verwijst naar de uitgeschakelde menuafbeeldingen.

Retourwaarde

Niet-nul als de methode slaagt; anders 0.

Opmerkingen

Met de methode CMFCToolBar::LoadToolBarEx wordt deze methode aangeroepen om de afbeeldingen te laden die aan de werkbalk zijn gekoppeld. Overschrijf deze methode om aangepaste laadbewerkingen van afbeeldingsresources uit te voeren.

Roep de methode LoadBitmapEx aan om extra afbeeldingen te laden nadat u de werkbalk hebt gemaakt.

CMFCToolBar::LoadBitmapEx

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

Parameters

[in] params
[in] bLocked

Retourwaarde

Opmerkingen

CMFCToolBar::LoadLargeIconsState

static BOOL __stdcall LoadLargeIconsState(LPCTSTR lpszProfileName = NULL);

Parameters

[in] lpszProfileName

Retourwaarde

Opmerkingen

CMFCToolBar::LoadParameters

Hiermee worden algemene werkbalkopties uit het Windows-register geladen.

static BOOL LoadParameters(LPCTSTR lpszProfileName=NULL);

Parameters

lpszProfileName
[in] Hiermee geeft u het relatieve pad van de Windows-registersleutel.

Retourwaarde

Niet-nul als de methode slaagt; anders 0.

Opmerkingen

Met deze methode worden globale parameters geladen, zoals het menuanimatietype, de schaduwstijl van het menu en of grote pictogrammen uit het Windows-register moeten worden weergegeven.

De methode CWinAppEx::LoadState roept deze methode aan als onderdeel van het initialisatieproces van de toepassing.

CMFCToolBar::LoadState

Laadt de informatie over de status van de werkbalk uit het Windows-register.

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

Parameters

lpszProfileName
[in] Hiermee geeft u het relatieve pad van de Windows-registersleutel.

nIndex
[in] Hiermee geeft u de besturings-id van de werkbalk.

uiID
[in] Hiermee geeft u de resource-id van de werkbalk.

Retourwaarde

Niet-nul als de methode slaagt; anders 0.

Opmerkingen

Dit framework roept deze methode aan als onderdeel van het initialisatieproces van de toepassing. Zie CWinAppEx::LoadStatevoor meer informatie.

CMFCToolBar::LoadToolBar

Laadt de werkbalk van toepassingsbronnen.

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

Parameters

uiResID
[in] De resource-id van de werkbalk.

uiColdResID
[in] De resource-id van de bitmap die verwijst naar de afbeeldingen van de koude werkbalk.

uiMenuResID
[in] De resource-id van de bitmap die verwijst naar de normale menuafbeeldingen.

bLocked
[in] Een Booleaanse waarde die aangeeft of de werkbalk is vergrendeld of niet. Als deze parameter is TRUE, is de werkbalk vergrendeld. Anders is de werkbalk niet vergrendeld.

uiDisabledResID
[in] De resource-id van de bitmap die verwijst naar de uitgeschakelde werkbalkafbeeldingen.

uiMenuDisabledResID
[in] De resource-id van de bitmap die verwijst naar de uitgeschakelde menuafbeeldingen.

uiHotResID
[in] De resource-id van de bitmap die verwijst naar de dynamische werkbalkafbeeldingen.

Retourwaarde

Niet-nul als de methode slaagt; anders 0.

Opmerkingen

In het framework wordt deze methode aangeroepen tijdens de initialisatie om de afbeeldingen te laden die aan de werkbalk zijn gekoppeld.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de methode LoadToolBar gebruikt in de klasse CMFCToolBar. Dit codefragment maakt deel uit van het IE Demo-voorbeeld.

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

Laadt de werkbalk van toepassingsresources met behulp van de CMFCToolBarInfo helperklasse om de toepassing in staat te stellen grote installatiekopieën te gebruiken.

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

Parameters

uiToolbarResID
[in] De resource-id van de werkbalk.

params
[in] Een verwijzing naar een CMFCToolBarInfo-object met de resource-id's voor de werkbalkafbeeldingen.

bLocked
[in] Een Booleaanse waarde die aangeeft of de werkbalk is vergrendeld of niet. Als deze parameter is TRUE, is de werkbalk vergrendeld. Anders is de werkbalk niet vergrendeld.

Retourwaarde

Niet-nul als de methode slaagt; anders 0.

Opmerkingen

Roep deze methode aan om werkbalkafbeeldingen uit de toepassingsbronnen te laden.

CMFCToolBar::m_dblLargeImageRatio

Hiermee geeft u de verhouding tussen de dimensie (hoogte of breedte) van grote afbeeldingen en de dimensie van reguliere afbeeldingen.

AFX_IMPORT_DATA static double m_dblLargeImageRatio;

Opmerkingen

De standaardverhouding is 2. U kunt deze waarde wijzigen om grote werkbalkafbeeldingen groter of kleiner te maken.

Het framework gebruikt dit gegevenslid wanneer u geen set grote installatiekopieën opgeeft. Als u bijvoorbeeld alleen de set kleine afbeeldingen met een grootte van 16x16 opgeeft en u wilt dat de grote afbeeldingen de grootte 24x24 hebben, stelt u dit gegevenslid in op 1,5.

CMFCToolBar::NextMenu

virtual BOOL NextMenu();

Retourwaarde

Opmerkingen

CMFCToolBar::OnBeforeRemoveButton

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

Parameters

pButton
[in] Ongebruikt.

dropEffect
[in] Ongebruikt.

Retourwaarde

Opmerkingen

CMFCToolBar::OnChangeHot

Aangeroepen door het framework wanneer een gebruiker een knop op de werkbalk selecteert.

virtual void OnChangeHot(int iHot);

Parameters

iHot
[in] Hiermee geeft u de index van de werkbalkknop die is geselecteerd; of -1 als er geen werkbalkknop is geselecteerd.

Opmerkingen

Overschrijf deze methode om meldingen te verwerken die de gebruiker op een werkbalk heeft geselecteerd.

CMFCToolBar::OnChangeVisualManager

virtual void OnChangeVisualManager();

Opmerkingen

CMFCToolBar::OnFillBackground

Aangeroepen door het framework van CBasePane::DoPaint om de achtergrond van de werkbalk te vullen.

virtual void OnFillBackground(CDC* pDC);

Parameters

pDC
[in] Een aanwijzer naar een apparaatcontext.

Opmerkingen

CMFCToolBar::DoPaint roept deze methode aan wanneer de achtergrond van een werkbalk is gevuld. De standaard implementatie doet niets.

Overschrijf deze methode om aangepaste achtergrond te tekenen in afgeleide klassen.

CMFCToolBar::OnGlobalFontsChanged

virtual void OnGlobalFontsChanged();

Opmerkingen

CMFCToolBar::OnReset

Hiermee wordt de werkbalk terugzet naar de oorspronkelijke staat.

virtual void OnReset();

Opmerkingen

Overschrijf deze methode voor het afhandelen van meldingen over het opnieuw instellen van een werkbalk.

De standaard implementatie doet niets. Overschrijf OnReset in een klasse die is afgeleid van CMFCToolBar wanneer de werkbalk dummyknoppen bevat die moeten worden vervangen wanneer de werkbalk terugkeert naar de oorspronkelijke staat.

CMFCToolBar::OnSetAccData

virtual BOOL OnSetAccData(long lVal);

Parameters

[in] lVal

Retourwaarde

Opmerkingen

CMFCToolBar::OnSetDefaultButtonText

Hiermee herstelt u de tekst van een werkbalkknop naar de standaardstatus.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

Parameters

pButton
[in] Verwijst naar een knop, waarvan de tekst wordt ingesteld.

Retourwaarde

TRUE als de tekst is hersteld; anders FALSE.

Opmerkingen

Overschrijf deze methode voor het verwerken van meldingen dat de tekst van een werkbalkknop wordt gewijzigd in de standaardinstelling.

Met de standaard implementatie wordt de tekst van een knop uit de toepassingsbronnen geladen.

CMFCToolBar::OnUserToolTip

Aangeroepen door het framework wanneer de knopinfo voor een knop op het punt staat te worden weergegeven.

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

Parameters

pButton
[in] Verwijst naar een werkbalkknop waarvoor knopinfo moet worden weergegeven.

strTTText
[uit] Een verwijzing naar CString object dat de tekst van de knopinfo ontvangt.

Retourwaarde

TRUE als strTTText is gevuld met knopinfo; anders FALSE.

Opmerkingen

In het framework wordt deze methode aangeroepen wanneer de knopinfo voor een werkbalkknop op het punt staat te worden weergegeven. Als OnUserToolTipTRUEretourneert, geeft het framework knopinfo weer die de tekst bevat die wordt geretourneerd door OnUserToolTip in strTTText. Anders bevat de knopinfo de knoptekst.

Overschrijf OnUserToolTip om knopinfo van werkbalkknoppen aan te passen. De standaard implementatie roept CMFCToolBar::OnUserToolTip aan om de knopinfotekst te verkrijgen.

CMFCToolBar::PrevMenu

virtual BOOL PrevMenu();

Retourwaarde

Opmerkingen

CMFCToolBar::ProcessCommand

Hiermee plaatst u een WM_COMMAND bericht in het venster dat eigenaar is van de werkbalk.

BOOL ProcessCommand(CMFCToolBarButton* pButton);

Parameters

pButton
[in] Aanwijzer naar een knop op de werkbalk.

Retourwaarde

Deze methode moet altijd TRUEretourneren. MFC maakt intern gebruik van FALSE waarden.

Opmerkingen

Met deze methode wordt een WM_COMMAND bericht geplaatst in het venster dat eigenaar is van de werkbalk door CWnd::PostMessage aan te roepen en de opdracht-id van de opgegeven knop door te geven als de parameter wParam.

Gebruik de macro ON_COMMAND om het WM_COMMAND bericht toe te wijzen aan een lidfunctie.

CMFCToolBar::RemoveAllButtons

Hiermee verwijdert u alle knoppen en scheidingstekens van de werkbalk.

virtual void RemoveAllButtons();

Opmerkingen

In het framework wordt deze methode aangeroepen wanneer deze een werkbalk opnieuw maakt of vernietigt.

CMFCToolBar::RemoveButton

Hiermee verwijdert u de knop uit de werkbalk met de opgegeven index.

virtual BOOL RemoveButton(int iIndex);

Parameters

iIndex
[in] Hiermee geeft u de op nul gebaseerde index van de knop te verwijderen.

Retourwaarde

TRUE of de methode slaagt of FALSE als de opgegeven index ongeldig is of de index verwijst naar de knop Aanpassen.

Opmerkingen

Met deze methode worden extra werkbalkkenmerken bijgewerkt die worden beïnvloed door het verwijderen van de knop. Met deze methode worden bijvoorbeeld niet-essentiële scheidingstekens uit de werkbalk verwijderd en wordt de tabel met sneltoetsen opnieuw opgebouwd.

Zie CMFCToolBar::EnableCustomizeButtonvoor meer informatie over de knop aanpassen.

CMFCToolBar::RemoveStateFromRegistry

Hiermee verwijdert u de statusinformatie voor de werkbalk uit het Windows-register.

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

Parameters

lpszProfileName
[in] Hiermee geeft u de registersleutel op waar de statusinformatie zich bevindt.

nIndex
[in] De besturingselement-id van de werkbalk.

uiID
[in] De resource-id van de werkbalk. Als deze parameter -1 is, gebruikt deze methode de CWnd::GetDlgCtrlID methode om de resource-id op te halen.

Retourwaarde

Niet-nul als de methode slaagt; anders 0.

Opmerkingen

In het framework wordt deze methode aangeroepen wanneer een door de gebruiker gedefinieerde werkbalk wordt verwijderd.

Overschrijf deze methode als u aanvullende statusinformatie opslaat in het Windows-register.

CMFCToolBar::ReplaceButton

Hiermee vervangt u een werkbalkknop door een andere werkbalkknop.

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

Parameters

uiCmd
[in] De opdracht-id van de knop die u wilt vervangen.

button
[in] Een verwijzing naar de CMFCToolBarButton die u wilt invoegen.

bAll
[in] Een Booleaanse waarde die aangeeft of alle knoppen moeten worden vervangen met de opdracht-id die is opgegeven door uiCmd. Als deze parameter is TRUE, worden alle knoppen met de opgegeven opdracht-id vervangen. Anders wordt de eerste knop vervangen.

Retourwaarde

Het aantal knoppen dat wordt vervangen. Deze methode retourneert 0 als er geen knop met de opgegeven opdracht-id bestaat op de werkbalk.

Opmerkingen

Roep deze methode aan wanneer u werkbalkknoppen wilt toevoegen die niet kunnen worden geladen vanuit resources. U kunt op ontwerptijd een tijdelijke aanduiding maken en deze knop vervangen door een aangepaste knop wanneer u de werkbalk initialiseert. Zie het VisualStudioDemo-voorbeeld voor een voorbeeld waarin deze methode wordt gebruikt.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de methode ReplaceButton gebruikt in de klasse CMFCToolBar. Dit codefragment maakt deel uit van het IE Demo-voorbeeld.

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

Hiermee worden alle werkbalken terugzet naar de oorspronkelijke status.

static void __stdcall ResetAll();

Opmerkingen

Met deze methode wordt de CMFCToolBar::RestoreOriginalState methode aangeroepen op elke werkbalk in de toepassing die kan worden hersteld. Hierbij wordt de methode CMFCToolBar::CanBeRestored gebruikt om te bepalen of een werkbalk kan worden hersteld.

CMFCToolBar::ResetAllImages

Hiermee wist u alle verzamelingen van werkbalkafbeeldingen in de toepassing.

static void __stdcall ResetAllImages();

Opmerkingen

Met deze methode worden de afbeeldingsverzamelingen gewist die zijn geïnitialiseerd door de methoden CMFCToolBar::LoadToolBar en CMFCToolBar::LoadBitmap.

CMFCToolBar::ResetImages

virtual void ResetImages();

Opmerkingen

CMFCToolBar::RestoreFocus

virtual void RestoreFocus();

Opmerkingen

CMFCToolBar::RestoreOriginalState

Hiermee wordt de oorspronkelijke status van een werkbalk hersteld.

virtual BOOL RestoreOriginalState();

Retourwaarde

TRUE of de methode slaagt of FALSE als de methode mislukt of als de werkbalk door de gebruiker is gedefinieerd.

Opmerkingen

Met deze methode wordt de werkbalk uit het resourcebestand geladen met behulp van de methode CMFCToolBar::LoadToolBar.

In het framework wordt deze methode aangeroepen wanneer de gebruiker de knop Alle opnieuw instellen kiest op de werkbalken pagina van een aanpassingsdialoogvenster.

CMFCToolBar::SaveParameters

static BOOL __stdcall SaveParameters(LPCTSTR lpszProfileName = NULL);

Parameters

[in] lpszProfileName

Retourwaarde

Opmerkingen

CMFCToolBar::SaveState

Hiermee wordt de statusinformatie voor de werkbalk opgeslagen in het Windows-register.

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

Parameters

lpszProfileName
[in] Hiermee geeft u het relatieve pad van de Windows-registersleutel.

nIndex
[in] De besturingselement-id van de werkbalk.

uiID
[in] De resource-id van de werkbalk.

Retourwaarde

Niet-nul als de methode slaagt; anders 0.

Opmerkingen

Dit framework roept deze methode aan wanneer de toepassingsstatus wordt opgeslagen in het register. Zie CWinAppEx::SaveStatevoor meer informatie.

CMFCToolBar::SetBasicCommands

Hiermee stelt u de lijst met opdrachten in die altijd worden weergegeven wanneer een gebruiker een menu opent.

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

Parameters

lstCommands
[in] Een verwijzing naar een CList-object dat een verzameling opdrachten bevat.

Opmerkingen

Er wordt altijd een basisopdracht weergegeven wanneer het menu wordt geopend. Deze methode is zinvol wanneer de gebruiker ervoor kiest onlangs gebruikte opdrachten weer te geven.

Gebruik de methode CMFCToolBar::AddBasicCommand om een opdracht toe te voegen aan de lijst met basisopdrachten. Gebruik de methode CMFCToolBar::GetBasicCommands om de lijst met basisopdrachten op te halen die door uw toepassing worden gebruikt.

Zie het Explorer-voorbeeld voor een voorbeeld waarin deze methode wordt gebruikt.

CMFCToolBar::SetButtonInfo

Hiermee stelt u de opdracht-id, stijl en afbeeldings-id van een werkbalkknop in.

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

Parameters

nIndex
[in] De op nul gebaseerde index van de knop waarvan de eigenschappen zijn ingesteld.

nID
[in] De opdracht-id van de knop.

nStyle
[in] De stijl van de knop. Zie werkbalkbesturingsstijlen voor de lijst met beschikbare werkbalkknopstijlen.

iImage
[in] De op nul gebaseerde afbeeldingsindex van de knop (de index in de verzameling werkbalkafbeeldingen).

Opmerkingen

Roep deze methode aan om de eigenschappen van een werkbalkknop in te stellen.

In builds voor foutopsporing genereert deze methode een assertiefout als de index die is opgegeven door nIndex ongeldig is.

Roep de methode CMFCToolBar::SetButtonStyle aan om alleen de stijl van de knop in te stellen.

CMFCToolBar::SetButtons

Hiermee stelt u de knoppen voor de werkbalk in.

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

Parameters

lpIDArray
[in] Een aanwijzer naar de matrix met opdracht-id's van de knoppen die moeten worden ingevoegd.

nIDCount
[in] Het aantal items in lpIDArray.

bRemapImages
[in] Een Booleaanse waarde die aangeeft of de bestaande knopafbeeldingen moeten worden gekoppeld aan de ingevoegde knoppen. Als deze parameter is TRUE, worden de installatiekopieën opnieuw toegepast.

Retourwaarde

Niet-nul als de methode slaagt; anders 0.

Opmerkingen

Roep deze methode aan om bestaande knoppen uit een werkbalk te verwijderen en een verzameling nieuwe knoppen in te voegen.

Met deze methode wordt de knop Aanpassen aan de werkbalk toegevoegd en wordt het AFX_WM_RESETTOOLBAR bericht naar het bovenliggende venster van de werkbalk verzonden. Zie CMFCToolBar::EnableCustomizeButtonvoor meer informatie over de knop aanpassen.

CMFCToolBar::SetButtonStyle

Hiermee stelt u de stijl van de werkbalkknop in op de opgegeven index.

virtual void SetButtonStyle(
    int nIndex,
    UINT nStyle);

Parameters

nIndex
[in] De op nul gebaseerde index van de werkbalkknop waarvan de stijl moet worden ingesteld.

nStyle
[in] De stijl van de knop. Zie werkbalkbesturingsstijlen voor de lijst met beschikbare werkbalkknopstijlen.

Opmerkingen

Met deze methode wordt de TBBS_PRESSED stijl verwijderd als nStyle is TBBS_DISABLED omdat de gebruiker geen uitgeschakelde knop kan selecteren.

CMFCToolBar::SetButtonText

Hiermee stelt u het tekstlabel van een werkbalkknop in.

BOOL SetButtonText(
    int nIndex,
    LPCTSTR lpszText);

Parameters

nIndex
[in] De index van de werkbalkknop.

lpszText
[in] Het tekstlabel van de werkbalkknop. Moet niet null zijn.

Retourwaarde

TRUE als de methode slaagt; anders FALSE.

Opmerkingen

Deze methode retourneert FALSE als de opgegeven index niet verwijst naar een geldige werkbalkknop.

CMFCToolBar::SetCommandUsageOptions

Hiermee geeft u op wanneer zelden gebruikte opdrachten niet worden weergegeven in het menu van de toepassing.

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

Parameters

nStartCount
[in] Hiermee geeft u het aantal keren op dat opdrachten moeten worden uitgevoerd voordat in het framework alleen de basis- en recent gebruikte opdrachten worden weergegeven.

nMinUsagePercentage
[in] Het percentage keren dat een opdracht moet worden uitgevoerd om te worden beschouwd als een recent gebruikte opdracht.

Retourwaarde

FALSE als nMinUsagePercentage gelijk is aan of groter is dan 100; anders TRUE.

Opmerkingen

Roep deze methode aan om het algoritme dat door het framework wordt gebruikt aan te passen om te bepalen hoe basis- en recent gebruikte menu-items worden weergegeven. Zie CMFCToolBar::AddBasicCommandvoor meer informatie over basisopdrachten.

Deze klasse gebruikt de CMFCCmdUsageCount-klasse om het aantal opdrachten bij te houden. Zie CMFCCmdUsageCount Classvoor meer informatie over deze klasse.

CMFCToolBar::SetCustomizeMode

Hiermee schakelt u de aanpassingsmodus voor alle werkbalken in de toepassing in of uit.

static BOOL __stdcall SetCustomizeMode(BOOL bSet=TRUE);

Parameters

bSet
[in] Een Booleaanse waarde die aangeeft of de aanpassingsmodus moet worden ingeschakeld of uitgeschakeld. Stel deze parameter in op TRUE om de aanpassingsmodus in te schakelen of FALSE om deze uit te schakelen.

Retourwaarde

TRUE als het aanroepen van deze methode de aanpassingsmodus wijzigt; anders FALSE.

Opmerkingen

Met deze methode wordt de indeling van elke werkbalk in de toepassing aangepast en opnieuw getekend. Roep de methode CMFCToolBar::IsCustomizeMode aan om te bepalen of de toepassing zich in de aanpassingsmodus bevindt.

CMFCToolBar::SetGrayDisabledButtons

Hiermee geeft u op of niet-beschikbare knoppen op de werkbalk grijs worden weergegeven of of er knoponbeschikbare afbeeldingen worden gebruikt.

void SetGrayDisabledButtons(BOOL bGrayDisabledButtons);

Parameters

bGrayDisabledButtons
[in] Een Booleaanse waarde die aangeeft hoe niet-beschikbare knoppen moeten worden weergegeven. Als deze parameter TRUEis, worden de knoppen door het framework gedimd. Anders maakt het framework gebruik van de verzameling knop-niet-beschikbare installatiekopieën.

Opmerkingen

Standaard worden niet-beschikbare knoppen grijs weergegeven.

CMFCToolBar::SetHeight

Hiermee stelt u de hoogte van de werkbalk in.

void SetHeight(int cyHeight);

Parameters

cyHeight
[in] De hoogte van de werkbalk, in pixels.

Opmerkingen

Met deze methode wordt de werkbalk opnieuw getekend nadat de hoogte is ingesteld.

CMFCToolBar::SetHelpMode

static void __stdcall SetHelpMode(BOOL bOn = TRUE);

Parameters

[in] bOn

Opmerkingen

CMFCToolBar::SetHot

BOOL SetHot(CMFCToolBarButton* pMenuButton);

Parameters

[in] pMenuButton

Retourwaarde

Opmerkingen

CMFCToolBar::SetHotBorder

Hiermee geeft u op of werkbalkknoppen dynamisch worden bijgehouden.

void SetHotBorder(BOOL bShowHotBorder);

Parameters

bShowHotBorder
[in] Een Booleaanse waarde die aangeeft of knoppen op de werkbalk dynamisch moeten worden bijgehouden. Als deze parameter is TRUE, houdt de werkbalk de knoppen bij. Anders worden de knoppen van de werkbalk niet dynamisch bijgehouden.

Opmerkingen

Als een knop dynamisch wordt bijgehouden, markeert het framework de knop wanneer de muis er overheen beweegt. Standaard houdt elke werkbalk de knoppen bij.

Roep de methode CMFCToolBar::GetHotBorder aan om te bepalen of de knoppen van de werkbalk dynamisch worden bijgehouden.

CMFCToolBar::SetHotTextColor

Hiermee stelt u de tekstkleur in voor knoppen met dynamische werkbalken.

static void SetHotTextColor(COLORREF clrText);

Parameters

clrText
[in] Hiermee geeft u de tekstkleur op voor werkbalkknoppen die dynamisch worden bijgehouden.

Opmerkingen

Zie CMFCToolBar::GetHotBorder en CMFCToolBar::SetHotBordervoor meer informatie over knoppen voor dynamische werkbalken.

CMFCToolBar::SetIgnoreSetText

void SetIgnoreSetText(BOOL bValue);

Parameters

[in] bValue

Opmerkingen

CMFCToolBar::SetLargeIcons

Hiermee geeft u op of op werkbalkknoppen grote pictogrammen worden weergegeven.

static void SetLargeIcons(BOOL bLargeIcons=TRUE);

Parameters

bLargeIcons
[in] Een Booleaanse waarde die aangeeft welke pictogrammen moeten worden gebruikt. Als deze parameter is TRUE, worden in het framework grote pictogrammen weergegeven. Anders worden in het framework normale pictogrammen weergegeven.

Opmerkingen

In het framework wordt deze methode aangeroepen wanneer de gebruiker de status van het Grote pictogrammen wijzigt selectievakje op het tabblad Opties van het dialoogvenster aanpassen. Met deze methode wordt het formaat van alle werkbalken in de toepassing gewijzigd.

Standaard worden in het framework normale pictogrammen weergegeven.

Zie CMFCToolBarsCustomizeDialog Classvoor meer informatie over het dialoogvenster aanpassen.

CMFCToolBar::SetLockedSizes

Hiermee stelt u de grootte van vergrendelde knoppen en vergrendelde afbeeldingen op de werkbalk in.

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

Parameters

sizeButton
[in] Hiermee geeft u de grootte van vergrendelde werkbalkknoppen.

sizeImage
[in] Hiermee geeft u de grootte van vergrendelde werkbalkafbeeldingen.

bDontScale
Hiermee geeft u op of afbeeldingen op de werkbalk moeten worden geschaald of vergrendeld in de modus hoge DPI.

Opmerkingen

De standaardgrootte van vergrendelde knoppen is 23x22 pixels. De standaardgrootte van vergrendelde afbeeldingen is 16x15 pixels.

Roep de methode CMFCToolBar::GetLockedImageSize aan om de grootte van vergrendelde installatiekopieën op te halen. Roep de methode CMFCToolBar::GetButtonSize aan om de grootte van vergrendelde werkbalkknoppen op te halen.

CMFCToolBar::SetMaskMode

void SetMaskMode(BOOL bMasked);

Parameters

[in] bMasked

Opmerkingen

CMFCToolBar::SetMenuSizes

Hiermee stelt u de grootte van werkbalkmenuknoppen en de bijbehorende afbeeldingen in.

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

Parameters

sizeButton
[in] Hiermee geeft u de grootte van werkbalkknoppen, in pixels.

sizeImage
[in] Hiermee geeft u de grootte van werkbalkafbeeldingen in pixels.

Opmerkingen

Menuknoppen en hun afbeeldingen hebben standaard een niet-gedefinieerd formaat.

Roep de methode CMFCToolBar::GetMenuButtonSize aan om de grootte van menuknoppen en de CMFCToolBar::GetMenuImageSize methode te bepalen om de grootte van menuknopafbeeldingen te bepalen.

Zie de voorbeelden IEDemo en MSMoneyDemo voor voorbeelden die deze methode gebruiken.

CMFCToolBar::SetNonPermittedCommands

Hiermee stelt u de lijst met opdrachten in die niet door de gebruiker kunnen worden uitgevoerd.

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

Parameters

lstCommands
[in] Een verwijzing naar een CList-object dat de opdrachten bevat die niet door de gebruiker kunnen worden uitgevoerd.

Opmerkingen

Roep deze methode aan om te voorkomen dat de gebruiker bepaalde opdrachten selecteert. U wilt bijvoorbeeld voorkomen dat de gebruiker bepaalde opdrachten selecteert om veiligheidsredenen. Zie de voorbeelden MDITabsDemo en MenuSubSet voor voorbeelden die deze methode gebruiken.

Met deze methode wordt de vorige lijst met niet-toegestane opdrachten gewist. De lijst met niet-toegestane opdrachten is standaard leeg.

CMFCToolBar::SetOneRowWithSibling

Hiermee plaatst u de werkbalk en het bijbehorende niveau op dezelfde rij.

void SetOneRowWithSibling();

Opmerkingen

In het framework wordt deze methode aangeroepen wanneer de gebruiker de knop Knoppen weergeven op één rij selecteert.

Roep de methode CMFCToolBar::SetSiblingToolBar aan om de knoppen Weergeven in te schakelen op één rij of Knoppen weergeven op twee rijen knoppen. Als u CMFCToolBar::SetSiblingToolBar aanroept voor deze werkbalk, wordt de werkbalk op hetzelfde niveau verplaatst naar de rij van deze werkbalk. Anders wordt deze werkbalk verplaatst naar de rij van het zelfde niveau.

Het framework roept de CMFCToolBar::SetTwoRowsWithSibling methode aan wanneer de gebruiker de knop Knoppen weergeven selecteert op twee rijen.

CMFCToolBar::SetOrigButtons

void SetOrigButtons(const CObList& lstOrigButtons);

Parameters

[in] lstOrigButtons

Opmerkingen

CMFCToolBar::SetPermament

Hiermee geeft u op of een gebruiker de werkbalk kan sluiten.

void SetPermament(BOOL bPermament=TRUE);

Parameters

bPermament
[in] Een Booleaanse waarde die aangeeft of een gebruiker de werkbalk kan sluiten. Als deze parameter is TRUE, kan een gebruiker de werkbalk niet sluiten. Anders kan een gebruiker de werkbalk sluiten.

Opmerkingen

Standaard kan een gebruiker elke werkbalk sluiten.

Roep de methode CMFCToolBar::CanBeClosed aan om te bepalen of een gebruiker de werkbalk kan sluiten.

CMFCToolBar::SetRouteCommandsViaFrame

Hiermee geeft u op of het bovenliggende frame of de eigenaar opdrachten naar de werkbalk verzendt.

void SetRouteCommandsViaFrame(BOOL bValue);

Parameters

bValue
[in] Als deze parameter is TRUE, verzendt het bovenliggende frame opdrachten naar de werkbalk. Anders verzendt de eigenaar opdrachten naar de werkbalk.

Opmerkingen

Standaard verzendt het bovenliggende frame opdrachten naar de werkbalk. Roep de methode CMFCToolBar::GetRouteCommandsViaFrame aan om te bepalen of het bovenliggende frame of de eigenaar opdrachten naar de werkbalk verzendt.

CMFCToolBar::SetShowTooltips

Hiermee geeft u op of in het framework knopinfo wordt weergegeven.

static void SetShowTooltips(BOOL bValue);

Parameters

bValue
[in] Als deze parameter is TRUE, worden in het framework knoptips weergegeven. Anders worden de tips voor hulpprogramma's verborgen in het framework.

Opmerkingen

Standaard worden in het framework tooltips weergegeven.

Roep de methode CMFCToolBar::GetShowTooltips aan om te bepalen of het framework tips voor hulpprogramma's weergeeft.

CMFCToolBar::SetSiblingToolBar

Hiermee geeft u het niveau van de werkbalk op.

void SetSiblingToolBar(CMFCToolBar* pBrotherToolbar);

Parameters

pBrotherToolbar
[in] Een aanwijzer naar de werkbalk op hetzelfde niveau.

Opmerkingen

Met deze methode kunt u de knoppen Weergeven op één rij of knoppen weergeven op twee rijen knoppen die worden weergegeven wanneer de gebruiker het snelmenu aanpassen weergeven weergeeft. Roep deze methode aan als u de gebruiker wilt inschakelen om op te geven of gerelateerde werkbalken in dezelfde rij of in verschillende rijen worden weergegeven.

Roep deze methode aan nadat u de knop Aanpassen hebt ingeschakeld die op de werkbalk wordt weergegeven. Als u de knop aanpassen wilt inschakelen, roept u de methode CMFCToolBar::EnableCustomizeButton aan.

Als u het niveau van een werkbalk wilt ophalen, roept u CMFCToolBar::GetSiblingToolBaraan.

CMFCToolBar::SetSizes

Hiermee geeft u de grootte van knoppen en afbeeldingen op alle werkbalken.

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

Parameters

sizeButton
[in] De grootte van werkbalkknoppen, in pixels.

sizeImage
[in] De grootte van afbeeldingen van werkbalkknoppen, in pixels.

Opmerkingen

De standaardgrootte van werkbalkknoppen is 23x22 pixels. De standaardgrootte van afbeeldingen van werkbalkknoppen is 16x15 pixels.

Roep de methode CMFCToolBar::GetImageSize aan om de grootte van afbeeldingen van werkbalkknoppen op te halen. Roep de CMFCToolBar::GetButtonSize methode aan om de grootte van werkbalkknoppen op te halen.

CMFCToolBar::SetToolBarBtnText

Hiermee geeft u eigenschappen van een knop op de werkbalk.

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

Parameters

nBtnIndex
[in] De op nul gebaseerde index van de werkbalkknop in de lijst met werkbalkknoppen.

szText
[in] Hiermee geeft u het tekstlabel van de werkbalkknop.

bShowText
[in] Als deze parameter is TRUE, wordt in het framework het tekstlabel weergegeven. Anders verbergt het framework het tekstlabel.

bShowImage
[in] Als deze parameter is TRUE, wordt in het framework de afbeelding van de werkbalkknop weergegeven. Anders verbergt het framework de afbeelding van de werkbalkknop.

Opmerkingen

Standaard worden in het framework de afbeeldingen van werkbalkknoppen weergegeven, maar wordt het tekstlabel van werkbalkknoppen niet weergegeven.

In builds voor foutopsporing genereert deze methode een assertiefout als nBtnIndex niet verwijst naar een geldige werkbalkknop of als de werkbalkknop een scheidingsteken is.

CMFCToolBar::SetTwoRowsWithSibling

Hiermee plaatst u de werkbalk en het bijbehorende niveau op afzonderlijke rijen.

void SetTwoRowsWithSibling();

Opmerkingen

In het framework wordt deze methode aangeroepen wanneer de gebruiker de knop Knoppen weergeven selecteert op twee rijen.

Roep de methode CMFCToolBar::SetSiblingToolBar aan om de knoppen Weergeven in te schakelen op één rij of Knoppen weergeven op twee rijen knoppen. Als u CMFCToolBar::SetSiblingToolBar aanroept voor deze werkbalk, wordt de werkbalk op hetzelfde niveau verplaatst naar een afzonderlijke rij. Anders wordt deze werkbalk verplaatst naar een afzonderlijke rij.

Het framework roept de CMFCToolBar::SetOneRowWithSibling methode aan wanneer de gebruiker de knop Knoppen weergeven op één rij selecteert.

CMFCToolBar::SetUserImages

Hiermee stelt u de verzameling door de gebruiker gedefinieerde installatiekopieën in de toepassing in.

static BOOL SetUserImages(CMFCToolBarImages* pUserImages);

Parameters

pUserImages
[in] Een aanwijzer naar de verzameling door de gebruiker gedefinieerde afbeeldingen.

Retourwaarde

Niet-nul als de methode slaagt; anders 0 als het opgegeven CMFCToolBarImages-object ongeldig is of een afbeeldingsgrootte heeft die verschilt van de standaardafbeeldingsgrootte van de werkbalk.

Opmerkingen

Het framework maakt gebruik van door de gebruiker gedefinieerde afbeeldingen om werkbalkknoppen te tekenen die door de gebruiker worden aangepast. De lijst met afbeeldingen die is opgegeven door pUserImages wordt gedeeld tussen alle werkbalken in de toepassing.

Met deze methode wordt een assertiefout gegenereerd in builds voor foutopsporing als het opgegeven CMFCToolBarImages-object ongeldig is of een afbeeldingsgrootte heeft die verschilt van de standaardafbeeldingsgrootte van de werkbalk.

De voorbeelden OutlookDemo, ToolTipDemo en VisualStudioDemo gebruiken deze methode om de globale verzameling door de gebruiker gedefinieerde afbeeldingen in te stellen. Ze laden het bestand met de naam UserImages.bmp, dat zich in de werkmap van de toepassing bevindt.

Roep de 'CMFCToolBar::GetUserImages methode aan om de verzameling door de gebruiker gedefinieerde installatiekopieën in de toepassing op te halen.

CMFCToolBar::StretchPane

De werkbalk verticaal of horizontaal uitrekken en de knoppen indien nodig verplaatsen.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Parameters

nLength
[in] De hoeveelheid, in pixels, waarmee het deelvenster moet worden uitgerekt.

bVert
[in] Als TRUE, wordt het deelvenster verticaal uitgerekt. Als FALSE, wordt het deelvenster horizontaal uitgerekt.

Retourwaarde

Een CSize-object dat de grootte van het werkbalkclientgebied aangeeft.

Opmerkingen

Met deze methode wordt CMFCToolBar::WrapToolBar aangeroepen om de knoppen in de uitgerekte werkbalk te verplaatsen.

De retourwaarde wordt bepaald door CMFCToolBar::CalcSizeaan te roepen.

CMFCToolBar::TranslateChar

Hiermee voert u een knopopdracht uit als de opgegeven sleutelcode overeenkomt met een geldige sneltoets.

virtual BOOL TranslateChar(UINT nChar);

Parameters

nChar
[in] Hiermee geeft u een virtuele-sleutelcode op. Zie Winuser.h voor een lijst met standaardcodes voor virtuele sleutels

Retourwaarde

FALSE als de opgegeven sleutelcode onafdrukbaar is of niet overeenkomt met een geldige sneltoets; TRUE als de opgegeven sleutelcode overeenkomt met een vervolgkeuzemenuoptie; anders wordt de retourwaarde van CMFCToolBar::ProcessCommand.

Opmerkingen

In het framework wordt deze methode aangeroepen wanneer een toets samen met de Alt--toets wordt ingedrukt.

CMFCToolBar::UpdateButton

Hiermee wordt de status van de opgegeven knop bijgewerkt.

void UpdateButton(int nIndex);

Parameters

nIndex
[in] Hiermee geeft u de op nul gebaseerde index van de knop die moet worden bijgewerkt.

Opmerkingen

CMFCToolBar::WrapToolBar

Werkbalkknoppen binnen de opgegeven dimensies verplaatsen.

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

Parameters

nWidth
[in] Maximale breedte van de werkbalk.

nHeight
[in] Maximale hoogte van de werkbalk. Niet gebruikt als de werkbalk zwevend is.

pDC
[in] Aanwijzer naar een apparaatcontext. Als NULL, wordt de apparaatcontext voor de werkbalk gebruikt.

nColumnWidth
[in] Knopbreedte. Als -1 wordt de huidige breedte gebruikt.

[in] mnRowHeight knophoogte. Als -1 wordt de huidige hoogte gebruikt.

Retourwaarde

Het aantal rijen met knoppen op de werkbalk.

Opmerkingen

Met deze methode worden knoppen binnen de werkbalk verplaatst en worden knoppen zo nodig terugloopknoppen naar extra rijen verplaatst.

CMFCToolBar::m_bDontScaleImages

Hiermee geeft u op of werkbalkafbeeldingen wel of niet moeten worden geschaald in de modus hoge DPI. Ingesteld op TRUE om te voorkomen dat afbeeldingen worden geschaald wanneer een afbeeldingsgrootte niet overeenkomt met een knopgrootte.

AFX_IMPORT_DATA static BOOL m_bDontScaleImages;

Zie ook

Hiërarchiegrafiek
klassen
CMFCMenuBar klasse
CMFCPopupMenuBar klasse
CMFCDropDownToolBar klasse
overzicht: Besturingselementen op werkbalken plaatsen