CMFCToolBarButton osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Gombfunkciókat biztosít az eszköztárakhoz.

Szemantika

class CMFCToolBarButton : public CObject

Tagok

Nyilvános konstruktorok

Név	Description
CMFCToolBarButton::CMFCToolBarButton	Objektumok létrehozása és inicializálása CMFCToolBarButton .
CMFCToolBarButton::~CMFCToolBarButton	Destruktor.

Nyilvános metódusok

Név	Description
CMFCToolBarButton::CanBeDropped	Megadja, hogy a felhasználó elhelyezhet-e gombot egy eszköztáron vagy menüben a testreszabás során.
CMFCToolBarButton::CanBeStored	Megadja, hogy a gomb tárolható-e.
CMFCToolBarButton::CanBeStretched	Megadja, hogy a felhasználó ki tudja-e húzni a gombot a testreszabás során.
CMFCToolBarButton::CompareWith	Összehasonlítja ezt a példányt a megadott CMFCToolBarButton objektummal.
CMFCToolBarButton::CopyFrom	Másolja egy másik eszköztárgomb tulajdonságait az aktuális gombra.
CMFCToolBarButton::CreateFromOleData	Objektumot CMFCToolBarButton hoz létre a megadott COleDataObject objektumból.
CMFCToolBarButton::CreateObject	A keretrendszer egy ilyen típusú dinamikus példány létrehozásához használja.
CMFCToolBarButton::EnableWindow	Engedélyezi vagy letiltja az egér- és billentyűzetbemenetet.
CMFCToolBarButton::ExportToMenuButton	Szöveg másolása az eszköztár gombjáról egy menübe.
CMFCToolBarButton::GetClipboardFormat	Lekéri az alkalmazás globális vágólapformátumát.
CMFCToolBarButton::GetHwnd	Lekéri az eszköztárgombhoz társított ablakfogópontot.
CMFCToolBarButton::GetImage	Lekéri a gomb képindexét.
CMFCToolBarButton::GetInvalidateRect	A gomb ügyfélterületének régióját kéri le, amelyet újra kell helyezni.
CMFCToolBarButton::GetParentWnd	Lekéri a gomb szülőablakát.
CMFCToolBarButton::GetProtectedCommands	Lekéri a felhasználó által nem testre szabható parancsok listáját.
CMFCToolBarButton::GetTextSize	Lekéri a gomb szövegének méretét.
CMFCToolBarButton::HasFocus	Meghatározza, hogy a gomb rendelkezik-e az aktuális bemeneti fókuszsal.
CMFCToolBarButton::HaveHotBorder	Meghatározza, hogy megjelenik-e a gomb szegélye, amikor egy felhasználó kiválasztja a gombot.
CMFCToolBarButton::IsDrawImage	Meghatározza, hogy megjelenik-e kép a gombon.
CMFCToolBarButton::IsDrawText	Meghatározza, hogy megjelenik-e szövegfelirat a gombon.
CMFCToolBarButton::IsDroppedDown	Meghatározza, hogy a gomb megjelenít-e egy almenüt.
CMFCToolBarButton::IsEditable	Meghatározza, hogy a gomb testre szabható-e.
CMFCToolBarButton::IsExtraSize	Meghatározza, hogy a gomb megjeleníthető-e kiterjesztett szegélylel.
CMFCToolBarButton::IsFirstInGroup	Meghatározza, hogy a gomb a gombcsoport első helyén van-e.
CMFCToolBarButton::IsHidden	Meghatározza, hogy a gomb rejtett-e.
CMFCToolBarButton::IsHorizontal	Meghatározza, hogy a gomb vízszintes eszköztáron található-e.
CMFCToolBarButton::IsLastInGroup	Megadja, hogy a gomb a gombcsoport utolsó helyén van-e.
CMFCToolBarButton::IsLocked	Meghatározza, hogy a gomb zárolt (nem testreszabható) eszköztáron van-e.
CMFCToolBarButton::IsOwnerOf	Meghatározza, hogy a gomb a megadott ablakfogópont tulajdonosa-e.
CMFCToolBarButton::IsVisible	Meghatározza, hogy az eszköztár gomb látható-e.
CMFCToolBarButton::IsWindowVisible	Meghatározza, hogy a gomb alapjául szolgáló ablakfogópont látható-e.
CMFCToolBarButton::NotifyCommand	Megadja, hogy a gomb feldolgozza-e a WM_COMMAND üzenetet.
CMFCToolBarButton::OnAddToCustomizePage	A keretrendszer meghívja, amikor a gomb hozzáadódik a Testreszabás párbeszédpanelhez.
CMFCToolBarButton::OnBeforeDrag	Megadja, hogy a gomb húzható-e.
CMFCToolBarButton::OnBeforeDrop	Megadja, hogy a felhasználó a gombot a célpultra helyezheti-e.
CMFCToolBarButton::OnCalculateSize	A keretrendszer meghívta, hogy kiszámítsa a gomb méretét a megadott eszközkörnyezethez és a rögzítési állapothoz.
CMFCToolBarButton::OnCancelMode	A keretrendszer meghívta a WM_CANCELMODE üzenet kezelésére.
CMFCToolBarButton::OnChangeParentWnd	A keretrendszer meghívta, amikor a gomb be van szúrva egy új eszköztárba.
CMFCToolBarButton::OnClick	A keretrendszer meghívja, amikor a felhasználó az egérgombra kattint.
CMFCToolBarButton::OnClickUp	A keretrendszer meghívja, amikor a felhasználó felengedi az egérgombot.
CMFCToolBarButton::OnContextHelp	A keretrendszer meghívja, amikor a szülő eszköztár egy WM_HELPHITTEST üzenetet kezel.
CMFCToolBarButton::OnCtlColor	A keretrendszer meghívja, amikor a szülő eszköztár egy WM_CTLCOLOR üzenetet kezel.
CMFCToolBarButton::OnCustomizeMenu	Lehetővé teszi, hogy a gomb módosítsa a megadott menüt, amikor az alkalmazás megjelenít egy helyi menüt a szülőpulton.
CMFCToolBarButton::OnDblClk	A keretrendszer meghívja, amikor a szülőpult egy WM_LBUTTONDBLCLK üzenetet kezel.
CMFCToolBarButton::OnDraw	A keretrendszer meghívta, hogy a megadott stílusok és beállítások használatával rajzolja meg a gombot.
CMFCToolBarButton::OnDrawOnCustomizeList	A keretrendszer meghívta, hogy rajzolja meg a gombot a Testreszabás párbeszédpanel Parancsok panelén.
CMFCToolBarButton::OnGetCustomToolTipText	A keretrendszer meghívta a gomb egyéni elemleírás-szövegének lekéréséhez.
CMFCToolBarButton::OnGlobalFontsChanged	A keretrendszer meghívta, amikor a globális betűtípus megváltozott.
CMFCToolBarButton::OnMove	A keretrendszer meghívta a szülő eszköztár áthelyezésekor.
CMFCToolBarButton::OnShow	A keretrendszer meghívja, amikor a gomb láthatóvá vagy láthatatlanná válik.
CMFCToolBarButton::OnSize	A keretrendszer meghívja, amikor a szülőpult módosítja a méretét vagy a pozícióját, és ehhez a módosításhoz a gombnak módosítania kell a méretet.
CMFCToolBarButton::OnToolHitTest	A keretrendszer meghívja, amikor a szülő eszköztárnak meg kell határoznia, hogy egy pont a gomb határoló téglalapjában van-e.
CMFCToolBarButton::OnUpdateToolTip	A keretrendszer meghívta, amikor a szülő eszköztár frissíti az elemleírás szövegét.
CMFCToolBarButton::P repareDrag	A keretrendszer meghívja, amikor a gomb húzási műveletet hajt végre.
CMFCToolBarButton::Rect	Lekéri a gomb határolókeretét.
CMFCToolBarButton::ResetImageToDefault	Beállítja a gombhoz társított kép alapértelmezett értékét.
CMFCToolBarButton::SaveBarState	Menti az eszköztár állapotát.
CMFCToolBarButton::Szerializálás	Beolvassa ezt az objektumot egy archívumból, vagy egy archívumba írja. (Felülbírálja a CObject::Serialize parancsot.)
CMFCToolBarButton::SetACCData	Kitölti a megadott CAccessibilityData objektumot az eszköztár gomb akadálymentességi adataival.
CMFCToolBarButton::SetClipboardFormatName	Átnevezi a globális vágólap formátumát.
CMFCToolBarButton::SetImage	Beállítja a gomb képindexét.
CMFCToolBarButton::SetProtectedCommands	Beállítja a felhasználó által nem testre szabható parancsok listáját.
CMFCToolBarButton::SetRadio	A keretrendszer meghívja, amikor egy gomb módosítja az ellenőrzött állapotát.
CMFCToolBarButton::SetRect	Beállítja a gomb határoló téglalapját.
CMFCToolBarButton::SetStyle	Beállítja a gomb stílusát.
CMFCToolBarButton::SetVisible	Megadja, hogy a gomb látható-e.
CMFCToolBarButton::Show	Megjeleníti vagy elrejti a gombot.

Adattagok

Név	Description
CMFCToolBarButton::m_bImage	Megadja, hogy megjelenik-e kép a gombon.
CMFCToolBarButton::m_bText	Megadja, hogy megjelenik-e szövegfelirat a gombon.
CMFCToolBarButton::m_bTextBelow	Megadja, hogy a szövegcímke megjelenjen-e a gomb képe alatt.
CMFCToolBarButton::m_bUserButton	Megadja, hogy a gomb rendelkezik-e felhasználó által definiált lemezképpel.
CMFCToolBarButton::m_bWholeText	Megadja, hogy a gomb megjelenítse-e a teljes szöveges címkét, még akkor is, ha nem fér el a határolókeretben.
CMFCToolBarButton::m_bWrap	Megadja, hogy az elválasztó gomb a következő sorra kerül-e.
CMFCToolBarButton::m_bWrapText	Megadja, hogy engedélyezve vannak-e a többsoros szövegfeliratok.
CMFCToolBarButton::m_nID	A gomb parancsazonosítója.
CMFCToolBarButton::m_nStyle	A gomb stílusa.
CMFCToolBarButton::m_strText	A gomb szövegfelirata.

Megjegyzések

Az CMFCToolbarButton objektumok olyan vezérlők, amelyek egy eszköztáron találhatók. Viselkedése egy szokásos gombhoz hasonlít. Ehhez az objektumhoz hozzárendelhet egy képet és egy szövegfeliratot. Az eszköztárgombok parancsazonosítóval is rendelkezhetnek. Amikor a felhasználó az eszköztár gombra kattint, a keretrendszer végrehajtja az azonosító által megadott parancsot.

Az eszköztárgombok általában testre szabhatók: a felhasználó áthúzhatja a gombokat az egyik eszköztárról a másikra, és szövegfeliratokat és képeket másolhat, beilleszthet, törölhet és szerkeszthet. Ha meg szeretné akadályozni, hogy a felhasználó testre szabja az eszköztárat, kétféleképpen zárolhatja az eszköztárat. Állítsa a bLocked jelölőt IGAZ értékre a CMFCToolBar::LoadToolBar hívásakor, vagy adja hozzá egy adott gomb parancsazonosítóját a védett parancsok globális listájához a CMFCToolBarButton::SetProtectedCommands metódussal.

CMFCToolBarButton az objektumok az alkalmazás eszköztárképeinek globális gyűjteményéből származó képeket jelenítik meg. Ezeket a gyűjteményeket a CMFCToolBar osztály szülő eszköztára tartja karban. További információ: CMFCToolBarImages osztály.

Amikor a felhasználó egy eszköztár gombra kattint, a szülőpult feldolgozza az egérüzenetet, és közli a megfelelő műveleteket a gombbal. Ha a gomb érvényes parancsazonosítóval rendelkezik, a szülő eszköztár elküldi a WM_COMMAND üzenetet a szülőkeretnek.

Az CMFCToolBarButton osztály más eszköztárgombosztályok, például CMFCToolBarMenuButton osztály, CMFCToolBarEditBoxButton osztály és CMFCToolBarComboBoxButton osztály alaposztálya.

Example

Az alábbi példa bemutatja, hogyan konfigurálhat egy objektumot CMFCToolBarButton az CMFCToolBarButton osztály különböző metódusaival. A példa bemutatja, hogyan engedélyezheti az egér- és billentyűzetbemenetet, hogyan állíthatja be a gomb képindexét, állíthatja be a gomb határoló téglalapját, és hogyan teheti láthatóvá a gombot. Ez a kódrészlet a Tab Control-minta része.

CMFCToolBarButton *pOffice2007 = NULL;
int nIndex = -1;

for (UINT uiCmd = ID_VIEW_APPLOOK_2007_1; uiCmd <= ID_VIEW_APPLOOK_2007_4; uiCmd++)
{
   // CMFCToolBar m_wndToolBarTheme
   nIndex = m_wndToolBarTheme.CommandToIndex(uiCmd);

   CMFCToolBarButton *pButton = m_wndToolBarTheme.GetButton(nIndex);

   if (pButton != NULL)
   {
      pOffice2007 = pButton;
      break;
   }
}

pOffice2007->EnableWindow();
pOffice2007->SetImage(1);
pOffice2007->SetRect(CRect(1, 1, 1, 1));
pOffice2007->SetVisible();
pOffice2007->Show(true);

Öröklési hierarchia

CObject

CMFCToolBarButton

Requirements

Fejléc: afxtoolbarbutton.h

CMFCToolBarButton::CanBeDropped

Megadja, hogy a felhasználó elhelyezhet-e gombot egy eszköztáron vagy menüben a testreszabás során.

virtual BOOL CanBeDropped(CMFCToolBar* pToolbar);

Paraméterek

pToolbar
[in] Használatlan.

Visszaadott érték

Ez a metódus IGAZ értéket ad vissza.

Megjegyzések

Alapértelmezés szerint minden testre szabható (vagyis nem zárolt) eszköztárra el lehet dobni egy eszköztárgombot.

A metódus alapértelmezett implementációja IGAZ értéket ad vissza. Bírálja felül ezt a módszert, és adja vissza a HAMIS értéket, ha meg szeretné akadályozni, hogy a felhasználó áthelyezze a gombot.

CMFCToolBarButton::CanBeStored

Meghatározza, hogy a gomb tárolható-e.

virtual BOOL CanBeStored() const;

Visszaadott érték

Ez a metódus IGAZ értéket ad vissza.

Megjegyzések

A keretrendszer ezzel a módszerrel határozza meg, hogy a gomb részt vehet-e egy húzási műveletben.

Az alapértelmezett implementáció IGAZ értéket ad vissza. Bírálja felül ezt a módszert, ha a gomb nem tárolható húzási művelet részeként. A húzással kapcsolatos műveletekről további információt az OLE húzással és húzással kapcsolatos cikkben talál.

CMFCToolBarButton::CanBeStretched

Megadja, hogy a felhasználó ki tudja-e húzni a gombot a testreszabás során.

virtual BOOL CanBeStretched() const;

Visszaadott érték

Ez a metódus HAMIS értéket ad vissza.

Megjegyzések

A keretrendszer ezt a módszert használja annak meghatározására, hogy a gomb testre szabási módban nyújtható-e.

A metódus alapértelmezett implementációja HAMIS értéket ad vissza. Bírálja felül ezt a metódust, hogy igaz értéket adjon vissza egy változó szélességű vezérlőelemhez, például kombinált lista vagy csúszka esetén.

A testreszabási módról további információt a CMFCToolBar::SetCustomizeMode című témakörben talál.

CMFCToolBarButton::CMFCToolBarButton

Objektumok létrehozása és inicializálása CMFCToolBarButton .

CMFCToolBarButton(
    UINT uiID,
    int iImage,
    LPCTSTR lpszText=NULL,
    BOOL bUserButton=FALSE,
    BOOL bLocked=FALSE);

Paraméterek

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

iImage
[in] A képgyűjteményben lévő gomb képindexe.

lpszText
[in] A gomb szövegfelirata. Null érték is lehet.

bUserButton
[in] Logikai érték, amely meghatározza, hogy a gomb felhasználó által definiált-e. Ha ez a paraméter IGAZ, a gomb felhasználó által definiált. Ellenkező esetben a gomb képe egy erőforrásból töltődik be.

Blokkolt
[in] Logikai érték, amely meghatározza, hogy a gomb testre szabható-e. Ha ez a paraméter IGAZ, a gomb nem szabható testre. Ellenkező esetben a gomb testre szabható.

CMFCToolBarButton::CompareWith

Összehasonlítja ezt a példányt a megadott CMFCToolBarButton objektummal.

virtual BOOL CompareWith(const CMFCToolBarButton& other) const;

Paraméterek

más
[in] Hivatkozás a példányhoz hasonlítandó objektumra.

Visszaadott érték

Nonzero, ha a megadott objektum megegyezik a példány értékével; ellenkező esetben 0.

Megjegyzések

Az alapértelmezett implementáció határozza meg, hogy a megadott objektum parancsazonosítója megegyezik-e a példány parancsazonosítójával. Bírálja felül ezt a módszert, ha további feldolgozást kell végeznie annak megállapításához, hogy két CMFCToolBarButton objektum egyenlő-e.

CMFCToolBarButton::CopyFrom

Másolja egy másik eszköztárgomb tulajdonságait az aktuális gombra.

virtual void CopyFrom(const CMFCToolBarButton& src);

Paraméterek

Src
[in] Hivatkozás arra a forrásgombra, amelyről a másolást el szeretné készíteni.

Megjegyzések

Hívja meg ezt a metódust egy másik eszköztárgomb másolásához ehhez az eszköztárgombhoz.

CMFCToolBarButton::CreateFromOleData

Objektumot CMFCToolBarButton hoz létre a megadott COleDataObject objektumból.

static CMFCToolBarButton* __stdcall CreateFromOleData(COleDataObject* pDataObject);

Paraméterek

pDataObject
[in] A forrás OLE adatobjektum.

Visszaadott érték

A létrehozott CMFCToolBarButton objektum.

Megjegyzések

Ezt a módszert a keretrendszer különböző formátumokban történő adatátvitelre használja. A metódus például ezzel a CMFCOutlookBarPane::OnDragOver módszerrel hajt végre húzási műveleteket.

CMFCToolBarButton::EnableWindow

Engedélyezi vagy letiltja az egér- és billentyűzetbemenetet.

virtual void EnableWindow(BOOL bEnable = TRUE);

Paraméterek

bEnable
[in] Állítsa ezt a paramétert TRUE értékre a bemenet engedélyezéséhez, vagy FALSE értékre a bemenet letiltásához.

Megjegyzések

Ez a metódus meghívja a függvényt a EnableWindow bemenet engedélyezésére vagy letiltására. További információ: EnableWindow a Windows SDK-ban.

CMFCToolBarButton::ExportToMenuButton

Szöveg másolása az eszköztár gombjáról egy menübe.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

Paraméterek

menuButton
[in] Hivatkozás a célmenü gombjára.

Visszaadott érték

Ez a metódus IGAZ értéket ad vissza.

Megjegyzések

A keretrendszer meghívja ezt a metódust, hogy másolja a szöveget egy eszköztárgombról egy menügombra. Az alapértelmezett implementáció átmásolja a gomb szövegfeliratát. Ha a szövegcímke üres, ez a metódus átmásolja a gomb elemleírását.

A metódus alapértelmezett implementációja IGAZ értéket ad vissza. Bírálja felül ezt a metódust, ha további műveleteket szeretne végrehajtani, amikor a keretrendszer a CMFCToolbarButtonból származó objektumot menügombmá alakítja.

CMFCToolBarButton::GetClipboardFormat

Lekéri az alkalmazás globális vágólapformátumát.

static CLIPFORMAT __stdcall GetClipboardFormat();

Visszaadott érték

Az alkalmazás globális CLIPFORMAT-értéke.

Megjegyzések

A keretrendszer meghívja ezt a metódust az OLE adatátviteli műveletek vágólapformátumának lekérésére. A CMFCToolBarButton::CreateFromOleData metódus például ezzel a módszerrel másol adatokat egy forrás OLE-adatobjektumból.

Ez a metódus a metódus első meghívásakor állítja be a globális CLIPFORMAT értéket. A metódus minden későbbi hívása ezt az értéket adja vissza.

Ha engedélyezni szeretné az alkalmazások közötti húzási műveletek végrehajtását, hívja meg a CMFCToolBarButton::SetClipboardFormatName metódust .

Az MFC-ben lévő vágólapokkal kapcsolatos további információkért lásd: Vágólap.

CMFCToolBarButton::GetHwnd

Lekéri az eszköztárgombhoz társított ablakfogópontot.

virtual HWND GetHwnd();

Visszaadott érték

Az eszköztárgombhoz vagy NULL értékhez társított ablakfogópont, ha az eszköztárgombhoz nincs társított ablakfogópont.

Megjegyzések

A metódus alapértelmezett implementációja NULL értéket ad vissza. A metódus felülbírálása az adott vezérlő ablakfogópontjának visszaadásához.

CMFCToolBarButton::GetImage

Lekéri a gomb képindexét.

int GetImage() const;

Visszaadott érték

A gombhoz társított kép indexe.

Megjegyzések

Ha a gomb felhasználó által definiált rendszerképet tartalmaz (azaz ha a konstruktorban a bUserButton IGAZ volt), a visszaadott index a felhasználó által definiált rendszerképek gyűjteményének egy képét adja meg (lásd : CMFCToolBar::GetUserImages). Ellenkező esetben az index egy erőforrásfájlból betöltött képek gyűjteményében lévő képet határoz meg (lásd : CMFCToolBar::GetImages). Az erőforrásfájlokról további információt az Erőforrásfájlok használata című témakörben talál.

CMFCToolBarButton::GetInvalidateRect

A gomb ügyfélterületének régióját kéri le, amelyet újra kell helyezni.

virtual const CRect GetInvalidateRect() const;

Visszaadott érték

Az CRect újrarajzolt régiót meghatározó objektum.

Megjegyzések

A metódus alapértelmezett implementációja a teljes ügyfélterületet adja vissza. Bírálja felül ezt a metódust, ha egy másik területet szeretne újrarajzolni.

CMFCToolBarButton::GetParentWnd

Lekéri a gomb szülőablakát.

CWnd* GetParentWnd() const;

Visszaadott érték

A gomb szülőablaka.

CMFCToolBarButton::GetProtectedCommands

Lekéri a felhasználó által nem testre szabható parancsok listáját.

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

Visszaadott érték

A védett parancsok listája.

Megjegyzések

Testreszabási módban a keretrendszer letiltja a védett eszköztárgombok parancsait. A felhasználó nem hajthat végre húzási és szerkesztési műveleteket a letiltott eszköztárgombokon.

A védett parancsok listájának meghatározásához használja a CMFCToolBarButton::SetProtectedCommands metódust.

CMFCToolBarButton::GetTextSize

Lekéri a gomb szövegének méretét.

SIZE GetTextSize() const;

Visszaadott érték

A gomb szövegének képpontban kifejezett méretét tartalmazó SIZE objektum.

CMFCToolBarButton::HasFocus

Meghatározza, hogy a gomb rendelkezik-e az aktuális bemeneti fókuszsal.

virtual BOOL HasFocus() const;

Visszaadott érték

Nonzero, ha a gomb a bemeneti fókuszt; egyéb esetben 0.

Megjegyzések

A metódus alapértelmezett implementációja nonzero értéket ad vissza, ha a gomb a bemeneti fókuszt, vagy a bemeneti fókuszt tartalmazó ablak gyermek- vagy leszármazottablaka. Ezt a függvényt felülbírálhatja a viselkedés testreszabásához.

CMFCToolBarButton::HaveHotBorder

Meghatározza, hogy megjelenik-e a gomb szegélye, amikor egy felhasználó kiválasztja a gombot.

virtual BOOL HaveHotBorder() const;

Visszaadott érték

Ez a metódus IGAZ értéket ad vissza.

Megjegyzések

A keretrendszer meghívja ezt a metódust annak meghatározására, hogy az eszköztár gombnak megjelenjen-e a szegélye, amikor egy felhasználó kiválasztja.

Az alapértelmezett implementáció IGAZ értéket ad vissza. Ezt a módszert felülbírálhatja a viselkedés testreszabásához.

CMFCToolBarButton::IsDrawImage

Meghatározza, hogy megjelenik-e kép a gombon.

BOOL IsDrawImage() const;

Visszaadott érték

Nonzero, ha egy kép jelenik meg a gombon; egyéb esetben 0.

Megjegyzések

Ez a metódus HAMIS értéket ad vissza, ha az eszköztárgombhoz nincs társított kép ( CMFCToolBarButton::GetImage visszaadja -1), vagy ha a CMFCToolBarButton::m_bImage értéke HAMIS.

CMFCToolBarButton::IsDrawText

Meghatározza, hogy megjelenik-e szövegfelirat a gombon.

BOOL IsDrawText() const;

Visszaadott érték

Nonzero, ha egy szövegfelirat jelenik meg; egyéb esetben 0.

Megjegyzések

Ez a metódus HAMIS értéket ad vissza, ha az eszköztár gombja nem tartalmaz társított szövegcímkét ( CMFCToolBarButton::m_strText üres), vagy a CMFCToolBarButton::m_bText értéke HAMIS.

CMFCToolBarButton::IsDroppedDown

Meghatározza, hogy a gomb megjelenít-e egy almenüt.

virtual BOOL IsDroppedDown() const;

Visszaadott érték

Ez a metódus HAMIS értéket ad vissza.

Megjegyzések

A metódus alapértelmezett implementációja HAMIS értéket ad vissza. Felülbírálja ezt a metódust, hogy IGAZ értéket adjon vissza, ha a vezérlőelem egy almenüt jelenít meg.

CMFCToolBarButton::IsEditable

Meghatározza, hogy a gomb testre szabható-e.

virtual BOOL IsEditable() const;

Visszaadott érték

Nonzero, ha a felhasználó testre szabhat egy gombot; egyéb esetben 0.

Megjegyzések

A keretrendszer meghívja ezt a metódust annak meghatározására, hogy a felhasználó testre szabhatja-e az eszköztárgombot húzással vagy szerkesztési műveletekkel.

Az alapértelmezett implementáció HAMIS értéket ad vissza, ha a gomb parancsazonosítója egy szabványos parancs (ezt a IsStandardCommand függvény meghívásával meghatározhatja), vagy ha a parancsazonosító szerepel a védett parancsok listájában. További információ a védett parancsokról: CMFCToolBarButton::GetProtectedCommands és CMFCToolBarButton::SetProtectedCommands.

A metódus felülbírálása a viselkedés testreszabásához.

CMFCToolBarButton::IsExtraSize

Meghatározza, hogy a gomb megjeleníthető-e kiterjesztett szegélylel.

virtual BOOL IsExtraSize() const;

Visszaadott érték

Nem kötelező, ha az eszköztár gombja kiterjesztett szegélylel jeleníthető meg; egyéb esetben 0.

Megjegyzések

Több bőr extra méretet használ az eszköztárgombok szegélyéhez (például kerek gombokhoz).

Ha a felhasználó áthelyezi ezt a gombot az egyik eszköztárról a másikra, a keretrendszer meghívja a CMFCToolBarButton::OnChangeParentWnd metódust . A CMFCToolBarButton::OnChangeParentWnd metódus az új szülőpult méretjelzőjének beállítását állítja be (további információ: CMFCToolBar::IsButtonExtraSizeAvailable).

CMFCToolBarButton::IsFirstInGroup

Meghatározza, hogy a gomb a gombcsoport első helyén van-e.

virtual BOOL IsFirstInGroup() const;

Visszaadott érték

IGAZ, ha a gomb az első gomb a gombcsoportban; egyéb esetben HAMIS.

Megjegyzések

Ez a metódus egy gombcsoportot egy szomszédos gombkészletként határoz meg, amelyek ugyanazon a sorban vannak elhelyezve, és elválasztójelek vagy az eszköztár szegélye határolja. Ez a metódus HAMIS értéket ad vissza, ha az eszköztárgomb a Testreszabás gombra hivatkozik. A Testreszabás gombbal kapcsolatos további információkért lásd: CMFCToolBar::GetCustomizeButton.

Hívja meg a CMFCToolBarButton::IsLastInGroup metódust annak megállapításához, hogy a gomb a gombcsoport utolsó helyén van-e.

CMFCToolBarButton::IsHidden

Meghatározza, hogy a gomb rejtett-e.

BOOL IsHidden() const;

Visszaadott érték

Nonzero, ha a gomb rejtett (láthatatlan); egyéb esetben 0.

Megjegyzések

A keretrendszer akkor hívja meg ezt a metódust, ha a szülőpult ki van feszítve annak megállapításához, hogy az eszköztár gomb látható-e.

Ha a CMFCToolBarButton::SetVisible metódussal láthatatlanná állítja a gombot, a CMFCToolBarButton::IsVisible használatával állapítsa meg, hogy az eszköztárgomb látható-e.

Alapértelmezés szerint az összes eszköztárgomb látható. Használja a CMFCToolBarButton::Show metódust az eszköztárgombok elrejtéséhez vagy megjelenítéséhez.

CMFCToolBarButton::IsHorizontal

Meghatározza, hogy a gomb vízszintes eszköztáron található-e.

BOOL IsHorizontal() const;

Visszaadott érték

Nonzero, ha egy eszköztárgomb vízszintes eszköztáron található; egyéb esetben 0.

Megjegyzések

A keretrendszer meghívja ezt a metódust az eszköztárgombok elrendezésének meghatározásához.

Ez a metódus az adattagot m_bHorz adja vissza. Az adattag alapértelmezett értéke m_bHorz IGAZ; a rendszer alaphelyzetbe állítja a CMFCToolBarButton::OnDraw metódus hívásait.

CMFCToolBarButton::IsLastInGroup

Megadja, hogy a gomb a gombcsoport utolsó helyén van-e.

virtual BOOL IsLastInGroup() const;

Visszaadott érték

IGAZ, ha a gomb az utolsó gomb a gombcsoportban; egyéb esetben HAMIS.

Megjegyzések

Ez a metódus egy gombcsoportot egy szomszédos gombkészletként határoz meg, amelyek ugyanazon a sorban vannak elhelyezve, és elválasztójelek vagy az eszköztár szegélye határolja. Ez a metódus HAMIS értéket ad vissza, ha az eszköztárgombnak nincs szülő eszköztára, vagy az eszköztárgomb a Testreszabás gombra hivatkozik. A Testreszabás gombbal kapcsolatos további információkért lásd: CMFCToolBar::GetCustomizeButton.

Hívja meg a CMFCToolBarButton::IsFirstInGroup metódust annak megállapításához, hogy a gomb a gombcsoport első helyén van-e.

CMFCToolBarButton::IsLocked

Meghatározza, hogy a gomb zárolt (nem testreszabható) eszköztáron van-e.

BOOL IsLocked() const;

Visszaadott érték

Nonzero, ha a gomb zárolt eszköztáron van; egyéb esetben 0.

Megjegyzések

A keretrendszer meghívja ezt a metódust annak meghatározására, hogy a felhasználó testre szabhatja-e az eszköztárgombot húzással vagy szerkesztési műveletekkel. Állítsa be a zárolt attribútumot a szülőpulton a CMFCToolBar::LoadToolBar metódus használatával. A keretrendszer átadja ennek az attribútumnak az értékét az egyes eszköztárgombok konstruktorának ( CMFCToolbarButton), amelyeket beszúr a szülő eszköztárba.

CMFCToolBarButton::IsOwnerOf

Meghatározza, hogy a gomb a megadott ablakfogópont tulajdonosa-e.

virtual BOOL IsOwnerOf(HWND hwnd);

Paraméterek

hwnd
[in] Egy ablakfogópont.

Visszaadott érték

Nonzero, ha a gomb a megadott ablakfogópont tulajdonosa; egyéb esetben 0.

Megjegyzések

Ez a metódus nonzero értéket ad vissza, ha a hwnd a közvetlen ablakfogópontra hivatkozik, vagy a gombhoz társított ablakfogópont gyermeke. Ez a metódus 0 értéket ad vissza, ha a hwnd értéke NULL.

CMFCToolBarButton::IsVisible

Meghatározza, hogy az eszköztár gomb látható-e.

BOOL IsVisible() const;

Visszaadott érték

Nonzero, ha az eszköztár gomb látható; egyéb esetben 0.

Megjegyzések

Az eszköztár gombot a CMFCToolBarButton::SetVisible metódussal jelenítheti meg vagy rejtheti el. A CMFCToolBarButton::SetVisible meghívása után hívja meg a CPane::AdjustSizeImmediate metódust a szülő eszköztáron.

CMFCToolBarButton::IsWindowVisible

Meghatározza, hogy a gomb alapjául szolgáló ablakfogópont látható-e.

virtual BOOL IsWindowVisible();

Visszaadott érték

Nonzero, ha a gomb alapjául szolgáló ablakfogópont látható; egyéb esetben 0.

Megjegyzések

Ez a metódus nem aero értéket ad vissza, ha a mögöttes ablakfogópont stílusattribútuma tartalmazza a WS_VISIBLE stílust. Ez a metódus HAMIS értéket ad vissza, ha a gomb mögöttes ablakleírója NULL.

CMFCToolBarButton::m_bImage

Megadja, hogy megjelenik-e kép a gombon.

BOOL m_bImage;

Megjegyzések

Ha ez az adattag IGAZ értékre van állítva, a keretrendszer megjeleníti az eszköztár gombhoz társított képet; ellenkező esetben a keretrendszer nem jeleníti meg a képet. Ez a tag befolyásolja a CMFCToolBarButton::m_bImage metódus visszatérési értékét.

CMFCToolBarButton::m_bText

Megadja, hogy megjelenik-e szövegfelirat a gombon.

BOOL m_bText;

Megjegyzések

Ha ez az adattag IGAZ értékre van állítva, a keretrendszer megjeleníti az eszköztár gomb szövegfeliratát; ellenkező esetben a keretrendszer nem jeleníti meg a szövegfeliratot. Ez a tag a CMFCToolBarButton::m_bText metódus visszatérési értékét befolyásolja.

CMFCToolBarButton::m_bTextBelow

Megadja, hogy a szövegcímke megjelenjen-e a gomb képe alatt.

BOOL m_bTextBelow;

Megjegyzések

Ha ez a tagváltozó IGAZ értékre van állítva, a keretrendszer megjeleníti a gomb szövegét a kép alatt. Ennek a tagnak az alapértelmezett értéke HAMIS.

CMFCToolBarButton::m_bUserButton

Megadja, hogy a gomb rendelkezik-e felhasználó által definiált lemezképpel

BOOL m_bUserButton;

Megjegyzések

Ez az adattag IGAZ értékre van állítva, ha a gombhoz felhasználó által definiált rendszerkép van társítva.

CMFCToolBarButton::m_bWholeText

Megadja, hogy a gomb megjelenítse-e a teljes szöveges címkét, még akkor is, ha nem fér el a határolókeretben.

BOOL m_bWholeText;

Megjegyzések

Ha ez az adattag IGAZ értékre van állítva, a keretrendszer a gomb felnagyításával megjeleníti a teljes szöveges címkét. Ellenkező esetben a keretrendszer csonkolja a szöveget, és hozzáfűz egy három pontot ( ...) a szövegcímkéhez.

CMFCToolBarButton::m_bWrap

Megadja, hogy az elválasztó gomb a következő sorra kerül-e.

BOOL m_bWrap;

Megjegyzések

A keretrendszer igaz értékre állítja ezt az adattagot, ha az eszköztár gomb nem fér el az aktuális sorban, vagy ha egy elrendezést ad meg (például soronként egy adott számú eszköztárgombot).

A keretrendszer ezt a gombot a következő sorra helyezi, ha ez az adattag IGAZ értékre van állítva, és az eszköztár vízszintesen vagy lebegőleg van rögzítve.

Az adattag alapértelmezett értéke HAMIS.

CMFCToolBarButton::m_bWrapText

Megadja, hogy engedélyezve vannak-e a többsoros szövegfeliratok.

AFX_IMPORT_DATA static BOOL m_bWrapText;

Megjegyzések

Ha ez a statikus tagváltozó IGAZ, a keretrendszer lehetővé teszi, hogy az összes eszköztár többsoros szövegfeliratokat jelenítsen meg az eszköztárgombokon.

Az adattag alapértelmezett értéke HAMIS.

CMFCToolBarButton::m_nID

A gomb parancsazonosítója.

UINT m_nID;

Megjegyzések

A -1 parancsazonosítója azt jelzi, hogy a gomb elválasztó. Minden gombelválasztó TBBS_SEPARATOR stílussal rendelkezik. További információ a gombstílusokról: CMFCToolBarButton::m_nStyle .

CMFCToolBarButton::m_nStyle

A gomb stílusa.

UINT m_nStyle;

Megjegyzések

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

CMFCToolBarButton::m_strText

A gomb szövegfelirata.

CString m_strText;

Megjegyzések

Ez az adattag tartalmazza a gomb szövegfeliratát. A szövegcímke üres lehet.

CMFCToolBarButton::NotifyCommand

Megadja, hogy a gomb feldolgozza-e a WM_COMMAND üzenetet.

virtual BOOL NotifyCommand(int iNotifyCode);

Paraméterek

iNotifyCode
[in] A parancshoz társított értesítési üzenet.

Visszaadott érték

Ez a metódus HAMIS értéket ad vissza.

Megjegyzések

A keretrendszer meghívja ezt a metódust, amikor WM_COMMAND üzenetet szeretne küldeni a szülőablakba.

Ez a metódus alapértelmezés szerint HAMIS értéket ad vissza. Felülbírálja ezt a metódust, hogy IGAZ értéket adjon vissza, ha a WM_COMMAND üzenetet vagy a HAMIS értéket szeretné feldolgozni annak jelzésére, hogy a szülő eszköztárnak kell kezelnie az üzenetet.

CMFCToolBarButton::OnAddToCustomizePage

A keretrendszer meghívja, amikor a gomb hozzáadódik a Testreszabás párbeszédpanelhez.

virtual void OnAddToCustomizePage();

Megjegyzések

A metódus alapértelmezett implementációja nem tesz semmit. Bírálja felül ezt a módszert, ha valamilyen műveletet szeretne végrehajtani, amikor a gomb hozzáadódik a Testreszabás párbeszédpanelhez.

CMFCToolBarButton::OnBeforeDrag

Megadja, hogy a gomb húzható-e.

virtual BOOL OnBeforeDrag() const;

Visszaadott érték

IGAZ, ha a gomb húzható; egyéb esetben HAMIS.

Megjegyzések

A keretrendszer meghívja ezt a metódust, mielőtt a felhasználó elkezdené húzni a gombot.

A metódus alapértelmezett implementációja IGAZ értéket ad vissza. Felülbírálja ezt a metódust, hogy HAMIS értéket adjon vissza a gomb húzásának letiltásához.

CMFCToolBarButton::OnBeforeDrop

Megadja, hogy a felhasználó a gombot a célpultra helyezheti-e.

virtual BOOL OnBeforeDrop(CMFCToolBar* pTarget);

Paraméterek

pTarget
[in] A húzási művelet célja.

Visszaadott érték

IGAZ, ha a gombot a megadott célpultra lehet dobni; egyéb esetben HAMIS.

Megjegyzések

A keretrendszer meghívja ezt a metódust, mielőtt a gombot egy eszköztárra dobják.

A metódus alapértelmezett implementációja IGAZ értéket ad vissza. Felülbírálja ezt a metódust, hogy hamis értéket adjon vissza a megadott célhelyen végzett elvetési művelet letiltásához.

CMFCToolBarButton::OnCalculateSize

A keretrendszer meghívta, hogy kiszámítsa a gomb méretét a megadott eszközkörnyezethez és a rögzítési állapothoz.

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

Paraméterek

Pdc
[in] A gombot megjelenítő eszközkörnyezet.

sizeDefault
[in] A gomb alapértelmezett mérete.

bHorz
[in] A szülő eszköztár dokkolásának állapota. Ez a paraméter IGAZ, ha az eszköztár vízszintesen van rögzítve, vagy lebegő, vagy HAMIS, ha az eszköztár függőlegesen van rögzítve.

Visszaadott érték

A SIZE gomb méreteit képpontokban tartalmazó struktúra.

Megjegyzések

A keretrendszer meghívja ezt a metódust az eszköztár gomb méretének meghatározásához a megadott eszközkörnyezethez és a dokkolás állapotához.

Az alapértelmezett implementáció figyelembe veszi a szöveg- és képméreteket (ha megjelennek), a szöveg- és képpozíciókat (a kép alatti vagy jobb oldali szöveget), valamint az eszköztár dokkolási állapotát.

Bírálja felül ezt a metódust, ha egy nem szabványos gomb méretét szeretné megadni (például egy szerkesztési gombot).

CMFCToolBarButton::OnCancelMode

A keretrendszer meghívta a WM_CANCELMODE üzenet kezelésére.

virtual void OnCancelMode();

Megjegyzések

A metódus alapértelmezett implementációja nem tesz semmit. Bírálja felül ezt a metódust, ha kezelni szeretné a WM_CANCELMODE üzenetet.

CMFCToolBarButton::OnChangeParentWnd

A keretrendszer meghívta, amikor a gomb be van szúrva egy új eszköztárba.

virtual void OnChangeParentWnd(CWnd* pWndParent);

Paraméterek

pWndParent
[in] Az új szülőablak.

Megjegyzések

A gombot beszúrja egy eszköztárba, például amikor a felhasználó az egyik eszköztárról egy másik eszköztárra húzza.

A metódus alapértelmezett implementációja nem tesz semmit.

CMFCToolBarButton::OnClick

A keretrendszer meghívja, amikor a felhasználó az egérgombra kattint.

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay=TRUE);

Paraméterek

pWnd
[in] Az eszköztár gomb szülőablaka.

bDelay
[in] IGAZ, ha az üzenetet késéssel kell kezelni.

Visszaadott érték

Ez a metódus HAMIS értéket ad vissza.

Megjegyzések

A keretrendszer meghívja ezt a metódust, amikor a felhasználó az eszköztár gombra kattint.

Az alapértelmezett implementáció nem végez semmit, és HAMIS értéket ad vissza. Ha a gomb feldolgozza a kattintási üzenetet, felülbírálja ezt a metódust, és nemero értéket ad vissza.

CMFCToolBarButton::OnClickUp

A keretrendszer meghívja, amikor a felhasználó felengedi az egérgombot.

virtual BOOL OnClickUp();

Visszaadott érték

Ez a metódus HAMIS értéket ad vissza.

Megjegyzések

A keretrendszer meghívja ezt a metódust, amikor a felhasználó kiadja az eszköztár gombot.

Az alapértelmezett implementáció nem végez semmit, és HAMIS értéket ad vissza. Ha a gomb feldolgozza a kattintási üzenetet, felülbírálja ezt a metódust, és nemero értéket ad vissza.

CMFCToolBarButton::OnContextHelp

A keretrendszer meghívja, amikor a szülő eszköztár egy WM_HELPHITTEST üzenetet kezel.

virtual BOOL OnContextHelp(CWnd* pWnd);

Paraméterek

pWnd
[in] Az eszköztár gomb szülőablaka.

Visszaadott érték

Ez a metódus HAMIS értéket ad vissza.

Megjegyzések

A metódus alapértelmezett implementációja nem végez semmit, és HAMIS értéket ad vissza. Ha a gomb feldolgozza a súgóüzenetet, felülbírálja ezt a metódust, és nemero értéket ad vissza.

A WM_HELPHITTEST üzenetről további információt a TN028: Context-Sensitive súgójában talál.

CMFCToolBarButton::OnCtlColor

A keretrendszer meghívja, amikor a szülő eszköztár egy WM_CTLCOLOR üzenetet kezel.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

Paraméterek

Pdc
[in] A gombot megjelenítő eszközkörnyezet.

nCtlColor
[in] Az adott színértesítés.

Visszaadott érték

Egy fogópont a kefe objektumhoz, amelyet a keretrendszer a gomb hátterének festéséhez használ.

Megjegyzések

A keretrendszer akkor hívja meg ezt a metódust, ha a szülőpult feldolgozza a Windows-vezérlőt tartalmazó eszköztárgomb WM_CTLCOLOR üzenetét. A keretrendszer nem hívja meg ezt a metódust, ha az eszköztár gombja ablak nélküli.

A keretrendszer akkor hívja meg ezt a metódust, ha az eszköztár-keretrendszer testreszabási módban van, és az eszköztár gombja fel van oldva. A testreszabási módról további információt a CMFCToolBar::SetCustomizeMode című témakörben talál. További információ az eszköztárgombok zárolásáról: CMFCToolBarButton::IsLocked.

Az alapértelmezett implementáció nem végez semmit, és null értéket ad vissza.

CMFCToolBarButton::OnCustomizeMenu

Lehetővé teszi, hogy a gomb módosítsa a megadott menüt, amikor az alkalmazás megjelenít egy helyi menüt a szülőpulton.

virtual BOOL OnCustomizeMenu(CMenu* pMenu);

Paraméterek

pMenu
[in] A testre szabandó menü.

Visszaadott érték

Ez a metódus HAMIS értéket ad vissza.

Megjegyzések

Az alapértelmezett implementáció nem végez semmit, és HAMIS értéket ad vissza. Ha módosítani szeretné a megadott menü tartalmát, felülbírálja ezt a metódust, és adjon vissza egy nem nulla értéket.

CMFCToolBarButton::OnDblClk

A keretrendszer meghívja, amikor a szülőpult egy WM_LBUTTONDBLCLK üzenetet kezel.

virtual void OnDblClk(CWnd* pWnd);

Paraméterek

pWnd
[in] – A gomb szülőablaka.

Megjegyzések

Ezt a metódust akkor hívja meg a CMFCToolBar::OnLButtonDblClk rendszer, ha a szülőpult egy WM_LBUTTONDBLCLK üzenetet kezel.

A metódus alapértelmezett implementációja nem tesz semmit.

CMFCToolBarButton::OnDraw

A keretrendszer meghívta, hogy a megadott stílusok és beállítások használatával rajzolja meg a gombot.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz=TRUE,
    BOOL bCustomizeMode=FALSE,
    BOOL bHighlight=FALSE,
    BOOL bDrawBorder=TRUE,
    BOOL bGrayDisabledButtons=TRUE);

Paraméterek

Pdc
[in] A gombot megjelenítő eszközkörnyezet.

téglalap
[in] A gomb határoló téglalapja.

pImages
[in] A gombhoz társított eszköztárképek gyűjteménye.

bHorz
[in] A szülő eszköztár dokkolásának állapota. Ez a paraméter IGAZ, ha a gomb vízszintesen van rögzítve, és HAMIS, ha a gomb függőlegesen van rögzítve.

bCustomizeMode
[in] Megadja, hogy az eszköztár testreszabási módban van-e. Ez a paraméter IGAZ, ha az eszköztár testreszabási módban van, és HAMIS, ha az eszköztár nincs testreszabási módban.

bHighlight
[in] Megadja, hogy a gomb ki van-e emelve. Ez a paraméter IGAZ, ha a gomb ki van emelve, és HAMIS, ha a gomb nincs kiemelve.

bDrawBorder
[in] Megadja, hogy a gomb megjelenítse-e a szegélyét. Ez a paraméter IGAZ, ha a gombnak meg kell jelennie a szegélye és HAMIS, ha a gomb nem jelenik meg a szegélye.

bGrayDisabledButtons
[in] Megadja, hogy árnyékolja-e a letiltott gombokat, vagy használja-e a letiltott képek gyűjteményét. Ez a paraméter IGAZ, ha a letiltott gombokat árnyékoltnak és HAMISnak kell lennie, ha ez a módszer a letiltott képek gyűjteményét használja.

Megjegyzések

A metódus felülbírálása az eszköztár gombrajzának testreszabásához.

CMFCToolBarButton::OnDrawOnCustomizeList

A keretrendszer meghívta, hogy rajzolja meg a gombot a Testreszabás párbeszédpanel Parancsok panelén.

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

Paraméterek

Pdc
[in] A gombot megjelenítő eszközkörnyezet.

téglalap
[in] A gomb határoló téglalapja.

b Kijelölve
[in] Megadja, hogy a gomb ki van-e jelölve. Ha ez a paraméter IGAZ, a gomb ki van jelölve. Ha ez a paraméter HAMIS, a gomb nincs kiválasztva.

Visszaadott érték

A gomb szélessége képpontban a megadott eszközkörnyezetben.

Megjegyzések

Ezt a metódust a testreszabási párbeszédpanel ( Parancsok lap) hívja meg, amikor a gomb a tulajdonos-rajz listamezőben jelenik meg.

A metódus alapértelmezett implementációja megjeleníti a gomb képét és szövegfeliratát, ha elérhetők. Ha a gomb szövegfelirata nem érhető el, a metódus megjeleníti az elemleírás szövegét.

A metódus felülbírálása egyéni rajzok végrehajtásához.

CMFCToolBarButton::OnGetCustomToolTipText

A keretrendszer meghívta a gomb egyéni elemleírás-szövegének lekéréséhez.

virtual BOOL OnGetCustomToolTipText(CString& strToolTip);

Paraméterek

strToolTip
[kifelé] Egy CString objektum, amely megkapja az egyéni elemleírás szövegét.

Visszaadott érték

Ez a metódus HAMIS értéket ad vissza.

Megjegyzések

A keretrendszer ezt a metódust hívja meg, amikor megjeleníti az eszköztár gomb elemleírását. Ha ez a metódus HAMIS értéket ad vissza, a keretrendszer egy alapértelmezett elemleírást használ.

Az alapértelmezett implementáció nem végez semmit, és HAMIS értéket ad vissza. Bírálja felül ezt a metódust, és adjon vissza egy nem kötelező értéket az eszköztár gomb egyéni elemleírás-szövegének megadásához.

CMFCToolBarButton::OnGlobalFontsChanged

A keretrendszer meghívta, amikor a globális betűtípus megváltozott.

virtual void OnGlobalFontsChanged();

Megjegyzések

A metódus alapértelmezett implementációja nem tesz semmit. A metódus felülbírálása a gomb szövegének megjelenítéséhez használt betűtípus frissítéséhez.

CMFCToolBarButton::OnMove

A keretrendszer meghívta a szülő eszköztár áthelyezésekor.

virtual void OnMove();

Megjegyzések

A metódus alapértelmezett implementációja nem tesz semmit. Felülbírálhatja ezt a metódust a gomb áthelyezéséhez a szülő eszköztár áthelyezésekor.

CMFCToolBarButton::OnShow

A keretrendszer meghívja, amikor a gomb láthatóvá vagy láthatatlanná válik.

virtual void OnShow(BOOL bShow);

Paraméterek

bShow
[in] Megadja, hogy a gomb látható-e. Ha ez a paraméter IGAZ, a gomb látható. Ellenkező esetben a gomb nem látható.

Megjegyzések

A metódus alapértelmezett implementációja nem tesz semmit. Felülbírálja ezt a módszert a gomb láthatóságának frissítéséhez.

CMFCToolBarButton::OnSize

A keretrendszer meghívja, amikor a szülőpult módosítja a méretét vagy a pozícióját, és ez a módosítás miatt a gomb mérete megváltozik.

virtual void OnSize(int iSize);

Paraméterek

iSize
[in] A gomb új szélessége.

Megjegyzések

A metódus alapértelmezett implementációja nem tesz semmit. Felülbírálja ezt a módszert a gomb átméretezéséhez, amikor a szülőpult mérete vagy pozíciója megváltozik.

CMFCToolBarButton::OnToolHitTest

A keretrendszer meghívja, amikor a szülő eszköztárnak meg kell határoznia, hogy egy pont a gomb határoló téglalapjában van-e.

virtual BOOL OnToolHitTest(
    const CWnd* pWnd,
    TOOLINFO* pTI);

Paraméterek

pWnd
[in] A gomb szülőablaka. Null érték is lehet.

pTI
[in] Olyan TOOLINFO struktúra, amely egy elemleírás-vezérlő eszközéről tartalmaz információkat.

Visszaadott érték

Annak az eredménye OnMenuButtonToolHitTest , hogy a gomb le tudja-e kérni az egérmutatót a szülőkeret ablakához, ellenkező esetben HAMIS.

Megjegyzések

Ez a metódus az alábbi metódusok egyikét hívja meg, ha a szülőablakot érvényes keretobjektummá konvertálja:

• CMDIFrameWndEx::OnMenuButtonToolHitTest

• CFrameWndEx::OnMenuButtonToolHitTest

• COleIPFrameWndEx::OnMenuButtonToolHitTest

CMFCToolBarButton::OnUpdateToolTip

A keretrendszer meghívta, amikor a szülő eszköztár frissíti az elemleírás szövegét.

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

Paraméterek

pWndParent
[in] A szülőablak.

iButtonIndex
[in] A szülőgomb gyűjteményében lévő gomb nullaalapú indexe.

wndToolTip
[in] Az elemleírás szövegét megjelenítő vezérlő.

Str
[kifelé] Egy CString objektum, amely megkapja a frissített elemleírás szövegét.

Visszaadott érték

Ez a metódus HAMIS értéket ad vissza.

Megjegyzések

A metódus alapértelmezett implementációja nem végez semmit, és HAMIS értéket ad vissza. Ha elemleírást ad meg, felülbírálhatja ezt a metódust, ha nemero értéket ad vissza.

CMFCToolBarButton::P repareDrag

A keretrendszer meghívja, amikor a gomb húzási műveletet hajt végre.

virtual BOOL PrepareDrag(COleDataSource& srcItem);

Paraméterek

srcItem
[in] Egy COleDataSource objektum, amely a húzási művelet állapotadatait tárolja.

Visszaadott érték

IGAZ, ha a művelet sikeres; egyéb esetben HAMIS.

Megjegyzések

A keretrendszer meghívja ezt a metódust, hogy előkészítse az eszköztár gombot az állapotának a megadott COleDataSource objektumban való tárolására. Ez a metódus úgy tárolja az állapotát, hogy szerializálja magát egy megosztott fájlba, majd átadja a fájlt a COleDataSource::CacheGlobalData metódusnak. Az eszköztárgomb szerializálásáról további információt a CMFCToolBarButton::Szerializálás című témakörben talál.

Ez a metódus nem tesz semmit, és IGAZ értéket ad vissza, ha a gomb nem tárolható (a CMFCToolBarButton::CanBeStored metódus HAMIS értéket ad vissza). HAMIS értéket ad vissza, ha kivétel történik az objektum szerializálása során.

Az OLE húzási műveleteiről további információt az OLE húzással és húzással kapcsolatos cikkben talál.

CMFCToolBarButton::Rect

Lekéri a gomb határolókeretét.

const CRect& Rect() const;

Visszaadott érték

Egy CRect gomb határoló téglalapját tartalmazó objektum.

CMFCToolBarButton::ResetImageToDefault

Beállítja a gombhoz társított kép alapértelmezett értékét.

virtual void ResetImageToDefault();

Megjegyzések

Ez a metódus a CMFCToolBar::GetDefaultImage metódussal kéri le az alapértelmezett képet a szülőpultjáról. Ha a gomb nem rendelkezik társított alapértelmezett képpel, ez a metódus a CStringT:LoadString metódus használatával állítja be a gomb szövegfeliratát a sztringerőforrásnak megfelelően. A sztringerőforrásokról további információt az Erőforrásfájlok használata című témakörben talál.

Ez a módszer nem tesz semmit, ha a gomb felhasználó által definiált rendszerképet tartalmaz.

CMFCToolBarButton::SaveBarState

Menti az eszköztár állapotát.

virtual void SaveBarState();

Megjegyzések

A keretrendszer akkor hívja meg ezt a metódust, ha húzási művelet eredményeként hoz létre objektumot CMFCToolBarButton .

A metódus alapértelmezett implementációja nem tesz semmit. A metódus felülbírálása az eszköztár gomb állapotának külső adatforrásba való mentéséhez.

CMFCToolBarButton::Szerializálás

Beolvassa ezt az objektumot egy archívumból, vagy egy archívumba írja.

virtual void Serialize(CArchive& ar);

Paraméterek

Ar
[in] Az CArchive az objektum, amelyből vagy amelyből szerializálni kell.

Megjegyzések

Ez a módszer támogatja az olyan adatátviteli folyamatokat, mint a vágólap vagy a húzási műveletek. Beolvassa vagy megírja a gomb tulajdonságait, például az azonosítót, a szövegfeliratot és a képazonosítót a megadott objektumból vagy az objektumba CArchive .

Szerializálási példákért lásd : Szerializálás: Objektum szerializálása.

CMFCToolBarButton::SetACCData

Kitölti a megadott CAccessibilityData objektumot az eszköztár gomb akadálymentességi adataival.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Paraméterek

pParent
[in] Az eszköztár gomb szülőablaka.

adat
[in] Egy CAccessibilityData objektum, amely az eszköztár gomb akadálymentességi adataival van feltöltve.

Visszaadott érték

Ez a metódus IGAZ értéket ad vissza.

Megjegyzések

Bírálja felül ezt a metódust, hogy HAMIS értéket adjon vissza, ha az eszköztár gomb nem biztosít akadálymentességi adatokat.

CMFCToolBarButton::SetClipboardFormatName

Átnevezi a globális vágólap formátumát.

static void __stdcall SetClipboardFormatName(LPCTSTR lpszName);

Paraméterek

lpszName
[in] A globális vágólap formátumának új neve. Nem lehet NULL.

Megjegyzések

Ez a módszer lehetővé teszi, hogy a húzási műveletek több alkalmazás között is előforduljanak. Minden alkalmazásnak ugyanazt a vágólapformátum-nevet kell megadnia.

Ezt a metódust meg kell hívnia, mielőtt a keretrendszer meghívja a CMFCToolBarButton::GetClipboardFormat parancsot.

CMFCToolBarButton::SetImage

Beállítja a gomb képindexét.

virtual void SetImage(int iImage);

Paraméterek

iImage
[in] A kép indexe az eszköztárképek gyűjteményében.

Megjegyzések

Ha az eszköztárgomb elválasztó, az iImage az elválasztó gomb új szélességére hivatkozik.

Ha az iImage kisebb, mint nulla, ez a módszer letiltja a kép rajzolását, és lehetővé teszi a gomb szövegfeliratának rajzolását.

CMFCToolBarButton::SetProtectedCommands

Beállítja a felhasználó által nem testre szabható parancsok listáját.

static void SetProtectedCommands(const CList<UINT,UINT>& lstCmds);

Paraméterek

lstCmds
[in] A védett parancsok listája.

Megjegyzések

Testreszabási módban a keretrendszer letiltja a védett eszköztárgombok parancsait. A felhasználó nem hajthat végre húzási és szerkesztési műveleteket a letiltott eszköztárgombokon.

Használja a CMFCToolBarButton::GetProtectedCommands metódust a védett parancsok listájának lekéréséhez.

CMFCToolBarButton::SetRadio

A keretrendszer meghívja, amikor egy gomb módosítja az ellenőrzött állapotát.

virtual void SetRadio();

Megjegyzések

A metódus alapértelmezett implementációja nem tesz semmit. A metódus felülbírálása egyéni művelet végrehajtásához, amikor a gomb módosítja a bejelölt állapotát.

CMFCToolBarButton::SetRect

Beállítja a gomb határoló téglalapját.

void SetRect(const CRect rect);

Paraméterek

téglalap
[in] A gomb új határoló téglalapja.

Megjegyzések

Ez a metódus meghívja a CMFCToolBarButton::OnMove metódust az új határolókeret beállítása után.

CMFCToolBarButton::SetStyle

Beállítja a gomb stílusát.

virtual void SetStyle(UINT nStyle);

Paraméterek

nStyle
[in] A gomb új stílusa.

Megjegyzések

Az alapértelmezett implementáció a CMFCToolBarButton::m_nStyle adattagot nStyle értékre állítja. Bírálja felül ezt a módszert, ha további feldolgozást szeretne végezni a stílusváltás kezeléséhez. Az érvényes stílusjelölők listáját az eszközsáv vezérlőstílusai között találja.

CMFCToolBarButton::SetVisible

Megadja, hogy a gomb látható-e.

void SetVisible(BOOL bShow=TRUE);

Paraméterek

bShow
[in] Logikai érték, amely meghatározza, hogy meg szeretné-e jeleníteni vagy elrejteni a gombot. Ha ez a paraméter IGAZ, megjelenik a gomb. Ha a paraméter HAMIS, a gomb rejtett.

Megjegyzések

Ezzel a függvénnyel elrejthet vagy megjeleníthet egy adott eszköztárgombot. Hívja meg a CPane::AdjustSizeImmediate metódust a metódus meghívása után.

CMFCToolBarButton::Show

Megjeleníti vagy elrejti a gombot.

void Show(BOOL bShow);

Paraméterek

bShow
[in] Logikai érték, amely meghatározza, hogy meg szeretné-e jeleníteni vagy elrejteni a gombot. Ha ez a paraméter IGAZ, megjelenik a gomb. Ha a paraméter HAMIS, a gomb rejtett.

Megjegyzések

A keretrendszer ezt a módszert arra hívja, hogy frissítse az eszköztárgombok láthatóságát a szülő eszköztár átméretezésekor. A keretrendszer ezt a metódust HAMIS értékre állítja , ha a gomb már nem fér el az eszköztár határai között. A keretrendszer ezt a metódust true (IGAZ) értékre állítja, amikor a gomb átméretezése után ismét elfér az eszköztár határai között.

Használja a CMFCToolBarButton::SetVisible metódust a gomb általános láthatóságának beállításához.

Ez a metódus meghívja a CMFCToolBarButton::OnShow metódust, miután frissíti a gomb láthatósági állapotát.

Lásd még

hierarchiadiagram
osztályok
CMFCToolBar osztály
CMFCToolBarImages osztály