`CMFCRibbonBar`-klasse

Artikel
03/17/2025

De CMFCRibbonBar-klasse implementeert een lintbalk die vergelijkbaar is met die in Office 2007.

Zie de broncode in de mfc map van uw Visual Studio-installatie voor meer informatie. Bijvoorbeeld %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Syntaxis

class CMFCRibbonBar : public CPane

Leden

Openbare constructors

Naam	Beschrijving
`CMFCRibbonBar::CMFCRibbonBar`	Standaardconstructor.

Openbare methoden

Naam	Beschrijving
`CMFCRibbonBar::ActivateContextCategory`	Hiermee wordt een contextcategorie geactiveerd die al zichtbaar is.
`CMFCRibbonBar::AddCategory`	Hiermee voegt u een nieuwe lintcategorie toe aan het lint.
`CMFCRibbonBar::AddContextCategory`	Hiermee voegt u een contextcategorie toe.
`CMFCRibbonBar::AddMainCategory`	Hiermee voegt u een nieuwe hoofdlintcategorie toe.
`CMFCRibbonBar::AddPrintPreviewCategory`
`CMFCRibbonBar::AddQATOnlyCategory`
`CMFCRibbonBar::AddToTabs`	Een lintelement rechts van een lintbalk toevoegen.
`CMFCRibbonBar::CreateEx`	Hiermee maakt u een besturingsbalk en koppelt u deze aan het `CPane`-object. (Overschrijft `CPane::CreateEx`.)
`CMFCRibbonBar::Create`	Hiermee maakt u een besturingselement op de lintbalk en koppelt u het aan een lintbalk.
`CMFCRibbonBar::DeactivateKeyboardFocus`
`CMFCRibbonBar::DrawMenuImage`
`CMFCRibbonBar::DWMCompositionChanged`
`CMFCRibbonBar::EnableKeyTips`	Belangrijke tips voor het lintbesturingselement in- of uitschakelen.
`CMFCRibbonBar::EnablePrintPreview`	Schakel het tabblad afdrukvoorbeeld in.
`CMFCRibbonBar::EnableToolTips`	Hiermee kunt u knopinfo en beschrijvingen van knopinfo op de lintbalk in- of uitschakelen.
`CMFCRibbonBar::FindByData`	Zoek een lintelement met behulp van gegevens die een gebruiker opgeeft.
`CMFCRibbonBar::FindByID`	Hiermee zoekt u een lintelement met de opgegeven opdracht-id.
`CMFCRibbonBar::FindCategoryIndexByData`	Hiermee zoekt u de index van de lintcategorie die de door de gebruiker gedefinieerde gegevens bevat.
`CMFCRibbonBar::ForceRecalcLayout`
`CMFCRibbonBar::GetActiveCategory`	Hiermee haalt u een aanwijzer op naar een actieve categorie.
`CMFCRibbonBar::GetCaptionHeight`	Retourneert de hoogte van het bijschrift. (Overschrijft `CBasePane::GetCaptionHeight`.)
`CMFCRibbonBar::GetCategory`	Hiermee haalt u de aanwijzer op naar een categorie die zich in een opgegeven index bevindt.
`CMFCRibbonBar::GetCategoryCount`	Hiermee haalt u het aantal lintcategorieën op de lintbalk op.
`CMFCRibbonBar::GetCategoryHeight`
`CMFCRibbonBar::GetCategoryIndex`	Retourneert de index van een lintcategorie.
`CMFCRibbonBar::GetContextName`	Haalt de naam op van het contextcategoriebijschrift dat u opgeeft met behulp van een id.
`CMFCRibbonBar::GetDroppedDown`
`CMFCRibbonBar::GetElementsByID`	Hiermee haalt u een matrix op die de aanwijzers bevat naar alle lintelementen met de opgegeven id.
`CMFCRibbonBar::GetApplicationButton`	Hiermee wordt een aanwijzer naar een lintknop weergegeven.
`CMFCRibbonBar::GetFocused`	Retourneert een gericht element.
`CMFCRibbonBar::GetHideFlags`
`CMFCRibbonBar::GetItemIDsList`
`CMFCRibbonBar::GetKeyboardNavigationLevel`
`CMFCRibbonBar::GetKeyboardNavLevelCurrent`
`CMFCRibbonBar::GetKeyboardNavLevelParent`
`CMFCRibbonBar::GetMainCategory`	Hiermee wordt een aanwijzer geretourneerd naar de lintcategorie die momenteel is geselecteerd.
`CMFCRibbonBar::GetQATCommandsLocation`
`CMFCRibbonBar::GetQATDroppedDown`
`CMFCRibbonBar::GetQuickAccessCommands`	Hiermee wordt een lijst ingevuld met de opdracht-id's van alle elementen die worden weergegeven op de werkbalk Snelle toegang.
`CMFCRibbonBar::GetQuickAccessToolbarLocation`
`CMFCRibbonBar::GetTabTrancateRatio`
`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`
`CMFCRibbonBar::GetTooltipFixedWidthRegular`
`CMFCRibbonBar::GetVisibleCategoryCount`
`CMFCRibbonBar::HideAllContextCategories`	Hiermee worden alle categorieën verborgen die actief en zichtbaar zijn.
`CMFCRibbonBar::HideKeyTips`
`CMFCRibbonBar::HitTest`	Hiermee zoekt u een aanwijzer naar het lintelement dat zich op het opgegeven punt in de clientcoördinaten van de lintbalk bevindt.
`CMFCRibbonBar::IsKeyTipEnabled`	Bepaalt of keytips zijn ingeschakeld.
`CMFCRibbonBar::IsMainRibbonBar`
`CMFCRibbonBar::IsPrintPreviewEnabled`	Bepaalt of het tabblad afdrukvoorbeeld is ingeschakeld.
`CMFCRibbonBar::IsQATEmpty`
`CMFCRibbonBar::IsQuickAccessToolbarOnTop`	Hiermee geeft u op of de werkbalk Snelle toegang zich boven de lintbalk bevindt.
`CMFCRibbonBar::IsReplaceFrameCaption`	Bepaalt of de lintbalk het hoofdframebijschrift vervangt of onder het framebijschrift wordt toegevoegd.
`CMFCRibbonBar::IsShowGroupBorder`
`CMFCRibbonBar::IsToolTipDescrEnabled`	Bepaalt of de beschrijvingen van knopinfo zijn ingeschakeld.
`CMFCRibbonBar::IsToolTipEnabled`	Bepaalt of de knopinfo voor de lintbalk is ingeschakeld.
`CMFCRibbonBar::IsTransparentCaption`
`CMFCRibbonBar::IsWindows7Look`	Hiermee wordt aangegeven of het lint een uiterlijk van Windows 7 heeft (kleine rechthoekige toepassingsknop).
`CMFCRibbonBar::LoadFromResource`	Overbelast. Hiermee laadt u een lintbalk van toepassingsbronnen.
`CMFCRibbonBar::OnClickButton`
`CMFCRibbonBar::OnEditContextMenu`
`CMFCRibbonBar::OnRTLChanged`	(Overschrijft `CPane::OnRTLChanged`.)
`CMFCRibbonBar::OnSetAccData`	(Overschrijft `CBasePane::OnSetAccData`.)
`CMFCRibbonBar::OnShowRibbonContextMenu`
`CMFCRibbonBar::OnShowRibbonQATMenu`
`CMFCRibbonBar::OnSysKeyDown`
`CMFCRibbonBar::OnSysKeyUp`
`CMFCRibbonBar::PopTooltip`
`CMFCRibbonBar::PreTranslateMessage`	(Overschrijft `CBasePane::PreTranslateMessage`.)
`CMFCRibbonBar::RecalcLayout`	(Overschrijft `CPane::RecalcLayout`.)
`CMFCRibbonBar::RemoveAllCategories`	Hiermee verwijdert u alle lintcategorieën uit de lintbalk.
`CMFCRibbonBar::RemoveAllFromTabs`	Hiermee verwijdert u alle lintelementen uit het tabbladgebied.
`CMFCRibbonBar::RemoveCategory`	Hiermee verwijdert u de lintcategorie die zich in de opgegeven index bevindt.
`CMFCRibbonBar::SaveToXMLBuffer`	Hiermee wordt de lintbalk opgeslagen in een buffer.
`CMFCRibbonBar::SaveToXMLFile`	Hiermee wordt de lintbalk opgeslagen in een XML-bestand.
`CMFCRibbonBar::SetActiveCategory`	Hiermee stelt u een opgegeven lintcategorie in op actief.
`CMFCRibbonBar::SetActiveMDIChild`
`CMFCRibbonBar::SetElementKeys`	Hiermee stelt u de opgegeven keytips in voor alle lintelementen met de opgegeven opdracht-id.
`CMFCRibbonBar::SetApplicationButton`	Hiermee wijst u een knop voor het toepassingslint toe aan de lintbalk.
`CMFCRibbonBar::SetKeyboardNavigationLevel`
`CMFCRibbonBar::SetMaximizeMode`
`CMFCRibbonBar::SetQuickAccessCommands`	Hiermee voegt u een of meer lintelementen toe aan de werkbalk Snelle toegang.
`CMFCRibbonBar::SetQuickAccessDefaultState`	Hiermee geeft u de standaardstatus voor de werkbalk Snelle toegang.
`CMFCRibbonBar::SetQuickAccessToolbarOnTop`	Hiermee plaatst u de werkbalk Snelle toegang (QAT) boven of onder de lintbalk.
`CMFCRibbonBar::SetTooltipFixedWidth`
`CMFCRibbonBar::SetWindows7Look`	Het uiterlijk van windows 7 op het lint in-/uitschakelen (kleine rechthoekige toepassingsknop)
`CMFCRibbonBar::ShowCategory`	Hiermee wordt de opgegeven lintcategorie weergegeven of verborgen.
`CMFCRibbonBar::ShowContextCategories`	Hiermee worden de contextcategorieën met de opgegeven id weergegeven of verborgen.
`CMFCRibbonBar::ShowKeyTips`
`CMFCRibbonBar::ToggleMimimizeState`	Hiermee schakelt u de lintbalk tussen de geminimaliseerde en gemaximaliseerde statussen in.
`CMFCRibbonBar::TranslateChar`

Opmerkingen

Microsoft heeft het Office Fluent-lint geïntroduceerd toen microsoft Office 2007 tegelijkertijd werd uitgebracht. Deze lintbalk is niet alleen een nieuw besturingselement. Het vertegenwoordigt een nieuw paradigma voor de gebruikersinterface. Het lint is een deelvenster met een set tabbladen die categorieën worden genoemd. Elke categorie is logisch onderverdeeld in lintpanelen en elk deelvenster kan verschillende besturingselementen en opdrachtknoppen bevatten.

De elementen die op de lintbalk worden weergegeven, worden uitgevouwen en uitgevouwen om optimaal gebruik te maken van beschikbare ruimte. Als een lintpaneel bijvoorbeeld onvoldoende ruimte heeft om de elementen weer te geven, wordt het een menuknop met subitems in een snelmenu. De lintbalk gedraagt zich als een statische (niet-zwevende) besturingsbalk en kan boven aan een frame worden gedokt.

U kunt de CMFCRibbonStatusBar-klasse gebruiken om een statusbalk te implementeren die vergelijkbaar is met die in Office 2007. Een lintcategorie bevat (en geeft) een groep lintvensters. Elk lintpaneel bevat een of meer lintelementen die zijn afgeleid van CMFCRibbonBaseElement.

Zie Walkthrough voor informatie over het toevoegen van een lintbalk aan uw bestaande MFC-toepassing: De MFC-krabbeltoepassing bijwerken.

Overnamehiërarchie

Eisen

koptekst:afxribbonbar.h

`CMFCRibbonBar::ActivateContextCategory`

Hiermee wordt een contextcategorie geactiveerd die al zichtbaar is.

BOOL ActivateContextCategory(UINT uiContextID);

Parameters

uiContextID
[in] De contextcategorie-id.

Retourwaarde

TRUE als een contextcategorie met uiContextID wordt gevonden en geactiveerd; anders FALSE.

`CMFCRibbonBar::AddCategory`

Hiermee maakt en initialiseert u een nieuwe lintcategorie voor de lintbalk.

CMFCRibbonCategory* AddCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage= CSize(16,
    16),
    CSize sizeLargeImage= CSize(32,
    32),
    int nInsertAt = -1,
    CRuntimeClass* pRTI= NULL);

Parameters

lpszName
[in] Naam van de lintcategorie.

uiSmallImagesResID
[in] Resource-id van de lijst met kleine afbeeldingen voor de lintcategorie.

uiLargeImagesResID
[in] Resource-id van de grote lijst met afbeeldingen voor de lintcategorie.

sizeSmallImage
[in] Hiermee geeft u de grootte van kleine afbeeldingen voor de lintcategorie.

sizeLargeImage
[in] Hiermee geeft u de grootte van grote afbeeldingen voor de lintcategorie.

nInsertAt
[in] Op nul gebaseerde index van de categorielocatie.

pRTI
[in] Wijs een CMFCRibbonCategory Klasse runtimeklasse aan om dynamisch een lintcategorie te maken tijdens runtime.

Retourwaarde

Een aanwijzer naar de nieuwe lintcategorie als de methode is geslaagd; anders, NULL.

Opmerkingen

Als de parameter pRTI niet NULL, wordt de nieuwe lintcategorie dynamisch gemaakt met behulp van de runtimeklasse.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de methode AddCategory gebruikt in de klasse CMFCRibbonBar.

// Add "Home" category.
// CMFCRibbonBar m_wndRibbonBar
strTemp.LoadString(IDS_RIBBON_HOME);
CMFCRibbonCategory *pCategoryHome = m_wndRibbonBar.AddCategory(strTemp,
                                                               IDB_WRITESMALL, IDB_WRITELARGE);

`CMFCRibbonBar::AddContextCategory`

Hiermee maakt en initialiseert u een nieuwe contextcategorie voor de lintbalk.

CMFCRibbonCategory* AddContextCategory(
    LPCTSTR lpszName,
    LPCTSTR lpszContextName,
    UINT uiContextID,
    AFX_RibbonCategoryColor clrContext,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage = CSize(16,
    16),
    CSize sizeLargeImage = CSize(32,
    32),
    CRuntimeClass* pRTI = NULL);

Parameters

lpszName
[in] Naam van de categorie.

lpszContextName
[in] Naam van het bijschrift van de contextcategorie.

uiContextID
[in] Context-id.

clrContext
[in] Kleur van het bijschrift van de contextcategorie.

uiSmallImagesResID
[in] Resource-id van de kleine afbeelding van een contextcategorie.

uiLargeImagesResID
[in] Resource-id van de grote afbeelding van een contextcategorie.

sizeSmallImage
[in] Grootte van een kleine afbeelding.

sizeLargeImage
[in] Grootte van een grote afbeelding.

pRTI
[in] Aanwijzer naar een runtimeklasse.

Retourwaarde

Een aanwijzer naar de zojuist gemaakte categorie of NULL als de CreateObject methode van pRTI de opgegeven categorie niet kan maken.

Opmerkingen

Gebruik deze functie om een contextcategorie toe te voegen. Contextcategorieën zijn een speciaal type categorie dat tijdens runtime kan worden weergegeven of verborgen, afhankelijk van de huidige toepassingscontext. Wanneer de gebruiker bijvoorbeeld een object selecteert, kunt u speciale tabbladen weergeven met contextcategorieën, die u gebruikt om het specifieke geselecteerde object te wijzigen.

De kleur van een contextcategorie 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

`CMFCRibbonBar::AddMainCategory`

Hiermee maakt u een nieuwe hoofdlintcategorie voor de lintbalk.

CMFCRibbonMainPanel* AddMainCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage = CSize(16,
    16),
    CSize sizeLargeImage = CSize(32,
    32));

Parameters

lpszName
[in] Naam van de hoofdlintcategorie.

uiSmallImagesResID
[in] Resource-id van kleine afbeeldingen.

uiLargeImagesResID
[in] Resource-id van grote installatiekopieën.

sizeSmallImage
[in] De grootte van kleine afbeeldingen.

sizeLargeImage
[in] De grootte van grote afbeeldingen.

Retourwaarde

Wijs de nieuwe categorie van het hoofdlint aan als de methode is geslaagd; anders, NULL.

Opmerkingen

Als er al een hoofdlintcategorie bestaat, wordt deze verwijderd.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de methode AddMainCategory gebruikt in de klasse CMFCRibbonBar.

// m_wndRibbonBar is declared as a protected member variable
// CMFCRibbonBar m_wndRibbonBar.
// strTemp is a CString variable.
strTemp.LoadString(IDS_RIBBON_FILE);
CMFCRibbonMainPanel *pMainPanel = m_wndRibbonBar.AddMainCategory(strTemp,
                                                                 IDB_FILESMALL, IDB_FILELARGE);

`CMFCRibbonBar::AddPrintPreviewCategory`

Hiermee maakt u een afdrukvoorbeeldcategorie op de lintbalk.

CMFCRibbonCategory* AddPrintPreviewCategory();

Retourwaarde

Een aanwijzer naar de nieuwe lintcategorie als de methode is geslaagd; anders, NULL.

Opmerkingen

Met deze methode maakt u een lintcategorie en de besturingselementen die nodig zijn om een afdrukvoorbeeld te bieden.

`CMFCRibbonBar::AddQATOnlyCategory`

Hiermee maakt u een werkbalklintcategorie voor snelle toegang.

CMFCRibbonCategory* AddQATOnlyCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    CSize sizeSmallImage = CSize(16,
    16));

Parameters

lpszName
[in] Naam van de categorie.

uiSmallImagesResID
[in] Resource-id van de lijst met installatiekopieën voor de categorie.

sizeSmallImage
[in] Grootte van afbeeldingen voor lintelementen in de categorie.

Retourwaarde

Een aanwijzer naar de nieuwe categorie als de methode is geslaagd; anders, NULL.

Opmerkingen

De lintcategorie werkbalk Snelle toegang wordt alleen gebruikt in het dialoogvenster snelle toegangswerkbalk aanpassen.

`CMFCRibbonBar::AddToTabs`

Hiermee voegt u het opgegeven lintelement toe aan de rij met tabbladen van de lintbalk.

void AddToTabs(CMFCRibbonBaseElement* pElement);

Parameters

pElement
[in] Aanwijzer naar een lintelement.

Opmerkingen

Het lintelement wordt vóór systeemknoppen weergegeven.

`CMFCRibbonBar::CMFCRibbonBar`

Een CMFCRibbonBar-object samenstellen en initialiseren.

CMFCRibbonBar(BOOL bReplaceFrameCaption = TRUE);

Parameters

bReplaceFrameCaption
[in] TRUE voor de lintbalk om het bijschrift van het hoofdframevenster te vervangen; FALSE om de lintbalk onder het bijschrift van het hoofdframevenster te zoeken.

Opmerkingen

`CMFCRibbonBar::Create`

Hiermee maakt u een venster voor de lintbalk.

BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_RIBBON_BAR);

Parameters

pParentWnd
[in] Aanwijzer naar het bovenliggende venster voor de lintbalk.

dwStyle
[in] Een logische combinatie van stijlen voor het nieuwe venster.

nID
[in] Id van het nieuwe venster.

Retourwaarde

TRUE als het venster is gemaakt; anders FALSE.

Opmerkingen

Voorbeeld

In het volgende voorbeeld ziet u hoe u de Create methode van de klasse CMFCRibbonBar gebruikt.

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.Create(this, WS_CHILD | CBRS_TOP);

`CMFCRibbonBar::CreateEx`

Hiermee maakt u een venster voor de lintbalk.

BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle = 0,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_RIBBON_BAR);

Parameters

pParentWnd
[in] Aanwijzer naar het bovenliggende venster voor de lintbalk.

dwCtrlStyle
[in] Deze parameter wordt niet gebruikt.

dwStyle
[in] Een logische combinatie van stijlen voor het nieuwe venster.

nID
[in] Id van het nieuwe venster.

Retourwaarde

TRUE als het venster is gemaakt; anders FALSE.

Opmerkingen

`CMFCRibbonBar::DeactivateKeyboardFocus`

Hiermee sluit u alle besturingselementen voor toetsinfo op de lintbalk.

void DeactivateKeyboardFocus(BOOL bSetFocus = TRUE);

Parameters

bSetFocus
[in] TRUE om de focus in te stellen op het bovenliggende venster van de lintbalk.

Opmerkingen

`CMFCRibbonBar::DrawMenuImage`

Hiermee tekent u de afbeelding voor een menuknop.

BOOL DrawMenuImage(
    CDC* pDC,
    const CMFCToolBarMenuButton* pMenuItem,
    const CRect& rectImage);

Parameters

pDC
[in] Aanwijzer naar een apparaatcontext voor de menuknop.

pMenuItem
[in] Aanwijzer naar een werkbalkmenuknop.

rectImage
[in] De weergaverechthoek voor een menuknop.

Retourwaarde

TRUE als de afbeelding is getekend; anders FALSE.

Opmerkingen

`CMFCRibbonBar::DWMCompositionChanged`

Hiermee past u de weergave van de lintbalk aan wanneer de samenstelling van Desktop Window Manager (DWM) is ingeschakeld of uitgeschakeld.

virtual void DWMCompositionChanged();

Opmerkingen

`CMFCRibbonBar::EnableKeyTips`

Hiermee schakelt u de toetsinfofunctie voor de lintbalk in of uit.

void EnableKeyTips(BOOL bEnable = TRUE);

Parameters

bEnable
[in] TRUE om de keytips-functie in te schakelen; FALSE om de functie keytips uit te schakelen.

Opmerkingen

Wanneer u deze functie inschakelt, worden toetstips weergegeven wanneer de gebruiker op de toetsen Alt- of F10 drukt. Wanneer de gebruiker op Alt--toets drukt, worden toetstips weergegeven met een vertraging van 200 milliseconden. Met deze vertraging kunnen sneltoetsen worden uitgevoerd, zodat de ingedrukte Alt--toets geen invloed heeft op andere combinaties die de toets Alt- bevatten.

`CMFCRibbonBar::EnablePrintPreview`

Hiermee schakelt u de functie Afdrukvoorbeeld in of uit.

void EnablePrintPreview(BOOL bEnable = TRUE);

Parameters

bEnable
[in] TRUE de functie Afdrukvoorbeeld inschakelen; FALSE om de functie afdrukvoorbeeld uit te schakelen.

Opmerkingen

Als bEnable is FALSE en er een afdrukvoorbeeldcategorie bestaat, wordt deze verwijderd.

De functie Afdrukvoorbeeld is standaard ingeschakeld.

`CMFCRibbonBar::EnableToolTips`

Hiermee kunt u knopinfo en optionele beschrijvingen van knopinfo op de lintbalk in- of uitschakelen.

void EnableToolTips(
    BOOL bEnable = TRUE,
    BOOL bEnableDescr = TRUE);

Parameters

bEnable
[in] TRUE knopinfo inschakelen op de lintbalk; FALSE knopinfo uitschakelen op de lintbalk.

bEnableDescr-
[in] TRUE om beschrijvingen van knopinfo in te schakelen op de knopinfo; FALSE om beschrijvingen van knopinfo op de knopinfo uit te schakelen.

Opmerkingen

De parameter bEnable bepaalt of knopinfo wordt weergegeven wanneer de muisaanwijzer boven een lintelement beweegt. De parameter bEnableDescr bepaalt of er aanvullende beschrijvende tekst wordt weergegeven met de knopinfotekst.

`CMFCRibbonBar::FindByData`

Hiermee wordt een aanwijzer naar een lintelement opgehaald als deze de opgegeven gegevens en zichtbaarheid heeft.

CMFCRibbonBaseElement* FindByData(
    DWORD_PTR dwData,
    BOOL bVisibleOnly = TRUE) const;

Parameters

dwData
[in] De gegevens die zijn gekoppeld aan een lintelement.

bVisibleOnly
[in] TRUE om alleen zichtbare lintelementen te doorzoeken; FALSE om alle lintelementen te doorzoeken.

Retourwaarde

Een aanwijzer naar een lintelement als het de opgegeven gegevens en zichtbaarheid heeft; anders NULL.

Opmerkingen

Een lintelement is een besturingselement dat u kunt toevoegen aan het lint, zoals een lintknop, een lintcategorie of een lintschuifregelaar.

`CMFCRibbonBar::FindByID`

Hiermee wordt een aanwijzer opgehaald naar het lintelement met de opgegeven opdracht-id en zoekwaarden.

CMFCRibbonBaseElement* FindByID(
    UINT uiCmdID,
    BOOL bVisibleOnly = TRUE,
    BOOL bExcludeQAT = FALSE) const;

Parameters

uiCmdID
[in] Opdracht-id voor een lintelement.

bVisibleOnly
[in] TRUE om alleen zichtbare lintelementen te doorzoeken; FALSE om alle lintelementen te doorzoeken.

bExcludeQAT
[in] TRUE om werkbalkelementen voor snelle toegang uit te sluiten van de zoekopdracht; anders, FALSE.

Retourwaarde

Een aanwijzer naar een lintelement als het de opgegeven opdracht-id en zoekwaarden heeft; anders, NULL.

Opmerkingen

Een lintelement is een lintbesturingselement dat kan worden toegevoegd aan het lint, zoals een lintknop, een lintcategorie of een lintschuifregelaar.

Over het algemeen kan er meer dan één lintelement zijn met dezelfde opdracht-id. Als u aanwijzers wilt ophalen voor alle lintelementen die een opgegeven opdracht-id gebruiken, gebruikt u de methode CMFCRibbonBar::GetElementsByID.

`CMFCRibbonBar::FindCategoryIndexByData`

Hiermee wordt de index opgehaald van de lintcategorie die de opgegeven gegevens bevat.

int FindCategoryIndexByData(DWORD dwData) const;

Parameters

dwData
[in] De gegevens die zijn gekoppeld aan een lintcategorie.

Retourwaarde

De op nul gebaseerde index van een lintcategorie als de methode is geslaagd; anders -1.

`CMFCRibbonBar::ForceRecalcLayout`

Hiermee past u de indeling van alle items op de lintbalk en het bovenliggende venster aan en tekent u het hele venster opnieuw.

void ForceRecalcLayout();

Opmerkingen

`CMFCRibbonBar::GetActiveCategory`

Hiermee wordt een aanwijzer naar de actieve lintcategorie opgehaald.

CMFCRibbonCategory* GetActiveCategory() const;

Retourwaarde

Een aanwijzer naar de actieve lintcategorie; of NULL als er geen categorie actief is.

Opmerkingen

Een categorie is actief als deze de focus heeft. De actieve categorie is standaard de eerste categorie aan de linkerkant van de lintbalk.

De hoofdcategorie wordt weergegeven wanneer de gebruiker op de toepassingsknop drukt en deze niet de actieve categorie kan zijn.

`CMFCRibbonBar::GetApplicationButton`

Hiermee wordt een aanwijzer naar de toepassingsknop opgehaald.

CMFCRibbonApplicationButton* GetApplicationButton() const;

Retourwaarde

Een aanwijzer naar de toepassingsknop; of NULL als de knop niet is ingesteld.

`CMFCRibbonBar::GetCaptionHeight`

Hiermee wordt de hoogte van het bijschriftgebied voor de lintbalk opgehaald.

int GetCaptionHeight() const;

Retourwaarde

De hoogte, in pixels, van het bijschriftgebied voor de lintbalk.

Opmerkingen

`CMFCRibbonBar::GetCategory`

Hiermee wordt een aanwijzer opgehaald naar de lintcategorie op de opgegeven index.

CMFCRibbonCategory* GetCategory(int nIndex) const;

Parameters

nIndex
[in] De op nul gebaseerde index van een lintcategorie in de lijst met lintcategorieën die zich in de lintbalk bevinden.

Retourwaarde

Een aanwijzer naar de lintcategorie op de opgegeven index; anders NULL als nIndex buiten het bereik was.

`CMFCRibbonBar::GetCategoryCount`

Hiermee haalt u het aantal lintcategorieën op de lintbalk op.

int GetCategoryCount() const;

Retourwaarde

Het aantal lintcategorieën op de lintbalk.

`CMFCRibbonBar::GetCategoryHeight`

Haalt de hoogte van de categorie op.

int GetCategoryHeight() const;

Retourwaarde

De hoogte van de categorie.

Opmerkingen

De categoriehoogte bevat de hoogte van het tabblad Categorie.

`CMFCRibbonBar::GetCategoryIndex`

Haalt de index van de opgegeven lintcategorie op.

int GetCategoryIndex(CMFCRibbonCategory* pCategory) const;

Parameters

pCategory
[in] Aanwijzer naar een lintcategorie.

Retourwaarde

De op nul gebaseerde index van een lintcategorie die is opgegeven door pCategory; of -1 als de lintcategorie niet is gevonden.

`CMFCRibbonBar::GetContextName`

Haalt de naam van het bijschrift van de contextcategorie op dat is opgegeven door een context-id.

BOOL GetContextName(
    UINT uiContextID,
    CString& strName) const;

Parameters

uiContextID
[in] Een context-id voor lintcategorie.

strName
[uit] De naam van een contextcategoriebijschrift.

Retourwaarde

TRUE als de methode is geslaagd; anders FALSE als uiContextID nul was of als het bijschrift van de contextcategorie niet is gevonden.

`CMFCRibbonBar::GetDroppedDown`

Hiermee wordt het lintelement opgehaald dat momenteel is neergezet.

virtual CMFCRibbonBaseElement* GetDroppedDown();

Retourwaarde

Het lintelement dat momenteel wordt neergezet; of NULL als er momenteel geen lintelement is neergezet.

Opmerkingen

`CMFCRibbonBar::GetElementsByID`

Hiermee haalt u een matrix met aanwijzers op voor alle lintelementen met een specifieke opdracht-id.

void GetElementsByID(
    UINT uiCmdID,
    CArray<CMFCRibbonBaseElement*,CMFCRibbonBaseElement*>& arButtons);

Parameters

uiCmdID
[in] Opdracht-id van een lintelement.

arButtons
[uit] Een matrix met aanwijzers naar lintelementen.

Opmerkingen

Meerdere lintelementen kunnen dezelfde opdracht-id hebben omdat sommige lintelementen kunnen worden gekopieerd naar de werkbalk Snelle toegang.

`CMFCRibbonBar::GetHideFlags`

Hiermee worden de vlaggen opgehaald die aangeven hoeveel van de lintbalk zichtbaar is.

DWORD GetHideFlags() const;

Retourwaarde

De vlaggen die aangeven hoeveel van de lintbalk zichtbaar is.

Opmerkingen

De volgende tabel bevat de mogelijke combinatie van vlaggen voor de retourwaarde:

Vlag	Beschrijving
`AFX_RIBBONBAR_HIDE_ELEMENTS`	De lintbalk wordt verticaal geminimaliseerd en alleen de categorietabbladen, de hoofdknop en de werkbalk Snelle toegang zijn zichtbaar.
`AFX_RIBBONBAR_HIDE_ALL`	De breedte van de lintbalk is kleiner dan de minimale breedte en is volledig verborgen.

`CMFCRibbonBar::GetItemIDsList`

Hiermee worden de opdracht-id's opgehaald voor de opgegeven verzameling lintelementen op de lintbalk.

void GetItemIDsList(CList<UINT, UINT>& lstItems,
    BOOL bHiddenOnly = FALSE) const;

Parameters

lstItems
[uit] De lijst met opdracht-id's voor lintelementen die zich in de lintbalk bevinden.

bHiddenOnly
[in] TRUE om lintelementen uit te sluiten die worden weergegeven; FALSE alle lintelementen op de lintbalk opnemen.

Opmerkingen

`CMFCRibbonBar::GetKeyboardNavigationLevel`

Hiermee haalt u het huidige navigatieniveau op terwijl de gebruiker op de toetstips drukt die zich op de lintbalk bevinden.

int GetKeyboardNavigationLevel() const;

Retourwaarde

Het huidige navigatieniveau terwijl de gebruiker op de toetstips drukt die zich op de lintbalk bevinden. De volgende tabel bevat mogelijke retourwaarden:

Waarde	Beschrijving
-1	Keytips worden niet weergegeven.
0	Keytips worden weergegeven.
1	Gebruiker heeft op een weergegeven toetsinfo gedrukt.

Opmerkingen

`CMFCRibbonBar::GetKeyboardNavLevelCurrent`

Hiermee haalt u het huidige toetsenbordnavigatieobject op de lintbalk op.

CObject* GetKeyboardNavLevelCurrent() const;

Retourwaarde

Het huidige toetsenbordnavigatieobject op de lintbalk; anders NULL als er momenteel geen object keytips weergeeft.

Opmerkingen

Het object dat momenteel toetsinfo weergeeft, is het huidige toetsenbordnavigatieobject.

`CMFCRibbonBar::GetKeyboardNavLevelParent`

Hiermee haalt u het bovenliggende toetsenbordnavigatieobject op de lintbalk op.

CObject* GetKeyboardNavLevelParent() const;

Retourwaarde

Het bovenliggende toetsenbordnavigatieobject op de lintbalk; anders NULL.

Opmerkingen

Wanneer de gebruiker op een toetstip op de lintbalk drukt, wordt het huidige toetsenbordnavigatieobject het bovenliggende toetsenbordnavigatieobject.

`CMFCRibbonBar::GetMainCategory`

Hiermee wordt een aanwijzer opgehaald naar de hoofdlintcategorie.

CMFCRibbonCategory* GetMainCategory() const;

Retourwaarde

Een aanwijzer naar de hoofdlintcategorie.

Opmerkingen

De categorie hoofdlint bevat het hoofdlintpaneel.

`CMFCRibbonBar::GetQATCommandsLocation`

Hiermee haalt u de weergaverechthoek op voor de opdrachtensectie van de werkbalk Snelle toegang.

CRect GetQATCommandsLocation() const;

Retourwaarde

De weergaverechthoek voor de opdrachtensectie van de werkbalk Snelle toegang.

Opmerkingen

De opdrachtsectie van de weergaverechthoek bevat niet de aanpassingsknop.

`CMFCRibbonBar::GetQATDroppedDown`

Hiermee wordt een aanwijzer opgehaald naar het lintelement op de werkbalk Snelle toegang met het pop-upmenu dat is neergezet.

CMFCRibbonBaseElement* GetQATDroppedDown();

Retourwaarde

Een aanwijzer naar het lintelement op de werkbalk Snelle toegang waarin het snelmenu is neergezet.

Opmerkingen

`CMFCRibbonBar::GetQuickAccessCommands`

Hiermee wordt een lijst met opdracht-id's opgehaald voor de lintelementen op de werkbalk Snelle toegang.

void GetQuickAccessCommands(CList<UINT,UINT>& lstCommands);

Parameters

lstCommands
[uit] De lijst met opdracht-id's voor de lintelementen op de werkbalk Snelle toegang.

Opmerkingen

De lijst bevat geen lintelementen die scheidingstekens voor besturingselementen zijn.

`CMFCRibbonBar::GetQuickAccessToolbarLocation`

Hiermee haalt u de weergaverechthoek voor de werkbalk Snelle toegang op.

CRect GetQuickAccessToolbarLocation() const;

Retourwaarde

De weergaverechthoek voor de werkbalk Snelle toegang.

Opmerkingen

`CMFCRibbonBar::GetTabTrancateRatio`

Hiermee haalt u de procentgroottevermindering op in de weergavebreedte van de categorietabbladen.

int GetTabTrancateRatio() const;

Retourwaarde

De procentgrootte wordt verkleind in de weergavebreedte van de categorietabbladen.

Opmerkingen

Categorietabbladen worden in breedte verkleind wanneer er niet voldoende breedte op de lintbalk is.

`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`

Hiermee wordt de grote breedte van knopinfo voor de lintbalk opgehaald.

int GetTooltipFixedWidthLargeImage() const;

Retourwaarde

De grote breedte van knopinfo in pixels.

Opmerkingen

Als de breedte van de knopinfo groter is dan 0, varieert de breedte.

`CMFCRibbonBar::GetTooltipFixedWidthRegular`

Hiermee haalt u de normale grootte van de breedte van knopinfo voor de lintbalk op.

int GetTooltipFixedWidthRegular() const;

Retourwaarde

De normale grootte van de breedte van knopinfo in pixels.

Opmerkingen

Als de normale grootte van de knopinfobreedte 0 is, varieert de breedte.

`CMFCRibbonBar::GetVisibleCategoryCount`

Hiermee wordt het aantal zichtbare categorieën op de lintbalk opgehaald.

int GetVisibleCategoryCount() const;

Retourwaarde

Het aantal zichtbare categorieën op de lintbalk.

Opmerkingen

`CMFCRibbonBar::HideAllContextCategories`

Hiermee worden alle contextcategorieën op de lintbalk verborgen.

BOOL HideAllContextCategories();

Retourwaarde

TRUE als ten minste één contextcategorie is verborgen; anders, FALSE.

Opmerkingen

Als een contextcategorie actief is, wordt de actieve categorie opnieuw ingesteld op de eerste zichtbare categorie in de lijst met categorieën.

`CMFCRibbonBar::HideKeyTips`

Hiermee worden alle toetstips op de lintbalk verborgen.

void HideKeyTips();

Opmerkingen

`CMFCRibbonBar::HitTest`

Hiermee wordt een aanwijzer opgehaald naar het lintelement dat is opgegeven door de locatie van het punt.

virtual CMFCRibbonBaseElement* HitTest(
    CPoint point,
    BOOL bCheckActiveCategory= FALSE,
    BOOL bCheckPanelCaption= FALSE);

Parameters

point
[in] Locatie van het punt op de lintbalkcoördinaten.

bCheckActiveCategory
[in] TRUE om de actieve categorie te doorzoeken; FALSE de actieve categorie niet doorzoeken.

bCheckPanelCaption
[in] TRUE om het bijschrift van het lintpaneel te testen met het punt in het lint; FALSE het bijschrift van het lintvenster niet testen met het punt in het lint. Zie de sectie Opmerkingen voor meer informatie.

Retourwaarde

Een aanwijzer naar het lintelement dat zich op het opgegeven punt bevindt; anders NULL als het punt zich niet in een lintelement bevindt.

Opmerkingen

Het bijschrift van het lintpaneel met het punt in het lint wordt niet getest tenzij de parameter bCheckActiveCategory is TRUE.

`CMFCRibbonBar::IsKeyTipEnabled`

Geeft aan of de keytips-functie is ingeschakeld.

BOOL IsKeyTipEnabled() const;

Retourwaarde

TRUE als de keytips-functie is ingeschakeld; anders FALSE.

`CMFCRibbonBar::IsMainRibbonBar`

Geeft aan of de lintbalk de primaire lintbalk is.

virtual BOOL IsMainRibbonBar() const;

Retourwaarde

Retourneert altijd TRUE.

Opmerkingen

Deze methode retourneert standaard altijd TRUE. Overschrijf deze methode om aan te geven of de lintbalk de primaire lintbalk is.

`CMFCRibbonBar::IsPrintPreviewEnabled`

Hiermee wordt aangegeven of de afdrukvoorbeeldfunctie is ingeschakeld.

BOOL IsPrintPreviewEnabled() const;

Retourwaarde

TRUE als de functie afdrukvoorbeeld is ingeschakeld; anders FALSE.

`CMFCRibbonBar::IsQATEmpty`

Hiermee wordt aangegeven of de werkbalk Snelle toegang opdrachtknoppen bevat.

BOOL IsQATEmpty() const;

Retourwaarde

TRUE als de werkbalk Snelle toegang opdrachtknoppen bevat; anders FALSE.

Opmerkingen

`CMFCRibbonBar::IsQuickAccessToolbarOnTop`

Hiermee wordt aangegeven of de werkbalk Snelle toegang zich op of onder de lintbalk bevindt.

BOOL IsQuickAccessToolbarOnTop() const;

Retourwaarde

TRUE als de werkbalk Snelle toegang zich op de lintbalk bevindt; FALSE als de werkbalk Snelle toegang zich onder de lintbalk bevindt.

`CMFCRibbonBar::IsReplaceFrameCaption`

Hiermee wordt aangegeven of de lintbalk wordt vervangen of onder het bijschrift van het hoofdframevenster staat.

BOOL IsReplaceFrameCaption() const;

Retourwaarde

TRUE als de lintbalk het bijschrift van het hoofdframevenster vervangt; FALSE als de lintbalk onder het bijschrift van het hoofdframevenster staat.

`CMFCRibbonBar::IsShowGroupBorder`

Hiermee wordt aangegeven of knopgroepen op de lintbalk een groepsrand weergeven.

virtual BOOL IsShowGroupBorder(CMFCRibbonButtonsGroup* pGroup) const;

Parameters

pGroup
[in] Deze parameter wordt niet gebruikt.

Retourwaarde

Retourneert altijd FALSE.

Opmerkingen

Deze methode retourneert standaard altijd FALSE. Overschrijf deze methode om aan te geven of knopgroepen op de lintbalk een groepsrand weergeven.

`CMFCRibbonBar::IsToolTipDescrEnabled`

Geeft aan of beschrijvingen van knopinfo zijn ingeschakeld.

BOOL IsToolTipDescrEnabled() const;

Retourwaarde

TRUE als beschrijvingen van knopinfo zijn ingeschakeld; FALSE als beschrijvingen van knopinfo zijn uitgeschakeld.

Opmerkingen

Beschrijvingen van knopinfo zijn aanvullende beschrijvende tekst die wordt weergegeven met de knopinfotekst.

`CMFCRibbonBar::IsToolTipEnabled`

Geeft aan of knopinfo is ingeschakeld of uitgeschakeld voor de lintbalk.

BOOL IsToolTipEnabled() const;

Retourwaarde

TRUE als knopinfo is ingeschakeld; FALSE als knopinfo is uitgeschakeld.

`CMFCRibbonBar::IsTransparentCaption`

Hiermee wordt aangegeven of het beeldscherm is ingesteld voor het Windows Aero-kleurenschema.

BOOL IsTransparentCaption() const;

Retourwaarde

TRUE als het kleurenschema Windows Aero is; anders FALSE.

Opmerkingen

`CMFCRibbonBar::OnClickButton`

Deze methode wordt bewaard voor achterwaartse compatibiliteit met bestaande toepassingen en mag niet worden gebruikt voor nieuwe ontwikkeling.

virtual void OnClickButton(
    CMFCRibbonButton* pButton,
    CPoint point);

Parameters

pButton
[in] Aanwijzer naar de knop waarop is geklikt.

point
[in] Deze parameter wordt niet gebruikt.

Opmerkingen

`CMFCRibbonBar::OnEditContextMenu`

virtual void OnEditContextMenu(
    CMFCRibbonRichEditCtrl* pEdit,
    CPoint point);

Parameters

[in] pEdit
[in] point

Opmerkingen

`CMFCRibbonBar::OnRTLChanged`

Aangeroepen door het framework wanneer de indeling de richting wijzigt.

virtual void OnRTLChanged(BOOL bIsRTL);

Parameters

bIsRTL
[in] TRUE als de indeling van rechts naar links is; FALSE als de indeling van links naar rechts is.

Opmerkingen

Met deze methode wordt de indeling van alle besturingselementen op de lintbalk aangepast voor de nieuwe indelingsrichting.

`CMFCRibbonBar::OnSetAccData`

Deze methode is intern voor het framework en is niet bedoeld om te worden aangeroepen vanuit gebruikerscode.

BOOL OnSetAccData(long lVal);

Parameters

lang lVal De index van het toegankelijke object.

Retourwaarde

S_OK indien geslaagd; anders FALSE of S_FALSE.

Opmerkingen

`CMFCRibbonBar::OnShowRibbonContextMenu`

virtual BOOL OnShowRibbonContextMenu(
    CWnd* pWnd,
    int x,
    int y,
    CMFCRibbonBaseElement* pHit);

Parameters

[in] pWnd
[in] x
[in] y
[in] pHit

Retourwaarde

Opmerkingen

`CMFCRibbonBar::OnShowRibbonQATMenu`

virtual BOOL OnShowRibbonQATMenu(
    CWnd* pWnd,
    int x,
    int y,
    CMFCRibbonBaseElement* pHit);

Parameters

[in] pWnd
[in] x
[in] y
[in] pHit

Retourwaarde

Opmerkingen

`CMFCRibbonBar::OnSysKeyDown`

Aangeroepen door het framework wanneer de gebruiker op de toets F10 drukt of de toets Alt- ingedrukt houdt en vervolgens op een andere toets drukt.

BOOL OnSysKeyDown(
    CFrameWnd* pFrameWnd,
    WPARAM wParam,
    LPARAM lParam);

Parameters

pFrameWnd
[in] Aanwijzer naar het bovenliggende hoofdframevenster van de lintbalk.

wParam
[in] Code van de virtuele sleutel van de toets die wordt ingedrukt.

lParam
[in] Toetsenbordstatusvlagken wanneer de toets werd ingedrukt.

Retourwaarde

TRUE als de toetsaanslaggebeurtenis is verwerkt; anders FALSE.

Opmerkingen

`CMFCRibbonBar::OnSysKeyUp`

Aangeroepen door het framework wanneer de gebruiker de F10-toets, de Alt--toets of een toets die werd ingedrukt toen de Alt--toets werd ingedrukt.

BOOL OnSysKeyUp(
    CFrameWnd* pFrameWnd,
    WPARAM wParam,
    LPARAM lParam);

Parameters

pFrameWnd
[in] Aanwijzer naar het bovenliggende hoofdframevenster van de lintbalk.

wParam
[in] Code van de virtuele sleutel van de sleutel die wordt vrijgegeven.

lParam
[in] Deze parameter wordt niet gebruikt.

Retourwaarde

TRUE als de toetsaanslaggebeurtenis is verwerkt; anders FALSE.

Opmerkingen

`CMFCRibbonBar::PopTooltip`

Hiermee verwijdert u knopinfo uit de weergave.

void PopTooltip();

Opmerkingen

`CMFCRibbonBar::PreTranslateMessage`

Bepaalt of het opgegeven bericht wordt verwerkt door de lintbalk.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parameters

pMsg
[in] Wijs een bericht aan.

Retourwaarde

TRUE als het bericht is verwerkt door de lintbalk; anders FALSE.

Opmerkingen

`CMFCRibbonBar::RecalcLayout`

Hiermee past u de indeling van alle besturingselementen op de lintbalk aan.

virtual void RecalcLayout();

Opmerkingen

Nadat de indeling is aangepast, wordt de weergave van de lintbalk bijgewerkt.

`CMFCRibbonBar::RemoveAllCategories`

Hiermee verwijdert u alle lintcategorieën uit de lintbalk.

void RemoveAllCategories();

Opmerkingen

Met deze methode worden alle lintcategorieën uit het geheugen en uit de categorielijst verwijderd.

`CMFCRibbonBar::RemoveAllFromTabs`

Hiermee verwijdert u alle lintelementen uit het tabbladgebied.

void RemoveAllFromTabs();

Opmerkingen

Gebruik deze functie als u alle elementen die u aan het tabbladgebied hebt toegevoegd wilt verwijderen met behulp van CMFCRibbonBar::AddToTabs methode.

`CMFCRibbonBar::RemoveCategory`

Hiermee verwijdert u de opgegeven lintcategorie uit de lintbalk.

BOOL RemoveCategory(int nIndex);

Parameters

nIndex
[in] De op nul gebaseerde index van een categorie in de lijst met lintcategorieën die zich in de lintbalk bevinden.

Retourwaarde

TRUE als de opgegeven lintcategorie is verwijderd; anders FALSE.

Opmerkingen

De opgegeven lintcategorie wordt verwijderd uit het geheugen en uit de categorielijst.

`CMFCRibbonBar::SetActiveCategory`

Hiermee stelt u de opgegeven lintcategorie in als de actieve categorie.

BOOL SetActiveCategory(
    CMFCRibbonCategory* pCategory,
    BOOL bForceRestore= FALSE);

Parameters

pCategory
[in] Een lintcategorie die zich in de lintbalk bevindt.

bForceRestore
[in] TRUE om de lintbalk te maximaliseren als deze is geminimaliseerd; FALSE om de actieve categorie weer te geven in een pop-upvenster als de lintbalk is geminimaliseerd.

Retourwaarde

TRUE als de opgegeven categorie is ingesteld als de actieve categorie; anders FALSE.

Opmerkingen

De hoofdlintcategorie kan niet de actieve categorie zijn.

Als de categorie die is opgegeven door pCategory niet wordt weergegeven, kan deze niet worden ingesteld als de actieve categorie.

`CMFCRibbonBar::SetActiveMDIChild`

Koppelt de systeemknoppen op de lintbalk die deel uitmaken van een onderliggend venster met meerdere documenteninterfaces (MDI) aan het opgegeven MDI-onderliggende venster.

void SetActiveMDIChild(CWnd* pWnd);

Parameters

pWnd
[in] Aanwijzer naar een onderliggend MDI-venster.

Opmerkingen

`CMFCRibbonBar::SetApplicationButton`

Hiermee wijst u een knop voor het toepassingslint toe aan de lintbalk.

void SetApplicationButton(
    CMFCRibbonApplicationButton* pButton,
    CSize sizeButton);

Parameters

pButton
[in] Een aanwijzer naar de knop toepassingslint.

sizeButton
[in] De grootte van de knop toepassingslint.

Opmerkingen

De knop Toepassingslint is een grote afgeronde knop in de linkerbovenhoek van het lintbesturingselement.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de methode SetApplicationButton gebruikt in de klasse CMFCRibbonBar.

// Init main button:
// CMFCRibbonApplicationButton m_MainButton
m_MainButton.SetImage(IDB_MAIN);
m_MainButton.SetText(_T("\nf"));
m_MainButton.SetToolTipText(strTemp);

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetApplicationButton(&m_MainButton, CSize(45, 45));

`CMFCRibbonBar::SetElementKeys`

Hiermee stelt u de keytips in voor alle lintelementen met de opgegeven opdracht-id.

BOOL SetElementKeys(
    UINT uiCmdID,
    LPCTSTR lpszKeys,
    LPCTSTR lpszMenuKeys= NULL);

Parameters

uiCmdID
[in] De opdracht-id van een lintelement.

lpszKeys
[in] De toetsinfo.

lpszMenuKeys
[in] De menutoetsinfo.

Retourwaarde

TRUE als de toetstips van ten minste één lintelement zijn ingesteld; anders FALSE.

Opmerkingen

De optionele menutoetsinfo is voor lintelementen met een splitsknop waarmee een pop-upmenu wordt geopend.

`CMFCRibbonBar::SetKeyboardNavigationLevel`

Hiermee stelt u het toetsenbordnavigatieniveau in terwijl de gebruiker op de toetstips drukt die zich op de lintbalk bevinden.

void SetKeyboardNavigationLevel(
    CObject* pLevel,
    BOOL bSetFocus = TRUE);

Parameters

pLevel
[in] Aanwijzer naar het huidige toetsenbordnavigatieobject.

bSetFocus
[in] TRUE om de toetsenbordfocus in te stellen op de lintbalk.

Opmerkingen

Toetsenbordnavigatie van de lintbalk wordt gestart wanneer de gebruiker op de toets Alt- of F10 drukt. De gebruiker selecteert het volgende navigatieniveau door op een toetsinfo op de lintbalk te drukken. De gebruiker kan terugkeren naar het vorige navigatieniveau door op de escape-toets te drukken.

`CMFCRibbonBar::SetMaximizeMode`

Hiermee past u de lintbalk aan wanneer het venstergrootte van een MDI-onderliggend venster (multiple-document interface) inkomt of de gemaximaliseerde status verlaat.

void SetMaximizeMode(
    BOOL bMax,
    CWnd* pWnd = NULL);

Parameters

bMax
[in] TRUE om de systeemknoppen voor een MDI-onderliggend venster op de lintbalk weer te geven; FALSE de systeemknoppen voor een MDI-onderliggend venster verwijderen uit de lintbalk.

pWnd
[in] Aanwijzer naar het hoofdframevenster voor de lintbalk.

Opmerkingen

Op de lintbalk worden systeemknoppen weergegeven voor een onderliggend MDI-venster in de tabrij wanneer een MDI-onderliggend venster is gemaximaliseerd.

`CMFCRibbonBar::SetQuickAccessCommands`

Hiermee voegt u een of meer lintelementen toe aan de werkbalk Snelle toegang.

void SetQuickAccessCommands(
    const CList<UINT,UINT>& lstCommands,
    BOOL bRecalcLayout=TRUE);

Parameters

lstCommands
[in] De lijst met opdrachten die moeten worden geplaatst op de werkbalk Snelle toegang.

bRecalcLayout
[in] TRUE als u het lint opnieuw wilt tekenen nadat u de lintelementen hebt toegevoegd; FALSE anders.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de methode SetQuickAccessCommands gebruikt in de klasse CMFCRibbonBar.

// Add quick access commands to the toolbar
CList<UINT, UINT> lstQATCmds;

lstQATCmds.AddTail(ID_FILE_NEW);
lstQATCmds.AddTail(ID_FILE_OPEN);
lstQATCmds.AddTail(ID_FILE_SAVE);
lstQATCmds.AddTail(ID_FILE_PRINT_DIRECT);

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetQuickAccessCommands(lstQATCmds);

`CMFCRibbonBar::SetQuickAccessDefaultState`

Hiermee stelt u de werkbalk Snelle toegang in op de standaardstatus.

void SetQuickAccessDefaultState(const CMFCRibbonQuickAccessToolBarDefaultState& state);

Parameters

state
[in] De standaardstatus van de werkbalk Snelle toegang.

Opmerkingen

De werkbalkstatus Snelle toegang bevat een lijst met opdrachten en hun zichtbaarheid.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de methode SetQuickAccessDefaultState gebruikt in de klasse CMFCRibbonBar.

CMFCRibbonQuickAccessToolBarDefaultState *qaToolBarState =
    new CMFCRibbonQuickAccessToolBarDefaultState();
qaToolBarState->AddCommand(ID_FILE_NEW, true);
qaToolBarState->AddCommand(ID_FILE_OPEN, true);
// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetQuickAccessDefaultState(*qaToolBarState);

`CMFCRibbonBar::SetQuickAccessToolbarOnTop`

Hiermee plaatst u de werkbalk Snelle toegang boven of onder de lintbalk.

void SetQuickAccessToolbarOnTop(BOOL bOnTop);

Parameters

bOnTop
[in] TRUE om de werkbalk snelle toegang boven de lintbalk te plaatsen; FALSE om de werkbalk Snelle toegang onder de lintbalk te plaatsen.

`CMFCRibbonBar::SetTooltipFixedWidth`

Hiermee stelt u de normale en grote grootte van knopinfo vaste breedten voor de lintbalk in.

void SetTooltipFixedWidth(
    int nWidthRegular,
    int nWidthLargeImage);

Parameters

nWidthRegular
[in] De breedte, in pixels, van een normale knopinfo met vaste grootte.

nWidthLargeImage
[in] De breedte, in pixels, van een grote knopinfo met vaste grootte.

Opmerkingen

Als u een parameter instelt op 0, kan de bijbehorende breedte variëren.

`CMFCRibbonBar::ShowCategory`

Hiermee wordt de opgegeven lintcategorie weergegeven of verborgen.

void ShowCategory(
    int nIndex,
    BOOL bShow=TRUE);

Parameters

nIndex
[in] De index van de lintcategorie.

bShow
[in] Als TRUE, toont u de lintcategorie; verberg anders de lintcategorie.

`CMFCRibbonBar::ShowContextCategories`

Hiermee worden de contextcategorieën met de opgegeven id weergegeven of verborgen.

void ShowContextCategories(
    UINT uiContextID,
    BOOL bShow=TRUE);

Parameters

uiContextID
[in] De contextcategorie-id.

bShow
[in] Als TRUE, toont u de categorieën met de opgegeven id; verberg anders de categorieën met de opgegeven id.

`CMFCRibbonBar::ShowKeyTips`

Toont de toetstips voor elk lintelement op de lintbalk.

void ShowKeyTips();

Opmerkingen

`CMFCRibbonBar::ToggleMimimizeState`

Hiermee schakelt u de lintbalk tussen de geminimaliseerde en gemaximaliseerde statussen in.

void ToggleMimimizeState();

Opmerkingen

De spelfout in de methodenaam is een bekend probleem.

In de geminimaliseerde status is het lintbesturingselement verborgen en worden alleen de tabbladen weergegeven. Wanneer de gebruiker op een tabblad klikt, wordt het lintbesturingselement weergegeven als pop-upvenster. Het venster wordt gesloten wanneer de gebruiker erop klikt of een opdracht uitvoert.

`CMFCRibbonBar::TranslateChar`

Bepaalt of de opgegeven toetsaanslagtekencode wordt verwerkt door de lintbalk.

virtual BOOL TranslateChar(UINT nChar);

Parameters

nChar
[in] Een toetsaanslagtekencode van een gebruiker.

Retourwaarde

TRUE als de tekencode is verwerkt door de lintbalk; anders FALSE.

Opmerkingen

Met de functie keytips kunnen gebruikers door de lintbalk navigeren met behulp van het toetsenbord.

`CMFCRibbonBar::GetFocused`

Retourneert een gericht element.

virtual CMFCRibbonBaseElement* GetFocused();

Retourwaarde

Een aanwijzer naar een gericht element of NULL.

Opmerkingen

`CMFCRibbonBar::IsWindows7Look`

Hiermee wordt aangegeven of het lint een Windows 7-uiterlijk heeft (kleine rechthoekige toepassingsknop).

BOOL IsWindows7Look() const;

Retourwaarde

TRUE als het lint een Windows 7-uiterlijk heeft; anders FALSE.

Opmerkingen

`CMFCRibbonBar::LoadFromResource`

Overbelast. Hiermee laadt u een lintbalk van toepassingsbronnen.

virtual BOOL LoadFromResource(
    UINT uiXMLResID,
    LPCTSTR lpszResType = RT_RIBBON,
    HINSTANCE hInstance = NULL);

virtual BOOL LoadFromResource(
    LPCTSTR lpszXMLResID,
    LPCTSTR lpszResType = RT_RIBBON,
    HINSTANCE hInstance = NULL);

Parameters

uiXMLResID
Hiermee geeft u de resource-id van de XML-tekenreeks met informatie op de lintbalk op.

lpszResType
Hiermee geeft u het type resource op dat zich in uiXMLResIDbevindt.

hInstance
Ga naar de module waarvan het uitvoerbare bestand de resource bevat. Als hInstance is NULL, laadt het systeem de resource uit de module die is gebruikt om het huidige proces te maken.

lpszXMLResID
Hiermee geeft u de resource-id (in tekenreeksformulier) op met informatie op de lintbalk.

Retourwaarde

TRUE als de belasting slaagt; anders FALSE.

Opmerkingen

`CMFCRibbonBar::SaveToXMLBuffer`

Hiermee wordt de lintbalk opgeslagen in een buffer.

UINT SaveToXMLBuffer(LPBYTE* ppBuffer) const;

Parameters

ppBuffer
Wanneer deze functie wordt geretourneerd, verwijst ppBuffer naar een buffer die door deze methode is toegewezen en bevat informatie over de lintbalk in XML-indeling.

Retourwaarde

TRUE indien geslaagd; anders FALSE.

Opmerkingen

`CMFCRibbonBar::SaveToXMLFile`

Hiermee wordt de lintbalk opgeslagen in een XML-bestand.

BOOL SaveToXMLFile(LPCTSTR lpszFilePath) const;

Parameters

lpszFilePath
Hiermee geeft u het uitvoerbestand.

Retourwaarde

TRUE indien geslaagd; anders FALSE.

Opmerkingen

`CMFCRibbonBar::SetWindows7Look`

Hiermee schakelt u een Windows 7-uiterlijk (kleine rechthoekige toepassingsknop) voor het lint in of uit.

void SetWindows7Look(
    BOOL bWindows7Look,
    BOOL bRecalc = TRUE);

Parameters

bWindows7Look
TRUE stelt een Windows 7-uiterlijk in; FALSE anders.

bRecalc
TRUE de lintindeling opnieuw berekent; FALSE anders.

Opmerkingen

Zie ook

Hiërarchiegrafiek
klassen
CPane klasse
CMFCRibbonCategory klasse
CMFCRibbonPanel klasse
CMFCRibbonBaseElement klasse
walkthrough: de MFC-krabbeltoepassing bijwerken

Share via

CMFCRibbonBar-klasse

Syntaxis

Leden

Openbare constructors

Openbare methoden

Opmerkingen

Overnamehiërarchie

Eisen

CMFCRibbonBar::ActivateContextCategory

Parameters

Retourwaarde

CMFCRibbonBar::AddCategory

Parameters

Retourwaarde

Opmerkingen

Voorbeeld

CMFCRibbonBar::AddContextCategory

Parameters

Retourwaarde

Opmerkingen

CMFCRibbonBar::AddMainCategory

Parameters

Retourwaarde

Opmerkingen

Voorbeeld

CMFCRibbonBar::AddPrintPreviewCategory

Retourwaarde

Opmerkingen

CMFCRibbonBar::AddQATOnlyCategory

Parameters

Retourwaarde

Opmerkingen

CMFCRibbonBar::AddToTabs

Parameters

Opmerkingen

CMFCRibbonBar::CMFCRibbonBar

Parameters

Opmerkingen

CMFCRibbonBar::Create

Parameters

Retourwaarde

Opmerkingen

Voorbeeld

CMFCRibbonBar::CreateEx

Parameters

Retourwaarde

Opmerkingen

CMFCRibbonBar::DeactivateKeyboardFocus

Parameters

Opmerkingen

CMFCRibbonBar::DrawMenuImage

Parameters

Retourwaarde

Opmerkingen

CMFCRibbonBar::DWMCompositionChanged

Opmerkingen

CMFCRibbonBar::EnableKeyTips

Parameters

Opmerkingen

CMFCRibbonBar::EnablePrintPreview

Parameters

Opmerkingen

CMFCRibbonBar::EnableToolTips

Parameters

Opmerkingen

CMFCRibbonBar::FindByData

Parameters

Retourwaarde

Opmerkingen

CMFCRibbonBar::FindByID

Parameters

Retourwaarde

Opmerkingen

CMFCRibbonBar::FindCategoryIndexByData

Parameters

Retourwaarde

CMFCRibbonBar::ForceRecalcLayout

Opmerkingen

CMFCRibbonBar::GetActiveCategory

`CMFCRibbonBar`-klasse

`CMFCRibbonBar::ActivateContextCategory`

`CMFCRibbonBar::AddCategory`

`CMFCRibbonBar::AddContextCategory`

`CMFCRibbonBar::AddMainCategory`

`CMFCRibbonBar::AddPrintPreviewCategory`

`CMFCRibbonBar::AddQATOnlyCategory`

`CMFCRibbonBar::AddToTabs`

`CMFCRibbonBar::CMFCRibbonBar`

`CMFCRibbonBar::Create`

`CMFCRibbonBar::CreateEx`

`CMFCRibbonBar::DeactivateKeyboardFocus`

`CMFCRibbonBar::DrawMenuImage`

`CMFCRibbonBar::DWMCompositionChanged`

`CMFCRibbonBar::EnableKeyTips`

`CMFCRibbonBar::EnablePrintPreview`

`CMFCRibbonBar::EnableToolTips`

`CMFCRibbonBar::FindByData`

`CMFCRibbonBar::FindByID`

`CMFCRibbonBar::FindCategoryIndexByData`

`CMFCRibbonBar::ForceRecalcLayout`

`CMFCRibbonBar::GetActiveCategory`

`CMFCRibbonBar::GetApplicationButton`

`CMFCRibbonBar::GetCaptionHeight`

`CMFCRibbonBar::GetCategory`

`CMFCRibbonBar::GetCategoryCount`

`CMFCRibbonBar::GetCategoryHeight`

`CMFCRibbonBar::GetCategoryIndex`

`CMFCRibbonBar::GetContextName`

`CMFCRibbonBar::GetDroppedDown`

`CMFCRibbonBar::GetElementsByID`

`CMFCRibbonBar::GetHideFlags`

`CMFCRibbonBar::GetItemIDsList`

`CMFCRibbonBar::GetKeyboardNavigationLevel`

`CMFCRibbonBar::GetKeyboardNavLevelCurrent`

`CMFCRibbonBar::GetKeyboardNavLevelParent`

`CMFCRibbonBar::GetMainCategory`

`CMFCRibbonBar::GetQATCommandsLocation`

`CMFCRibbonBar::GetQATDroppedDown`

`CMFCRibbonBar::GetQuickAccessCommands`

`CMFCRibbonBar::GetQuickAccessToolbarLocation`

`CMFCRibbonBar::GetTabTrancateRatio`

`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`

`CMFCRibbonBar::GetTooltipFixedWidthRegular`

`CMFCRibbonBar::GetVisibleCategoryCount`