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 CMFCRibbonBaseElement klasse is de basisklasse voor alle elementen die u aan een lintbalk kunt toevoegen. Voorbeelden van lintelementen zijn lintknoppen, lint selectievakjes en keuzelijsten met invoervak op het lint.
Syntaxis
class CMFCRibbonBaseElement : public CObject
Leden
Openbare constructors
| Naam | Description |
|---|---|
CMFCRibbonBaseElement |
Maakt een CMFCRibbonBaseElement object. |
Openbare methoden
| Naam | Description |
|---|---|
| CMFCRibbonBaseElement::AddToKeyList | Hiermee voegt u een toetstip voor het lintelement toe aan een matrix met keytips. |
| CMFCRibbonBaseElement::AddToListBox | Hiermee voegt u een lintelement toe aan de opgegeven keuzelijst met lintopdrachten. |
| CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar | Hiermee wordt aangegeven of het lintelement kan worden toegevoegd aan de werkbalk Snelle toegang. |
| CMFCRibbonBaseElement::CanBeCompacted | Hiermee wordt aangegeven of de grootte van het lintelement compact kan zijn. |
| CMFCRibbonBaseElement::CanBeStretched | Hiermee wordt aangegeven of de hoogte van het lintelement verticaal kan toenemen tot de hoogte van een lintrij. |
| CMFCRibbonBaseElement::CanBeStretchedHorizontally | Hiermee wordt aangegeven of de breedte van het lintelement kan worden gewijzigd. |
| CMFCRibbonBaseElement::CleanUpSizes | Hiermee worden de dimensie-instellingen voor het lintelement opgeschoond. |
| CMFCRibbonBaseElement::ClosePopupMenu | Hiermee sluit u het pop-upmenu voor het lintelement. |
| CMFCRibbonBaseElement::CopyFrom | Hiermee kopieert u de status van de opgegeven CMFCRibbonBaseElement waarde naar het huidige object. |
| CMFCRibbonBaseElement::D estroyCtrl | Hiermee wordt het lintelement vernietigd. |
| CMFCRibbonBaseElement::D rawImage | Hiermee tekent u de afbeelding voor het lintelement. |
| CMFCRibbonBaseElement::Find | Retourneert de opgegeven aanwijzer naar het lintelement als deze verwijst naar het huidige object. |
| CMFCRibbonBaseElement::FindByData | Hiermee wordt een aanwijzer naar het lintelement opgehaald als het de opgegeven gegevens bevat. |
| CMFCRibbonBaseElement::FindByID | Hiermee wordt een aanwijzer naar het lintelement opgehaald als dat element wordt geïdentificeerd door de opgegeven opdracht-id. |
| CMFCRibbonBaseElement::FindByOriginal | Hiermee wordt een aanwijzer naar het lintelement opgehaald als het oorspronkelijke lintelement overeenkomt met het opgegeven lintelement. |
| CMFCRibbonBaseElement::GetCompactSize | Retourneert de compacte grootte van het lintelement. |
| CMFCRibbonBaseElement::GetData | Hiermee worden de door de gebruiker gedefinieerde gegevens opgehaald die zijn gekoppeld aan het lintelement. |
| CMFCRibbonBaseElement::GetDescription | Retourneert de beschrijving van het lintelement. |
| CMFCRibbonBaseElement::GetDroppedDown | Hiermee wordt een aanwijzer naar het lintelement opgehaald als het pop-upmenu wordt neergezet. |
| CMFCRibbonBaseElement::GetElements | Hiermee voegt u het huidige lintelement toe aan de opgegeven matrix. |
| CMFCRibbonBaseElement::GetElementsByID | Hiermee voegt u het huidige lintelement toe aan de opgegeven matrix als het huidige lintelement de opgegeven opdracht-id bevat. |
| CMFCRibbonBaseElement::GetHighlighted | Hiermee wordt een aanwijzer naar het lintelement opgehaald als dit is gemarkeerd. |
| CMFCRibbonBaseElement::GetID | Retourneert de opdracht-id van het lintelement. |
| CMFCRibbonBaseElement::GetImageSize | Retourneert de afbeeldingsgrootte van het lintelement. |
| CMFCRibbonBaseElement::GetIntermediateSize | Retourneert de grootte van het lintelement in de tussenliggende status. |
| CMFCRibbonBaseElement::GetKeys | Retourneert de toetsinfo die is gekoppeld aan het lintelement. |
| CMFCRibbonBaseElement::GetKeyTipRect | Hiermee haalt u de rechthoek voor de sleuteltipgrens voor het lintelement op. |
| CMFCRibbonBaseElement::GetKeyTipSize | Hiermee wordt de grootte van de sleutelinfotekst opgehaald. |
| CMFCRibbonBaseElement::GetLocationInGroup | Geeft de weergavelocatie van het lintelement in een lintgroep aan. |
| CMFCRibbonBaseElement::GetMenuKeys | Retourneert de toetstips die zijn gekoppeld aan een knop. |
| CMFCRibbonBaseElement::GetNotifyID | Hiermee haalt u de meldingsopdracht-id voor het lintelement op. |
| CMFCRibbonBaseElement::GetOriginal | Hiermee wordt het oorspronkelijke lintelement opgehaald. |
| CMFCRibbonBaseElement::GetParentCategory | Hiermee wordt de lintcategorie voor het lintelement opgehaald. |
| CMFCRibbonBaseElement::GetParentPanel | Hiermee wordt het lintvenster opgehaald dat het lintelement bevat. |
| CMFCRibbonBaseElement::GetParentRibbonBar | Hiermee wordt de bovenliggende lintbalk voor het lintelement opgehaald. |
| CMFCRibbonBaseElement::GetParentWnd | Hiermee wordt het bovenliggende venster voor het lintelement opgehaald. |
| CMFCRibbonBaseElement::GetPressed | Hiermee wordt een aanwijzer naar het lintelement opgehaald als de gebruiker er momenteel op drukt. |
| CMFCRibbonBaseElement::GetQuickAccessToolBarID | Hiermee wordt de opdracht-id van het lintelement opgehaald wanneer het zich op de werkbalk Snelle toegang bevindt. |
| CMFCRibbonBaseElement::GetRect | Retourneert de begrenzingsrechthoek van het lintelement. |
| CMFCRibbonBaseElement::GetRegularSize | Retourneert de normale grootte van het lintelement. |
| CMFCRibbonBaseElement::GetSize | Retourneert de huidige grootte van het lintelement. |
| CMFCRibbonBaseElement::GetText | Retourneert de tekst die is gekoppeld aan het lintelement. |
| CMFCRibbonBaseElement::GetToolTipText | Hiermee wordt knopinfotekst van het lintelement geretourneerd. |
| CMFCRibbonBaseElement::GetTopLevelRibbonBar | Hiermee haalt u de lintbalk op het hoogste niveau voor het lintelement op. |
| CMFCRibbonBaseElement::HasCompactMode | Hiermee geeft u op of het lintelement een compacte modus heeft. |
| CMFCRibbonBaseElement::HasFocus | Geeft aan of het bovenliggende element de focus op het toetsenbord heeft. |
| CMFCRibbonBaseElement::HasIntermediateMode | Hiermee geeft u op of het lintelement een tussenliggende modus heeft. |
| CMFCRibbonBaseElement::HasLargeMode | Hiermee geeft u op of het lintelement een grote modus heeft. |
| CMFCRibbonBaseElement::HasMenu | Hiermee wordt aangegeven of het lintelement een menu heeft. |
| CMFCRibbonBaseElement::HitTest | Hiermee wordt een aanwijzer naar het lintelement opgehaald als het opgegeven punt zich daarin bevindt. |
| CMFCRibbonBaseElement::IsAlignByColumn | Hiermee wordt aangegeven of het lintelement verticaal is uitgelijnd met andere lintelementen. |
| CMFCRibbonBaseElement::IsAlwaysLargeImage | Hiermee wordt aangegeven of de afbeeldingsgrootte van het lintelement altijd groot is. |
| CMFCRibbonBaseElement::IsAutoRepeatMode | Hiermee wordt aangegeven of het lintelement zich in de modus voor automatisch herhalen bevindt. |
| CMFCRibbonBaseElement::IsChecked | Hiermee geeft u op of het lintelement is ingeschakeld. |
| CMFCRibbonBaseElement::IsCompactMode | Hiermee geeft u op of het lintelement zich in een compacte modus bevindt. |
| CMFCRibbonBaseElement::IsDefaultMenuLook | |
| CMFCRibbonBaseElement::IsDisabled | Hiermee geeft u op of het lintelement is uitgeschakeld. |
| CMFCRibbonBaseElement::IsDroppedDown | Bepaalt of het lintelement een pop-upmenu weergeeft en wordt neergezet. |
| CMFCRibbonBaseElement::IsFocused | Hiermee geeft u op of het lintelement de focus heeft. |
| CMFCRibbonBaseElement::IsGalleryIcon | Hiermee wordt aangegeven of het lintelement zich in een lintgalerie bevindt. |
| CMFCRibbonBaseElement::IsHighlighted | Hiermee geeft u op of het lintelement is gemarkeerd. |
| CMFCRibbonBaseElement::IsIntermediateMode | Hiermee wordt aangegeven of de huidige afbeelding voor het lintelement tussenliggende grootte is. |
| CMFCRibbonBaseElement::IsLargeMode | Hiermee wordt aangegeven of de huidige afbeelding voor het lintelement groot is. |
| CMFCRibbonBaseElement::IsMenuMode | Hiermee wordt aangegeven of het lintelement zich in een menu bevindt. |
| CMFCRibbonBaseElement::IsPressed | Geeft aan of de gebruiker op het lintelement heeft geklikt. |
| CMFCRibbonBaseElement::IsQATMode | Hiermee wordt aangegeven of het lintelement is opgenomen in de werkbalk Snelle toegang. |
| CMFCRibbonBaseElement::IsSeparator | Hiermee wordt aangegeven of het lintelement een weergavescheidingsteken is. |
| CMFCRibbonBaseElement::IsShowGroupBorder | Hiermee wordt aangegeven of het lintelement is opgenomen in een groep die een gemeenschappelijke rand weergeeft. |
| CMFCRibbonBaseElement::IsShowTooltipOnBottom | Geeft aan of de knopinfo wordt weergegeven onder het lintelement. |
| CMFCRibbonBaseElement::IsTabStop | Hiermee wordt aangegeven of het lintelement kan worden geselecteerd met het toetsenbord. |
| CMFCRibbonBaseElement::IsTextAlwaysOnRight | Hiermee wordt aangegeven of de tekst voor het lintelement aan de rechterkant wordt weergegeven. |
| CMFCRibbonBaseElement::IsVisible | Hiermee wordt aangegeven of het lintelement momenteel wordt weergegeven. |
| CMFCRibbonBaseElement::IsWholeRowHeight | Hiermee wordt aangegeven of de weergave heigth van het lintelement hetzelfde is als de weergavehoogte van het lintpaneel dat het bevat. |
| CMFCRibbonBaseElement::NotifyCommand | Hiermee wordt een opdrachtmelding verzonden naar het bovenliggende venster van het lintelement. |
| CMFCRibbonBaseElement::NotifyHighlightListItem | Hiermee wordt het bovenliggende venster van de lintbalk weergegeven wanneer een gebruiker een lintelement markeert dat zich in een lijst bevindt. |
| CMFCRibbonBaseElement::OnAddToQAToolbar | Hiermee voegt u het lintelement toe aan de opgegeven werkbalk snelle toegang. |
| CMFCRibbonBaseElement::OnAfterChangeRect | Hiermee werkt u de knopinfo voor het lintelement bij. |
| CMFCRibbonBaseElement::OnAutoRepeat | Hiermee werkt u het lintelement bij als reactie op aanhoudende gebruikersinvoer. |
| CMFCRibbonBaseElement::OnCalcTextsize | Hiermee wordt de grootte van de tekst voor het lintelement berekend. |
| CMFCRibbonBaseElement::OnChangeMenuHighlight | Aangeroepen door het framework wanneer de markering verandert voor een lintelement dat zich in een menu bevindt. |
| CMFCRibbonBaseElement::OnDraw | Aangeroepen door het framework om het lintelement te tekenen. |
| CMFCRibbonBaseElement::OnDrawKeyTip | Aangeroepen door het framework om de toetsinfo voor het lintelement te tekenen. |
| CMFCRibbonBaseElement::OnDrawMenuImage | Aangeroepen door het framework wanneer de menuafbeelding voor het lintelement wordt getekend. |
| CMFCRibbonBaseElement::OnDrawOnList | Aangeroepen door het framework om het lintelement te tekenen in een keuzelijst met opdrachten. |
| CMFCRibbonBaseElement::OnKey | Aangeroepen door het framework wanneer de gebruiker op een toetsinfo drukt en het lintelement de focus heeft. |
| CMFCRibbonBaseElement::OnMenuKey | |
| CMFCRibbonBaseElement::OnRTLChanged | Aangeroepen door het framework wanneer de indeling de richting wijzigt. |
| CMFCRibbonBaseElement::OnShow | Aangeroepen door het framework om het lintelement weer te geven of te verbergen. |
| CMFCRibbonBaseElement::OnShowPopupMenu | Aangeroepen door het framework wanneer het lintelement een pop-upmenu weergeeft. |
| CMFCRibbonBaseElement::P ostMenuCommand | |
| CMFCRibbonBaseElement::Redraw | Hiermee wordt de weergave voor het lintelement bijgewerkt. |
| CMFCRibbonBaseElement::SetACCData | Hiermee stelt u de toegankelijkheidsgegevens voor het lintelement in. |
| CMFCRibbonBaseElement::SetCompactMode | Hiermee stelt u de weergavegrootte voor het lintelement in. |
| CMFCRibbonBaseElement::SetData | Hiermee koppelt u een gegevensitem aan het lintelement. |
| CMFCRibbonBaseElement::SetDefaultMenuLook | |
| CMFCRibbonBaseElement::SetDescription | Hiermee stelt u de beschrijving voor het lintelement in. |
| CMFCRibbonBaseElement::SetID | Hiermee stelt u de opdracht-id van het lintelement in. |
| CMFCRibbonBaseElement::SetInitialMode | Hiermee stelt u de oorspronkelijke weergavegrootte voor het lintelement in. |
| CMFCRibbonBaseElement::SetKeys | Hiermee stelt u een toetsinfo in voor het lintelement. |
| CMFCRibbonBaseElement::SetOriginal | Hiermee stelt u het oorspronkelijke lintelement voor het lintelement in. |
| CMFCRibbonBaseElement::SetParentCategory | Hiermee stelt u de bovenliggende categorie voor het lintelement in. |
| CMFCRibbonBaseElement::SetParentMenu | Hiermee stelt u de bovenliggende menucontainer voor het lintelement in. |
| CMFCRibbonBaseElement::SetParentRibbonBar | Hiermee stelt u de bovenliggende lintbalk voor het lintelement in. |
| CMFCRibbonBaseElement::SetRect | Hiermee stelt u de afmetingen van de weergaverechthoek voor het lintelement in. |
| CMFCRibbonBaseElement::SetText | Hiermee stelt u de tekst voor het lintelement in. |
| CMFCRibbonBaseElement::SetTextAlwaysOnRight | Hiermee stelt u de tekst voor het lintelement in om aan de rechterkant weer te geven. |
| CMFCRibbonBaseElement::SetToolTipText | Hiermee stelt u de knopinfotekst voor het lintelement in. |
| CMFCRibbonBaseElement::SetVisible | Hiermee stelt u de zichtbaarheidsstatus van het lintelement in. |
| CMFCRibbonBaseElement::StretchHorizontally | Hiermee wordt de breedte van het lintelement uitgerekt. |
| CMFCRibbonBaseElement::StretchToWholeRow | Hiermee wijzigt u de weergavehoogte van het lintelement in de opgegeven rijhoogte. |
| CMFCRibbonBaseElement::UpdateTooltipInfo | Hiermee werkt u de tekst van de knopinfo bij met behulp van de opdrachtresource voor het lintelement. |
Beveiligde methoden
| Naam | Description |
|---|---|
| CMFCRibbonBaseElement::OnProcessKey | Aangeroepen door het framework wanneer de gebruiker op een sneltoets drukt. |
| CMFCRibbonBaseElement::OnSetFocus | Aangeroepen door het framework wanneer een lintelement de invoerfocus ontvangt of verliest. |
Opmerkingen
De CMFCRibbonBaseElement klasse definieert de eigenschappen die gebruikelijk zijn voor alle lintelementen die opdracht-id, tekstlabel, knopinfotekst, elementbeschrijving en status bevatten (die kunnen worden gericht, gemarkeerd, ingedrukt, uitgeschakeld, ingeschakeld of verwijderd).
De afbeeldingsgrootte van een lintelement wordt gedefinieerd door het RibbonImageType lid. Dit kan een van de volgende waarden zijn:
RibbonImageLargeRibbonImageSmall
Afhankelijk van de grootte van een lintelement wordt een kleine of grote afbeelding weergegeven.
Example
In het volgende voorbeeld ziet u hoe u verschillende methoden in de CMFCRibbonBaseElement klasse gebruikt. In het voorbeeld ziet u hoe u een CMFCRibbonBaseElement object uit een CMFCRibbonStatusBar klasse haalt, de beschrijving voor het lintelement instelt, de tekst instelt, een toetsinfo instelt en de knopinfotekst voor het lintelement instelt. Dit codefragment maakt deel uit van het voorbeeld van de draw-client.
// CMFCRibbonStatusBar m_wndStatusBar
CMFCRibbonBaseElement *pPane = m_wndStatusBar.FindByID(nID);
pPane->SetDescription(_T("a pane"));
// CString strText
pPane->SetText(strText);
pPane->SetKeys(_T("p"));
pPane->SetToolTipText(_T("this is a pane"));
Overnamehiërarchie
Requirements
Koptekst: afxbaseribbonelement.h
CMFCRibbonBaseElement::AddToKeyList
Hiermee voegt u een toetstip voor het lintelement toe aan een matrix met keytips.
virtual void AddToKeyList(
CArray<CMFCRibbonKeyTip*, CMFCRibbonKeyTip*>& arElems);
Parameterwaarden
arElems
[in] Verwijzing naar een CArray van keytips.
Opmerkingen
Wanneer de functie voor knopinfo op het lint is ingeschakeld, worden in het framework linttoetstips weergegeven wanneer de gebruiker op de Alt-toets of de F10-toets drukt.
CMFCRibbonBaseElement::AddToListBox
Hiermee voegt u een lintelement toe aan de opgegeven keuzelijst met lintopdrachten.
virtual int AddToListBox(
CMFCRibbonCommandsListBox* pWndListBox,
BOOL bDeep);
Parameterwaarden
pWndListBox
[in] Aanwijzer naar een keuzelijst met opdrachten.
bDeep
[in] Deze parameter wordt niet gebruikt.
Retourwaarde
De op nul gebaseerde index van het toegevoegde lintelement.
Opmerkingen
Het framework voegt lintelementen toe aan een keuzelijst met opdrachten om de gebruiker in staat te stellen de gebruikersinterface aan te passen.
CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar
Hiermee wordt aangegeven of het lintelement kan worden toegevoegd aan de werkbalk Snelle toegang.
virtual BOOL CanBeAddedToQuickAccessToolBar() const;
Retourwaarde
WAAR als het element kan worden toegevoegd; anders, ONWAAR.
Opmerkingen
CMFCRibbonBaseElement::CanBeCompacted
Hiermee wordt aangegeven of de grootte van het lintelement compact kan zijn.
virtual BOOL CanBeCompacted() const;
Retourwaarde
WAAR als de grootte van het lintelement compact kan zijn; anders, ONWAAR.
Opmerkingen
De grootte van een lintelement kan compact, tussenliggend of groot zijn.
CMFCRibbonBaseElement::CanBeStretched
Hiermee wordt aangegeven of de hoogte van het lintelement verticaal kan toenemen tot de hoogte van een lintrij.
virtual BOOL CanBeStretched();
Retourwaarde
Retourneert altijd WAAR.
Opmerkingen
Deze methode retourneert standaard altijd TRUE. Overschrijf deze methode om aan te geven of de hoogte van het lintelement verticaal kan toenemen tot de hoogte van een lintrij.
CMFCRibbonBaseElement::CanBeStretchedHorizontally
Hiermee wordt aangegeven of de breedte van het lintelement kan worden gewijzigd.
virtual BOOL CanBeStretchedHorizontally();
Retourwaarde
Retourneert altijd ONWAAR.
Opmerkingen
Deze methode retourneert standaard altijd FALSE. Overschrijf deze methode om aan te geven of de breedte van het lintelement kan worden gewijzigd.
CMFCRibbonBaseElement::CleanUpSizes
Hiermee worden de dimensie-instellingen voor het lintelement opgeschoond.
virtual void CleanUpSizes();
Opmerkingen
Deze methode doet standaard niets. Overschrijf deze methode in een afgeleide klasse om de dimensie-instellingen voor het lintelement opnieuw in te stellen.
CMFCRibbonBaseElement::ClosePopupMenu
Hiermee sluit u het snelmenu voor het lintelement.
virtual void ClosePopupMenu();
Opmerkingen
CMFCRibbonBaseElement::CopyFrom
Kopieert de status van het opgegeven CMFCRibbonBaseElement naar het huidige object.
virtual void CopyFrom(const CMFCRibbonBaseElement& src);
Parameterwaarden
Src
[in] Het bronobject CMFCRibbonBaseElement .
Opmerkingen
CMFCRibbonBaseElement::D estroyCtrl
Hiermee wordt het lintelement vernietigd.
virtual void DestroyCtrl();
Opmerkingen
Deze methode doet standaard niets. Overschrijf deze methode in een afgeleide klasse om het lintelement te vernietigen.
CMFCRibbonBaseElement::D rawImage
Hiermee tekent u de afbeelding voor het lintelement.
virtual void DrawImage(
CDC* pDC,
RibbonImageType type,
CRect rectImage);
Parameterwaarden
Pdc
[in] Aanwijzer naar een apparaatcontext.
type
[in] Een afbeeldingstype opgesomde waarde. Zie de sectie Opmerkingen voor een lijst met mogelijke waarden.
rectImage
[in] De rechthoek van de afbeelding.
Opmerkingen
Deze methode doet standaard niets. Overschrijf deze methode in een afgeleide klasse om de afbeelding voor het lintelement te tekenen.
De volgende tabel bevat mogelijke waarden voor de typeparameter :
| Waarde | Description |
|---|---|
RibbonImageLarge |
Grote afbeeldingsgrootte van 32x32 pixels. |
RibbonImageSmall |
Kleine afbeeldingsgrootte van 16x16 pixels. |
CMFCRibbonBaseElement::Find
Retourneert de opgegeven aanwijzer als deze verwijst naar het huidige object.
virtual CMFCRibbonBaseElement* Find(const CMFCRibbonBaseElement* pElement);
Parameterwaarden
pElement
[in] Aanwijzer naar een lintelement.
Retourwaarde
Een aanwijzer naar het lintelement als pElement naar het huidige object verwijst; anders NULL.
Opmerkingen
CMFCRibbonBaseElement::FindByData
Hiermee wordt een aanwijzer naar het lintelement opgehaald als het de opgegeven gegevens bevat.
virtual CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData);
Parameterwaarden
dwData
[in] De gegevens die zijn gekoppeld aan een lintelement.
Retourwaarde
Een aanwijzer naar het lintelement als het de opgegeven gegevens bevat; anders NULL.
Opmerkingen
CMFCRibbonBaseElement::FindByID
Hiermee wordt een aanwijzer naar het lintelement opgehaald als dat element wordt geïdentificeerd door de opgegeven opdracht-id.
virtual CMFCRibbonBaseElement* FindByID(UINT uiCmdID);
Parameterwaarden
uiCmdID
[in] Opdracht-id voor een lintelement.
Retourwaarde
Een aanwijzer naar het lintelement als dat element wordt geïdentificeerd door de opgegeven opdracht-id; anders NULL.
Opmerkingen
CMFCRibbonBaseElement::FindByOriginal
Hiermee wordt een aanwijzer naar het huidige lintelement opgehaald als het oorspronkelijke lintelement overeenkomt met het opgegeven lintelement.
virtual CMFCRibbonBaseElement* FindByOriginal(CMFCRibbonBaseElement* pOriginal);
Parameterwaarden
pOriginal
[in] Aanwijzer naar een lintelement.
Retourwaarde
Een aanwijzer naar het lintelement als het oorspronkelijke lintelement overeenkomt met het opgegeven lintelement; anders NULL.
Opmerkingen
Lintelementen die naar een andere container worden gekopieerd, behouden een aanwijzer naar het oorspronkelijke lintelement.
CMFCRibbonBaseElement::GetCompactSize
Retourneert de compacte grootte van het lintelement.
virtual CSize GetCompactSize(CDC* pDC);
Parameterwaarden
Pdc
[in] Een aanwijzer naar een apparaatcontext.
Retourwaarde
De compacte grootte van een lintelement.
Opmerking
De compacte grootte betekent dat het lintelement wordt afgekapt (er wordt een kleine afbeelding of een afbeelding zonder tekst weergegeven).
CMFCRibbonBaseElement::GetData
Hiermee worden de door de gebruiker gedefinieerde gegevens opgehaald die zijn gekoppeld aan het lintelement.
DWORD_PTR GetData() const;
Retourwaarde
De door de gebruiker gedefinieerde gegevens die zijn gekoppeld aan het lintelement.
CMFCRibbonBaseElement::GetDescription
Retourneert de beschrijving van het lintelement.
virtual CString GetDescription() const;
Retourwaarde
De beschrijving van het lintelement. De beschrijving wordt weergegeven op de statusbalk of in knopinfo, of onder de menuknop als het lintelement zich in de klasse CMFCRibbonMainPanel bevindt.
CMFCRibbonBaseElement::GetDroppedDown
Hiermee wordt een aanwijzer naar het lintelement opgehaald als het pop-upmenu wordt neergezet.
virtual CMFCRibbonBaseElement* GetDroppedDown();
Retourwaarde
Een aanwijzer naar het lintelement als het pop-upmenu wordt neergezet; anders NULL.
Opmerkingen
CMFCRibbonBaseElement::GetElements
Hiermee voegt u het huidige lintelement toe aan de opgegeven matrix.
virtual void GetElements(
CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Parameterwaarden
arElements
[in, uit] Een matrix met lintelementen.
Opmerkingen
CMFCRibbonBaseElement::GetElementsByID
Hiermee voegt u het huidige lintelement toe aan de opgegeven matrix als het huidige lintelement de opgegeven opdracht-id bevat.
virtual void GetElementsByID(
UINT uiCmdID,
CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Parameterwaarden
uiCmdID
[in] Opdracht-id van een lintelement.
arElements
[in] Een matrix met lintelementen.
Opmerkingen
CMFCRibbonBaseElement::GetHighlighted
Hiermee wordt een aanwijzer naar het lintelement opgehaald als dit is gemarkeerd.
virtual CMFCRibbonBaseElement* GetHighlighted();
Retourwaarde
Een aanwijzer naar het lintelement als dit is gemarkeerd; anders NULL.
Opmerkingen
CMFCRibbonBaseElement::GetID
Retourneert de opdracht-id van het lintelement.
UINT GetID() const;
Retourwaarde
De opdracht-id van het lintelement.
CMFCRibbonBaseElement::GetImageSize
Retourneert de afbeeldingsgrootte van het lintelement.
virtual CSize GetImageSize(RibbonImageType R) const;
Retourwaarde
De grootte van de afbeelding van het lintelement.
CMFCRibbonBaseElement::GetIntermediateSize
Retourneert de grootte van het lintelement in de tussenliggende status.
virtual CSize GetIntermediateSize(CDC* pDC);
Parameterwaarden
Pdc
[in] Een aanwijzer naar een apparaatcontext.
Retourwaarde
De grootte van het lintelement in de tussenliggende status.
CMFCRibbonBaseElement::GetKeys
Retourneert de toetsinfo die is gekoppeld aan het lintelement.
LPCTSTR GetKeys() const;
Retourwaarde
Een toetsinfo die is gekoppeld aan het lintelement.
CMFCRibbonBaseElement::GetKeyTipRect
Hiermee haalt u de rechthoek voor de sleuteltipgrens voor het lintelement op.
virtual CRect GetKeyTipRect(
CDC* pDC,
BOOL bIsMenu);
Parameterwaarden
Pdc
[in] Aanwijzer naar een apparaatcontext.
bIsMenu
[in] WAAR als het lintelement een snelmenu weergeeft; anders ONWAAR.
Retourwaarde
Retourneert altijd een rechthoek met 0 waarden.
Opmerkingen
Overschrijf deze methode in een afgeleide klasse om de rechthoek voor de sleuteltipgrens te retourneren.
CMFCRibbonBaseElement::GetKeyTipSize
Hiermee wordt de grootte van de sleutelinfotekst opgehaald.
virtual CSize GetKeyTipSize(CDC* pDC);
Parameterwaarden
Pdc
[in] Aanwijzer naar een apparaatcontext.
Retourwaarde
De grootte van de toetsinfotekst.
Opmerkingen
CMFCRibbonBaseElement::GetLocationInGroup
Geeft de weergavelocatie van het lintelement in een lintgroep aan.
RibbonElementLocation GetLocationInGroup() const;
Retourwaarde
Een RibbonElementLocation opgesomde waarde. De volgende tabel bevat mogelijke waarden.
| Waarde | Description |
|---|---|
RibbonElementNotInGroup |
Het lintelement bevindt zich niet in een lintgroep. |
RibbonElementSingleInGroup |
Het lintelement wordt weergegeven als het enige item in een lintgroep. |
RibbonElementFirstInGroup |
Het lintelement wordt aan de linkerkant van een lintgroep weergegeven. |
RibbonElementLastInGroup |
Het lintelement wordt weergegeven aan de rechterkant van een lintgroep. |
RibbonElementMiddleInGroup |
Het lintelement wordt niet weergegeven aan een van beide uiteinden van een lintgroep. |
Opmerkingen
Lintelementgroepen worden alleen horizontaal uitgelijnd.
CMFCRibbonBaseElement::GetMenuKeys
Retourneert de menutoetsinfo voor het lintelement.
LPCTSTR GetMenuKeys() const;
Retourwaarde
De menutoetsinfo die is gekoppeld aan het lintelement.
Opmerkingen
Wanneer er een menutoetsinfo wordt aangeroepen, wordt een snelmenu weergegeven.
CMFCRibbonBaseElement::GetNotifyID
Hiermee haalt u de meldingsopdracht-id voor het lintelement op.
virtual UINT GetNotifyID();
Retourwaarde
De meldingsopdracht-id.
Opmerkingen
CMFCRibbonBaseElement::GetOriginal
Hiermee wordt het oorspronkelijke lintelement opgehaald.
CMFCRibbonBaseElement* GetOriginal() const;
Retourwaarde
Een aanwijzer naar het oorspronkelijke lintelement.
Opmerkingen
Lintelementen die naar een andere container worden gekopieerd, behouden een aanwijzer naar het oorspronkelijke lintelement.
CMFCRibbonBaseElement::GetParentCategory
Hiermee wordt de lintcategorie voor het lintelement opgehaald.
CMFCRibbonCategory* GetParentCategory() const;
Retourwaarde
Een aanwijzer naar de lintcategorie.
Opmerkingen
CMFCRibbonBaseElement::GetParentPanel
Hiermee wordt het lintvenster opgehaald dat het lintelement bevat.
virtual CMFCRibbonPanel* GetParentPanel() const;
Retourwaarde
Een aanwijzer naar het lintpaneel dat het lintelement bevat.
Opmerkingen
CMFCRibbonBaseElement::GetParentRibbonBar
Hiermee wordt de bovenliggende lintbalk voor het lintelement opgehaald.
CMFCRibbonBar* GetParentRibbonBar() const;
Retourwaarde
Een aanwijzer naar de bovenliggende lintbalk voor het lintelement.
Opmerkingen
CMFCRibbonBaseElement::GetParentWnd
Hiermee wordt het bovenliggende venster voor het lintelement opgehaald.
virtual CWnd* GetParentWnd() const;
Retourwaarde
Een aanwijzer naar het bovenliggende venster voor het lintelement als de methode is geslaagd; anders, NULL.
Opmerkingen
Het bovenliggende venster voor een lintelement is een CMFCRibbonBar-klasse of een CMFCRibbonPanelMenuBar.
CMFCRibbonBaseElement::GetPressed
Hiermee wordt een aanwijzer naar het lintelement opgehaald als de gebruiker er momenteel op drukt.
virtual CMFCRibbonBaseElement* GetPressed();
Retourwaarde
Een aanwijzer naar het lintelement als de gebruiker er momenteel op drukt; anders, NULL.
Opmerkingen
CMFCRibbonBaseElement::GetQuickAccessToolBarID
Hiermee wordt de opdracht-id van het lintelement opgehaald wanneer het zich op de werkbalk Snelle toegang bevindt.
virtual UINT GetQuickAccessToolBarID() const;
Retourwaarde
De opdracht-id van het lintelement wanneer het zich op de werkbalk Snelle toegang bevindt.
Opmerkingen
CMFCRibbonBaseElement::GetRect
Retourneert de begrenzingsrechthoek van het lintelement.
CRect GetRect() const;
Retourwaarde
De begrenzingsrechthoek van het lintelement. De positie van de rechthoek bevindt zich in de coördinaten van het bovenliggende lintbesturingselement.
CMFCRibbonBaseElement::GetRegularSize
Retourneert de normale grootte van het lintelement.
virtual CSize GetRegularSize(CDC* pDC) = 0;
Parameterwaarden
Pdc
[in] Een aanwijzer naar een apparaatcontext.
Retourwaarde
De normale grootte van het lintelement.
Opmerkingen
Opmerking
De normale grootte is de maximale grootte van het lintelement.
CMFCRibbonBaseElement::GetSize
Retourneert de huidige grootte van het lintelement.
virtual CSize GetSize(CDC* pDC);
Parameterwaarden
Pdc
[in] Een aanwijzer naar een apparaatcontext.
Retourwaarde
De huidige grootte van het lintelement.
CMFCRibbonBaseElement::GetText
Retourneert de tekst die is gekoppeld aan het lintelement.
LPCTSTR GetText() const;
Retourwaarde
De tekst die is gekoppeld aan het lintelement.
CMFCRibbonBaseElement::GetToolTipText
Hiermee wordt knopinfotekst van het lintelement geretourneerd.
virtual CString GetToolTipText() const;
Retourwaarde
De knopinfotekst van het lintelement.
CMFCRibbonBaseElement::GetTopLevelRibbonBar
Hiermee haalt u de lintbalk op het hoogste niveau voor het lintelement op.
CMFCRibbonBar* GetTopLevelRibbonBar() const;
Retourwaarde
Een aanwijzer naar de lintbalk op het hoogste niveau voor het lintelement als de methode is geslaagd; anders, NULL.
Opmerkingen
CMFCRibbonBaseElement::HasCompactMode
Hiermee geeft u op of het lintelement een compacte modus heeft.
virtual BOOL HasCompactMode() const;
Retourwaarde
WAAR als het lintelement een compacte modus heeft. ANDERS ONWAAR.
Opmerkingen
Opmerking
In de compacte modus geeft een element alleen een kleine afbeelding weer.
CMFCRibbonBaseElement::HasIntermediateMode
Hiermee geeft u op of het lintelement een tussenliggende modus heeft.
virtual BOOL HasIntermediateMode() const;
Retourwaarde
WAAR als het lintelement een tussenliggende modus heeft, anders ONWAAR. In de tussenliggende modus geeft een element een kleine afbeelding en tekst rechts van de afbeelding weer.
Opmerkingen
CMFCRibbonBaseElement::HasLargeMode
Bepaalt of het lintelement een grote modus heeft.
virtual BOOL HasLargeMode() const;
Retourwaarde
WAAR als het lintelement een grote modus heeft. ANDERS ONWAAR.
Opmerkingen
In de grote modus kan een element de volledige hoogte van het bovenliggende deelvenster overnemen.
CMFCRibbonBaseElement::HasMenu
Hiermee wordt aangegeven of het lintelement een menu heeft.
virtual BOOL HasMenu() const;
Retourwaarde
Retourneert altijd ONWAAR.
Opmerkingen
Deze methode retourneert standaard altijd FALSE. Overschrijf deze methode in een afgeleide klasse om aan te geven of het lintelement een menu heeft.
CMFCRibbonBaseElement::HitTest
Hiermee wordt een aanwijzer naar het lintelement opgehaald als het opgegeven punt zich daarin bevindt.
virtual CMFCRibbonBaseElement* HitTest(CPoint point);
Parameterwaarden
Punt
[in] Deze parameter wordt niet gebruikt.
Retourwaarde
Een aanwijzer naar het lintelement als dit bestaat; anders ONWAAR.
Opmerkingen
Deze methode retourneert standaard altijd een geldige aanwijzer naar het lintelement wanneer deze bestaat. Overschrijf deze methode om aan te geven of het punt zich in het lintelement bevindt.
CMFCRibbonBaseElement::IsAlignByColumn
Hiermee wordt aangegeven of het lintelement verticaal is uitgelijnd met andere lintelementen.
virtual BOOL IsAlignByColumn() const;
Retourwaarde
Retourneert altijd WAAR.
Opmerkingen
Deze methode retourneert standaard altijd TRUE. Overschrijf deze methode in een afgeleide klasse om aan te geven of het afgeleide lintelement verticaal is uitgelijnd met andere lintelementen.
CMFCRibbonBaseElement::IsAlwaysLargeImage
Hiermee wordt aangegeven of de afbeeldingsgrootte van het lintelement altijd groot is.
virtual BOOL IsAlwaysLargeImage() const;
Retourwaarde
WAAR als de afbeeldingsgrootte van het lintelement altijd groot is; anders ONWAAR.
Opmerkingen
Grote afbeelding is 32 x 32 pixels.
CMFCRibbonBaseElement::IsAutoRepeatMode
Hiermee wordt aangegeven of het lintelement zich in de modus voor automatisch herhalen bevindt.
virtual BOOL IsAutoRepeatMode(int& nDelay) const;
Parameterwaarden
nDelay
[in] Deze parameter wordt niet gebruikt.
Retourwaarde
Retourneert altijd ONWAAR.
Opmerkingen
Deze methode retourneert standaard altijd FALSE. Overschrijf deze methode om aan te geven of het lintelement zich in de modus automatisch herhalen bevindt.
In de modus voor automatisch herhalen reageert het lintelement met een bepaald interval, gemeten in milliseconden, op duurzame gebruikersinvoer.
CMFCRibbonBaseElement::IsChecked
Hiermee geeft u op of het lintelement is ingeschakeld.
virtual BOOL IsChecked() const;
Retourwaarde
WAAR als het lintelement is ingeschakeld; anders ONWAAR.
CMFCRibbonBaseElement::IsCompactMode
Hiermee geeft u op of het lintelement zich in een compacte modus bevindt.
BOOL IsCompactMode() const;
Retourwaarde
WAAR als het lintelement zich in een compacte modus bevindt; anders ONWAAR.
CMFCRibbonBaseElement::IsDefaultMenuLook
Hiermee wordt aangegeven of het lintelement is ingesteld om te worden weergegeven als een pop-upopdracht.
BOOL IsDefaultMenuLook() const;
Retourwaarde
TRUE als het lintelement is ingesteld om te worden weergegeven als een pop-upopdracht; anders ONWAAR.
Opmerkingen
CMFCRibbonBaseElement::IsDisabled
Hiermee geeft u op of het lintelement is uitgeschakeld.
virtual BOOL IsDisabled() const;
Retourwaarde
WAAR als het lintelement is uitgeschakeld; anders ONWAAR.
CMFCRibbonBaseElement::IsDroppedDown
Hiermee geeft u op of het lintelement een snelmenu weergeeft en wordt neergezet.
virtual BOOL IsDroppedDown() const;
Retourwaarde
WAAR als het lintelement wordt neergezet en een pop-upmenu wordt weergegeven; anders ONWAAR.
CMFCRibbonBaseElement::IsFocused
Hiermee geeft u op of het lintelement de focus heeft.
virtual BOOL IsFocused() const;
Retourwaarde
WAAR als het lintelement de focus heeft; anders ONWAAR.
CMFCRibbonBaseElement::IsGalleryIcon
Hiermee wordt aangegeven of het lintelement zich in een lintgalerie bevindt.
virtual BOOL IsGalleryIcon() const;
Retourwaarde
Retourneert altijd ONWAAR.
Opmerkingen
Deze methode retourneert standaard altijd FALSE. Overschrijf deze methode in een afgeleide klasse om aan te geven of het lintelement zich in een lintgalerie bevindt.
CMFCRibbonBaseElement::IsHighlighted
Hiermee geeft u op of het lintelement is gemarkeerd.
virtual BOOL IsHighlighted() const;
Retourwaarde
WAAR als het lintelement is gemarkeerd; anders ONWAAR.
Opmerkingen
CMFCRibbonBaseElement::IsIntermediateMode
Hiermee wordt aangegeven of de huidige afbeelding voor het lintelement tussenliggende grootte is.
BOOL IsIntermediateMode() const;
Retourwaarde
WAAR als de afbeelding voor het lintelement tussenliggende grootte is; anders ONWAAR.
Opmerkingen
Tussenliggende afbeeldingsgrootte is 16 x 16 pixels.
CMFCRibbonBaseElement::IsLargeMode
Hiermee wordt aangegeven of de huidige afbeelding voor het lintelement groot is.
BOOL IsLargeMode() const;
Retourwaarde
WAAR als de afbeelding voor het lintelement groot is; anders ONWAAR.
Opmerkingen
Grote afbeelding is 32 x 32 pixels.
CMFCRibbonBaseElement::IsMenuMode
Hiermee wordt aangegeven of het lintelement zich in een menu bevindt.
BOOL IsMenuMode() const;
Retourwaarde
WAAR als het lintelement zich in een menu bevindt; anders, ONWAAR.
Opmerkingen
CMFCRibbonBaseElement::IsPressed
Geeft aan of de gebruiker op het lintelement heeft geklikt.
virtual BOOL IsPressed() const;
Retourwaarde
WAAR als de gebruiker op het lintelement heeft geklikt; anders ONWAAR.
CMFCRibbonBaseElement::IsQATMode
Hiermee wordt aangegeven of het lintelement is opgenomen in de werkbalk Snelle toegang.
BOOL IsQATMode() const;
Retourwaarde
WAAR als het lintelement is opgenomen in de werkbalk Snelle toegang; anders, ONWAAR.
Opmerkingen
CMFCRibbonBaseElement::IsSeparator
Hiermee wordt aangegeven of het lintelement een weergavescheidingsteken is.
virtual BOOL IsSeparator() const;
Retourwaarde
WAAR als het lintelement een weergavescheidingsteken is; anders ONWAAR.
Opmerkingen
CMFCRibbonBaseElement::IsShowGroupBorder
Hiermee wordt aangegeven of het lintelement is opgenomen in een groep die een gemeenschappelijke rand weergeeft.
BOOL IsShowGroupBorder() const;
Retourwaarde
WAAR als het lintelement is opgenomen in een groep die een gemeenschappelijke rand weergeeft; anders, ONWAAR.
Opmerkingen
CMFCRibbonBaseElement::IsShowTooltipOnBottom
Geeft aan of de knopinfo wordt weergegeven onder het lintelement.
virtual BOOL IsShowTooltipOnBottom() const;
Retourwaarde
WAAR als de knopinfo wordt weergegeven onder het lintelement; ONWAAR als de knopinfo wordt weergegeven in de buurt van de aanwijzer.
Opmerkingen
CMFCRibbonBaseElement::IsTabStop
Hiermee wordt aangegeven of het lintelement kan worden geselecteerd met het toetsenbord.
virtual BOOL IsTabStop() const;
Retourwaarde
Retourneert altijd WAAR.
Opmerkingen
Deze methode retourneert standaard altijd TRUE. Overschrijf deze methode om aan te geven of het lintelement kan worden geselecteerd met het toetsenbord.
CMFCRibbonBaseElement::IsTextAlwaysOnRight
Hiermee wordt aangegeven of de tekst voor het lintelement aan de rechterkant wordt weergegeven.
BOOL IsTextAlwaysOnRight() const;
Retourwaarde
WAAR als de tekst voor het lintelement aan de rechterkant wordt weergegeven; anders, ONWAAR.
Opmerkingen
CMFCRibbonBaseElement::IsVisible
Hiermee wordt aangegeven of het lintelement momenteel wordt weergegeven.
BOOL IsVisible() const;
Retourwaarde
WAAR als het lintelement momenteel wordt weergegeven; anders, ONWAAR.
Opmerkingen
CMFCRibbonBaseElement::IsWholeRowHeight
Hiermee wordt aangegeven of de weergavehoogte van het lintelement gelijk is aan de weergavehoogte van het lintpaneel dat het bevat.
virtual BOOL IsWholeRowHeight() const;
Retourwaarde
Retourneert altijd ONWAAR.
Opmerkingen
Deze methode retourneert standaard altijd FALSE. Overschrijf deze methode om aan te geven of de weergavehoogte van het lintelement hetzelfde is als de weergavehoogte van het lintpaneel dat het bevat.
CMFCRibbonBaseElement::NotifyCommand
Hiermee wordt een opdrachtmelding verzonden naar het bovenliggende venster van het lintelement.
BOOL NotifyCommand(BOOL bWithDelay = FALSE);
Parameterwaarden
bWithDelay
[in] TRUE om de opdrachtmelding toe te voegen aan de berichtenwachtrij van het bovenliggende venster; FALSE om het bericht onmiddellijk naar het bovenliggende venster te verzenden.
Retourwaarde
WAAR als het bericht is verzonden; anders, ONWAAR.
Opmerkingen
CMFCRibbonBaseElement::NotifyHighlightListItem
Hiermee wordt het bovenliggende venster van de lintbalk weergegeven wanneer een gebruiker een lintelement markeert dat zich in een lijst bevindt.
virtual void NotifyHighlightListItem(int nIndex);
Parameterwaarden
nIndex
[in] De index van het lintelement in de lijst.
Opmerkingen
CMFCRibbonBaseElement::OnAddToQAToolbar
Hiermee voegt u het lintelement toe aan de opgegeven werkbalk snelle toegang.
virtual BOOL OnAddToQAToolbar(CMFCRibbonQuickAccessToolBar& qat);
Parameterwaarden
Qat
[in] De werkbalk Snelle toegang.
Retourwaarde
Retourneert altijd TRUE dat aangeeft dat het lintelement is toegevoegd aan de werkbalk Snelle toegang.
Opmerkingen
CMFCRibbonBaseElement::OnAfterChangeRect
Hiermee werkt u de knopinfo voor het lintelement bij.
virtual void OnAfterChangeRect(CDC* pDC);
Parameterwaarden
Pdc
[in] Deze parameter wordt niet gebruikt.
Opmerkingen
Deze methode werkt standaard de knopinfo voor het lintelement bij. Overschrijf deze methode om het lintelement bij te werken nadat de weergaverechthoek is gewijzigd.
CMFCRibbonBaseElement::OnAutoRepeat
Hiermee werkt u het lintelement bij als reactie op aanhoudende gebruikersinvoer.
virtual BOOL OnAutoRepeat();
Retourwaarde
Retourneert altijd ONWAAR.
Opmerkingen
Deze methode retourneert standaard altijd FALSE. Overschrijf deze methode om langdurige gebruikersinvoer te verwerken.
CMFCRibbonBaseElement::OnCalcTextsize
Hiermee wordt de grootte van de tekst voor het lintelement berekend.
virtual void OnCalcTextSize(CDC* pDC);
Parameterwaarden
Pdc
[in] Deze parameter wordt niet gebruikt.
Opmerkingen
Deze methode doet standaard niets. Overschrijf deze methode om de grootte van de tekst voor het lintelement te berekenen.
CMFCRibbonBaseElement::OnChangeMenuHighlight
Aangeroepen door het framework wanneer de markering verandert voor een lintelement dat zich in een menu bevindt.
virtual void OnChangeMenuHighlight(CMFCRibbonPanelMenuBar* pPanelMenuBar
CMFCRibbonBaseElement* pHot);
Parameterwaarden
pPanelMenuBar
[in] Deze parameter wordt niet gebruikt.
pHot
[in] Deze parameter wordt niet gebruikt.
Opmerkingen
Deze methode doet standaard niets. Overschrijf deze methode om een lintelement bij te werken dat zich in een menu bevindt wanneer de markering wordt gewijzigd.
CMFCRibbonBaseElement::OnDraw
Aangeroepen door het framework om het lintelement te tekenen.
virtual void OnDraw(CDC* pDC) = 0;
Parameterwaarden
Pdc
[in] Een aanwijzer naar een apparaatcontext.
Opmerkingen
Overschrijf deze methode in een afgeleide klasse als u de tekening van een specifiek lintelement wilt aanpassen.
CMFCRibbonBaseElement::OnDrawKeyTip
Aangeroepen door het framework om de toetsinfo voor het lintelement te tekenen.
virtual void OnDrawKeyTip(
CDC* pDC,
const CRect& rect,
BOOL bIsMenu);
Parameterwaarden
Pdc
[in] Aanwijzer naar een apparaatcontext.
Rect
[in] Rechthoek met grenzen voor de toetsinfo.
bIsMenu
[in] WAAR als de keytip voor een pop-upmenuknop is; anders, ONWAAR.
Opmerkingen
CMFCRibbonBaseElement::OnDrawMenuImage
Aangeroepen door het framework wanneer de menuafbeelding voor het lintelement wordt getekend.
virtual BOOL OnDrawMenuImage(
CDC* pDC,
CRect rect);
Parameterwaarden
Pdc
[in] Aanwijzer naar een apparaatcontext.
Rect
[in] Rechthoek met menuafbeelding.
Retourwaarde
Retourneert altijd TRUE om aan te geven dat de afbeelding is getekend.
Opmerkingen
CMFCRibbonBaseElement::OnDrawOnList
Aangeroepen door het framework om het lintelement te tekenen in een keuzelijst met opdrachten.
virtual void OnDrawOnList(
CDC* pDC,
CString strText,
int nTextOffset,
CRect rect,
BOOL bIsSelected,
BOOL bHighlighted);
Parameterwaarden
Pdc
[in] Aanwijzer naar een apparaatcontext voor het lintelement.
strText
[in] De weergavetekst.
nTextOffset
[in] Afstand, in pixels, van de linkerkant van de keuzelijst tot de weergavetekst.
Rect
[in] De weergaverechthoek voor het lintelement.
bIsSelected
[in] Deze parameter wordt niet gebruikt.
bHighlighted
[in] Deze parameter wordt niet gebruikt.
Opmerkingen
In de keuzelijst met opdrachten worden lintelementen weergegeven waarmee gebruikers de werkbalk Snelle toegang kunnen aanpassen.
CMFCRibbonBaseElement::OnKey
Aangeroepen door het framework wanneer de gebruiker op een toetsinfo drukt en het lintelement de focus heeft.
virtual BOOL OnKey(BOOL bIsMenuKey);
Parameterwaarden
bIsMenuKey
[in] WAAR als de keytip een snelmenu weergeeft; anders, ONWAAR.
Retourwaarde
WAAR als de gebeurtenis is verwerkt; anders ONWAAR.
Opmerkingen
CMFCRibbonBaseElement::OnMenuKey
Aangeroepen door het framework wanneer de gebruiker op een menutoetsinfo in het hoofdvenster drukt.
virtual BOOL OnMenuKey(UINT nUpperChar);
Parameterwaarden
nUpperChar
[in] Deze parameter wordt niet gebruikt.
Retourwaarde
Retourneert altijd ONWAAR.
Opmerkingen
Deze methode retourneert standaard altijd FALSE. Overschrijf deze methode om te reageren wanneer een gebruiker op een menutoetsinfo in het hoofdvenster drukt.
CMFCRibbonBaseElement::OnProcessKey
Aangeroepen door het framework wanneer de gebruiker op een sneltoets drukt.
virtual BOOL OnProcessKey(UINT nChar);
Parameterwaarden
Nchar
[in] Deze parameter wordt niet gebruikt.
Retourwaarde
Retourneert altijd ONWAAR.
Opmerkingen
Overschrijf deze methode als u wilt dat het lintelement een sneltoets verwerkt.
CMFCRibbonBaseElement::OnRTLChanged
Aangeroepen door het framework wanneer de indeling de richting wijzigt.
virtual void OnRTLChanged(BOOL bIsRTL);
Parameterwaarden
bIsRTL
[in] Deze parameter wordt niet gebruikt.
Opmerkingen
Deze methode doet standaard niets. Overschrijf deze methode om het lintelement aan te passen wanneer de indeling de richting wijzigt. De standaardrichting van de indeling is van links naar rechts.
CMFCRibbonBaseElement::OnSetFocus
Aangeroepen door het framework wanneer een lintelement de invoerfocus ontvangt of verliest.
virtual void OnSetFocus(BOOL B);
Opmerkingen
Overschrijf deze methode in een afgeleide klasse als u wilt dat uw toepassing een wijziging in de focus van een lintelement afhandelt.
CMFCRibbonBaseElement::OnShow
Aangeroepen door het framework om het lintelement weer te geven of te verbergen.
virtual void OnShow(BOOL bShow);
Parameterwaarden
bShow
[in] Deze parameter wordt niet gebruikt.
Opmerkingen
Deze methode doet standaard niets. Overschrijf deze methode om het lintelement weer te geven of te verbergen.
CMFCRibbonBaseElement::OnShowPopupMenu
Aangeroepen door het framework voordat het lintelement een pop-upmenu weergeeft.
virtual void OnShowPopupMenu();
Opmerkingen
Met deze methode wordt het bovenliggende venster van de lintbalk op de hoogte gesteld dat het lintelement een pop-upmenu weergeeft.
CMFCRibbonBaseElement::P ostMenuCommand
Hiermee sluit u het snelmenu voor het lintelement en verzendt u een sluitend bericht naar het bovenliggende menu.
void PostMenuCommand(UINT uiCmdId);
Parameterwaarden
uiCmdId
[in] De parameter wordt niet gebruikt.
Opmerkingen
Het bericht sluiten wordt alleen verzonden als het lintelement zich in een snelmenu bevindt.
CMFCRibbonBaseElement::Redraw
Hiermee wordt de weergave voor het lintelement bijgewerkt.
virtual void Redraw();
Opmerkingen
Met deze methode wordt de weergaverechthoek voor het lintelement opnieuw getekend door CWnd:::RedrawWindow aan te roepen met de RDW_INVALIDATE, RDW_ERASE en RDW_UPDATENOW vlaggen ingesteld.
CMFCRibbonBaseElement::SetACCData
Hiermee stelt u de toegankelijkheidsgegevens voor het lintelement in.
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Parameterwaarden
pParent
Het bovenliggende venster voor het lintelement.
gegevens
De toegankelijkheidsgegevens voor het lintelement.
Retourwaarde
Retourneert altijd WAAR.
Opmerkingen
Deze methode stelt standaard de toegankelijkheidsgegevens voor het lintelement in en retourneert altijd TRUE. Overschrijf deze methode om de toegankelijkheidsgegevens in te stellen en een waarde te retourneren die aangeeft dat deze is geslaagd of mislukt.
CMFCRibbonBaseElement::SetCompactMode
Hiermee stelt u de weergavegrootte voor het lintelement in.
virtual void SetCompactMode(BOOL bCompactMode = TRUE);
Parameterwaarden
bCompactMode
[in] TRUE om de weergavegrootte van het lintelement te verkleinen; ONWAAR om de weergavegrootte van het lintelement te vergroten.
Opmerkingen
De volgende tabel bevat een overzicht van de logica voor deze methode.
| bCompactMode | Grootte van huidig lintelement | Grootte van nieuw lintelement |
|---|---|---|
| TRUE | Compact | Geen verandering. |
| TRUE | Gevorderd | Compact indien mogelijk. |
| TRUE | Groot | Tussenliggend, indien mogelijk. |
| ONWAAR | Compact | Tussenliggend indien mogelijk; anders groot. |
CMFCRibbonBaseElement::SetData
Hiermee koppelt u een gegevensitem aan het lintelement.
void SetData(DWORD_PTR dwData);
Parameterwaarden
dwData
[in] De gegevenswaarde.
CMFCRibbonBaseElement::SetDefaultMenuLook
Hiermee stelt u in dat het lintelement wordt weergegeven als een pop-upopdracht.
void SetDefaultMenuLook(BOOL bIsDefaultMenuLook = TRUE);
Parameterwaarden
bIsDefaultMenuLook
[in] TRUE om het lintelement in te stellen als een pop-upopdracht; anders ONWAAR.
Opmerkingen
CMFCRibbonBaseElement::SetDescription
Hiermee stelt u de beschrijving voor het lintelement in.
virtual void SetDescription(LPCTSTR lpszText);
Parameterwaarden
lpszText
[in] De beschrijving voor het lintelement.
Opmerkingen
In het framework wordt de nieuwe beschrijving weergegeven op de statusbalk of in de knopinfo of onder de menuknop.
CMFCRibbonBaseElement::SetID
Hiermee stelt u de opdracht-id van het lintelement in.
virtual void SetID(UINT nID);
Parameterwaarden
nID
[in] De opdracht-id.
CMFCRibbonBaseElement::SetInitialMode
Hiermee stelt u de oorspronkelijke weergavegrootte voor het lintelement in.
virtual void SetInitialMode(BOOL bOneRow = FALSE);
Parameterwaarden
bOneRow
[in] TRUE om de weergavegrootte voor het lintelement te beperken tot compact of tussenliggend element; anders, ONWAAR.
Opmerkingen
De weergavegrootte van lintelementen kan compact, tussenliggend of groot zijn.
CMFCRibbonBaseElement::SetKeys
Hiermee stelt u de toetsinfo voor het lintelement in.
virtual void SetKeys(
LPCTSTR lpszKeys,
LPCTSTR lpszMenuKeys=NULL);
Parameterwaarden
lpszKeys
[in] De toetsinfo voor het lintelement.
lpszMenuKeys
[in] De toetsinfo voor het snelmenu van het lintelement.
CMFCRibbonBaseElement::SetOriginal
Hiermee stelt u het oorspronkelijke lintelement voor het lintelement in.
virtual void SetOriginal(CMFCRibbonBaseElement* pOriginal);
Parameterwaarden
pOriginal
[in] Aanwijzer naar een lintelement.
Opmerkingen
Lintelementen die naar een andere container worden gekopieerd, behouden een aanwijzer naar het oorspronkelijke lintelement.
CMFCRibbonBaseElement::SetParentCategory
Hiermee stelt u de bovenliggende categorie voor het lintelement in.
virtual void SetParentCategory(CMFCRibbonCategory* pParent);
Parameterwaarden
pParent
[in] Aanwijzer naar een lintcategorie.
Opmerkingen
De groepen met tabbladen in lintbesturingselementen worden categorieën genoemd.
CMFCRibbonBaseElement::SetParentMenu
Hiermee stelt u de bovenliggende menucontainer voor het lintelement in.
virtual void SetParentMenu(CMFCRibbonPanelMenuBar* pMenuBar);
Parameterwaarden
pMenubalk
[in] Het bovenliggende menu.
Opmerkingen
CMFCRibbonBaseElement::SetParentRibbonBar
Hiermee stelt u de bovenliggende lintbalk voor het lintelement in.
virtual void SetParentRibbonBar(CMFCRibbonBar* pRibbonBar);
Parameterwaarden
pRibbonBar
[in] Aanwijzer naar de bovenliggende lintbalk.
Opmerkingen
CMFCRibbonBaseElement::SetRect
Hiermee stelt u de afmetingen van de weergaverechthoek voor het lintelement in.
void SetRect(CRect rect);
Parameterwaarden
Rect
[in] De afmetingen van de rechthoek.
Opmerkingen
CMFCRibbonBaseElement::SetText
Hiermee stelt u de tekst en keytip voor het lintelement in.
virtual void SetText(LPCTSTR lpszText);
Parameterwaarden
lpszText
[in] De tekst en de toetsinfo voor het lintelement.
Opmerkingen
Als u de toetstip voor het lintelement wilt instellen, voegt u de escapereeks voor de nieuwe regel toe, gevolgd door de toetstiptekens aan lpszText.
Example
//Set the text for the ribbon element
SetText(_T("Margins"))
//Set the text and a single-letter keytip
SetText(_T("Margins\nm"))
//Set the text and a multiple-letter keytip
SetText(_T("Line Numbers\nln"))
CMFCRibbonBaseElement::SetTextAlwaysOnRight
Hiermee stelt u de tekst voor het lintelement in om aan de rechterkant weer te geven.
virtual void SetTextAlwaysOnRight(BOOL bSet = TRUE);
Parameterwaarden
bSet
[in] WAAR om de tekst aan de rechterkant weer te geven; anders ONWAAR.
Opmerkingen
CMFCRibbonBaseElement::SetToolTipText
Hiermee stelt u de knopinfotekst voor het lintelement in.
virtual void SetToolTipText(LPCTSTR lpszText);
Parameterwaarden
lpszText
[in] De knopinfotekst.
CMFCRibbonBaseElement::SetVisible
Hiermee stelt u de zichtbaarheid van het lintelement in.
void SetVisible(BOOL bIsVisible);
Parameterwaarden
bIsVisible
[in] WAAR om het lintelement weer te geven; FALSE om het lintelement te verbergen.
Opmerkingen
CMFCRibbonBaseElement::StretchHorizontally
Hiermee wordt de breedte van het lintelement uitgerekt.
virtual void StretchHorizontally();
Opmerkingen
Deze methode genereert standaard een assertiefout in builds voor foutopsporing en mag daarom niet worden aangeroepen. Overschrijf deze methode om de breedte van het lintelement uit te rekken.
CMFCRibbonBaseElement::StretchToWholeRow
Hiermee wijzigt u de weergavehoogte van het lintelement in de opgegeven rijhoogte.
virtual BOOL StretchToWholeRow(
CDC* pDC,
int nHeight);
Parameterwaarden
Pdc
[in] Deze parameter wordt niet gebruikt.
nHeight
[in] De hoogte van de rij.
Retourwaarde
WAAR als de weergavehoogte is ingesteld; anders, ONWAAR.
Opmerkingen
Overschrijf deze methode om de weergavehoogte van het lintelement te wijzigen in de opgegeven rijhoogte.
CMFCRibbonBaseElement::UpdateTooltipInfo
Hiermee werkt u de tekst van de knopinfo bij met behulp van de opdrachtresource voor het lintelement.
virtual void UpdateTooltipInfo();
Opmerkingen
CMFCRibbonBaseElement::HasFocus
Geeft aan of het bovenliggende element de focus op het toetsenbord heeft.
virtual BOOL HasFocus() const;
Retourwaarde
WAAR als het lintelement is gericht; anders ONWAAR.