`CMFCToolBar` osztály

Az CMFCToolBar osztály az osztályhoz hasonlóCToolBar, de további támogatást nyújt a felhasználói felület funkcióihoz. Ezek közé tartoznak a lapos eszköztárak, a gyakori képeket tartalmazó eszköztárak, a nagy ikonok, a lapozógombok, a zárolt eszköztárak, a sávvezérlők, a képek alatti szöveg, a háttérképek és a többlapos eszköztárak. Az CMFCToolBar osztály beépített támogatást is tartalmaz az eszköztárak és menük felhasználói testreszabásához, az eszköztárak és menük közötti húzással, a kombinált lista gombjaival, a beviteli gombok szerkesztésével, a színválasztókkal és a roll-up gombokkal.

További részletekért lásd a Visual Studio telepítésében található forráskódot, például %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Szemantika

class CMFCToolBar : public CMFCBaseToolBar

Tagok

Nyilvános konstruktorok

Név	Leírás
`CMFCToolBar::CMFCToolBar`	Alapértelmezett konstruktor.
`CMFCToolBar::~CMFCToolBar`	Destruktor.

Nyilvános metódusok

Név	Leírás
`CMFCToolBar::AddBasicCommand`	Hozzáad egy menüparancsot azon parancsok listájához, amelyek mindig megjelennek, amikor egy felhasználó megnyit egy menüt.
`CMFCToolBar::AddCommandUsage`	Az adott parancshoz társított számláló eggyel növekszik.
`CMFCToolBar::AddToolBarForImageCollection`	Képeket ad hozzá a felhasználói felület erőforrásaiból az alkalmazásban lévő képek gyűjteményéhez.
`CMFCToolBar::AdjustLayout`	Újraszámítja az eszköztár méretét és pozícióját. (Felülbírálások `CBasePane::AdjustLayout`).
`CMFCToolBar::AdjustSize`	Újraszámítja az eszköztár méretét.
`CMFCToolBar::AllowChangeTextLabels`	Megadja, hogy a szövegfeliratok megjeleníthetők-e a képek alatt az eszköztárgombokon.
`CMFCToolBar::AreTextLabels`	Megadja, hogy a képek alatti szövegfeliratok jelenleg megjelenjenek-e az eszköztárgombokon.
`CMFCToolBar::AutoGrayInactiveImages`	Az inaktív gombképek automatikus generálásának engedélyezése vagy letiltása.
`CMFCToolBar::ButtonToIndex`	Egy adott `CMFCToolBarButton` osztályobjektum indexét adja vissza ebben az eszköztárban.
`CMFCToolBar::CalcFixedLayout`	Kiszámítja az eszköztár vízszintes méretét. (Felülbírálások `CBasePane::CalcFixedLayout`.)
`CMFCToolBar::CalcSize`	A keretrendszer meghívta az elrendezés számítási folyamatának részeként. (Felülbírálások `CPane::CalcSize`.)
`CMFCToolBar::CanHandleSiblings`	Meghatározza, hogy az eszköztár és a testvére ugyanazon a panelen van-e elhelyezve.
`CMFCToolBar::CleanUpImages`	Felszabadítja az eszköztárképekhez lefoglalt rendszererőforrásokat.
`CMFCToolBar::CleanUpLockedImages`	Felszabadítja a zárolt eszköztárképekhez lefoglalt rendszererőforrásokat.
`CMFCToolBar::CanBeClosed`	Megadja, hogy egy felhasználó bezárhatja-e az eszköztárat. (Felülbírálások `CBasePane::CanBeClosed`.)
`CMFCToolBar::CanBeRestored`	Meghatározza, hogy a rendszer visszaállíthat-e egy eszköztárat az eredeti állapotára a testreszabás után.
`CMFCToolBar::CanFocus`	Megadja, hogy a panel kap-e fókuszt. (Felülbírálások `CBasePane::CanFocus`.)
`CMFCToolBar::CommandToIndex`	Az eszköztár gombjának indexét adja vissza egy megadott parancsazonosítóval.
`CMFCToolBar::Create`	Létrehoz egy `CMFCToolBar` objektumot.
`CMFCToolBar::CreateEx`	Létrehoz egy `CMFCToolBar` objektumot, amely további stílusbeállításokat, például nagyméretű ikonokat használ.
`CMFCToolBar::Deactivate`	Inaktiválja az eszköztárat.
`CMFCToolBar::EnableCustomizeButton`	Engedélyezi vagy letiltja az eszköztár végén megjelenő Gombok hozzáadása vagy eltávolítása gombot.
`CMFCToolBar::EnableDocking`	Engedélyezi a panel rögzítését a főkerethez. (Felülbírálások `CBasePane::EnableDocking`.)
`CMFCToolBar::EnableLargeIcons`	Engedélyezi vagy letiltja a nagyméretű ikonokat az eszköztárgombokon.
`CMFCToolBar::EnableQuickCustomization`	Engedélyezi vagy letiltja az eszköztárak gyors testreszabását, hogy a felhasználó lenyomhassa az Alt billentyűt, és egy gombot egy új helyre húzzon.
`CMFCToolBar::EnableReflections`	Engedélyezi vagy letiltja a parancsvisszaverést.
`CMFCToolBar::EnableTextLabels`	Engedélyezi vagy letiltja a szövegfeliratokat az eszköztár gombképei alatt.
`CMFCToolBar::FromHandlePermanent`	Az adott ablakfogópontot tartalmazó objektumra mutató mutatót `CMFCToolBar` kér le.
`CMFCToolBar::GetAllButtons`	Az eszköztár gombjainak írásvédett listáját adja vissza.
`CMFCToolBar::GetAllToolbars`	Az alkalmazás összes eszköztárának írásvédett listáját adja vissza.
`CMFCToolBar::GetBasicCommands`	Az alkalmazásban definiált alapvető parancsok írásvédett listáját adja vissza.
`CMFCToolBar::GetButton`	A megadott eszköztárgomb-indexet tartalmazó objektumra mutató mutatót `CMFCToolBarButton` ad vissza.
`CMFCToolBar::GetButtonInfo`	Egy adott index gombjának parancsazonosítóját, stílusát és képindexét adja vissza.
`CMFCToolBar::GetButtonSize`	Az eszköztár egyes gombjainak méreteit adja vissza.
`CMFCToolBar::GetButtonStyle`	A megadott indexen található eszköztárgomb aktuális stílusát adja vissza.
`CMFCToolBar::GetButtonText`	Egy adott indexet tartalmazó gomb szöveges címkéjét adja vissza.
`CMFCToolBar::GetColdImages`	Egy mutatót ad vissza a hideg eszköztár gombképeinek gyűjteményéhez az alkalmazásban.
`CMFCToolBar::GetColumnWidth`	Az eszköztárgombok szélességét adja vissza.
`CMFCToolBar::GetCommandButtons`	Visszaadja azoknak a gomboknak a listáját, amelyek adott parancsazonosítóval rendelkeznek az alkalmazás összes eszköztárából.
`CMFCToolBar::GetCount`	Az eszköztár gombjainak és elválasztó elemeinek számát adja vissza.
`CMFCToolBar::GetCustomizeButton`	Az eszköztárhoz társított objektumra mutató mutatót `CMFCCustomizeButton` kér le.
`CMFCToolBar::GetDefaultImage`	A megadott parancsazonosítóval rendelkező eszköztárgomb alapértelmezett képének indexét adja vissza.
`CMFCToolBar::GetDisabledImages`	Az alkalmazás letiltott eszköztárgombjaihoz használt képek gyűjteményére mutató mutatót ad vissza.
`CMFCToolBar::GetDisabledMenuImages`	Az alkalmazás letiltott menügombjaihoz használt képek gyűjteményére mutató mutatót ad vissza.
`CMFCToolBar::GetDroppedDownMenu`	Lekéri a menügomb objektumára mutató mutatót, amely jelenleg az almenüjét jeleníti meg.
`CMFCToolBar::GetGrayDisabledButtons`	Megadja, hogy a letiltott gombok képei a normál gombképek halványított verziói-e, vagy a letiltott gombképek gyűjteményéből származnak-e.
`CMFCToolBar::GetHighlightedButton`	Az aktuálisan kiemelt eszköztár gombjára mutató mutatót ad vissza.
`CMFCToolBar::GetHotBorder`	Meghatározza, hogy az eszköztárgombok gyakori követésűek-e.
`CMFCToolBar::GetHotTextColor`	A kiemelt eszköztárgombok szövegszínét adja vissza.
`CMFCToolBar::GetHwndLastFocus`	Egy fogópontot ad vissza arra az ablakra, amelyen a bemeneti fókusz éppen az eszköztár előtt volt.
`CMFCToolBar::GetIgnoreSetText`	Megadja, hogy a rendszer figyelmen kívül hagyja-e a gombfeliratok beállítására irányuló hívásokat.
`CMFCToolBar::GetImageSize`	Az eszköztár gombképeinek aktuális méretét adja vissza.
`CMFCToolBar::GetImages`	Az alkalmazás alapértelmezett gombképeinek gyűjteményére mutató mutatót ad vissza.
`CMFCToolBar::GetImagesOffset`	Azt az indexeltolást adja vissza, amellyel az eszköztár eszköztárgomb-lemezképeit megtalálhatja az eszköztár gombképeinek globális listájában.
`CMFCToolBar::GetInvalidateItemRect`	Lekéri az ügyfélterület azon régióját, amelyet újra kell helyezni a gombhoz az adott indexen.
`CMFCToolBar::GetItemID`	Egy adott index eszköztár gombjának parancsazonosítóját adja vissza.
`CMFCToolBar::GetItemRect`	A gomb határoló téglalapját adja vissza egy adott indexen.
`CMFCToolBar::GetLargeColdImages`	Egy mutatót ad vissza az alkalmazás nagyméretű, hideg eszköztár gombképeinek gyűjteményéhez.
`CMFCToolBar::GetLargeDisabledImages`	Egy mutatót ad vissza az alkalmazás nagyméretű letiltott eszköztárképeinek gyűjteményéhez.
`CMFCToolBar::GetLargeImages`	Egy mutatót ad vissza az alkalmazás nagyméretű eszköztár-gombképeinek gyűjteményéhez.
`CMFCToolBar::GetLockedColdImages`	Egy mutatót ad vissza az eszköztár zárolt hideg lemezképeinek gyűjteményéhez.
`CMFCToolBar::GetLockedDisabledImages`	Egy mutatót ad vissza az eszköztár zárolt letiltott lemezképeinek gyűjteményéhez.
`CMFCToolBar::GetLockedImages`	Az eszköztár zárolt gombképeinek gyűjteményére mutató mutatót ad vissza.
`CMFCToolBar::GetLockedImageSize`	A zárolt eszköztárképek alapértelmezett méretét adja vissza.
`CMFCToolBar::GetLockedMenuImages`	Egy mutatót ad vissza az eszköztár zárolt eszköztár-menüképeinek gyűjteményéhez.
`CMFCToolBar::GetMenuButtonSize`	Az alkalmazás menügombjainak méretét adja vissza.
`CMFCToolBar::GetMenuImageSize`	Az alkalmazásban lévő menügomb-képek méretét adja vissza.
`CMFCToolBar::GetMenuImages`	Egy mutatót ad vissza az alkalmazásban található menügombképek gyűjteményéhez.
`CMFCToolBar::GetOrigButtons`	Lekéri az eszköztár nem testre szabott gombjainak gyűjteményét.
`CMFCToolBar::GetOrigResetButtons`	Lekéri az eszköztár nem testre szabott alaphelyzetbe állítási gombjainak gyűjteményét.
`CMFCToolBar::GetResourceID`	Lekéri az eszköztár erőforrás-azonosítóját.
`CMFCToolBar::GetRouteCommandsViaFrame`	Meghatározza, hogy melyik objektum, a szülőkeret vagy a tulajdonos küld parancsokat az eszköztárnak.
`CMFCToolBar::GetRowHeight`	Az eszköztárgombok magasságát adja vissza.
`CMFCToolBar::GetShowTooltips`	Megadja, hogy az eszköztárgombok eszköztippjei megjelenjenek-e.
`CMFCToolBar::GetSiblingToolBar`	Lekéri az eszköztár testvérét.
`CMFCToolBar::GetUserImages`	Egy mutatót ad vissza a felhasználó által definiált eszköztár gombképeinek gyűjteményéhez az alkalmazásban.
`CMFCToolBar::HitTest`	A megadott helyen található eszköztárgomb indexét adja vissza.
`CMFCToolBar::InsertButton`	Beszúr egy gombot az eszköztárba.
`CMFCToolBar::InsertSeparator`	Elválasztó beszúrása az eszköztárba.
`CMFCToolBar::InvalidateButton`	Érvényteleníti a megadott indexen található eszköztárgomb ügyfélterületét.
`CMFCToolBar::IsAddRemoveQuickCustomize`	Meghatározza, hogy a felhasználó hozzáadhat vagy eltávolíthat-e eszköztárgombokat a Testreszabás menü beállítással.
`CMFCToolBar::IsAltCustomizeMode`	Megadja, hogy a gyors testreszabást használja-e egy gomb húzásához.
`CMFCToolBar::IsAutoGrayInactiveImages`	Megadja, hogy engedélyezve van-e az inaktív (nem kiemelt) gombképek automatikus létrehozása.
`CMFCToolBar::IsBasicCommand`	Meghatározza, hogy egy parancs szerepel-e az alapszintű parancsok listájában.
`CMFCToolBar::IsButtonExtraSizeAvailable`	Meghatározza, hogy az eszköztár megjeleníthet-e kiterjesztett szegélyű gombokat.
`CMFCToolBar::IsButtonHighlighted`	Meghatározza, hogy az eszköztár egyik gombja ki van-e emelve.
`CMFCToolBar::IsCommandPermitted`	Meghatározza, hogy engedélyezett-e egy parancs.
`CMFCToolBar::IsCommandRarelyUsed`	Meghatározza, hogy ritkán használ-e parancsot (lásd `CMFCToolBar::SetCommandUsageOptions`).
`CMFCToolBar::IsCustomizeMode`	Megadja, hogy az eszköztár-keretrendszer testreszabási módban van-e.
`CMFCToolBar::IsDragButton`	Meghatározza, hogy az eszköztár gombja húzva van-e.
`CMFCToolBar::IsExistCustomizeButton`	Meghatározza, hogy az eszköztár tartalmazza-e a Testreszabás gombot.
`CMFCToolBar::IsFloating`	Meghatározza, hogy az eszköztár lebegő-e.
`CMFCToolBar::IsLargeIcons`	Megadja, hogy az alkalmazás eszköztárai jelenleg nagy ikonokat jelenjenek-e meg.
`CMFCToolBar::IsLastCommandFromButton`	Meghatározza, hogy a legutóbb végrehajtott parancs a megadott eszköztárgombból lett-e elküldve.
`CMFCToolBar::IsLocked`	Meghatározza, hogy az eszköztár zárolva van-e.
`CMFCToolBar::IsOneRowWithSibling`	Meghatározza, hogy az eszköztár és a testvérpult ugyanabban a sorban van-e elhelyezve.
`CMFCToolBar::IsUserDefined`	Megadja, hogy az eszköztár felhasználó által definiált-e.
`CMFCToolBar::LoadBitmap`	Betölti az eszköztárrendszerképeket az alkalmazáserőforrásokból.
`CMFCToolBar::LoadBitmapEx`	Betölti az eszköztárrendszerképeket az alkalmazáserőforrásokból. Nagy méretű képeket tartalmaz.
`CMFCToolBar::LoadParameters`	Betölti a globális eszköztár beállításait a Windows beállításjegyzékéből.
`CMFCToolBar::LoadState`	Betölti az eszköztár állapotadatait a Windows beállításjegyzékéből. (Felülbírálások `CPane::LoadState`.)
`CMFCToolBar::LoadToolBar`	Betölti az eszköztárat az alkalmazáserőforrásokból.
`CMFCToolBar::LoadToolBarEx`	Betölti az eszköztárat az alkalmazás erőforrásaiból a `CMFCToolBarInfo` segédosztály használatával, hogy az alkalmazás nagy méretű képeket használhasson.
`CMFCToolBar::OnChangeHot`	A keretrendszer meghívja, amikor egy felhasználó kiválaszt egy gombot az eszköztáron.
`CMFCToolBar::OnFillBackground`	A keretrendszer `CBasePane::DoPaint` meghívta, hogy kitöltse az eszköztár hátterét.
`CMFCToolBar::OnReset`	Visszaállítja az eszköztárat az eredeti állapotára.
`CMFCToolBar::OnSetAccData`	(Felülbírálások `CBasePane::OnSetAccData`.)
`CMFCToolBar::OnSetDefaultButtonText`	Visszaállítja egy eszköztárgomb szövegét az alapértelmezett állapotba.
`CMFCToolBar::OnUpdateCmdUI`	Belsőleg használva.
`CMFCToolBar::RemoveAllButtons`	Eltávolítja az összes gombot az eszköztárról.
`CMFCToolBar::RemoveButton`	Eltávolítja az eszköztárról a megadott indexet tartalmazó gombot.
`CMFCToolBar::RemoveStateFromRegistry`	Törli az eszköztár állapotadatait a Windows beállításjegyzékéből.
`CMFCToolBar::ReplaceButton`	Az eszköztárgombot egy másik eszköztárgombra cseréli.
`CMFCToolBar::ResetAll`	Visszaállítja az összes eszköztárat az eredeti állapotára.
`CMFCToolBar::ResetAllImages`	Törli az alkalmazás összes eszköztárképgyűjteményét.
`CMFCToolBar::RestoreOriginalState`	Visszaállítja az eszköztár eredeti állapotát.
`CMFCToolBar::SaveState`	Menti az eszköztár állapotadatait a Windows beállításjegyzékében. (Felülbírálások `CPane::SaveState`.)
`CMFCToolBar::Serialize`	(Felülbírálások `CBasePane::Serialize`.)
`CMFCToolBar::SetBasicCommands`	Beállítja azoknak a parancsoknak a listáját, amelyek mindig megjelennek, amikor egy felhasználó megnyitja a menüt.
`CMFCToolBar::SetButtonInfo`	Beállítja egy eszköztárgomb parancsazonosítóját, stílusát és képazonosítóját.
`CMFCToolBar::SetButtonStyle`	Beállítja az eszköztár gomb stílusát az adott indexen.
`CMFCToolBar::SetButtonText`	Beállítja egy eszköztárgomb szövegfeliratát.
`CMFCToolBar::SetButtons`	Beállítja az eszköztár gombjait.
`CMFCToolBar::SetCommandUsageOptions`	Azt adja meg, hogy a ritkán használt parancsok mikor nem jelennek meg az alkalmazás menüjében.
`CMFCToolBar::SetCustomizeMode`	Engedélyezi vagy letiltja a testreszabási módot az alkalmazás összes eszköztárán.
`CMFCToolBar::SetGrayDisabledButtons`	Megadja, hogy az eszköztár letiltott gombjai halványak-e, vagy letiltott képeket használnak-e a letiltott gombokhoz.
`CMFCToolBar::SetHeight`	Beállítja az eszköztár magasságát.
`CMFCToolBar::SetHotBorder`	Azt határozza meg, hogy az eszköztárgombok gyakori követésűek-e.
`CMFCToolBar::SetHotTextColor`	A gyakori eszköztárgombok szövegszínét állítja be.
`CMFCToolBar::SetLargeIcons`	Megadja, hogy az eszköztárgombok nagy ikonokat jelenjenek-e meg.
`CMFCToolBar::SetLockedSizes`	Beállítja a zárolt gombok és a zárolt képek méretét az eszköztáron.
`CMFCToolBar::SetMenuSizes`	Beállítja az eszköztár menügombjainak és képeinek méretét.
`CMFCToolBar::SetNonPermittedCommands`	Beállítja azoknak a parancsoknak a listáját, amelyeket a felhasználó nem hajthat végre.
`CMFCToolBar::SetOneRowWithSibling`	Az eszköztár és a testvére ugyanabban a sorban van elhelyezve.
`CMFCToolBar::SetPermament`	Megadja, hogy egy felhasználó bezárhatja-e az eszköztárat.
`CMFCToolBar::SetRouteCommandsViaFrame`	Megadja, hogy a szülőkeret vagy a tulajdonos parancsokat küld-e az eszköztárnak.
`CMFCToolBar::SetShowTooltips`	Megadja, hogy a keretrendszer megjelenít-e eszköztippeket.
`CMFCToolBar::SetSiblingToolBar`	Az eszköztár testvérét adja meg.
`CMFCToolBar::SetSizes`	A gombok és képek méretét határozza meg az összes eszköztáron.
`CMFCToolBar::SetToolBarBtnText`	Egy gomb tulajdonságait adja meg az eszköztáron.
`CMFCToolBar::SetTwoRowsWithSibling`	Az eszköztárat és annak testvérét külön sorokra osztva pozja.
`CMFCToolBar::SetUserImages`	Beállítja a felhasználó által definiált képek gyűjteményét az alkalmazásban.
`CMFCToolBar::StretchPane`	Függőlegesen vagy vízszintesen nyújtja az eszköztárat. (Felülbírálások `CBasePane::StretchPane`.)
`CMFCToolBar::TranslateChar`	Gombparancsot hajt végre, ha a megadott kulcskód érvényes billentyűparancsnak felel meg.
`CMFCToolBar::UpdateButton`	Frissíti a megadott gomb állapotát.
`CMFCToolBar::WrapToolBar`	Áthelyezi az eszköztárgombokat a megadott dimenziókban.

Védett metódusok

Név	Leírás
`CMFCToolBar::AllowShowOnList`	Meghatározza, hogy az eszköztár megjelenik-e a Testreszabás párbeszédpanel Eszköztárak paneljének listájában.
`CMFCToolBar::CalcMaxButtonHeight`	Kiszámítja egy gomb maximális magasságát az eszköztáron.
`CMFCToolBar::DoPaint`	Egy eszköztár újrarajzlása.
`CMFCToolBar::DrawButton`	Eszköztárgomb újrarajzolója.
`CMFCToolBar::DrawSeparator`	Újrafest egy elválasztót egy eszköztáron.
`CMFCToolBar::OnUserToolTip`	A keretrendszer meghívja, amikor megjelenik egy gomb elemleírása.

Adattagok

Név	Leírás
`CMFCToolBar::m_bDontScaleImages`	Meghatározza, hogy nagy DPI-módban skálázza-e vagy sem az eszköztárképeket.
`CMFCToolBar::m_dblLargeImageRatio`	Megadja a nagyméretű képek mérete (magassága vagy szélessége) és a normál képek mérete közötti arányt.

Megjegyzések

Ha objektumot CMFCToolBar szeretne beépíteni az alkalmazásba, kövesse az alábbi lépéseket:

CMFCToolBar Objektum hozzáadása a fő keretablakhoz.
Amikor feldolgozza a fő keretablak WM_CREATE üzenetét, hívja meg vagy CMFCToolBar::CreateCMFCToolBar::CreateEx hozza létre az eszköztárat, és adja meg annak stílusát.
Hívás CBasePane::EnableDocking a rögzítési stílus megadásához.

Speciális gomb( például kombinált lista vagy legördülő eszköztár) beszúrásához foglaljon le egy próbagombot a szülőerőforrásban, és cserélje le a próbabábu gombot futásidőben a használatával CMFCToolBar::ReplaceButton. További információ: Útmutató: Vezérlők elhelyezése eszköztárakon.

CMFCToolBaraz MFC-kódtár osztályánakCMFCMenuBar, CMFCPopupMenuBar osztályának és CMFCDropDownToolBar osztályának alaposztálya.

példa

Az alábbi példa bemutatja, hogyan használhat különböző metódusokat a CMFCToolBar osztályban. A példa bemutatja, hogyan állíthatja be az eszköztár ablakfeliratának szövegét, hogyan állíthatja be a szegélyeket, hogyan állíthatja be a panel stílusát, és hogyan engedélyezheti az eszköztár végén megjelenő Gombok hozzáadása vagy eltávolítása gombot. Ez a kódrészlet a IE Demo mintarésze.

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

Követelmények

fejléc:afxtoolbar.h

Öröklési hierarchia

CMFCToolBar

`CMFCToolBar::AddBasicCommand`

Hozzáad egy menüparancsot azon parancsok listájához, amelyek mindig megjelennek, amikor egy felhasználó megnyit egy menüt.

static void __stdcall AddBasicCommand(UINT uiCmd);

Paraméterek

uiCmd
[in] Megadja a hozzáadni kívánt parancsot.

Megjegyzések

A menü megnyitásakor mindig megjelenik egy egyszerű parancs. Ez a módszer akkor hasznos, ha a felhasználó úgy dönt, hogy megtekinti a legutóbb használt parancsokat.

Ezzel a CMFCToolBar::SetBasicCommands módszerrel állíthatja be azoknak a parancsoknak a listáját, amelyek mindig megjelennek, amikor egy felhasználó megnyitja a menüt. Ezzel a CMFCToolBar::GetBasicCommands módszerrel lekérheti az alkalmazás által használt alapvető parancsok listáját.

`CMFCToolBar::AddCommandUsage`

Az adott parancshoz társított számláló eggyel növekszik.

static void __stdcall AddCommandUsage(UINT uiCommand);

Paraméterek

uiCommand
[in] A növekményes parancsszámlálót adja meg.

Megjegyzések

A keretrendszer meghívja ezt a metódust, amikor a felhasználó kiválaszt egy menüelemet.

A keretrendszer parancsszámlálókkal jeleníti meg a legutóbb használt menüelemeket.

Ez a metódus a metódus használatával növeli a parancsszámlálót CMFCCmdUsageCount::AddCmd .

`CMFCToolBar::AddToolBarForImageCollection`

Képeket ad hozzá a felhasználói felület erőforrásaiból az alkalmazásban lévő képek gyűjteményéhez.

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

Paraméterek

uiResID
[in] Egy betöltendő képekkel rendelkező eszköztár erőforrás-azonosítója.

uiBmpResID
[in] Egy bitkép erőforrás-azonosítója eszköztárképekkel.

uiColdResID
[in] Bitkép erőforrás-azonosítója "hideg" eszköztárképekkel.

uiMenuResID
[in] Egy bitkép erőforrás-azonosítója menürendszerképekkel.

uiDisabledResID
[in] Egy bitkép erőforrás-azonosítója letiltott eszköztárképekkel.

uiMenuDisabledResID
[in] Egy bitkép erőforrás-azonosítója letiltott menüképekkel.

Visszaadott érték

TRUEha a módszer sikeres; FALSEuiResID ha uiBmpResID nem ad meg érvényes erőforrásokat, vagy egy másik hiba történik.

Megjegyzések

Ennek a metódusnak a meghívásával betölthet egy bitképet eszköztárképekkel, és hozzáadhatja azt az eszköztárképek gyűjteményéhez. Ez a metódus létrehoz egy ideiglenes eszköztárobjektumot, és meghívja azokat CMFCToolBar::LoadToolBar.

`CMFCToolBar::AdjustLayout`

Újraszámítja az eszköztár méretét és pozícióját.

virtual void AdjustLayout();

Megjegyzések

Ezt a metódust akkor hívhatja meg, ha az eszköztár létrejött a méretének és pozíciójának újraszámításához.

A keretrendszer minden alkalommal meghívja ezt a metódust, amikor módosítani kell az eszköztár elrendezését. Az elrendezésnek például meg kell változnia, amikor a felhasználó áthelyez egy másik vezérlősávot, átméretez egy alkalmazásablakot, vagy testre szabja az eszköztárat.

Bírálja felül ezt a metódust, hogy saját dinamikus elrendezést biztosítson azokban az osztályokban, amelyekből CMFCToolbarszármazik.

`CMFCToolBar::AdjustSize`

Újraszámítja az eszköztár méretét.

void AdjustSize();

Megjegyzések

Ez a módszer biztosítja, hogy az eszköztár illeszkedjen a szülőkeret határaiba. Ez a módszer nem tesz semmit, ha az eszköztár nem tartalmaz szülőkeretet.

A CMFCToolBar::AdjustLayout metódus meghívja ezt a metódust a méret újraszámítására, ha az eszköztár szülője nem CMFCReBar objektum.

`CMFCToolBar::AllowChangeTextLabels`

Megadja, hogy a szövegfeliratok megjeleníthetők-e a képek alatt az eszköztárgombokon.

virtual BOOL AllowChangeTextLabels() const;

Visszaadott érték

TRUE ha a képek alatt szövegfeliratok jeleníthetők meg; egyéb esetben FALSE.

Megjegyzések

Ezt a módszert a testreszabási párbeszédpanel hívja meg annak megállapításához, hogy engedélyezi-e a szövegfeliratok megjelenítése jelölőnégyzetet a kijelölt eszköztár Eszköztárak lapján.

Az alapértelmezett implementáció ad TRUEvissza.

Felülbírálja ezt a metódust egy olyan objektumban, amelyből származik CMFCToolBar , és visszaadja FALSE azt, ha nem szeretné, hogy a felhasználó eldöntse, hogy a képek alatti eszköztárgombokon megjelennek-e szövegfeliratok.

`CMFCToolBar::AllowShowOnList`

Meghatározza, hogy az eszköztár megjelenik-e a Testreszabás párbeszédpanel Eszköztárak panelén lévő eszköztárak listájában.

virtual BOOL AllowShowOnList() const;

Visszaadott érték

TRUE ha az eszköztár-objektum megjeleníthető az eszköztár testreszabási oldalán lévő listamezőben; egyéb esetben FALSE.

Megjegyzések

Ezt a metódust a keretrendszer hívja meg annak meghatározásához, hogy az eszköztár testreszabási lapján található lista tartalmaz-e egy adott objektumot, amelyből CMFCToolBarszármazik.

Az alapértelmezett implementáció mindig ad vissza TRUE. Bírálja felül ezt a módszert, ha nem szeretné, hogy egy eszköztár megjelenjen a testreszabási párbeszédpanel eszköztárainak listájában.

`CMFCToolBar::AreTextLabels`

Megadja, hogy a képek alatti szövegfeliratok jelenleg megjelenjenek-e az eszköztárgombokon.

BOOL AreTextLabels() const;

Visszaadott érték

TRUE ha az eszköztárgombok szövegfeliratokat jelenítenek meg a képek alatt; egyéb esetben FALSE.

Megjegyzések

Itt CMFCToolBar::EnableTextLabels adhatja meg, hogy megjelenik-e a szöveg. Az alapértelmezett érték a FALSE. Hívás CMFCToolBar::AllowChangeTextLabels annak megadásához, hogy a felhasználó módosíthatja-e ezt a beállítást a testreszabási párbeszédpanelen.

`CMFCToolBar::AutoGrayInactiveImages`

Az inaktív gombképek automatikus generálásának engedélyezése vagy letiltása.

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

Paraméterek

bEnable
[in] Logikai érték, amely meghatározza, hogy az inaktív képek elhalványuljanak-e. Ha ez a paraméter, az TRUEinaktív képek halványak lesznek. Ellenkező esetben az inaktív képek nem halványulnak.

nGrayImagePercentage
[in] Az inaktív képek fényerejének százalékos értékét adja meg. Ha bEnable igen FALSE, a rendszer figyelmen kívül hagyja ezt az értéket.

bRedrawAllToolbars
[in] Logikai érték, amely meghatározza, hogy az alkalmazás összes eszköztárát újra szeretné-e újrarajzolva. Ha ez a paraméter, TRUEez a metódus újrarajzolva az összes eszköztárat.

Megjegyzések

Ha bEnable igen TRUE, a keretrendszer inaktív képeket hoz nGrayImagePercentage létre a normál rendszerképekből. Ellenkező esetben a metódus használatával meg kell adnia az inaktív képek készletét CMFCToolBar::GetColdImages . Alapértelmezés szerint ez a beállítás le van tiltva.

További információ a nGrayImagePercentage paraméterről: CMFCToolBarImages::GrayImages.

`CMFCToolBar::ButtonToIndex`

Egy adott CMFCToolBarButton osztályobjektum indexét adja vissza ebben az eszköztárban.

int ButtonToIndex(const CMFCToolBarButton* pButton) const;

Paraméterek

pButton
[in] Az eszköztár gombobjektumára mutató mutató.

Visszaadott érték

Az eszköztárgombok belső listájának indexe pButton ; vagy -1, ha a megadott gomb nincs ezen az eszköztáron.

`CMFCToolBar::CalcFixedLayout`

Kiszámítja az eszköztár vízszintes méretét.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Paraméterek

bStretch
[in] TRUE az eszköztár a szülőkeret méretére való húzásához.

bHorz
[in] TRUE az eszköztár vízszintes tájlásához; FALSE az eszköztár függőleges tájlásához.

Visszaadott érték

Az CSize eszköztár méretét meghatározó objektum.

Megjegyzések

Ez a metódus kiszámítja az eszköztár méretét a CMFCToolBar::CalcLayout metódus használatával. Átmegy a LM_STRETCH paraméter jelölője dwMode , ha bStretch az TRUE. Átmegy a jelzőn LM_HORZ , ha bHorz igen TRUE.

Tekintse meg a VisualStudioDemo mintát egy, a metódust használó példában.

`CMFCToolBar::CalcMaxButtonHeight`

Kiszámítja az eszköztár gombjainak maximális magasságát.

virtual int CalcMaxButtonHeight();

Visszaadott érték

A gombok maximális magassága.

Megjegyzések

Ez a módszer kiszámítja az eszköztár összes eszköztárgombjának maximális magasságát. A magasság az olyan tényezőktől függően változhat, mint például az eszköztár aktuális dokkolásának állapota.

Felülbírálhatja ezt a metódust egy olyan osztályban, amelyből származik CMFCToolBar , hogy saját magasságszámítást biztosítson.

`CMFCToolBar::CalcSize`

A keretrendszer meghívta az elrendezés számítási folyamatának részeként.

virtual CSize CalcSize(BOOL bVertDock);

Paraméterek

bVertDock
[in] TRUE annak megadásához, hogy az eszköztár függőlegesen legyen rögzítve; FALSE az eszköztár vízszintes rögzítésének megadásához.

Visszaadott érték

Az CSize eszköztár gombjainak általános méretét meghatározó objektum.

Megjegyzések

Ez a módszer figyelembe veszi az egyes gombok méretét befolyásoló attribútumokat, például a szövegcímke területét és a szegély méretét.

Ha az eszköztár nem tartalmaz gombokat, ez a metódus egyetlen gomb fenntartott méretét adja vissza a CMFCToolBar::GetButtonSize metódus használatával.

`CMFCToolBar::CanBeClosed`

Megadja, hogy egy felhasználó bezárhatja-e az eszköztárat.

virtual BOOL CanBeClosed() const;

Visszaadott érték

TRUE ha az eszköztárat a felhasználó bezárhatja; egyéb esetben FALSE.

Megjegyzések

A keretrendszer meghívja ezt a metódust annak meghatározására, hogy a felhasználó bezárhat-e egy eszköztárat. Ha a metódus visszatér TRUE, a keretrendszer engedélyezi a SC_CLOSE parancsot az eszköztár rendszermenüjében, és a felhasználó bezárhatja az eszköztárat a testreszabási párbeszédpanel eszköztárainak listájában található jelölőnégyzet bejelölésével.

Az alapértelmezett implementáció ad TRUEvissza. Felülbírálja ezt a metódust egy olyan osztályban, amelyből olyan CMFCToolBar eszköztárobjektumokat hozhat létre, amelyeket a felhasználó nem zárhat be.

`CMFCToolBar::CanBeRestored`

Meghatározza, hogy a rendszer visszaállíthat-e egy eszköztárat az eredeti állapotára a testreszabás után.

virtual BOOL CanBeRestored() const;

Visszaadott érték

TRUE ha az eszköztár visszaállítható az alkalmazás erőforrásaiból; egyéb esetben FALSE.

Megjegyzések

A keretrendszer meghívja ezt a metódust annak meghatározására, hogy az eszköztár a testreszabás után visszatérhet-e az eredeti állapotához. Az eredeti állapot betöltődik az alkalmazás erőforrásaiból.

Ha CanBeRestored visszaadja TRUE, a testreszabási párbeszédpanel Eszköztárak lapja engedélyezi a kijelölt eszköztár Alaphelyzetbe állítása gombját.

Az alapértelmezett implementáció akkor ad TRUE vissza, ha az eszköztár eredeti erőforrás-azonosítója a betöltésekor nem nulla. Általában csak a felhasználó által megadott eszköztárak nem állíthatók vissza.

Felülbírálhatja a metódust a CanBeRestored viselkedés származtatott osztályokban való testreszabásához.

`CMFCToolBar::CanFocus`

Megadja, hogy a panel kap-e fókuszt.

virtual BOOL CanFocus() const;

Visszaadott érték

Ez a metódus ad FALSEvissza .

Megjegyzések

Ez a módszer felülírja az alaposztály implementációját, CBasePane::CanFocusmert az eszköztárobjektumok nem kapnak fókuszt.

`CMFCToolBar::CanHandleSiblings`

Meghatározza, hogy az eszköztár és a testvére ugyanazon a panelen van-e elhelyezve.

BOOL CanHandleSiblings();

Visszaadott érték

TRUE ha az eszköztár egy testvérrel rendelkezik, és az eszköztár és a testvére ugyanazon az ablaktáblán van elhelyezve; egyéb esetben FALSE.

Megjegyzések

A belső CMFCCustomizeButton::CreatePopupMenu metódus meghívja ezt a metódust, hogy meghatározza, hogyan jelenjen meg az Előugró menü testreszabása . Ha ez a módszer visszatér TRUE, a keretrendszer megjeleníti a Gombok megjelenítése egy sorban vagy a Gombok megjelenítése két sorban gombot.

Ezt a módszert általában nem kell használnia. Az eszköztáron megjelenő Testreszabás gomb engedélyezéséhez hívja meg a metódust CMFCToolBar::EnableCustomizeButton . Ha engedélyezni szeretné a Gombok megjelenítése egy sorban vagy a Gombok megjelenítése két sorban gombon parancsot, hívja meg a következőt CMFCToolBar::SetSiblingToolBar:

`CMFCToolBar::CleanUpImages`

Felszabadítja az eszköztárképekhez lefoglalt rendszererőforrásokat.

static void CMFCToolBar::CleanUpImages();

Megjegyzések

A keretrendszer ezt a metódust hívja meg, amikor egy alkalmazás leáll.

`CMFCToolBar::CleanUpLockedImages`

Felszabadítja a zárolt eszköztárképekhez lefoglalt rendszererőforrásokat.

void CleanUpLockedImages();

Megjegyzések

Hívja meg ezt a metódust, amikor az alkalmazás vizualizációs stílusa megváltozik. Tekintse meg a VisualStudioDemo mintát egy, a metódust használó példában.

`CMFCToolBar::CommandToIndex`

Az eszköztár gombjának indexét adja vissza egy megadott parancsazonosítóval.

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

Paraméterek

nIDFind
[in] Megadja a parancsazonosítót.

iIndexFirst
[in] Megadja a kiindulási indexet.

Visszaadott érték

Az eszköztár gomb nulla alapú indexe, ha a metódus sikeres volt; -1, ha nincs gomb a megadott azonosítóval.

Megjegyzések

Az CMFCToolBar objektumok megőrzik az eszköztár gombjainak belső listáját. Hívja meg ezt a függvényt, hogy lekérje egy gomb indexét a listában a gomb parancsazonosítójának megadva.

Ha iIndex 0-nál nagyobb, ez a metódus figyelmen kívül hagyja az eszköztár azon gombjait, amelyek indexe kisebb, mint iIndex.

`CMFCToolBar::Create`

Létrehoz egy CMFCToolBar objektumot.

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

Paraméterek

pParentWnd
[in] Az eszköztár szülőablakára mutató mutató.

dwStyle
[in] Az eszköztár stílusa. A stílusok listáját a Windows SDK eszköztár-vezérlő és gombstílusai című témakörben találja.

nID
[in] Az eszköztár gyermekablakának azonosítója.

Visszaadott érték

TRUE ha ez a módszer sikeres; egyéb esetben FALSE.

Megjegyzések

Ez a metódus létrehoz egy vezérlősávot, és csatolja az eszköztárhoz. Létrehozza a vezérlősávot a TBSTYLE_FLAT stílussal. Hívjon CMFCToolBar::CreateEx , ha más vezérlősávstílust szeretne használni.

`CMFCToolBar::CreateEx`

Létrehoz egy CMFCToolBar objektumot, amely további stílusbeállításokat, például nagyméretű ikonokat használ.

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

Paraméterek

pParentWnd
[in] Az eszköztár szülőablakára mutató mutató.

dwCtrlStyle
[in] További stílusok a beágyazott vezérlősáv-objektum létrehozásához.

dwStyle
[in] Az eszköztár stílusa. A megfelelő stílusok listáját az Eszköztár vezérlőelem és a Gombstílusok című témakörben találja.

rcBorders
[in] Az CRect eszköztár ablakszegélyeinek szélességét meghatározó objektum.

nID
[in] Az eszköztár gyermekablakának azonosítója.

Visszaadott érték

Nonzero, ha ez a módszer sikeres; egyéb esetben 0.

Megjegyzések

Ez a metódus létrehoz egy vezérlősávot, és csatolja az eszköztárhoz.

Ezt a metódust hívja meg ahelyett CMFCToolBar::Create , hogy konkrét stílusokat szeretne megadni. Állítsa be például úgy, dwCtrlStyleTBSTYLE_FLAT | TBSTYLE_TRANSPARENT hogy az Internet Explorer 4 által használt eszköztárakhoz hasonló eszköztárat hozzon létre.

példa

Az alábbi példa a CreateEx osztály CMFCToolBar metódusának használatát mutatja be. Ez a kódrészlet a IE Demo mintarésze.

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`

Inaktiválja az eszköztárat.

virtual void Deactivate();

Megjegyzések

Ez a módszer inaktiválja az eszköztárat úgy, hogy eltávolítja a fókuszt a kiemelt eszköztár gombjáról. A keretrendszer akkor hívja meg ezt a metódust, ha az eszköztár elveszíti a fókuszt, vagy megsemmisül.

`CMFCToolBar::DoPaint`

Egy eszköztár újrarajzlása.

virtual void DoPaint(CDC* pDC);

Paraméterek

pDC
[in] Egy eszközkörnyezetre mutató mutató.

Megjegyzések

Ezt a metódust a keretrendszer hívja meg, amikor az eszköztár egy részét újra kell festeni.

Felülbírálja ezt a metódust egy objektum CMFCToolBarmegjelenésének testreszabásához.

`CMFCToolBar::DrawButton`

Eszköztárgomb újrarajzolója.

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

Paraméterek

pDC
[in] Egy eszközkörnyezetre mutató mutató.

pButton
[in] A rajzolni kívánt gombra mutató egérmutató.

pImages
[in] Az eszköztár képére mutató mutató.

bHighlighted
[in] TRUE ha a gomb ki van emelve; egyéb esetben FALSE.

bDrawDisabledImages
[in] TRUE ha a letiltott gombok halványak; egyéb esetben FALSE.

Visszaadott érték

TRUE ha a gombot újrafestette; FALSE ha a gomb rejtett.

Megjegyzések

A CMFCToolBar::DrawButton metódus akkor hívja meg ezt a metódust, ha újra kell festeni egy eszköztárgombot.

Bírálja felül ezt a módszert, ha testre szeretné szabni a gombok megjelenését az eszköztáron.

`CMFCToolBar::DrawSeparator`

Újrafest egy elválasztót egy eszköztáron.

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

Paraméterek

pDC
[in] Egy eszközkörnyezetre mutató mutató.

rect
[in] Az elválasztó hely határoló téglalapja képpontban.

bHorz
[in] TRUE ha az elválasztó vízszintes, FALSE ha az elválasztó függőleges.

Megjegyzések

CMFCToolBar::DoPaint ezt a metódust hívja meg minden CMFCToolBar::DrawSeparator olyan objektumhoz, amely rendelkezik a TBBS_SEPARATOR stílussal, ahelyett, hogy ezeket a gombokat hívna CMFCToolBar::DrawButton meg.

Felülbírálhatja ezt a metódust egy olyan osztályban, amelyből CMFCToolBar származik az elválasztók megjelenésének testreszabása az eszköztáron. Az alapértelmezett megvalósítási hívások CMFCVisualManager::OnDrawSeparator egy elválasztó rajzolására szolgálnak, amelynek megjelenését az aktuális vizualizációkezelő határozza meg.

`CMFCToolBar::EnableCustomizeButton`

Engedélyezi vagy letiltja az eszköztáron megjelenő Testreszabás gombot.

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

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

Paraméterek

bEnable
[in] Engedélyezi vagy letiltja a Testreszabás gombot.

iCustomizeCmd
[in] A Testreszabás gomb parancsazonosítója.

strCustomizeText
[in] A Testreszabás gomb szövegfelirata.

uiCustomizeTextResId
[in] A Testreszabás gombcímke erőforrás-sztringazonosítója.

bQuickCustomize
[in] Engedélyezi vagy letiltja a Gomb hozzáadása vagy eltávolítása lehetőséget a gombról leeső menüben.

Megjegyzések

Ha iCustomizeCmd -1, a keretrendszer akkor jeleníti meg a Testreszabás gombot, ha több eszköztárgomb nem fér el az eszköztár területén. A gombon egy dupla balra mutató nyíl vagy sáv látható, amely azt jelzi, hogy több gomb van.

Ha iCustomizeCmd érvényes parancsazonosítót ad meg, és bEnable így van TRUE, a Testreszabás gomb mindig megjelenik. A gomb egy kis lefelé mutató nyíllal rendelkezik, és megnyitja a parancsot tartalmazó menüt. Ez a parancs a megadott strCustomizeTextszövegcímkét használja. Ha bQuickCustomize igen TRUE, akkor a menüben megjelenik a Gombok hozzáadása vagy eltávolítása lehetőség.

A keretrendszer dinamikusan hozzáadja a menühöz azokat a gombokat, amelyek nem férnek el az eszköztár területén a megadott iCustomizeCmdelem előtt. A sáv sáv a lefelé mutató nyíl mellett jelenik meg.

`CMFCToolBar::EnableDocking`

Engedélyezi a panel rögzítését a főkerethez.

virtual void EnableDocking(DWORD dwAlignment);

Paraméterek

dwAlignment
[in] Megadja az engedélyezendő dokkolás igazítását.

Megjegyzések

Ez a módszer kibővíti az alaposztály implementációját, CBasePane::EnableDockingha az adattagot a CBasePane::m_dwControlBarStyle következőre AFX_CBRS_FLOATállítja. Ez a módszer ezután átmegy dwAlignment az alaposztály implementálására.

`CMFCToolBar::EnableLargeIcons`

Engedélyezi vagy letiltja a nagyméretű ikonokat az eszköztárgombokon.

void EnableLargeIcons(BOOL bEnable);

Paraméterek

bEnable
[in] TRUE a nagyméretű ikonok engedélyezéséhez, FALSE a nagyméretű ikonok letiltásához.

Megjegyzések

Alapértelmezés szerint a nagyméretű ikonok engedélyezve vannak.

`CMFCToolBar::EnableQuickCustomization`

Engedélyezi vagy letiltja az eszköztárak gyors testreszabását, hogy a felhasználó lenyomhassa az Alt billentyűt, és egy gombot egy új helyre húzzon.

static void EnableQuickCustomization(BOOL bEnable=TRUE);

Paraméterek

bEnable
[in] TRUE a gyors testreszabás engedélyezéséhez, FALSE a gyors testreszabás letiltásához.

`CMFCToolBar::EnableReflections`

Engedélyezi vagy letiltja a parancsvisszaverést.

void EnableReflections(BOOL bEnable = TRUE);

Paraméterek

bEnable
[in] TRUE a parancsvisszaverés engedélyezéséhez; FALSE parancsvisszaverés letiltásához.

Megjegyzések

Ennek a metódusnak a meghívásával engedélyezheti a beágyazott vezérlőket, például kombinált listákat tartalmazó eszköztárgombok parancsvisszaverését.

A parancsvisszaverésről további információt a TN062: Message Reflection for Windows Controls című témakörben talál.

`CMFCToolBar::EnableTextLabels`

Engedélyezi vagy letiltja a szövegfeliratokat az eszköztár gombképei alatt.

void EnableTextLabels(BOOL bEnable=TRUE);

Paraméterek

bEnable
TRUE ha a szövegfeliratok az eszköztár gombképe alatt jelennek meg; egyéb esetben FALSE.

Megjegyzések

Ha a szövegfeliratok engedélyezve vannak, az eszköztár összes gombja megnagyobbodik, hogy helyet biztosítson a képek alatt megjelenítendő címkéknek. A testreszabási párbeszédpanelen be van jelölve a Szövegcímke megjelenítése jelölőnégyzet az Eszköztárak lapon. Amikor a felhasználó kiválaszt egy eszköztárat, és ellenőrzi ezt a beállítást, a keretrendszer meghívja EnableTextLabels a kijelölt eszköztárat. A forrásból származó CMFCToolBarFALSECMFCToolBar::AllowChangeTextLabels objektumok jelölőnégyzetét letilthatja.

`CMFCToolBar::FromHandlePermanent`

Az adott ablakfogópontot tartalmazó objektumra mutató mutatót CMFCToolBar kér le.

static CMFCToolBar* __stdcall FromHandlePermanent(HWND hwnd);

Paraméterek

hwnd
[in] A keresni kívánt ablakfogópont.

Visszaadott érték

Mutató a CMFCToolBar megadott ablakfogópontot tartalmazó objektumra, vagy NULL ha nincs megfelelő CMFCToolBar objektum.

Megjegyzések

Ez a megosztott módszer megvizsgálja az alkalmazás egyes eszköztárait az CMFCToolBar adott ablakleírót tartalmazó objektumhoz.

`CMFCToolBar::GetAllButtons`

Az eszköztár gombjainak írásvédett listáját adja vissza.

const CObList& GetAllButtons() const;

Visszaadott érték

Állandó hivatkozás egy CObList osztályobjektumra, amely osztályobjektumok gyűjteményét CMFCToolBarButton tartalmazza.

`CMFCToolBar::GetAllToolbars`

Az alkalmazás összes eszköztárának írásvédett listáját adja vissza.

static const CObList& GetAllToolbars();

Visszaadott érték

Egy objektumgyűjteményt tartalmazó osztályobjektumra mutató const-hivatkozásCObList.CMFCToolBar

`CMFCToolBar::GetBasicCommands`

Az alkalmazásban definiált alapvető parancsok írásvédett listáját adja vissza.

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

Visszaadott érték

Egy egyszerű parancsokat tartalmazó osztályobjektumra mutató const-hivatkozásCList.

Megjegyzések

Egyszerű parancsok hozzáadása hívással CMFCToolBar::AddBasicCommand vagy CMFCToolBar::SetBasicCommands.

`CMFCToolBar::GetButton`

Egy adott index osztályobjektumáraCMFCToolBarButton mutató mutatót ad vissza.

CMFCToolBarButton* GetButton(int iIndex) const;

Paraméterek

iIndex
[in] A visszaadni kívánt gomb indexét adja meg.

Visszaadott érték

Az eszköztár gombra mutató mutató, ha létezik; vagy NULL ha nincs ilyen gomb.

`CMFCToolBar::GetButtonInfo`

Egy adott index gombjának parancsazonosítóját, stílusát és képindexét adja vissza.

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

Paraméterek

nIndex
[in] Megadja a gomb indexét az eszköztár gomblistájában.

nID
[kifelé] Egy gomb parancsazonosítója.

nStyle
[kifelé] A gomb stílusa.

iImage
[kifelé] A gomb képének indexe.

Megjegyzések

A GetButtonInfo metódus megkeres egy eszköztárgombot a megadott indexben, és lekéri a gomb parancsazonosítóját, stílusát és képindexét.

Ha a megadott index gombja nem létezik, a keretrendszer 0 értékre állítja nIDnStyle , és iImage -1 a metódus visszatérésekor.

`CMFCToolBar::GetButtonSize`

Az eszköztár egyes gombjainak méreteit adja vissza.

CSize GetButtonSize() const;

Visszaadott érték

OsztályobjektumCSize, amely az eszköztár egyes gombjainak dimenzióit adja meg.

Megjegyzések

Hívja meg CMFCToolBar::SetSizes vagy CMFCToolBar::SetLockedSizes állítsa be az eszköztár egyes gombjainak méreteit.

`CMFCToolBar::GetButtonStyle`

A megadott indexen található eszköztárgomb aktuális stílusát adja vissza.

UINT GetButtonStyle(int nIndex) const;

Paraméterek

nIndex
[in] Egy eszköztárgomb indexét adja meg.

Visszaadott érték

Az eszköztár gomb stílusát meghatározó érték. . A lehetséges stílusok listáját az eszközsáv vezérlőstílusai között találja.

Megjegyzések

Hívás CMFCToolBar::SetButtonStyle egy eszköztárgomb stílusának beállításához

`CMFCToolBar::GetButtonText`

Egy adott indexet tartalmazó gomb szöveges címkéjét adja vissza.

CString GetButtonText(int nIndex) const;

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

`CMFCToolBar::GetCommandButtons`

Visszaadja azoknak a gomboknak a listáját, amelyek adott parancsazonosítóval rendelkeznek az alkalmazás összes eszköztárából.

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

Paraméterek

uiCmd
[in] A gombok parancsazonosítója.

listButtons
[kifelé] Hivatkozás egy CObList osztályobjektumra , amely megkapja az eszköztárgombok listáját.

Visszaadott érték

A megadott parancsazonosítóval rendelkező gombok száma.

`CMFCToolBar::GetCount`

Az eszköztár gombjainak és elválasztó elemeinek számát adja vissza.

int GetCount() const;

Visszaadott érték

Az eszköztár gombjainak és elválasztó elemeinek száma.

`CMFCToolBar::GetCustomizeButton`

Az eszköztárhoz társított objektumra mutató mutatót CMFCCustomizeButton kér le.

CMFCCustomizeButton* GetCustomizeButton();

Visszaadott érték

Az eszköztárhoz társított objektumra mutató mutató CMFCCustomizeButton .

Megjegyzések

Ez a metódus lekéri az eszköztár végén megjelenő Testreszabás gombot. Ezzel a CMFCToolBar::EnableCustomizeButton módszerrel hozzáadhatja a Testreszabás gombot az eszköztárhoz.

Meghívhatja a CMFCToolBar::IsExistCustomizeButton metódust annak megállapításához, hogy az eszköztár tartalmaz-e érvényes CMFCCustomizeButton objektumot.

`CMFCToolBar::GetDefaultImage`

A megadott parancsazonosítóval rendelkező eszköztárgomb alapértelmezett képének indexét adja vissza.

static int GetDefaultImage(UINT uiID);

Paraméterek

BOOL GetIgnoreSetText() const;

Visszaadott érték

TRUEha a gombcímkék beállítására irányuló hívásokat figyelmen kívül hagyja; egyéb esetben. FALSE

Megjegyzések

`CMFCToolBar::GetImages`

Az alkalmazás alapértelmezett gombképeinek gyűjteményére mutató mutatót ad vissza.

static CMFCToolBarImages* GetImages();

Visszaadott érték

Mutató az CMFCToolBarImages osztályobjektumra , amely az alkalmazás összes eszköztárának alapértelmezett rendszerképeit tartalmazza.

Megjegyzések

Ez a megosztott módszer hozzáférést biztosít az alkalmazás összes alapértelmezett eszköztárképének gyűjteményéhez. Hívja meg a metódust CMFCToolBar::LoadBitmap , hogy képeket vegyen fel a gyűjteménybe.

`CMFCToolBar::GetImageSize`

Az eszköztár gombképeinek aktuális méretét adja vissza.

CSize GetImageSize() const;

Visszaadott érték

EgyCSize osztályobjektum, amely az eszköztár gombképeinek aktuális méretét jelöli.

`CMFCToolBar::GetImagesOffset`

Azt az indexeltolást adja vissza, amellyel az eszköztár eszköztárgomb-lemezképeit megtalálhatja az eszköztár gombképeinek globális listájában.

int GetImagesOffset() const;

Visszaadott érték

Az eszköztárképek indexeltolása.

Megjegyzések

A rendszer az összes alapértelmezett eszköztárképet a globális CMFCToolBarImages osztálylistában tárolja. Az eszköztár minden gombjának képei egymás után vannak tárolva a listában. A kép indexének kiszámításához adja hozzá az eszköztárban lévő gomb indexét az eszköztár képlistájának elejéhez.

Hívás CMFCToolBar::ButtonToIndex egy eszköztárgomb indexének lekéréséhez, amely egy mutatót ad a gombhoz.

Hívás CMFCToolBar::GetImages az eszköztárképek gyűjteményére mutató mutató lekéréséhez.

`CMFCToolBar::GetInvalidateItemRect`

Lekéri az ügyfélterület azon régióját, amelyet újra kell helyezni a gombhoz az adott indexen.

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

Paraméterek

nIndex
[in] Annak a gombnak az indexe, amelyhez le szeretné kérni az ügyfélterületet.

lpRect
[kifelé] Egy olyan objektumra mutató RECT mutató, amely az ügyfélterület régióját fogadja.

Megjegyzések

A lpRect paraméter nem lehet NULL. Ha a megadott indexben nincs gomb, lpRect a rendszer egy RECT nullára inicializált objektumot fogad.

`CMFCToolBar::GetItemID`

Egy adott index eszköztár gombjának parancsazonosítóját adja vissza.

UINT GetItemID(int nIndex) const;

Paraméterek

nIndex
[in] Az eszköztár gomb indexét adja meg.

Visszaadott érték

Az eszköztár gomb parancsazonosítója; vagy nulla, ha a megadott indexet tartalmazó gomb nem létezik.

`CMFCToolBar::GetItemRect`

A gomb határoló téglalapját adja vissza egy adott indexen.

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

Paraméterek

nIndex
[in] Egy eszköztárgomb indexét adja meg.

lpRect
[kifelé] A kép határoló téglalap koordinátáit fogadó objektumra mutató mutató CRect .

Megjegyzések

Az CRect objektum, amelyre lpRect a pontok 0-ra vannak állítva, ha a megadott index egyik gombja nem létezik.

példa

Az alábbi példa a GetItemRect osztály CMFCToolBar metódusának használatát mutatja be. Ez a kódrészlet a IE Demo mintarésze.

CMFCToolBar m_wndToolBar;

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

`CMFCToolBar::GetLargeColdImages`

Egy mutatót ad vissza az alkalmazás nagyméretű, hideg eszköztár gombképeinek gyűjteményéhez.

static CMFCToolBarImages* GetLargeColdImages();

Visszaadott érték

A nagyméretű hideg képek gyűjteményére mutató mutató.

Megjegyzések

A hideg képek azokat a képeket használják, amelyek akkor használatosak, ha a felhasználó nem használja az eszköztárgombokat. Hívás CMFCToolBar::LoadBitmapEx a nagy hideg képek betöltéséhez.

`CMFCToolBar::GetLargeDisabledImages`

Egy mutatót ad vissza az alkalmazás nagyméretű letiltott eszköztárképeinek gyűjteményéhez.

static CMFCToolBarImages* GetLargeDisabledImages();

Visszaadott érték

A nagyméretű letiltott eszköztárképek gyűjteményére mutató mutató.

Megjegyzések

A nagyméretű képek a normál eszköztár gombképeinek nagy verziói. Hívja meg CMFCToolBar::LoadBitmapEx vagy CMFCToolBar::LoadBitmap töltse be a nagyméretű képeket.

`CMFCToolBar::GetLargeImages`

Egy mutatót ad vissza az alkalmazás nagyméretű eszköztár-gombképeinek gyűjteményéhez.

static CMFCToolBarImages* GetLargeImages();

Visszaadott érték

Mutató a nagyméretű eszköztár-gombképek gyűjteményéhez.

Megjegyzések

A nagyméretű képek a normál eszköztár gombképeinek nagy verziói. Hívás CMFCToolBar::LoadBitmapEx a nagyméretű képek betöltéséhez.

`CMFCToolBar::GetLockedColdImages`

Egy mutatót ad vissza az eszköztár zárolt hideg lemezképeinek gyűjteményéhez.

CMFCToolBarImages* GetLockedColdImages();

Visszaadott érték

Mutató a zárolt hideg képek gyűjteményéhez, vagy NULL ha az eszköztár nincs zárolva.

Megjegyzések

A zárolt képek a normál eszköztár gombképeinek olyan verziói, amelyeket a keretrendszer akkor használ, ha a felhasználó nem tudja testre szabni az eszköztárat. A hideg képek azokat a képeket használják, amelyek akkor használatosak, ha a felhasználó nem használja az eszköztárgombokat.

Ez a metódus akkor ad NULL vissza, ha az eszköztár nincs zárolva. Ez a módszer a hibakeresési buildekben is érvényesítési hibát okoz, ha az eszköztár nincs zárolva. További információ a zárolt eszköztárakról: CMFCToolBar::IsLocked.

Hívja meg a metódust a CMFCToolBar::LoadBitmapEx zárolt hideg képek betöltéséhez.

`CMFCToolBar::GetLockedDisabledImages`

Egy mutatót ad vissza az eszköztár zárolt letiltott lemezképeinek gyűjteményéhez.

CMFCToolBarImages* GetLockedDisabledImages();

Visszaadott érték

Mutató a zárolt letiltott képek gyűjteményére, vagy NULL ha az eszköztár nincs zárolva.

Megjegyzések

A zárolt képek a normál eszköztár gombképeinek olyan verziói, amelyeket a keretrendszer akkor használ, ha a felhasználó nem tudja testre szabni az eszköztárat. A letiltott képek azok a képek, amelyeket a keretrendszer használ, amikor egy gomb stílussal rendelkezik TBBS_DISABLED .

CMFCToolBar::LoadBitmapEx A zárolt letiltott képek betöltéséhez hívja meg a metódust.

`CMFCToolBar::GetLockedImages`

Az eszköztár zárolt gombképeinek gyűjteményére mutató mutatót ad vissza.

CMFCToolBarImages* GetLockedImages();

Visszaadott érték

Mutató a zárolt eszköztár gombképeinek gyűjteményéhez, vagy NULL ha az eszköztár nincs zárolva.

Megjegyzések

A zárolt képek a normál eszköztár gombképeinek olyan verziói, amelyeket a keretrendszer akkor használ, ha a felhasználó nem tudja testre szabni az eszköztárat.

`CMFCToolBar::GetLockedImageSize`

A zárolt eszköztárképek alapértelmezett méretét adja vissza.

CSize GetLockedImageSize() const;

Visszaadott érték

Olyan CSize struktúra, amely meghatározza a zárolt eszköztár lemezképeinek méretét, vagy üres CSize szerkezetet, ha az eszköztár nincs zárolva.

Megjegyzések

A zárolt képek a normál eszköztár gombképeinek olyan verziói, amelyeket a keretrendszer akkor használ, ha a felhasználó nem tudja testre szabni az eszköztárat.

Ez a metódus nulla CSize szélességű és nulla magasságú szerkezetet ad vissza, ha az eszköztár nincs zárolva. Ez a módszer a hibakeresési buildekben is érvényesítési hibát okoz, ha az eszköztár nincs zárolva. További információ a zárolt eszköztárakról: CMFCToolBar::IsLocked.

A zárolt kép méretének megadásához hívja meg a CMFCToolBar::SetLockedSizes metódust.

`CMFCToolBar::GetLockedMenuImages`

Egy mutatót ad vissza az eszköztár zárolt eszköztár-menüképeinek gyűjteményéhez.

CMFCToolBarImages* GetLockedMenuImages();

Visszaadott érték

Mutató a zárolt eszköztár menüképeinek gyűjteményéhez, vagy NULL ha az eszköztár nincs zárolva.

Megjegyzések

A zárolt képek a normál eszköztár menürendszerképeinek olyan verziói, amelyeket a keretrendszer akkor használ, ha a felhasználó nem tudja testre szabni az eszköztárat.

Hívja meg a metódust a CMFCToolBar::LoadBitmapEx zárolt menürendszerképek betöltéséhez.

`CMFCToolBar::GetMenuButtonSize`

Az alkalmazás menügombjainak méretét adja vissza.

static CSize GetMenuButtonSize();

Visszaadott érték

A CSize menügombok méretét képpontban kifejező objektum.

Megjegyzések

Az eszköztárak menügombjainak mérete globális változóként marad fenn, és ezzel a statikus módszerrel kérhető le.

Hívás CMFCToolBar::SetMenuSizes a globális változó beállításához.

`CMFCToolBar::GetMenuImages`

Egy mutatót ad vissza az alkalmazásban található menügombképek gyűjteményéhez.

static CMFCToolBarImages* GetMenuImages();

Visszaadott érték

A menüképek gyűjteményére mutató mutató.

Megjegyzések

Hívja meg a metódust CMFCToolBar::LoadBitmapEx a menürendszerképek betöltéséhez.

Hívja meg a metódust a CMFCToolBar::SetMenuSizes gombok és a képek méretének beállításához.

`CMFCToolBar::GetMenuImageSize`

Az alkalmazásban lévő menügomb-képek méretét adja vissza.

static CSize GetMenuImageSize();

Visszaadott érték

A CSize menüképek méretét képviselő objektum.

Megjegyzések

Ez a módszer a globális változóként fenntartott eszköztár menügombjaiban lévő képek méretét adja vissza. Hívás CMFCToolBar::SetMenuSizes a globális változó beállításához.

`CMFCToolBar::GetOrigButtons`

Lekéri az eszköztár nem testre szabott gombjainak gyűjteményét.

const CObList& GetOrigButtons() const;

Visszaadott érték

Hivatkozás az eszköztár nem testre szabott gombjainak listájára.

Megjegyzések

A keretrendszer létrehozza az eszköztárgombok másolatát, mielőtt a felhasználó testre szabja őket. A CMFCToolBar::SetButtons metódus hozzáad egy másolatot a megadott tömb egyes gombjairól az eredeti gombok listájához. A CMFCToolBar::RestoreOriginalState metódus visszaállítja az eszköztár eredeti állapotát az erőforrásfájlból való betöltésével.

Az eszköztár eredeti gombjainak listájának beállításához hívja meg a metódust CMFCToolBar::SetOrigButtons .

`CMFCToolBar::GetOrigResetButtons`

Lekéri az eszköztár nem testre szabott alaphelyzetbe állítási gombjainak gyűjteményét.

const CObList& GetOrigResetButtons() const;

Visszaadott érték

Hivatkozás az eszköztár nem testre szabott alaphelyzetbe állítási gombjainak listájára.

Megjegyzések

Amikor a felhasználó a testreszabási módban az Alaphelyzetbe állítás gombot választja, a keretrendszer ezzel a módszerrel állítja vissza az eszköztárról eltávolított gombokat.

A CMFCToolBar::SetButtons metódus az egyes eszköztárgombok másolatát hozzáadja az eredeti visszaállítási gombok listájához, miután meghívta a metódust CMFCToolBar::OnReset . Felülbírálhatja a metódust a CMFCToolBar::OnReset gombok megjelenésének testreszabásához, miután a felhasználó lenyomta az Alaphelyzetbe állítás gombot.

`CMFCToolBar::GetResourceID`

Lekéri az eszköztár erőforrás-azonosítóját.

UINT GetResourceID() const;

Visszaadott érték

Az eszköztár erőforrás-azonosítója.

Megjegyzések

Hívja meg a metódust CMFCToolBar::LoadToolBarEx az eszköztár erőforrás-azonosítójának beállításához.

`CMFCToolBar::GetRouteCommandsViaFrame`

Meghatározza, hogy melyik objektum, a szülőkeret vagy a tulajdonos küld parancsokat az eszköztárnak.

BOOL GetRouteCommandsViaFrame();

Visszaadott érték

Nonzero, ha a szülőkeret parancsokat küld az eszköztárnak; 0, ha a tulajdonos parancsokat küld az eszköztárra.

Megjegyzések

Alapértelmezés szerint a szülőkeret parancsokat küld az eszköztárnak. Hívás CMFCToolBar::SetRouteCommandsViaFrame a viselkedés módosítására.

Ha ez a metódus nemero értéket ad vissza, a metódus használatával CMFCToolBar::GetCommandTarget lekérhet egy mutatót a szülőkeret objektumához. Tekintse meg a VisualStudioDemo mintát egy, a metódust használó példában.

`CMFCToolBar::GetRowHeight`

Az eszköztárgombok magasságát adja vissza.

virtual int GetRowHeight() const;

Visszaadott érték

Az eszköztárgombok magassága képpontban.

Megjegyzések

A keretrendszer ezt a metódust az eszköztár elrendezésének kiszámítására hívja meg. Felülbírálja ezt a metódust egy származtatott osztályban, és adjon meg egy másik magasságot az eszköztárhoz.

`CMFCToolBar::GetShowTooltips`

Megadja, hogy az eszköztárgombok eszköztippjei megjelenjenek-e.

static BOOL GetShowTooltips();

Visszaadott érték

TRUE ha eszköztippek jelennek meg az eszköztárgombokhoz; egyéb esetben FALSE.

Megjegyzések

Alapértelmezés szerint az eszköztippek jelennek meg. Ezt a statikus jelzőt a hívással CMFCToolBar::SetShowTooltipsmódosíthatja.

`CMFCToolBar::GetSiblingToolBar`

Lekéri az eszköztár testvérét.

CMFCToolBar* GetSiblingToolBar();

Visszaadott érték

Egy mutató a testvér eszköztárra.

Megjegyzések

További információ arról, hogyan engedélyezheti a Gombok megjelenítése egy sorban és a Gombok megjelenítése két sorban gombot, lásd CMFCToolBar::SetSiblingToolBar: .

`CMFCToolBar::GetUserImages`

Egy mutatót ad vissza a felhasználó által definiált eszköztár gombképeinek gyűjteményéhez az alkalmazásban.

static CMFCToolBarImages* GetUserImages();

Visszaadott érték

Mutató a felhasználó által definiált eszköztárgombképek gyűjteményére az alkalmazás összes eszköztárához.

Megjegyzések

Hívja meg a metódust CMFCToolBar::SetUserImages a felhasználó által definiált képek gyűjteményének beállításához az alkalmazásban.

`CMFCToolBar::HitTest`

A megadott helyen található eszköztárgomb indexét adja vissza.

virtual int HitTest(CPoint point);

Paraméterek

point
[in] A tesztelni kívánt pont az ügyfélkoordinátákban.

Visszaadott érték

A gomb indexe, amely a megadott pozícióban található, vagy -1, ha nincs ilyen gomb, vagy a gomb elválasztó.

`CMFCToolBar::InsertButton`

Beszúr egy gombot az eszköztárba.

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

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

Paraméterek

button
[in] Megadja a beszúrni kívánt gombot.

iInsertAt
[in] Megadja a gomb beszúrásához a nullaalapú pozíciót.

Visszaadott érték

A gomb beszúrásának helye, vagy hiba esetén -1.

Megjegyzések

Ha iInsertAt -1, ez a metódus hozzáadja a gombot az eszköztárgombok listájának végéhez.

Hívja meg a CMFCToolBar::InsertSeparator metódust, hogy beszúrjon egy elválasztót az eszköztárba.

`CMFCToolBar::InsertSeparator`

Elválasztó beszúrása az eszköztárba.

virtual int InsertSeparator(INT_PTR iInsertAt=-1);

Paraméterek

iInsertAt
[in] Megadja azt a nulla alapú pozíciót, amelybe be szeretné szúrni az elválasztót. Ennek a paraméternek 0-nál nagyobbnak kell lennie.

Visszaadott érték

Az elválasztó beszúrásának helye, vagy hiba esetén -1.

Megjegyzések

Hívja meg ezt a metódust, ha elválasztót szeretne beszúrni két meglévő gomb közé. Ha iInsertAt -1, ez a metódus hozzáadja az elválasztót az eszköztárgombok listájának végéhez.

Ezzel a módszerrel nem adhat hozzá elválasztójelet egy üres eszköztárhoz.

Hívja meg a CMFCToolBar::InsertButton metódust, hogy beszúrjon egy gombot az eszköztárba.

`CMFCToolBar::InvalidateButton`

Érvényteleníti a megadott indexen található eszköztárgomb ügyfélterületét.

CMFCToolBarButton* InvalidateButton(int nIndex);

Paraméterek

nIndex
[in] Az eszköztár gombjának nullaalapú indexe.

Visszaadott érték

Mutató a CMFCToolBarButton megadott indexben található objektumra, vagy NULL ha nincs ilyen objektum.

Megjegyzések

A keretrendszer ezt a metódust hívja meg, amikor frissíti az eszköztárgombhoz társított ügyfélterületet. Meghívja a metódust CWnd::InvalidateRect a megadott indexben található objektum ügyfél téglalapjával CMFCToolBarButton .

`CMFCToolBar::IsAddRemoveQuickCustomize`

Meghatározza, hogy a felhasználó hozzáadhat vagy eltávolíthat-e eszköztárgombokat a Testreszabás menü beállítással.

BOOL IsAddRemoveQuickCustomize();

Visszaadott érték

TRUEha a felhasználó a Testreszabás menüvel módosíthatja az eszköztárat; egyéb esetben. FALSE

Megjegyzések

`CMFCToolBar::IsAltCustomizeMode`

Megadja, hogy a gyors testreszabást használja-e egy gomb húzásához. Ha a gyors testreszabás engedélyezve van, a felhasználó lenyomva tarthatja az Alt billentyűt, és húzhat egy gombot egy új helyre.

static BOOL __stdcall IsAltCustomizeMode();

Visszaadott érték

TRUEha gyors testreszabást használ egy gomb húzásához; egyéb esetben. FALSE

Megjegyzések

`CMFCToolBar::IsAutoGrayInactiveImages`

Megadja, hogy engedélyezve van-e az inaktív (nem kiemelt) gombképek automatikus létrehozása.

static BOOL IsAutoGrayInactiveImages();

Visszaadott érték

TRUE ha engedélyezve van az inaktív képek automatikus halványításának lehetősége; egyéb esetben FALSE.

Megjegyzések

Az inaktív képek automatikus halványítását a hívással CMFCToolBar::AutoGrayInactiveImagesengedélyezheti vagy letilthatja.

`CMFCToolBar::IsBasicCommand`

Meghatározza, hogy egy parancs szerepel-e az alapszintű parancsok listájában.

static BOOL IsBasicCommand(UINT uiCmd);

Paraméterek

uiCmd
[in] Megadja az ellenőrizni kívánt parancsot.

Visszaadott érték

TRUE ha a megadott parancs az alapszintű parancsok listájához tartozik; egyéb esetben FALSE.

Megjegyzések

Ez a statikus módszer határozza meg, hogy a megadott uiCmd parancs az alapszintű parancsok globális listájához tartozik-e. Az alapszintű parancsok listáját a hívással CMFCToolBar::AddBasicCommand vagy CMFCToolBar::SetBasicCommandsa .

`CMFCToolBar::IsButtonExtraSizeAvailable`

Meghatározza, hogy az eszköztár megjeleníthet-e kiterjesztett szegélyű gombokat.

virtual BOOL IsButtonExtraSizeAvailable() const;

Visszaadott érték

TRUE ha a sáv a plusz szegélyméretű gombokat képes megjeleníteni; egyéb esetben FALSE.

Megjegyzések

Az eszköztár-objektum akkor tér vissza TRUE , ha kiterjesztett szegélyű gombokat jelenít meg. Az eszköztárgomb meghívja ezt a metódust, amikor kezeli az CMFCToolBarButton::OnChangeParentWnd értesítést, és ennek megfelelően beállítja a belső extra szegélyméret jelzőjét. Ez a belső jelző később lekérhető a hívással CMFCToolBarButton::IsExtraSize.

Felülbírálhatja ezt a metódust egy olyan osztályban, amelyből származik CMFCToolBar , és visszaadja TRUE azt, ha a sáv az eszköztárgombokat a további szegélymérettel jeleníti meg, és ellenkező esetben tér vissza FALSE . Az alapértelmezett implementáció ad TRUEvissza.

`CMFCToolBar::IsButtonHighlighted`

Meghatározza, hogy a megadott gomb ki van-e emelve.

BOOL IsButtonHighlighted(int iButton) const;

Paraméterek

iButton
[in] Egy eszköztárgomb indexét adja meg.

Visszaadott érték

TRUEha a megadott gomb ki van emelve; egyéb esetben. FALSE

Megjegyzések

`CMFCToolBar::IsCommandPermitted`

Meghatározza, hogy engedélyezett-e egy parancs.

static BOOL IsCommandPermitted(UINT uiCmd);

Paraméterek

uiCmd
[in] Megadja az ellenőrizni kívánt parancsot.

Visszaadott érték

TRUE ha a megadott parancs engedélyezett; egyéb esetben FALSE.

Megjegyzések

Ez a statikus módszer határozza meg, hogy a megadott uiCmd parancs a nem engedélyezett parancsok globális listájához tartozik-e.

A nem engedélyezett parancsok listáját a hívással CMFCToolBar::SetNonPermittedCommandsmódosíthatja.

`CMFCToolBar::IsCommandRarelyUsed`

Meghatározza, hogy ritkán használ-e parancsot.

static BOOL IsCommandRarelyUsed(UINT uiCmd);

Paraméterek

uiCmd
[in] Megadja az ellenőrizni kívánt parancsot.

Visszaadott érték

TRUE ha a megadott parancsot ritkán használják; egyéb esetben FALSE.

Megjegyzések

A IsCommandRarelyUsed metódus a FALSE következő feltételek közül egy vagy több bekövetkezésekor ad vissza:

A megadott parancs az alapszintű parancsok listájához tartozik
A megadott parancs az egyik szabványos parancs
A keretrendszer testreszabási módban van
Az alapszintű parancsok listája üres
A parancshívások több mint 20% a megadott parancsra irányuló hívások.

`CMFCToolBar::IsCustomizeMode`

Megadja, hogy az eszköztár-keretrendszer testreszabási módban van-e.

static BOOL IsCustomizeMode();

Visszaadott érték

TRUE ha a keretrendszer testreszabási módban van; egyéb esetben FALSE.

Megjegyzések

A testreszabási módot a hívással CMFCToolBar::SetCustomizeModekapcsolhatja be.

A keretrendszer megváltoztatja a módot, amikor a felhasználó meghívja a testreszabási párbeszédpanelt ( CMFCToolBarsCustomizeDialog Osztály).

`CMFCToolBar::IsDragButton`

Meghatározza, hogy az eszköztár gombja húzva van-e.

BOOL IsDragButton(const CMFCToolBarButton* pButton) const;

Paraméterek

pButton
[in] Mutató az eszköztár gombjára.

Visszaadott érték

TRUEha a megadott gomb húzása folyamatban van; egyéb esetben. FALSE

Megjegyzések

`CMFCToolBar::IsExistCustomizeButton`

Meghatározza, hogy az eszköztár tartalmazza-e a Testreszabás gombot.

BOOL IsExistCustomizeButton();

Visszaadott érték

TRUE ha az eszköztár tartalmazza a Testreszabás gombot; egyéb esetben FALSE.

Megjegyzések

Ha ez a metódus visszatér TRUE, a CMFCToolBar::GetCustomizeButton metódus az eszköztár végén megjelenő Testreszabás gombra mutató mutatót ad vissza.

Ezzel a CMFCToolBar::EnableCustomizeButton módszerrel hozzáadhatja a Testreszabás gombot az eszköztárhoz.

`CMFCToolBar::IsFloating`

Meghatározza, hogy az eszköztár lebegő-e.

virtual BOOL IsFloating() const;

Visszaadott érték

TRUEha az eszköztár lebegő; egyéb esetben. FALSE

`CMFCToolBar::IsLargeIcons`

Megadja, hogy az alkalmazás eszköztárai jelenleg nagy ikonokat jelenjenek-e meg.

static BOOL IsLargeIcons();

Visszaadott érték

TRUE ha az alkalmazás nagy ikonokat használ; egyéb esetben FALSE.

Megjegyzések

Nagy ikonok és normál ikonok közötti váltás hívása CMFCToolBar::SetLargeIcons .

A keretrendszer automatikusan módosítja a módot, amikor a felhasználó a Testreszabás párbeszédpanel Beállítások lapján bejelöli a Nagy ikonok jelölőnégyzetet.

`CMFCToolBar::IsLastCommandFromButton`

Meghatározza, hogy a legutóbb végrehajtott parancs a megadott eszköztárgombból lett-e elküldve.

static BOOL IsLastCommandFromButton(CMFCToolBarButton* pButton);

Paraméterek

pButton
[in] Mutató a gombhoz.

Visszaadott érték

TRUE ha az utolsó parancs a megadott gombról pButton lett elküldve; ellenkező esetben FALSE.

Megjegyzések

Ez a metódus hívással egy struktúra mutatójátMSG szerzi beCWnd::GetCurrentMessage. Ezután összehasonlítja a HWND gombot a MSG::lParam tagokkal, és MSG::hwnd megállapítja, hogy a gomb volt-e a parancs forrása.

`CMFCToolBar::IsLocked`

Meghatározza, hogy az eszköztár zárolva van-e.

BOOL IsLocked() const;

Visszaadott érték

TRUEha az eszköztár zárolva van; egyéb esetben. FALSE

Megjegyzések

Ez a módszer akkor tér TRUE vissza, ha a felhasználó nem tudja végrehajtani a testreszabási feladatokat, például az eszköztárgombok áthelyezését.

A zárolt eszköztárak külön képlistákat használnak. További információ ezekről a képlistákról: CMFCToolBar::LoadBitmapEx.

`CMFCToolBar::IsOneRowWithSibling`

Meghatározza, hogy az eszköztár és a testvérpult ugyanabban a sorban van-e elhelyezve.

BOOL IsOneRowWithSibling();

Visszaadott érték

TRUE ha az eszköztár és a testvére ugyanabban a sorban van elhelyezve; egyéb esetben FALSE.

Megjegyzések

A CMFCCustomizeButton::CreatePopupMenu metódus meghívja ezt a metódust, hogy meghatározza, hogyan jelenjen meg az előugró menü testreszabása . Ha ez a módszer visszatér TRUE, a keretrendszer megjeleníti a Gombok megjelenítése egy sorban gombot. Ellenkező esetben a keretrendszer megjeleníti a Gombok megjelenítése két sorban gombot.

Ezt a módszert általában nem kell használnia. Ha engedélyezni szeretné a Gombok megjelenítése egy sorban vagy a Gombok megjelenítése két sorban gombon parancsot, hívja meg a következőt CMFCToolBar::SetSiblingToolBar:

`CMFCToolBar::IsResourceChanged`

virtual BOOL IsResourceChanged() const;

Visszaadott érték

Megjegyzések

`CMFCToolBar::IsSibling`

BOOL IsSibling();

Visszaadott érték

Megjegyzések

`CMFCToolBar::IsUserDefined`

Megadja, hogy az eszköztár felhasználó által definiált-e.

BOOL IsUserDefined() const;

Visszaadott érték

TRUE ha az eszköztárat a felhasználó hozta létre; egyéb esetben FALSE.

`CMFCToolBar::LoadBitmap`

Betölti az eszköztárrendszerképeket az alkalmazáserőforrásokból.

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

Paraméterek

uiResID
[in] A gyakori eszköztár lemezképére hivatkozó bitkép erőforrás-azonosítója.

uiColdResID
[in] A hideg eszköztár lemezképére hivatkozó bitkép erőforrás-azonosítója.

uiMenuResID
[in] A normál menürendszerképekre hivatkozó bitkép erőforrás-azonosítója.

bLocked
[in] TRUE az eszköztár zárolásához; egyéb esetben FALSE.

uiDisabledResID
[in] A letiltott eszköztárképekre hivatkozó bitkép erőforrás-azonosítója.

uiMenuDisabledResID
[in] A letiltott menüképekre hivatkozó bitkép erőforrás-azonosítója.

Visszaadott érték

Nemzero, ha a módszer sikeres; egyéb esetben 0.

Megjegyzések

A CMFCToolBar::LoadToolBarEx metódus meghívja ezt a metódust, hogy betöltse az eszköztárhoz társított képeket. A metódus felülbírálása a képerőforrások egyéni betöltéséhez.

Az eszköztár létrehozása után hívja meg a LoadBitmapEx metódust további képek betöltéséhez.

`CMFCToolBar::LoadBitmapEx`

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

Paraméterek

[in] params
[in] bLocked

Visszaadott érték

Megjegyzések

`CMFCToolBar::LoadLargeIconsState`

static BOOL __stdcall LoadLargeIconsState(LPCTSTR lpszProfileName = NULL);

Paraméterek

[in] lpszProfileName

Visszaadott érték

Megjegyzések

`CMFCToolBar::LoadParameters`

Betölti a globális eszköztár beállításait a Windows beállításjegyzékéből.

static BOOL LoadParameters(LPCTSTR lpszProfileName=NULL);

Paraméterek

lpszProfileName
[in] A Windows beállításkulcs relatív elérési útját adja meg.

Visszaadott érték

Nemzero, ha a módszer sikeres; egyéb esetben 0.

Megjegyzések

Ez a módszer betölti a globális paramétereket, például a menüanimáció típusát, a menü árnyékstílusát, valamint azt, hogy a Windows beállításjegyzékből megjelenít-e nagy ikonokat.

A CWinAppEx::LoadState metódus ezt a metódust az alkalmazás inicializálási folyamatának részeként hívja meg.

`CMFCToolBar::LoadState`

Betölti az eszköztár állapotadatait a Windows beállításjegyzékéből.

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

Paraméterek

lpszProfileName
[in] A Windows beállításkulcs relatív elérési útját adja meg.

nIndex
[in] Megadja az eszköztár vezérlőazonosítóját.

uiID
[in] Megadja az eszköztár erőforrás-azonosítóját.

Visszaadott érték

Nemzero, ha a módszer sikeres; egyéb esetben 0.

Megjegyzések

A keretrendszer ezt a metódust az alkalmazás inicializálási folyamatának részeként hívja meg. További információért lásd CWinAppEx::LoadState.

`CMFCToolBar::LoadToolBar`

Betölti az eszköztárat az alkalmazáserőforrásokból.

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

Paraméterek

uiResID
[in] Az eszköztár erőforrás-azonosítója.

uiColdResID
[in] A hideg eszköztár lemezképére hivatkozó bitkép erőforrás-azonosítója.

uiMenuResID
[in] A normál menürendszerképekre hivatkozó bitkép erőforrás-azonosítója.

bLocked
[in] Logikai érték, amely meghatározza, hogy az eszköztár zárolva van-e. Ha ez a paraméter, TRUEaz eszköztár zárolva van. Ellenkező esetben az eszköztár nincs zárolva.

uiDisabledResID
[in] A letiltott eszköztárképekre hivatkozó bitkép erőforrás-azonosítója.

uiMenuDisabledResID
[in] A letiltott menüképekre hivatkozó bitkép erőforrás-azonosítója.

uiHotResID
[in] A gyakori eszköztár lemezképére hivatkozó bitkép erőforrás-azonosítója.

Visszaadott érték

Nemzero, ha a módszer sikeres; egyéb esetben 0.

Megjegyzések

A keretrendszer az inicializálás során meghívja ezt a metódust az eszköztárhoz társított képek betöltéséhez.

példa

Az alábbi példa bemutatja, hogyan használható a LoadToolBar metódus a CMFCToolBar osztályban. Ez a kódrészlet a IE Demo mintarésze.

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`

Betölti az eszköztárat az alkalmazás erőforrásaiból a CMFCToolBarInfo segédosztály használatával, hogy az alkalmazás nagy méretű képeket használhasson.

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

Paraméterek

uiToolbarResID
[in] Az eszköztár erőforrás-azonosítója.

params
[in] Hivatkozás az CMFCToolBarInfo eszköztárképek erőforrásazonosítóit tartalmazó objektumra.

bLocked
[in] Logikai érték, amely meghatározza, hogy az eszköztár zárolva van-e. Ha ez a paraméter, TRUEaz eszköztár zárolva van. Ellenkező esetben az eszköztár nincs zárolva.

Visszaadott érték

Nemzero, ha a módszer sikeres; egyéb esetben 0.

Megjegyzések

Ennek a metódusnak a meghívásával betölthet eszköztárképeket az alkalmazás erőforrásaiból.

`CMFCToolBar::m_dblLargeImageRatio`

Megadja a nagyméretű képek mérete (magassága vagy szélessége) és a normál képek mérete közötti arányt.

AFX_IMPORT_DATA static double m_dblLargeImageRatio;

Megjegyzések

Az alapértelmezett arány 2. Ezt az értéket úgy módosíthatja, hogy nagy eszköztárképek legyenek nagyobbak vagy kisebbek.

A keretrendszer akkor használja ezt az adattagot, ha nem ad meg nagy méretű képeket. Ha például csak a 16x16-os méretű kis képeket adja meg, és azt szeretné, hogy a nagyméretű képek mérete 24x24 legyen, állítsa az adattagot 1,5-ös értékre.

`CMFCToolBar::NextMenu`

virtual BOOL NextMenu();

Visszaadott érték

Megjegyzések

`CMFCToolBar::OnBeforeRemoveButton`

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

Paraméterek

pButton
[in] Használatlan.

dropEffect
[in] Használatlan.

Visszaadott érték

Megjegyzések

`CMFCToolBar::OnChangeHot`

A keretrendszer meghívja, amikor egy felhasználó kiválaszt egy gombot az eszköztáron.

virtual void OnChangeHot(int iHot);

Paraméterek

iHot
[in] A kijelölt eszköztárgomb indexét adja meg; vagy -1, ha nincs kijelölve eszköztárgomb.

Megjegyzések

A metódus felülbírálása az olyan értesítések feldolgozásához, amelyeken a felhasználó kiválasztott egy gombot az eszköztáron.

`CMFCToolBar::OnChangeVisualManager`

virtual void OnChangeVisualManager();

Megjegyzések

`CMFCToolBar::OnFillBackground`

A keretrendszer CBasePane::DoPaint meghívta, hogy kitöltse az eszköztár hátterét.

virtual void OnFillBackground(CDC* pDC);

Paraméterek

pDC
[in] Egy eszközkörnyezetre mutató mutató.

Megjegyzések

CMFCToolBar::DoPaint akkor hívja meg ezt a metódust, ha az eszköztár háttere megtelt. Az alapértelmezett implementáció nem végez semmit.

A metódus felülbírálása az egyéni háttér származtatott osztályokban való rajzolásához.

`CMFCToolBar::OnGlobalFontsChanged`

virtual void OnGlobalFontsChanged();

Megjegyzések

`CMFCToolBar::OnReset`

Visszaállítja az eszköztárat az eredeti állapotára.

virtual void OnReset();

Megjegyzések

A metódus felülbírálása az eszköztár alaphelyzetbe állításával kapcsolatos értesítések kezeléséhez.

Az alapértelmezett implementáció nem végez semmit. Felülbírálás OnReset egy olyan osztályban, amely abból CMFCToolBar származik, hogy az eszköztáron vannak olyan próbagombok, amelyeket az eszköztár eredeti állapotba való visszatérésekor kell lecserélni.

`CMFCToolBar::OnSetAccData`

virtual BOOL OnSetAccData(long lVal);

Paraméterek

[in] lVal

Visszaadott érték

Megjegyzések

`CMFCToolBar::OnSetDefaultButtonText`

Visszaállítja egy eszköztárgomb szövegét az alapértelmezett állapotba.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

Paraméterek

pButton
[in] Egy olyan gombra mutat, amelynek a szövege be van állítva.

Visszaadott érték

TRUE ha a szöveg visszaállítása sikeresen megtörtént; egyéb esetben FALSE.

Megjegyzések

Bírálja felül ezt a metódust az olyan értesítések feldolgozásához, amelyek szerint az eszköztárgomb szövege az alapértelmezettre módosul.

Az alapértelmezett implementáció betölti egy gomb szövegét az alkalmazás erőforrásaiból.

`CMFCToolBar::OnUserToolTip`

A keretrendszer meghívja, amikor megjelenik egy gomb elemleírása.

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

Paraméterek

pButton
[in] Egy eszköztárgombra mutat, amelynek elemleírását meg kell jeleníteni.

strTTText
[kifelé] Az elemleírás szövegét fogadó objektumra mutató hivatkozás CString .

Visszaadott érték

TRUE ha strTTText elemleírás-szöveggel lett kitöltve; ellenkező esetben FALSE.

Megjegyzések

A keretrendszer ezt a metódust hívja meg, amikor megjelenik egy eszköztárgomb elemleírása. Ha OnUserToolTip visszaadjaTRUE, a keretrendszer egy elemleírást jelenít meg, amely tartalmazza a következőben OnUserToolTipvisszaadott strTTText szöveget: . Ellenkező esetben az elemleírás tartalmazza a gomb szövegét.

Felülbírálás OnUserToolTip az eszköztárgombok eszköztippeinek testreszabásához. Az alapértelmezett megvalósítási hívások CMFCToolBar::OnUserToolTip az elemleírás szövegének lekéréséhez.

`CMFCToolBar::PrevMenu`

virtual BOOL PrevMenu();

Visszaadott érték

Megjegyzések

`CMFCToolBar::ProcessCommand`

Üzenet küldése WM_COMMAND az eszköztárat tartalmazó ablakba.

BOOL ProcessCommand(CMFCToolBarButton* pButton);

Paraméterek

pButton
[in] Mutasson az eszköztár egyik gombjára.

Visszaadott érték

Ennek a metódusnak mindig vissza kell térnie TRUE. Az MFC belső értékeket használ FALSE .

Megjegyzések

Ez a metódus egy WM_COMMAND üzenetet jelenít meg az eszköztárat birtokoló ablakba a megadott gomb parancsazonosítójának meghívásával CWnd::PostMessage és paraméterként wParam való átadásával.

Az üzenet tagfüggvényre való leképezéséhez használja a ON_COMMANDWM_COMMAND makrót.

`CMFCToolBar::RemoveAllButtons`

Eltávolítja az összes gombot és elválasztót az eszköztárról.

virtual void RemoveAllButtons();

Megjegyzések

A keretrendszer meghívja ezt a metódust, amikor újra létrehozza vagy megsemmisíti az eszköztárat.

`CMFCToolBar::RemoveButton`

Eltávolítja az eszköztárból azt a gombot, amely a megadott indexet jeleníti meg.

virtual BOOL RemoveButton(int iIndex);

Paraméterek

iIndex
[in] Megadja az eltávolítani kívánt gomb nullaalapú indexét.

Visszaadott érték

TRUE ha a metódus sikeres, vagy FALSE ha a megadott index érvénytelen, vagy az index a Testreszabás gombra hivatkozik.

Megjegyzések

Ez a módszer frissíti a gomb eltávolítása által érintett további eszköztárattribútumokat. Ez a metódus például eltávolítja a nem lényeges elválasztókat az eszköztárból, és újraépíti a billentyűparancsok táblázatát.

A Testreszabás gombbal kapcsolatos további információkért lásd: CMFCToolBar::EnableCustomizeButton.

`CMFCToolBar::RemoveStateFromRegistry`

Törli az eszköztár állapotadatait a Windows beállításjegyzékéből.

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

Paraméterek

lpszProfileName
[in] Megadja azt a beállításkulcsot, ahol az állapotinformációk találhatók.

nIndex
[in] Az eszköztár vezérlőazonosítója.

uiID
[in] Az eszköztár erőforrás-azonosítója. Ha ez a paraméter -1, ez a metódus az CWnd::GetDlgCtrlID erőforrás-azonosító lekérésére használja a metódust.

Visszaadott érték

Nemzero, ha a módszer sikeres; egyéb esetben 0.

Megjegyzések

A keretrendszer meghívja ezt a metódust, amikor töröl egy felhasználó által definiált eszköztárat.

Bírálja felül ezt a módszert, ha további állapotinformációkat tárol a Windows beállításjegyzékében.

`CMFCToolBar::ReplaceButton`

Az eszköztárgombot egy másik eszköztárgombra cseréli.

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

Paraméterek

uiCmd
[in] A lecserélendő gomb parancsazonosítója.

button
[in] A beszúrni kívánt hivatkozás CMFCToolBarButton .

bAll
[in] Logikai érték, amely meghatározza, hogy az összes olyan gombot lecserélje-e, amely rendelkezik a megadott parancsazonosítóval uiCmd. Ha ez a paraméter, TRUEa rendszer minden olyan gombot lecserél, amely rendelkezik a megadott parancsazonosítóval. Ellenkező esetben az első gomb lecserélődik.

Visszaadott érték

A lecserélt gombok száma. Ez a metódus 0 értéket ad vissza, ha a megadott parancsazonosítóval rendelkező gomb nem létezik az eszköztáron.

Megjegyzések

Ezt a metódust akkor hívja meg, ha olyan eszköztárgombokat szeretne hozzáadni, amelyek nem tölthetők be az erőforrásokból. Az eszköztár inicializálásakor létrehozhat egy helyőrző gombot, és lecserélheti azt egy egyéni gombra. Tekintse meg a VisualStudioDemo mintát egy, a metódust használó példában.

példa

Az alábbi példa bemutatja, hogyan használható a ReplaceButton metódus a CMFCToolBar osztályban. Ez a kódrészlet a IE Demo mintarésze.

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`

Visszaállítja az összes eszköztárat az eredeti állapotára.

static void __stdcall ResetAll();

Megjegyzések

Ez a metódus meghívja a metódust az CMFCToolBar::RestoreOriginalState alkalmazás minden egyes eszköztárán, amely visszaállítható. Ezzel a CMFCToolBar::CanBeRestored módszerrel állapítja meg, hogy visszaállítható-e az eszköztár.

`CMFCToolBar::ResetAllImages`

Törli az alkalmazás összes eszköztárképgyűjteményét.

static void __stdcall ResetAllImages();

Megjegyzések

Ez a metódus törli azokat a képgyűjteményeket, amelyeket a CMFCToolBar::LoadToolBar metódusok inicializálnak CMFCToolBar::LoadBitmap .

`CMFCToolBar::ResetImages`

virtual void ResetImages();

Megjegyzések

`CMFCToolBar::RestoreFocus`

virtual void RestoreFocus();

Megjegyzések

`CMFCToolBar::RestoreOriginalState`

Visszaállítja az eszköztár eredeti állapotát.

virtual BOOL RestoreOriginalState();

Visszaadott érték

TRUE ha a metódus sikeres, vagy FALSE ha a metódus sikertelen, vagy az eszköztár felhasználó által definiált.

Megjegyzések

Ez a metódus betölti az eszköztárat az erőforrásfájlból a CMFCToolBar::LoadToolBar metódus használatával.

A keretrendszer akkor hívja meg ezt a metódust, ha a felhasználó a testreszabási párbeszédpanel Eszköztárak lapján az Összes visszaállítása gombot választja.

`CMFCToolBar::SaveParameters`

static BOOL __stdcall SaveParameters(LPCTSTR lpszProfileName = NULL);

Paraméterek

[in] lpszProfileName

Visszaadott érték

Megjegyzések

`CMFCToolBar::SaveState`

Menti az eszköztár állapotadatait a Windows beállításjegyzékében.

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

Paraméterek

lpszProfileName
[in] A Windows beállításkulcs relatív elérési útját adja meg.

nIndex
[in] Az eszköztár vezérlőazonosítója.

uiID
[in] Az eszköztár erőforrás-azonosítója.

Visszaadott érték

Nemzero, ha a módszer sikeres; egyéb esetben 0.

Megjegyzések

A keretrendszer meghívja ezt a metódust, amikor menti az alkalmazás állapotát a beállításjegyzékbe. További információért lásd CWinAppEx::SaveState.

`CMFCToolBar::SetBasicCommands`

Beállítja azoknak a parancsoknak a listáját, amelyek mindig megjelennek, amikor egy felhasználó megnyitja a menüt.

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

Paraméterek

lstCommands
[in] Parancsgyűjteményt CList tartalmazó objektumra mutató hivatkozás.

Megjegyzések

A menü megnyitásakor mindig megjelenik egy egyszerű parancs. Ez a módszer akkor hasznos, ha a felhasználó úgy dönt, hogy megtekinti a legutóbb használt parancsokat.

Ezzel a CMFCToolBar::AddBasicCommand módszerrel adhat hozzá egy parancsot az alapszintű parancsok listájához. Ezzel a CMFCToolBar::GetBasicCommands módszerrel lekérheti az alkalmazás által használt alapvető parancsok listáját.

Az Explorer-mintában talál egy példát, amely ezt a módszert használja.

`CMFCToolBar::SetButtonInfo`

Beállítja egy eszköztárgomb parancsazonosítóját, stílusát és képazonosítóját.

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

Paraméterek

nIndex
[in] Annak a gombnak a nullaalapú indexe, amelynek a tulajdonságai be vannak állítva.

nID
[in] A gomb parancsazonosítója.

nStyle
[in] A gomb stílusa. Az elérhető eszköztárgombstílusok listáját az eszköztár vezérlőelem-stílusai között találja.

iImage
[in] A gomb nulla alapú képindexe (vagyis az eszköztárképek gyűjteményének indexe).

Megjegyzések

Az eszköztárgomb tulajdonságainak beállításához hívja meg ezt a metódust.

A hibakeresési buildekben ez a módszer érvényesítési hibát okoz, ha a megadott nIndex index érvénytelen.

Hívja meg a metódust CMFCToolBar::SetButtonStyle , hogy csak a gomb stílusát állítsa be.

`CMFCToolBar::SetButtons`

Beállítja az eszköztár gombjait.

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

Paraméterek

lpIDArray
[in] A beszúrni kívánt gombok parancsazonosítóinak tömbje.

nIDCount
[in] Az elemek száma a következőben lpIDArray: .

bRemapImages
[in] Logikai érték, amely meghatározza, hogy a meglévő gombképeket társítja-e a beszúrt gombokkal. Ha ez a paraméter, TRUEa rendszer újraképezi a rendszerképeket.

Visszaadott érték

Nemzero, ha a módszer sikeres; egyéb esetben 0.

Megjegyzések

Ezt a metódust meghívva eltávolíthatja a meglévő gombokat az eszköztárból, és beszúrhat egy új gombgyűjteményt.

Ez a módszer hozzáadja a Testreszabás gombot az eszköztárhoz, és elküldi az AFX_WM_RESETTOOLBAR üzenetet az eszköztár szülőablakának. A Testreszabás gombbal kapcsolatos további információkért lásd: CMFCToolBar::EnableCustomizeButton.

`CMFCToolBar::SetButtonStyle`

Beállítja az eszköztár gomb stílusát az adott indexen.

virtual void SetButtonStyle(
    int nIndex,
    UINT nStyle);

Paraméterek

nIndex
[in] Az eszköztárgomb nullaalapú indexe, amelynek stílusát be kell állítani.

nStyle
[in] A gomb stílusa. Az elérhető eszköztárgombstílusok listáját az eszköztár vezérlőelem-stílusai között találja.

Megjegyzések

Ez a módszer eltávolítja a TBBS_PRESSED stílust, ha nStyle az azért van, TBBS_DISABLED mert a felhasználó nem tud letiltott gombot választani.

`CMFCToolBar::SetButtonText`

Beállítja egy eszköztárgomb szövegfeliratát.

BOOL SetButtonText(
    int nIndex,
    LPCTSTR lpszText);

Paraméterek

nIndex
[in] Az eszköztár gomb indexe.

lpszText
[in] Az eszköztár gomb szövegfelirata. Nem null értékűnek kell lennie.

Visszaadott érték

TRUE ha a módszer sikeres; egyéb esetben FALSE.

Megjegyzések

Ez a metódus akkor ad FALSE vissza, ha a megadott index nem érvényes eszköztárgombra hivatkozik.

`CMFCToolBar::SetCommandUsageOptions`

Azt adja meg, hogy a ritkán használt parancsok mikor nem jelennek meg az alkalmazás menüjében.

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

Paraméterek

nStartCount
[in] Megadja, hogy a parancsokat hányszor kell végrehajtani, mielőtt a keretrendszer csak az alapszintű és a legutóbb használt parancsokat jeleníti meg.

nMinUsagePercentage
[in] Az a százalék, amikor egy parancsot végre kell hajtani, hogy a legutóbb használt parancsnak minősüljön.

Visszaadott érték

FALSE ha nMinUsagePercentage 100-nál egyenlő vagy nagyobb; ellenkező esetben TRUE.

Megjegyzések

Ennek a metódusnak a meghívásával testre szabhatja azt az algoritmust, amelyet a keretrendszer használ az alapszintű és a legutóbb használt menüelemek megjelenésének meghatározásához. Az alapszintű parancsokkal kapcsolatos további információkért lásd: CMFCToolBar::AddBasicCommand.

Ez az osztály a CMFCCmdUsageCount parancsok használati számának nyomon követésére használja az osztályt. Az osztályról további információt az Osztály című témakörben találCMFCCmdUsageCount.

`CMFCToolBar::SetCustomizeMode`

Engedélyezi vagy letiltja a testreszabási módot az alkalmazás összes eszköztárán.

static BOOL __stdcall SetCustomizeMode(BOOL bSet=TRUE);

Paraméterek

bSet
[in] Logikai érték, amely meghatározza, hogy engedélyezni vagy letiltani szeretné-e a testreszabási módot. Állítsa be ezt a paramétert a TRUE testreszabási mód engedélyezéséhez vagy FALSE letiltásához.

Visszaadott érték

TRUE ha a metódus meghívása megváltoztatja a testreszabási módot; egyéb esetben FALSE.

Megjegyzések

Ez a metódus módosítja az alkalmazás egyes eszköztárainak elrendezését és újrarajzolását. Hívja meg a CMFCToolBar::IsCustomizeMode metódust annak megállapításához, hogy az alkalmazás testreszabási módban van-e,

`CMFCToolBar::SetGrayDisabledButtons`

Megadja, hogy az eszköztár nem elérhető gombjai halványak-e, vagy hogy a gomb nem érhető el.

void SetGrayDisabledButtons(BOOL bGrayDisabledButtons);

Paraméterek

bGrayDisabledButtons
[in] Logikai érték, amely meghatározza, hogyan jeleníthetők meg a nem elérhető gombok. Ha ez a paraméter, TRUEa keretrendszer elhomályosítja a gombokat. Ellenkező esetben a keretrendszer gomb nem érhető el képek gyűjteményét használja.

Megjegyzések

Alapértelmezés szerint a nem elérhető gombok halványak.

`CMFCToolBar::SetHeight`

Beállítja az eszköztár magasságát.

void SetHeight(int cyHeight);

Paraméterek

cyHeight
[in] Az eszköztár magassága képpontban.

Megjegyzések

Ez a metódus újrarajzozza az eszköztárat a magasság beállítása után.

`CMFCToolBar::SetHelpMode`

static void __stdcall SetHelpMode(BOOL bOn = TRUE);

Paraméterek

[in] bOn

Megjegyzések

`CMFCToolBar::SetHot`

BOOL SetHot(CMFCToolBarButton* pMenuButton);

Paraméterek

[in] pMenuButton

Visszaadott érték

Megjegyzések

`CMFCToolBar::SetHotBorder`

Azt határozza meg, hogy az eszköztárgombok gyakori követésűek-e.

void SetHotBorder(BOOL bShowHotBorder);

Paraméterek

bShowHotBorder
[in] Logikai érték, amely meghatározza, hogy a gyakori követésű eszköztárgombokat kell-e követni. Ha ez a paraméter, TRUEaz eszköztár gyakran nyomon követi a gombjait. Ellenkező esetben az eszköztár nem követi a gombokat.

Megjegyzések

Ha egy gombot gyakran követnek, a keretrendszer kiemeli a gombot, amikor az egér végighalad rajta. Alapértelmezés szerint az egyes eszköztárak gyakran nyomon követik a gombokat.

Hívja meg a CMFCToolBar::GetHotBorder metódust annak meghatározásához, hogy az eszköztár gyakran követi-e a gombokat.

`CMFCToolBar::SetHotTextColor`

A gyakori eszköztárgombok szövegszínét állítja be.

static void SetHotTextColor(COLORREF clrText);

Paraméterek

clrText
[in] A gyakori elérésű eszköztárgombok szövegszínét adja meg.

Megjegyzések

A gyakori követésű eszköztárgombokkal kapcsolatos további információkért lásd CMFCToolBar::GetHotBorder és CMFCToolBar::SetHotBorder.

`CMFCToolBar::SetIgnoreSetText`

void SetIgnoreSetText(BOOL bValue);

Paraméterek

[in] bValue

Megjegyzések

`CMFCToolBar::SetLargeIcons`

Megadja, hogy az eszköztárgombok nagy ikonokat jelenjenek-e meg.

static void SetLargeIcons(BOOL bLargeIcons=TRUE);

Paraméterek

bLargeIcons
[in] Logikai érték, amely meghatározza a használni kívánt ikonokat. Ha ez a paraméter, TRUEa keretrendszer nagyméretű ikonokat jelenít meg. Ellenkező esetben a keretrendszer normál ikonokat jelenít meg.

Megjegyzések

A keretrendszer akkor hívja meg ezt a metódust, ha a felhasználó módosítja a Nagy ikonok állapotát a Testreszabás párbeszédpanel Beállítások lapján. Ez a metódus átméretezi az alkalmazás összes eszköztárát.

Alapértelmezés szerint a keretrendszer normál ikonokat jelenít meg.

A Testreszabás párbeszédpanelről további információt az Osztály című témakörben találCMFCToolBarsCustomizeDialog.

`CMFCToolBar::SetLockedSizes`

Beállítja a zárolt gombok és a zárolt képek méretét az eszköztáron.

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

Paraméterek

sizeButton
[in] A zárolt eszköztárgombok méretét adja meg.

sizeImage
[in] A zárolt eszköztárképek méretét adja meg.

bDontScale
Megadja, hogy nagy DPI-módban skálázza-e vagy sem a zárolt eszköztárképeket.

Megjegyzések

A zárolt gombok alapértelmezett mérete 23x22 képpont. A zárolt képek alapértelmezett mérete 16x15 képpont.

CMFCToolBar::GetLockedImageSize A zárolt képek méretének lekéréséhez hívja meg a metódust. Hívja meg a metódust a CMFCToolBar::GetButtonSize zárolt eszköztárgombok méretének lekéréséhez.

`CMFCToolBar::SetMaskMode`

void SetMaskMode(BOOL bMasked);

Paraméterek

[in] bMasked

Megjegyzések

`CMFCToolBar::SetMenuSizes`

Beállítja az eszköztár menügombjainak és képeinek méretét.

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

Paraméterek

sizeButton
[in] Az eszköztárgombok képpontban kifejezett méretét adja meg.

sizeImage
[in] Az eszköztárképek képpontban kifejezett méretét adja meg.

Megjegyzések

Alapértelmezés szerint a menügombok és a hozzájuk tartozó képek mérete nem definiált.

Hívja meg a metódust CMFCToolBar::GetMenuButtonSize a menügombok méretének meghatározásához és a CMFCToolBar::GetMenuImageSize menügombok lemezképeinek méretének meghatározásához.

A módszert használó példákért tekintse meg az IEDemo és az MSMoneyDemo mintákat.

`CMFCToolBar::SetNonPermittedCommands`

Beállítja azoknak a parancsoknak a listáját, amelyeket a felhasználó nem hajthat végre.

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

Paraméterek

lstCommands
[in] Olyan objektumra CList mutató hivatkozás, amely tartalmazza a felhasználó által nem végrehajtható parancsokat.

Megjegyzések

Ennek a metódusnak a meghívásával megakadályozhatja, hogy a felhasználó bizonyos parancsokat válasszon. Előfordulhat például, hogy biztonsági okokból meg szeretné akadályozni, hogy a felhasználó bizonyos parancsokat válasszon. A metódust használó példákért tekintse meg az MDITabsDemo és a MenuSubSet mintákat.

Ez a metódus törli a nem engedélyezett parancsok előző listáját. Alapértelmezés szerint a nem engedélyezett parancsok listája üres.

`CMFCToolBar::SetOneRowWithSibling`

Az eszköztár és a testvére ugyanabban a sorban van elhelyezve.

void SetOneRowWithSibling();

Megjegyzések

A keretrendszer akkor hívja meg ezt a metódust, ha a felhasználó a Gombok megjelenítése egy sorban gombot választja.

Hívja meg a CMFCToolBar::SetSiblingToolBar metódust, hogy engedélyezze a Gombok megjelenítése egy sorban vagy a Gomb megjelenítése két sorban gombot. Ha ezt az eszköztárat hívja meg CMFCToolBar::SetSiblingToolBar , a testvér eszköztár az eszköztár sorába kerül. Ellenkező esetben ez az eszköztár a testvér sorába kerül.

A keretrendszer meghívja a CMFCToolBar::SetTwoRowsWithSibling metódust, amikor a felhasználó kiválasztja a Gombok megjelenítése két sorban gombot.

`CMFCToolBar::SetOrigButtons`

void SetOrigButtons(const CObList& lstOrigButtons);

Paraméterek

[in] lstOrigButtons

Megjegyzések

`CMFCToolBar::SetPermament`

Megadja, hogy egy felhasználó bezárhatja-e az eszköztárat.

void SetPermament(BOOL bPermament=TRUE);

Paraméterek

bPermament
[in] Logikai érték, amely meghatározza, hogy egy felhasználó bezárhatja-e az eszköztárat. Ha ez a paraméter, TRUEa felhasználó nem tudja bezárni az eszköztárat. Ellenkező esetben a felhasználó bezárhatja az eszköztárat.

Megjegyzések

Alapértelmezés szerint a felhasználó bezárhatja az egyes eszköztárokat.

Hívja meg a CMFCToolBar::CanBeClosed metódust annak megállapításához, hogy egy felhasználó bezárhatja-e az eszköztárat.

`CMFCToolBar::SetRouteCommandsViaFrame`

Megadja, hogy a szülőkeret vagy a tulajdonos parancsokat küld-e az eszköztárnak.

void SetRouteCommandsViaFrame(BOOL bValue);

Paraméterek

bValue
[in] Ha ez a paraméter, TRUEa szülőkeret parancsokat küld az eszköztárnak. Ellenkező esetben a tulajdonos parancsokat küld az eszköztárra.

Megjegyzések

Alapértelmezés szerint a szülőkeret parancsokat küld az eszköztárnak. Hívja meg a CMFCToolBar::GetRouteCommandsViaFrame metódust annak megállapításához, hogy a szülőkeret vagy a tulajdonos parancsokat küld-e az eszköztárnak.

`CMFCToolBar::SetShowTooltips`

Megadja, hogy a keretrendszer megjelenít-e eszköztippeket.

static void SetShowTooltips(BOOL bValue);

Paraméterek

bValue
[in] Ha ez a paraméter, TRUEa keretrendszer eszköztippeket jelenít meg. Ellenkező esetben a keretrendszer elrejti az eszköztippeket.

Megjegyzések

Alapértelmezés szerint a keretrendszer eszköztippeket jelenít meg.

Hívja meg a CMFCToolBar::GetShowTooltips metódust annak megállapításához, hogy a keretrendszer eszköztippeket jelenít-e meg.

`CMFCToolBar::SetSiblingToolBar`

Az eszköztár testvérét adja meg.

void SetSiblingToolBar(CMFCToolBar* pBrotherToolbar);

Paraméterek

pBrotherToolbar
[in] Egy mutató a testvér eszköztárra.

Megjegyzések

Ez a módszer lehetővé teszi a Gombok megjelenítése egy sorban vagy a Gombok megjelenítése két sorban gombon, amelyek akkor jelennek meg, amikor a felhasználó megjeleníti a Testreszabás előugró menüt. Hívja meg ezt a metódust, ha engedélyezni szeretné a felhasználónak, hogy megadhatja, hogy a kapcsolódó eszköztárak ugyanazon a sorban vagy különböző sorokban jelenjenek-e meg.

Hívja meg ezt a metódust, miután engedélyezte az eszköztáron megjelenő Testreszabás gombot. A Testreszabás gomb engedélyezéséhez hívja meg a metódust CMFCToolBar::EnableCustomizeButton .

Az eszköztár testvérének lekéréséhez hívja fel a következőt CMFCToolBar::GetSiblingToolBar: .

`CMFCToolBar::SetSizes`

A gombok és képek méretét határozza meg az összes eszköztáron.

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

Paraméterek

sizeButton
[in] Az eszköztárgombok mérete képpontban.

sizeImage
[in] Az eszköztár gombképeinek mérete képpontban.

Megjegyzések

Az eszköztárgombok alapértelmezett mérete 23x22 képpont. Az eszköztár gombképeinek alapértelmezett mérete 16x15 képpont.

Hívja meg a metódust az CMFCToolBar::GetImageSize eszköztár gombképeinek méretének lekéréséhez. CMFCToolBar::GetButtonSize Az eszköztárgombok méretének lekéréséhez hívja meg a metódust.

`CMFCToolBar::SetToolBarBtnText`

Egy gomb tulajdonságait adja meg az eszköztáron.

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

Paraméterek

nBtnIndex
[in] Az eszköztárgomb nullaalapú indexe az eszköztárgombok listájában.

szText
[in] Az eszköztár gomb szövegfeliratát adja meg.

bShowText
[in] Ha ez a paraméter, TRUEa keretrendszer megjeleníti a szövegfeliratot. Ellenkező esetben a keretrendszer elrejti a szövegfeliratot.

bShowImage
[in] Ha ez a paraméter, TRUEa keretrendszer megjeleníti az eszköztár gomb képét. Ellenkező esetben a keretrendszer elrejti az eszköztár gomb képét.

Megjegyzések

A keretrendszer alapértelmezés szerint az eszköztárgombok képeit jeleníti meg, de nem jeleníti meg az eszköztárgombok szövegfeliratát.

A hibakeresési buildekben ez a módszer érvényesítési hibát okoz, ha nBtnIndex nem érvényes eszköztárgombra hivatkozik, vagy ha az eszköztár gomb elválasztó.

`CMFCToolBar::SetTwoRowsWithSibling`

Az eszköztárat és annak testvérét külön sorokra osztva pozja.

void SetTwoRowsWithSibling();

Megjegyzések

A keretrendszer meghívja ezt a metódust, amikor a felhasználó kiválasztja a Gombok megjelenítése két sorban gombot.

Hívja meg a CMFCToolBar::SetSiblingToolBar metódust, hogy engedélyezze a Gombok megjelenítése egy sorban vagy a Gomb megjelenítése két sorban gombot. Ha ezt az eszköztárat hívja meg CMFCToolBar::SetSiblingToolBar , a testvér eszköztár egy külön sorba kerül. Ellenkező esetben ez az eszköztár egy külön sorba kerül.

A keretrendszer meghívja a CMFCToolBar::SetOneRowWithSibling metódust, amikor a felhasználó kiválasztja a Gombok megjelenítése egy sorban gombot.

`CMFCToolBar::SetUserImages`

Beállítja a felhasználó által definiált képek gyűjteményét az alkalmazásban.

static BOOL SetUserImages(CMFCToolBarImages* pUserImages);

Paraméterek

pUserImages
[in] A felhasználó által definiált képek gyűjteményére mutató mutató.

Visszaadott érték

Nemzero, ha a módszer sikeres; ellenkező esetben 0, ha a megadott CMFCToolBarImages objektum érvénytelen, vagy az eszköztár alapértelmezett képméretétől eltérő képméretű.

Megjegyzések

A keretrendszer felhasználó által definiált rendszerképekkel rajzolja meg a felhasználó által testre szabott eszköztárgombokat. A megadott pUserImages képlista meg van osztva az alkalmazás összes eszköztára között.

Ez a módszer helyességi hibát okoz a hibakeresési buildekben, ha a megadott CMFCToolBarImages objektum érvénytelen, vagy az eszköztár alapértelmezett képméretétől eltérő képméretű.

Az OutlookDemo, az ToolTipDemo és a VisualStudioDemo minták ezzel a módszerrel állítják be a felhasználó által definiált képek globális gyűjteményét. Betöltik a UserImages.bmpnevű fájlt, amely az alkalmazás munkakönyvtárában található.

Hívja meg a metódust CMFCToolBar::GetUserImages a felhasználó által definiált képek gyűjteményének lekéréséhez az alkalmazásban.

`CMFCToolBar::StretchPane`

Függőlegesen vagy vízszintesen nyújtja az eszköztárat, és szükség esetén áthelyezi a gombokat.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Paraméterek

nLength
[in] Az az összeg képpontban, amellyel kinyújthatja a panelt.

bVert
[in] Ha TRUE, függőlegesen feszíti ki a panelt. Ha FALSE, vízszintesen nyújtja a panelt.

Visszaadott érték

Az CSize eszköztár ügyfélterületének méretét meghatározó objektum.

Megjegyzések

Ez a metódus meghívja CMFCToolBar::WrapToolBar a gombok áthelyezését a kifeszített eszköztáron belül.

A visszatérési érték a hívással CMFCToolBar::CalcSizehatározható meg.

`CMFCToolBar::TranslateChar`

Gombparancsot hajt végre, ha a megadott kulcskód érvényes billentyűparancsnak felel meg.

virtual BOOL TranslateChar(UINT nChar);

Paraméterek

nChar
[in] Egy virtuális kulcs kódját adja meg. A szabványos virtuális kulcskódok listáját lásd: Winuser.h

Visszaadott érték

FALSE ha a megadott kulcskód nyomtathatatlan, vagy nem felel meg érvényes billentyűparancsnak; TRUE ha a megadott kulcskód egy legördülő menübeállításnak felel meg, ellenkező esetben a visszatérési érték a következőből: CMFCToolBar::ProcessCommand.

Megjegyzések

A keretrendszer akkor hívja meg ezt a metódust, ha egy kulcs az Alt billentyűvel együtt van lenyomva.

`CMFCToolBar::UpdateButton`

Frissíti a megadott gomb állapotát.

void UpdateButton(int nIndex);

Paraméterek

nIndex
[in] A frissíteni kívánt gomb nulla alapú indexét adja meg.

Megjegyzések

`CMFCToolBar::WrapToolBar`

Áthelyezi az eszköztárgombokat a megadott dimenziókban.

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

Paraméterek

nWidth
[in] Az eszköztár maximális szélessége.

nHeight
[in] Az eszköztár maximális magassága. Nem használható, ha az eszköztár lebegő.

pDC
[in] Mutasson egy eszközkörnyezetre. Ha NULLaz eszköztár eszközkörnyezetét használja a rendszer.

nColumnWidth
[in] Gombszélesség. Ha -1, a rendszer az aktuális szélességet használja.

[in] mnRowHeight Gombmagasság. Ha -1, a rendszer az aktuális magasságot használja.

Visszaadott érték

Az eszköztár gombsorainak száma.

Megjegyzések

Ez a metódus áthelyezi a gombokat az eszköztáron belül, és szükség esetén további sorokba tördeli a gombokat.

`CMFCToolBar::m_bDontScaleImages`

Megadja, hogy az eszköztárképek nagy DPI-módban skálázhatók-e. Úgy van beállítva, hogy TRUE megakadályozza a képméretezést, ha egy képméret nem egyezik meg a gomb méretével.

AFX_IMPORT_DATA static BOOL m_bDontScaleImages;

Lásd még

hierarchiadiagram
osztályok
CMFCMenuBar osztály
CMFCPopupMenuBar osztály
CMFCDropDownToolBar osztály
Útmutató: Vezérlők elhelyezése eszköztárakon

Visszacsatolás

Hasznos volt ez az oldal?

Last updated on 2025-11-07

Megosztás:

CMFCToolBar osztály

Szemantika

Tagok

Nyilvános konstruktorok

Nyilvános metódusok

Védett metódusok

Adattagok

Megjegyzések

példa

Követelmények

Öröklési hierarchia

CMFCToolBar::AddBasicCommand

Paraméterek

Megjegyzések

CMFCToolBar::AddCommandUsage

Paraméterek

Megjegyzések

CMFCToolBar::AddToolBarForImageCollection

Paraméterek

Visszaadott érték

Megjegyzések

CMFCToolBar::AdjustLayout

Megjegyzések

CMFCToolBar::AdjustSize

Megjegyzések

CMFCToolBar::AllowChangeTextLabels

Visszaadott érték

Megjegyzések

CMFCToolBar::AllowShowOnList

Visszaadott érték

Megjegyzések

CMFCToolBar::AreTextLabels

Visszaadott érték

Megjegyzések

CMFCToolBar::AutoGrayInactiveImages

Paraméterek

Megjegyzések

CMFCToolBar::ButtonToIndex

Paraméterek

Visszaadott érték

CMFCToolBar::CalcFixedLayout

Paraméterek

Visszaadott érték

Megjegyzések

CMFCToolBar::CalcMaxButtonHeight

Visszaadott érték

Megjegyzések

CMFCToolBar::CalcSize

Paraméterek

Visszaadott érték

Megjegyzések

CMFCToolBar::CanBeClosed

Visszaadott érték

Megjegyzések

CMFCToolBar::CanBeRestored

Visszaadott érték

Megjegyzések

CMFCToolBar::CanFocus

Visszaadott érték

Megjegyzések

CMFCToolBar::CanHandleSiblings

Visszaadott érték

Megjegyzések

CMFCToolBar::CleanUpImages

Megjegyzések

CMFCToolBar::CleanUpLockedImages

Megjegyzések

CMFCToolBar::CommandToIndex

Paraméterek

Visszaadott érték

Megjegyzések

CMFCToolBar::Create

Paraméterek

Visszaadott érték

Megjegyzések

CMFCToolBar::CreateEx

Paraméterek

Visszaadott érték

Megjegyzések

`CMFCToolBar` osztály

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