Share via

CToolBarCtrl-klasse

Opmerking

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

Biedt de functionaliteit van de gemeenschappelijke bedieningselementen van de Windows-werkbalk.

Syntaxis

class CToolBarCtrl : public CWnd

Leden

Openbare constructors

Naam Description
CToolBarCtrl::CToolBarCtrl Maakt een CToolBarCtrl object.

Openbare methoden

Naam Description
CToolBarCtrl::AddBitmap Hiermee voegt u een of meer bitmapknopafbeeldingen toe aan de lijst met knopafbeeldingen die beschikbaar zijn voor een besturingselement op de werkbalk.
CToolBarCtrl::AddButtons Hiermee voegt u een of meer knoppen toe aan een besturingselement op de werkbalk.
CToolBarCtrl::AddString Voegt een nieuwe tekenreeks, doorgegeven als resource-id, toe aan de interne lijst met tekenreeksen van de werkbalk.
CToolBarCtrl::AddStrings Hiermee voegt u een nieuwe tekenreeks of tekenreeksen toe, die als een aanwijzer worden doorgegeven aan een buffer met NULLdoor elkaar gescheiden tekenreeksen, aan de interne lijst met tekenreeksen van de werkbalk.
CToolBarCtrl::AutoSize Hiermee wijzigt u het formaat van een besturingselement op de werkbalk.
CToolBarCtrl::ChangeBitmap Hiermee wijzigt u de bitmap voor een knop in het huidige werkbalk besturingselement.
CToolBarCtrl::CheckButton Hiermee wordt een bepaalde knop in een werkbalkcontrole gecontroleerd of gewist.
CToolBarCtrl::CommandToIndex Haalt de op nul gebaseerde index op voor de knop die is gekoppeld aan de opgegeven opdracht-id.
CToolBarCtrl::Create Hiermee maakt u een besturingselement voor de werkbalk en koppelt u dit aan een CToolBarCtrl object.
CToolBarCtrl::CreateEx Hiermee maakt u een besturingselement op de werkbalk met de opgegeven uitgebreide Stijlen van Windows en koppelt u dit aan een CToolBarCtrl object.
CToolBarCtrl::Customize Hiermee wordt het dialoogvenster Werkbalk aanpassen weergegeven.
CToolBarCtrl::DeleteButton Hiermee verwijdert u een knop uit het besturingselement van de werkbalk.
CToolBarCtrl::EnableButton Hiermee schakelt u de opgegeven knop in of uit in een werkbalk.
CToolBarCtrl::GetAnchorHighlight Hiermee haalt u de ankermarkeringsinstelling voor een werkbalk op.
CToolBarCtrl::GetBitmap Hiermee haalt u de index op van de bitmap die is gekoppeld aan een knop op een werkbalk.
CToolBarCtrl::GetBitmapFlags Hiermee haalt u vlaggen op die zijn gekoppeld aan de bitmap van de werkbalk.
CToolBarCtrl::GetButton Hiermee wordt informatie opgehaald over de opgegeven knop in een werkbalk.
CToolBarCtrl::GetButtonCount Hiermee haalt u het aantal knoppen op dat zich momenteel in het besturingselement van de werkbalk bevindt.
CToolBarCtrl::GetButtonInfo Hiermee haalt u de informatie voor een knop op een werkbalk op.
CToolBarCtrl::GetButtonSize Hiermee haalt u de huidige breedte en hoogte van werkbalkknoppen op in pixels.
CToolBarCtrl::GetColorScheme Hiermee wordt het kleurenschema van het huidige besturingselement voor de werkbalk opgehaald.
CToolBarCtrl::GetDisabledImageList Hiermee haalt u de lijst met afbeeldingen op die een werkbalk besturingselement gebruikt om uitgeschakelde knoppen weer te geven.
CToolBarCtrl::GetDropTarget Hiermee haalt u de IDropTarget interface voor een besturingselement op de werkbalk op.
CToolBarCtrl::GetExtendedStyle Hiermee worden de uitgebreide stijlen voor een besturingselement op de werkbalk opgehaald.
CToolBarCtrl::GetHotImageList Hiermee haalt u de lijst met afbeeldingen op die een werkbalk besturingselement gebruikt om 'hot'-knoppen weer te geven. Er wordt een dynamische knop weergegeven wanneer de muiswijzer erboven staat.
CToolBarCtrl::GetHotItem Hiermee haalt u de index van het hot-item op een werkbalk op.
CToolBarCtrl::GetImageList Hiermee haalt u de lijst met afbeeldingen op die een werkbalk besturingselement gebruikt om knoppen weer te geven in de standaardstatus.
CToolBarCtrl::GetInsertMark Hiermee haalt u de huidige invoegmarkering voor de werkbalk op.
CToolBarCtrl::GetInsertMarkColor Hiermee wordt de kleur opgehaald die wordt gebruikt om de invoegmarkering voor de werkbalk te tekenen.
CToolBarCtrl::GetItemRect Hiermee haalt u de begrenzingsrechthoek van een knop in een werkbalk besturingselement op.
CToolBarCtrl::GetMaxSize Hiermee haalt u de totale grootte van alle zichtbare knoppen en scheidingstekens op de werkbalk op.
CToolBarCtrl::GetMaxTextRows Hiermee wordt het maximum aantal tekstrijen opgehaald dat op een werkbalkknop wordt weergegeven.
CToolBarCtrl::GetMetrics Hiermee worden de metrische gegevens van een besturingselement op de werkbalk opgehaald.
CToolBarCtrl::GetPadding Hiermee wordt de horizontale en verticale opvulling van het huidige besturingselement voor de werkbalk opgehaald.
CToolBarCtrl::GetPressedImageList Hiermee haalt u de lijst met afbeeldingen op die door het huidige werkbalk besturingselement worden gebruikt om knoppen in de ingedrukt status weer te geven.
CToolBarCtrl::GetRect Hiermee haalt u de begrenzingsrechthoek voor een opgegeven werkbalkknop op.
CToolBarCtrl::GetRows Hiermee wordt het aantal rijen met knoppen opgehaald dat momenteel op de werkbalk wordt weergegeven.
CToolBarCtrl::GetState Hiermee wordt informatie opgehaald over de status van de opgegeven knop in een werkbalk, zoals of deze is ingeschakeld, ingedrukt of ingeschakeld.
CToolBarCtrl::GetString Hiermee haalt u een werkbalktekenreeks op.
CToolBarCtrl::GetStyle Hiermee worden de stijlen opgehaald die momenteel worden gebruikt voor een besturingselement op de werkbalk.
CToolBarCtrl::GetToolTips Hiermee wordt de greep van het besturingselement voor knopinfo opgehaald, indien aanwezig, gekoppeld aan het besturingselement voor de werkbalk.
CToolBarCtrl::HideButton Hiermee wordt de opgegeven knop in een werkbalk besturingselement verborgen of weergegeven.
CToolBarCtrl::HitTest Bepaalt waar een punt zich in een werkbalk bevindt.
CToolBarCtrl::Indeterminate Hiermee wordt de onbepaalde (grijze) status van de opgegeven knop in een werkbalkbesturingselement ingesteld of gewist.
CToolBarCtrl::InsertButton Hiermee voegt u een knop in een besturingselement voor de werkbalk in.
CToolBarCtrl::InsertMarkHitTest Hiermee haalt u de informatie over de invoegmarkering voor een punt in een werkbalk op.
CToolBarCtrl::IsButtonChecked Hiermee wordt aangegeven of de opgegeven knop in een werkbalk is ingeschakeld.
CToolBarCtrl::IsButtonEnabled Hiermee wordt aangegeven of de opgegeven knop in een werkbalk besturingselement is ingeschakeld.
CToolBarCtrl::IsButtonHidden Hiermee wordt aangegeven of de opgegeven knop in een werkbalk besturingselement verborgen is.
CToolBarCtrl::IsButtonHighlighted Hiermee wordt de markeringsstatus van de werkbalkknop gecontroleerd.
CToolBarCtrl::IsButtonIndeterminate Hiermee wordt aangegeven of de status van de opgegeven knop in een werkbalkbesturingselement onbepaald is (grijs).
CToolBarCtrl::IsButtonPressed Hiermee wordt aangegeven of de opgegeven knop in een werkbalk wordt ingedrukt.
CToolBarCtrl::LoadImages Hiermee laadt u bitmaps in de lijst met afbeeldingen van een werkbalk.
CToolBarCtrl::MapAccelerator Wijst een acceleratorteken toe aan een werkbalkknop.
CToolBarCtrl::MarkButton Hiermee stelt u de markeringsstatus van een bepaalde knop in een werkbalk besturingselement in.
CToolBarCtrl::MoveButton Hiermee verplaatst u een knop van de ene index naar de andere.
CToolBarCtrl::PressButton Druk op de opgegeven knop of laat deze los in een werkbalk besturingselement.
CToolBarCtrl::ReplaceBitmap Vervangt de bestaande bitmap in het huidige werkbalk besturingselement door een nieuwe bitmap.
CToolBarCtrl::RestoreState Hiermee wordt de status van het besturingselement voor de werkbalk hersteld.
CToolBarCtrl::SaveState Hiermee wordt de status van het besturingselement voor de werkbalk opgeslagen.
CToolBarCtrl::SetAnchorHighlight Hiermee stelt u de ankermarkeringsinstelling voor een werkbalk in.
CToolBarCtrl::SetBitmapSize Hiermee stelt u de grootte van de bitmapafbeeldingen in die moeten worden toegevoegd aan een werkbalk.
CToolBarCtrl::SetButtonInfo Hiermee stelt u de informatie voor een bestaande knop in een werkbalk in.
CToolBarCtrl::SetButtonSize Hiermee stelt u de grootte van de knoppen in die moeten worden toegevoegd aan een werkbalk.
CToolBarCtrl::SetButtonStructSize Hiermee geeft u de grootte van de TBBUTTON structuur.
CToolBarCtrl::SetButtonWidth Hiermee stelt u de minimale en maximale knopbreedte in het werkbalk besturingselement in.
CToolBarCtrl::SetCmdID Hiermee stelt u de opdracht-id in die naar het eigenaarsvenster moet worden verzonden wanneer de opgegeven knop wordt ingedrukt.
CToolBarCtrl::SetColorScheme Hiermee stelt u het kleurenschema van het huidige besturingselement voor de werkbalk in.
CToolBarCtrl::SetDisabledImageList Hiermee stelt u de lijst met afbeeldingen in die door het werkbalk besturingselement worden gebruikt om uitgeschakelde knoppen weer te geven.
CToolBarCtrl::SetDrawTextFlags Hiermee stelt u de vlaggen in de Functie Win32 DrawTextin, die wordt gebruikt om de tekst in de opgegeven rechthoek te tekenen, opgemaakt op basis van de wijze waarop de vlaggen worden ingesteld.
CToolBarCtrl::SetExtendedStyle Hiermee stelt u de uitgebreide stijlen voor een besturingselement op de werkbalk in.
CToolBarCtrl::SetHotImageList Hiermee stelt u de lijst met afbeeldingen in die door het werkbalk besturingselement worden gebruikt om 'hot'-knoppen weer te geven.
CToolBarCtrl::SetHotItem Hiermee stelt u het dynamische item in een werkbalk in.
CToolBarCtrl::SetImageList Hiermee stelt u de lijst met afbeeldingen in die door de werkbalk worden gebruikt om knoppen weer te geven die de standaardstatus hebben.
CToolBarCtrl::SetIndent Hiermee stelt u de inspringing voor de eerste knop in een werkbalk besturingselement in.
CToolBarCtrl::SetInsertMark Hiermee stelt u de huidige invoegmarkering voor de werkbalk in.
CToolBarCtrl::SetInsertMarkColor Hiermee stelt u de kleur in die wordt gebruikt om de invoegmarkering voor de werkbalk te tekenen.
CToolBarCtrl::SetMaxTextRows Hiermee stelt u het maximum aantal tekstrijen in dat wordt weergegeven op een werkbalkknop.
CToolBarCtrl::SetMetrics Hiermee stelt u de metrische gegevens van een besturingselement op de werkbalk in.
CToolBarCtrl::SetOwner Hiermee stelt u het venster in voor het ontvangen van meldingsberichten van het besturingselement op de werkbalk.
CToolBarCtrl::SetPadding Hiermee stelt u de horizontale en verticale opvulling van het huidige besturingselement voor de werkbalk in.
CToolBarCtrl::SetPressedImageList Hiermee stelt u de lijst met afbeeldingen in die door het huidige werkbalk besturingselement worden gebruikt om knoppen in de ingedrukt status weer te geven.
CToolBarCtrl::SetRows Hiermee stelt u het aantal rijen met knoppen in die op de werkbalk worden weergegeven.
CToolBarCtrl::SetState Hiermee stelt u de status voor de opgegeven knop in een werkbalk besturingselement in.
CToolBarCtrl::SetStyle Hiermee stelt u de stijlen voor een besturingselement op de werkbalk in.
CToolBarCtrl::SetToolTips Hiermee koppelt u een besturingselement voor knopinfo aan het werkbalk besturingselement.
CToolBarCtrl::SetWindowTheme Hiermee stelt u de visuele stijl van een besturingselement op de werkbalk in.

Opmerkingen

Dit besturingselement (en daarom de CToolBarCtrl klasse) is alleen beschikbaar voor programma's die worden uitgevoerd onder Windows 95/98 en Windows NT versie 3.51 en hoger.

Een algemeen besturingselement voor een Windows-werkbalk is een rechthoekig onderliggend venster met een of meer knoppen. Met deze knoppen kunt u een bitmapafbeelding, een tekenreeks of beide weergeven. Wanneer de gebruiker een knop kiest, wordt er een opdrachtbericht verzonden naar het venster eigenaar van de werkbalk. Normaal gesproken komen de knoppen op een werkbalk overeen met items in het menu van de toepassing; ze bieden een meer directe manier voor de gebruiker om toegang te krijgen tot de opdrachten van een toepassing.

CToolBarCtrl objecten bevatten verschillende belangrijke interne gegevensstructuren: een lijst met knopafbeeldings bitmaps of een lijst met afbeeldingen, een lijst met knoplabeltekenreeksen en een lijst met TBBUTTON structuren die een afbeelding en/of tekenreeks koppelen aan de positie, stijl, status en opdracht-id van de knop. Elk van de elementen van deze gegevensstructuren wordt aangeduid door een index op basis van nul. Voordat u een CToolBarCtrl object kunt gebruiken, moet u deze gegevensstructuren instellen. De lijst met tekenreeksen kan alleen worden gebruikt voor knoplabels; u kunt geen tekenreeksen ophalen uit de werkbalk.

Als u een CToolBarCtrl object wilt gebruiken, voert u doorgaans de volgende stappen uit:

  1. Maak het CToolBarCtrl object.

  2. Aanroep Create om het algemene besturingselement van de Windows-werkbalk te maken en deze aan het CToolBarCtrl object toe te voegen. Geef de stijl van de werkbalk aan met behulp van stijlen, zoals TBSTYLE_TRANSPARENT voor een transparante werkbalk of TBSTYLE_DROPDOWN voor een werkbalk die vervolgkeuzelijsten ondersteunt.

  3. Bepaal hoe u de knoppen op de werkbalk wilt weergeven:

    • Als u bitmapafbeeldingen voor knoppen wilt gebruiken, voegt u de knop bitmaps toe aan de werkbalk door aan te roepen AddBitmap.

    • Als u afbeeldingen wilt gebruiken die worden weergegeven in een lijst met afbeeldingen voor knoppen, geeft u de lijst met afbeeldingen op door aan te roepen SetImageList, SetHotImageListof SetDisabledImageList.

    • Als u tekenreekslabels voor knoppen wilt gebruiken, voegt u de tekenreeksen toe aan de werkbalk door aan te roepen AddString en/of AddStrings.

  4. Voeg knopstructuren toe aan de werkbalk door aan te roepen AddButtons.

  5. Als u knopinfo wilt voor een werkbalkknop in een eigenaarsvenster dat geen CFrameWndis, moet u de berichten in het venster van de TTN_NEEDTEXT eigenaar van de werkbalk afhandelen, zoals wordt beschreven in Meldingen over tip voor het afhandelen van hulpprogramma's. Als het bovenliggende venster van de werkbalk is afgeleid van CFrameWnd, worden knoptips zonder extra inspanning van u weergegeven omdat CFrameWnd dit een standaardhandler biedt.

  6. Als u wilt dat uw gebruiker de werkbalk kan aanpassen, verwerkt u meldingsberichten voor aanpassing in het venster van de eigenaar, zoals wordt beschreven in Aanpassingsmeldingen verwerken.

U kunt SaveState de huidige status van een werkbalk in het register opslaan en RestoreState de status herstellen op basis van informatie die eerder in het register is opgeslagen. Naast het opslaan van de werkbalkstatus tussen het gebruik van de toepassing, slaan toepassingen doorgaans de status op voordat de gebruiker begint met het aanpassen van de werkbalk als de gebruiker de werkbalk later in de oorspronkelijke staat wil herstellen.

Ondersteuning voor Internet Explorer versie 4.0 en hoger

Ter ondersteuning van functionaliteit die is geïntroduceerd in Internet Explorer, versie 4.0 en hoger, biedt MFC ondersteuning voor afbeeldingenlijsten en transparante en platte stijlen voor werkbalkbesturingselementen.

Met een transparante werkbalk kan de client onder de werkbalk worden weergegeven. Als u een transparante werkbalk wilt maken, gebruikt u beide TBSTYLE_FLAT stijlen TBSTYLE_TRANSPARENT . Transparante werkbalken zijn dynamisch bijhouden; Als de muiswijzer over een hot button op de werkbalk beweegt, verandert het uiterlijk van de knop. Werkbalken die zijn gemaakt met alleen de TBSTYLE_FLAT stijl, bevatten knoppen die niet transparant zijn.

Ondersteuning voor afbeeldingenlijsten biedt meer flexibiliteit voor standaardgedrag, dynamische afbeeldingen en uitgeschakelde installatiekopieën. Gebruik GetImageList, GetHotImageListen GetDisabledImageList met de transparante werkbalk om de afbeelding te bewerken op basis van de status:

Zie Besturingselementen en gebruiken CToolBarCtrlvoor meer informatie over het gebruikCToolBarCtrl.

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CToolBarCtrl

Requirements

Rubriek:afxcmn.h

CToolBarCtrl::AddBitmap

Hiermee voegt u een of meer knopafbeeldingen toe aan de lijst met knopafbeeldingen die zijn opgeslagen in het besturingselement van de werkbalk.

int AddBitmap(
    int nNumButtons,
    UINT nBitmapID);

int AddBitmap(
    int nNumButtons,
    CBitmap* pBitmap);

Parameterwaarden

nNumButtons
Aantal knopafbeeldingen in de bitmap.

nBitmapID
Resource-id van de bitmap die de knopafbeelding of afbeeldingen bevat die moeten worden toegevoegd.

pBitmap
Wijs het CBitmap object aan dat de knopafbeelding of afbeeldingen bevat die u wilt toevoegen.

Retourwaarde

Op nul gebaseerde index van de eerste nieuwe installatiekopieën, indien geslaagd; anders - 1.

Opmerkingen

U kunt de Windows-API CreateMappedBitmap gebruiken om kleuren toe te wijzen voordat u de bitmap toevoegt aan de werkbalk. Als u een aanwijzer doorgeeft aan een CBitMap object, moet u ervoor zorgen dat de bitmap pas wordt vernietigd nadat de werkbalk is vernietigd.

CToolBarCtrl::AddButtons

Hiermee voegt u een of meer knoppen toe aan een besturingselement op de werkbalk.

BOOL AddButtons(
    int nNumButtons,
    LPTBBUTTON lpButtons);

Parameterwaarden

nNumButtons
Aantal knoppen dat moet worden toegevoegd.

lpButtons
Adres van een matrix met TBBUTTON structuren die informatie bevatten over de knoppen die moeten worden toegevoegd. Er moet hetzelfde aantal elementen in de matrix zijn als knoppen die zijn opgegeven door nNumButtons.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

De lpButtons aanwijzer verwijst naar een matrix met TBBUTTON structuren. Elke TBBUTTON structuur koppelt de knop die wordt toegevoegd aan de stijl, afbeelding en/of tekenreeks, opdracht-id, status en door de gebruiker gedefinieerde gegevens:

typedef struct _TBBUTTON {
    int iBitmap;    // zero-based index of button image
    int idCommand;  // command to be sent when button pressed
    BYTE fsState;   // button state--see below
    BYTE fsStyle;   // button style--see below
    DWORD dwData;   // application-defined value
    int iString;    // zero-based index of button label string
} TBBUTTON;

De leden zijn als volgt:

  • iBitmap

    Op nul gebaseerde index van knopafbeelding -1 als er geen afbeelding voor deze knop is.

  • idCommand

    Opdracht-id die is gekoppeld aan de knop. Deze id wordt verzonden in een WM_COMMAND bericht wanneer de knop wordt gekozen. Als het fsStyle lid de TBSTYLE_SEP waarde heeft, moet dit lid nul zijn.

  • fsState

    Knopstatusvlagmen. Dit kan een combinatie zijn van de onderstaande waarden:

    • TBSTATE_CHECKED De knop heeft de TBSTYLE_CHECKED stijl en wordt ingedrukt.

    • TBSTATE_ENABLED De knop accepteert gebruikersinvoer. Een knop die niet over deze status beschikt, accepteert geen gebruikersinvoer en wordt grijs weergegeven.

    • TBSTATE_HIDDEN De knop is niet zichtbaar en kan geen gebruikersinvoer ontvangen.

    • TBSTATE_INDETERMINATE De knop wordt grijs weergegeven.

    • TBSTATE_PRESSED De knop wordt ingedrukt.

    • TBSTATE_WRAP Een regeleinde volgt de knop. De knop moet ook de TBSTATE_ENABLED status hebben.

  • fsStyle

    Knopstijl. Dit kan een combinatie zijn van de onderstaande waarden:

    • TBSTYLE_BUTTON Hiermee maakt u een standaarddrukknop.

    • TBSTYLE_CHECK Hiermee maakt u een knop die tussen de ingedrukt en niet-ingedrukt statussen schakelt telkens wanneer de gebruiker erop klikt. De knop heeft een andere achtergrondkleur wanneer deze de status Ingedrukt heeft.

    • TBSTYLE_CHECKGROUP Hiermee maakt u een controleknop die ingedrukt blijft totdat een andere knop in de groep wordt ingedrukt.

    • TBSTYLE_GROUP Hiermee maakt u een knop die ingedrukt blijft totdat een andere knop in de groep wordt ingedrukt.

    • TBSTYLE_SEP Hiermee maakt u een scheidingsteken, waardoor er een kleine tussenruimte tussen knopgroepen wordt geboden. Een knop met deze stijl ontvangt geen gebruikersinvoer.

  • dwData

    Door de gebruiker gedefinieerde gegevens.

  • iString

    Op nul gebaseerde index van de tekenreeks die moet worden gebruikt als label van de knop, -1 als er geen tekenreeks voor deze knop is.

De afbeelding en/of tekenreeks waarvan u de index opgeeft, moeten eerder zijn toegevoegd aan de lijst van het besturingselement op de werkbalk met behulp AddBitmapvan , AddStringen/of AddStrings.

CToolBarCtrl::AddString

Voegt een nieuwe tekenreeks, doorgegeven als resource-id, toe aan de interne lijst met tekenreeksen van de werkbalk.

int AddString(UINT nStringID);

Parameterwaarden

nStringID
Resource-id van de tekenreeksresource die moet worden toegevoegd aan de lijst met tekenreeksen van het besturingselement op de werkbalk.

Retourwaarde

De op nul gebaseerde index van de eerste nieuwe tekenreeks die is toegevoegd, indien geslaagd; anders -1.

CToolBarCtrl::AddStrings

Voegt een nieuwe tekenreeks of tekenreeksen toe aan de lijst met tekenreeksen die beschikbaar zijn voor een werkbalk besturingselement.

int AddStrings(LPCTSTR lpszStrings);

Parameterwaarden

lpszStrings
Adres van een buffer die een of meer NULLbeëindigde tekenreeksen bevat die moeten worden toegevoegd aan de lijst met tekenreeksen van de werkbalk. De laatste tekenreeks moet worden beëindigd met twee NULL tekens.

Retourwaarde

De op nul gebaseerde index van de eerste nieuwe tekenreeks die is toegevoegd, indien geslaagd; anders -1.

Opmerkingen

Tekenreeksen in de buffer moeten worden gescheiden door een NULL teken. U moet ervoor zorgen dat de laatste tekenreeks twee NULL afsluiters heeft. Als u een constante tekenreeks op de juiste manier wilt opmaken, kunt u deze schrijven als:

// one null added automatically
lpszStrings = _T("Only one string to add\0");

or:

// adds three strings with one call
lpszStrings = _T("String 1\0String 2\0String 3\0");

U moet een CString object niet doorgeven aan deze functie, omdat het niet mogelijk is om meer dan één NULL teken in een CString.

CToolBarCtrl::AutoSize

Hiermee wijzigt u het formaat van het volledige besturingselement van de werkbalk.

void AutoSize();

Opmerkingen

U moet deze functie aanroepen wanneer de grootte van het bovenliggende venster verandert of wanneer de grootte van de werkbalk wordt gewijzigd (bijvoorbeeld wanneer u de knop- of bitmapgrootte instelt of tekenreeksen toevoegt).

CToolBarCtrl::ChangeBitmap

Hiermee wijzigt u de bitmap voor een knop in het huidige werkbalk besturingselement.

BOOL ChangeBitmap(
    int idButton,
    int iBitmap);

Parameterwaarden

idButton
[in] Opdracht-id van de knop die een nieuwe bitmap moet ontvangen.

iBitmap
[in] Op nul gebaseerde index van een afbeelding in de lijst met afbeeldingen van het huidige werkbalkbesturingselement.

Retourwaarde

TRUE als deze methode is geslaagd; anders, FALSE.

Opmerkingen

Als deze methode is geslaagd, geeft het systeem de opgegeven afbeelding weer in de opgegeven knop.

Met deze methode wordt het TB_CHANGEBITMAP bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

In het volgende codevoorbeeld wordt de bitmap voor de knop Bestand opslaan gewijzigd in de bitmap voor de knop Info .

{
   // Change the bitmap for the File Save button, whose
   // command ID is ID_FILE_SAVE, to the bitmap for the
   // About button, whose index is 7.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ChangeBitmap(ID_FILE_SAVE, 7);
}

CToolBarCtrl::CheckButton

Hiermee wordt een bepaalde knop in een werkbalkcontrole gecontroleerd of gewist.

BOOL CheckButton(
    int nID,
    BOOL bCheck = TRUE);

Parameterwaarden

nID
Opdracht-id van de knop om te controleren of te wissen.

bCheck
TRUE om de knop te controleren, FALSE om deze te wissen.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Wanneer een knop is aangevinkt, lijkt het erop dat deze is ingedrukt. Als u meer dan één knopstatus wilt wijzigen, kunt u in plaats daarvan bellen SetState .

CToolBarCtrl::CommandToIndex

Haalt de op nul gebaseerde index op voor de knop die is gekoppeld aan de opgegeven opdracht-id.

UINT CommandToIndex(UINT nID) const;

Parameterwaarden

nID
Opdracht-id waarvan u de knopindex wilt zoeken.

Retourwaarde

De op nul gebaseerde index voor de knop die is gekoppeld aan de opdracht-id.

Opmerkingen

CToolBarCtrl::Create

Hiermee maakt u een besturingselement voor de werkbalk en koppelt u dit aan een CToolBarCtrl object.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameterwaarden

dwStyle
Hiermee geeft u de stijl van het besturingselement voor de werkbalk op. Werkbalken moeten altijd de WS_CHILD stijl hebben. Daarnaast kunt u elke combinatie van werkbalkstijlen en vensterstijlen opgeven, zoals beschreven onder Opmerkingen.

rect
U kunt desgewenst de grootte en positie van het besturingselement op de werkbalk instellen. Het kan een CRect object of een RECT structuur zijn.

pParentWnd
Hiermee geeft u het bovenliggende venster van het besturingselement voor de werkbalk op. Het mag niet zijn NULL.

nID
Hiermee geeft u de id van het besturingselement voor de werkbalk op.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

U maakt een CToolBarCtrl in twee stappen. Roep eerst de constructor aan en roep Createvervolgens het besturingselement voor de werkbalk aan en koppel het aan het CToolBarCtrl object. Pas de volgende vensterstijlen toe op een werkbalk.

  • WS_CHILD Altijd

  • WS_VISIBLE Gewoonlijk

  • WS_DISABLED Zelden

Zie CreateWindow in de Windows SDK voor een beschrijving van vensterstijlen.

U kunt desgewenst een combinatie van veelgebruikte besturingsstijlen toepassen, zoals beschreven in de Windows SDK.

Pas een combinatie van werkbalkstijlen toe op het besturingselement of de knoppen zelf. De stijlen worden beschreven in het besturingselement voor de onderwerpwerkbalk en knopstijlen in de Windows SDK.

Als u uitgebreide werkbalkstijlen wilt gebruiken, roept SetExtendedStyle u aan nadat u het gesprek hebt uitgevoerd Create. Als u een werkbalk met uitgebreide vensterstijlen wilt maken, roept CToolBarCtrl::CreateEx u aan in plaats van Create.

Het besturingselement voor de werkbalk stelt automatisch de grootte en positie van het werkbalkvenster in. De hoogte is gebaseerd op de hoogte van de knoppen op de werkbalk. De breedte is hetzelfde als de breedte van het clientgebied van het bovenliggende venster. De CCS_TOP en CCS_BOTTOM stijlen bepalen of de werkbalk zich boven of onder aan het clientgebied bevindt. Standaard heeft een werkbalk de CCS_TOP stijl.

CToolBarCtrl::CreateEx

Hiermee maakt u een besturingselement (een onderliggend venster) en koppelt u dit aan het CToolBarCtrl object.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameterwaarden

dwExStyle
Hiermee geeft u de uitgebreide stijl van het besturingselement dat wordt gemaakt. Zie de dwExStyle parameter voor in de Windows SDK voor CreateWindowEx een lijst met uitgebreide Windows-stijlen.

dwStyle
Hiermee geeft u de stijl van het besturingselement voor de werkbalk op. Werkbalken moeten altijd de WS_CHILD stijl hebben. Daarnaast kunt u elke combinatie van werkbalkstijlen en vensterstijlen opgeven, zoals beschreven in het gedeelte Opmerkingen van Create.

rect
Een verwijzing naar een RECT structuur die de grootte en positie van het venster beschrijft dat moet worden gemaakt, in clientcoördinaten van pParentWnd.

pParentWnd
Een aanwijzer naar het venster dat het bovenliggende besturingselement is.

nID
De id van het onderliggende venster van het besturingselement.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Gebruik CreateEx in plaats van Create uitgebreide Windows-stijlen toe te passen, die zijn opgegeven door het voorwoord WS_EX_voor de uitgebreide Stijl van Windows. CreateEx maakt het besturingselement met de uitgebreide Windows-stijlen die zijn opgegeven door dwExStyle. Uitgebreide stijlen instellen die specifiek zijn voor een besturingselement met behulp van SetExtendedStyle. U kunt bijvoorbeeld CreateEx stijlen zoals WS_EX_CONTEXTHELP, maar gebruiken SetExtendedStyle om dergelijke stijlen in te stellen, zoals TBSTYLE_EX_DRAWDDARROWS. Zie de stijlen die worden beschreven in uitgebreide werkbalkstijlen in de Windows SDK voor meer informatie.

CToolBarCtrl::CToolBarCtrl

Maakt een CToolBarCtrl object.

CToolBarCtrl();

Opmerkingen

U moet aanroepen Create om de werkbalk bruikbaar te maken.

CToolBarCtrl::Customize

Hiermee wordt het dialoogvenster Werkbalk aanpassen weergegeven.

void Customize();

Opmerkingen

Met dit dialoogvenster kan de gebruiker de werkbalk aanpassen door knoppen toe te voegen en te verwijderen. Ter ondersteuning van aanpassing moet het bovenliggende venster van de werkbalk de meldingsberichten voor aanpassing afhandelen, zoals beschreven in Aanpassingsmeldingen verwerken. De werkbalk moet ook zijn gemaakt met de CCS_ADJUSTABLE stijl, zoals beschreven in CToolBarCtrl::Create.

CToolBarCtrl::DeleteButton

Hiermee verwijdert u een knop uit het besturingselement van de werkbalk.

BOOL DeleteButton(int nIndex);

Parameterwaarden

nIndex
Op nul gebaseerde index van de knop die u wilt verwijderen.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

CToolBarCtrl::EnableButton

Hiermee schakelt u de opgegeven knop in of uit in een werkbalk.

BOOL EnableButton(
    int nID,
    BOOL bEnable = TRUE);

Parameterwaarden

nID
Opdracht-id van de knop om in of uit te schakelen.

bEnable
TRUE om de knop in te schakelen; FALSE om de knop uit te schakelen.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Wanneer een knop is ingeschakeld, kan deze worden ingedrukt en gecontroleerd. Als u meer dan één knopstatus wilt wijzigen, kunt u in plaats daarvan bellen SetState .

CToolBarCtrl::GetAnchorHighlight

Hiermee haalt u de ankermarkeringsinstelling voor een werkbalk op.

BOOL GetAnchorHighlight() const;

Retourwaarde

Als niet-nul is ankermarkering ingeschakeld. Als nul is ankermarkering uitgeschakeld.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_GETANCHORHIGHLIGHT, zoals beschreven in de Windows SDK.

CToolBarCtrl::GetBitmap

Hiermee haalt u de index op van de bitmap die is gekoppeld aan een knop op een werkbalk.

int GetBitmap(int nID) const;

Parameterwaarden

nID
Opdracht-id van de knop waarvan de bitmapindex moet worden opgehaald.

Retourwaarde

Retourneert de index van de bitmap als dit lukt of anders nul.

Opmerkingen

Implementeert de functionaliteit van TB_GETBITMAP de Windows SDK.

CToolBarCtrl::GetBitmapFlags

Hiermee worden de bitmapvlagmen opgehaald uit de werkbalk.

UINT GetBitmapFlags() const;

Retourwaarde

Een UINT met de TBBF_LARGE vlag die is ingesteld als de weergave grote werkbalk bitmaps kan ondersteunen, anders wissen.

Opmerkingen

U moet deze aanroepen nadat u de werkbalk hebt gemaakt, maar voordat u bitmaps aan de werkbalk toevoegt. De retourwaarde geeft aan of de weergave grote bitmaps ondersteunt of niet. Als de weergave grote bitmaps ondersteunt en als u ervoor kiest om ze te gebruiken, roept SetBitmapSize u aan en SetButtonSize voordat u uw grote bitmap toevoegt met behulp van AddBitmap.

CToolBarCtrl::GetButton

Hiermee wordt informatie opgehaald over de opgegeven knop in een werkbalk.

BOOL GetButton(
    int nIndex,
    LPTBBUTTON lpButton) const;

Parameterwaarden

nIndex
Op nul gebaseerde index van de knop waarvoor informatie moet worden opgehaald.

lpButton
Adres van de TBBUTTON structuur die een kopie van de knopgegevens ontvangt. Zie CToolBarCtrl::AddButtons voor informatie over de TBBUTTON structuur.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

CToolBarCtrl::GetButtonCount

Hiermee haalt u het aantal knoppen op dat zich momenteel in het besturingselement van de werkbalk bevindt.

int GetButtonCount() const;

Retourwaarde

Het aantal knoppen.

CToolBarCtrl::GetButtonInfo

Hiermee haalt u de informatie voor een knop op een werkbalk op.

int GetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi) const;

Parameterwaarden

nID
De knop-id.

ptbbi
Een aanwijzer naar een TBBUTTONINFO structuur die de knopinformatie ontvangt.

Retourwaarde

De op nul gebaseerde index van de knop, indien geslaagd; anders -1.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_GETBUTTONINFO, zoals beschreven in de Windows SDK.

CToolBarCtrl::GetButtonSize

Hiermee haalt u de grootte van een werkbalkknop op.

DWORD GetButtonSize() const;

Retourwaarde

Een DWORD waarde die de waarden voor breedte en hoogte in de LOWORD en HIWORDrespectievelijke waarden bevat.

CToolBarCtrl::GetButtonText

Hiermee haalt u de weergavetekst van een opgegeven knop op het huidige besturingselement van de werkbalk op.

CString GetButtonText(int idButton) const;

Parameterwaarden

idButton
[in] De id voor de knop waarvan de weergavetekst wordt opgehaald.

Retourwaarde

Een CString met de weergavetekst van de opgegeven knop.

Opmerkingen

Met deze methode wordt het TB_GETBUTTONTEXT bericht verzonden, dat wordt beschreven in de Windows SDK.

CToolBarCtrl::GetColorScheme

Hiermee wordt het kleurenschema van het huidige besturingselement voor de werkbalk opgehaald.

BOOL GetColorScheme(COLORSCHEME* lpColorScheme) const;

Parameterwaarden

lpColorScheme
[uit] Wijs een COLORSCHEME structuur aan die informatie over het kleurenschema ontvangt. Wanneer deze methode wordt geretourneerd, beschrijft de structuur de markeringskleur en schaduwkleur van het werkbalk besturingselement.

Retourwaarde

TRUE als deze methode is geslaagd; anders, FALSE.

Opmerkingen

Met deze methode wordt het TB_GETCOLORSCHEME bericht verzonden, dat wordt beschreven in de Windows SDK.

CToolBarCtrl::GetDisabledImageList

Hiermee haalt u de lijst met afbeeldingen op die een werkbalk besturingselement gebruikt om uitgeschakelde knoppen weer te geven.

CImageList* GetDisabledImageList() const;

Retourwaarde

Een aanwijzer naar een CImageList object of NULL als er geen uitgeschakelde lijst met afbeeldingen is ingesteld.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_GETDISABLEDIMAGELIST, zoals beschreven in de Windows SDK. De MFC-implementatie maakt gebruik van GetDisabledImageList een CImageList object met de knopafbeeldingen van het werkbalk besturingselement, in plaats van een ingang naar een afbeeldingslijst.

CToolBarCtrl::GetDropTarget

Hiermee haalt u de IDropTarget interface voor een besturingselement op de werkbalk op.

HRESULT GetDropTarget(IDropTarget** ppDropTarget) const;

Parameterwaarden

ppDropTarget
Een aanwijzer naar een IDropTarget interfaceaanwijzer. Als er een fout optreedt, wordt er een NULL aanwijzer in dit adres geplaatst.

Retourwaarde

Retourneert een HRESULT waarde die aangeeft dat de bewerking is geslaagd of mislukt.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_GETOBJECT, zoals beschreven in de Windows SDK.

CToolBarCtrl::GetExtendedStyle

Hiermee worden de uitgebreide stijlen voor een besturingselement op de werkbalk opgehaald.

DWORD GetExtendedStyle() const;

Retourwaarde

Een DWORD die de uitgebreide stijlen vertegenwoordigt die momenteel worden gebruikt voor het besturingselement voor de werkbalk. Zie Uitgebreide stijlen op de werkbalk in de Windows SDK voor een lijst met stijlen.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_GETEXTENDEDSTYLE, zoals beschreven in de Windows SDK.

CToolBarCtrl::GetHotImageList

Hiermee haalt u de lijst met afbeeldingen op die een werkbalk besturingselement gebruikt om 'hot'-knoppen weer te geven. Er wordt een dynamische knop weergegeven wanneer de muiswijzer erboven staat.

CImageList* GetHotImageList() const;

Retourwaarde

Een aanwijzer naar een CImageList object of NULL als er geen uitgeschakelde lijst met afbeeldingen is ingesteld.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_GETHOTIMAGELIST, zoals beschreven in de Windows SDK. Er wordt een dynamische knop weergegeven wanneer de muiswijzer erboven staat.

CToolBarCtrl::GetHotItem

Hiermee haalt u de index van het hot-item op een werkbalk op.

int GetHotItem() const;

Retourwaarde

De op nul gebaseerde index van het dynamische item in een werkbalk.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_GETHOTITEM, zoals beschreven in de Windows SDK.

CToolBarCtrl::GetImageList

Hiermee haalt u de lijst met afbeeldingen op die een werkbalk besturingselement gebruikt om knoppen weer te geven in de standaardstatus.

CImageList* GetImageList() const;

Retourwaarde

Een aanwijzer naar een CImageList object of NULL als er geen afbeeldingslijst is ingesteld.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_GETIMAGELIST, zoals beschreven in de Windows SDK.

CToolBarCtrl::GetInsertMark

Hiermee haalt u de huidige invoegmarkering voor de werkbalk op.

void GetInsertMark(TBINSERTMARK* ptbim) const;

Parameterwaarden

ptbim
Een aanwijzer naar een TBINSERTMARK structuur die de invoegmarkering ontvangt.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_GETINSERTMARK, zoals beschreven in de Windows SDK.

CToolBarCtrl::GetInsertMarkColor

Hiermee wordt de kleur opgehaald die wordt gebruikt om de invoegmarkering voor de werkbalk te tekenen.

COLORREF GetInsertMarkColor() const;

Retourwaarde

Een COLORREF waarde die de huidige kleur van de invoegmarkering bevat.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_GETINSERTMARKCOLOR, zoals beschreven in de Windows SDK.

CToolBarCtrl::GetItemRect

Hiermee haalt u de begrenzingsrechthoek van een knop in een werkbalk besturingselement op.

BOOL GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parameterwaarden

nIndex
Op nul gebaseerde index van de knop waarvoor informatie moet worden opgehaald.

lpRect
Adres van een RECT structuur of een CRect object dat de coördinaten van de begrenzingsrechthoek ontvangt.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Met deze functie wordt de begrenzingsrechthoek niet opgehaald voor knoppen waarvan de status is ingesteld op TBSTATE_HIDDEN.

CToolBarCtrl::GetMaxSize

Hiermee haalt u de totale grootte van alle zichtbare knoppen en scheidingstekens op de werkbalk op.

BOOL GetMaxSize(LPSIZE pSize) const;

Parameterwaarden

pSize
Een aanwijzer naar een SIZE structuur die de grootte van de items ontvangt.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_GETMAXSIZE, zoals beschreven in de Windows SDK.

CToolBarCtrl::GetMaxTextRows

Hiermee wordt het maximum aantal tekstrijen opgehaald dat op een werkbalkknop wordt weergegeven.

int GetMaxTextRows() const;

Retourwaarde

Het maximum aantal tekstrijen dat op een werkbalkknop wordt weergegeven.

CToolBarCtrl::GetMetrics

Haalt de metrische gegevens van het CToolBarCtrl object op.

void GetMetrics(LPTBMETRICS ptbm) const;

Parameterwaarden

ptbm
Een aanwijzer naar de TBMETRICS structuur van het CToolBarCtrl object.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het TB_GETMETRICS bericht geëmuleren, zoals beschreven in de Windows SDK.

CToolBarCtrl::GetPadding

Hiermee wordt de horizontale en verticale opvulling van het huidige besturingselement voor de werkbalk opgehaald.

BOOL GetPadding(
    int* pnHorzPadding,
    int* pnVertPadding) const;

Parameterwaarden

pnHorzPadding
[uit] Een geheel getal dat de horizontale opvulling van het besturingselement van de werkbalk ontvangt, in pixels.

pnVertPadding
[uit] Een geheel getal dat de verticale opvulling van het besturingselement van de werkbalk ontvangt, in pixels.

Retourwaarde

TRUE als deze methode is geslaagd; anders, FALSE.

Opmerkingen

Met deze methode wordt het TB_GETPADDING bericht verzonden, dat wordt beschreven in de Windows SDK.

CToolBarCtrl::GetPressedImageList

Hiermee haalt u de lijst met afbeeldingen op die door het huidige werkbalk besturingselement worden gebruikt om knoppen in de ingedrukt status weer te geven.

CImageList* GetPressedImageList();

Retourwaarde

Aanwijzer naar een CImageList lijst met afbeeldingen voor het huidige besturingselement of NULL als er geen dergelijke lijst met afbeeldingen is ingesteld.

Opmerkingen

Met deze methode wordt het TB_GETPRESSEDIMAGELIST bericht verzonden, dat wordt beschreven in de Windows SDK.

CToolBarCtrl::GetRect

Hiermee haalt u de begrenzingsrechthoek voor een opgegeven werkbalkknop op.

BOOL GetRect(
    int nID,
    LPRECT lpRect) const;

Parameterwaarden

nID
De knop-id.

lpRect
Een aanwijzer naar een RECT structuur om de informatie over de begrenzingsrechthoek te ontvangen.

Retourwaarde

TRUE indien geslaagd; anders FALSE.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_GETRECT, zoals beschreven in de Windows SDK.

CToolBarCtrl::GetRows

Hiermee wordt het aantal rijen met knoppen opgehaald dat momenteel wordt weergegeven door het besturingselement van de werkbalk.

int GetRows() const;

Retourwaarde

Het aantal rijen met knoppen dat momenteel op de werkbalk wordt weergegeven.

Opmerkingen

Houd er rekening mee dat het aantal rijen altijd één is, tenzij de werkbalk is gemaakt met de TBSTYLE_WRAPABLE stijl.

CToolBarCtrl::GetState

Hiermee wordt informatie opgehaald over de status van de opgegeven knop in een werkbalk, zoals of deze is ingeschakeld, ingedrukt of ingeschakeld.

int GetState(int nID) const;

Parameterwaarden

nID
Opdracht-id van de knop waarvoor gegevens moeten worden opgehaald.

Retourwaarde

De statusinformatie van de knop als dit lukt of anders -1. De informatie over de knopstatus kan een combinatie zijn van de waarden die worden vermeld in CToolBarCtrl::AddButtons.

Opmerkingen

Deze functie is vooral handig als u meer dan een van de knopstatussen wilt ophalen. Als u slechts één status wilt ophalen, gebruikt u een van de volgende lidfuncties: IsButtonEnabled, IsButtonChecked, IsButtonPressed, IsButtonHiddenof IsButtonIndeterminate. De GetState lidfunctie is echter de enige manier om de TBSTATE_WRAP knopstatus te detecteren.

CToolBarCtrl::GetString

Hiermee haalt u een werkbalktekenreeks op.

int GetString(
    int nString,
    LPTSTR lpstrString,
    int cchMaxLen) const;

int GetString(
    int nString,
    CString& str) const;

Parameterwaarden

nString
Index van de tekenreeks.

lpstrString
Aanwijzer naar een buffer die wordt gebruikt om de tekenreeks te retourneren.

cchMaxLen
Lengte van de buffer in bytes.

str
De tekenreeks.

Retourwaarde

De lengte van de tekenreeks als dit lukt, -1 zo niet.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_GETSTRING, zoals beschreven in de Windows SDK.

CToolBarCtrl::GetStyle

Hiermee haalt u de stijlen op die momenteel op een werkbalk worden toegepast.

DWORD GetStyle() const;

Retourwaarde

Een DWORD met een combinatie van werkbalkbesturingsstijlen, zoals beschreven in de Windows SDK.

CToolBarCtrl::GetToolTips

Hiermee wordt de greep van het besturingselement voor knopinfo opgehaald, indien aanwezig, gekoppeld aan het besturingselement voor de werkbalk.

CToolTipCtrl* GetToolTips() const;

Retourwaarde

Een aanwijzer naar het CToolTipCtrl object dat is gekoppeld aan deze werkbalk of NULL als de werkbalk geen besturingselement voor knopinfo heeft.

Opmerkingen

Omdat het besturingselement voor werkbalken normaal gesproken een eigen besturingselement voor knopinfo maakt en onderhoudt, hoeven de meeste programma's deze functie niet aan te roepen.

CToolBarCtrl::HitTest

Bepaalt waar een punt zich in een werkbalk bevindt.

int HitTest(LPPOINT ppt) const;

Parameterwaarden

ppt
Een aanwijzer naar een POINT structuur met de x-coördinaat van de hittest in het x lid en de y-coördinaat van de hittest in het y lid. De coördinaten zijn relatief ten opzichte van het clientgebied van de werkbalk.

Retourwaarde

Een geheel getal dat de locatie van een punt op een werkbalk aangeeft. Als de waarde nul of een positieve waarde is, is deze retourwaarde de op nul gebaseerde index van het item zonderparator waarin het punt ligt.

Als de retourwaarde negatief is, ligt het punt niet binnen een knop. De absolute waarde van de retourwaarde is de index van een scheidingstekenitem of het dichtstbijzijnde niet-scheidingstekenitem.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_HITTEST, zoals beschreven in de Windows SDK.

CToolBarCtrl::HideButton

Hiermee wordt de opgegeven knop in een werkbalk besturingselement verborgen of weergegeven.

BOOL HideButton(
    int nID,
    BOOL bHide = TRUE);

Parameterwaarden

nID
Opdracht-id van de knop om te verbergen of weer te geven.

bHide
TRUE om de knop te verbergen om FALSE deze weer te geven.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Als u meer dan één knopstatus wilt wijzigen, kunt u in plaats daarvan bellen SetState .

CToolBarCtrl::Indeterminate

Hiermee wordt de onbepaalde status van de opgegeven knop in een werkbalkbesturingselement ingesteld of gewist.

BOOL Indeterminate(
    int nID,
    BOOL bIndeterminate = TRUE);

Parameterwaarden

nID
Opdracht-id van de knop waarvan de onbepaalde status moet worden ingesteld of gewist.

bIndeterminate
TRUE om de onbepaalde status voor de opgegeven knop in te stellen om FALSE deze te wissen.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Onbepaalde knoppen worden grijs weergegeven, zoals de manier waarop de vetgedrukte knop op de werkbalk van een tekstverwerker eruit zou zien wanneer de geselecteerde tekst zowel vet als gewone tekens bevat. Als u meer dan één knopstatus wilt wijzigen, kunt u in plaats daarvan bellen SetState .

CToolBarCtrl::InsertButton

Hiermee voegt u een knop in een besturingselement voor de werkbalk in.

BOOL InsertButton(
    int nIndex,
    LPTBBUTTON lpButton);

Parameterwaarden

nIndex
Op nul gebaseerde index van een knop. Met deze functie wordt de nieuwe knop links van deze knop ingevoegd.

lpButton
Adres van een TBBUTTON structuur met informatie over de knop die moet worden ingevoegd. Zie CToolBarCtrl::AddButtons voor een beschrijving van de TBBUTTON structuur.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

De afbeelding en/of tekenreeks waarvan u de index opgeeft, moeten eerder zijn toegevoegd aan de lijst van het besturingselement op de werkbalk met behulp AddBitmapvan , AddStringen/of AddStrings.

CToolBarCtrl::InsertMarkHitTest

Hiermee haalt u de informatie over de invoegmarkering voor een punt in een werkbalk op.

BOOL InsertMarkHitTest(
    LPPOINT ppt,
    LPTBINSERTMARK ptbim) const;

Parameterwaarden

ppt
Een aanwijzer naar een POINT structuur die de hittestcoördinaten bevat, ten opzichte van het clientgebied van de werkbalk.

ptbim
Een aanwijzer naar een TBINSERTMARK structuur die informatie over de invoegmarkering ontvangt.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_INSERTMARKHITTEST, zoals beschreven in de Windows SDK.

CToolBarCtrl::IsButtonChecked

Bepaalt of de opgegeven knop in een werkbalk besturingselement is ingeschakeld.

BOOL IsButtonChecked(int nID) const;

Parameterwaarden

nID
Opdracht-id van de knop op de werkbalk.

Retourwaarde

Niet-nul als de knop is ingeschakeld; anders nul.

Opmerkingen

U kunt bellen GetState als u meer dan één knopstatus wilt ophalen.

CToolBarCtrl::IsButtonEnabled

Bepaalt of de opgegeven knop in een werkbalk besturingselement is ingeschakeld.

BOOL IsButtonEnabled(int nID) const;

Parameterwaarden

nID
Opdracht-id van de knop op de werkbalk.

Retourwaarde

Niet-nul als de knop is ingeschakeld; anders nul.

Opmerkingen

U kunt bellen GetState als u meer dan één knopstatus wilt ophalen.

CToolBarCtrl::IsButtonHidden

Bepaalt of de opgegeven knop in een werkbalk besturingselement verborgen is.

BOOL IsButtonHidden(int nID) const;

Parameterwaarden

nID
Opdracht-id van de knop op de werkbalk.

Retourwaarde

Niet-nul als de knop verborgen is; anders nul.

Opmerkingen

U kunt bellen GetState als u meer dan één knopstatus wilt ophalen.

CToolBarCtrl::IsButtonHighlighted

Hiermee wordt de markeringsstatus van een werkbalkknop gecontroleerd.

BOOL IsButtonHighlighted(int nID) const;

Parameterwaarden

nID
[in] De opdracht-id voor de werkbalkknop.

Retourwaarde

Positief geheel getal als de knop is gemarkeerd, 0 als de knop niet is gemarkeerd of -1 als er een fout optreedt.

CToolBarCtrl::IsButtonIndeterminate

Bepaalt of de opgegeven knop in een werkbalkbesturingselement onbepaald is.

BOOL IsButtonIndeterminate(int nID) const;

Parameterwaarden

nID
[in] Opdracht-id van de knop op de werkbalk.

Retourwaarde

Positief geheel getal als de knop onbepaald is, nul als de knop niet onbepaald is of -1 als er een fout optreedt.

Opmerkingen

Onbepaalde knoppen worden grijs weergegeven, zoals de manier waarop de vetgedrukte knop op de werkbalk van een tekstverwerker eruitziet wanneer de geselecteerde tekst zowel vet als gewone tekens bevat. U kunt bellen GetState als u meer dan één knopstatus wilt ophalen.

CToolBarCtrl::IsButtonPressed

Bepaalt of de opgegeven knop in een werkbalk besturingselement wordt ingedrukt.

BOOL IsButtonPressed(int nID) const;

Parameterwaarden

nID
Opdracht-id van de knop op de werkbalk.

Retourwaarde

Niet-nul als de knop wordt ingedrukt, anders nul.

Opmerkingen

U kunt bellen GetState als u meer dan één knopstatus wilt ophalen.

CToolBarCtrl::LoadImages

Hiermee laadt u bitmaps in de lijst met afbeeldingen van een werkbalk.

void LoadImages(
    int iBitmapID,
    HINSTANCE hinst);

Parameterwaarden

iBitmapID
Id van een bitmap die de afbeeldingen bevat die moeten worden geladen. Als u uw eigen bitmapresource wilt opgeven, stelt u deze parameter in op de id van een bitmapresource en stelt u deze in op hInstNULL. Uw bitmapresource wordt als één afbeelding toegevoegd aan de lijst met afbeeldingen. U kunt standaard, door het systeem gedefinieerde bitmaps toevoegen door deze parameter in te HINST_COMMCTRL stellen hinst en in te stellen op een van de volgende id's:

Bitmap-id Description
IDB_HIST_LARGE_COLOR Explorer-bitmaps in grote grootte
IDB_HIST_SMALL_COLOR Explorer-bitmaps in kleine grootte
IDB_STD_LARGE_COLOR Standaard bitmaps in grote grootte
IDB_STD_SMALL_COLOR Standaard bitmaps in kleine grootte
IDB_VIEW_LARGE_COLOR Bitmaps in grote grootte weergeven
IDB_VIEW_SMALL_COLOR Bitmaps in kleine grootte weergeven

hinst
Het exemplaar van het programma verwerkt de aanroepende toepassing. Deze parameter kan zijn HINST_COMMCTRL om een standaardafbeeldingslijst te laden.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_LOADIMAGES, zoals beschreven in de Windows SDK.

CToolBarCtrl::MapAccelerator

Wijst een acceleratorteken toe aan een werkbalkknop.

BOOL MapAccelerator(
    TCHAR chAccel,
    UINT* pIDBtn);

Parameterwaarden

chAccel
Accelerator-teken dat moet worden toegewezen. Dit teken is hetzelfde teken dat wordt onderstreept in de tekst van de knop.

pIDBtn
Een aanwijzer naar een UINT die de opdracht-id ontvangt van de knop die overeenkomt met de opgegeven accelerator.chAccel

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_MAPACCELERATOR, zoals beschreven in de Windows SDK.

CToolBarCtrl::MarkButton

Hiermee stelt u de markeringsstatus van een bepaalde knop in een werkbalk besturingselement in.

BOOL MarkButton(
    int nID,
    BOOL fHighlight = TRUE);

Parameterwaarden

nID
De knop-id.

fHighlight
Hiermee geeft u de markeringsstatus die moet worden ingesteld. TRUEStandaard. Als deze optie is ingesteld FALSE, wordt de knop ingesteld op de standaardstatus.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_MARKBUTTON, zoals beschreven in de Windows SDK.

CToolBarCtrl::MoveButton

Hiermee verplaatst u een knop van de ene index naar de andere.

BOOL MoveButton(
    UINT nOldPos,
    UINT nNewPos);

Parameterwaarden

nOldPos
De op nul gebaseerde index van de knop die moet worden verplaatst.

nNewPos
De op nul gebaseerde index van de bestemming van de knop.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_MOVEBUTTON, zoals beschreven in de Windows SDK.

CToolBarCtrl::PressButton

Druk op de opgegeven knop of laat deze los in een werkbalk besturingselement.

BOOL PressButton(int nID, BOOL bPress = TRUE);

Parameterwaarden

nID
[in] Opdracht-id van de knop om op te drukken of los te laten.

bPress
[in] TRUE om op de opgegeven knop te drukken; FALSE om de opgegeven knop vrij te geven. De standaardwaarde is TRUE.

Retourwaarde

TRUE als de methode is geslaagd; anders, FALSE.

Opmerkingen

Als u meer dan één knopstatus wilt wijzigen, kunt u in plaats daarvan bellen SetState .

Met deze methode wordt het TB_PRESSBUTTON bericht verzonden, dat wordt beschreven in de Windows SDK.

CToolBarCtrl::ReplaceBitmap

Vervangt de bestaande bitmap in het huidige werkbalk besturingselement door een nieuwe bitmap.

BOOL ReplaceBitmap(LPTBREPLACEBITMAP pReplaceBitmap);

Parameterwaarden

pReplaceBitmap
[in] Wijs een TBREPLACEBITMAP structuur aan die de bitmap beschrijft die moet worden vervangen en de nieuwe bitmap.

Retourwaarde

TRUE als deze methode is geslaagd; anders, FALSE.

Opmerkingen

Met deze methode wordt het TB_REPLACEBITMAP bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

In het volgende codevoorbeeld wordt de bitmap voor de standaardwerkbalk vervangen door een andere bitmap.

{
   // Replace one toolbar bitmap with another.
   TBREPLACEBITMAP tbrb;
   tbrb.hInstOld = ::AfxGetInstanceHandle();
   tbrb.nIDOld = IDR_MAINFRAME;
   tbrb.hInstNew = ::AfxGetInstanceHandle();
   tbrb.nIDNew = IDR_MAINFRAME1;
   tbrb.nButtons = 8;
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ReplaceBitmap(&tbrb);
}

CToolBarCtrl::RestoreState

Hiermee herstelt u de status van het werkbalkbeheer vanaf de locatie in het register dat is opgegeven door de parameters.

void RestoreState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

Parameterwaarden

hKeyRoot
Identificeert een momenteel geopende sleutel in het register of een van de volgende vooraf gedefinieerde gereserveerde ingangswaarden:

  • HKEY_CLASSES_ROOT

  • HKEY_CURRENT_USER

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

lpszSubKey
Verwijst naar een NULL-beëindigde tekenreeks met de naam van de subsleutel waaraan een waarde is gekoppeld. Deze parameter kan of een aanwijzer naar een lege tekenreeks zijn NULL . Als de parameter is NULL, wordt de waarde toegevoegd aan de sleutel die wordt geïdentificeerd door de hKeyRoot parameter.

lpszValueName
Verwijst naar een tekenreeks met de naam van de waarde die moet worden opgehaald. Als een waarde met deze naam nog niet aanwezig is in de sleutel, voegt de functie deze toe aan de sleutel.

CToolBarCtrl::SaveState

Hiermee wordt de status van het werkbalkbeheer opgeslagen op de locatie in het register dat is opgegeven door de parameters.

void SaveState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

Parameterwaarden

hKeyRoot
Identificeert een momenteel geopende sleutel in het register of een van de volgende vooraf gedefinieerde gereserveerde ingangswaarden:

  • HKEY_CLASSES_ROOT

  • HKEY_CURRENT_USER

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

lpszSubKey
Verwijst naar een NULL-beëindigde tekenreeks met de naam van de subsleutel waaraan een waarde is gekoppeld. Deze parameter kan of een aanwijzer naar een lege tekenreeks zijn NULL . Als de parameter is NULL, wordt de waarde toegevoegd aan de sleutel die wordt geïdentificeerd door de hKeyRoot parameter.

lpszValueName
Verwijst naar een tekenreeks met de naam van de waarde die u wilt instellen. Als een waarde met deze naam nog niet aanwezig is in de sleutel, voegt de functie deze toe aan de sleutel.

CToolBarCtrl::SetAnchorHighlight

Hiermee stelt u de ankermarkeringsinstelling voor een werkbalk in.

BOOL SetAnchorHighlight(BOOL fAnchor = TRUE);

Parameterwaarden

fAnchor
[in] Hiermee geeft u op of ankermarkering is ingeschakeld of uitgeschakeld. Als deze waarde niet-nul is, wordt ankermarkering ingeschakeld. Als deze waarde nul is, wordt ankermarkering uitgeschakeld

Retourwaarde

De vorige ankerinstelling. Als markering is ingeschakeld, is deze waarde niet-nul. Als markeren niet is ingeschakeld, is deze waarde nul.

Opmerkingen

Met deze methode wordt het gedrag van het Win32-bericht TB_SETANCHORHIGHLIGHTgeïmplementeerd, zoals beschreven in de Windows SDK.

CToolBarCtrl::SetBitmapSize

Hiermee stelt u de grootte van de werkelijke bitmapafbeeldingen in die moeten worden toegevoegd aan een werkbalk.

BOOL SetBitmapSize(CSize size);

Parameterwaarden

size
Breedte en hoogte, in pixels, van de bitmapafbeeldingen.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Deze functie moet alleen worden aangeroepen voordat u bitmaps aan de werkbalk toevoegt. Als de toepassing de bitmapgrootte niet expliciet instelt, wordt deze standaard ingesteld op 16 bij 15 pixels.

CToolBarCtrl::SetButtonInfo

Hiermee stelt u de informatie voor een bestaande knop in een werkbalk in.

BOOL SetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi);

Parameterwaarden

nID
De knop-id.

ptbbi
Een aanwijzer naar een TBBUTTONINFO structuur die de knopinformatie ontvangt.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

De lidfunctie implementeert het gedrag van het Win32-bericht TB_SETBUTTONINFO, zoals beschreven in de Windows SDK.

CToolBarCtrl::SetButtonSize

Hiermee stelt u de grootte van de knoppen in het besturingselement voor de werkbalk in.

BOOL SetButtonSize(CSize size);

Parameterwaarden

size
Breedte en hoogte, in pixels, van de knoppen.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

De knopgrootte moet altijd minstens zo groot zijn als de bitmapgrootte die deze omsluit. Deze functie moet alleen worden aangeroepen voordat u bitmaps aan de werkbalk toevoegt. Als de toepassing de knopgrootte niet expliciet instelt, wordt deze standaard ingesteld op 24 bij 22 pixels.

Example

Zie het voorbeeld voor CToolBar::GetToolBarCtrl.

CToolBarCtrl::SetButtonStructSize

Hiermee geeft u de grootte van de TBBUTTON structuur.

void SetButtonStructSize(int nSize);

Parameterwaarden

nSize
Grootte, in bytes, van de TBBUTTON structuur.

Opmerkingen

Als u extra gegevens in de TBBUTTON structuur wilt opslaan, kunt u een nieuwe structuur afleiden van TBBUTTON, de benodigde leden toevoegen of een nieuwe structuur maken die een TBBUTTON structuur bevat als eerste lid. Vervolgens roept u deze functie aan om de werkbalk de grootte van de nieuwe structuur te laten bepalen.

Zie CToolBarCtrl::AddButtons voor meer informatie over de TBBUTTON structuur.

CToolBarCtrl::SetButtonWidth

Hiermee stelt u de minimale en maximale knopbreedte in het werkbalk besturingselement in.

BOOL SetButtonWidth(
    int cxMin,
    int cxMax);

Parameterwaarden

cxMin
Minimale knopbreedte, in pixels. Werkbalkknoppen zijn nooit smaller dan deze waarde.

cxMax
Maximale knopbreedte, in pixels. Als knoptekst te breed is, wordt het besturingselement weergegeven met beletseltekens.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_SETBUTTONWIDTH, zoals beschreven in de Windows SDK.

CToolBarCtrl::SetCmdID

Hiermee stelt u de opdracht-id in die naar het eigenaarsvenster wordt verzonden wanneer de opgegeven knop wordt ingedrukt.

BOOL SetCmdID(
    int nIndex,
    UINT nID);

Parameterwaarden

nIndex
De op nul gebaseerde index van de knop waarvan de opdracht-id moet worden ingesteld.

nID
De opdracht-id voor het instellen van de geselecteerde knop op.

Retourwaarde

Retourneert niet-nul indien geslaagd; anders nul.

CToolBarCtrl::SetColorScheme

Hiermee stelt u het kleurenschema van het huidige besturingselement voor de werkbalk in.

void SetColorScheme(const COLORSCHEME* lpColorScheme);

Parameterwaarden

lpColorScheme
[in] Wijs een COLORSCHEME structuur aan waarmee de markeringskleur en schaduwkleur van het besturingselement van de werkbalk worden beschreven.

Opmerkingen

Deze methode heeft geen effect als een windows Vista-visualthema is ingesteld.

Met deze methode wordt het TB_SETCOLORSCHEME bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

In het volgende codevoorbeeld wordt het kleurenschema voor het huidige besturingselement voor de werkbalk ingesteld. In het codevoorbeeld worden de linker- en bovenranden van elke knop rood en de rechter- en onderrand blauw. Wanneer de gebruiker op de knop drukt, worden de rode randen van de knop blauw en de blauwe randen rood.

//Set color scheme for the current toolbar control.
//Make the left and top edges of the tool button red,
//and the right and bottom edges blue. The colors
//reverse when a button is pressed.
//This method has no effect if the Vista visual theme
//is set.
{
   COLORSCHEME cs;
   cs.dwSize = sizeof(COLORSCHEME);
   cs.clrBtnHighlight = RGB(255, 0, 0);
   cs.clrBtnShadow = RGB(0, 0, 255);
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetColorScheme(&cs);
}

CToolBarCtrl::SetDisabledImageList

Hiermee stelt u de lijst met afbeeldingen in die door het werkbalk besturingselement worden gebruikt om uitgeschakelde knoppen weer te geven.

CImageList* SetDisabledImageList(CImageList* pImageList);

Parameterwaarden

pImageList
Een aanwijzer naar een CImageList object met de afbeeldingen dat door het werkbalk besturingselement moet worden gebruikt om uitgeschakelde knopafbeeldingen weer te geven.

Retourwaarde

Een aanwijzer naar een CImageList object dat eerder door het besturingselement van de werkbalk werd gebruikt om uitgeschakelde knopafbeeldingen weer te geven.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_SETDISABLEDIMAGELIST, zoals beschreven in de Windows SDK. De MFC-implementatie van het gebruik van SetDisabledImageList een CImageList object met de uitgeschakelde knopafbeeldingen van het werkbalk besturingselement, in plaats van een ingang naar een lijst met afbeeldingen.

CToolBarCtrl::SetDrawTextFlags

Hiermee stelt u de vlaggen in de Functie Win32 DrawTextin, die wordt gebruikt om de tekst in de opgegeven rechthoek te tekenen, opgemaakt op basis van de wijze waarop de vlaggen worden ingesteld.

DWORD SetDrawTextFlags(
    DWORD dwMask,
    DWORD dwDTFlags);

Parameterwaarden

dwMask
Een combinatie van een of meer vlaggen, opgegeven in de Win32-functieDrawText, die aangeeft in welke bits dwDTFlags worden gebruikt bij het tekenen van DT_ de tekst.

dwDTFlags
Een combinatie van een of meer vlaggen DT_ , opgegeven in de Functie DrawTextWin32, die aangeven hoe de knoptekst wordt getekend. Deze waarde wordt doorgegeven DrawText wanneer de knoptekst wordt getekend.

Retourwaarde

Een DWORD met de vorige teksttekeningvlagmen.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_SETDRAWTEXTFLAGS, zoals beschreven in de Windows SDK. Met deze lidfunctie worden de vlaggen in de Win32-functie DrawTextingesteld, waarmee tekst in de opgegeven rechthoek wordt geformatteerd op basis van de wijze waarop de vlaggen worden ingesteld.

CToolBarCtrl::SetExtendedStyle

Hiermee stelt u de uitgebreide stijlen voor een besturingselement op de werkbalk in.

DWORD SetExtendedStyle(DWORD dwExStyle);

Parameterwaarden

dwExStyle
Een waarde die de nieuwe uitgebreide stijlen aangeeft. Deze parameter kan een combinatie zijn van de uitgebreide stijlen van de werkbalk.

Retourwaarde

Een DWORD die de vorige uitgebreide stijlen vertegenwoordigt. Zie Uitgebreide stijlen op de werkbalk in de Windows SDK voor een lijst met stijlen.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_SETEXTENDEDSTYLE, zoals beschreven in de Windows SDK.

CToolBarCtrl::SetHotImageList

Hiermee stelt u de lijst met afbeeldingen in die door het werkbalk besturingselement worden gebruikt om 'hot'-knoppen weer te geven.

CImageList* SetHotImageList(CImageList* pImageList);

Parameterwaarden

pImageList
Een aanwijzer naar een CImageList object met de afbeeldingen die moeten worden gebruikt door het werkbalk besturingselement om afbeeldingen met een dynamische knop weer te geven.

Retourwaarde

Een aanwijzer naar een CImageList object dat eerder door het besturingselement van de werkbalk werd gebruikt om afbeeldingen met een dynamische knop weer te geven.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_SETHOTIMAGELIST, zoals beschreven in de Windows SDK.

De MFC-implementatie van het gebruik van SetHotImageList een CImageList object met de afbeeldingen van de werkbalkknop, in plaats van een ingang naar een lijst met afbeeldingen. Er wordt een hot-knop weergegeven wanneer de aanwijzer erboven staat.

CToolBarCtrl::SetHotItem

Hiermee stelt u het dynamische item in een werkbalk in.

int SetHotItem(int nHot);

Parameterwaarden

nHot
Het indexnummer op basis van nul van het item dat dynamisch wordt gemaakt. Als deze waarde -1 is, is geen van de items dynamisch.

Retourwaarde

De index van het vorige hot-item of -1 als er geen hot item was.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_SETHOTITEM, zoals beschreven in de Windows SDK.

CToolBarCtrl::SetImageList

Hiermee stelt u de lijst met afbeeldingen in die door de werkbalk worden gebruikt om knoppen weer te geven die de standaardstatus hebben.

CImageList* SetImageList(CImageList* pImageList);

Parameterwaarden

pImageList
Een aanwijzer naar een CImageList object met de afbeeldingen dat door het werkbalk besturingselement moet worden gebruikt om knopafbeeldingen weer te geven in de standaardstatus.

Retourwaarde

Een aanwijzer naar een CImageList object dat eerder door het besturingselement van de werkbalk werd gebruikt om knopafbeeldingen weer te geven in de standaardstatus.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_SETIMAGELIST, zoals beschreven in de Windows SDK.

De MFC-implementatie maakt gebruik van SetImageList een CImageList object met de knopafbeeldingen van het werkbalk besturingselement, in plaats van een ingang naar een afbeeldingslijst.

CToolBarCtrl::SetIndent

Hiermee stelt u de inspringing voor de eerste knop in een werkbalk besturingselement in.

BOOL SetIndent(int iIndent);

Parameterwaarden

iIndent
De waarde die de inspringing aangeeft, in pixels.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

CToolBarCtrl::SetInsertMark

Hiermee stelt u de huidige invoegmarkering voor de werkbalk in.

void SetInsertMark(TBINSERTMARK* ptbim);

Parameterwaarden

ptbim
Een aanwijzer naar de TBINSERTMARK structuur die de invoegmarkering bevat.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_SETINSERTMARK, zoals beschreven in de Windows SDK.

CToolBarCtrl::SetInsertMarkColor

Hiermee stelt u de kleur in die wordt gebruikt om de invoegmarkering voor de werkbalk te tekenen.

COLORREF SetInsertMarkColor(COLORREF clrNew);

Parameterwaarden

clrNew
Een COLORREF waarde die de nieuwe kleur van de invoegmarkering bevat.

Retourwaarde

Een COLORREF waarde die de vorige kleur van de invoegmarkering bevat.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TB_SETINSERTMARKCOLOR, zoals beschreven in de Windows SDK.

CToolBarCtrl::SetMaxTextRows

Hiermee stelt u het maximum aantal tekstrijen in dat wordt weergegeven op een werkbalkknop.

BOOL SetMaxTextRows(int iMaxRows);

Parameterwaarden

iMaxRows
Maximum aantal rijen dat moet worden ingesteld.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

CToolBarCtrl::SetMetrics

Hiermee stelt u de metrische gegevens van het CToolBarCtrl object in.

void SetMetrics(LPTBMETRICS ptbm);

Parameterwaarden

ptbm
Een aanwijzer naar de TBMETRICS structuur van het CToolBarCtrl object.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het TB_SETMETRICS bericht geëmuleren, zoals beschreven in de Windows SDK.

CToolBarCtrl::SetOwner

Hiermee stelt u het eigenaarvenster voor het besturingselement voor de werkbalk in.

void SetOwner(CWnd* pWnd);

Parameterwaarden

pWnd
Wijs het CWnd of CWnd-afgeleide object aan dat het nieuwe eigenaarsvenster voor het werkbalkbesturingselement wordt.

Opmerkingen

Het venster Eigenaar is het venster dat meldingen ontvangt van de werkbalk.

CToolBarCtrl::SetPadding

Hiermee stelt u de horizontale en verticale opvulling van het huidige besturingselement voor de werkbalk in.

DWORD SetPadding(
    int nHorzPadding,
    int nVertPadding);

Parameterwaarden

nHorzPadding
[in] Hiermee geeft u de horizontale opvulling van het werkbalk besturingselement, in pixels.

nVertPadding
[in] Hiermee geeft u de verticale opvulling van het werkbalk besturingselement, in pixels.

Retourwaarde

Een DWORD wiens lage woord de vorige horizontale opvullingswaarde bevat en waarvan het hoge woord de vorige verticale opvullingswaarde bevat. De opvullingswaarden worden gemeten in pixels.

Opmerkingen

Met deze methode wordt het TB_SETPADDING bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

In het volgende codevoorbeeld wordt de horizontale en verticale opvulling van het huidige besturingselement voor de werkbalk ingesteld op 20 pixels.

{
   // Set the horizontal and vertical padding of the current
   // toolbar control.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetPadding(50, 50);
}

CToolBarCtrl::SetPressedImageList

Hiermee stelt u de lijst met afbeeldingen in die door het huidige werkbalk besturingselement worden gebruikt om knoppen in de ingedrukt status weer te geven.

CImagelist* SetPressedImageList(
    int iImageID,
    CImageList* pImageList);

Parameterwaarden

iImageID
[in] De op nul gebaseerde index van de lijst met installatiekopieën. Stel deze parameter in op nul als u slechts één lijst met installatiekopieën gebruikt.

pImageList
[in] Aanwijzer naar een CImageList lijst met nieuwe installatiekopieën.

Retourwaarde

Wijs een CImageList afbeeldingslijst aan die de vorige lijst met afbeeldingen voor het huidige besturingselement bevat of NULL als er geen lijst met afbeeldingen is ingesteld.

Opmerkingen

Met deze methode wordt het TB_SETPRESSEDIMAGELIST bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

In het volgende codevoorbeeld wordt de lijst met ingedrukt afbeeldingen ingesteld op dezelfde als de standaardafbeeldingslijst.

{
   // SetPressedImageList
   // Set the pressed image list to be the same as the
   // normal image list.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   CImageList *pNormalCil = m_toolBarCtrl.GetImageList();
   CImageList *pPressedCil = m_toolBarCtrl.GetPressedImageList();
   m_toolBarCtrl.SetPressedImageList(0, pNormalCil);
}

CToolBarCtrl::SetRows

Vraagt het besturingselement van de werkbalk om het formaat van het opgegeven aantal rijen te wijzigen.

void SetRows(
    int nRows,
    BOOL bLarger,
    LPRECT lpRect);

Parameterwaarden

nRows
Aangevraagd aantal rijen.

bLarger
Hiermee wordt aangegeven of er meer rijen of minder rijen moeten worden gebruikt als de werkbalk niet kan worden aangepast aan het aangevraagde aantal rijen.

lpRect
Verwijst naar het object of RECT de CRect structuur die de nieuwe begrenzingsrechthoek van de werkbalk ontvangt.

Opmerkingen

Als de werkbalk het formaat van het aangevraagde getal of de aangevraagde rijen niet kan wijzigen, wordt de grootte ervan aangepast aan de volgende grotere of volgende kleinere geldige grootte, afhankelijk van de waarde van bLarger. Als bLarger dat het is TRUE, is het nieuwe aantal rijen groter dan het aangevraagde aantal. Als bLarger dat het is FALSE, is het nieuwe aantal rijen kleiner dan het aangevraagde aantal.

Een bepaald aantal rijen is geldig voor de werkbalk als de knoppen zodanig kunnen worden gerangschikt dat alle rijen hetzelfde aantal knoppen hebben (behalve misschien de laatste rij). Een werkbalk met vier knoppen kan bijvoorbeeld niet worden aangepast aan drie rijen, omdat de laatste twee rijen korter moeten zijn. Als u de grootte ervan probeerde te wijzigen in drie rijen, krijgt u vier rijen als bLarger dat het was TRUE en twee rijen als bLarger dat het was FALSE.

Als er scheidingstekens in de werkbalk staan, zijn de regels voor wanneer een bepaald aantal rijen geldig is ingewikkelder. De indeling wordt zodanig berekend dat knopgroepen (knoppen met een scheidingsteken voor de eerste en de laatste knop in de groep) nooit worden opgesplitst in verschillende rijen, tenzij de groep niet op één rij past.

Als een groep niet op één rij past, wordt de volgende groep op de volgende rij gestart, zelfs als deze past in de rij waar de grote groep is beëindigd. Het doel van deze regel is om de scheiding tussen grote groepen duidelijker te maken. De resulterende verticale scheidingstekens worden geteld als rijen.

Houd er ook rekening mee dat de SetRows lidfunctie altijd de indeling kiest die resulteert in de kleinste werkbalkgrootte. Als u een werkbalk met de TBSTYLE_WRAPABLE stijl maakt en vervolgens het formaat van het besturingselement wijzigt, past u de hierboven beschreven methode toe op basis van de breedte van het besturingselement.

Deze functie kan alleen worden aangeroepen voor werkbalken die zijn gemaakt met de TBSTYLE_WRAPABLE stijl.

CToolBarCtrl::SetState

Hiermee stelt u de status voor de opgegeven knop in een werkbalk besturingselement in.

BOOL SetState(
    int nID,
    UINT nState);

Parameterwaarden

nID
Opdracht-id van de knop.

nState
Statusvlagmen. Het kan een combinatie zijn van de waarden die worden vermeld voor knopstatussen in CToolBarCtrl::AddButtons.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Deze functie is vooral handig als u meer dan een van de knopstatussen wilt instellen. Als u slechts één status wilt instellen, gebruikt u een van de volgende lidfuncties: EnableButton, CheckButton, HideButton, Indeterminateof PressButton.

CToolBarCtrl::SetStyle

Hiermee stelt u de stijlen voor een besturingselement op de werkbalk in.

void SetStyle(DWORD dwStyle);

Parameterwaarden

dwStyle
Een DWORD met een combinatie van werkbalkbesturingsstijlen, zoals beschreven in de Windows SDK.

CToolBarCtrl::SetToolTips

Hiermee koppelt u een besturingselement voor knopinfo aan een werkbalk.

void SetToolTips(CToolTipCtrl* pTip);

Parameterwaarden

pTip
Aanwijzer naar het CToolTipCtrl object.

CToolBarCtrl::SetWindowTheme

Hiermee stelt u de visuele stijl van het CToolBarCtrl object in.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parameterwaarden

pszSubAppName
Een aanwijzer naar een Unicode-tekenreeks die de stijl van de werkbalkvisual bevat die u wilt instellen.

Retourwaarde

De retourwaarde wordt niet gebruikt.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het TB_SETWINDOWTHEME bericht geëmuleren, zoals beschreven in de Windows SDK.

Zie ook

MFC-voorbeeld CMNCTRL1
MFC-voorbeeld MFCIE
CWnd klasse
Hiërarchiegrafiek
CToolBar klasse

  • Last updated on