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.
Hiermee wordt een deelvenster geïmplementeerd dat een set lintelementen bevat. Wanneer het paneel wordt getekend, worden er zoveel mogelijk elementen weergegeven, gezien de grootte van het paneel.
Zie de broncode in de map VC\atlmfc\src\mfc van uw Visual Studio-installatie voor meer informatie.
Syntaxis
class CMFCRibbonPanel : public CObject
Leden
Beveiligde constructors
| Naam | Description |
|---|---|
| CMFCRibbonPanel::CMFCRibbonPanel | Maakt en initialiseert een CMFCRibbonPanel object. |
Openbare methoden
| Naam | Description |
|---|---|
| CMFCRibbonPanel::Add | Hiermee voegt u een lintelement toe aan het deelvenster. |
| CMFCRibbonPanel::AddSeparator | Hiermee voegt u een scheidingsteken toe aan het lintpaneel. |
| CMFCRibbonPanel::AddToolBar | Hiermee voegt u een werkbalk toe aan het lintpaneel. |
| CMFCRibbonPanel::FindByData | |
| CMFCRibbonPanel::FindByID | Retourneert een element dat is geïdentificeerd door een opgegeven opdracht-id. |
| CMFCRibbonPanel::GetCaptionHeight | |
| CMFCRibbonPanel::GetCount | Retourneert het aantal elementen in het lintvenster. |
| CMFCRibbonPanel::GetData | Retourneert de door de gebruiker gedefinieerde gegevens die zijn gekoppeld aan het deelvenster. |
| CMFCRibbonPanel::GetDefaultButton | |
| CMFCRibbonPanel::GetDroppedDown | |
| CMFCRibbonPanel::GetElement | Retourneert het lintelement dat zich in een opgegeven index bevindt. |
| CMFCRibbonPanel::GetElements | Hiermee worden alle elementen opgehaald die zich in het lintvenster bevinden. |
| CMFCRibbonPanel::GetElementsByID | |
| CMFCRibbonPanel::GetFocused | Retourneert een gericht element. |
| CMFCRibbonPanel::GetGalleryRect | Hiermee wordt een begrenzingsrechthoek van het galerie-element geretourneerd. |
| CMFCRibbonPanel::GetHighlighted | |
| CMFCRibbonPanel::GetIndex | |
| CMFCRibbonPanel::GetItemIDsList | |
| CMFCRibbonPanel::GetName | |
| CMFCRibbonPanel::GetParentButton | |
| CMFCRibbonPanel::GetParentCategory | Retourneert de bovenliggende categorie van het lintpaneel. |
| CMFCRibbonPanel::GetParentMenuBar | |
| CMFCRibbonPanel::GetPreferedMenuLocation | |
| CMFCRibbonPanel::GetPressed | |
| CMFCRibbonPanel::GetRect | |
| CMFCRibbonPanel::GetVisibleElements | Hiermee haalt u een matrix van zichtbare elementen op. |
| CMFCRibbonPanel::HasElement | |
| CMFCRibbonPanel::HitTest | |
| CMFCRibbonPanel::HitTestEx | |
| CMFCRibbonPanel::Insert | Hiermee wordt een lintelement op de opgegeven positie ingevoegd. |
| CMFCRibbonPanel::InsertSeparator | Hiermee voegt u een scheidingsteken in op de opgegeven positie. |
| CMFCRibbonPanel::IsCenterColumnVert | Hiermee geeft u op of alle paneelelementen verticaal moeten worden gecentreerd (uitgelijnd) op kolom. |
| CMFCRibbonPanel::IsCollapsed | |
| CMFCRibbonPanel::IsHighlighted | |
| CMFCRibbonPanel::IsJustifyColumns | Hiermee geeft u op of alle paneelkolommen dezelfde breedte hebben. |
| CMFCRibbonPanel::IsMainPanel | |
| CMFCRibbonPanel::IsMenuMode | |
| CMFCRibbonPanel::MakeGalleryItemVisible | Schuift door de galerie om het opgegeven lintelement zichtbaar te maken. |
| CMFCRibbonPanel::OnKey | |
| CMFCRibbonPanel::RecalcWidths | |
| CMFCRibbonPanel::Remove | Hiermee verwijdert u een element dat zich in de opgegeven index bevindt, en verwijdert u dit desgewenst. |
| CMFCRibbonPanel::RemoveAll | Hiermee verwijdert u alle elementen uit het lintvenster. |
| CMFCRibbonPanel::Replace | Het ene element wordt vervangen door een ander element op basis van hun respectieve indexwaarden. |
| CMFCRibbonPanel::ReplaceByID | Vervangt het ene element door een ander element op basis van een opgegeven opdracht-id. |
| CMFCRibbonPanel::SetCenterColumnVert | Hiermee wordt het deelvenster gerangschikt om elementen verticaal uit te lijnen op kolom. |
| CMFCRibbonPanel::SetData | Hiermee koppelt u door de gebruiker gedefinieerde gegevens aan het lintpaneel. |
| CMFCRibbonPanel::SetElementMenu | Hiermee wordt een pop-upmenu toegewezen aan het element met de opgegeven opdracht-id. |
| CMFCRibbonPanel::SetElementRTC | Hiermee voegt u een lintelement toe dat is opgegeven door de opgegeven runtimeklassegegevens aan het lintpaneel. |
| CMFCRibbonPanel::SetElementRTCByID | Hiermee voegt u een lintelement toe dat is opgegeven door de opgegeven runtimeklassegegevens aan het lintpaneel. |
| CMFCRibbonPanel::SetFocused | Hiermee stelt u de focus in op het opgegeven lintelement. |
| CMFCRibbonPanel::SetJustifyColumns | Hiermee schakelt u de reden voor kolommen in of uit. |
| CMFCRibbonPanel::SetKeys | Hiermee stelt u de sneltoets in waarmee het lintvenster wordt weergegeven. |
| CMFCRibbonPanel::ShowPopup |
Opmerkingen
Lintvensters zijn logische groeperingen van gerelateerde taken die u in lintcategorieën maakt. Naarmate de grootte van het lint verandert, wordt de deelvensterindeling automatisch aangepast om zoveel mogelijk elementen weer te geven.
U kunt een lintvenster ophalen dat zich in een lintcategorie bevindt door de methode CMFCRibbonCategory::GetPanel aan te roepen.
Example
In het volgende voorbeeld ziet u hoe u een CMFCRibbonPanel object configureert met behulp van verschillende methoden in de CMFCRibbonPanel klasse. In het voorbeeld ziet u hoe u de sneltoets kunt instellen waarmee het lintvenster wordt weergegeven, elementen in het deelvenster verticaal uitlijnen op kolom en het inschakelen van een reden voor kolommen. Dit codefragment maakt deel uit van het MS Office 2007 Demo-voorbeeld.
// CMFCRibbonCategory* pCategory
// CMFCToolBarImages m_PanelImages
CMFCRibbonPanel *pPanelClipboard = pCategory->AddPanel(_T("Clipboard"), m_PanelImages.ExtractIcon(1));
pPanelClipboard->SetKeys(_T("zc"));
pPanelClipboard->SetCenterColumnVert();
pPanelClipboard->SetJustifyColumns();
Overnamehiërarchie
Requirements
Koptekst: afxRibbonPanel.h
CMFCRibbonPanel::Add
Hiermee voegt u het opgegeven lintelement toe aan de matrix met lintelementen die zich in het lintvenster bevinden.
virtual void Add(CMFCRibbonBaseElement* pElem);
Parameterwaarden
pElem
[in, uit] Aanwijzer naar een lintelement.
Opmerkingen
CMFCRibbonPanel::AddSeparator
Hiermee voegt u een scheidingsteken toe aan het lintpaneel.
virtual void AddSeparator();
Opmerkingen
Roep deze methode aan om een scheidingsteken toe te voegen aan het lintpaneel. Het scheidingsteken wordt toegevoegd naast het lintelement dat is toegevoegd door de vorige aanroep naar CMFCRibbonPanel::Add. Als u een scheidingsteken op een bepaalde positie wilt invoegen, roept u CMFCRibbonPanel::InsertSeparator aan.
CMFCRibbonPanel::AddToolBar
Hiermee voegt u een werkbalk toe aan het lintpaneel.
CMFCRibbonButtonsGroup* AddToolBar(
UINT uiToolbarResID,
UINT uiColdResID = 0,
UINT uiHotResID = 0,
UINT uiDisabledResID = 0);
Parameterwaarden
uiToolbarResID
[in] Hiermee geeft u de resource-id van de werkbalk die moet worden toegevoegd.
uiColdResID
[in] Hiermee geeft u de resource-id van de koude afbeeldingen van de werkbalk.
uiHotResID
[in] Hiermee geeft u de resource-id van de dynamische afbeeldingen van de werkbalk.
uiDisabledResID
[in] Hiermee geeft u de resource-id van de uitgeschakelde afbeeldingen van de werkbalk.
Retourwaarde
Roep deze methode aan om een werkbalk toe te voegen aan het lintpaneel. De werkbalk wordt toegevoegd naast het lintelement dat is toegevoegd door de vorige aanroep naar CMFCRibbonPanel::Add.
Opmerkingen
Zie DE klasse CMFCToolBar voor meer informatie over werkbalken, dynamische afbeeldingen, koude afbeeldingen en uitgeschakelde afbeeldingen.
CMFCRibbonPanel::CMFCRibbonPanel
Bouwt en initialiseert een CMFCRibbonPanel-object .
CMFCRibbonPanel(
LPCTSTR lpszName = NULL,
HICON hIcon = NULL);
CMFCRibbonPanel(CMFCRibbonGallery* pPaletteButton);
Parameterwaarden
lpszName
[in] De naam van het lintpaneel.
hIcon
[in] Greep naar het pictogram van de standaardknop voor het lintpaneel.
pPaletteButton
[in] Aanwijzer naar een lintgalerie voor het lintpaneel.
CMFCRibbonPanel::FindByData
Hiermee wordt het lintelement opgehaald dat is gekoppeld aan de opgegeven gegevens.
CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData) const;
Parameterwaarden
dwData
[in] De gegevens die zijn gekoppeld aan een lintelement.
Retourwaarde
Aanwijzer naar een lintelement als de methode is geslaagd; anders NULL.
Opmerkingen
CMFCRibbonPanel::FindByID
Hiermee wordt het lintelement opgehaald dat wordt geïdentificeerd door de opgegeven opdracht-id.
CMFCRibbonBaseElement* FindByID(UINT uiCmdID) const;
Parameterwaarden
uiCmdID
[in] De opdracht-id van een lintelement.
Retourwaarde
Het lintelement dat wordt geïdentificeerd door de opgegeven opdracht-id; anders NULL als er geen lintelement wordt geïdentificeerd met de opgegeven opdracht-id.
CMFCRibbonPanel::GetCaptionHeight
Hiermee haalt u de hoogte van een bijschrift voor het lintpaneel op.
int GetCaptionHeight() const;
Retourwaarde
De hoogte, in pixels, van een bijschrift voor het lintpaneel.
Opmerkingen
CMFCRibbonPanel::GetCount
Hiermee haalt u het aantal lintelementen op dat zich in het lintvenster bevindt.
int GetCount() const;
Retourwaarde
Het aantal lintelementen dat zich in het lintvenster bevindt.
CMFCRibbonPanel::GetData
Retourneert de door de gebruiker gedefinieerde gegevens die zijn gekoppeld aan het deelvenster.
DWORD_PTR GetData() const;
Retourwaarde
De door de gebruiker gedefinieerde gegevens die aan het deelvenster zijn gekoppeld.
CMFCRibbonPanel::GetDefaultButton
Hiermee wordt de standaardknop voor het lintvenster opgehaald.
CMFCRibbonButton& GetDefaultButton();
Retourwaarde
De standaardknop voor het lintpaneel.
Opmerkingen
De standaardknop wordt weergegeven wanneer een lintpaneel onvoldoende ruimte heeft om de lintelementen weer te geven.
CMFCRibbonPanel::GetDroppedDown
Hiermee wordt een aanwijzer naar een lintelement opgehaald als het pop-upmenu wordt neergezet.
CMFCRibbonBaseElement* GetDroppedDown() const;
Retourwaarde
Wijs het lintelement aan waarop het pop-upmenu is neergezet; anders NULL als er geen pop-upmenu van het lintelement is neergezet.
Opmerkingen
Alleen lintelementen die zich in het lintvenster bevinden, worden getest.
CMFCRibbonPanel::GetElement
Retourneert het lintelement dat zich in een opgegeven index bevindt.
CMFCRibbonBaseElement* GetElement(int nIndex) const;
Parameterwaarden
nIndex
[in] Hiermee geeft u de op nul gebaseerde index van het element dat moet worden opgehaald.
Retourwaarde
Een geldige aanwijzer naar het basislintelement op positie nIndex in het lintvenster of NULL als er geen element in de opgegeven index is.
CMFCRibbonPanel::GetElements
Hiermee worden alle lintelementen opgehaald die zich in het lintvenster bevinden.
void GetElements(CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Parameterwaarden
arElements
[uit] Een matrix die moet worden gevuld met alle lintelementen die zich in het lintvenster bevinden.
Opmerkingen
CMFCRibbonPanel::GetElementsByID
Hiermee voegt u lintelementen met de opgegeven opdracht-id toe aan de opgegeven matrix.
void GetElementsByID(
UINT uiCmdID,
CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Parameterwaarden
uiCmdID
[in] Opdracht-id voor een lintelement.
arElements
[in] Matrix met lintelementen.
Opmerkingen
Alleen lintelementen die zich in het lintvenster bevinden, worden getest.
CMFCRibbonPanel::GetHighlighted
Hiermee wordt het lintelement opgehaald dat is gemarkeerd op het lintpaneel.
CMFCRibbonBaseElement* GetHighlighted() const;
Retourwaarde
Wijs het lintelement aan dat is gemarkeerd op het lintpaneel.
Opmerkingen
CMFCRibbonPanel::GetIndex
Hiermee haalt u de op nul gebaseerde index van het opgegeven lintelement op uit de matrix met lintelementen die zich in het lintvenster bevinden.
virtual int GetIndex(CMFCRibbonBaseElement* pElem) const;
Parameterwaarden
pElem
[in] Aanwijzer naar een lintelement.
Retourwaarde
Op nul gebaseerde index van het opgegeven lintelement als de methode is geslaagd; anders -1.
Opmerkingen
CMFCRibbonPanel::GetItemIDsList
Hiermee worden de opdracht-id's opgehaald voor alle lintelementen in het lintvenster.
void GetItemIDsList(CList<UINT, UINT>& lstItems) const;
Parameterwaarden
lstItems
[uit] De lijst met opdracht-id's voor lintelementen die zich in het lintvenster bevinden.
Opmerkingen
CMFCRibbonPanel::GetName
Hiermee wordt de naam van het lintvenster opgehaald.
LPCTSTR GetName() const;
Retourwaarde
De naam van het lintpaneel.
Opmerkingen
CMFCRibbonPanel::GetParentButton
CMFCRibbonBaseElement* GetParentButton() const;
Retourwaarde
Opmerkingen
CMFCRibbonPanel::GetParentCategory
Retourneert de bovenliggende categorie van het lintpaneel.
CMFCRibbonCategory* GetParentCategory() const;
Retourwaarde
Een aanwijzer naar de lintcategorie die dit lintpaneel bevat.
CMFCRibbonPanel::GetParentMenuBar
CMFCRibbonPanelMenuBar* GetParentMenuBar() const;
Retourwaarde
Opmerkingen
CMFCRibbonPanel::GetPreferedMenuLocation
Hiermee wordt de voorkeursweergaverechthoek opgehaald voor het snelmenu van het lintpaneel.
virtual BOOL GetPreferedMenuLocation(CRect& rect);
Parameterwaarden
Rect
[uit] Deze parameter wordt niet gebruikt.
Retourwaarde
Retourneert altijd ONWAAR.
Opmerkingen
Deze methode retourneert altijd FALSE. Overschrijf deze methode om de voorkeursweergaverechthoek op te halen voor het snelmenu van het lintpaneel.
CMFCRibbonPanel::GetPressed
Hiermee wordt een aanwijzer naar een lintelement in het lintvenster opgehaald als de gebruiker er momenteel op drukt.
CMFCRibbonBaseElement* GetPressed() const;
Retourwaarde
Een aanwijzer naar een lintelement als de gebruiker er momenteel op drukt; anders NULL.
Opmerkingen
CMFCRibbonPanel::GetRect
Hiermee haalt u de weergaverechthoek voor het lintpaneel op.
const CRect& GetRect() const;
Retourwaarde
De weergaverechthoek voor het lintpaneel.
Opmerkingen
CMFCRibbonPanel::HasElement
Hiermee wordt aangegeven of het lintpaneel het opgegeven lintelement bevat.
BOOL HasElement(const CMFCRibbonBaseElement* pElem) const;
Parameterwaarden
pElem
[in] Aanwijzer naar een lintelement.
Retourwaarde
WAAR als het lintpaneel het opgegeven lintelement bevat; anders ONWAAR.
Opmerkingen
CMFCRibbonPanel::Highlight
Hiermee stelt u de markeringskleur in voor het geselecteerde lintpaneel en voor het lintelement dat door het punt is opgegeven.
virtual void Highlight(
BOOL bHighlight,
CPoint point);
Parameterwaarden
bHighlight
[in] WAAR om het lintpaneel te markeren; ONWAAR om het lintpaneel te ontlichten.
Punt
[in] De x- en y-coördinaten van de aanwijzer ten opzichte van de linkerbovenhoek van het venster.
Opmerkingen
CMFCRibbonPanel::HitTest
Hiermee wordt een lintelement opgehaald als het opgegeven punt zich erin bevindt.
virtual CMFCRibbonBaseElement* HitTest(
CPoint point,
BOOL bCheckPanelCaption = FALSE);
Parameterwaarden
Punt
[in] De x- en y-coördinaten van de aanwijzer ten opzichte van de linkerbovenhoek van het venster.
bCheckPanelCaption
[in] WAAR om het bijschrift van het lintpaneel te testen; anders ONWAAR.
Retourwaarde
Aanwijzer naar een lintelement als het opgegeven punt zich erin bevindt; anders NULL.
Opmerkingen
Alleen lintelementen die zich in het lintvenster bevinden, worden getest.
CMFCRibbonPanel::HitTestEx
Hiermee wordt de op nul gebaseerde index opgehaald van het lintelement dat het opgegeven punt bevat.
virtual int HitTestEx(CPoint point) const;
Parameterwaarden
Punt
[in] De x- en y-coördinaten van de aanwijzer ten opzichte van de linkerbovenhoek van het venster.
Retourwaarde
De op nul gebaseerde index van het lintelement met daarin het opgegeven punt; anders -1.
Opmerkingen
Alleen lintelementen die zich in het lintvenster bevinden, worden getest.
CMFCRibbonPanel::Insert
Hiermee voegt u het opgegeven lintelement in op de opgegeven positie in de matrix met lintelementen die zich in het lintvenster bevinden.
virtual BOOL Insert(
CMFCRibbonBaseElement* pElem,
int nIndex);
Parameterwaarden
pElem
[in, uit] Aanwijzer naar een lintelement.
nIndex
[in] Op nul gebaseerde waarde, variërend van -1 tot het aantal lintelementen in de matrix.
Retourwaarde
WAAR als het lintelement is ingevoegd; anders ONWAAR.
Opmerkingen
Als de waarde van nIndex -1 is of als nIndex gelijk is aan het aantal lintelementen in de matrix, wordt het opgegeven lintelement toegevoegd aan het einde van de matrix. Als de waarde van nIndex buiten het bereik valt, mislukt de methode.
CMFCRibbonPanel::InsertSeparator
Hiermee voegt u een scheidingsteken in op de opgegeven positie.
virtual BOOL InsertSeparator(int nIndex);
Parameterwaarden
nIndex
[in] Hiermee geeft u de op nul gebaseerde index op waar het scheidingsteken wordt ingevoegd.
Retourwaarde
WAAR als het scheidingsteken is ingevoegd; anders, ONWAAR.
Opmerkingen
Roep deze methode aan om een scheidingsteken in te voegen op de positie die is opgegeven door nIndex. Als u een scheidingsteken wilt invoegen naast het laatst toegevoegde lintelement, roept u CMFCRibbonPanel::AddSeparator aan.
CMFCRibbonPanel::IsCenterColumnVert
Hiermee wordt aangegeven of de verticale posities van lintelementen zijn gecentreerd binnen de weergaverechthoek.
BOOL IsCenterColumnVert() const;
Retourwaarde
WAAR als de verticale posities van lintelementen zijn gecentreerd binnen de weergaverechthoek; anders ONWAAR.
CMFCRibbonPanel::IsCollapsed
Hiermee wordt aangegeven of de weergavegrootte van het lintpaneel wordt geminimaliseerd in de horizontale richting.
BOOL IsCollapsed() const;
Retourwaarde
WAAR als de weergavegrootte van het lintpaneel wordt geminimaliseerd in de horizontale richting; anders ONWAAR.
Opmerkingen
Wanneer een lintpaneel is samengevouwen, wordt alleen de standaardknop, de naam en een vervolgkeuzepijl weergegeven.
CMFCRibbonPanel::IsHighlighted
Hiermee wordt aangegeven of de weergave van het lintvenster is gemarkeerd.
BOOL IsHighlighted() const;
Retourwaarde
WAAR als de weergave van het lintpaneel is gemarkeerd; anders ONWAAR.
Opmerkingen
De weergave van een lintpaneel wordt gemarkeerd wanneer de aanwijzer erop staat.
CMFCRibbonPanel::IsJustifyColumns
Hiermee wordt aangegeven of de weergavedimensies van lintelementen die zich in dezelfde kolom in het lintpaneel bevinden, zijn ingesteld op dezelfde breedte.
BOOL IsJustifyColumns() const;
Retourwaarde
WAAR als de weergavedimensies van lintelementen die zich in dezelfde kolom in het lintpaneel bevinden, zijn ingesteld op dezelfde breedte; anders ONWAAR.
CMFCRibbonPanel::IsMainPanel
Hiermee wordt aangegeven of het lintpaneel het hoofdlintpaneel is.
virtual BOOL IsMainPanel() const;
Retourwaarde
Retourneert altijd ONWAAR.
Opmerkingen
Deze methode retourneert altijd FALSE. Overschrijf deze methode om aan te geven of het lintpaneel het hoofdlintpaneel is.
Het hoofdlintvenster wordt weergegeven wanneer de gebruiker de toepassingsknop selecteert.
CMFCRibbonPanel::IsMenuMode
BOOL IsMenuMode() const;
Retourwaarde
Opmerkingen
CMFCRibbonPanel::OnKey
virtual BOOL OnKey(UINT nChar);
Parameterwaarden
[in] Nchar
Retourwaarde
Opmerkingen
CMFCRibbonPanel::RecalcWidths
Berekent de breedte van elke configuratie van de weergave-indeling voor het lintpaneel opnieuw.
virtual void RecalcWidths(
CDC* pDC,
int nHeight);
Parameterwaarden
Pdc
[in] Aanwijzer naar een apparaatcontext voor het lintpaneel.
nHeight
[in] De hoogte van het lintpaneel.
Opmerkingen
Een lintpaneel wijzigt de indelingsconfiguratie naarmate de beschikbare breedte verandert.
CMFCRibbonPanel::Remove
Hiermee verwijdert u een element dat zich in de opgegeven index bevindt, en verwijdert u dit desgewenst.
BOOL Remove(
int nIndex,
BOOL bDelete = TRUE);
Parameterwaarden
nIndex
[in] Hiermee geeft u de op nul gebaseerde index op van het element dat uit het lintvenster wordt verwijderd.
bDelete
[in] WAAR om het element te verwijderen dat wordt verwijderd; anders, ONWAAR.
Retourwaarde
WAAR als het element is verwijderd en verwijderd (als bDelete TRUE is); ONWAAR als het element niet is verwijderd of als er geen lintelement zich in nIndex bevindt.
Opmerkingen
Roep deze methode aan om een element uit het lintvenster te verwijderen.
CMFCRibbonPanel::RemoveAll
Hiermee verwijdert u alle lintelementen uit het lintvenster.
void RemoveAll();
Opmerkingen
Alle lintelementen worden verwijderd uit het lintpaneel en vernietigd.
CMFCRibbonPanel::Replace
Hiermee vervangt u het ene element door een ander element op basis van de indexwaarde.
BOOL Replace(
int nIndex,
CMFCRibbonBaseElement* pElem);
Parameterwaarden
nIndex
[in] Hiermee geeft u de op nul gebaseerde index van het element dat moet worden vervangen.
pElem
[in, uit] Een geldige aanwijzer naar het element dat het oorspronkelijke element vervangt.
Retourwaarde
WAAR als het oorspronkelijke lintelement is vervangen door het nieuwe lintelement; ONWAAR als het lintelement niet is vervangen of als er geen element in de opgegeven index is.
Opmerkingen
Als u een lintelement wilt vervangen door opdracht-id, roept u CMFCRibbonPanel::ReplaceByID aan.
CMFCRibbonPanel::ReplaceByID
Vervangt het ene element door een ander element op basis van een opgegeven opdracht-id.
BOOL ReplaceByID(
UINT uiCmdID,
CMFCRibbonBaseElement* pElem);
Parameterwaarden
uiCmdID
[in] Hiermee geeft u de opdracht-id van het element dat moet worden vervangen.
pElem
[in, uit] Een geldige aanwijzer naar het element dat het oorspronkelijke element vervangt.
Retourwaarde
WAAR als het oorspronkelijke lintelement is vervangen door het nieuwe lintelement; ONWAAR als het lintelement niet is vervangen of als er geen element met de opgegeven opdracht-id bestaat.
Opmerkingen
Als u een lintelement wilt vervangen op basis van positie, roept u CMFCRibbonPanel::Replace aan.
CMFCRibbonPanel::SetCenterColumnVert
Hiermee schakelt u het centreren van de verticale posities van lintelementen in de weergaverechthoek in of uit.
void SetCenterColumnVert(BOOL bSet = TRUE);
Parameterwaarden
bSet
[in] WAAR om de verticale posities van lintelementen in de weergaverechthoek te centreren; FALSE om deze functie uit te schakelen.
Opmerkingen
CMFCRibbonPanel::SetData
Hiermee koppelt u door de gebruiker gedefinieerde gegevens aan het lintpaneel.
void SetData(DWORD_PTR dwData);
Parameterwaarden
dwData
[in] Hiermee geeft u de door de gebruiker gedefinieerde gegevens op die moeten worden ingesteld.
Opmerkingen
Roep deze methode aan om door de gebruiker gedefinieerde gegevens te koppelen aan het lintvenster.
CMFCRibbonPanel::SetElementMenu
Hiermee wordt een pop-upmenu toegewezen aan het element met de opgegeven opdracht-id.
BOOL SetElementMenu(
UINT uiCmdID,
HMENU hMenu,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);
BOOL SetElementMenu(
UINT uiCmdID,
UINT uiMenuResID,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);
Parameterwaarden
uiCmdID
[in] Hiermee geeft u de opdracht-id van het lintelement waar het menu wordt toegevoegd.
hMenu
[in] Hiermee geeft u de greep aan het Windows-menu om toe te voegen aan het lintpaneel.
bIsDefautCommand
[in] TRUE om op te geven dat de opdracht die aan het lintelement is gekoppeld, moet worden uitgevoerd als op het lintelement wordt geklikt. In dit geval wordt het menu alleen geopend wanneer de gebruiker op de pijl naast het lintelement klikt. FALSE om op te geven dat de opdracht die is gekoppeld aan het lintelement niet mag worden uitgevoerd als op het lintelement wordt geklikt. In dit geval wordt het pop-upmenu weergegeven, ongeacht waar de gebruiker op het element klikt.
bRightAlign
[in] WAAR om op te geven dat het pop-upmenu rechts is uitgelijnd; anders, ONWAAR.
uiMenuResID
[in] Hiermee geeft u de resource-id van het menu om toe te voegen aan het lintpaneel.
Retourwaarde
WAAR als het menu is toegewezen aan het lintelement; anders, ONWAAR.
Opmerkingen
Roep deze methode aan om een pop-upmenu toe te wijzen aan het lintelement met de opgegeven opdracht-id.
CMFCRibbonPanel::SetElementRTC
Hiermee voegt u het lintelement toe dat is opgegeven door de opgegeven runtimeklassegegevens aan het lintpaneel.
CMFCRibbonBaseElement* SetElementRTC(
int nIndex,
CRuntimeClass* pRTC);
Parameterwaarden
nIndex
[in] Hiermee geeft u de op nul gebaseerde index van het lintelement dat moet worden toegevoegd.
pRTC
[in, uit] Een aanwijzer naar de informatie van de runtimeklasse voor het lintelement dat wordt toegevoegd aan het lintpaneel.
Retourwaarde
Het lintelement dat is gemaakt met behulp van de opgegeven runtimeklassegegevens.
Opmerkingen
Als u een aangepast element (bijvoorbeeld een kleurknop) wilt toevoegen aan het lintvenster, moet u de runtimeklassegegevens van het aangepaste element opgeven. Het lint slaat deze informatie op, maakt het aangepaste element en vervangt een bestaand element dat zich bevindt (geïdentificeerd door) de opgegeven opdracht-id. Het lint retourneert vervolgens een aanwijzer naar het zojuist gemaakte element.
CMFCRibbonPanel::SetElementRTCByID
Hiermee voegt u een lintelement toe dat is opgegeven door de opgegeven runtimeklassegegevens aan het lintpaneel.
CMFCRibbonBaseElement* SetElementRTCByID(
UINT uiCmdID,
CRuntimeClass* pRTC);
Parameterwaarden
uiCmdID
[in] Hiermee geeft u de opdracht-id van het lintelement dat moet worden toegevoegd.
pRTC
[in, uit] Een aanwijzer naar de runtimeklasse-informatie die is gekoppeld aan het lintelement dat wordt toegevoegd aan het lintpaneel.
Retourwaarde
Het lintelement dat is gemaakt met behulp van de opgegeven runtimeklassegegevens.
Opmerkingen
Als u een aangepast element (bijvoorbeeld een kleurknop) wilt toevoegen aan het lintvenster, moet u de runtimeklassegegevens van het aangepaste element opgeven. Op het lint worden deze gegevens opgeslagen, wordt het aangepaste element gemaakt en wordt een bestaand element vervangen door de opgegeven opdracht-id. Vervolgens wordt een aanwijzer geretourneerd naar het zojuist gemaakte element.
Example
In het volgende voorbeeld ziet u hoe u de SetElementRTCByID methode gebruikt:
// Load and add toolbar with standard buttons. This toolbar
// should display a custom color button with id ID_CHAR_COLOR:
pPanel->AddToolBar(IDR_MAINFRAME,
IDB_MAINFRAME256);
CMFCRibbonColorButton* pColorButton =
(CMFCRibbonColorButton*)pPanel->SetElementRTCByID(
ID_CHAR_COLOR,
RUNTIME_CLASS (CMFCRibbonColorButton));
// SetElementRTCByID sets runtime class and returns a pointer
// to the newly created custom button,
which can be set up immediately:
pColorButton->EnableAutomaticButton(_T("Automatic"),
RGB (0,
0,
0));
CMFCRibbonPanel::SetJustifyColumns
Hiermee schakelt u de aanpassing van de breedte van lintelementen in dezelfde kolom in of uit.
void SetJustifyColumns(BOOL bSet = TRUE);
Parameterwaarden
bSet
[in] TRUE om de breedte van lintelementen in dezelfde kolom aan te passen aan de breedte van het grootste lintelement in de kolom; FALSE om deze breedteaanpassing uit te schakelen.
Opmerkingen
Wanneer deze functie is ingeschakeld in een lintvenster, worden de breedte van lintelementen in dezelfde kolom aangepast aan de breedte van het grootste lintelement in dezelfde kolom.
CMFCRibbonPanel::SetKeys
Hiermee stelt u de toetsinfo voor de standaardknop van het lintpaneel in.
void SetKeys(LPCTSTR lpszKeys);
Parameterwaarden
lpszKeys
[in] De toetsinfo voor de standaardknop van het lintpaneel.
Opmerkingen
De standaardknop wordt weergegeven wanneer een lintpaneel onvoldoende ruimte heeft om de lintelementen weer te geven.
CMFCRibbonPanel::ShowPopup
Hiermee wordt een snelmenu voor het lintvenster gemaakt en weergegeven.
CMFCRibbonPanelMenu* ShowPopup(CMFCRibbonDefaultPanelButton* pButton = NULL);
Parameterwaarden
pButton
[in] Aanwijzer naar de standaardknop voor het lintpaneel.
Retourwaarde
Wijs het snelmenu voor het lintvenster aan als de methode is geslaagd; anders NULL.
Opmerkingen
Het snelmenu voor het lintvenster is alleen beschikbaar wanneer het lintvenster wordt samengevouwen.
CMFCRibbonPanel::SetFocused
Hiermee stelt u de focus in op het opgegeven lintelement.
void SetFocused(CMFCRibbonBaseElement* pNewFocus);
Parameterwaarden
pNewFocus
Een aanwijzer naar een lintelement dat de focus krijgt.
Opmerkingen
CMFCRibbonPanel::MakeGalleryItemVisible
Schuift door de galerie om het opgegeven lintelement zichtbaar te maken.
void MakeGalleryItemVisible(CMFCRibbonBaseElement* pItem);
Parameterwaarden
pItem
Een aanwijzer naar een lintelement dat moet worden weergegeven.
Opmerkingen
CMFCRibbonPanel::IsWindows7Look
Hiermee wordt aangegeven of het bovenliggende lint een Windows 7-uiterlijk heeft (kleine rechthoekige toepassingsknop).
BOOL IsWindows7Look() const;
Retourwaarde
WAAR als het bovenliggende lint windows 7 heeft; anders ONWAAR.
Opmerkingen
CMFCRibbonPanel::GetVisibleElements
Hiermee haalt u een matrix met zichtbare elementen op.
void GetVisibleElements(
CArray<CMFCRibbonBaseElement*,
CMFCRibbonBaseElement*>& arElements);
Parameterwaarden
arElements
Wanneer de functie wordt geretourneerd, bevat deze parameter een matrix met zichtbare elementen.
Opmerkingen
CMFCRibbonPanel::GetGalleryRect
Hiermee wordt een begrenzingsrechthoek van een galerie-element geretourneerd.
CRect GetGalleryRect();
Retourwaarde
Grootte en positie van het element Galerie in dit deelvenster.
Opmerkingen
CMFCRibbonPanel::GetFocused
Retourneert een gericht element.
CMFCRibbonBaseElement* GetFocused() const;
Retourwaarde
Een aanwijzer naar een gericht element of NULL.
Opmerkingen
Zie ook
Hiërarchiegrafiek
Klassen
CObject-klasse
CMFCRibbonCategory-klasse
Klasse CMFCRibbonBaseElement