`CMFCToolBar`-klass

Artikel
03/18/2025

Klassen CMFCToolBar liknar CToolBar Class, men ger ytterligare stöd för användargränssnittsfunktioner. Dessa inkluderar platta verktygsfält, verktygsfält med heta bilder, stora ikoner, sidsidesknappar, låsta verktygsfält, omlistningskontroller, text under bilder, bakgrundsbilder och verktygsfält med flikar. Klassen CMFCToolBar innehåller också inbyggt stöd för användaranpassning av verktygsfält och menyer, dra och släpp mellan verktygsfält och menyer, kombinationsruteknappar, redigera lådknappar, färgväljare och sammanslagningsknappar.

Mer information finns i källkoden som finns i Visual Studio-installationen, till exempel %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Syntax

class CMFCToolBar : public CMFCBaseToolBar

Medlemmar

Offentliga konstruktorer

Namn	Beskrivning
`CMFCToolBar::CMFCToolBar`	Standardkonstruktor.
`CMFCToolBar::~CMFCToolBar`	Destructor.

Offentliga metoder

Namn	Beskrivning
`CMFCToolBar::AddBasicCommand`	Lägger till ett menykommando i listan över kommandon som alltid visas när en användare öppnar en meny.
`CMFCToolBar::AddCommandUsage`	Ökar med en räknare som är associerad med det angivna kommandot.
`CMFCToolBar::AddToolBarForImageCollection`	Lägger till bilder från användargränssnittsresurserna i samlingen av bilder i programmet.
`CMFCToolBar::AdjustLayout`	Beräknar om storleken och positionen för ett verktygsfält. (Åsidosätter `CBasePane::AdjustLayout`).
`CMFCToolBar::AdjustSize`	Beräknar om storleken på verktygsfältet.
`CMFCToolBar::AllowChangeTextLabels`	Anger om textetiketter kan visas under bilder i verktygsfältsknapparna.
`CMFCToolBar::AreTextLabels`	Anger om textetiketter under bilder för närvarande visas i verktygsfältsknapparna.
`CMFCToolBar::AutoGrayInactiveImages`	Aktiverar eller inaktiverar automatisk generering av inaktiva knappbilder.
`CMFCToolBar::ButtonToIndex`	Returnerar indexet för ett angivet `CMFCToolBarButton` class-objekt i det här verktygsfältet.
`CMFCToolBar::CalcFixedLayout`	Beräknar verktygsfältets vågräta storlek. (Åsidosätter `CBasePane::CalcFixedLayout`.)
`CMFCToolBar::CalcSize`	Anropas av ramverket som en del av layoutberäkningsprocessen. (Åsidosätter `CPane::CalcSize`.)
`CMFCToolBar::CanHandleSiblings`	Avgör om verktygsfältet och dess syskon är placerade i samma fönster.
`CMFCToolBar::CleanUpImages`	Frigör systemresurser som allokerats för verktygsfältsbilder.
`CMFCToolBar::CleanUpLockedImages`	Frigör systemresurser som allokerats för låsta verktygsfältsbilder.
`CMFCToolBar::CanBeClosed`	Anger om en användare kan stänga verktygsfältet. (Åsidosätter `CBasePane::CanBeClosed`.)
`CMFCToolBar::CanBeRestored`	Avgör om systemet kan återställa ett verktygsfält till sitt ursprungliga tillstånd efter anpassningen.
`CMFCToolBar::CanFocus`	Anger om fönstret kan få fokus. (Åsidosätter `CBasePane::CanFocus`.)
`CMFCToolBar::CanHandleSiblings`	Avgör om verktygsfältet och dess syskon är placerade i samma fönster.
`CMFCToolBar::CommandToIndex`	Returnerar indexet för knappen i verktygsfältet med ett angivet kommando-ID.
`CMFCToolBar::Create`	Skapar ett `CMFCToolBar` objekt.
`CMFCToolBar::CreateEx`	Skapar ett `CMFCToolBar` objekt som använder ytterligare formatalternativ, till exempel stora ikoner.
`CMFCToolBar::Deactivate`	Inaktiverar verktygsfältet.
`CMFCToolBar::EnableCustomizeButton`	Aktiverar eller inaktiverar knappen Lägg till eller ta bort knappar som visas i slutet av verktygsfältet.
`CMFCToolBar::EnableDocking`	Aktiverar dockning av fönstret till huvudramen. (Åsidosätter `CBasePane::EnableDocking`.)
`CMFCToolBar::EnableLargeIcons`	Aktiverar eller inaktiverar stora ikoner på verktygsfältsknappar.
`CMFCToolBar::EnableQuickCustomization`	Aktiverar eller inaktiverar snabbanpassning av verktygsfält så att användaren kan trycka på Alt- och dra en knapp till en ny plats.
`CMFCToolBar::EnableReflections`	Aktiverar eller inaktiverar kommandoreflektion.
`CMFCToolBar::EnableTextLabels`	Aktiverar eller inaktiverar textetiketter under knappbilder i verktygsfältet.
`CMFCToolBar::FromHandlePermanent`	Hämtar en pekare till det `CMFCToolBar` objekt som innehåller det angivna fönsterhandtaget.
`CMFCToolBar::GetAllButtons`	Returnerar en skrivskyddad lista med knappar i ett verktygsfält.
`CMFCToolBar::GetAllToolbars`	Returnerar en skrivskyddad lista över alla verktygsfält i programmet.
`CMFCToolBar::GetBasicCommands`	Returnerar en skrivskyddad lista över de grundläggande kommandon som definierats i programmet.
`CMFCToolBar::GetButton`	Returnerar en pekare till det `CMFCToolBarButton` objekt som har ett angivet knappindex för verktygsfältet.
`CMFCToolBar::GetButtonInfo`	Returnerar kommando-ID, formatmall och bildindex för knappen vid ett angivet index.
`CMFCToolBar::GetButtonSize`	Returnerar dimensionerna för varje knapp i verktygsfältet.
`CMFCToolBar::GetButtonStyle`	Returnerar det aktuella formatet för verktygsfältsknappen som finns i det angivna indexet.
`CMFCToolBar::GetButtonText`	Returnerar textetiketten för en knapp som har ett angivet index.
`CMFCToolBar::GetColdImages`	Returnerar en pekare till samlingen med knappbilder i det kalla verktygsfältet i programmet.
`CMFCToolBar::GetColumnWidth`	Returnerar bredden på verktygsfältsknapparna.
`CMFCToolBar::GetCommandButtons`	Returnerar en lista med knappar som har ett angivet kommando-ID från alla verktygsfält i programmet.
`CMFCToolBar::GetCount`	Returnerar antalet knappar och avgränsare i verktygsfältet.
`CMFCToolBar::GetCustomizeButton`	Hämtar en pekare till det `CMFCCustomizeButton` objekt som är associerat med verktygsfältet.
`CMFCToolBar::GetDefaultImage`	Returnerar indexet för standardbilden för en verktygsfältsknapp med ett angivet kommando-ID.
`CMFCToolBar::GetDisabledImages`	Returnerar en pekare till samlingen av bilder som används för inaktiverade verktygsfältsknappar i programmet.
`CMFCToolBar::GetDisabledMenuImages`	Returnerar en pekare till samlingen av bilder som används för inaktiverade menyknappar i programmet.
`CMFCToolBar::GetDroppedDownMenu`	Hämtar en pekare till menyknappsobjektet som för närvarande visar undermenyn.
`CMFCToolBar::GetGrayDisabledButtons`	Anger om bilderna av inaktiverade knappar är nedtonade versioner av de vanliga knappbilderna eller tagna från samlingen av inaktiverade knappbilder.
`CMFCToolBar::GetHighlightedButton`	Returnerar en pekare till verktygsfältsknappen som för närvarande är markerad.
`CMFCToolBar::GetHotBorder`	Avgör om verktygsfältsknapparna är snabbspårade.
`CMFCToolBar::GetHotTextColor`	Returnerar textfärgen för de markerade verktygsfältsknapparna.
`CMFCToolBar::GetHwndLastFocus`	Returnerar ett handtag till fönstret som hade indatafokus precis innan verktygsfältet gjorde det.
`CMFCToolBar::GetIgnoreSetText`	Anger om anrop för att ange knappetiketter ignoreras.
`CMFCToolBar::GetImageSize`	Returnerar den aktuella storleken på knappbilder i verktygsfältet.
`CMFCToolBar::GetImages`	Returnerar en pekare till samlingen med standardknappbilder i programmet.
`CMFCToolBar::GetImagesOffset`	Returnerar indexförskjutningen som används för att hitta knappbilderna i verktygsfältet i den globala listan med knappbilder i verktygsfältet.
`CMFCToolBar::GetInvalidateItemRect`	Hämtar den region i klientområdet som måste ritas om för knappen i det angivna indexet.
`CMFCToolBar::GetItemID`	Returnerar kommando-ID för verktygsfältsknappen vid ett angivet index.
`CMFCToolBar::GetItemRect`	Returnerar avgränsningsrektangeln för knappen vid ett angivet index.
`CMFCToolBar::GetLargeColdImages`	Returnerar en pekare till samlingen med stora knappbilder för kallt verktygsfält i programmet.
`CMFCToolBar::GetLargeDisabledImages`	Returnerar en pekare till samlingen med stora inaktiverade knappbilder i programmet.
`CMFCToolBar::GetLargeImages`	Returnerar en pekare till samlingen med stora knappbilder i verktygsfältet i programmet.
`CMFCToolBar::GetLockedColdImages`	Returnerar en pekare till samlingen med låsta kalla bilder i verktygsfältet.
`CMFCToolBar::GetLockedDisabledImages`	Returnerar en pekare till samlingen med låsta inaktiverade bilder i verktygsfältet.
`CMFCToolBar::GetLockedImages`	Returnerar en pekare till samlingen med låsta knappbilder i verktygsfältet.
`CMFCToolBar::GetLockedImageSize`	Returnerar standardstorleken för låsta verktygsfältsbilder.
`CMFCToolBar::GetLockedMenuImages`	Returnerar en pekare till samlingen med låsta verktygsfältsmenybilder i verktygsfältet.
`CMFCToolBar::GetMenuButtonSize`	Returnerar storleken på menyknapparna i programmet.
`CMFCToolBar::GetMenuImageSize`	Returnerar storleken på menyknappsbilderna i programmet.
`CMFCToolBar::GetMenuImages`	Returnerar en pekare till samlingen med menyknappsbilder i programmet.
`CMFCToolBar::GetOrigButtons`	Hämtar samlingen med icke-anpassade knappar i verktygsfältet.
`CMFCToolBar::GetOrigResetButtons`	Hämtar samlingen med icke-anpassade återställningsknappar i verktygsfältet.
`CMFCToolBar::GetResourceID`	Hämtar resurs-ID för verktygsfältet.
`CMFCToolBar::GetRouteCommandsViaFrame`	Avgör vilket objekt, den överordnade ramen eller ägaren, som skickar kommandon till verktygsfältet.
`CMFCToolBar::GetRowHeight`	Returnerar höjden på verktygsfältsknapparna.
`CMFCToolBar::GetShowTooltips`	Anger om verktygstips visas för verktygsfältsknappar.
`CMFCToolBar::GetSiblingToolBar`	Hämtar samma objekt i verktygsfältet.
`CMFCToolBar::GetUserImages`	Returnerar en pekare till samlingen med användardefinierade knappbilder i programmet.
`CMFCToolBar::HitTest`	Returnerar indexet för verktygsfältsknappen som finns på den angivna positionen.
`CMFCToolBar::InsertButton`	Infogar en knapp i verktygsfältet.
`CMFCToolBar::InsertSeparator`	Infogar en avgränsare i verktygsfältet.
`CMFCToolBar::InvalidateButton`	Ogiltigförklarar klientområdet för verktygsfältsknappen som finns i det angivna indexet.
`CMFCToolBar::IsAddRemoveQuickCustomize`	Avgör om en användare kan lägga till eller ta bort verktygsfältsknappar med hjälp av menyalternativet Anpassa.
`CMFCToolBar::IsAltCustomizeMode`	Anger om snabbanpassning används för att dra en knapp.
`CMFCToolBar::IsAutoGrayInactiveImages`	Anger om den automatiska genereringen av inaktiva (icke-markerade) knappbilder är aktiverad.
`CMFCToolBar::IsBasicCommand`	Avgör om ett kommando finns med i listan över grundläggande kommandon.
`CMFCToolBar::IsButtonExtraSizeAvailable`	Avgör om verktygsfältet kan visa knappar som har utökade kantlinjer.
`CMFCToolBar::IsButtonHighlighted`	Avgör om en knapp i verktygsfältet är markerad.
`CMFCToolBar::IsCommandPermitted`	Avgör om ett kommando är tillåtet.
`CMFCToolBar::IsCommandRarelyUsed`	Avgör om ett kommando används sällan (se `CMFCToolBar::SetCommandUsageOptions`).
`CMFCToolBar::IsCustomizeMode`	Anger om verktygsfältsramverket är i anpassningsläge.
`CMFCToolBar::IsDragButton`	Avgör om en verktygsfältsknapp dras.
`CMFCToolBar::IsExistCustomizeButton`	Avgör om verktygsfältet innehåller knappen Anpassa.
`CMFCToolBar::IsFloating`	Avgör om verktygsfältet är flytande.
`CMFCToolBar::IsLargeIcons`	Anger om verktygsfälten i programmet för närvarande visar stora ikoner.
`CMFCToolBar::IsLastCommandFromButton`	Avgör om det senast utförda kommandot skickades från den angivna verktygsfältsknappen.
`CMFCToolBar::IsLocked`	Avgör om verktygsfältet är låst.
`CMFCToolBar::IsOneRowWithSibling`	Avgör om verktygsfältet och dess samma verktygsfält är placerade på samma rad.
`CMFCToolBar::IsUserDefined`	Anger om verktygsfältet är användardefinierat.
`CMFCToolBar::LoadBitmap`	Läser in verktygsfältsbilder från programresurser.
`CMFCToolBar::LoadBitmapEx`	Läser in verktygsfältsbilder från programresurser. Innehåller stora bilder.
`CMFCToolBar::LoadParameters`	Läser in globala verktygsfältsalternativ från Windows-registret.
`CMFCToolBar::LoadState`	Läser in tillståndsinformation för verktygsfältet från Windows-registret. (Åsidosätter `CPane::LoadState`.)
`CMFCToolBar::LoadToolBar`	Läser in verktygsfältet från programresurser.
`CMFCToolBar::LoadToolBarEx`	Läser in verktygsfältet från programresurser med hjälp av hjälpklassen `CMFCToolBarInfo` för att programmet ska kunna använda stora avbildningar.
`CMFCToolBar::OnChangeHot`	Anropas av ramverket när en användare väljer en knapp i verktygsfältet.
`CMFCToolBar::OnFillBackground`	Anropas av ramverket från `CBasePane::DoPaint` för att fylla verktygsfältets bakgrund.
`CMFCToolBar::OnReset`	Återställer verktygsfältet till sitt ursprungliga tillstånd.
`CMFCToolBar::OnSetAccData`	(Åsidosätter `CBasePane::OnSetAccData`.)
`CMFCToolBar::OnSetDefaultButtonText`	Återställer texten i en verktygsfältsknapp till standardtillståndet.
`CMFCToolBar::OnUpdateCmdUI`	Används internt.
`CMFCToolBar::RemoveAllButtons`	Tar bort alla knappar från verktygsfältet.
`CMFCToolBar::RemoveButton`	Tar bort knappen med det angivna indexet från verktygsfältet.
`CMFCToolBar::RemoveStateFromRegistry`	Tar bort tillståndsinformationen för verktygsfältet från Windows-registret.
`CMFCToolBar::ReplaceButton`	Ersätter en verktygsfältsknapp med en annan verktygsfältsknapp.
`CMFCToolBar::ResetAll`	Återställer alla verktygsfält till sina ursprungliga tillstånd.
`CMFCToolBar::ResetAllImages`	Rensar alla bildsamlingar i verktygsfältet i programmet.
`CMFCToolBar::RestoreOriginalState`	Återställer det ursprungliga tillståndet för ett verktygsfält.
`CMFCToolBar::SaveState`	Sparar tillståndsinformationen för verktygsfältet i Windows-registret. (Åsidosätter `CPane::SaveState`.)
`CMFCToolBar::Serialize`	(Åsidosätter `CBasePane::Serialize`.)
`CMFCToolBar::SetBasicCommands`	Anger listan över kommandon som alltid visas när en användare öppnar en meny.
`CMFCToolBar::SetButtonInfo`	Anger kommando-ID, formatmall och bild-ID för en verktygsfältsknapp.
`CMFCToolBar::SetButtonStyle`	Anger formatmallen för verktygsfältsknappen vid det angivna indexet.
`CMFCToolBar::SetButtonText`	Anger textetiketten för en verktygsfältsknapp.
`CMFCToolBar::SetButtons`	Anger knapparna för verktygsfältet.
`CMFCToolBar::SetCommandUsageOptions`	Anger när kommandon som sällan används inte visas i programmets meny.
`CMFCToolBar::SetCustomizeMode`	Aktiverar eller inaktiverar anpassningsläge för alla verktygsfält i programmet.
`CMFCToolBar::SetGrayDisabledButtons`	Anger om de inaktiverade knapparna i verktygsfältet är nedtonade eller om inaktiverade bilder används för de inaktiverade knapparna.
`CMFCToolBar::SetHeight`	Anger höjden på verktygsfältet.
`CMFCToolBar::SetHotBorder`	Anger om verktygsfältsknappar är snabbspårade.
`CMFCToolBar::SetHotTextColor`	Anger textfärgen för knappar i verktygsfältet.
`CMFCToolBar::SetLargeIcons`	Anger om verktygsfältsknappar visar stora ikoner.
`CMFCToolBar::SetLockedSizes`	Anger storleken på låsta knappar och låsta bilder i verktygsfältet.
`CMFCToolBar::SetMenuSizes`	Anger storleken på menyknapparna i verktygsfältet och deras bilder.
`CMFCToolBar::SetNonPermittedCommands`	Anger listan över kommandon som inte kan köras av användaren.
`CMFCToolBar::SetOneRowWithSibling`	Placerar verktygsfältet och dess syskon på samma rad.
`CMFCToolBar::SetPermament`	Anger om en användare kan stänga verktygsfältet.
`CMFCToolBar::SetRouteCommandsViaFrame`	Anger om den överordnade ramen eller ägaren skickar kommandon till verktygsfältet.
`CMFCToolBar::SetShowTooltips`	Anger om ramverket visar verktygstips.
`CMFCToolBar::SetSiblingToolBar`	Anger på samma sätt som verktygsfältet.
`CMFCToolBar::SetSizes`	Anger storleken på knappar och bilder i alla verktygsfält.
`CMFCToolBar::SetToolBarBtnText`	Anger egenskaper för en knapp i verktygsfältet.
`CMFCToolBar::SetTwoRowsWithSibling`	Placerar verktygsfältet och dess syskon på separata rader.
`CMFCToolBar::SetUserImages`	Anger samlingen av användardefinierade bilder i programmet.
`CMFCToolBar::StretchPane`	Sträcker ut verktygsfältet lodrätt eller vågrätt. (Åsidosätter `CBasePane::StretchPane`.)
`CMFCToolBar::TranslateChar`	Kör ett knappkommando om den angivna nyckelkoden motsvarar ett giltigt kortkommando.
`CMFCToolBar::UpdateButton`	Uppdaterar tillståndet för den angivna knappen.
`CMFCToolBar::WrapToolBar`	Flyttar verktygsfältsknappar inom de angivna dimensionerna.

Skyddade metoder

Namn	Beskrivning
`CMFCToolBar::AllowShowOnList`	Avgör om verktygsfältet visas i listan i fönstret Verktygsfält i dialogrutan Anpassa.
`CMFCToolBar::CalcMaxButtonHeight`	Beräknar den maximala höjden på en knapp i verktygsfältet.
`CMFCToolBar::DoPaint`	Ommålar ett verktygsfält.
`CMFCToolBar::DrawButton`	Ommålar en knapp i verktygsfältet.
`CMFCToolBar::DrawSeparator`	Ommålar en avgränsare i ett verktygsfält.
`CMFCToolBar::OnUserToolTip`	Anropas av ramverket när knappbeskrivningen för en knapp är på väg att visas.

Datamedlemmar

Namn	Beskrivning
`CMFCToolBar::m_bDontScaleImages`	Anger om bilder i verktygsfältet ska skalas eller inte i högt DPI-läge.
`CMFCToolBar::m_dblLargeImageRatio`	Anger förhållandet mellan dimensionen (höjd eller bredd) för stora bilder och dimensionen för vanliga bilder.

Anmärkningar

Följ dessa steg för att införliva ett CMFCToolBar objekt i ditt program:

Lägg till ett CMFCToolBar objekt i huvudramfönstret.
När du bearbetar WM_CREATE meddelande för huvudramsfönstret anropar du antingen CMFCToolBar::Create eller CMFCToolBar::CreateEx för att skapa verktygsfältet och ange dess formatmall.
Anropa CBasePane::EnableDocking för att ange dockningsformatet.

Om du vill infoga en särskild knapp, till exempel en kombinationsruta eller ett nedrullningsbara verktygsfält, reserverar du en dummy-knapp i den överordnade resursen och ersätter dummy-knappen vid körning med hjälp av CMFCToolBar::ReplaceButton. Mer information finns i genomgång: Placera kontroller i verktygsfält.

CMFCToolBar är basklassen för MFC-biblioteksklasserna CMFCMenuBar Class, CMFCPopupMenuBar Classoch CMFCDropDownToolBar Class.

Exempel

I följande exempel visas hur du använder olika metoder i klassen CMFCToolBar. Exemplet visar hur du anger texten i fönsteretiketten i verktygsfältet, anger kantlinjerna, anger formatet för fönstret och aktiverar knappen Lägg till eller ta bort knappar som visas i slutet av verktygsfältet. Det här kodfragmentet är en del av IE Demo-exempelexemplet.

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

Krav

rubrik:afxtoolbar.h

Arvshierarki

CMFCToolBar

`CMFCToolBar::AddBasicCommand`

Lägger till ett menykommando i listan över kommandon som alltid visas när en användare öppnar en meny.

static void __stdcall AddBasicCommand(UINT uiCmd);

Parametrar

uiCmd
[i] Anger det kommando som ska läggas till.

Anmärkningar

Ett grundläggande kommando visas alltid när menyn öppnas. Den här metoden är meningsfull när användaren väljer att visa nyligen använda kommandon.

Använd metoden CMFCToolBar::SetBasicCommands för att ange listan över kommandon som alltid visas när en användare öppnar en meny. Använd metoden CMFCToolBar::GetBasicCommands för att hämta listan över grundläggande kommandon som används av ditt program.

`CMFCToolBar::AddCommandUsage`

Ökar med en räknare som är associerad med det angivna kommandot.

static void __stdcall AddCommandUsage(UINT uiCommand);

Parametrar

uiCommand
[i] Anger kommandoräknaren som ska ökas.

Anmärkningar

Ramverket anropar den här metoden när användaren väljer ett menyalternativ.

Ramverket använder kommandoräknare för att visa nyligen använda menyalternativ.

Den här metoden ökar kommandoräknaren med hjälp av metoden CMFCCmdUsageCount::AddCmd.

`CMFCToolBar::AddToolBarForImageCollection`

Lägger till bilder från användargränssnittsresurserna i samlingen av bilder i programmet.

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

Parametrar

uiResID
[i] Resurs-ID för ett verktygsfält med bilder att läsa in.

uiBmpResID
[i] Resurs-ID för en bitmapp med verktygsfältsbilder.

uiColdResID
[i] Resurs-ID för en bitmapp med "kalla" verktygsfältsbilder.

uiMenuResID
[i] Resurs-ID för en bitmapp med menybilder.

uiDisabledResID
[i] Resurs-ID för en bitmapp med inaktiverade verktygsfältsbilder.

uiMenuDisabledResID
[i] Resurs-ID för en bitmapp med inaktiverade menybilder.

Returvärde

TRUE om metoden lyckas. FALSE om uiResID eller uiBmpResID inte anger giltiga resurser, eller om ett annat fel inträffar.

Anmärkningar

Anropa den här metoden för att läsa in en bitmapp med verktygsfältsbilder och lägga till den i samlingen med verktygsfältsbilder. Den här metoden skapar ett tillfälligt verktygsfältsobjekt och anropar CMFCToolBar::LoadToolBar.

`CMFCToolBar::AdjustLayout`

Beräknar om storleken och positionen för ett verktygsfält.

virtual void AdjustLayout();

Anmärkningar

Anropa den här metoden när verktygsfältet har skapats för att beräkna om dess storlek och position.

Ramverket anropar den här metoden varje gång verktygsfältets layout måste ändras. Layouten måste till exempel ändras när användaren flyttar ett annat kontrollfält, ändrar storlek på ett programfönster eller anpassar verktygsfältet.

Åsidosätt den här metoden för att ange en egen dynamisk layout i klasser som du härleder från CMFCToolbar.

`CMFCToolBar::AdjustSize`

Beräknar om storleken på verktygsfältet.

void AdjustSize();

Anmärkningar

Den här metoden ser till att verktygsfältet passar inom ramens gränser. Den här metoden gör ingenting om verktygsfältet inte har någon överordnad ram.

Metoden CMFCToolBar::AdjustLayout anropar den här metoden för att beräkna om storleken om det överordnade verktygsfältet inte är ett CMFCReBar objekt.

`CMFCToolBar::AllowChangeTextLabels`

Anger om textetiketter kan visas under bilder i verktygsfältsknapparna.

virtual BOOL AllowChangeTextLabels() const;

Returvärde

TRUE om det är tillåtet att visa textetiketter under bilder; annars FALSE.

Anmärkningar

Den här metoden anropas av dialogrutan för anpassning för att avgöra om du vill aktivera en Kryssrutan Visa textetiketter på verktygsfältssidan för det markerade verktygsfältet.

Standardimplementeringen returnerar TRUE.

Åsidosätt den här metoden i ett objekt som härletts från CMFCToolBar och returnera FALSE när du inte vill att användaren ska bestämma om textetiketter ska visas på verktygsfältsknappar under bilderna.

`CMFCToolBar::AllowShowOnList`

Avgör om verktygsfältet visas i listan med verktygsfält i fönstret Verktygsfält i dialogrutan Anpassa.

virtual BOOL AllowShowOnList() const;

Returvärde

TRUE om verktygsfältsobjektet kan visas i listrutan på sidan för anpassning av verktygsfältet. annars FALSE.

Anmärkningar

Den här metoden anropas av ramverket för att avgöra om listan på sidan för anpassning av verktygsfältet ska innehålla ett visst objekt som härleds från CMFCToolBar.

Standardimplementeringen returnerar alltid TRUE. Åsidosätt den här metoden när du inte vill att ett verktygsfält ska visas i listan med verktygsfält i dialogrutan anpassning.

`CMFCToolBar::AreTextLabels`

Anger om textetiketter under bilder för närvarande visas i verktygsfältsknapparna.

BOOL AreTextLabels() const;

Returvärde

TRUE om verktygsfältsknapparna visar textetiketter under bilder; annars FALSE.

Anmärkningar

Använd CMFCToolBar::EnableTextLabels för att ange om texten ska visas. Standardvärdet är FALSE. Anropa CMFCToolBar::AllowChangeTextLabels för att ange om användaren kan ändra den här inställningen i dialogrutan anpassning.

`CMFCToolBar::AutoGrayInactiveImages`

Aktiverar eller inaktiverar automatisk generering av inaktiva knappbilder.

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

Parametrar

bEnable
[i] Ett booleskt värde som anger om inaktiva bilder ska tonas ned. Om den här parametern är TRUEär inaktiva bilder nedtonade. Annars är inaktiva bilder inte nedtonade.

nGrayImagePercentage
[i] Anger luminansprocenten för inaktiva bilder. Om bEnable är FALSEignoreras det här värdet.

bRedrawAllToolbars
[i] Ett booleskt värde som anger om alla verktygsfält i programmet ska ritas om. Om den här parametern är TRUEritar den här metoden om alla verktygsfält.

Anmärkningar

Om bEnable är TRUEanvänder ramverket nGrayImagePercentage för att generera inaktiva bilder från de vanliga bilderna. Annars måste du ange uppsättningen inaktiva bilder med hjälp av metoden CMFCToolBar::GetColdImages. Det här alternativet är inaktiverat som standard.

Mer information om parametern nGrayImagePercentage finns i CMFCToolBarImages::GrayImages.

`CMFCToolBar::ButtonToIndex`

Returnerar indexet för ett angivet CMFCToolBarButton class-objekt i det här verktygsfältet.

int ButtonToIndex(const CMFCToolBarButton* pButton) const;

Parametrar

pButton
[i] En pekare till knappobjektet i verktygsfältet.

Returvärde

Index för pButton i den interna listan med verktygsfältsknappar. eller -1 om den angivna knappen inte finns i det här verktygsfältet.

`CMFCToolBar::CalcFixedLayout`

Beräknar verktygsfältets vågräta storlek.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parametrar

bStretch
[in] TRUE för att sträcka ut verktygsfältet till storleken på den överordnade ramen.

bHorz
[i] TRUE för att orientera verktygsfältet vågrätt; FALSE för att orientera verktygsfältet lodrätt.

Returvärde

Ett CSize objekt som anger verktygsfältets storlek.

Anmärkningar

Den här metoden beräknar verktygsfältets storlek med hjälp av metoden CMFCToolBar::CalcLayout. Den skickar flaggan LM_STRETCH för parametern dwMode om bStretch är TRUE. Den skickar flaggan LM_HORZ om bHorz är TRUE.

Se VisualStudioDemo-exemplet för ett exempel som använder den här metoden.

`CMFCToolBar::CalcMaxButtonHeight`

Beräknar den maximala höjden på knapparna i verktygsfältet.

virtual int CalcMaxButtonHeight();

Returvärde

Den maximala höjden på knapparna.

Anmärkningar

Den här metoden beräknar den maximala höjden bland alla verktygsfältsknappar i verktygsfältet. Höjden kan variera beroende på faktorer som det aktuella dockningstillståndet för verktygsfältet.

Åsidosätt den här metoden i en klass som härleds från CMFCToolBar för att ange en egen höjdberäkning.

`CMFCToolBar::CalcSize`

Anropas av ramverket som en del av layoutberäkningsprocessen.

virtual CSize CalcSize(BOOL bVertDock);

Parametrar

bVertDock
[in] TRUE för att ange att verktygsfältet är dockat lodrätt. FALSE för att ange att verktygsfältet är dockat vågrätt.

Returvärde

Ett CSize objekt som anger den totala storleken på knapparna i verktygsfältet.

Anmärkningar

Den här metoden tar hänsyn till de attribut som påverkar storleken på varje knapp, till exempel textetikettens område och kantstorleken.

Om verktygsfältet inte innehåller några knappar returnerar den här metoden den reserverade storleken på en enda knapp med hjälp av metoden CMFCToolBar::GetButtonSize.

`CMFCToolBar::CanBeClosed`

Anger om en användare kan stänga verktygsfältet.

virtual BOOL CanBeClosed() const;

Returvärde

TRUE om verktygsfältet kan stängas av användaren. annars FALSE.

Anmärkningar

Ramverket anropar den här metoden för att avgöra om användaren kan stänga ett verktygsfält. Om metoden returnerar TRUEaktiverar ramverket kommandot SC_CLOSE i systemmenyn i verktygsfältet och användaren kan stänga verktygsfältet med hjälp av en kryssruta i listan med verktygsfält i dialogrutan anpassning.

Standardimplementeringen returnerar TRUE. Åsidosätt den här metoden i en klass som härleds från CMFCToolBar för att skapa verktygsfältsobjekt som inte kan stängas av användaren.

`CMFCToolBar::CanBeRestored`

Avgör om systemet kan återställa ett verktygsfält till sitt ursprungliga tillstånd efter anpassningen.

virtual BOOL CanBeRestored() const;

Returvärde

TRUE om verktygsfältet kan återställas från programresurserna. annars FALSE.

Anmärkningar

Ramverket anropar den här metoden för att avgöra om ett verktygsfält kan returneras till sitt ursprungliga tillstånd efter anpassningen. Det ursprungliga tillståndet läses in från programresurserna.

Om CanBeRestored returnerar TRUEaktiverar sidan verktygsfält i dialogrutan anpassning knappen Återställ för det valda verktygsfältet.

Standardimplementeringen returnerar TRUE om det ursprungliga resurs-ID:t för verktygsfältet när det lästes in inte är noll. Vanligtvis går det inte att återställa endast användardefinierade verktygsfält.

Du kan åsidosätta metoden CanBeRestored för att anpassa det här beteendet i härledda klasser.

`CMFCToolBar::CanFocus`

Anger om fönstret kan få fokus.

virtual BOOL CanFocus() const;

Returvärde

Den här metoden returnerar FALSE.

Anmärkningar

Den här metoden åsidosätter basklassimplementeringen, CBasePane::CanFocus, eftersom verktygsfältsobjekt inte kan ta emot fokus.

`CMFCToolBar::CanHandleSiblings`

Avgör om verktygsfältet och dess syskon är placerade i samma fönster.

BOOL CanHandleSiblings();

Returvärde

TRUE om verktygsfältet har ett syskon och verktygsfältet och dess syskon placeras i samma fönster. annars FALSE.

Anmärkningar

Den interna CMFCCustomizeButton::CreatePopupMenu-metoden anropar den här metoden för att avgöra hur du visar popup-menyn Anpassa. Om den här metoden returnerar TRUEvisar ramverket knapparna Visa knappar på en rad eller Visa knappar på två rader knappar.

Du behöver vanligtvis inte använda den här metoden. Om du vill aktivera knappen Anpassa som visas i verktygsfältet anropar du metoden CMFCToolBar::EnableCustomizeButton. Om du vill aktivera Visa knappar på en rad eller Visa knappar på två rader knappar anropar du CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::CleanUpImages`

Frigör systemresurser som allokerats för verktygsfältsbilder.

static void CMFCToolBar::CleanUpImages();

Anmärkningar

Ramverket anropar den här metoden när ett program stängs av.

`CMFCToolBar::CleanUpLockedImages`

Frigör systemresurser som allokerats för låsta verktygsfältsbilder.

void CleanUpLockedImages();

Anmärkningar

Anropa den här metoden när det visuella formatet för ditt program ändras. Se VisualStudioDemo-exemplet för ett exempel som använder den här metoden.

`CMFCToolBar::CommandToIndex`

Returnerar indexet för knappen i verktygsfältet med ett angivet kommando-ID.

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

Parametrar

nIDFind
[i] Anger kommando-ID: t.

iIndexFirst
[i] Anger det första indexet som ska startas från.

Returvärde

Nollbaserat index för verktygsfältsknappen om metoden lyckades. -1 om det inte finns någon knapp med det angivna ID:t.

Anmärkningar

Ett CMFCToolBar-objekt har en intern lista över knapparna i verktygsfältet. Anropa den här funktionen för att hämta indexet för en knapp i listan med hjälp av kommando-ID:t för knappen.

Om iIndex är större än 0 ignorerar den här metoden alla knappar i verktygsfältet som har ett index som är mindre än iIndex.

`CMFCToolBar::Create`

Skapar ett CMFCToolBar objekt.

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

Parametrar

pParentWnd
[i] En pekare till det överordnade fönstret i verktygsfältet.

dwStyle
[i] Verktygsfältsformatet. Se Kontroll- och knappformat för verktygsfältet i Windows SDK för listan över formatmallar.

nID
[i] ID:t för det underordnade fönstret i verktygsfältet.

Returvärde

TRUE om den här metoden lyckas. annars FALSE.

Anmärkningar

Den här metoden skapar ett kontrollfält och kopplar det till verktygsfältet. Det skapar kontrollfältet med TBSTYLE_FLAT formatmall. Anropa CMFCToolBar::CreateEx om du vill ha ett annat format för kontrollfältet.

`CMFCToolBar::CreateEx`

Skapar ett CMFCToolBar objekt som använder ytterligare formatalternativ, till exempel stora ikoner.

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

Parametrar

pParentWnd
[i] En pekare till det överordnade fönstret i verktygsfältet.

dwCtrlStyle
[i] Ytterligare formatmallar för att skapa det inbäddade kontrollstapelobjektet.

dwStyle
[i] Verktygsfältsformatet. En lista med lämpliga format finns i Kontroll- och knappformat för verktygsfältet.

rcBorders
[i] Ett CRect objekt som anger bredden på verktygsfältets fönsterkantlinjer.

nID
[i] ID:t för det underordnade fönstret i verktygsfältet.

Returvärde

Nonzero om den här metoden lyckas; annars 0.

Anmärkningar

Den här metoden skapar ett kontrollfält och kopplar det till verktygsfältet.

Anropa den här metoden i stället för CMFCToolBar::Create när du vill ange specifika formatmallar. Ange till exempel dwCtrlStyle till TBSTYLE_FLAT | TBSTYLE_TRANSPARENT för att skapa ett verktygsfält som liknar de verktygsfält som används av Internet Explorer 4.

Exempel

I följande exempel visas hur du använder CreateEx-metoden för klassen CMFCToolBar. Det här kodfragmentet är en del av IE Demo-exempelexemplet.

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`

Inaktiverar verktygsfältet.

virtual void Deactivate();

Anmärkningar

Den här metoden inaktiverar verktygsfältet genom att ta bort fokus från den markerade verktygsfältsknappen. Ramverket anropar den här metoden när verktygsfältet förlorar fokus eller förstörs.

`CMFCToolBar::DoPaint`

Ommålar ett verktygsfält.

virtual void DoPaint(CDC* pDC);

Parametrar

pDC
[i] En pekare till en enhetskontext.

Anmärkningar

Den här metoden anropas av ramverket när en del av verktygsfältet måste målas om.

Åsidosätt den här metoden för att anpassa utseendet på ett objekt som härletts från CMFCToolBar.

`CMFCToolBar::DrawButton`

Ommålar en knapp i verktygsfältet.

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

Parametrar

pDC
[i] En pekare till en enhetskontext.

pButton
[i] En pekare till en knapp att rita.

pImages
[i] En pekare till verktygsfältsbilderna.

bHighlighted
[i] TRUE om knappen är markerad. annars FALSE.

bDrawDisabledImages
[in] TRUE om inaktiverade knappar är nedtonade. annars FALSE.

Returvärde

TRUE om knappen har målats om. FALSE om knappen är dold.

Anmärkningar

Metoden CMFCToolBar::DrawButton anropar den här metoden när en knapp i verktygsfältet måste målas om.

Åsidosätt den här metoden om du vill anpassa utseendet på knappar i verktygsfältet.

`CMFCToolBar::DrawSeparator`

Ommålar en avgränsare i ett verktygsfält.

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

Parametrar

pDC
[i] En pekare till en enhetskontext.

rect
[i] Avgränsningsrektangeln för platsen där avgränsaren ritas, i bildpunkter.

bHorz
[i] TRUE om avgränsaren är vågrät FALSE om avgränsaren är lodrät.

Anmärkningar

CMFCToolBar::DoPaint anropar den här metoden för varje CMFCToolBar::DrawSeparator objekt som har TBBS_SEPARATOR formatmall, i stället för att anropa CMFCToolBar::DrawButton för dessa knappar.

Åsidosätt den här metoden i en klass som härleds från CMFCToolBar för att anpassa utseendet på avgränsare i verktygsfältet. Standardimplementeringen anropar CMFCVisualManager::OnDrawSeparator för att rita en avgränsare vars utseende bestäms av den aktuella visualiseringshanteraren.

`CMFCToolBar::EnableCustomizeButton`

Aktiverar eller inaktiverar knappen Anpassa som visas i verktygsfältet.

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

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

Parametrar

bEnable
[i] Aktiverar eller inaktiverar knappen Anpassa.

iCustomizeCmd
[i] Kommando-ID för knappen Anpassa.

strCustomizeText
[i] Textetiketten för knappen Anpassa.

uiCustomizeTextResId
[i] Resurssträngens ID för knappetiketten Anpassa.

bQuickCustomize
[i] Aktiverar eller inaktiverar alternativet Lägg till eller ta bort knappar på menyn som faller ned från knappen.

Anmärkningar

Om iCustomizeCmd är -1 visar ramverket knappen Anpassa när flera verktygsfältsknappar inte får plats i verktygsfältsområdet. Knappen visar en dubbel vänsterriktad pil, eller sparr, vilket indikerar att det finns fler knappar.

Om iCustomizeCmd anger ett giltigt kommando-ID och bEnable är TRUEvisas alltid knappen Anpassa. Knappen har en liten nedåtpil och öppnar en meny som innehåller ett kommando. Det här kommandot använder den textetikett som anges av strCustomizeText. Om bQuickCustomize också är TRUEvisar menyn alternativet Lägg till eller ta bort knappar.

Ramverket lägger dynamiskt till alla knappar som inte får plats i verktygsfältsområdet före det objekt som anges av iCustomizeCmd. Sparren visas bredvid nedåtpilen.

`CMFCToolBar::EnableDocking`

Aktiverar dockning av fönstret till huvudramen.

virtual void EnableDocking(DWORD dwAlignment);

Parametrar

dwAlignment
[i] Anger den dockningsjustering som ska aktiveras.

Anmärkningar

Den här metoden utökar basklassimplementeringen, CBasePane::EnableDocking, genom att ange CBasePane::m_dwControlBarStyle datamedlem till AFX_CBRS_FLOAT. Den här metoden skickar sedan dwAlignment till basklassimplementeringen.

`CMFCToolBar::EnableLargeIcons`

Aktiverar eller inaktiverar stora ikoner på verktygsfältsknappar.

void EnableLargeIcons(BOOL bEnable);

Parametrar

bEnable
[i] TRUE för att aktivera stora ikoner FALSE inaktivera stora ikoner.

Anmärkningar

Som standard är stora ikoner aktiverade.

`CMFCToolBar::EnableQuickCustomization`

Aktiverar eller inaktiverar snabbanpassning av verktygsfält så att användaren kan trycka på Alt- och dra en knapp till en ny plats.

static void EnableQuickCustomization(BOOL bEnable=TRUE);

Parametrar

bEnable
[i] TRUE för att aktivera snabb anpassning FALSE för att inaktivera snabb anpassning.

`CMFCToolBar::EnableReflections`

Aktiverar eller inaktiverar kommandoreflektion.

void EnableReflections(BOOL bEnable = TRUE);

Parametrar

bEnable
[i] TRUE för att aktivera kommandoreflektion; FALSE för att inaktivera kommandoreflektion.

Anmärkningar

Anropa den här metoden för att aktivera kommandoreflektion för verktygsfältsknappar som innehåller inbäddade kontroller, till exempel kombinationsrutor.

Mer information om kommandoreflektion finns i TN062: Meddelandereflektion för Windows Controls.

`CMFCToolBar::EnableTextLabels`

Aktiverar eller inaktiverar textetiketter under knappbilder i verktygsfältet.

void EnableTextLabels(BOOL bEnable=TRUE);

Parametrar

bEnable
TRUE om textetiketter visas under knappbilder i verktygsfältet. annars FALSE.

Anmärkningar

Om textetiketter är aktiverade förstoras alla knappar i verktygsfältet för att ge utrymme för etiketterna som ska visas under bilderna. Dialogrutan för anpassning har kryssrutan Visa textetikett på sidan Verktygsfält. När användaren väljer ett verktygsfält och kontrollerar det här alternativet anropar ramverket EnableTextLabels för det valda verktygsfältet. Du kan inaktivera kryssrutan för ett objekt som härletts från CMFCToolBar genom att returnera FALSE från CMFCToolBar::AllowChangeTextLabels .

`CMFCToolBar::FromHandlePermanent`

Hämtar en pekare till det CMFCToolBar objekt som innehåller det angivna fönsterhandtaget.

static CMFCToolBar* __stdcall FromHandlePermanent(HWND hwnd);

Parametrar

hwnd
[i] Fönsterhandtaget att leta efter.

Returvärde

En pekare till det CMFCToolBar objekt som innehåller det angivna fönsterhandtaget eller NULL om det inte finns någon motsvarande CMFCToolBar objekt.

Anmärkningar

Den här delade metoden undersöker varje verktygsfält i programmet för det CMFCToolBar objekt som innehåller det angivna fönsterhandtaget.

`CMFCToolBar::GetAllButtons`

Returnerar en skrivskyddad lista med knappar i ett verktygsfält.

const CObList& GetAllButtons() const;

Returvärde

En konstant referens till ett CObList class-objekt, som innehåller en samling CMFCToolBarButton class-objekt.

`CMFCToolBar::GetAllToolbars`

Returnerar en skrivskyddad lista över alla verktygsfält i programmet.

static const CObList& GetAllToolbars();

Returvärde

En const-referens till ett CObList class-objekt som innehåller en samling CMFCToolBar objekt.

`CMFCToolBar::GetBasicCommands`

Returnerar en skrivskyddad lista över de grundläggande kommandon som definierats i programmet.

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

Returvärde

En const-referens till ett CList class-objekt som innehåller en samling grundläggande kommandon.

Anmärkningar

Lägg till grundläggande kommandon genom att anropa CMFCToolBar::AddBasicCommand eller CMFCToolBar::SetBasicCommands.

`CMFCToolBar::GetButton`

Returnerar en pekare till objektet CMFCToolBarButton Class vid ett angivet index.

CMFCToolBarButton* GetButton(int iIndex) const;

Parametrar

iIndex
[i] Anger indexet för knappen som ska returneras.

Returvärde

En pekare till verktygsfältsknappen om den finns. eller NULL om det inte finns någon sådan knapp.

`CMFCToolBar::GetButtonInfo`

Returnerar kommando-ID, formatmall och bildindex för knappen vid ett angivet index.

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

Parametrar

nIndex
[i] Anger indexet för knappen i listan över knappar i verktygsfältet.

nID
[ut] Kommando-ID för en knapp.

nStyle
[ut] Knappens format.

iImage
[ut] Indexet för bilden för knappen.

Anmärkningar

Metoden GetButtonInfo hittar en verktygsfältsknapp i det angivna indexet och hämtar kommando-ID, format och bildindex för knappen.

Om knappen vid det angivna indexet inte finns anger ramverket nID och nStyle till 0 och iImage till -1 när metoden returneras.

`CMFCToolBar::GetButtonSize`

Returnerar dimensionerna för varje knapp i verktygsfältet.

CSize GetButtonSize() const;

Returvärde

Ett CSize class-objekt som anger dimensionerna för varje knapp i verktygsfältet.

Anmärkningar

Anropa CMFCToolBar::SetSizes eller CMFCToolBar::SetLockedSizes för att ange dimensionerna för varje knapp i verktygsfältet.

`CMFCToolBar::GetButtonStyle`

Returnerar det aktuella formatet för verktygsfältsknappen som finns i det angivna indexet.

UINT GetButtonStyle(int nIndex) const;

Parametrar

nIndex
[i] Anger indexet för en knapp i verktygsfältet.

Returvärde

Ett värde som anger formatmallen för verktygsfältsknappen. . En lista över möjliga format finns i Knapplistkontrollformat.

Anmärkningar

Anropa CMFCToolBar::SetButtonStyle för att ange formatmallen för en verktygsfältsknapp

`CMFCToolBar::GetButtonText`

Returnerar textetiketten för en knapp som har ett angivet index.

CString GetButtonText(int nIndex) const;

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

`CMFCToolBar::GetCommandButtons`

Returnerar en lista med knappar som har ett angivet kommando-ID från alla verktygsfält i programmet.

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

Parametrar

uiCmd
[i] Knapparnas kommando-ID.

listButtons
[ut] En referens till ett CObList class-objekt som tar emot listan med verktygsfältsknappar.

Returvärde

Antalet knappar som har det angivna kommando-ID:t.

`CMFCToolBar::GetCount`

Returnerar antalet knappar och avgränsare i verktygsfältet.

int GetCount() const;

Returvärde

Antalet knappar och avgränsare i verktygsfältet.

`CMFCToolBar::GetCustomizeButton`

Hämtar en pekare till det CMFCCustomizeButton objekt som är associerat med verktygsfältet.

CMFCCustomizeButton* GetCustomizeButton();

Returvärde

En pekare till det CMFCCustomizeButton objekt som är associerat med verktygsfältet.

Anmärkningar

Den här metoden hämtar knappen Anpassa som visas i slutet av verktygsfältet. Använd metoden CMFCToolBar::EnableCustomizeButton för att lägga till knappen Anpassa i verktygsfältet.

Du kan anropa metoden CMFCToolBar::IsExistCustomizeButton för att avgöra om verktygsfältet innehåller ett giltigt CMFCCustomizeButton objekt.

`CMFCToolBar::GetDefaultImage`

Returnerar indexet för standardbilden för en verktygsfältsknapp med ett angivet kommando-ID.

static int GetDefaultImage(UINT uiID);

Parametrar

BOOL GetIgnoreSetText() const;

Returvärde

TRUE om anrop för att ange knappetiketter ignoreras. annars FALSE.

Anmärkningar

`CMFCToolBar::GetImages`

Returnerar en pekare till samlingen med standardknappbilder i programmet.

static CMFCToolBarImages* GetImages();

Returvärde

En pekare till objektet CMFCToolBarImages Class som innehåller samlingen med standardbilder för alla verktygsfält i programmet.

Anmärkningar

Den här delade metoden ger åtkomst till samlingen med alla standardverktygsbilder för programmet. Anropa metoden CMFCToolBar::LoadBitmap för att lägga till bilder i samlingen.

`CMFCToolBar::GetImageSize`

Returnerar den aktuella storleken på knappbilder i verktygsfältet.

CSize GetImageSize() const;

Returvärde

Ett CSize class-objekt som representerar den aktuella storleken på knappbilder i verktygsfältet.

`CMFCToolBar::GetImagesOffset`

Returnerar indexförskjutningen som används för att hitta knappbilderna i verktygsfältet i den globala listan med knappbilder i verktygsfältet.

int GetImagesOffset() const;

Returvärde

Indexförskjutningen för verktygsfältsbilderna.

Anmärkningar

Alla standardbilder i verktygsfältet lagras i listan global CMFCToolBarImages Class. Bilderna för varje knapp i verktygsfältet lagras i följd i listan. Om du vill beräkna indexet för bilden lägger du till knappens index i verktygsfältet i förskjutningen av början av listan med bilder för verktygsfältsknappen.

Anropa CMFCToolBar::ButtonToIndex för att hämta indexet för en knapp i verktygsfältet med en pekare på knappen.

Anropa CMFCToolBar::GetImages för att hämta en pekare till samlingen med verktygsfältsbilder.

`CMFCToolBar::GetInvalidateItemRect`

Hämtar den region i klientområdet som måste ritas om för knappen i det angivna indexet.

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

Parametrar

nIndex
[i] Indexet för knappen som klientområdet ska hämtas för.

lpRect
[ut] En pekare till ett RECT objekt som tar emot regionen i klientområdet.

Anmärkningar

Parametern lpRect får inte vara NULL. Om det inte finns någon knapp i det angivna indexet tar lpRect emot ett RECT objekt som initieras till noll.

`CMFCToolBar::GetItemID`

Returnerar kommando-ID för verktygsfältsknappen vid ett angivet index.

UINT GetItemID(int nIndex) const;

Parametrar

nIndex
[i] Anger indexet för verktygsfältsknappen.

Returvärde

Kommando-ID för verktygsfältsknappen. eller noll om knappen med det angivna indexet inte finns.

`CMFCToolBar::GetItemRect`

Returnerar avgränsningsrektangeln för knappen vid ett angivet index.

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

Parametrar

nIndex
[i] Anger indexet för en knapp i verktygsfältet.

lpRect
[ut] En pekare till CRect objekt som tar emot koordinaterna för rektangeln för avgränsning av bilder.

Anmärkningar

Det CRect objekt som lpRect punkter är inställt på 0 om en knapp i det angivna indexet inte finns.

Exempel

I följande exempel visas hur du använder GetItemRect-metoden för klassen CMFCToolBar. Det här kodfragmentet är en del av IE Demo-exempelexemplet.

CMFCToolBar m_wndToolBar;

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

`CMFCToolBar::GetLargeColdImages`

Returnerar en pekare till samlingen med stora knappbilder för kallt verktygsfält i programmet.

static CMFCToolBarImages* GetLargeColdImages();

Returvärde

En pekare till samlingen med stora kalla bilder.

Anmärkningar

Kalla bilder är de bilder som används när användaren inte interagerar med verktygsfältsknapparna. Anropa CMFCToolBar::LoadBitmapEx för att läsa in de stora kalla bilderna.

`CMFCToolBar::GetLargeDisabledImages`

Returnerar en pekare till samlingen med stora inaktiverade knappbilder i programmet.

static CMFCToolBarImages* GetLargeDisabledImages();

Returvärde

En pekare till samlingen med stora inaktiverade knappbilder i verktygsfältet.

Anmärkningar

Stora bilder är stora versioner av vanliga knappbilder i verktygsfältet. Anropa CMFCToolBar::LoadBitmapEx eller CMFCToolBar::LoadBitmap för att läsa in de stora bilderna.

`CMFCToolBar::GetLargeImages`

Returnerar en pekare till samlingen med stora knappbilder i verktygsfältet i programmet.

static CMFCToolBarImages* GetLargeImages();

Returvärde

En pekare till samlingen med stora knappbilder i verktygsfältet.

Anmärkningar

Stora bilder är stora versioner av vanliga knappbilder i verktygsfältet. Anropa CMFCToolBar::LoadBitmapEx för att läsa in de stora bilderna.

`CMFCToolBar::GetLockedColdImages`

Returnerar en pekare till samlingen med låsta kalla bilder i verktygsfältet.

CMFCToolBarImages* GetLockedColdImages();

Returvärde

En pekare till samlingen med låsta kalla bilder eller NULL om verktygsfältet inte är låst.

Anmärkningar

Låsta bilder är versioner av vanliga knappbilder i verktygsfältet som ramverket använder när användaren inte kan anpassa verktygsfältet. Kalla bilder är de bilder som används när användaren inte interagerar med verktygsfältsknapparna.

Den här metoden returnerar NULL om verktygsfältet inte är låst. Den här metoden genererar också ett kontrollfel i felsökningsversioner om verktygsfältet inte är låst. Mer information om låsta verktygsfält finns i CMFCToolBar::IsLocked.

Anropa metoden CMFCToolBar::LoadBitmapEx för att läsa in de låsta kalla bilderna.

`CMFCToolBar::GetLockedDisabledImages`

Returnerar en pekare till samlingen med låsta inaktiverade bilder i verktygsfältet.

CMFCToolBarImages* GetLockedDisabledImages();

Returvärde

En pekare till samlingen med låsta inaktiverade bilder eller NULL om verktygsfältet inte är låst.

Anmärkningar

Låsta bilder är versioner av vanliga knappbilder i verktygsfältet som ramverket använder när användaren inte kan anpassa verktygsfältet. Inaktiverade bilder är de bilder som ramverket använder när en knapp har TBBS_DISABLED formatmall.

Anropa metoden CMFCToolBar::LoadBitmapEx för att läsa in de låsta inaktiverade bilderna.

`CMFCToolBar::GetLockedImages`

Returnerar en pekare till samlingen med låsta knappbilder i verktygsfältet.

CMFCToolBarImages* GetLockedImages();

Returvärde

En pekare till samlingen med låsta knappbilder i verktygsfältet eller NULL om verktygsfältet inte är låst.

Anmärkningar

Låsta bilder är versioner av vanliga knappbilder i verktygsfältet som ramverket använder när användaren inte kan anpassa verktygsfältet.

`CMFCToolBar::GetLockedImageSize`

Returnerar standardstorleken för låsta verktygsfältsbilder.

CSize GetLockedImageSize() const;

Returvärde

En CSize struktur som anger storleken på låsta verktygsfältsbilder eller en tom CSize struktur om verktygsfältet inte är låst.

Anmärkningar

Låsta bilder är versioner av vanliga knappbilder i verktygsfältet som ramverket använder när användaren inte kan anpassa verktygsfältet.

Den här metoden returnerar en CSize struktur med noll bredd och noll höjd om verktygsfältet inte är låst. Den här metoden genererar också ett kontrollfel i felsökningsversioner om verktygsfältet inte är låst. Mer information om låsta verktygsfält finns i CMFCToolBar::IsLocked.

Anropa metoden CMFCToolBar::SetLockedSizes för att ange den låsta bildstorleken.

`CMFCToolBar::GetLockedMenuImages`

Returnerar en pekare till samlingen med låsta verktygsfältsmenybilder i verktygsfältet.

CMFCToolBarImages* GetLockedMenuImages();

Returvärde

En pekare till samlingen med låsta verktygsfältsmenybilder eller NULL om verktygsfältet inte är låst.

Anmärkningar

Låsta bilder är versioner av vanliga menybilder i verktygsfältet som ramverket använder när användaren inte kan anpassa verktygsfältet.

Anropa metoden CMFCToolBar::LoadBitmapEx för att läsa in de låsta menybilderna.

`CMFCToolBar::GetMenuButtonSize`

Returnerar storleken på menyknapparna i programmet.

static CSize GetMenuButtonSize();

Returvärde

Ett CSize objekt som representerar storleken på menyknapparna i bildpunkter.

Anmärkningar

Storleken på menyknapparna i verktygsfälten bibehålls som en global variabel och kan hämtas med den här statiska metoden.

Anropa CMFCToolBar::SetMenuSizes för att ange den här globala variabeln.

`CMFCToolBar::GetMenuImages`

Returnerar en pekare till samlingen med menyknappsbilder i programmet.

static CMFCToolBarImages* GetMenuImages();

Returvärde

En pekare till samlingen med menybilder.

Anmärkningar

Anropa metoden CMFCToolBar::LoadBitmapEx för att läsa in menybilderna.

Anropa metoden CMFCToolBar::SetMenuSizes för att ange storleken på knappar och deras bilder.

`CMFCToolBar::GetMenuImageSize`

Returnerar storleken på menyknappsbilderna i programmet.

static CSize GetMenuImageSize();

Returvärde

Ett CSize objekt som representerar storleken på menybilder.

Anmärkningar

Den här metoden returnerar storleken på bilder på menyknappar i verktygsfältet som underhålls som en global variabel. Anropa CMFCToolBar::SetMenuSizes för att ange den här globala variabeln.

`CMFCToolBar::GetOrigButtons`

Hämtar samlingen med icke-anpassade knappar i verktygsfältet.

const CObList& GetOrigButtons() const;

Returvärde

En referens till listan över icke-anpassade knappar i verktygsfältet.

Anmärkningar

Ramverket skapar en kopia av verktygsfältsknappar innan de anpassas av användaren. Metoden CMFCToolBar::SetButtons lägger till en kopia av varje knapp i den angivna matrisen i listan över ursprungliga knappar. Metoden CMFCToolBar::RestoreOriginalState återställer verktygsfältets ursprungliga tillstånd genom att läsa in det från resursfilen.

Om du vill ange listan över ursprungliga knappar för verktygsfältet anropar du metoden CMFCToolBar::SetOrigButtons.

`CMFCToolBar::GetOrigResetButtons`

Hämtar samlingen med icke-anpassade återställningsknappar i verktygsfältet.

const CObList& GetOrigResetButtons() const;

Returvärde

En referens till listan över icke-anpassade återställningsknappar i verktygsfältet.

Anmärkningar

När användaren väljer knappen Återställ under anpassningsläget använder ramverket den här metoden för att återställa knappar som har tagits bort från verktygsfältet.

Metoden CMFCToolBar::SetButtons lägger till en kopia av varje verktygsfältsknapp i listan över ursprungliga återställningsknappar när den anropar metoden CMFCToolBar::OnReset. Du kan åsidosätta metoden CMFCToolBar::OnReset för att anpassa utseendet på knappar när användaren trycker på knappen Återställ.

`CMFCToolBar::GetResourceID`

Hämtar resurs-ID för verktygsfältet.

UINT GetResourceID() const;

Returvärde

Verktygsfältets resurs-ID.

Anmärkningar

Anropa metoden CMFCToolBar::LoadToolBarEx för att ange resurs-ID för verktygsfältet.

`CMFCToolBar::GetRouteCommandsViaFrame`

Avgör vilket objekt, den överordnade ramen eller ägaren, som skickar kommandon till verktygsfältet.

BOOL GetRouteCommandsViaFrame();

Returvärde

Nonzero om den överordnade ramen skickar kommandon till verktygsfältet. 0 om ägaren skickar kommandon till verktygsfältet.

Anmärkningar

Som standard skickar den överordnade ramen kommandon till verktygsfältet. Anropa CMFCToolBar::SetRouteCommandsViaFrame för att ändra det här beteendet.

Om den här metoden returnerar ett icke-nollvärde kan du hämta en pekare till det överordnade ramobjektet med hjälp av metoden CMFCToolBar::GetCommandTarget. Se VisualStudioDemo-exemplet för ett exempel som använder den här metoden.

`CMFCToolBar::GetRowHeight`

Returnerar höjden på verktygsfältsknapparna.

virtual int GetRowHeight() const;

Returvärde

Höjden på verktygsfältsknappar i bildpunkter.

Anmärkningar

Ramverket anropar den här metoden för att beräkna verktygsfältslayout. Åsidosätt den här metoden i en härledd klass för att ange en annan höjd för verktygsfältet.

`CMFCToolBar::GetShowTooltips`

Anger om verktygstips visas för verktygsfältsknappar.

static BOOL GetShowTooltips();

Returvärde

TRUE om verktygstips visas för verktygsfältsknappar; annars FALSE.

Anmärkningar

Som standard visas verktygstips. Du kan ändra den här statiska flaggan genom att anropa CMFCToolBar::SetShowTooltips.

`CMFCToolBar::GetSiblingToolBar`

Hämtar samma objekt i verktygsfältet.

CMFCToolBar* GetSiblingToolBar();

Returvärde

En pekare till verktygsfältet på samma nivå.

Anmärkningar

Mer information om hur du aktiverar Visa knappar på en rad och Visa knappar på två rader knappar finns i CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::GetUserImages`

Returnerar en pekare till samlingen med användardefinierade knappbilder i programmet.

static CMFCToolBarImages* GetUserImages();

Returvärde

En pekare till samlingen med användardefinierade knappbilder i verktygsfältet för alla verktygsfält i programmet.

Anmärkningar

Anropa metoden CMFCToolBar::SetUserImages för att ange samlingen av användardefinierade bilder i programmet.

`CMFCToolBar::HitTest`

Returnerar indexet för verktygsfältsknappen som finns på den angivna positionen.

virtual int HitTest(CPoint point);

Parametrar

point
[i] Den punkt som ska testas i klientkoordinater.

Returvärde

Indexet för knappen som finns på den angivna positionen, eller -1 om det inte finns någon sådan knapp eller om knappen är en avgränsare.

`CMFCToolBar::InsertButton`

Infogar en knapp i verktygsfältet.

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

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

Parametrar

button
[i] Anger knappen som ska infogas.

iInsertAt
[i] Anger den nollbaserade position som knappen ska infogas på.

Returvärde

Den position där knappen infogades eller -1 om ett fel inträffar.

Anmärkningar

Om iInsertAt är -1 lägger den här metoden till knappen i slutet av listan med verktygsfältsknappar.

Anropa metoden CMFCToolBar::InsertSeparator för att infoga en avgränsare i verktygsfältet.

`CMFCToolBar::InsertSeparator`

Infogar en avgränsare i verktygsfältet.

virtual int InsertSeparator(INT_PTR iInsertAt=-1);

Parametrar

iInsertAt
[i] Anger den nollbaserade position som avgränsaren ska infogas på. Den här parametern måste vara större än 0.

Returvärde

Den position där avgränsaren infogades eller -1 om ett fel inträffar.

Anmärkningar

Anropa den här metoden för att infoga en avgränsare mellan två befintliga knappar. Om iInsertAt är -1 lägger den här metoden till avgränsaren i slutet av listan med verktygsfältsknappar.

Du kan inte använda den här metoden för att lägga till en avgränsare i ett tomt verktygsfält.

Anropa metoden CMFCToolBar::InsertButton för att infoga en knapp i verktygsfältet.

`CMFCToolBar::InvalidateButton`

Ogiltigförklarar klientområdet för verktygsfältsknappen som finns i det angivna indexet.

CMFCToolBarButton* InvalidateButton(int nIndex);

Parametrar

nIndex
[i] Knappens nollbaserade index i verktygsfältet.

Returvärde

En pekare till det CMFCToolBarButton objekt som finns vid det angivna indexet eller NULL om det inte finns något sådant objekt.

Anmärkningar

Ramverket anropar den här metoden när den uppdaterar klientområdet som är associerat med en verktygsfältsknapp. Den anropar metoden CWnd::InvalidateRect med klientrektangeln för det CMFCToolBarButton objekt som finns i det angivna indexet.

`CMFCToolBar::IsAddRemoveQuickCustomize`

Avgör om en användare kan lägga till eller ta bort verktygsfältsknappar med hjälp av menyalternativet Anpassa.

BOOL IsAddRemoveQuickCustomize();

Returvärde

TRUE om en användare kan använda menyalternativet Anpassa för att ändra verktygsfältet. annars FALSE.

Anmärkningar

`CMFCToolBar::IsAltCustomizeMode`

Anger om snabbanpassning används för att dra en knapp. När snabbanpassning är aktiverat kan en användare trycka på och hålla Alt-tangenten och dra en knapp till en ny plats.

static BOOL __stdcall IsAltCustomizeMode();

Returvärde

TRUE om snabbanpassning används för att dra en knapp. annars FALSE.

Anmärkningar

`CMFCToolBar::IsAutoGrayInactiveImages`

Anger om den automatiska genereringen av inaktiva (icke-markerade) knappbilder är aktiverad.

static BOOL IsAutoGrayInactiveImages();

Returvärde

TRUE om alternativet för att automatiskt tona ned inaktiva bilder är aktiverat. annars FALSE.

Anmärkningar

Du kan aktivera eller inaktivera automatisk nedtoning av inaktiva bilder genom att anropa CMFCToolBar::AutoGrayInactiveImages.

`CMFCToolBar::IsBasicCommand`

Avgör om ett kommando finns med i listan över grundläggande kommandon.

static BOOL IsBasicCommand(UINT uiCmd);

Parametrar

uiCmd
[i] Anger det kommando som ska kontrolleras.

Returvärde

TRUE om det angivna kommandot tillhör listan med grundläggande kommandon. annars FALSE.

Anmärkningar

Den här statiska metoden avgör om kommandot som anges av uiCmd tillhör den globala listan över grundläggande kommandon. Du kan ändra listan över grundläggande kommandon genom att anropa CMFCToolBar::AddBasicCommand eller CMFCToolBar::SetBasicCommands.

`CMFCToolBar::IsButtonExtraSizeAvailable`

Avgör om verktygsfältet kan visa knappar som har utökade kantlinjer.

virtual BOOL IsButtonExtraSizeAvailable() const;

Returvärde

TRUE om fältet kan visa knappar med extra kantlinjestorlek. annars FALSE.

Anmärkningar

Verktygsfältsobjektet returnerar TRUE om det kan visa knappar som har utökade kantlinjer. En knapp i verktygsfältet anropar den här metoden när den hanterar CMFCToolBarButton::OnChangeParentWnd-meddelandet och anger dess interna flagga för extra kantlinjestorlek i enlighet med detta. Den här interna flaggan kan hämtas senare genom att anropa CMFCToolBarButton::IsExtraSize.

Åsidosätt den här metoden i en klass som härletts från CMFCToolBar och returnera TRUE om fältet kan visa verktygsfältsknapparna med extra kantlinjestorlek och returnera FALSE annars. Standardimplementeringen returnerar TRUE.

`CMFCToolBar::IsButtonHighlighted`

Avgör om den angivna knappen är markerad.

BOOL IsButtonHighlighted(int iButton) const;

Parametrar

iButton
[i] Anger indexet för en knapp i verktygsfältet.

Returvärde

TRUE om den angivna knappen är markerad. annars FALSE.

Anmärkningar

`CMFCToolBar::IsCommandPermitted`

Avgör om ett kommando är tillåtet.

static BOOL IsCommandPermitted(UINT uiCmd);

Parametrar

uiCmd
[i] Anger det kommando som ska kontrolleras.

Returvärde

TRUE om det angivna kommandot är tillåtet. annars FALSE.

Anmärkningar

Den här statiska metoden avgör om kommandot som anges av uiCmd tillhör den globala listan över kommandon som inte tillåts.

Du kan ändra listan över kommandon som inte tillåts genom att anropa CMFCToolBar::SetNonPermittedCommands.

`CMFCToolBar::IsCommandRarelyUsed`

Avgör om ett kommando används sällan.

static BOOL IsCommandRarelyUsed(UINT uiCmd);

Parametrar

uiCmd
[i] Anger det kommando som ska kontrolleras.

Returvärde

TRUE om det angivna kommandot sällan används. annars FALSE.

Anmärkningar

Metoden IsCommandRarelyUsed returnerar FALSE när ett eller flera av följande villkor inträffar:

Det angivna kommandot tillhör listan över grundläggande kommandon
Det angivna kommandot är ett av standardkommandona
Ramverket är i anpassningsläge
Listan över grundläggande kommandon är tom
Mer än 20% av kommandoanrop är anrop till det angivna kommandot.

`CMFCToolBar::IsCustomizeMode`

Anger om verktygsfältsramverket är i anpassningsläge.

static BOOL IsCustomizeMode();

Returvärde

TRUE om ramverket är i anpassningsläge. annars FALSE.

Anmärkningar

Du kan växla anpassningsläge genom att anropa CMFCToolBar::SetCustomizeMode.

Ramverket ändrar läget när användaren anropar dialogrutan anpassning ( CMFCToolBarsCustomizeDialog Class).

`CMFCToolBar::IsDragButton`

Avgör om en verktygsfältsknapp dras.

BOOL IsDragButton(const CMFCToolBarButton* pButton) const;

Parametrar

pButton
[i] Pekare till en knapp i verktygsfältet.

Returvärde

TRUE om den angivna knappen dras. annars FALSE.

Anmärkningar

`CMFCToolBar::IsExistCustomizeButton`

Avgör om verktygsfältet innehåller knappen Anpassa.

BOOL IsExistCustomizeButton();

Returvärde

TRUE om verktygsfältet innehåller knappen Anpassa. annars FALSE.

Anmärkningar

Om den här metoden returnerar TRUEreturnerar metoden CMFCToolBar::GetCustomizeButton en pekare till knappen Anpassa som visas i slutet av verktygsfältet.

Använd metoden CMFCToolBar::EnableCustomizeButton för att lägga till knappen Anpassa i verktygsfältet.

`CMFCToolBar::IsFloating`

Avgör om verktygsfältet är flytande.

virtual BOOL IsFloating() const;

Returvärde

TRUE om verktygsfältet är flytande. annars FALSE.

`CMFCToolBar::IsLargeIcons`

Anger om verktygsfälten i programmet för närvarande visar stora ikoner.

static BOOL IsLargeIcons();

Returvärde

TRUE om programmet använder stora ikoner. annars FALSE.

Anmärkningar

Anropa CMFCToolBar::SetLargeIcons för att växla mellan stora ikoner och vanliga ikoner.

Ramverket ändrar automatiskt läget när användaren växlar kryssrutan Stora ikoner på sidan Alternativ i dialogrutan Anpassning.

`CMFCToolBar::IsLastCommandFromButton`

Avgör om det senast utförda kommandot skickades från den angivna verktygsfältsknappen.

static BOOL IsLastCommandFromButton(CMFCToolBarButton* pButton);

Parametrar

pButton
[i] Pekare till knapp.

Returvärde

TRUE om det senaste kommandot skickades från knappen som pButton anger. annars FALSE.

Anmärkningar

Den här metoden hämtar en pekare till en MSG Structure genom att anropa CWnd::GetCurrentMessage. Den jämför sedan knappens HWND med MSG::lParam och MSG::hwnd medlemmar för att avgöra om knappen var källan till kommandot.

`CMFCToolBar::IsLocked`

Avgör om verktygsfältet är låst.

BOOL IsLocked() const;

Returvärde

TRUE om verktygsfältet är låst. annars FALSE.

Anmärkningar

Den här metoden returnerar TRUE när användaren inte kan utföra anpassningsuppgifter som att flytta verktygsfältsknappar.

Låsta verktygsfält använder separata bildlistor. Mer information om dessa bildlistor finns i CMFCToolBar::LoadBitmapEx.

`CMFCToolBar::IsOneRowWithSibling`

Avgör om verktygsfältet och dess samma verktygsfält är placerade på samma rad.

BOOL IsOneRowWithSibling();

Returvärde

TRUE om verktygsfältet och dess syskon är placerade på samma rad. annars FALSE.

Anmärkningar

Metoden CMFCCustomizeButton::CreatePopupMenu anropar den här metoden för att avgöra hur du visar popup-menyn Anpassa. Om den här metoden returnerar TRUEvisar ramverket knappen Visa knappar på en rad. Annars visar ramverket knappen Visa knappar på två rader.

Du behöver vanligtvis inte använda den här metoden. Om du vill aktivera Visa knappar på en rad eller Visa knappar på två rader knappar anropar du CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::IsResourceChanged`

virtual BOOL IsResourceChanged() const;

Returvärde

Anmärkningar

`CMFCToolBar::IsSibling`

BOOL IsSibling();

Returvärde

Anmärkningar

`CMFCToolBar::IsUserDefined`

Anger om verktygsfältet är användardefinierat.

BOOL IsUserDefined() const;

Returvärde

TRUE om verktygsfältet skapades av användaren. annars FALSE.

`CMFCToolBar::LoadBitmap`

Läser in verktygsfältsbilder från programresurser.

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

Parametrar

uiResID
[i] Resurs-ID:t för bitmappen som refererar till de heta verktygsfältsbilderna.

uiColdResID
[i] Resurs-ID:t för bitmappen som refererar till bilderna i det kalla verktygsfältet.

uiMenuResID
[i] Resurs-ID för bitmappen som refererar till de vanliga menybilderna.

bLocked
[in] TRUE för att låsa verktygsfältet; annars FALSE.

uiDisabledResID
[i] Resurs-ID för bitmappen som refererar till inaktiverade verktygsfältsbilder.

uiMenuDisabledResID
[i] Resurs-ID:t för bitmappen som refererar till inaktiverade menybilder.

Returvärde

Nonzero om metoden lyckas; annars 0.

Anmärkningar

Metoden CMFCToolBar::LoadToolBarEx anropar den här metoden för att läsa in de bilder som är associerade med verktygsfältet. Åsidosätt den här metoden för att utföra anpassad inläsning av avbildningsresurser.

Anropa metoden LoadBitmapEx för att läsa in ytterligare bilder när du har skapat verktygsfältet.

`CMFCToolBar::LoadBitmapEx`

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

Parametrar

[i] params
[i] bLocked

Returvärde

Anmärkningar

`CMFCToolBar::LoadLargeIconsState`

static BOOL __stdcall LoadLargeIconsState(LPCTSTR lpszProfileName = NULL);

Parametrar

[i] lpszProfileName

Returvärde

Anmärkningar

`CMFCToolBar::LoadParameters`

Läser in globala verktygsfältsalternativ från Windows-registret.

static BOOL LoadParameters(LPCTSTR lpszProfileName=NULL);

Parametrar

lpszProfileName
[i] Anger den relativa sökvägen för Windows-registernyckeln.

Returvärde

Nonzero om metoden lyckas; annars 0.

Anmärkningar

Den här metoden läser in globala parametrar som menyanimeringstypen, menyns skuggformat och om du vill visa stora ikoner från Windows-registret.

Metoden CWinAppEx::LoadState anropar den här metoden som en del av programmets initieringsprocess.

`CMFCToolBar::LoadState`

Läser in tillståndsinformation för verktygsfältet från Windows-registret.

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

Parametrar

lpszProfileName
[i] Anger den relativa sökvägen för Windows-registernyckeln.

nIndex
[i] Anger kontroll-ID för verktygsfältet.

uiID
[i] Anger resurs-ID för verktygsfältet.

Returvärde

Nonzero om metoden lyckas; annars 0.

Anmärkningar

Ramverket anropar den här metoden som en del av initieringsprocessen för programmet. Mer information finns i CWinAppEx::LoadState.

`CMFCToolBar::LoadToolBar`

Läser in verktygsfältet från programresurser.

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

Parametrar

uiResID
[i] Verktygsfältets resurs-ID.

uiColdResID
[i] Resurs-ID:t för bitmappen som refererar till bilderna i det kalla verktygsfältet.

uiMenuResID
[i] Resurs-ID för bitmappen som refererar till de vanliga menybilderna.

bLocked
[i] Ett booleskt värde som anger om verktygsfältet är låst eller inte. Om den här parametern är TRUEär verktygsfältet låst. Annars är verktygsfältet inte låst.

uiDisabledResID
[i] Resurs-ID för bitmappen som refererar till inaktiverade verktygsfältsbilder.

uiMenuDisabledResID
[i] Resurs-ID:t för bitmappen som refererar till inaktiverade menybilder.

uiHotResID
[i] Resurs-ID:t för bitmappen som refererar till de heta verktygsfältsbilderna.

Returvärde

Nonzero om metoden lyckas; annars 0.

Anmärkningar

Ramverket anropar den här metoden under initieringen för att läsa in de bilder som är associerade med verktygsfältet.

Exempel

I följande exempel visas hur du använder metoden LoadToolBar i klassen CMFCToolBar. Det här kodfragmentet är en del av IE Demo-exempelexemplet.

CMFCToolBar m_wndToolBar;

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

`CMFCToolBar::LoadToolBarEx`

Läser in verktygsfältet från programresurser med hjälp av hjälpklassen CMFCToolBarInfo för att programmet ska kunna använda stora avbildningar.

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

Parametrar

uiToolbarResID
[i] Verktygsfältets resurs-ID.

params
[i] En referens till ett CMFCToolBarInfo objekt som innehåller resurs-ID:t för verktygsfältsbilderna.

bLocked
[i] Ett booleskt värde som anger om verktygsfältet är låst eller inte. Om den här parametern är TRUEär verktygsfältet låst. Annars är verktygsfältet inte låst.

Returvärde

Nonzero om metoden lyckas; annars 0.

Anmärkningar

Anropa den här metoden för att läsa in verktygsfältsbilder från programresurserna.

`CMFCToolBar::m_dblLargeImageRatio`

Anger förhållandet mellan dimensionen (höjd eller bredd) för stora bilder och dimensionen för vanliga bilder.

AFX_IMPORT_DATA static double m_dblLargeImageRatio;

Anmärkningar

Standardförhållandet är 2. Du kan ändra det här värdet så att stora verktygsfältsbilder blir större eller mindre.

Ramverket använder den här datamedlemmen när du inte anger en uppsättning stora bilder. Om du till exempel bara anger en uppsättning små bilder med storlek 16x16 och vill att de stora bilderna ska ha storleken 24 x 24 anger du den här datamedlemmen till 1,5.

`CMFCToolBar::NextMenu`

virtual BOOL NextMenu();

Returvärde

Anmärkningar

`CMFCToolBar::OnBeforeRemoveButton`

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

Parametrar

pButton
[i] Oanvänd.

dropEffect
[i] Oanvänd.

Returvärde

Anmärkningar

`CMFCToolBar::OnChangeHot`

Anropas av ramverket när en användare väljer en knapp i verktygsfältet.

virtual void OnChangeHot(int iHot);

Parametrar

iHot
[i] Anger indexet för verktygsfältsknappen som är markerad. eller -1 om ingen verktygsfältsknapp har valts.

Anmärkningar

Åsidosätt den här metoden för att bearbeta meddelanden om att användaren har valt en knapp i ett verktygsfält.

`CMFCToolBar::OnChangeVisualManager`

virtual void OnChangeVisualManager();

Anmärkningar

`CMFCToolBar::OnFillBackground`

Anropas av ramverket från CBasePane::DoPaint för att fylla verktygsfältets bakgrund.

virtual void OnFillBackground(CDC* pDC);

Parametrar

pDC
[i] En pekare till en enhetskontext.

Anmärkningar

CMFCToolBar::DoPaint anropar den här metoden när bakgrunden i ett verktygsfält har fyllts i. Standardimplementeringen gör ingenting.

Åsidosätt den här metoden för att rita anpassad bakgrund i härledda klasser.

`CMFCToolBar::OnGlobalFontsChanged`

virtual void OnGlobalFontsChanged();

Anmärkningar

`CMFCToolBar::OnReset`

Återställer verktygsfältet till sitt ursprungliga tillstånd.

virtual void OnReset();

Anmärkningar

Åsidosätt den här metoden för att hantera meddelanden om en återställning av verktygsfältet.

Standardimplementeringen gör ingenting. Åsidosätt OnReset i en klass som härletts från CMFCToolBar när verktygsfältet har dummyknappar som måste ersättas när verktygsfältet återgår till sitt ursprungliga tillstånd.

`CMFCToolBar::OnSetAccData`

virtual BOOL OnSetAccData(long lVal);

Parametrar

[i] lVal

Returvärde

Anmärkningar

`CMFCToolBar::OnSetDefaultButtonText`

Återställer texten i en verktygsfältsknapp till standardtillståndet.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

Parametrar

pButton
[i] Pekar på en knapp, vars text anges.

Returvärde

TRUE om texten har återställts. annars FALSE.

Anmärkningar

Åsidosätt den här metoden för att bearbeta meddelanden om att texten i en verktygsfältsknapp ändras till standardvärdet.

Standardimplementeringen läser in texten för en knapp från programresurserna.

`CMFCToolBar::OnUserToolTip`

Anropas av ramverket när knappbeskrivningen för en knapp är på väg att visas.

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

Parametrar

pButton
[i] Pekar på en knapp i verktygsfältet som en knappbeskrivning ska visas för.

strTTText
[ut] En referens till CString objekt som tar emot texten i knappbeskrivningen.

Returvärde

TRUE om strTTText fylldes med knappbeskrivningstext. annars FALSE.

Anmärkningar

Ramverket anropar den här metoden när knappbeskrivningen för en verktygsfältsknapp är på väg att visas. Om OnUserToolTip returnerar TRUEvisar ramverket en knappbeskrivning som innehåller texten som returneras av OnUserToolTip i strTTText. Annars innehåller knappbeskrivningen knapptexten.

Åsidosätt OnUserToolTip för att anpassa verktygstips för verktygsfältsknappar. Standardimplementeringen anropar CMFCToolBar::OnUserToolTip för att hämta knappbeskrivningstexten.

`CMFCToolBar::PrevMenu`

virtual BOOL PrevMenu();

Returvärde

Anmärkningar

`CMFCToolBar::ProcessCommand`

Publicerar ett WM_COMMAND meddelande i fönstret som äger verktygsfältet.

BOOL ProcessCommand(CMFCToolBarButton* pButton);

Parametrar

pButton
[i] Pekare mot en knapp i verktygsfältet.

Returvärde

Den här metoden bör alltid returnera TRUE. MFC använder FALSE värden internt.

Anmärkningar

Den här metoden publicerar ett WM_COMMAND meddelande i fönstret som äger verktygsfältet genom att anropa CWnd::PostMessage och skicka kommando-ID:t för den angivna knappen som parametern wParam.

Använd makrot ON_COMMAND för att mappa WM_COMMAND-meddelandet till en medlemsfunktion.

`CMFCToolBar::RemoveAllButtons`

Tar bort alla knappar och avgränsare från verktygsfältet.

virtual void RemoveAllButtons();

Anmärkningar

Ramverket anropar den här metoden när den återskapar eller förstör ett verktygsfält.

`CMFCToolBar::RemoveButton`

Tar bort knappen som har det angivna indexet från verktygsfältet.

virtual BOOL RemoveButton(int iIndex);

Parametrar

iIndex
[i] Anger det nollbaserade indexet för knappen som ska tas bort.

Returvärde

TRUE om metoden lyckas eller FALSE om det angivna indexet är ogiltigt eller om indexet refererar till knappen Anpassa.

Anmärkningar

Den här metoden uppdaterar ytterligare verktygsfältsattribut som påverkas av att knappen tas bort. Den här metoden tar till exempel bort nonessential-avgränsare från verktygsfältet och återskapar tabellen med genvägsnycklar.

Mer information om knappen Anpassa finns i CMFCToolBar::EnableCustomizeButton.

`CMFCToolBar::RemoveStateFromRegistry`

Tar bort tillståndsinformationen för verktygsfältet från Windows-registret.

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

Parametrar

lpszProfileName
[i] Anger registernyckeln där tillståndsinformationen finns.

nIndex
[i] Verktygsfältets kontroll-ID.

uiID
[i] Verktygsfältets resurs-ID. Om den här parametern är -1 använder den här metoden metoden CWnd::GetDlgCtrlID för att hämta resurs-ID:t.

Returvärde

Nonzero om metoden lyckas; annars 0.

Anmärkningar

Ramverket anropar den här metoden när den tar bort ett användardefinierat verktygsfält.

Åsidosätt den här metoden om du lagrar ytterligare tillståndsinformation i Windows-registret.

`CMFCToolBar::ReplaceButton`

Ersätter en verktygsfältsknapp med en annan verktygsfältsknapp.

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

Parametrar

uiCmd
[i] Kommando-ID:t för knappen som ska ersättas.

button
[i] En referens till CMFCToolBarButton som ska infogas.

bAll
[i] Ett booleskt värde som anger om du vill ersätta alla knappar som har kommando-ID:t som anges av uiCmd. Om den här parametern är TRUEersätts alla knappar som har det angivna kommando-ID:t. Annars ersätts den första knappen.

Returvärde

Antalet knappar som ersätts. Den här metoden returnerar 0 om en knapp med det angivna kommando-ID:t inte finns i verktygsfältet.

Anmärkningar

Anropa den här metoden när du vill lägga till verktygsfältsknappar som inte kan läsas in från resurser. Du kan skapa en platshållarknapp vid designtillfället och ersätta den knappen med en anpassad knapp när du initierar verktygsfältet. Se VisualStudioDemo-exemplet för ett exempel som använder den här metoden.

Exempel

I följande exempel visas hur du använder metoden ReplaceButton i klassen CMFCToolBar. Det här kodfragmentet är en del av IE Demo-exempelexemplet.

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`

Återställer alla verktygsfält till sina ursprungliga tillstånd.

static void __stdcall ResetAll();

Anmärkningar

Den här metoden anropar metoden CMFCToolBar::RestoreOriginalState i varje verktygsfält i programmet som kan återställas. Den använder metoden CMFCToolBar::CanBeRestored för att avgöra om ett verktygsfält kan återställas.

`CMFCToolBar::ResetAllImages`

Rensar alla bildsamlingar i verktygsfältet i programmet.

static void __stdcall ResetAllImages();

Anmärkningar

Den här metoden rensar de bildsamlingar som initieras av metoderna CMFCToolBar::LoadToolBar och CMFCToolBar::LoadBitmap.

`CMFCToolBar::ResetImages`

virtual void ResetImages();

Anmärkningar

`CMFCToolBar::RestoreFocus`

virtual void RestoreFocus();

Anmärkningar

`CMFCToolBar::RestoreOriginalState`

Återställer det ursprungliga tillståndet för ett verktygsfält.

virtual BOOL RestoreOriginalState();

Returvärde

TRUE om metoden lyckas eller FALSE om metoden misslyckas eller om verktygsfältet är användardefinierat.

Anmärkningar

Den här metoden läser in verktygsfältet från resursfilen med hjälp av metoden CMFCToolBar::LoadToolBar.

Ramverket anropar den här metoden när användaren väljer knappen Återställ alla på verktygsfält sidan i en dialogruta för anpassning.

`CMFCToolBar::SaveParameters`

static BOOL __stdcall SaveParameters(LPCTSTR lpszProfileName = NULL);

Parametrar

[i] lpszProfileName

Returvärde

Anmärkningar

`CMFCToolBar::SaveState`

Sparar tillståndsinformationen för verktygsfältet i Windows-registret.

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

Parametrar

lpszProfileName
[i] Anger den relativa sökvägen för Windows-registernyckeln.

nIndex
[i] Verktygsfältets kontroll-ID.

uiID
[i] Verktygsfältets resurs-ID.

Returvärde

Nonzero om metoden lyckas; annars 0.

Anmärkningar

Ramverket anropar den här metoden när den sparar programtillståndet i registret. Mer information finns i CWinAppEx::SaveState.

`CMFCToolBar::SetBasicCommands`

Anger listan över kommandon som alltid visas när en användare öppnar en meny.

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

Parametrar

lstCommands
[i] En referens till ett CList objekt som innehåller en samling kommandon.

Anmärkningar

Ett grundläggande kommando visas alltid när menyn öppnas. Den här metoden är meningsfull när användaren väljer att visa nyligen använda kommandon.

Använd metoden CMFCToolBar::AddBasicCommand för att lägga till ett kommando i listan med grundläggande kommandon. Använd metoden CMFCToolBar::GetBasicCommands för att hämta listan över grundläggande kommandon som används av ditt program.

Se Explorer-exemplet för ett exempel som använder den här metoden.

`CMFCToolBar::SetButtonInfo`

Anger kommando-ID, formatmall och bild-ID för en verktygsfältsknapp.

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

Parametrar

nIndex
[i] Nollbaserat index för knappen vars egenskaper har angetts.

nID
[i] Knappens kommando-ID.

nStyle
[i] Knappens format. Se Verktygslistkontrollformat för listan över tillgängliga knappformat i verktygsfältet.

iImage
[i] Knappens nollbaserade bildindex (d.s. indexet i samlingen med verktygsfältsbilder).

Anmärkningar

Anropa den här metoden för att ange egenskaperna för en knapp i verktygsfältet.

I Felsökningsversioner genererar den här metoden ett kontrollfel om indexet som anges av nIndex är ogiltigt.

Anropa metoden CMFCToolBar::SetButtonStyle för att ange knappens formatmall.

`CMFCToolBar::SetButtons`

Anger knapparna för verktygsfältet.

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

Parametrar

lpIDArray
[i] En pekare till matrisen med kommando-ID:t för knapparna som ska infogas.

nIDCount
[i] Antalet objekt i lpIDArray.

bRemapImages
[i] Ett booleskt värde som anger om de befintliga knappbilderna ska associeras med de infogade knapparna. Om den här parametern är TRUEmappas bilderna om.

Returvärde

Nonzero om metoden lyckas; annars 0.

Anmärkningar

Anropa den här metoden för att ta bort befintliga knappar från ett verktygsfält och infoga en samling nya knappar.

Den här metoden lägger till knappen Anpassa i verktygsfältet och skickar meddelandet AFX_WM_RESETTOOLBAR till verktygsfältets överordnade fönster. Mer information om knappen Anpassa finns i CMFCToolBar::EnableCustomizeButton.

`CMFCToolBar::SetButtonStyle`

Anger formatmallen för verktygsfältsknappen vid det angivna indexet.

virtual void SetButtonStyle(
    int nIndex,
    UINT nStyle);

Parametrar

nIndex
[i] Det nollbaserade indexet för verktygsfältsknappen vars formatmall ska anges.

nStyle
[i] Knappens format. Se Verktygslistkontrollformat för listan över tillgängliga knappformat i verktygsfältet.

Anmärkningar

Den här metoden tar bort TBBS_PRESSED formatmallen om nStyle är TBBS_DISABLED eftersom användaren inte kan välja en inaktiverad knapp.

`CMFCToolBar::SetButtonText`

Anger textetiketten för en verktygsfältsknapp.

BOOL SetButtonText(
    int nIndex,
    LPCTSTR lpszText);

Parametrar

nIndex
[i] Indexet för verktygsfältsknappen.

lpszText
[i] Textetiketten för verktygsfältsknappen. Måste vara icke-null.

Returvärde

TRUE om metoden lyckas. annars FALSE.

Anmärkningar

Den här metoden returnerar FALSE om det angivna indexet inte refererar till en giltig verktygsfältsknapp.

`CMFCToolBar::SetCommandUsageOptions`

Anger när kommandon som sällan används inte visas i programmets meny.

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

Parametrar

nStartCount
[i] Anger antalet gånger som kommandon måste köras innan ramverket endast visar de grundläggande och nyligen använda kommandona.

nMinUsagePercentage
[i] Procentandelen gånger som ett kommando måste köras för att betraktas som ett nyligen använt kommando.

Returvärde

FALSE om nMinUsagePercentage är lika med eller större än 100. annars TRUE.

Anmärkningar

Anropa den här metoden för att anpassa algoritmen som ramverket använder för att avgöra hur grundläggande och nyligen använda menyalternativ visas. Mer information om grundläggande kommandon finns i CMFCToolBar::AddBasicCommand.

Den här klassen använder klassen CMFCCmdUsageCount för att spåra användningsantalet kommandon. Mer information om den här klassen finns i CMFCCmdUsageCount Class.

`CMFCToolBar::SetCustomizeMode`

Aktiverar eller inaktiverar anpassningsläge för alla verktygsfält i programmet.

static BOOL __stdcall SetCustomizeMode(BOOL bSet=TRUE);

Parametrar

bSet
[i] Ett booleskt värde som anger om anpassningsläget ska aktiveras eller inaktiveras. Ställ in den här parametern på TRUE för att aktivera anpassningsläge eller FALSE för att inaktivera den.

Returvärde

TRUE om anropet av den här metoden ändrar anpassningsläget. annars FALSE.

Anmärkningar

Den här metoden justerar layouten för och ritar om varje verktygsfält i programmet. Anropa metoden CMFCToolBar::IsCustomizeMode för att avgöra om programmet är i anpassningsläge.

`CMFCToolBar::SetGrayDisabledButtons`

Anger om knappar som inte är tillgängliga i verktygsfältet är nedtonade eller om knapptillgängliga bilder används.

void SetGrayDisabledButtons(BOOL bGrayDisabledButtons);

Parametrar

bGrayDisabledButtons
[i] Ett booleskt värde som anger hur du visar knappar som inte är tillgängliga. Om den här parametern är TRUEtonar ramverket ned knapparna. Annars använder ramverket samlingen av knapptillgängliga avbildningar.

Anmärkningar

Som standard är knappar som inte är tillgängliga nedtonade.

`CMFCToolBar::SetHeight`

Anger höjden på verktygsfältet.

void SetHeight(int cyHeight);

Parametrar

cyHeight
[i] Höjden på verktygsfältet, i bildpunkter.

Anmärkningar

Den här metoden ritar om verktygsfältet när det har konfigurerat höjden.

`CMFCToolBar::SetHelpMode`

static void __stdcall SetHelpMode(BOOL bOn = TRUE);

Parametrar

[i] bOn

Anmärkningar

`CMFCToolBar::SetHot`

BOOL SetHot(CMFCToolBarButton* pMenuButton);

Parametrar

[i] pMenuButton

Returvärde

Anmärkningar

`CMFCToolBar::SetHotBorder`

Anger om verktygsfältsknappar är snabbspårade.

void SetHotBorder(BOOL bShowHotBorder);

Parametrar

bShowHotBorder
[i] Ett booleskt värde som anger om knapparna i verktygsfältet ska spåras. Om den här parametern är TRUEspårar verktygsfältet knapparna. Annars kan verktygsfältet inte snabbspåra knapparna.

Anmärkningar

Om en knapp är snabbspårad markerar ramverket knappen när musen rör sig över den. Som standard spårar varje verktygsfält sina knappar.

Anropa metoden CMFCToolBar::GetHotBorder för att avgöra om verktygsfältet spårar knapparna.

`CMFCToolBar::SetHotTextColor`

Anger textfärgen för knappar i verktygsfältet.

static void SetHotTextColor(COLORREF clrText);

Parametrar

clrText
[i] Anger textfärgen för verktygsfältsknappar som är snabbspårade.

Anmärkningar

Mer information om snabbspårade verktygsfältsknappar finns i CMFCToolBar::GetHotBorder och CMFCToolBar::SetHotBorder.

`CMFCToolBar::SetIgnoreSetText`

void SetIgnoreSetText(BOOL bValue);

Parametrar

[i] bValue

Anmärkningar

`CMFCToolBar::SetLargeIcons`

Anger om verktygsfältsknappar visar stora ikoner.

static void SetLargeIcons(BOOL bLargeIcons=TRUE);

Parametrar

bLargeIcons
[i] Ett booleskt värde som anger vilka ikoner som ska användas. Om den här parametern är TRUEvisar ramverket stora ikoner. Annars visar ramverket vanliga ikoner.

Anmärkningar

Ramverket anropar den här metoden när användaren ändrar tillståndet för kryssrutan stora ikoner på fliken Alternativ i dialogrutan Anpassa. Den här metoden ändrar storlek på alla verktygsfält i programmet.

Som standard visar ramverket vanliga ikoner.

Mer information om dialogrutan Anpassa finns i CMFCToolBarsCustomizeDialog Class.

`CMFCToolBar::SetLockedSizes`

Anger storleken på låsta knappar och låsta bilder i verktygsfältet.

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

Parametrar

sizeButton
[i] Anger storleken på låsta verktygsfältsknappar.

sizeImage
[i] Anger storleken på låsta verktygsfältsbilder.

bDontScale
Anger om du vill skala eller inte låsa verktygsfältsbilder i hög DPI-läge.

Anmärkningar

Standardstorleken för låsta knappar är 23 x 22 bildpunkter. Standardstorleken för låsta bilder är 16 x 15 bildpunkter.

Anropa metoden CMFCToolBar::GetLockedImageSize för att hämta storleken på låsta bilder. Anropa metoden CMFCToolBar::GetButtonSize för att hämta storleken på låsta verktygsfältsknappar.

`CMFCToolBar::SetMaskMode`

void SetMaskMode(BOOL bMasked);

Parametrar

[i] bMasked

Anmärkningar

`CMFCToolBar::SetMenuSizes`

Anger storleken på menyknapparna i verktygsfältet och deras bilder.

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

Parametrar

sizeButton
[i] Anger storleken på verktygsfältsknappar i bildpunkter.

sizeImage
[i] Anger storleken på verktygsfältsbilder i bildpunkter.

Anmärkningar

Som standard har menyknappar och deras bilder en odefinierad storlek.

Anropa metoden CMFCToolBar::GetMenuButtonSize för att fastställa storleken på menyknapparna och metoden CMFCToolBar::GetMenuImageSize för att fastställa storleken på menyknappsbilderna.

Se exemplen IEDemo och MSMoneyDemo för exempel som använder den här metoden.

`CMFCToolBar::SetNonPermittedCommands`

Anger listan över kommandon som inte kan köras av användaren.

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

Parametrar

lstCommands
[i] En referens till ett CList objekt som innehåller kommandon som inte kan köras av användaren.

Anmärkningar

Anropa den här metoden för att förhindra att användaren väljer vissa kommandon. Du kanske till exempel vill förhindra att användaren väljer vissa kommandon av säkerhetsskäl. Se exemplen MDITabsDemo och MenuSubSet för exempel som använder den här metoden.

Den här metoden rensar den tidigare listan över icke-tillåtna kommandon. Som standard är listan över icke-tillåtna kommandon tom.

`CMFCToolBar::SetOneRowWithSibling`

Placerar verktygsfältet och dess syskon på samma rad.

void SetOneRowWithSibling();

Anmärkningar

Ramverket anropar den här metoden när användaren väljer knappen Visa knappar på en rad.

Anropa metoden CMFCToolBar::SetSiblingToolBar för att aktivera Visa knappar på en rad eller Visa knappar på två rader knappar. Om du anropar CMFCToolBar::SetSiblingToolBar för det här verktygsfältet flyttas samma verktygsfält till raden i det här verktygsfältet. Annars flyttas det här verktygsfältet till samma rad.

Ramverket anropar metoden CMFCToolBar::SetTwoRowsWithSibling när användaren väljer knappen Visa knappar på två rader.

`CMFCToolBar::SetOrigButtons`

void SetOrigButtons(const CObList& lstOrigButtons);

Parametrar

[i] lstOrigButtons

Anmärkningar

`CMFCToolBar::SetPermament`

Anger om en användare kan stänga verktygsfältet.

void SetPermament(BOOL bPermament=TRUE);

Parametrar

bPermament
[i] Ett booleskt värde som anger om en användare kan stänga verktygsfältet. Om den här parametern är TRUEkan en användare inte stänga verktygsfältet. Annars kan en användare stänga verktygsfältet.

Anmärkningar

Som standard kan en användare stänga varje verktygsfält.

Anropa metoden CMFCToolBar::CanBeClosed för att avgöra om en användare kan stänga verktygsfältet.

`CMFCToolBar::SetRouteCommandsViaFrame`

Anger om den överordnade ramen eller ägaren skickar kommandon till verktygsfältet.

void SetRouteCommandsViaFrame(BOOL bValue);

Parametrar

bValue
[i] Om den här parametern är TRUEskickar den överordnade ramen kommandon till verktygsfältet. Annars skickar ägaren kommandon till verktygsfältet.

Anmärkningar

Som standard skickar den överordnade ramen kommandon till verktygsfältet. Anropa metoden CMFCToolBar::GetRouteCommandsViaFrame för att avgöra om den överordnade ramen eller ägaren skickar kommandon till verktygsfältet.

`CMFCToolBar::SetShowTooltips`

Anger om ramverket visar verktygstips.

static void SetShowTooltips(BOOL bValue);

Parametrar

bValue
[i] Om den här parametern är TRUEvisar ramverket verktygstips. Annars döljer ramverket verktygstips.

Anmärkningar

Som standard visar ramverket verktygstips.

Anropa metoden CMFCToolBar::GetShowTooltips för att avgöra om ramverket visar verktygstips.

`CMFCToolBar::SetSiblingToolBar`

Anger på samma sätt som verktygsfältet.

void SetSiblingToolBar(CMFCToolBar* pBrotherToolbar);

Parametrar

pBrotherToolbar
[i] En pekare till verktygsfältet på samma nivå.

Anmärkningar

Den här metoden aktiverar Visa knappar på en rad eller Visa knappar på två rader knappar som visas när användaren visar popup-menyn Anpassa. Anropa den här metoden när du vill att användaren ska kunna ange om relaterade verktygsfält ska visas på samma rad eller på olika rader.

Anropa den här metoden när du har aktiverat knappen Anpassa som visas i verktygsfältet. Om du vill aktivera knappen Anpassa anropar du metoden CMFCToolBar::EnableCustomizeButton.

Om du vill hämta ett verktygsfälts syskon anropar du CMFCToolBar::GetSiblingToolBar.

`CMFCToolBar::SetSizes`

Anger storleken på knappar och bilder i alla verktygsfält.

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

Parametrar

sizeButton
[i] Storleken på verktygsfältsknappar i bildpunkter.

sizeImage
[i] Storleken på knappbilder i verktygsfältet, i bildpunkter.

Anmärkningar

Standardstorleken för verktygsfältsknappar är 23 x 22 bildpunkter. Standardstorleken för knappbilder i verktygsfältet är 16 x 15 bildpunkter.

Anropa metoden CMFCToolBar::GetImageSize för att hämta storleken på knappbilderna i verktygsfältet. Anropa metoden CMFCToolBar::GetButtonSize för att hämta storleken på verktygsfältsknapparna.

`CMFCToolBar::SetToolBarBtnText`

Anger egenskaper för en knapp i verktygsfältet.

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

Parametrar

nBtnIndex
[i] Det nollbaserade indexet för verktygsfältsknappen i listan med verktygsfältsknappar.

szText
[i] Anger textetiketten för verktygsfältsknappen.

bShowText
[i] Om den här parametern är TRUEvisar ramverket textetiketten. Annars döljer ramverket textetiketten.

bShowImage
[i] Om den här parametern är TRUEvisar ramverket knappbilden i verktygsfältet. Annars döljer ramverket knappbilden i verktygsfältet.

Anmärkningar

Som standard visar ramverket bilder av verktygsfältsknappar men visar inte textetiketten för verktygsfältsknappar.

I Felsökningsversioner genererar den här metoden ett kontrollfel om nBtnIndex inte refererar till en giltig verktygsfältsknapp eller om verktygsfältsknappen är en avgränsare.

`CMFCToolBar::SetTwoRowsWithSibling`

Placerar verktygsfältet och dess syskon på separata rader.

void SetTwoRowsWithSibling();

Anmärkningar

Ramverket anropar den här metoden när användaren väljer knappen Visa knappar på två rader.

Anropa metoden CMFCToolBar::SetSiblingToolBar för att aktivera Visa knappar på en rad eller Visa knappar på två rader knappar. Om du anropar CMFCToolBar::SetSiblingToolBar för det här verktygsfältet flyttas verktygsfältet på samma nivå till en separat rad. Annars flyttas verktygsfältet till en separat rad.

Ramverket anropar metoden CMFCToolBar::SetOneRowWithSibling när användaren väljer knappen Visa knappar på en rad.

`CMFCToolBar::SetUserImages`

Anger samlingen av användardefinierade bilder i programmet.

static BOOL SetUserImages(CMFCToolBarImages* pUserImages);

Parametrar

pUserImages
[i] En pekare till samlingen med användardefinierade bilder.

Returvärde

Nonzero om metoden lyckas; annars 0 om det angivna CMFCToolBarImages objektet inte är giltigt eller har en bildstorlek som skiljer sig från standardstorleken för bild i verktygsfältet.

Anmärkningar

Ramverket använder användardefinierade bilder för att rita verktygsfältsknappar som är anpassade av användaren. Bildlistan som anges av pUserImages delas mellan alla verktygsfält i programmet.

Den här metoden genererar ett kontrollfel i Felsökningsversioner om det angivna CMFCToolBarImages objektet inte är giltigt eller har en bildstorlek som skiljer sig från standardstorleken för bild i verktygsfältet.

Exemplen OutlookDemo, ToolTipDemo och VisualStudioDemo använder den här metoden för att ange den globala samlingen av användardefinierade bilder. De läser in filen med namnet UserImages.bmp, som finns i programmets arbetskatalog.

Anropa metoden CMFCToolBar::GetUserImages för att hämta samlingen med användardefinierade bilder i programmet.

`CMFCToolBar::StretchPane`

Sträcker ut verktygsfältet lodrätt eller vågrätt och flyttar knapparna om det behövs.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Parametrar

nLength
[i] Mängden, i bildpunkter, med vilken fönstret ska sträckas ut.

bVert
[i] Om TRUEsträcker du ut fönstret lodrätt. Om FALSEsträcker du ut fönstret vågrätt.

Returvärde

Ett CSize objekt som anger storleken på verktygsfältets klientområde.

Anmärkningar

Den här metoden anropar CMFCToolBar::WrapToolBar för att flytta knapparna i det utsträckta verktygsfältet.

Returvärdet bestäms genom att anropa CMFCToolBar::CalcSize.

`CMFCToolBar::TranslateChar`

Kör ett knappkommando om den angivna nyckelkoden motsvarar ett giltigt kortkommando.

virtual BOOL TranslateChar(UINT nChar);

Parametrar

nChar
[i] Anger en kod för virtuell nyckel. En lista över standardkoder för virtuella nycklar finns i Winuser.h

Returvärde

FALSE om den angivna nyckelkoden antingen inte kan skrivas ut eller inte motsvarar ett giltigt kortkommando. TRUE om den angivna nyckelkoden motsvarar ett menyalternativ i listrutan. annars returneras värdet från CMFCToolBar::ProcessCommand.

Anmärkningar

Ramverket anropar den här metoden när en nyckel trycks ihop med nyckeln Alt.

`CMFCToolBar::UpdateButton`

Uppdaterar tillståndet för den angivna knappen.

void UpdateButton(int nIndex);

Parametrar

nIndex
[i] Anger det nollbaserade indexet för knappen som ska uppdateras.

Anmärkningar

`CMFCToolBar::WrapToolBar`

Flyttar verktygsfältsknappar inom de angivna dimensionerna.

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

Parametrar

nWidth
[i] Verktygsfältets maximala bredd.

nHeight
[i] Maximal höjd för verktygsfältet. Används inte om verktygsfältet är flytande.

pDC
[i] Pekare mot en enhetskontext. Om NULLanvänds enhetskontexten för verktygsfältet.

nColumnWidth
[i] Knappbredd. Om -1 används den aktuella bredden.

[in] mnRowHeight Knapphöjd. Om -1 används den aktuella höjden.

Returvärde

Antalet rader med knappar i verktygsfältet.

Anmärkningar

Den här metoden flyttar knappar i verktygsfältet och omsluter knappar till ytterligare rader om det behövs.

`CMFCToolBar::m_bDontScaleImages`

Anger om verktygsfältsbilder ska skalas i högt DPI-läge eller inte. Ställ in på TRUE för att förhindra bildskalning när en bildstorlek inte matchar en knappstorlek.

AFX_IMPORT_DATA static BOOL m_bDontScaleImages;

Se även

hierarkidiagram
klasser
CMFCMenuBar klass
CMFCPopupMenuBar klass
CMFCDropDownToolBar klass
genomgång: Placera kontroller i verktygsfält

Dela via

CMFCToolBar-klass

Syntax

Medlemmar

Offentliga konstruktorer

Offentliga metoder

Skyddade metoder

Datamedlemmar

Anmärkningar

Exempel

Krav

Arvshierarki

CMFCToolBar::AddBasicCommand

Parametrar

Anmärkningar

CMFCToolBar::AddCommandUsage

Parametrar

Anmärkningar

CMFCToolBar::AddToolBarForImageCollection

Parametrar

Returvärde

Anmärkningar

CMFCToolBar::AdjustLayout

Anmärkningar

CMFCToolBar::AdjustSize

Anmärkningar

CMFCToolBar::AllowChangeTextLabels

Returvärde

Anmärkningar

CMFCToolBar::AllowShowOnList

Returvärde

Anmärkningar

CMFCToolBar::AreTextLabels

Returvärde

Anmärkningar

CMFCToolBar::AutoGrayInactiveImages

Parametrar

Anmärkningar

CMFCToolBar::ButtonToIndex

Parametrar

Returvärde

CMFCToolBar::CalcFixedLayout

Parametrar

Returvärde

Anmärkningar

CMFCToolBar::CalcMaxButtonHeight

Returvärde

Anmärkningar

CMFCToolBar::CalcSize

Parametrar

Returvärde

Anmärkningar

CMFCToolBar::CanBeClosed

Returvärde

Anmärkningar

CMFCToolBar::CanBeRestored

Returvärde

Anmärkningar

CMFCToolBar::CanFocus

Returvärde

Anmärkningar

CMFCToolBar::CanHandleSiblings

Returvärde

Anmärkningar

CMFCToolBar::CleanUpImages

Anmärkningar

CMFCToolBar::CleanUpLockedImages

Anmärkningar

CMFCToolBar::CommandToIndex

Parametrar

Returvärde

Anmärkningar

CMFCToolBar::Create

Parametrar

Returvärde

Anmärkningar

CMFCToolBar::CreateEx

Parametrar

Returvärde

Anmärkningar

`CMFCToolBar`-klass

`CMFCToolBar::AddBasicCommand`

`CMFCToolBar::AddCommandUsage`

`CMFCToolBar::AddToolBarForImageCollection`

`CMFCToolBar::AdjustLayout`

`CMFCToolBar::AdjustSize`

`CMFCToolBar::AllowChangeTextLabels`

`CMFCToolBar::AllowShowOnList`

`CMFCToolBar::AreTextLabels`

`CMFCToolBar::AutoGrayInactiveImages`

`CMFCToolBar::ButtonToIndex`

`CMFCToolBar::CalcFixedLayout`

`CMFCToolBar::CalcMaxButtonHeight`

`CMFCToolBar::CalcSize`

`CMFCToolBar::CanBeClosed`

`CMFCToolBar::CanBeRestored`

`CMFCToolBar::CanFocus`

`CMFCToolBar::CanHandleSiblings`

`CMFCToolBar::CleanUpImages`

`CMFCToolBar::CleanUpLockedImages`

`CMFCToolBar::CommandToIndex`

`CMFCToolBar::Create`

`CMFCToolBar::CreateEx`

`CMFCToolBar::Deactivate`

`CMFCToolBar::DoPaint`

`CMFCToolBar::DrawButton`

`CMFCToolBar::DrawSeparator`

`CMFCToolBar::EnableCustomizeButton`

`CMFCToolBar::EnableDocking`

`CMFCToolBar::EnableLargeIcons`

`CMFCToolBar::EnableQuickCustomization`

`CMFCToolBar::EnableReflections`

`CMFCToolBar::EnableTextLabels`

`CMFCToolBar::FromHandlePermanent`

`CMFCToolBar::GetAllButtons`

`CMFCToolBar::GetAllToolbars`

`CMFCToolBar::GetBasicCommands`

`CMFCToolBar::GetButton`

`CMFCToolBar::GetButtonInfo`

`CMFCToolBar::GetButtonSize`

`CMFCToolBar::GetButtonStyle`

`CMFCToolBar::GetButtonText`

`CMFCToolBar::GetColdImages`

`CMFCToolBar::GetColumnWidth`

`CMFCToolBar::GetCommandButtons`

`CMFCToolBar::GetCount`