Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
Opmerking
De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.
De CMFCRibbonCategory klasse implementeert een linttabblad dat een groep lintpanelen bevat.
Syntaxis
class CMFCRibbonCategory : public CObject
Leden
Beveiligde constructors
| Naam | Description |
|---|---|
| CMFCRibbonCategory::CMFCRibbonCategory | De constructor. |
Openbare methoden
Opmerkingen
Normaal gesproken maakt u indirect een lintcategorie door CMFCRibbonBar::AddCategory aan te roepen, waarmee een aanwijzer wordt geretourneerd naar de zojuist gemaakte lintcategorie. U voegt panelen toe aan de categorie door CMFCRibbonCategory::AddPanel aan te roepen.
De CMFCRibbonTab klasse tekent lintcategorieën. Het is afgeleid van CMFCRibbonBaseElement Class.
In dit volgende voorbeeld ziet u hoe u een lintcategorie maakt en er een deelvenster aan toevoegt.
// Create a new ribbon category and get a pointer to it
CMFCRibbonCategory* pCategory = m_wndRibbonBar.AddCategory
(_T("&Write"), // Category name
IDB_WRITE, // Category small images (16 x 16)
IDB_WRITE_LARGE); // Category large images (32 x 32)
// Add a panel to the new category
CMFCRibbonPanel* pPanel = pCategory->AddPanel (
_T("Clipboard"), // Panel name
m_PanelIcons.ExtractIcon (0)); // Panel icon
In het volgende diagram ziet u een afbeelding van de categorie Start in de voorbeeldtoepassing RibbonApp.
Overnamehiërarchie
CMFCRibbonCategory
Requirements
Koptekst: afxribboncategory.h
CMFCRibbonCategory::AddHidden
Hiermee voegt u het opgegeven lintelement toe aan de matrix met lintelementen die worden weergegeven in het dialoogvenster Aanpassing.
void AddHidden(CMFCRibbonBaseElement* pElem);
Parameterwaarden
pElem
[in] Aanwijzer naar een lintelement.
Opmerkingen
Lintelementen in het dialoogvenster Aanpassing zijn de opdrachten die u kunt toevoegen aan de werkbalk Snelle toegang.
CMFCRibbonCategory::AddPanel
Hiermee maakt u een lintpaneel voor de categorie van het lint.
CMFCRibbonPanel* AddPanel(
LPCTSTR lpszPanelName,
HICON hIcon = 0,
CRuntimeClass* pRTI = NULL);
Parameterwaarden
lpszPanelName
[in] Wijs de naam van het nieuwe lintpaneel aan.
hIcon
[in] Greep naar het standaardpictogram voor het nieuwe lintpaneel.
pRTI
[in] Aanwijzer naar runtimeklasse-informatie voor een aangepast lintpaneel.
Retourwaarde
Wijs het nieuwe lintpaneel aan als de methode is geslaagd; anders NULL als het deelvenster niet is gemaakt.
Opmerkingen
Als u een aangepast lintpaneel wilt maken, moet u de runtimeklasse-informatie opgeven in pRTI. De aangepaste klasse van het lintpaneel moet worden afgeleid van de CMFCRibbonPanel klasse.
Het standaardpictogram voor het lintvenster wordt weergegeven wanneer er onvoldoende ruimte is om de lintelementen weer te geven.
Example
In het volgende voorbeeld ziet u hoe u de AddPanel methode in de CMFCRibbonCategory klasse gebruikt.
// Create "Favorites" panel:
strTemp.LoadString(IDS_RIBBON_FAVORITES);
// CMFCRibbonCategory* pCategoryCustom
CMFCRibbonPanel *pPanelFavorites = pCategoryCustom->AddPanel(strTemp,
m_PanelImages.ExtractIcon(15));
CMFCRibbonCategory::CMFCRibbonCategory
Bouwt en initialiseert een CMFCRibbonCategory-object .
CMFCRibbonCategory(
CMFCRibbonBar* pParenrRibbonBar,
LPCTSTR lpszName,
UINT uiSmallImagesResID,
UINT uiLargeImagesResID,
CSize sizeSmallImage = CSize(16,
16),
CSize sizeLargeImage = CSize(32,
32));
Parameterwaarden
pParenrRibbonBar
[in] Aanwijzer naar de bovenliggende lintbalk van de lintcategorie.
lpszName
[in] Naam van de lintcategorie.
uiSmallImagesResID
[in] Resource-id van de lijst met afbeeldingen voor kleine afbeeldingen die worden gebruikt door lintelementen in de categorie van het lint.
uiLargeImagesResID
[in] Resource-id van de lijst met afbeeldingen voor grote afbeeldingen die worden gebruikt door lintelementen in de categorie van het lint.
sizeSmallImage
[in] Standaardgrootte van kleine afbeeldingen voor lintelementen in de lintcategorie.
sizeLargeImage
[in] Standaardgrootte van grote afbeeldingen voor lintelementen in de categorie lint.
CMFCRibbonCategory::CopyFrom
Kopieert de status van de opgegeven CMFCRibbonCategory naar het huidige CMFCRibbonCategory-object .
virtual void CopyFrom(CMFCRibbonCategory& src);
Parameterwaarden
Src
[in] Het bronobject CMFCRibbonCategory .
Opmerkingen
CMFCRibbonCategory::FindByData
Hiermee wordt het lintelement opgehaald dat is gekoppeld aan de opgegeven gegevens.
CMFCRibbonBaseElement* FindByData(
DWORD_PTR dwData,
BOOL bVisibleOnly = TRUE) const;
Parameterwaarden
dwData
[in] De gegevens die zijn gekoppeld aan een lintelement.
bVisibleOnly
[in] WAAR voor het opnemen van lintelementen voor snelle toegang in de zoekopdracht; FALSE om lintelementen voor snelle toegang uit te sluiten in de zoekopdracht.
Retourwaarde
Aanwijzer naar een lintelement als de methode is geslaagd; anders NULL.
Opmerkingen
CMFCRibbonCategory::FindByID
Hiermee wordt het lintelement opgehaald dat is gekoppeld aan de opgegeven opdracht-id.
CMFCRibbonBaseElement* FindByID(
UINT uiCmdID,
BOOL bVisibleOnly = TRUE) const;
Parameterwaarden
uiCmdID
[in] Opdracht-id die is gekoppeld aan een lintelement.
bVisibleOnly
[in] WAAR voor het opnemen van lintelementen voor snelle toegang in de zoekopdracht; FALSE om lintelementen voor snelle toegang uit te sluiten in de zoekopdracht.
Retourwaarde
Aanwijzer naar een lintelement als de methode is geslaagd; anders NULL.
Opmerkingen
CMFCRibbonCategory::FindPanelWithElem
Hiermee wordt het lintvenster opgehaald dat het opgegeven lintelement bevat.
CMFCRibbonPanel* FindPanelWithElem(const CMFCRibbonBaseElement* pElement);
Parameterwaarden
pElement
[in] Aanwijzer naar een lintelement.
Retourwaarde
Wijs een aanwijzer naar een lintpaneel als de methode is geslaagd; anders NULL.
Opmerkingen
CMFCRibbonCategory::GetContextID
Hiermee wordt de context-id van de lintcategorie opgehaald.
UINT GetContextID() const;
Retourwaarde
Context-id van de lintcategorie.
Opmerkingen
De context-id is 0 als de lintcategorie geen contextlintcategorie is.
CMFCRibbonCategory::GetData
Hiermee worden de door de gebruiker gedefinieerde gegevens opgehaald die aan de lintcategorie zijn gekoppeld.
DWORD_PTR GetData() const;
Retourwaarde
De door de gebruiker gedefinieerde gegevens die zijn gekoppeld aan de lintcategorie.
CMFCRibbonCategory::GetDroppedDown
Hiermee wordt een aanwijzer opgehaald naar het lintelement waarop momenteel het pop-upmenu wordt weergegeven.
CMFCRibbonBaseElement* GetDroppedDown();
Retourwaarde
Aanwijzer naar een lintelement als de methode is geslaagd; anders NULL.
Opmerkingen
CMFCRibbonCategory::GetElements
Hiermee worden alle lintelementen in de lintcategorie opgehaald.
void GetElements(
CArray <CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Parameterwaarden
arElements
[in, uit] Verwijzing naar een CArray van lintelementen.
Opmerkingen
Lintelementen die zijn ontworpen voor gebruik op de werkbalk Snelle toegang, worden opgenomen in de matrix.
CMFCRibbonCategory::GetElementsByID
Hiermee worden alle lintelementen opgehaald die zijn gekoppeld aan de opgegeven opdracht-id.
void GetElementsByID(
UINT uiCmdID,
CArray <CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Parameterwaarden
uiCmdID
[in] Opdracht-id die is gekoppeld aan een lintelement.
arElements
[in, uit] Verwijzing naar een CArray van lintelementen.
Opmerkingen
Lintelementen die zijn ontworpen voor gebruik op de werkbalk Snelle toegang, worden opgenomen in de matrix.
CMFCRibbonCategory::GetFirstVisibleElement
Hiermee wordt het eerste zichtbare element opgehaald dat deel uitmaakt van de lintcategorie.
CMFCRibbonBaseElement* GetFirstVisibleElement() const;
Retourwaarde
Aanwijzer naar het eerste zichtbare element; kan NULL zijn als de categorie geen zichtbare elementen bevat.
Opmerkingen
CMFCRibbonCategory::GetFocused
Retourneert een gericht element.
CMFCRibbonBaseElement* GetFocused();
Retourwaarde
Een aanwijzer naar een gericht element of NULL.
Opmerkingen
CMFCRibbonCategory::GetHighlighted
Retourneert een gemarkeerd element.
CMFCRibbonBaseElement* GetHighlighted();
Retourwaarde
Een aanwijzer naar een gemarkeerd element of NULL als er geen elementen zijn gemarkeerd.
Opmerkingen
CMFCRibbonCategory::GetImageCount
Hiermee haalt u het aantal afbeeldingen op in de opgegeven lijst met afbeeldingen die zich in de lintcategorie bevinden.
int GetImageCount(BOOL bIsLargeImage) const;
Parameterwaarden
bIsLargeImage
[in] WAAR voor het aantal afbeeldingen in de grote lijst met afbeeldingen; ONWAAR voor het aantal afbeeldingen in de kleine lijst met afbeeldingen.
Retourwaarde
Het aantal afbeeldingen in de opgegeven lijst met afbeeldingen.
Opmerkingen
CMFCRibbonCategory::GetImageSize
Hiermee haalt u de grootte van een afbeelding op in de opgegeven lijst met afbeeldingen die zich in de lintcategorie bevindt.
CSize GetImageSize(BOOL bIsLargeImage) const;
Parameterwaarden
bIsLargeImage
[in] WAAR voor de grootte van grote afbeeldingen; ONWAAR voor de grootte van kleine afbeeldingen.
Retourwaarde
De grootte van een afbeelding in de opgegeven lijst met afbeeldingen.
Opmerkingen
De opgehaalde grootte omvat de globale schaalfactor voor afbeeldingen.
CMFCRibbonCategory::GetItemIDsList
Hiermee worden de opdracht-id's opgehaald voor de lintelementen die zijn opgenomen in de lintcategorie.
void GetItemIDsList(
CList<UINT, UINT>& lstItems,
BOOL bHiddenOnly = FALSE) const;
Parameterwaarden
lstItems
[uit] De lijst met opdracht-id's voor de lintelementen in de lintcategorie.
bHiddenOnly
[in] WAAR om lintelementen uit te sluiten die worden weergegeven op de lintvensters in de categorie van het lint; ONWAAR om alle lintelementen in de lintcategorie op te nemen.
Opmerkingen
CMFCRibbonCategory::GetLargeImages
Hiermee haalt u de lijst met grote afbeeldingen op die zich in de lintcategorie bevinden.
CMFCToolBarImages& GetLargeImages();
Retourwaarde
De lijst met grote afbeeldingen die zich in de lintcategorie bevinden.
CMFCRibbonCategory::GetLastVisibleElement
Hiermee wordt het laatste zichtbare element opgehaald dat deel uitmaakt van de lintcategorie.
CMFCRibbonBaseElement* GetLastVisibleElement() const;
Retourwaarde
Aanwijzer naar het laatste zichtbare element; kan NULL zijn als de categorie geen zichtbare elementen bevat.
Opmerkingen
CMFCRibbonCategory::GetMaxHeight
Hiermee haalt u de maximale hoogte op van de lintpanelen die zich in de lintcategorie bevinden.
int GetMaxHeight(CDC* pDC);
Parameterwaarden
Pdc
[in] Aanwijzer naar een apparaatcontext voor de lintvensters.
Retourwaarde
De maximale hoogte van de lintpanelen die zich in de lintcategorie bevinden.
Opmerkingen
De opgehaalde waarde bevat de hoogte van de boven- en ondermarges voor de lintpanelen.
CMFCRibbonCategory::GetName
Hiermee haalt u de naam van de lintcategorie op.
LPCTSTR GetName() const;
Retourwaarde
De naam van de lintcategorie.
Opmerkingen
CMFCRibbonCategory::GetPanel
Retourneert een aanwijzer naar het lintpaneel dat zich in de opgegeven index bevindt.
CMFCRibbonPanel* GetPanel(int nIndex);
Parameterwaarden
nIndex
[in] De op nul gebaseerde index van een lintpaneel.
Retourwaarde
Wijs het lintpaneel aan dat zich in de opgegeven index bevindt.
Opmerkingen
Er wordt een uitzondering gegenereerd als nIndex buiten het bereik valt.
CMFCRibbonCategory::GetPanelCount
Retourneert het aantal lintvensters in de lintcategorie.
int GetPanelCount() const;
Retourwaarde
Het aantal lintvensters in de lintcategorie.
CMFCRibbonCategory::GetPanelFromPoint
Hiermee wordt een aanwijzer naar een lintvenster opgehaald als het opgegeven punt zich in het lint bevindt.
CMFCRibbonPanel* GetPanelFromPoint(CPoint point) const;
Parameterwaarden
Punt
[in] De x- en y-coördinaten van de aanwijzer ten opzichte van de linkerbovenhoek van het venster.
Retourwaarde
Wijs een aanwijzer naar een lintpaneel als de methode is geslaagd; anders NULL.
Opmerkingen
Alleen lintpanelen die zich in de lintcategorie bevinden, worden getest.
CMFCRibbonCategory::GetPanelIndex
Hiermee haalt u de op nul gebaseerde index van het opgegeven lintpaneel op.
int GetPanelIndex(const CMFCRibbonPanel* pPanel) const;
Parameterwaarden
pPanel
[in] Aanwijzer naar een lintpaneel.
Retourwaarde
Index op basis van nul van het opgegeven lintpaneel als de methode is geslaagd; anders -1.
Opmerkingen
Alleen lintvensters die zich in de lintcategorie bevinden, worden doorzocht.
CMFCRibbonCategory::GetParentButton
Hiermee wordt het bovenliggende lintelement van de lintcategorie opgehaald.
CMFCRibbonBaseElement* GetParentButton() const;
Retourwaarde
Retourneert een aanwijzer naar het bovenliggende lintelement of NULL als er geen bovenliggend element is.
Opmerkingen
CMFCRibbonCategory::GetParentMenuBar
Retourneert een aanwijzer naar de bovenliggende menubalk van het CMFCRibbonCategory object.
CMFCRibbonPanelMenuBar* GetParentMenuBar() const;
Retourwaarde
Retourneert de inhoud van het m_pParentMenuBar beveiligde lid.
Opmerkingen
CMFCRibbonCategory::GetParentRibbonBar
Hiermee wordt de bovenliggende lintbalk voor de lintcategorie opgehaald.
CMFCRibbonBar* GetParentRibbonBar() const;
Retourwaarde
Aanwijzer naar de bovenliggende lintbalk voor de lintcategorie.
Opmerkingen
CMFCRibbonCategory::GetRect
Hiermee wordt de weergaverechthoek voor de lintcategorie opgehaald.
CRect GetRect() const;
Retourwaarde
De weergaverechthoek voor de lintcategorie.
Opmerkingen
De weergaverechthoek voor de lintcategorie bevat niet het categorietabblad.
CMFCRibbonCategory::GetSmallImages
Hiermee haalt u de lijst met kleine afbeeldingen op die zijn opgenomen in de lintcategorie.
CMFCToolBarImages& GetSmallImages();
Retourwaarde
De lijst met kleine afbeeldingen die zich in de lintcategorie bevinden.
CMFCRibbonCategory::GetTabColor
Retourneert de huidige kleur van het tabblad Lintcategorie.
AFX_RibbonCategoryColor GetTabColor() const;
Retourwaarde
De huidige kleur van het tabblad Lintcategorie.
Opmerkingen
De geretourneerde waarde kan een van de volgende opgesomde waarden zijn:
AFX_CategoryColor_Red
AFX_CategoryColor_Orange
AFX_CategoryColor_Yellow
AFX_CategoryColor_Green
AFX_CategoryColor_Blue
AFX_CategoryColor_Indigo
AFX_CategoryColor_Violet
CMFCRibbonCategory::GetTabRect
Hiermee wordt de weergaverechthoek voor het tabblad Lintcategorie opgehaald.
CRect GetTabRect() const;
Retourwaarde
De weergaverechthoek voor het tabblad Lintcategorie.
Opmerkingen
CMFCRibbonCategory::GetTextTopLine
Hiermee haalt u de verticale locatie van tekst op lintknoppen op in de lintcategorie waarin grote afbeeldingen worden weergegeven.
int GetTextTopLine() const;
Retourwaarde
De verticale locatie van tekst, in pixels, op lintknoppen met grote afbeeldingen.
Opmerkingen
CMFCRibbonCategory::GetVisibleElements
Hiermee worden alle zichtbare elementen opgehaald die deel uitmaken van de lintcategorie.
void GetVisibleElements(
CArray <CMFCRibbonBaseElement*,
CMFCRibbonBaseElement*>& arElements);
Parameterwaarden
arElements
Matrix van alle zichtbare elementen.
Opmerkingen
CMFCRibbonCategory::HighlightPanel
Hiermee wordt het opgegeven lintvenster gemarkeerd.
CMFCRibbonPanel* HighlightPanel(
CMFCRibbonPanel* pHLPanel,
CPoint point);
Parameterwaarden
pHLPanel
[in] Aanwijzer naar het lintpaneel om te markeren.
Punt
[in] De x- en y-coördinaten van de aanwijzer ten opzichte van de linkerbovenhoek van het venster.
Retourwaarde
Aanwijzer naar het eerder gemarkeerde lintpaneel; anders NULL als er geen lintpaneel is gemarkeerd wanneer deze methode wordt aangeroepen.
Opmerkingen
Zie CMFCRibbonPanel::Highlight voor meer informatie over het markeren van een lintpaneel.
CMFCRibbonCategory::HitTest
Hiermee wordt een aanwijzer naar een lintelement opgehaald als het opgegeven punt zich daarin bevindt.
CMFCRibbonBaseElement* HitTest(
CPoint point,
BOOL bCheckPanelCaption = FALSE) const;
Parameterwaarden
Punt
[in] De x- en y-coördinaten van de muisaanwijzer ten opzichte van de linkerbovenhoek van het venster.
bCheckPanelCaption
[in] WAAR om het bijschrift van het lintpaneel te testen; FALSE om het bijschrift van het lintpaneel uit te sluiten.
Retourwaarde
Aanwijzer naar een lintelement als de methode is geslaagd; anders NULL.
Opmerkingen
Alleen lintelementen die zich in de lintcategorie bevinden, worden getest.
CMFCRibbonCategory::HitTestEx
Haalt de op nul gebaseerde index van een lintelement op als het opgegeven punt zich daarin bevindt.
int HitTestEx(CPoint point) const;
Parameterwaarden
Punt
[in] De x- en y-coördinaten van de muisaanwijzer ten opzichte van de linkerbovenhoek van het venster.
Retourwaarde
Op nul gebaseerde index van een lintelement als de methode is geslaagd; anders -1.
Opmerkingen
Alleen lintelementen die zich in de lintcategorie bevinden, worden getest.
CMFCRibbonCategory::HitTestScrollButtons
Als een punt binnen de linker- of rechterschuifknop van een lintcategorie valt, wordt een aanwijzer naar die knop geretourneerd.
CMFCRibbonBaseElement* HitTestScrollButtons(CPoint point) const;
Parameterwaarden
Punt
[in] Het punt om te testen.
Retourwaarde
Als het punt binnen de begrenzingsrechthoek van de linker- of rechterschuifknop van de lintcategorie valt, retourneert u een aanwijzer naar die knop, anders wordt NULL geretourneerd.
Opmerkingen
CMFCRibbonCategory::IsActive
Hiermee wordt aangegeven of de lintcategorie de actieve categorie op de lintbalk is.
BOOL IsActive() const;
Retourwaarde
WAAR als de lintcategorie de actieve categorie is; anders ONWAAR.
Opmerkingen
In de actieve lintcategorie worden de lintvensters weergegeven.
CMFCRibbonCategory::IsVisible
Hiermee wordt aangegeven of de lintcategorie zichtbaar is.
BOOL IsVisible() const;
Retourwaarde
WAAR als de lintcategorie zichtbaar is; anders ONWAAR.
Opmerkingen
Lintcategorieën die zichtbaar zijn, geven een categorietabblad weer.
CMFCRibbonCategory::IsWindows7Look
Hiermee wordt aangegeven of het bovenliggende lint een Windows 7-uiterlijk heeft (kleine rechthoekige toepassingsknop).
BOOL IsWindows7Look() const;
Retourwaarde
WAAR als het bovenliggende lint windows 7 heeft; anders ONWAAR.
Opmerkingen
CMFCRibbonCategory::NotifyControlCommand
Levert een WM_NOTIFY opdrachtbericht aan alle CMFCRibbonPanel elementen in het CMFCRibbonCategory bericht totdat het bericht wordt verwerkt.
virtual BOOL NotifyControlCommand(
BOOL bAccelerator,
int nNotifyCode,
WPARAM wParam,
LPARAM lParam);
Parameterwaarden
bAccelerator
[in] WAAR als deze opdracht afkomstig is van een accelerator of anderszins ONWAAR.
nNotifyCode
[in] De meldingscode.
wParam-
[in] Het WPARAM-veld van het bericht.
lParam-
[in] Het LPARAM-veld van het bericht.
Retourwaarde
Retourneert TRUE als het bericht is verwerkt of ONWAAR als dat niet het geval is.
Opmerkingen
CMFCRibbonCategory::OnCancelMode
Roept de annuleringsmodus aan in alle CMFCRibbonPanel elementen van de CMFCRibbonCategory.
virtual void OnCancelMode();
Opmerkingen
CMFCRibbonCategory::OnDraw
Aangeroepen door het framework om de lintcategorie te tekenen.
virtual void OnDraw(CDC* pDC);
Parameterwaarden
Pdc
[in] Aanwijzer naar een apparaatcontext voor de lintcategorie.
Opmerkingen
CMFCRibbonCategory::OnDrawImage
Aangeroepen door het framework om de opgegeven afbeelding op de lintcategorie te tekenen.
virtual BOOL OnDrawImage(
CDC* pDC,
CRect rect,
CMFCRibbonBaseElement* pElement,
BOOL bIsLargeImage,
BOOL nImageIndex,
BOOL bCenter);
Parameterwaarden
Pdc
[in] Aanwijzer naar een apparaatcontext voor de afbeelding.
Rect
[in] Rechthoek voor de afbeelding weergeven.
pElement
[in] Wijs het lintelement aan dat de afbeelding bevat.
bIsLargeImage
[in] WAAR als de afbeelding de grote grootte heeft; ONWAAR als de afbeelding de kleine grootte heeft.
nImageIndex
[in] Op nul gebaseerde index van de afbeelding in de afbeeldingsmatrix die zich in de lintcategorie bevindt.
bCenter
[in] WAAR om de afbeelding in de weergaverechthoek te centreren; FALSE om de afbeelding te tekenen in de linkerbovenhoek van de weergaverechthoek.
Retourwaarde
WAAR als de methode is geslaagd; anders ONWAAR.
Opmerkingen
CMFCRibbonCategory::OnDrawMenuBorder
Aangeroepen door het framework om de rand van een pop-upmenu te tekenen.
virtual void OnDrawMenuBorder(
CDC* pDC,
CMFCRibbonPanelMenuBar* pMenuBar);
Parameterwaarden
Pdc
[in] Deze parameter wordt niet gebruikt.
pMenubalk
[in] Deze parameter wordt niet gebruikt.
Opmerkingen
Deze methode doet standaard niets. Overschrijf deze methode om de rand van een pop-upmenu te tekenen.
CMFCRibbonCategory::OnKey
Aangeroepen door het framework wanneer een gebruiker op een toetsenbordknop drukt.
virtual BOOL OnKey(UINT nChar);
Parameterwaarden
Nchar
De code van de virtuele sleutel voor de sleutel waarop een gebruiker heeft gedrukt.
Opmerkingen
CMFCRibbonCategory::OnLButtonDown
Aangeroepen door het framework om het lintelement onder het opgegeven punt op te halen wanneer de gebruiker op de linkermuisknop drukt.
virtual CMFCRibbonBaseElement* OnLButtonDown(CPoint point);
Parameterwaarden
Punt
[in] De x- en y-coördinaten van de muisaanwijzer ten opzichte van de linkerbovenhoek van het venster.
Retourwaarde
Aanwijzer naar een lintelement als de methode is geslaagd; anders NULL.
Opmerkingen
CMFCRibbonCategory::OnLButtonUp
Aangeroepen door het framework wanneer de gebruiker de linkermuisknop loslaat en de aanwijzer zich boven de lintcategorie bevindt.
virtual void OnLButtonUp(CPoint point);
Parameterwaarden
Punt
[in] De x- en y-coördinaten van de aanwijzer ten opzichte van de linkerbovenhoek van het venster.
Opmerkingen
CMFCRibbonCategory::OnMouseMove
Aangeroepen door het framework wanneer de aanwijzer op de lintbalk wordt verplaatst om de weergave van de lintcategorie bij te werken.
virtual void OnMouseMove(CPoint point);
Parameterwaarden
Punt
[in] De x- en y-coördinaten van de aanwijzer ten opzichte van de linkerbovenhoek van het venster.
Opmerkingen
CMFCRibbonCategory::OnRTLChanged
Aangeroepen door het framework wanneer de indeling de richting wijzigt.
virtual void OnRTLChanged(BOOL bIsRTL);
Parameterwaarden
bIsRTL
[in] WAAR als de indeling van rechts naar links is; ONWAAR als de indeling van links naar rechts is.
Opmerkingen
Met deze methode wordt de indeling aangepast van alle lintvensters en lintelementen die zich in de categorie van het lint bevinden.
CMFCRibbonCategory::OnScrollHorz
Hiermee schuift u de lintcategorie in de horizontale richting.
virtual BOOL OnScrollHorz(
BOOL bScrollLeft,
int nScrollOffset = 0);
Parameterwaarden
bScrollLeft
[in] WAAR om naar links te schuiven; FALSE om naar rechts te schuiven.
nScrollOffset
[in] De schuifafstand in pixels.
Retourwaarde
WAAR als de lintcategorie in een horizontale richting is verplaatst; anders ONWAAR.
Opmerkingen
CMFCRibbonCategory::OnUpdateCmdUI
Roept de OnUpdateCmdUI lidfunctie aan in elk van de elementen van de CMFCRibbonPanelCMFCRibbonCategory onderdelen om de elementen van de gebruikersinterface in of uit te schakelen.
virtual void OnUpdateCmdUI(
CMFCRibbonCmdUI* pCmdUI,
CFrameWnd* pTarget,
BOOL bDisableIfNoHndler);
Parameterwaarden
pCmdUI
[in] Wijs het object aan dat aangeeft welke elementen van de CMFCRibbonCmdUI gebruikersinterface moeten worden ingeschakeld en welke moeten worden uitgeschakeld.
pTarget
[in] Wijs het venster aan waarmee het in- of uitschakelen van de elementen van de gebruikersinterface wordt bepaald.
bDisableIfNoHndler
[in] TRUE om het gebruikersinterface-item uit te schakelen als er geen handler is gedefinieerd in een berichtoverzicht; anders, ONWAAR.
Opmerkingen
CMFCRibbonCategory::RecalcLayout
Hiermee past u de indeling van alle besturingselementen in de lintcategorie aan.
virtual void RecalcLayout(CDC* pDC);
Parameterwaarden
Pdc
[in] Aanwijzer naar een apparaatcontext voor de lintcategorie.
Opmerkingen
CMFCRibbonCategory::RemovePanel
Hiermee verwijdert u een lintpaneel uit de lintcategorie.
BOOL RemovePanel(
int nIndex,
BOOL bDelete = TRUE);
Parameterwaarden
nIndex
[in] Het indexnummer van het deelvenster dat moet worden verwijderd. Verkregen door de methode CMFCRibbonCategory::GetPanelIndex aan te roepen.
bDelete
[in] WAAR om het paneelobject uit het geheugen te verwijderen; FALSE om het paneelobject te verwijderen zonder het te verwijderen.
Retourwaarde
WAAR als de methode is geslaagd; anders, ONWAAR.
CMFCRibbonCategory::ReposPanels
Hiermee past u de indeling van alle besturingselementen op de lintvensters aan die zich in de lintcategorie bevinden.
virtual void ReposPanels(CDC* pDC);
Parameterwaarden
Pdc
[in] Wijs een apparaatcontext aan voor de lintvensters die zich in de lintcategorie bevinden.
Opmerkingen
CMFCRibbonCategory::SetCollapseOrder
Hiermee definieert u de volgorde waarin de lintvensters van de lintcategorie worden samengevouwen.
void SetCollapseOrder(const CArray<int,int>& arCollapseOrder);
Parameterwaarden
arCollapseOrder
[in] Hiermee geeft u de samenvouwen volgorde. De matrix bevat op nul gebaseerde indexen van lintpanelen.
Opmerkingen
De bibliotheek definieert de samenvouwen volgorde. U kunt dit gedrag echter aanpassen door de categorie op te geven met de lijst met indexen waarmee de samenvouwen volgorde wordt opgegeven.
Wanneer de categorie detecteert dat het een lintvenster moet samenvouwen, wordt gezocht naar het volgende element in de opgegeven lijst. Als de lijst leeg is of als u onvoldoende elementen hebt opgegeven, gebruikt de categorie het interne algoritme.
De categorie heeft bijvoorbeeld drie lintpanelen en kan meerdere keren worden samengevouwen totdat alle panelen de volledig samengevouwen status hebben. U kunt de volgende samenvouwen volgorde instellen: 0, 0, 2, 2. In dit geval zal de categorie het paneel twee keer samenvouwen, het paneel twee keer. Het paneel met de index van 1 blijft ongecollapseerd.
Example
In het volgende voorbeeld ziet u hoe u de SetCollapseOrder methode in de CMFCRibbonCategory klasse gebruikt. In het voorbeeld ziet u hoe u een matrix maakt voor de samenvouwen volgorde en hoe u de samenvouwen volgorde instelt op de lintcategorie.
CArray<int, int> arCollapseOrder;
arCollapseOrder.Add(0);
arCollapseOrder.Add(1);
arCollapseOrder.Add(2);
// CMFCRibbonCategory* pCategoryHome
pCategoryHome->SetCollapseOrder(arCollapseOrder);
CMFCRibbonCategory::SetData
Hiermee stelt u de door de gebruiker gedefinieerde gegevens in die aan de lintcategorie moeten worden gekoppeld.
void SetData(DWORD_PTR dwData);
Parameterwaarden
dwData
[in] De door de gebruiker gedefinieerde gegevens.
CMFCRibbonCategory::SetKeys
Hiermee wordt een toetstip toegewezen aan de lintcategorie.
void SetKeys(LPCTSTR lpszKeys);
Parameterwaarden
lpszKeys
[in] De tekst van de toetsinfo.
Opmerkingen
Keytips worden weergegeven wanneer de gebruiker op de Alt-toets of de F10-toets drukt.
CMFCRibbonCategory::SetName
Hiermee wijst u een naam en toetsinfo toe aan de lintcategorie.
void SetName(LPCTSTR lpszName);
Parameterwaarden
lpszName
[in] De naam en de toetsinfo van de lintcategorie.
Opmerkingen
Als u de toetstip voor de lintcategorie wilt instellen, voegt u een escapereeks voor nieuwe regels toe, gevolgd door de toetstiptekens aan lpszName.
CMFCRibbonCategory::SetTabColor
Hiermee stelt u de kleur van de lintcategorie in.
void SetTabColor(AFX_RibbonCategoryColor color);
Parameterwaarden
kleur
[in] Hiermee geeft u de nieuwe kleur van de lintcategorie op.
Opmerkingen
Kleur kan een van de volgende waarden zijn:
AFX_CategoryColor_None
AFX_CategoryColor_Red
AFX_CategoryColor_Orange
AFX_CategoryColor_Yellow
AFX_CategoryColor_Green
AFX_CategoryColor_Blue
AFX_CategoryColor_Indigo
AFX_CategoryColor_Violet