Share via

Klasse CMFCToolBarButton

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Biedt knopfunctionaliteit voor werkbalken.

Syntaxis

class CMFCToolBarButton : public CObject

Leden

Openbare constructors

Naam Description
CMFCToolBarButton::CMFCToolBarButton Maakt en initialiseert een CMFCToolBarButton object.
CMFCToolBarButton::~CMFCToolBarButton Destructor.

Openbare methoden

Naam Description
CMFCToolBarButton::CanBeDropped Hiermee geeft u op of een gebruiker een knop op een werkbalk of menu kan plaatsen tijdens het aanpassen.
CMFCToolBarButton::CanBeStored Hiermee geeft u op of de knop kan worden opgeslagen.
CMFCToolBarButton::CanBeStretched Hiermee geeft u op of een gebruiker de knop tijdens het aanpassen kan uitrekken.
CMFCToolBarButton::CompareWith Vergelijkt dit exemplaar met het opgegeven CMFCToolBarButton object.
CMFCToolBarButton::CopyFrom Hiermee kopieert u de eigenschappen van een andere werkbalkknop naar de huidige knop.
CMFCToolBarButton::CreateFromOleData Hiermee maakt u een CMFCToolBarButton object op basis van het opgegeven COleDataObject object.
CMFCToolBarButton::CreateObject Wordt door het framework gebruikt om een dynamisch exemplaar van dit klassetype te maken.
CMFCToolBarButton::EnableWindow Hiermee schakelt u muis- en toetsenbordinvoer in of uit.
CMFCToolBarButton::ExportToMenuButton Hiermee kopieert u tekst van de werkbalkknop naar een menu.
CMFCToolBarButton::GetClipboardFormat Hiermee haalt u de algemene klembordindeling voor de toepassing op.
CMFCToolBarButton::GetHwnd Hiermee haalt u de venstergreep op die is gekoppeld aan de werkbalkknop.
CMFCToolBarButton::GetImage Haalt de afbeeldingsindex van de knop op.
CMFCToolBarButton::GetInvalidateRect Hiermee wordt de regio van het clientgebied van de knop opgehaald die opnieuw moet worden getekend.
CMFCToolBarButton::GetParentWnd Hiermee wordt het bovenliggende venster van de knop opgehaald.
CMFCToolBarButton::GetProtectedCommands Haalt de lijst met opdrachten op die de gebruiker niet kan aanpassen.
CMFCToolBarButton::GetTextSize Hiermee wordt de grootte van de knoptekst opgehaald.
CMFCToolBarButton::HasFocus Bepaalt of de knop de huidige invoerfocus heeft.
CMFCToolBarButton::HaveHotBorder Bepaalt of een rand van de knop wordt weergegeven wanneer een gebruiker de knop selecteert.
CMFCToolBarButton::IsDrawImage Bepaalt of een afbeelding wordt weergegeven op de knop.
CMFCToolBarButton::IsDrawText Bepaalt of een tekstlabel wordt weergegeven op de knop.
CMFCToolBarButton::IsDroppedDown Bepaalt of op de knop een submenu wordt weergegeven.
CMFCToolBarButton::IsEditable Bepaalt of de knop kan worden aangepast.
CMFCToolBarButton::IsExtraSize Bepaalt of de knop kan worden weergegeven met een uitgebreide rand.
CMFCToolBarButton::IsFirstInGroup Bepaalt of de knop zich op de eerste positie in de knopgroep bevindt.
CMFCToolBarButton::IsHidden Bepaalt of de knop verborgen is.
CMFCToolBarButton::IsHorizontal Bepaalt of de knop zich op een horizontale werkbalk bevindt.
CMFCToolBarButton::IsLastInGroup Hiermee geeft u op of de knop zich op de laatste positie in de knopgroep bevindt.
CMFCToolBarButton::IsLocked Bepaalt of de knop zich op een vergrendelde (niet-aanpasbare) werkbalk bevindt.
CMFCToolBarButton::IsOwnerOf Bepaalt of de knop de eigenaar is van de opgegeven venstergreep.
CMFCToolBarButton::IsVisible Bepaalt of de werkbalkknop zichtbaar is.
CMFCToolBarButton::IsWindowVisible Bepaalt of de onderliggende venstergreep van de knop zichtbaar is.
CMFCToolBarButton::NotifyCommand Hiermee geeft u op of de knop het WM_COMMAND bericht verwerkt.
CMFCToolBarButton::OnAddToCustomizePage Aangeroepen door het framework wanneer de knop wordt toegevoegd aan een dialoogvenster Aanpassen .
CMFCToolBarButton::OnBeforeDrag Hiermee geeft u op of de knop kan worden gesleept.
CMFCToolBarButton::OnBeforeDrop Hiermee geeft u op of een gebruiker de knop op de doelwerkbalk kan neerzetten.
CMFCToolBarButton::OnCalculateSize Aangeroepen door het framework om de grootte van de knop voor de opgegeven apparaatcontext en dockingstatus te berekenen.
CMFCToolBarButton::OnCancelMode Wordt aangeroepen door het framework om het WM_CANCELMODE bericht af te handelen.
CMFCToolBarButton::OnChangeParentWnd Aangeroepen door het framework wanneer de knop wordt ingevoegd in een nieuwe werkbalk.
CMFCToolBarButton::OnClick Aangeroepen door het framework wanneer de gebruiker op de muisknop klikt.
CMFCToolBarButton::OnClickUp Aangeroepen door het framework wanneer de gebruiker de muisknop loslaat.
CMFCToolBarButton::OnContextHelp Aangeroepen door het framework wanneer de bovenliggende werkbalk een WM_HELPHITTEST bericht verwerkt.
CMFCToolBarButton::OnCtlColor Aangeroepen door het framework wanneer de bovenliggende werkbalk een WM_CTLCOLOR bericht verwerkt.
CMFCToolBarButton::OnCustomizeMenu Hiermee kan de knop het opgegeven menu wijzigen wanneer in de toepassing een snelmenu op de bovenliggende werkbalk wordt weergegeven.
CMFCToolBarButton::OnDblClk Aangeroepen door het framework wanneer de bovenliggende werkbalk een WM_LBUTTONDBLCLK bericht verwerkt.
CMFCToolBarButton::OnDraw Aangeroepen door het framework om de knop te tekenen met behulp van de opgegeven stijlen en opties.
CMFCToolBarButton::OnDrawOnCustomizeList Aangeroepen door het framework om de knop te tekenen in het deelvenster Opdrachten van het dialoogvenster Aanpassen .
CMFCToolBarButton::OnGetCustomToolTipText Aangeroepen door het framework om de aangepaste knopinfotekst voor de knop op te halen.
CMFCToolBarButton::OnGlobalFontsChanged Aangeroepen door het framework wanneer het algemene lettertype is gewijzigd.
CMFCToolBarButton::OnMove Aangeroepen door het framework wanneer de bovenliggende werkbalk wordt verplaatst.
CMFCToolButton::OnShow Aangeroepen door het framework wanneer de knop zichtbaar of onzichtbaar wordt.
CMFCToolButton::OnSize Aangeroepen door het framework wanneer de bovenliggende werkbalk de grootte of positie wijzigt en deze wijziging vereist dat de knop de grootte wijzigt.
CMFCToolBarButton::OnToolHitTest Aangeroepen door het framework wanneer de bovenliggende werkbalk moet bepalen of een punt zich in de begrenzingsrechthoek van de knop bevindt.
CMFCToolBarButton::OnUpdateToolTip Aangeroepen door het framework wanneer de bovenliggende werkbalk de tekst van de knopinfo bijwerkt.
CMFCToolBarButton::P repareDrag Aangeroepen door het framework wanneer de knop op het punt staat om een slepen-en-neerzetten-bewerking uit te voeren.
CMFCToolBarButton::Rect Hiermee haalt u de begrenzingsrechthoek van de knop op.
CMFCToolBarButton::ResetImageToDefault Hiermee stelt u de standaardwaarde in voor de afbeelding die aan de knop is gekoppeld.
CMFCToolBarButton::SaveBarState Hiermee wordt de status van de werkbalkknop opgeslagen.
CMFCToolBarButton::Serialize Leest dit object uit een archief of schrijft het naar een archief. (Overschrijft CObject::Serialize.)
CMFCToolBarButton::SetACCData Hiermee wordt het opgegeven CAccessibilityData object gevuld met toegankelijkheidsgegevens via de werkbalkknop.
CMFCToolBarButton::SetClipboardFormatName Hiermee wijzigt u de naam van de globale klembordindeling.
CMFCToolBarButton::SetImage Hiermee stelt u de afbeeldingsindex van de knop in.
CMFCToolBarButton::SetProtectedCommands Hiermee stelt u de lijst met opdrachten in die de gebruiker niet kan aanpassen.
CMFCToolBarButton::SetRadio Aangeroepen door het framework wanneer de status van een knop wordt gewijzigd.
CMFCToolBarButton::SetRect Hiermee stelt u de begrenzingsrechthoek van de knop in.
CMFCToolBarButton::SetStyle Hiermee stelt u de stijl van de knop in.
CMFCToolBarButton::SetVisible Hiermee geeft u op of de knop zichtbaar is.
CMFCToolBarButton::Show Hiermee wordt de knop weergegeven of verborgen.

Gegevensleden

Naam Description
CMFCToolBarButton::m_bImage Hiermee geeft u op of een afbeelding wordt weergegeven op de knop.
CMFCToolButton::m_bText Hiermee geeft u op of er een tekstlabel wordt weergegeven op de knop.
CMFCToolButton::m_bTextBelow Hiermee geeft u op of het tekstlabel wordt weergegeven onder de afbeelding op de knop.
CMFCToolBarButton::m_bUserButton Hiermee geeft u op of de knop een door de gebruiker gedefinieerde installatiekopieën heeft.
CMFCToolButton::m_bWholeText Hiermee geeft u op of de knop het label voor volledige tekst weergeeft, zelfs als deze niet in de begrenzingsrechthoek past.
CMFCToolBarButton::m_bWrap Hiermee geeft u op of de knop naast een scheidingsteken in de volgende rij wordt geplaatst.
CMFCToolButton::m_bWrapText Hiermee geeft u op of tekstlabels met meerdere regels zijn ingeschakeld.
CMFCToolBarButton::m_nID De opdracht-id van de knop.
CMFCToolBarButton::m_nStyle De stijl van de knop.
CMFCToolBarButton::m_strText Het tekstlabel van de knop.

Opmerkingen

Een CMFCToolbarButton object is een besturingselement dat zich op een werkbalk bevindt. Het gedrag lijkt op die van een gewone knop. U kunt een afbeelding en een tekstlabel toewijzen aan dit object. Een werkbalkknop kan ook een opdracht-id hebben. Wanneer de gebruiker op de werkbalkknop klikt, voert het framework de opdracht uit die met deze id wordt opgegeven.

Werkbalkknoppen kunnen doorgaans worden aangepast: de gebruiker kan knoppen van de ene werkbalk naar de andere slepen en tekstlabels en afbeeldingen kopiëren, plakken, verwijderen en bewerken. Als u wilt voorkomen dat de gebruiker de werkbalk kan aanpassen, kunt u de werkbalk op twee manieren vergrendelen. Stel de bLocked vlag in op TRUE wanneer u CMFCToolBar::LoadToolBar aanroept of voeg de opdracht-id van een afzonderlijke knop toe aan de algemene lijst met beveiligde opdrachten met behulp van de methode CMFCToolBarButton::SetProtectedCommands .

CMFCToolBarButton objecten geven afbeeldingen weer uit de globale verzamelingen werkbalkafbeeldingen in de toepassing. Deze verzamelingen worden onderhouden door de bovenliggende werkbalk, CMFCToolBar Class. Zie CMFCToolBarImages Class voor meer informatie.

Wanneer de gebruiker op een werkbalkknop klikt, verwerkt de bovenliggende werkbalk het muisbericht en communiceert de juiste acties naar de knop. Als de knop een geldige opdracht-id heeft, verzendt de bovenliggende werkbalk het WM_COMMAND bericht naar het bovenliggende frame.

De CMFCToolBarButton klasse is de basisklasse voor andere werkbalkknopklassen, zoals CMFCToolBarMenuButton Class, CMFCToolBarEditBoxButton Class en CMFCToolBarComboBoxButton Class.

Example

In het volgende voorbeeld ziet u hoe u een CMFCToolBarButton object configureert met behulp van verschillende methoden in de CMFCToolBarButton klasse. In het voorbeeld ziet u hoe u de invoer van de muis en het toetsenbord inschakelt, de afbeeldingsindex van de knop instelt, de begrenzingsrechthoek van de knop instelt en de knop zichtbaar maakt. Dit codefragment maakt deel uit van het tab-besturingselement.

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

Overnamehiërarchie

CObject

CMFCToolBarButton

Requirements

Koptekst: afxtoolbarbutton.h

CMFCToolBarButton::CanBeDropped

Hiermee geeft u op of een gebruiker een knop op een werkbalk of menu kan plaatsen tijdens het aanpassen.

virtual BOOL CanBeDropped(CMFCToolBar* pToolbar);

Parameterwaarden

pToolbar
[in] Ongebruikte.

Retourwaarde

Deze methode retourneert TRUE.

Opmerkingen

Standaard kan een werkbalkknop worden verwijderd op elke aanpasbare (dat wil gezegd, niet-vergrendelde) werkbalk.

De standaard implementatie van deze methode retourneert TRUE. Overschrijf deze methode en retourneer FALSE als u wilt voorkomen dat de gebruiker de positie van de knop wijzigt.

CMFCToolBarButton::CanBeStored

Bepaalt of de knop kan worden opgeslagen.

virtual BOOL CanBeStored() const;

Retourwaarde

Deze methode retourneert TRUE.

Opmerkingen

Het framework gebruikt deze methode om te bepalen of de knop kan deelnemen aan een slepen-en-neerzetten-bewerking.

De standaard implementatie retourneert TRUE. Overschrijf deze methode als de knop niet kan worden opgeslagen als onderdeel van een slepen-en-neerzetten-bewerking. Zie OLE-slepen en neerzetten voor meer informatie over slepen en neerzetten.

CMFCToolBarButton::CanBeStretched

Hiermee geeft u op of een gebruiker de knop tijdens het aanpassen kan uitrekken.

virtual BOOL CanBeStretched() const;

Retourwaarde

Deze methode retourneert FALSE.

Opmerkingen

Deze methode wordt door het framework gebruikt om te bepalen of de knop kan worden uitgerekt in de aanpassingsmodus.

De standaard implementatie van deze methode retourneert FALSE. Overschrijf deze methode om TRUE te retourneren voor een besturingselement met variabele breedte, zoals een keuzelijst met invoervak of schuifregelaar.

Zie CMFCToolBar::SetCustomizeMode voor meer informatie over de aanpassingsmodus.

CMFCToolBarButton::CMFCToolBarButton

Maakt en initialiseert een CMFCToolBarButton object.

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

Parameterwaarden

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

iImage
[in] De afbeeldingsindex van de knop in de verzameling afbeeldingen.

lpszText
[in] Het tekstlabel van de knop. Kan NULL zijn.

bUserButton
[in] Een Booleaanse waarde die bepaalt of de knop door de gebruiker is gedefinieerd. Als deze parameter TRUE is, is de knop door de gebruiker gedefinieerd. Anders wordt de knopafbeelding geladen vanuit een resource.

Geblokkeerd
[in] Een Booleaanse waarde die bepaalt of de knop kan worden aangepast. Als deze parameter TRUE is, kan de knop niet worden aangepast. Anders kan de knop worden aangepast.

CMFCToolBarButton::CompareWith

Vergelijkt dit exemplaar met het opgegeven CMFCToolBarButton object.

virtual BOOL CompareWith(const CMFCToolBarButton& other) const;

Parameterwaarden

ander
[in] Verwijzing naar het object dat moet worden vergeleken met dit exemplaar.

Retourwaarde

Niet-nul als het opgegeven object gelijk is aan de waarde van dit exemplaar; anders, 0.

Opmerkingen

De standaard implementatie bepaalt of de opdracht-id van het opgegeven object gelijk is aan de opdracht-id van dit exemplaar. Overschrijf deze methode als u extra verwerking moet uitvoeren om te bepalen of twee CMFCToolBarButton objecten gelijk zijn.

CMFCToolBarButton::CopyFrom

Hiermee kopieert u de eigenschappen van een andere werkbalkknop naar de huidige knop.

virtual void CopyFrom(const CMFCToolBarButton& src);

Parameterwaarden

Src
[in] Een verwijzing naar de bronknop waaruit u wilt kopiëren.

Opmerkingen

Roep deze methode aan om een andere werkbalkknop naar deze werkbalkknop te kopiëren.

CMFCToolBarButton::CreateFromOleData

Hiermee maakt u een CMFCToolBarButton object op basis van het opgegeven COleDataObject object.

static CMFCToolBarButton* __stdcall CreateFromOleData(COleDataObject* pDataObject);

Parameterwaarden

pDataObject
[in] Het OLE-brongegevensobject.

Retourwaarde

Het gemaakte CMFCToolBarButton object.

Opmerkingen

Deze methode wordt door het framework gebruikt om gegevensoverdracht in verschillende indelingen uit te voeren. De CMFCOutlookBarPane::OnDragOver methode gebruikt deze methode bijvoorbeeld om slepen-en-neerzetten-bewerkingen uit te voeren.

CMFCToolBarButton::EnableWindow

Hiermee schakelt u muis- en toetsenbordinvoer in of uit.

virtual void EnableWindow(BOOL bEnable = TRUE);

Parameterwaarden

bEnable
[in] Stel deze parameter in op TRUE om invoer in te schakelen of op FALSE om invoer uit te schakelen.

Opmerkingen

Met deze methode wordt de EnableWindow functie aangeroepen om invoer in of uit te schakelen. Zie EnableWindow in de Windows SDK voor meer informatie.

CMFCToolBarButton::ExportToMenuButton

Hiermee kopieert u tekst van de werkbalkknop naar een menu.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

Parameterwaarden

menuButton
[in] Een verwijzing naar de knop doelmenu.

Retourwaarde

Deze methode retourneert TRUE.

Opmerkingen

In het framework wordt deze methode aangeroepen om de tekst van een werkbalkknop naar een menuknop te kopiëren. Met de standaard implementatie wordt het tekstlabel van de knop gekopieerd. Als het tekstlabel leeg is, kopieert deze methode de knopinfotekst van de knop.

De standaard implementatie van deze methode retourneert TRUE. Overschrijf deze methode als u extra acties wilt ondernemen wanneer het framework een object converteert dat is afgeleid van CMFCToolbarButton naar een menuknop.

CMFCToolBarButton::GetClipboardFormat

Hiermee haalt u de algemene klembordindeling voor de toepassing op.

static CLIPFORMAT __stdcall GetClipboardFormat();

Retourwaarde

De globale CLIPFORMAT-waarde voor de toepassing.

Opmerkingen

Dit framework roept deze methode aan om de klembordindeling voor OLE-gegevensoverdrachtsbewerkingen op te halen. De methode CMFCToolBarButton::CreateFromOleData gebruikt deze methode om gegevens te kopiëren van een OLE-bronobject.

Met deze methode stelt u de globale WAARDE VAN CLIPFORMAT in wanneer deze methode de eerste keer wordt aangeroepen. Alle volgende aanroepen naar deze methode retourneren deze waarde.

Roep de methode CMFCToolBarButton::SetClipboardFormatName aan om slepen en neerzetten tussen toepassingen mogelijk te maken.

Zie Klembord voor meer informatie over klemborden in MFC.

CMFCToolBarButton::GetHwnd

Hiermee haalt u de venstergreep op die is gekoppeld aan de werkbalkknop.

virtual HWND GetHwnd();

Retourwaarde

De venstergreep die is gekoppeld aan de werkbalkknop of NULL als de werkbalkknop geen gekoppelde venstergreep heeft.

Opmerkingen

De standaard implementatie van deze methode retourneert NULL. Overschrijf deze methode om de venstergreep van uw specifieke besturingselement te retourneren.

CMFCToolBarButton::GetImage

Haalt de afbeeldingsindex van de knop op.

int GetImage() const;

Retourwaarde

De index van de afbeelding die aan deze knop is gekoppeld.

Opmerkingen

Als de knop een door de gebruiker gedefinieerde installatiekopie bevat (als bUserButton TRUE was in de constructor), geeft de geretourneerde index een afbeelding op in de verzameling door de gebruiker gedefinieerde afbeeldingen (zie CMFCToolBar::GetUserImages). Anders geeft de index een afbeelding op in de verzameling afbeeldingen die zijn geladen vanuit een resourcebestand (zie CMFCToolBar::GetImages). Zie Werken met resourcebestanden voor meer informatie over resourcebestanden.

CMFCToolBarButton::GetInvalidateRect

Hiermee wordt de regio van het clientgebied van de knop opgehaald die opnieuw moet worden getekend.

virtual const CRect GetInvalidateRect() const;

Retourwaarde

Een CRect object dat de regio aangeeft die opnieuw moet worden getekend.

Opmerkingen

De standaard implementatie van deze methode retourneert het hele clientgebied. Overschrijf deze methode als u een ander gebied opnieuw wilt tekenen.

CMFCToolBarButton::GetParentWnd

Hiermee wordt het bovenliggende venster van de knop opgehaald.

CWnd* GetParentWnd() const;

Retourwaarde

Het bovenliggende venster van de knop.

CMFCToolBarButton::GetProtectedCommands

Haalt de lijst met opdrachten op die de gebruiker niet kan aanpassen.

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

Retourwaarde

De lijst met beveiligde opdrachten.

Opmerkingen

In de aanpassingsmodus worden opdrachten op de werkbalkknop uitgeschakeld die zijn beveiligd. De gebruiker kan geen bewerkingen voor slepen en neerzetten uitvoeren op uitgeschakelde werkbalkknoppen.

Gebruik de methode CMFCToolBarButton::SetProtectedCommands om de lijst met beveiligde opdrachten te definiëren.

CMFCToolBarButton::GetTextSize

Hiermee wordt de grootte van de knoptekst opgehaald.

SIZE GetTextSize() const;

Retourwaarde

Een SIZE-object met de grootte, in pixels, van de knoptekst.

CMFCToolBarButton::HasFocus

Bepaalt of de knop de huidige invoerfocus heeft.

virtual BOOL HasFocus() const;

Retourwaarde

Niet-nul als de knop de invoerfocus heeft; anders 0.

Opmerkingen

De standaard implementatie van deze methode retourneert niet-nul als de knop de invoerfocus heeft of een onderliggend of onderliggend venster is van het venster met de invoerfocus. U kunt deze functie overschrijven om dit gedrag aan te passen.

CMFCToolBarButton::HaveHotBorder

Bepaalt of een rand van de knop wordt weergegeven wanneer een gebruiker de knop selecteert.

virtual BOOL HaveHotBorder() const;

Retourwaarde

Deze methode retourneert TRUE.

Opmerkingen

In het framework wordt deze methode aangeroepen om te bepalen of de werkbalkknop de rand ervan moet weergeven wanneer een gebruiker deze selecteert.

De standaard implementatie retourneert TRUE. U kunt deze methode overschrijven om dit gedrag aan te passen.

CMFCToolBarButton::IsDrawImage

Bepaalt of een afbeelding wordt weergegeven op de knop.

BOOL IsDrawImage() const;

Retourwaarde

Niet-nul als een afbeelding op de knop wordt weergegeven; anders 0.

Opmerkingen

Deze methode retourneert FALSE als de werkbalkknop geen gekoppelde afbeelding heeft ( CMFCToolBarButton::GetImage retourneert -1) of als CMFCToolBarButton::m_bImage is ingesteld op FALSE.

CMFCToolBarButton::IsDrawText

Bepaalt of een tekstlabel wordt weergegeven op de knop.

BOOL IsDrawText() const;

Retourwaarde

Niet-nul als een tekstlabel wordt weergegeven; anders 0.

Opmerkingen

Deze methode retourneert FALSE als de werkbalkknop geen gekoppeld tekstlabel ( CMFCToolBarButton::m_strText leeg is) of CMFCToolBarButton::m_bText is ingesteld op FALSE.

CMFCToolBarButton::IsDroppedDown

Bepaalt of op de knop een submenu wordt weergegeven.

virtual BOOL IsDroppedDown() const;

Retourwaarde

Deze methode retourneert FALSE.

Opmerkingen

De standaard implementatie van deze methode retourneert FALSE. Overschrijf deze methode om TRUE te retourneren als in uw besturingselement een submenu wordt weergegeven.

CMFCToolBarButton::IsEditable

Bepaalt of de knop kan worden aangepast.

virtual BOOL IsEditable() const;

Retourwaarde

Nonzero als een knop door de gebruiker kan worden aangepast; anders 0.

Opmerkingen

In het framework wordt deze methode aangeroepen om te bepalen of de gebruiker de werkbalkknop kan aanpassen met behulp van bewerkingen voor slepen en neerzetten of bewerken.

De standaard implementatie retourneert FALSE als de opdracht-id van de knop een standaardopdracht is (u kunt dit bepalen door de IsStandardCommand functie aan te roepen) of als de opdracht-id in de lijst met beveiligde opdrachten staat. Zie CMFCToolBarButton::GetProtectedCommands en CMFCToolBarButton::SetProtectedCommands voor meer informatie over beveiligde opdrachten.

Overschrijf deze methode om het gedrag ervan aan te passen.

CMFCToolBarButton::IsExtraSize

Bepaalt of de knop kan worden weergegeven met een uitgebreide rand.

virtual BOOL IsExtraSize() const;

Retourwaarde

Niet-nul als de werkbalkknop kan worden weergegeven met een uitgebreide rand; anders 0.

Opmerkingen

Verschillende skins gebruiken extra grootte voor de randen van werkbalkknoppen (bijvoorbeeld ronde knoppen).

Als de gebruiker deze knop van de ene werkbalk naar de andere verplaatst, roept het framework de methode CMFCToolBarButton::OnChangeParentWnd aan. De methode CMFCToolBarButton::OnChangeParentWnd stelt de vlag extra grootte in op die van de nieuwe bovenliggende werkbalk (zie CMFCToolBar::IsButtonExtraSizeAvailable) voor meer informatie.

CMFCToolBarButton::IsFirstInGroup

Bepaalt of de knop zich op de eerste positie in de knopgroep bevindt.

virtual BOOL IsFirstInGroup() const;

Retourwaarde

WAAR als de knop de eerste knop in de knopgroep is; anders ONWAAR.

Opmerkingen

Met deze methode wordt een knopgroep gedefinieerd als een aangrenzende set knoppen die op dezelfde rij zijn geplaatst en zijn gebonden door scheidingstekens of de rand van de werkbalk. Deze methode retourneert FALSE als de werkbalkknop verwijst naar de knop Aanpassen . Zie CMFCToolBar::GetCustomizeButton voor meer informatie over de knop Aanpassen.

Roep de methode CMFCToolBarButton::IsLastInGroup aan om te bepalen of de knop zich op de laatste positie in de knopgroep bevindt.

CMFCToolBarButton::IsHidden

Bepaalt of de knop verborgen is.

BOOL IsHidden() const;

Retourwaarde

Niet-nul als de knop verborgen is (onzichtbaar); anders 0.

Opmerkingen

Dit framework roept deze methode aan wanneer de bovenliggende werkbalk wordt uitgerekt om te bepalen of de werkbalkknop zichtbaar is.

Als u de knop zodanig instelt dat deze onzichtbaar is met behulp van de methode CMFCToolBarButton::SetVisible , gebruikt u CMFCToolBarButton::IsVisible om te bepalen of de werkbalkknop zichtbaar is.

Standaard zijn alle werkbalkknoppen zichtbaar. Gebruik de methode CMFCToolBarButton::Show om werkbalkknoppen te verbergen of weer te geven.

CMFCToolBarButton::IsHorizontal

Bepaalt of de knop zich op een horizontale werkbalk bevindt.

BOOL IsHorizontal() const;

Retourwaarde

Niet-nul als een werkbalkknop zich op een horizontale werkbalk bevindt; anders 0.

Opmerkingen

Dit framework roept deze methode aan om de indeling van werkbalkknoppen te bepalen.

Met deze methode wordt het m_bHorz gegevenslid geretourneerd. De standaardwaarde van het m_bHorz gegevenslid is TRUE; deze wordt opnieuw ingesteld voor elke aanroep naar de methode CMFCToolBarButton::OnDraw .

CMFCToolBarButton::IsLastInGroup

Hiermee geeft u op of de knop zich op de laatste positie in de knopgroep bevindt.

virtual BOOL IsLastInGroup() const;

Retourwaarde

WAAR als de knop de laatste knop in de knopgroep is; anders ONWAAR.

Opmerkingen

Met deze methode wordt een knopgroep gedefinieerd als een aangrenzende set knoppen die op dezelfde rij zijn geplaatst en zijn gebonden door scheidingstekens of de rand van de werkbalk Deze methode retourneert ONWAAR als de werkbalkknop geen bovenliggende werkbalk heeft of de werkbalkknop verwijst naar de knop Aanpassen . Zie CMFCToolBar::GetCustomizeButton voor meer informatie over de knop Aanpassen.

Roep de methode CMFCToolBarButton::IsFirstInGroup aan om te bepalen of de knop zich op de eerste positie in de knopgroep bevindt.

CMFCToolBarButton::IsLocked

Bepaalt of de knop zich op een vergrendelde (niet-aanpasbare) werkbalk bevindt.

BOOL IsLocked() const;

Retourwaarde

Niet-nul als de knop zich op een vergrendelde werkbalk bevindt; anders 0.

Opmerkingen

In het framework wordt deze methode aangeroepen om te bepalen of de gebruiker de werkbalkknop kan aanpassen met behulp van bewerkingen voor slepen en neerzetten of bewerken. Stel het vergrendelde kenmerk op de bovenliggende werkbalk in met behulp van de methode CMFCToolBar::LoadToolBar . Het framework geeft de waarde van dit kenmerk door aan de constructor van elke werkbalkknop ( CMFCToolbarButton) die in de bovenliggende werkbalk wordt ingevoegd.

CMFCToolBarButton::IsOwnerOf

Bepaalt of de knop de eigenaar is van de opgegeven venstergreep.

virtual BOOL IsOwnerOf(HWND hwnd);

Parameterwaarden

hwnd
[in] Een venstergreep.

Retourwaarde

Nonzero als de knop de eigenaar is van de opgegeven venstergreep; anders 0.

Opmerkingen

Deze methode retourneert niet-nul als hwnd verwijst naar de directe venstergreep of een onderliggend element is van de venstergreep die aan de knop is gekoppeld. Deze methode retourneert 0 als hwnd NULL is.

CMFCToolBarButton::IsVisible

Bepaalt of de werkbalkknop zichtbaar is.

BOOL IsVisible() const;

Retourwaarde

Niet-nul als de werkbalkknop zichtbaar is; anders 0.

Opmerkingen

U kunt de werkbalkknop weergeven of verbergen met behulp van de methode CMFCToolBarButton::SetVisible . Roep de methode CPane::AdjustSizeImmediate aan op de bovenliggende werkbalk nadat u CMFCToolBarButton::SetVisible hebt aangeroepen om de indeling van een bovenliggende werkbalk opnieuw te berekenen.

CMFCToolBarButton::IsWindowVisible

Bepaalt of de onderliggende venstergreep van de knop zichtbaar is.

virtual BOOL IsWindowVisible();

Retourwaarde

Niet-nul als de onderliggende venstergreep van de knop zichtbaar is; anders 0.

Opmerkingen

Deze methode retourneert niet-nul als het stijlkenmerk van de onderliggende venstergreep de WS_VISIBLE stijl bevat. Deze methode retourneert FALSE als de onderliggende venstergreep van de knop NULL is.

CMFCToolBarButton::m_bImage

Hiermee geeft u op of een afbeelding wordt weergegeven op de knop.

BOOL m_bImage;

Opmerkingen

Als dit gegevenslid is ingesteld op TRUE, wordt in het framework de afbeelding weergegeven die is gekoppeld aan de werkbalkknop; anders wordt de afbeelding niet weergegeven in het framework. Dit lid is van invloed op de retourwaarde van de methode CMFCToolBarButton::m_bImage .

CMFCToolButton::m_bText

Hiermee geeft u op of er een tekstlabel wordt weergegeven op de knop.

BOOL m_bText;

Opmerkingen

Als dit gegevenslid is ingesteld op TRUE, wordt in het framework het tekstlabel van de werkbalkknop weergegeven; anders wordt het tekstlabel niet weergegeven in het framework. Dit lid is van invloed op de retourwaarde van de methode CMFCToolBarButton::m_bText .

CMFCToolButton::m_bTextBelow

Hiermee geeft u op of het tekstlabel wordt weergegeven onder de afbeelding op de knop.

BOOL m_bTextBelow;

Opmerkingen

Als deze lidvariabele is ingesteld op TRUE, wordt in het framework de tekst van de knop onder de afbeelding weergegeven. De standaardwaarde van dit lid is FALSE.

CMFCToolBarButton::m_bUserButton

Hiermee geeft u op of de knop een door de gebruiker gedefinieerde installatiekopieën heeft

BOOL m_bUserButton;

Opmerkingen

Dit gegevenslid is ingesteld op TRUE wanneer aan de knop een door de gebruiker gedefinieerde installatiekopieën zijn gekoppeld.

CMFCToolButton::m_bWholeText

Hiermee geeft u op of de knop het label voor volledige tekst weergeeft, zelfs als deze niet in de begrenzingsrechthoek past.

BOOL m_bWholeText;

Opmerkingen

Als dit gegevenslid is ingesteld op TRUE, wordt in het framework het label voor volledige tekst weergegeven door de knop te vergroten. Anders wordt in het framework een beletselteken ( ...) afgekapt en toegevoegd aan het tekstlabel.

CMFCToolBarButton::m_bWrap

Hiermee geeft u op of de knop naast een scheidingsteken in de volgende rij wordt geplaatst.

BOOL m_bWrap;

Opmerkingen

Het framework stelt dit gegevenslid in op TRUE wanneer de werkbalkknop niet in de huidige rij past of wanneer u een indeling opgeeft (bijvoorbeeld een specifiek aantal werkbalkknoppen per rij).

Het framework plaatst deze knop op de volgende rij als dit gegevenslid is ingesteld op TRUE en de werkbalk horizontaal of zwevend wordt vastgezet.

De standaardwaarde van dit gegevenslid is FALSE.

CMFCToolButton::m_bWrapText

Hiermee geeft u op of tekstlabels met meerdere regels zijn ingeschakeld.

AFX_IMPORT_DATA static BOOL m_bWrapText;

Opmerkingen

Als deze statische lidvariabele TRUE is, kunnen in het framework alle werkbalken tekstlabels met meerdere regels worden weergegeven op werkbalkknoppen.

De standaardwaarde van dit gegevenslid is FALSE.

CMFCToolBarButton::m_nID

De opdracht-id van de knop.

UINT m_nID;

Opmerkingen

Een opdracht-id van -1 geeft aan dat de knop een scheidingsteken is. Alle knopscheidingstekens hebben de stijl TBBS_SEPARATOR. Zie CMFCToolBarButton::m_nStyle voor meer informatie over knopstijlen.

CMFCToolBarButton::m_nStyle

De stijl van de knop.

UINT m_nStyle;

Opmerkingen

Zie Werkbalkbesturingsstijlen voor de lijst met beschikbare werkbalkknopstijlen.

CMFCToolBarButton::m_strText

Het tekstlabel van de knop.

CString m_strText;

Opmerkingen

Dit gegevenslid bevat het tekstlabel van de knop. Het tekstlabel kan leeg zijn.

CMFCToolBarButton::NotifyCommand

Hiermee geeft u op of de knop het WM_COMMAND bericht verwerkt.

virtual BOOL NotifyCommand(int iNotifyCode);

Parameterwaarden

iNotifyCode
[in] Het meldingsbericht dat is gekoppeld aan de opdracht.

Retourwaarde

Deze methode retourneert FALSE.

Opmerkingen

Dit framework roept deze methode aan wanneer er een WM_COMMAND bericht naar het bovenliggende venster wordt verzonden.

Deze methode retourneert standaard FALSE. Overschrijf deze methode om TRUE te retourneren als u het WM_COMMAND bericht of ONWAAR wilt verwerken om aan te geven dat de bovenliggende werkbalk het bericht moet verwerken.

CMFCToolBarButton::OnAddToCustomizePage

Aangeroepen door het framework wanneer de knop wordt toegevoegd aan een dialoogvenster Aanpassen .

virtual void OnAddToCustomizePage();

Opmerkingen

De standaard implementatie van deze methode doet niets. Overschrijf deze methode als u een actie wilt uitvoeren wanneer de knop wordt toegevoegd aan een dialoogvenster Aanpassen .

CMFCToolBarButton::OnBeforeDrag

Hiermee geeft u op of de knop kan worden gesleept.

virtual BOOL OnBeforeDrag() const;

Retourwaarde

WAAR als de knop kan worden gesleept; anders ONWAAR.

Opmerkingen

Het framework roept deze methode aan voordat de gebruiker de knop gaat slepen.

De standaard implementatie van deze methode retourneert TRUE. Overschrijf deze methode om FALSE te retourneren om slepen van de knop uit te schakelen.

CMFCToolBarButton::OnBeforeDrop

Hiermee geeft u op of een gebruiker de knop op de doelwerkbalk kan neerzetten.

virtual BOOL OnBeforeDrop(CMFCToolBar* pTarget);

Parameterwaarden

pTarget
[in] Het doel van de bewerking slepen en neerzetten.

Retourwaarde

WAAR als de knop kan worden neergezet op de opgegeven doelwerkbalk; anders ONWAAR.

Opmerkingen

In het framework wordt deze methode aangeroepen voordat de knop op een werkbalk wordt geplaatst.

De standaard implementatie van deze methode retourneert TRUE. Overschrijf deze methode om FALSE te retourneren om de drop-bewerking op het opgegeven doel uit te schakelen.

CMFCToolBarButton::OnCalculateSize

Aangeroepen door het framework om de grootte van de knop voor de opgegeven apparaatcontext en dockingstatus te berekenen.

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

Parameterwaarden

Pdc
[in] De apparaatcontext waarin de knop wordt weergegeven.

sizeDefault
[in] De standaardgrootte van de knop.

bHorz
[in] De dockstatus van de bovenliggende werkbalk. Deze parameter is TRUE als de werkbalk horizontaal is gedokt of zwevend is, of ONWAAR als de werkbalk verticaal is gedokt.

Retourwaarde

Een SIZE structuur die de afmetingen van de knop bevat, in pixels.

Opmerkingen

In het framework wordt deze methode aangeroepen om de grootte van de werkbalkknop voor de opgegeven apparaatcontext en dockstatus te bepalen.

De standaard implementatie houdt rekening met de grootte van tekst en afbeeldingen (als deze worden weergegeven), de tekst- en afbeeldingsposities (de tekst onder of aan de rechterkant van de afbeelding) en de status van het werkbalkstation.

Overschrijf deze methode als u de grootte van een niet-standaardknop wilt opgeven (bijvoorbeeld een knop bewerken).

CMFCToolBarButton::OnCancelMode

Wordt aangeroepen door het framework om het WM_CANCELMODE bericht af te handelen.

virtual void OnCancelMode();

Opmerkingen

De standaard implementatie van deze methode doet niets. Overschrijf deze methode als u het WM_CANCELMODE bericht wilt verwerken.

CMFCToolBarButton::OnChangeParentWnd

Aangeroepen door het framework wanneer de knop wordt ingevoegd in een nieuwe werkbalk.

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parameterwaarden

pWndParent
[in] Het nieuwe bovenliggende venster.

Opmerkingen

De knop wordt ingevoegd in een werkbalk, bijvoorbeeld wanneer de gebruiker deze van de ene werkbalk naar een andere werkbalk sleept.

De standaard implementatie van deze methode doet niets.

CMFCToolBarButton::OnClick

Aangeroepen door het framework wanneer de gebruiker op de muisknop klikt.

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

Parameterwaarden

pWnd
[in] Het bovenliggende venster van de werkbalkknop.

bDelay
[in] WAAR als het bericht met een vertraging moet worden verwerkt.

Retourwaarde

Deze methode retourneert FALSE.

Opmerkingen

Dit framework roept deze methode aan wanneer de gebruiker op de werkbalkknop klikt.

De standaard implementatie doet niets en retourneert FALSE. Overschrijf deze methode om een niet-nulwaarde te retourneren als de knop het klikbericht verwerkt.

CMFCToolBarButton::OnClickUp

Aangeroepen door het framework wanneer de gebruiker de muisknop loslaat.

virtual BOOL OnClickUp();

Retourwaarde

Deze methode retourneert FALSE.

Opmerkingen

In het framework wordt deze methode aangeroepen wanneer de gebruiker de werkbalkknop loslaat.

De standaard implementatie doet niets en retourneert FALSE. Overschrijf deze methode om een niet-nulwaarde te retourneren als de knop het klikbericht verwerkt.

CMFCToolBarButton::OnContextHelp

Aangeroepen door het framework wanneer de bovenliggende werkbalk een WM_HELPHITTEST bericht verwerkt.

virtual BOOL OnContextHelp(CWnd* pWnd);

Parameterwaarden

pWnd
[in] Het bovenliggende venster van de werkbalkknop.

Retourwaarde

Deze methode retourneert FALSE.

Opmerkingen

De standaard implementatie van deze methode doet niets en retourneert FALSE. Overschrijf deze methode om een niet-nulwaarde te retourneren als de knop het Help-bericht verwerkt.

Zie TN028 voor meer informatie over het WM_HELPHITTEST bericht: Context-Sensitive Help-ondersteuning.

CMFCToolBarButton::OnCtlColor

Aangeroepen door het framework wanneer de bovenliggende werkbalk een WM_CTLCOLOR bericht verwerkt.

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

Parameterwaarden

Pdc
[in] De apparaatcontext waarin de knop wordt weergegeven.

nCtlColor
[in] De specifieke kleurmelding.

Retourwaarde

Een handgreep voor het penseelobject dat door het framework wordt gebruikt om de achtergrond van de knop te schilderen.

Opmerkingen

Dit framework roept deze methode aan wanneer de bovenliggende werkbalk het WM_CTLCOLOR bericht verwerkt voor een werkbalkknop die een Windows-besturingselement bevat. Dit framework roept deze methode niet aan als de werkbalkknop vensterloos is.

Het framework roept deze methode aan wanneer het werkbalkframework zich in de aanpassingsmodus bevindt en de werkbalkknop is ontgrendeld. Zie CMFCToolBar::SetCustomizeMode voor meer informatie over de aanpassingsmodus. Zie CMFCToolBarButton::IsLocked voor meer informatie over het vergrendelen van werkbalkknoppen.

De standaard implementatie doet niets en retourneert NULL.

CMFCToolBarButton::OnCustomizeMenu

Hiermee kan de knop het opgegeven menu wijzigen wanneer in de toepassing een snelmenu op de bovenliggende werkbalk wordt weergegeven.

virtual BOOL OnCustomizeMenu(CMenu* pMenu);

Parameterwaarden

pMenu
[in] Het menu dat u wilt aanpassen.

Retourwaarde

Deze methode retourneert FALSE.

Opmerkingen

De standaard implementatie doet niets en retourneert FALSE. Overschrijf deze methode en retourneer een niet-nulwaarde als u de inhoud van het opgegeven menu wilt wijzigen.

CMFCToolBarButton::OnDblClk

Aangeroepen door het framework wanneer de bovenliggende werkbalk een WM_LBUTTONDBLCLK bericht verwerkt.

virtual void OnDblClk(CWnd* pWnd);

Parameterwaarden

pWnd
[in] - Het bovenliggende venster van de knop.

Opmerkingen

Deze methode wordt aangeroepen door de CMFCToolBar::OnLButtonDblClk methode wanneer de bovenliggende werkbalk een WM_LBUTTONDBLCLK bericht verwerkt.

De standaard implementatie van deze methode doet niets.

CMFCToolBarButton::OnDraw

Aangeroepen door het framework om de knop te tekenen met behulp van de opgegeven stijlen en opties.

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

Parameterwaarden

Pdc
[in] De apparaatcontext waarin de knop wordt weergegeven.

Rect
[in] De begrenzingsrechthoek van de knop.

pImages
[in] De verzameling werkbalkafbeeldingen die aan de knop zijn gekoppeld.

bHorz
[in] De dockstatus van de bovenliggende werkbalk. Deze parameter is TRUE wanneer de knop horizontaal wordt gedokt en ONWAAR wanneer de knop verticaal wordt gedokt.

bCustomizeMode
[in] Hiermee geeft u op of de werkbalk zich in de aanpassingsmodus bevindt. Deze parameter is TRUE wanneer de werkbalk zich in de aanpassingsmodus bevindt en ONWAAR wanneer de werkbalk zich niet in de aanpassingsmodus bevindt.

bHighlight
[in] Hiermee geeft u op of de knop is gemarkeerd. Deze parameter is WAAR wanneer de knop is gemarkeerd en ONWAAR wanneer de knop niet is gemarkeerd.

bDrawBorder
[in] Hiermee geeft u op of de knop de rand moet weergeven. Deze parameter is WAAR wanneer de rand van de knop moet worden weergegeven en ONWAAR wanneer de rand van de knop niet moet worden weergegeven.

bGrayDisabledButtons
[in] Hiermee geeft u op of uitgeschakelde knoppen moeten worden gearced of de verzameling met uitgeschakelde afbeeldingen moet worden gebruikt. Deze parameter is TRUE wanneer uitgeschakelde knoppen moeten worden gearceerd en ONWAAR wanneer deze methode de verzameling uitgeschakelde installatiekopieën moet gebruiken.

Opmerkingen

Overschrijf deze methode om de werkbalkknoptekening aan te passen.

CMFCToolBarButton::OnDrawOnCustomizeList

Aangeroepen door het framework om de knop te tekenen in het deelvenster Opdrachten van het dialoogvenster Aanpassen .

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

Parameterwaarden

Pdc
[in] De apparaatcontext waarin de knop wordt weergegeven.

Rect
[in] De begrenzingsrechthoek van de knop.

bSelected
[in] Hiermee geeft u op of de knop is geselecteerd. Als deze parameter TRUE is, wordt de knop geselecteerd. Als deze parameter ONWAAR is, wordt de knop niet geselecteerd.

Retourwaarde

De breedte, in pixels, van de knop in de opgegeven apparaatcontext.

Opmerkingen

Deze methode wordt aangeroepen door het dialoogvenster Aanpassing (tabblad Opdrachten ) wanneer de knop op het punt staat zichzelf weer te geven in de keuzelijst met eigenaartekeningen.

Bij de standaard implementatie van deze methode worden de afbeelding en het tekstlabel van de knop weergegeven als deze beschikbaar zijn. Als het tekstlabel van de knop niet beschikbaar is, geeft de methode de knopinfotekst weer.

Overschrijf deze methode om aangepaste tekening uit te voeren.

CMFCToolBarButton::OnGetCustomToolTipText

Aangeroepen door het framework om de aangepaste knopinfotekst voor de knop op te halen.

virtual BOOL OnGetCustomToolTipText(CString& strToolTip);

Parameterwaarden

strToolTip
[uit] Een CString object dat de aangepaste knopinfotekst ontvangt.

Retourwaarde

Deze methode retourneert FALSE.

Opmerkingen

In het framework wordt deze methode aangeroepen wanneer de knopinfo voor de werkbalkknop wordt weergegeven. Als deze methode FALSE retourneert, gebruikt het framework standaardknopinfo.

De standaard implementatie doet niets en retourneert FALSE. Overschrijf deze methode en retourneer een niet-nulwaarde om aangepaste knopinfotekst voor de werkbalkknop op te geven.

CMFCToolBarButton::OnGlobalFontsChanged

Aangeroepen door het framework wanneer het algemene lettertype is gewijzigd.

virtual void OnGlobalFontsChanged();

Opmerkingen

De standaard implementatie van deze methode doet niets. Overschrijf deze methode om het lettertype bij te werken dat wordt gebruikt om de knoptekst weer te geven.

CMFCToolBarButton::OnMove

Aangeroepen door het framework wanneer de bovenliggende werkbalk wordt verplaatst.

virtual void OnMove();

Opmerkingen

De standaard implementatie van deze methode doet niets. Overschrijf deze methode om de knop te verplaatsen wanneer de bovenliggende werkbalk wordt verplaatst.

CMFCToolButton::OnShow

Aangeroepen door het framework wanneer de knop zichtbaar of onzichtbaar wordt.

virtual void OnShow(BOOL bShow);

Parameterwaarden

bShow
[in] Hiermee geeft u op of de knop zichtbaar is. Als deze parameter TRUE is, is de knop zichtbaar. Anders is de knop niet zichtbaar.

Opmerkingen

De standaard implementatie van deze methode doet niets. Overschrijf deze methode om de zichtbaarheid van de knop bij te werken.

CMFCToolButton::OnSize

Aangeroepen door het framework wanneer de bovenliggende werkbalk de grootte of positie wijzigt en deze wijziging ervoor zorgt dat de knop de grootte wijzigt.

virtual void OnSize(int iSize);

Parameterwaarden

iSize
[in] De nieuwe breedte van de knop.

Opmerkingen

De standaard implementatie van deze methode doet niets. Overschrijf deze methode om het formaat van de knop te wijzigen wanneer de grootte of positie van de bovenliggende werkbalk wordt gewijzigd.

CMFCToolBarButton::OnToolHitTest

Aangeroepen door het framework wanneer de bovenliggende werkbalk moet bepalen of een punt zich in de begrenzingsrechthoek van de knop bevindt.

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

Parameterwaarden

pWnd
[in] Het bovenliggende venster van de knop. Kan NULL zijn.

Pti
[in] Een TOOLINFO structuur met informatie over een hulpmiddel in een besturingselement voor knopinfo.

Retourwaarde

Het resultaat van OnMenuButtonToolHitTest of de knop een aanwijzer naar het bovenliggende framevenster kan ophalen; anders ONWAAR.

Opmerkingen

Met deze methode wordt een van de volgende methoden aangeroepen als het bovenliggende venster kan worden geconverteerd naar een geldig frameobject:

CMFCToolBarButton::OnUpdateToolTip

Aangeroepen door het framework wanneer de bovenliggende werkbalk de tekst van de knopinfo bijwerkt.

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

Parameterwaarden

pWndParent
[in] Het bovenliggende venster.

iButtonIndex
[in] De op nul gebaseerde index van de knop in de bovenliggende knopverzameling.

wndToolTip
[in] Het besturingselement dat de knopinfotekst weergeeft.

Str
[uit] Een CString object dat de bijgewerkte knopinfotekst ontvangt.

Retourwaarde

Deze methode retourneert FALSE.

Opmerkingen

De standaard implementatie van deze methode doet niets en retourneert FALSE. Overschrijf deze methode om een niet-nulwaarde te retourneren als u een tekenreeks voor knopinfo opgeeft.

CMFCToolBarButton::P repareDrag

Aangeroepen door het framework wanneer de knop op het punt staat om een slepen-en-neerzetten-bewerking uit te voeren.

virtual BOOL PrepareDrag(COleDataSource& srcItem);

Parameterwaarden

srcItem
[in] Een COleDataSource object met statusinformatie over de bewerking slepen en neerzetten.

Retourwaarde

WAAR als de bewerking slaagt; anders ONWAAR.

Opmerkingen

In het framework wordt deze methode aangeroepen om de werkbalkknop voor te bereiden om de status ervan op te slaan in het opgegeven COleDataSource object. Met deze methode wordt de status opgeslagen door zichzelf te serialiseren naar een gedeeld bestand en dat bestand vervolgens door te geven aan de methode COleDataSource::CacheGlobalData . Zie CMFCToolBarButton::Serialize voor meer informatie over serialisatie van werkbalkknoppen.

Deze methode doet niets en retourneert TRUE als de knop niet kan worden opgeslagen (de METHODE CMFCToolBarButton::CanBeStored retourneert FALSE). Het retourneert FALSE als er een uitzondering optreedt tijdens objectserialisatie.

Zie OLE-slepen en neerzetten voor meer informatie over OLE-slepen en neerzetten.

CMFCToolBarButton::Rect

Hiermee haalt u de begrenzingsrechthoek van de knop op.

const CRect& Rect() const;

Retourwaarde

Een CRect object dat de begrenzingsrechthoek van een knop bevat.

CMFCToolBarButton::ResetImageToDefault

Hiermee stelt u de standaardwaarde in voor de afbeelding die aan de knop is gekoppeld.

virtual void ResetImageToDefault();

Opmerkingen

Met deze methode wordt de standaardafbeelding opgehaald uit de bovenliggende werkbalk met behulp van de methode CMFCToolBar::GetDefaultImage . Als de knop geen gekoppelde standaardafbeelding heeft, stelt deze methode het tekstlabel van de knop in op basis van de tekenreeksresource met behulp van de methode CStringT::LoadString . Zie Werken met resourcebestanden voor meer informatie over tekenreeksresources.

Deze methode doet niets als de knop een door de gebruiker gedefinieerde installatiekopieën heeft.

CMFCToolBarButton::SaveBarState

Hiermee wordt de status van de werkbalkknop opgeslagen.

virtual void SaveBarState();

Opmerkingen

In het framework wordt deze methode aangeroepen wanneer er een CMFCToolBarButton object wordt gemaakt als gevolg van een slepen-en-neerzetten-bewerking.

De standaard implementatie van deze methode doet niets. Overschrijf deze methode om de status van de werkbalkknop op te slaan in een externe gegevensbron.

CMFCToolBarButton::Serialize

Leest dit object uit een archief of schrijft het naar een archief.

virtual void Serialize(CArchive& ar);

Parameterwaarden

Ar
[in] Het CArchive object van waaruit of waarnaar moet worden geserialiseerd.

Opmerkingen

Deze methode ondersteunt processen voor gegevensoverdracht, zoals klembord of slepen en neerzetten. De knop leest of schrijft eigenschappen van de knop, zoals de id, het tekstlabel en de afbeeldings-id van of naar het opgegeven CArchive object.

Zie Serialisatie: Een object serialiseren voor voorbeelden van serialisatie.

CMFCToolBarButton::SetACCData

Hiermee wordt het opgegeven CAccessibilityData object gevuld met toegankelijkheidsgegevens via de werkbalkknop.

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

Parameterwaarden

pParent
[in] Het bovenliggende venster van de werkbalkknop.

gegevens
[in] Een CAccessibilityData object dat is gevuld met de toegankelijkheidsgegevens van de werkbalkknop.

Retourwaarde

Deze methode retourneert TRUE.

Opmerkingen

Overschrijf deze methode om ONWAAR te retourneren als de werkbalkknop geen toegankelijkheidsgegevens biedt.

CMFCToolBarButton::SetClipboardFormatName

Hiermee wijzigt u de naam van de globale klembordindeling.

static void __stdcall SetClipboardFormatName(LPCTSTR lpszName);

Parameterwaarden

lpszName
[in] De nieuwe naam van de algemene klembordindeling. Kan niet NULL zijn.

Opmerkingen

Met deze methode kunnen bewerkingen voor slepen en neerzetten worden uitgevoerd tussen meerdere toepassingen. Elke toepassing moet dezelfde naam voor de klembordindeling opgeven.

U moet deze methode aanroepen voordat het framework CMFCToolBarButton::GetClipboardFormat aanroept.

CMFCToolBarButton::SetImage

Hiermee stelt u de afbeeldingsindex van de knop in.

virtual void SetImage(int iImage);

Parameterwaarden

iImage
[in] De index van de afbeelding in de verzameling werkbalkafbeeldingen.

Opmerkingen

Als de werkbalkknop een scheidingsteken is, verwijst iImage naar de nieuwe breedte van de scheidingstekenknop.

Als iImage kleiner is dan nul, wordt met deze methode de tekening van de afbeelding uitgeschakeld en wordt het tekenen van het tekstlabel van de knop ingeschakeld.

CMFCToolBarButton::SetProtectedCommands

Hiermee stelt u de lijst met opdrachten in die de gebruiker niet kan aanpassen.

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

Parameterwaarden

lstCmds
[in] De lijst met beveiligde opdrachten.

Opmerkingen

In de aanpassingsmodus worden opdrachten op de werkbalkknop uitgeschakeld die zijn beveiligd. De gebruiker kan geen bewerkingen voor slepen en neerzetten uitvoeren op uitgeschakelde werkbalkknoppen.

Gebruik de methode CMFCToolBarButton::GetProtectedCommands om de lijst met beveiligde opdrachten op te halen.

CMFCToolBarButton::SetRadio

Aangeroepen door het framework wanneer de status van een knop wordt gewijzigd.

virtual void SetRadio();

Opmerkingen

De standaard implementatie van deze methode doet niets. Overschrijf deze methode om een aangepaste actie uit te voeren wanneer de status van de knop wordt gewijzigd.

CMFCToolBarButton::SetRect

Hiermee stelt u de begrenzingsrechthoek van de knop in.

void SetRect(const CRect rect);

Parameterwaarden

Rect
[in] De nieuwe begrenzingsrechthoek van de knop.

Opmerkingen

Met deze methode wordt de METHODE CMFCToolBarButton::OnMove aangeroepen nadat de nieuwe begrenzingsrechthoek is ingesteld.

CMFCToolBarButton::SetStyle

Hiermee stelt u de stijl van de knop in.

virtual void SetStyle(UINT nStyle);

Parameterwaarden

nStyle
[in] De nieuwe stijl van de knop.

Opmerkingen

Met de standaardimplementatie wordt het gegevenslid CMFCToolBarButton::m_nStyle ingesteld op nStyle. Overschrijf deze methode als u extra verwerking wilt uitvoeren om de wijziging in stijl af te handelen. Zie Besturingsstijlen op de werkbalk voor een lijst met geldige stijlvlagmen.

CMFCToolBarButton::SetVisible

Hiermee geeft u op of de knop zichtbaar is.

void SetVisible(BOOL bShow=TRUE);

Parameterwaarden

bShow
[in] Een Booleaanse waarde die aangeeft of de knop moet worden weergegeven of verborgen. Als deze parameter TRUE is, wordt de knop weergegeven. Als de parameter FALSE is, is de knop verborgen.

Opmerkingen

Gebruik deze functie om een bepaalde werkbalkknop te verbergen of weer te geven. Roep de methode CPane::AdjustSizeImmediate aan nadat u deze methode hebt aangeroepen.

CMFCToolBarButton::Show

Hiermee wordt de knop weergegeven of verborgen.

void Show(BOOL bShow);

Parameterwaarden

bShow
[in] Een Booleaanse waarde die aangeeft of de knop moet worden weergegeven of verborgen. Als deze parameter TRUE is, wordt de knop weergegeven. Als de parameter FALSE is, is de knop verborgen.

Opmerkingen

In het framework wordt deze methode aangeroepen om de zichtbaarheid van werkbalkknoppen bij te werken wanneer het formaat van de bovenliggende werkbalk wordt gewijzigd. Dit framework roept deze methode aan met bShow ingesteld op FALSE wanneer de knop niet meer binnen de grenzen van de werkbalk past. Het framework roept deze methode aan met bShow ingesteld op TRUE wanneer na het wijzigen van het formaat van de knop opnieuw binnen de grenzen van de werkbalk past.

Gebruik de methode CMFCToolBarButton::SetVisible om de algemene zichtbaarheid van de knop in te stellen.

Met deze methode wordt de methode CMFCToolBarButton::OnShow aangeroepen nadat de zichtbaarheidsstatus van de knop is bijgewerkt.

Zie ook

Hiërarchiegrafiek
Klassen
CMFCToolBar-klasse
Klasse CMFCToolBarImages

  • Last updated on