CMFCRibbonBaseElement-klass

Artikel
2025-02-21

Klassen CMFCRibbonBaseElement är basklassen för alla element som du kan lägga till i ett menyfliksområde. Exempel på menyflikselement är menyfliksknappar, kryssrutor för menyfliksområdet och kombinationsrutor i menyfliksområdet.

Syntax

class CMFCRibbonBaseElement : public CObject

Medlemmar

Offentliga konstruktorer

Namn	Beskrivning
`CMFCRibbonBaseElement`	Konstruerar ett `CMFCRibbonBaseElement` objekt.

Offentliga metoder

Namn	Beskrivning
CMFCRibbonBaseElement::AddToKeyList	Lägger till en nyckelbeskrivning för menyflikselementet i en matris med knappbeskrivningar.
CMFCRibbonBaseElement::AddToListBox	Lägger till ett menyflikselement i den angivna listrutan för menyflikskommandon.
CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar	Anger om menyflikselementet kan läggas till i verktygsfältet för snabbåtkomst.
CMFCRibbonBaseElement::CanBeCompacted	Anger om storleken på menyflikselementet kan vara kompakt.
CMFCRibbonBaseElement::CanBeStretched	Anger om höjden på menyflikselementet kan öka lodrätt till höjden på en menyfliksrad.
CMFCRibbonBaseElement::CanBeStretchedHorizontally	Anger om bredden på menyflikselementet kan ändras.
CMFCRibbonBaseElement::CleanUpSizes	Rensar dimensionsinställningarna för menyfliksområdet.
CMFCRibbonBaseElement::ClosePopupMenu	Stänger popup-menyn för menyfliksområdet.
CMFCRibbonBaseElement::CopyFrom	Kopierar tillståndet för den angivna `CMFCRibbonBaseElement` till det aktuella objektet.
CMFCRibbonBaseElement::D estroyCtrl	Förstör menyflikselementet.
CMFCRibbonBaseElement::D rawImage	Ritar bilden för menyflikselementet.
CMFCRibbonBaseElement::Hitta	Returnerar den angivna pekaren till menyfliksområdet om den pekar på det aktuella objektet.
CMFCRibbonBaseElement::FindByData	Hämtar en pekare till menyfliksområdet om det innehåller angivna data.
CMFCRibbonBaseElement::FindByID	Hämtar en pekare till menyfliksområdet om elementet identifieras av det angivna kommando-ID:t.
CMFCRibbonBaseElement::FindByOriginal	Hämtar en pekare till menyflikselementet om dess ursprungliga menyflikselement matchar det angivna menyflikselementet.
CMFCRibbonBaseElement::GetCompactSize	Returnerar menyfliksområdets kompakta storlek.
CMFCRibbonBaseElement::GetData	Hämtar användardefinierade data som är associerade med menyflikselementet.
CMFCRibbonBaseElement::GetDescription	Returnerar beskrivningen av menyflikselementet.
CMFCRibbonBaseElement::GetDroppedDown	Hämtar en pekare till menyfliksområdet om popup-menyn tas bort.
CMFCRibbonBaseElement::GetElements	Lägger till det aktuella menyflikselementet i den angivna matrisen.
CMFCRibbonBaseElement::GetElementsByID	Lägger till det aktuella menyflikselementet i den angivna matrisen om det aktuella menyflikselementet innehåller det angivna kommando-ID:t.
CMFCRibbonBaseElement::GetHighlighted	Hämtar en pekare till menyfliksområdet om det är markerat.
CMFCRibbonBaseElement::GetID	Returnerar kommando-ID för menyflikselementet.
CMFCRibbonBaseElement::GetImageSize	Returnerar bildstorleken för menyfliksområdet.
CMFCRibbonBaseElement::GetIntermediateSize	Returnerar storleken på menyflikselementet i dess mellanliggande tillstånd.
CMFCRibbonBaseElement::GetKeys	Returnerar nyckelbeskrivningen som är associerad med menyflikselementet.
CMFCRibbonBaseElement::GetKeyTipRect	Hämtar nyckelip-gränsrektangeln för menyflikselementet.
CMFCRibbonBaseElement::GetKeyTipSize	Hämtar storleken på nyckelbeskrivningstexten.
CMFCRibbonBaseElement::GetLocationInGroup	Anger visningsplatsen för menyflikselementet i en menyfliksgrupp.
CMFCRibbonBaseElement::GetMenuKeys	Returnerar de knappbeskrivningar som är associerade med en knapp.
CMFCRibbonBaseElement::GetNotifyID	Hämtar meddelandekommando-ID:t för menyfliksområdet.
CMFCRibbonBaseElement::GetOriginal	Hämtar det ursprungliga menyfliksområdet.
CMFCRibbonBaseElement::GetParentCategory	Hämtar menyfliksområdets kategori för menyfliksområdet.
CMFCRibbonBaseElement::GetParentPanel	Hämtar menyfliksområdet som innehåller menyflikselementet.
CMFCRibbonBaseElement::GetParentRibbonBar	Hämtar det överordnade menyfliksområdet för menyflikselementet.
CMFCRibbonBaseElement::GetParentWnd	Hämtar det överordnade fönstret för menyfliksområdet.
CMFCRibbonBaseElement::GetPressed	Hämtar en pekare till menyfliksområdet om användaren trycker på den.
CMFCRibbonBaseElement::GetQuickAccessToolBarID	Hämtar kommando-ID för menyflikselementet när det finns i verktygsfältet för snabbåtkomst.
CMFCRibbonBaseElement::GetRect	Returnerar avgränsningsrektangeln för menyfliksområdet.
CMFCRibbonBaseElement::GetRegularSize	Returnerar den vanliga storleken på menyflikselementet.
CMFCRibbonBaseElement::GetSize	Returnerar den aktuella storleken på menyfliksområdets element.
CMFCRibbonBaseElement::GetText	Returnerar texten som är associerad med menyfliksområdet.
CMFCRibbonBaseElement::GetToolTipText	Returnerar knappbeskrivningstext för menyflikselementet.
CMFCRibbonBaseElement::GetTopLevelRibbonBar	Hämtar menyfliksområdet på den översta nivån för menyflikselementet.
CMFCRibbonBaseElement::HasCompactMode	Anger om menyflikselementet har ett kompakt läge.
CMFCRibbonBaseElement::HasFocus	Anger om det överordnade elementet har tangentbordsfokus.
CMFCRibbonBaseElement::HasIntermediateMode	Anger om menyflikselementet har ett mellanliggande läge.
CMFCRibbonBaseElement::HasLargeMode	Anger om menyflikselementet har ett stort läge.
CMFCRibbonBaseElement::HasMenu	Anger om menyflikselementet har en meny.
CMFCRibbonBaseElement::HitTest	Hämtar en pekare till menyfliksområdet om den angivna punkten finns i den.
CMFCRibbonBaseElement::IsAlignByColumn	Anger om menyflikselementet är lodrätt justerat med andra element i menyfliksområdet.
CMFCRibbonBaseElement::IsAlwaysLargeImage	Anger om bildstorleken för menyfliksområdet alltid är stor.
CMFCRibbonBaseElement::IsAutoRepeatMode	Anger om menyflikselementet är i automatiskt upprepat läge.
CMFCRibbonBaseElement::IsChecked	Anger om menyflikselementet är markerat.
CMFCRibbonBaseElement::IsCompactMode	Anger om menyflikselementet är i kompakt läge.
CMFCRibbonBaseElement::IsDefaultMenuLook
CMFCRibbonBaseElement::IsDisabled	Anger om menyflikselementet är inaktiverat.
CMFCRibbonBaseElement::IsDroppedDown	Avgör om menyflikselementet visar en popup-meny och tas ned.
CMFCRibbonBaseElement::IsFocused	Anger om menyflikselementet har fokus.
CMFCRibbonBaseElement::IsGalleryIcon	Anger om menyflikselementet finns i ett bandgalleri.
CMFCRibbonBaseElement::IsHighlighted	Anger om menyflikselementet är markerat.
CMFCRibbonBaseElement::IsIntermediateMode	Anger om den aktuella bilden för menyflikselementet är mellanliggande storlek.
CMFCRibbonBaseElement::IsLargeMode	Anger om den aktuella bilden för menyflikselementet är stor.
CMFCRibbonBaseElement::IsMenuMode	Anger om menyflikselementet finns i en meny.
CMFCRibbonBaseElement::IsPressed	Anger om användaren har klickat på menyflikselementet.
CMFCRibbonBaseElement::IsQATMode	Anger om menyflikselementet finns i verktygsfältet för snabbåtkomst.
CMFCRibbonBaseElement::IsSeparator	Anger om menyflikselementet är en visningsavgränsare.
CMFCRibbonBaseElement::IsShowGroupBorder	Anger om menyflikselementet finns i en grupp som visar en gemensam kantlinje.
CMFCRibbonBaseElement::IsShowTooltipOnBottom	Anger om knappbeskrivningen visas under menyfliksområdet.
CMFCRibbonBaseElement::IsTabStop	Anger om menyflikselementet kan väljas med tangentbordet.
CMFCRibbonBaseElement::IsTextAlwaysOnRight	Anger om texten för menyflikselementet visas till höger.
CMFCRibbonBaseElement::IsVisible	Anger om menyflikselementet visas för närvarande.
CMFCRibbonBaseElement::IsWholeRowHeight	Anger om menyflikselementets visnings heigth är samma som visningshöjden på den bandpanel som innehåller det.
CMFCRibbonBaseElement::NotifyCommand	Skickar ett kommandomeddelande till det överordnade fönstret i menyfliksområdet.
CMFCRibbonBaseElement::NotifyHighlightListItem	Meddelar det överordnade fönstret i menyfliksområdet när en användare markerar ett menyflikselement som finns i en lista.
CMFCRibbonBaseElement::OnAddToQAToolbar	Lägger till menyflikselementet i det angivna verktygsfältet för snabbåtkomst.
CMFCRibbonBaseElement::OnAfterChangeRect	Uppdaterar knappbeskrivningen för menyfliksområdet.
CMFCRibbonBaseElement::OnAutoRepeat	Uppdaterar menyflikselementet som svar på varaktiga användarindata.
CMFCRibbonBaseElement::OnCalcTextSize	Beräknar textens storlek för menyfliksområdet.
CMFCRibbonBaseElement::OnChangeMenuHighlight	Anropas av ramverket när markeringar ändras för ett menyflikselement som finns på en meny.
CMFCRibbonBaseElement::OnDraw	Anropas av ramverket för att rita menyfliksområdet.
CMFCRibbonBaseElement::OnDrawKeyTip	Anropas av ramverket för att rita nyckelbeskrivningen för menyflikselementet.
CMFCRibbonBaseElement::OnDrawMenuImage	Anropas av ramverket när menybilden för menyelementet ritas.
CMFCRibbonBaseElement::OnDrawOnList	Anropas av ramverket för att rita menyfliksområdet i en kommandolistruta.
CMFCRibbonBaseElement::OnKey	Anropas av ramverket när användaren trycker på en knappbeskrivning och menyflikselementet har fokus.
CMFCRibbonBaseElement::OnMenuKey
CMFCRibbonBaseElement::OnRTLChanged	Anropas av ramverket när layouten ändrar riktning.
CMFCRibbonBaseElement::OnShow	Anropas av ramverket för att visa eller dölja menyflikselementet.
CMFCRibbonBaseElement::OnShowPopupMenu	Anropas av ramverket när menyflikselementet ska visa en popup-meny.
CMFCRibbonBaseElement::P ostMenuCommand
CMFCRibbonBaseElement::Redraw	Uppdaterar visningen för menyflikselementet.
CMFCRibbonBaseElement::SetACCData	Anger hjälpmedelsdata för menyfliksområdets element.
CMFCRibbonBaseElement::SetCompactMode	Anger visningsstorleken för menyfliksområdets element.
CMFCRibbonBaseElement::SetData	Associerar ett dataobjekt med menyfliksområdet.
CMFCRibbonBaseElement::SetDefaultMenuLook
CMFCRibbonBaseElement::SetDescription	Anger beskrivningen för menyflikselementet.
CMFCRibbonBaseElement::SetID	Anger kommando-ID för menyflikselementet.
CMFCRibbonBaseElement::SetInitialMode	Anger den inledande visningsstorleken för menyfliksområdets element.
CMFCRibbonBaseElement::SetKeys	Anger en nyckelbeskrivning för menyflikselementet.
CMFCRibbonBaseElement::SetOriginal	Anger det ursprungliga menyflikselementet för menyflikselementet.
CMFCRibbonBaseElement::SetParentCategory	Anger den överordnade kategorin för menyfliksområdet.
CMFCRibbonBaseElement::SetParentMenu	Anger den överordnade menycontainern för menyfliksområdet.
CMFCRibbonBaseElement::SetParentRibbonBar	Anger det överordnade menyfliksområdet för menyflikselementet.
CMFCRibbonBaseElement::SetRect	Anger dimensionerna för visningsrektangeln för menyflikselementet.
CMFCRibbonBaseElement::SetText	Anger texten för menyflikselementet.
CMFCRibbonBaseElement::SetTextAlwaysOnRight	Anger texten för menyflikselementet som ska visas till höger.
CMFCRibbonBaseElement::SetToolTipText	Anger knappbeskrivningstexten för menyflikselementet.
CMFCRibbonBaseElement::SetVisible	Anger synlighetstillståndet för menyfliksområdets element.
CMFCRibbonBaseElement::StretchHorizontally	Sträcker ut bredden på menyfliksområdet.
CMFCRibbonBaseElement::StretchToWholeRow	Ändrar visningshöjden för menyflikselementet till den angivna radhöjden.
CMFCRibbonBaseElement::UpdateTooltipInfo	Uppdaterar knappbeskrivningstexten med hjälp av kommandoresursen för menyflikselementet.

Skyddade metoder

Namn	Beskrivning
CMFCRibbonBaseElement::OnProcessKey	Anropas av ramverket när användaren trycker på en genvägsnyckel.
CMFCRibbonBaseElement::OnSetFocus	Anropas av ramverket när ett bandelement tar emot eller förlorar indatafokuset.

Anmärkningar

Klassen CMFCRibbonBaseElement definierar de egenskaper som är gemensamma för alla element i menyfliksområdet som innehåller kommando-ID, textetikett, knappbeskrivningstext, elementbeskrivning och tillstånd (som kan fokuseras, markeras, tryckas ned, inaktiveras, kontrolleras eller tas ned).

Bildstorleken för ett bandelement definieras av RibbonImageType medlem, vilket kan vara något av följande värden:

RibbonImageLarge
RibbonImageSmall

Beroende på dess storlek visar ett menyfliksområde antingen en liten eller stor bild.

Exempel

I följande exempel visas hur du använder olika metoder i klassen CMFCRibbonBaseElement. Exemplet visar hur du hämtar ett CMFCRibbonBaseElement-objekt från en CMFCRibbonStatusBar-klass, anger beskrivningen för menyflikselementet, anger texten, anger en nyckelbeskrivning och anger knappbeskrivningstexten för menyflikselementet. Det här kodfragmentet är en del av Draw Client-exempelexemplet.

// 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"));

Arvshierarki

CObject

CMFCRibbonBaseElement

Krav

Rubrik: afxbaseribbonelement.h

CMFCRibbonBaseElement::AddToKeyList

Lägger till en nyckelbeskrivning för menyflikselementet i en matris med knappbeskrivningar.

virtual void AddToKeyList(
    CArray<CMFCRibbonKeyTip*, CMFCRibbonKeyTip*>& arElems);

Parametrar

arElems
[i] Referens till en CArray- med knappbeskrivningar.

Anmärkningar

När funktionen för knappbeskrivningar i menyfliksområdet är aktiverad visar ramverket knappbeskrivningar i menyfliksområdet när användaren trycker på ALT-tangenten eller F10-tangenten.

CMFCRibbonBaseElement::AddToListBox

Lägger till ett menyflikselement i den angivna listrutan för menyflikskommandon.

virtual int AddToListBox(
    CMFCRibbonCommandsListBox* pWndListBox,
    BOOL bDeep);

Parametrar

pWndListBox
[i] Pekare till en kommandolistruta.

bDeep
[i] Den här parametern används inte.

Returvärde

Det nollbaserade indexet för det tillagda menyfliksområdet.

Anmärkningar

Ramverket lägger till menyflikselement i en kommandolistruta så att användaren kan anpassa användargränssnittet.

CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar

Anger om menyflikselementet kan läggas till i verktygsfältet för snabbåtkomst.

virtual BOOL CanBeAddedToQuickAccessToolBar() const;

Returvärde

TRUE om elementet kan läggas till. annars FALSKT.

Anmärkningar

CMFCRibbonBaseElement::CanBeCompacted

Anger om storleken på menyflikselementet kan vara kompakt.

virtual BOOL CanBeCompacted() const;

Returvärde

SANT om storleken på menyfliksområdet kan vara kompakt; annars FALSKT.

Anmärkningar

Storleken på ett bandelement kan vara kompakt, mellanliggande eller stort.

CMFCRibbonBaseElement::CanBeStretched

Anger om höjden på menyflikselementet kan öka lodrätt till höjden på en menyfliksrad.

virtual BOOL CanBeStretched();

Returvärde

Returnerar alltid TRUE.

Anmärkningar

Som standard returnerar den här metoden alltid TRUE. Åsidosätt den här metoden för att ange om höjden på menyflikselementet kan öka lodrätt till höjden på en menyfliksrad.

CMFCRibbonBaseElement::CanBeStretchedHorizontally

Anger om bredden på menyflikselementet kan ändras.

virtual BOOL CanBeStretchedHorizontally();

Returvärde

Returnerar alltid FALSE.

Anmärkningar

Som standard returnerar den här metoden alltid FALSE. Åsidosätt den här metoden för att ange om bredden på menyflikselementet kan ändras.

CMFCRibbonBaseElement::CleanUpSizes

Rensar dimensionsinställningarna för menyfliksområdet.

virtual void CleanUpSizes();

Anmärkningar

Som standard gör den här metoden ingenting. Åsidosätt den här metoden i en härledd klass för att återställa dimensionsinställningarna för menyflikselementet.

CMFCRibbonBaseElement::ClosePopupMenu

Stänger popup-menyn för menyfliksområdet.

virtual void ClosePopupMenu();

Anmärkningar

CMFCRibbonBaseElement::CopyFrom

Kopierar tillståndet för den angivna CMFCRibbonBaseElement till det aktuella objektet.

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

Parametrar

src
[i] Källan CMFCRibbonBaseElement-objektet.

Anmärkningar

CMFCRibbonBaseElement::D estroyCtrl

Förstör menyflikselementet.

virtual void DestroyCtrl();

Anmärkningar

Som standard gör den här metoden ingenting. Åsidosätt den här metoden i en härledd klass för att förstöra menyflikselementet.

CMFCRibbonBaseElement::D rawImage

Ritar bilden för menyflikselementet.

virtual void DrawImage(
    CDC* pDC,
    RibbonImageType type,
    CRect rectImage);

Parametrar

pDC-
[i] Pekare mot en enhetskontext.

typ
[i] Ett uppräknat värde för bildtyp. Se avsnittet Kommentarer för en lista över möjliga värden.

rectImage
[i] Bildrektangeln.

Anmärkningar

Som standard gör den här metoden ingenting. Åsidosätt den här metoden i en härledd klass för att rita bilden för menyflikselementet.

I följande tabell visas möjliga värden för parametern typ:

Värde	Beskrivning
`RibbonImageLarge`	Stor bildstorlek på 32 x 32 bildpunkter.
`RibbonImageSmall`	Liten bildstorlek på 16 x 16 bildpunkter.

CMFCRibbonBaseElement::Find

Returnerar den angivna pekaren om den pekar på det aktuella objektet.

virtual CMFCRibbonBaseElement* Find(const CMFCRibbonBaseElement* pElement);

Parametrar

pElement
[i] Pekare till ett menyflikselement.

Returvärde

En pekare till menyflikselementet om pElement- pekar på det aktuella objektet. annars NULL.

Anmärkningar

CMFCRibbonBaseElement::FindByData

Hämtar en pekare till menyfliksområdet om det innehåller angivna data.

virtual CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData);

Parametrar

dwData
[i] Data som är associerade med ett bandelement.

Returvärde

En pekare till menyflikselementet om det innehåller angivna data. annars NULL.

Anmärkningar

CMFCRibbonBaseElement::FindByID

Hämtar en pekare till menyfliksområdet om elementet identifieras av det angivna kommando-ID:t.

virtual CMFCRibbonBaseElement* FindByID(UINT uiCmdID);

Parametrar

uiCmdID
[i] Kommando-ID för ett menyflikselement.

Returvärde

En pekare till menyfliksområdet om elementet identifieras av det angivna kommando-ID:t. annars NULL.

Anmärkningar

CMFCRibbonBaseElement::FindByOriginal

Hämtar en pekare till det aktuella menyflikselementet om dess ursprungliga menyflikselement matchar det angivna menyflikselementet.

virtual CMFCRibbonBaseElement* FindByOriginal(CMFCRibbonBaseElement* pOriginal);

Parametrar

pOriginal
[i] Pekare till ett menyflikselement.

Returvärde

En pekare till menyflikselementet om dess ursprungliga menyflikselement matchar det angivna menyflikselementet. annars NULL.

Anmärkningar

Bandelement som kopieras till en annan container behåller en pekare till det ursprungliga menyflikselementet.

CMFCRibbonBaseElement::GetCompactSize

Returnerar menyfliksområdets kompakta storlek.

virtual CSize GetCompactSize(CDC* pDC);

Parametrar

pDC-
[i] En pekare till en enhetskontext.

Returvärde

Den kompakta storleken på ett bandelement.

Not

Den kompakta storleken innebär att menyfliksområdet trunkeras (det visar en liten bild eller en bild utan text).

CMFCRibbonBaseElement::GetData

Hämtar användardefinierade data som är associerade med menyflikselementet.

DWORD_PTR GetData() const;

Returvärde

Användardefinierade data som är associerade med menyfliksområdet.

CMFCRibbonBaseElement::GetDescription

Returnerar beskrivningen av menyflikselementet.

virtual CString GetDescription() const;

Returvärde

Beskrivning av menyfliksområdets element. Beskrivningen visas antingen i statusfältet eller i en knappbeskrivning eller under menyknappen om menyelementet finns på CMFCRibbonMainPanel Class.

CMFCRibbonBaseElement::GetDroppedDown

Hämtar en pekare till menyfliksområdet om popup-menyn tas bort.

virtual CMFCRibbonBaseElement* GetDroppedDown();

Returvärde

En pekare till menyflikselementet om popup-menyn tas ned. annars NULL.

Anmärkningar

CMFCRibbonBaseElement::GetElements

Lägger till det aktuella menyflikselementet i den angivna matrisen.

virtual void GetElements(
    CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

Parametrar

arElements
[in, ut] En matris med menyflikselement.

Anmärkningar

CMFCRibbonBaseElement::GetElementsByID

Lägger till det aktuella menyflikselementet i den angivna matrisen om det aktuella menyflikselementet innehåller det angivna kommando-ID:t.

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

Parametrar

uiCmdID
[i] Kommando-ID för ett menyfliksområde.

arElements
[i] En matris med menyflikselement.

Anmärkningar

CMFCRibbonBaseElement::GetHighlighted

Hämtar en pekare till menyfliksområdet om det är markerat.

virtual CMFCRibbonBaseElement* GetHighlighted();

Returvärde

En pekare till menyflikselementet om det är markerat. annars NULL.

Anmärkningar

CMFCRibbonBaseElement::GetID

Returnerar kommando-ID för menyflikselementet.

UINT GetID() const;

Returvärde

Kommando-ID för menyflikselementet.

CMFCRibbonBaseElement::GetImageSize

Returnerar bildstorleken för menyfliksområdet.

virtual CSize GetImageSize(RibbonImageType R) const;

Returvärde

Bildstorleken för menyfliksområdet.

CMFCRibbonBaseElement::GetIntermediateSize

Returnerar storleken på menyflikselementet i dess mellanliggande tillstånd.

virtual CSize GetIntermediateSize(CDC* pDC);

Parametrar

pDC-
[i] En pekare till en enhetskontext.

Returvärde

Storleken på elementet i menyfliksområdet i dess mellanliggande tillstånd.

CMFCRibbonBaseElement::GetKeys

Returnerar nyckelbeskrivningen som är associerad med menyflikselementet.

LPCTSTR GetKeys() const;

Returvärde

En nyckelbeskrivning som är associerad med menyfliksområdet.

CMFCRibbonBaseElement::GetKeyTipRect

Hämtar nyckelip-gränsrektangeln för menyflikselementet.

virtual CRect GetKeyTipRect(
    CDC* pDC,
    BOOL bIsMenu);

Parametrar

pDC-
[i] Pekare mot en enhetskontext.

bIsMenu
[i] TRUE om menyflikselementet visar en popup-meny. annars FALSKT.

Returvärde

Returnerar alltid en rektangel med 0 värden.

Anmärkningar

Åsidosätt den här metoden i en härledd klass för att returnera nyckelbeskrivningens gränsrektangel.

CMFCRibbonBaseElement::GetKeyTipSize

Hämtar storleken på nyckelbeskrivningstexten.

virtual CSize GetKeyTipSize(CDC* pDC);

Parametrar

pDC-
[i] Pekare mot en enhetskontext.

Returvärde

Storleken på nyckelbeskrivningstexten.

Anmärkningar

CMFCRibbonBaseElement::GetLocationInGroup

Anger visningsplatsen för menyflikselementet i en menyfliksgrupp.

RibbonElementLocation GetLocationInGroup() const;

Returvärde

Ett RibbonElementLocation uppräknat värde. I följande tabell visas möjliga värden.

Värde	Beskrivning
`RibbonElementNotInGroup`	Menyflikselementet finns inte i en menyfliksgrupp.
`RibbonElementSingleInGroup`	Menyflikselementet visas som det enda objektet i en menyfliksgrupp.
`RibbonElementFirstInGroup`	Menyflikselementet visas till vänster i en menyfliksgrupp.
`RibbonElementLastInGroup`	Menyflikselementet visas till höger i en menyfliksgrupp.
`RibbonElementMiddleInGroup`	Menyflikselementet visas inte i någon av änderna av en menyfliksgrupp.

Anmärkningar

Elementgrupper i menyfliksområdet justeras bara vågrätt.

CMFCRibbonBaseElement::GetMenuKeys

Returnerar menyknappbeskrivningen för menyfliksområdet.

LPCTSTR GetMenuKeys() const;

Returvärde

Menynyckelbeskrivningen som är associerad med menyflikselementet.

Anmärkningar

När en menyknappbeskrivning anropas visas en popup-meny.

CMFCRibbonBaseElement::GetNotifyID

Hämtar meddelandekommando-ID:t för menyfliksområdet.

virtual UINT GetNotifyID();

Returvärde

Meddelandekommandots ID.

Anmärkningar

CMFCRibbonBaseElement::GetOriginal

Hämtar det ursprungliga menyfliksområdet.

CMFCRibbonBaseElement* GetOriginal() const;

Returvärde

En pekare till det ursprungliga menyfliksområdet.

Anmärkningar

Bandelement som kopieras till en annan container behåller en pekare till det ursprungliga menyflikselementet.

CMFCRibbonBaseElement::GetParentCategory

Hämtar menyfliksområdets kategori för menyfliksområdet.

CMFCRibbonCategory* GetParentCategory() const;

Returvärde

En pekare till menyfliksområdets kategori.

Anmärkningar

CMFCRibbonBaseElement::GetParentPanel

Hämtar menyfliksområdet som innehåller menyflikselementet.

virtual CMFCRibbonPanel* GetParentPanel() const;

Returvärde

En pekare till menyfliksområdet som innehåller menyflikselementet.

Anmärkningar

CMFCRibbonBaseElement::GetParentRibbonBar

Hämtar det överordnade menyfliksområdet för menyflikselementet.

CMFCRibbonBar* GetParentRibbonBar() const;

Returvärde

En pekare till det överordnade menyfliksområdet för menyflikselementet.

Anmärkningar

CMFCRibbonBaseElement::GetParentWnd

Hämtar det överordnade fönstret för menyfliksområdet.

virtual CWnd* GetParentWnd() const;

Returvärde

En pekare till det överordnade fönstret för menyflikselementet om metoden lyckades. annars NULL.

Anmärkningar

Det överordnade fönstret för ett menyfliksområde är en CMFCRibbonBar Class eller en CMFCRibbonPanelMenuBar.

CMFCRibbonBaseElement::GetPressed

Hämtar en pekare till menyfliksområdet om användaren trycker på den.

virtual CMFCRibbonBaseElement* GetPressed();

Returvärde

En pekare till menyflikselementet om användaren trycker på det. annars NULL.

Anmärkningar

CMFCRibbonBaseElement::GetQuickAccessToolBarID

Hämtar kommando-ID för menyflikselementet när det finns i verktygsfältet för snabbåtkomst.

virtual UINT GetQuickAccessToolBarID() const;

Returvärde

Kommando-ID för menyflikselementet när det finns i verktygsfältet för snabbåtkomst.

Anmärkningar

CMFCRibbonBaseElement::GetRect

Returnerar avgränsningsrektangeln för menyfliksområdet.

CRect GetRect() const;

Returvärde

Avgränsningsrektangeln för menyfliksområdets element. Rektangelns position finns i koordinaterna för den överordnade bandkontrollen.

CMFCRibbonBaseElement::GetRegularSize

Returnerar den vanliga storleken på menyflikselementet.

virtual CSize GetRegularSize(CDC* pDC) = 0;

Parametrar

pDC-
[i] En pekare till en enhetskontext.

Returvärde

Den vanliga storleken på menyflikselementet.

Anmärkningar

Not

Den vanliga storleken är den maximala möjliga storleken på menyflikselementet.

CMFCRibbonBaseElement::GetSize

Returnerar den aktuella storleken på menyfliksområdets element.

virtual CSize GetSize(CDC* pDC);

Parametrar

pDC-
[i] En pekare till en enhetskontext.

Returvärde

Den aktuella storleken på menyflikselementet.

CMFCRibbonBaseElement::GetText

Returnerar texten som är associerad med menyfliksområdet.

LPCTSTR GetText() const;

Returvärde

Texten som är associerad med menyfliksområdet.

CMFCRibbonBaseElement::GetToolTipText

Returnerar knappbeskrivningstext för menyflikselementet.

virtual CString GetToolTipText() const;

Returvärde

Knappbeskrivningstexten för menyflikselementet.

CMFCRibbonBaseElement::GetTopLevelRibbonBar

Hämtar menyfliksområdet på den översta nivån för menyflikselementet.

CMFCRibbonBar* GetTopLevelRibbonBar() const;

Returvärde

En pekare till menyfliksområdet på den översta nivån för menyflikselementet om metoden lyckades. annars NULL.

Anmärkningar

CMFCRibbonBaseElement::HasCompactMode

Anger om menyflikselementet har ett kompakt läge.

virtual BOOL HasCompactMode() const;

Returvärde

SANT om menyflikselementet har ett kompakt läge. ANNARS FALSKT.

Anmärkningar

Not

I kompakt läge visar ett element endast en liten bild.

CMFCRibbonBaseElement::HasIntermediateMode

Anger om menyflikselementet har ett mellanliggande läge.

virtual BOOL HasIntermediateMode() const;

Returvärde

SANT om menyflikselementet har ett mellanliggande läge, ANNARS FALSE. I mellanläge visar ett element en liten bild och text till höger om bilden.

Anmärkningar

CMFCRibbonBaseElement::HasLargeMode

Avgör om menyflikselementet har ett stort läge.

virtual BOOL HasLargeMode() const;

Returvärde

SANT om menyflikselementet har ett stort läge. ANNARS FALSKT.

Anmärkningar

I det stora läget kan ett element ta hela höjden på den överordnade panelen.

CMFCRibbonBaseElement::HasMenu

Anger om menyflikselementet har en meny.

virtual BOOL HasMenu() const;

Returvärde

Returnerar alltid FALSE.

Anmärkningar

Som standard returnerar den här metoden alltid FALSE. Åsidosätt den här metoden i en härledd klass för att ange om menyflikselementet har en meny.

CMFCRibbonBaseElement::HitTest

Hämtar en pekare till menyfliksområdet om den angivna punkten finns i den.

virtual CMFCRibbonBaseElement* HitTest(CPoint point);

Parametrar

punkt
[i] Den här parametern används inte.

Returvärde

En pekare till menyflikselementet om det finns. annars FALSKT.

Anmärkningar

Som standard returnerar den här metoden alltid en giltig pekare till menyflikselementet när det finns. Åsidosätt den här metoden för att ange om punkten finns i menyflikselementet.

CMFCRibbonBaseElement::IsAlignByColumn

Anger om menyflikselementet är lodrätt justerat med andra element i menyfliksområdet.

virtual BOOL IsAlignByColumn() const;

Returvärde

Returnerar alltid TRUE.

Anmärkningar

Som standard returnerar den här metoden alltid TRUE. Åsidosätt den här metoden i en härledd klass för att ange om det härledda menyflikselementet justeras lodrätt med andra element i menyfliksområdet.

CMFCRibbonBaseElement::IsAlwaysLargeImage

Anger om bildstorleken för menyfliksområdet alltid är stor.

virtual BOOL IsAlwaysLargeImage() const;

Returvärde

SANT om bildstorleken för menyfliksområdet alltid är stor. annars FALSKT.

Anmärkningar

Stor bildstorlek är 32 x 32 bildpunkter.

CMFCRibbonBaseElement::IsAutoRepeatMode

Anger om menyflikselementet är i automatiskt upprepat läge.

virtual BOOL IsAutoRepeatMode(int& nDelay) const;

Parametrar

nDelay
[i] Den här parametern används inte.

Returvärde

Returnerar alltid FALSE.

Anmärkningar

Som standard returnerar den här metoden alltid FALSE. Åsidosätt den här metoden för att ange om menyflikselementet är i automatiskt upprepningsläge.

I autorepetitionsläge svarar menyflikselementet med ett angivet intervall, mätt i millisekunder, på varaktiga användarindata.

CMFCRibbonBaseElement::IsChecked

Anger om menyflikselementet är markerat.

virtual BOOL IsChecked() const;

Returvärde

SANT om menyflikselementet är markerat. annars FALSKT.

CMFCRibbonBaseElement::IsCompactMode

Anger om menyflikselementet är i kompakt läge.

BOOL IsCompactMode() const;

Returvärde

SANT om menyflikselementet är i ett kompakt läge. annars FALSKT.

CMFCRibbonBaseElement::IsDefaultMenuLook

Anger om menyflikselementet är inställt på att visas som ett popup-kommando.

BOOL IsDefaultMenuLook() const;

Returvärde

SANT om menyflikselementet är inställt på att visas som ett popup-kommando. annars FALSKT.

Anmärkningar

CMFCRibbonBaseElement::IsDisabled

Anger om menyflikselementet är inaktiverat.

virtual BOOL IsDisabled() const;

Returvärde

SANT om menyflikselementet är inaktiverat. annars FALSKT.

CMFCRibbonBaseElement::IsDroppedDown

Anger om menyflikselementet visar en popup-meny och tas ned.

virtual BOOL IsDroppedDown() const;

Returvärde

SANT om menyflikselementet tappas ned och visar en popup-meny. annars FALSKT.

CMFCRibbonBaseElement::IsFocused

Anger om menyflikselementet har fokus.

virtual BOOL IsFocused() const;

Returvärde

TRUE om menyflikselementet har fokus; annars FALSKT.

CMFCRibbonBaseElement::IsGalleryIcon

Anger om menyflikselementet finns i ett bandgalleri.

virtual BOOL IsGalleryIcon() const;

Returvärde

Returnerar alltid FALSE.

Anmärkningar

Som standard returnerar den här metoden alltid FALSE. Åsidosätt den här metoden i en härledd klass för att ange om menyflikselementet finns i ett bandgalleri.

CMFCRibbonBaseElement::IsHighlighted

Anger om menyflikselementet är markerat.

virtual BOOL IsHighlighted() const;

Returvärde

SANT om menyflikselementet är markerat. annars FALSKT.

Anmärkningar

CMFCRibbonBaseElement::IsIntermediateMode

Anger om den aktuella bilden för menyflikselementet är mellanliggande storlek.

BOOL IsIntermediateMode() const;

Returvärde

SANT om bilden för menyflikselementet är mellanliggande storlek. annars FALSKT.

Anmärkningar

Mellanliggande bildstorlek är 16 x 16 bildpunkter.

CMFCRibbonBaseElement::IsLargeMode

Anger om den aktuella bilden för menyflikselementet är stor.

BOOL IsLargeMode() const;

Returvärde

SANT om bilden för menyflikselementet är stor. annars FALSKT.

Anmärkningar

Stor bildstorlek är 32 x 32 bildpunkter.

CMFCRibbonBaseElement::IsMenuMode

Anger om menyflikselementet finns i en meny.

BOOL IsMenuMode() const;

Returvärde

SANT om menyflikselementet finns i en meny. annars FALSKT.

Anmärkningar

CMFCRibbonBaseElement::IsPressed

Anger om användaren har klickat på menyflikselementet.

virtual BOOL IsPressed() const;

Returvärde

SANT om användaren har klickat på menyflikselementet. annars FALSKT.

CMFCRibbonBaseElement::IsQATMode

Anger om menyflikselementet finns i verktygsfältet för snabbåtkomst.

BOOL IsQATMode() const;

Returvärde

SANT om menyflikselementet finns i verktygsfältet för snabbåtkomst. annars FALSKT.

Anmärkningar

CMFCRibbonBaseElement::IsSeparator

Anger om menyflikselementet är en visningsavgränsare.

virtual BOOL IsSeparator() const;

Returvärde

SANT om menyflikselementet är en visningsavgränsare. annars FALSKT.

Anmärkningar

CMFCRibbonBaseElement::IsShowGroupBorder

Anger om menyflikselementet finns i en grupp som visar en gemensam kantlinje.

BOOL IsShowGroupBorder() const;

Returvärde

SANT om menyflikselementet finns i en grupp som visar en gemensam kantlinje. annars FALSKT.

Anmärkningar

CMFCRibbonBaseElement::IsShowTooltipOnBottom

Anger om knappbeskrivningen visas under menyfliksområdet.

virtual BOOL IsShowTooltipOnBottom() const;

Returvärde

SANT om knappbeskrivningen visas under menyflikselementet. FALSKT om knappbeskrivningen visas nära pekaren.

Anmärkningar

CMFCRibbonBaseElement::IsTabStop

Anger om menyflikselementet kan väljas med tangentbordet.

virtual BOOL IsTabStop() const;

Returvärde

Returnerar alltid TRUE.

Anmärkningar

Som standard returnerar den här metoden alltid TRUE. Åsidosätt den här metoden för att ange om menyflikselementet kan väljas med tangentbordet.

CMFCRibbonBaseElement::IsTextAlwaysOnRight

Anger om texten för menyflikselementet visas till höger.

BOOL IsTextAlwaysOnRight() const;

Returvärde

SANT om texten för menyflikselementet visas till höger. annars FALSKT.

Anmärkningar

CMFCRibbonBaseElement::IsVisible

Anger om menyflikselementet visas för närvarande.

BOOL IsVisible() const;

Returvärde

SANT om menyflikselementet för närvarande visas. annars FALSKT.

Anmärkningar

CMFCRibbonBaseElement::IsWholeRowHeight

Anger om menyflikselementets visningshöjd är samma som visningshöjden för den bandpanel som innehåller det.

virtual BOOL IsWholeRowHeight() const;

Returvärde

Returnerar alltid FALSE.

Anmärkningar

Som standard returnerar den här metoden alltid FALSE. Åsidosätt den här metoden för att ange om visningshöjden för menyflikselementet är samma som visningshöjden för den menyflikspanel som innehåller det.

CMFCRibbonBaseElement::NotifyCommand

Skickar ett kommandomeddelande till det överordnade fönstret i menyfliksområdet.

BOOL NotifyCommand(BOOL bWithDelay = FALSE);

Parametrar

bWithDelay
[i] TRUE för att lägga till kommandomeddelandet i meddelandekön i det överordnade fönstret. FALSE för att skicka meddelandet direkt till det överordnade fönstret.

Returvärde

SANT om meddelandet skickades. annars FALSKT.

Anmärkningar

CMFCRibbonBaseElement::NotifyHighlightListItem

Meddelar det överordnade fönstret i menyfliksområdet när en användare markerar ett menyflikselement som finns i en lista.

virtual void NotifyHighlightListItem(int nIndex);

Parametrar

nIndex
[i] Indexet för menyfliksområdet i listan.

Anmärkningar

CMFCRibbonBaseElement::OnAddToQAToolbar

Lägger till menyflikselementet i det angivna verktygsfältet för snabbåtkomst.

virtual BOOL OnAddToQAToolbar(CMFCRibbonQuickAccessToolBar& qat);

Parametrar

qat
[i] Verktygsfältet för snabbåtkomst.

Returvärde

Returnerar alltid TRUE som anger att menyflikselementet har lagts till i verktygsfältet för snabbåtkomst.

Anmärkningar

CMFCRibbonBaseElement::OnAfterChangeRect

Uppdaterar knappbeskrivningen för menyfliksområdet.

virtual void OnAfterChangeRect(CDC* pDC);

Parametrar

pDC-
[i] Den här parametern används inte.

Anmärkningar

Som standard uppdaterar den här metoden knappbeskrivningen för menyflikselementet. Åsidosätt den här metoden för att uppdatera menyfliksområdet när dess visningsrektangel har ändrats.

CMFCRibbonBaseElement::OnAutoRepeat

Uppdaterar menyflikselementet som svar på varaktiga användarindata.

virtual BOOL OnAutoRepeat();

Returvärde

Returnerar alltid FALSE.

Anmärkningar

Som standard returnerar den här metoden alltid FALSE. Åsidosätt den här metoden för att bearbeta varaktiga användarindata.

CMFCRibbonBaseElement::OnCalcTextSize

Beräknar textens storlek för menyfliksområdet.

virtual void OnCalcTextSize(CDC* pDC);

Parametrar

pDC-
[i] Den här parametern används inte.

Anmärkningar

Som standard gör den här metoden ingenting. Åsidosätt den här metoden för att beräkna textens storlek för menyflikselementet.

CMFCRibbonBaseElement::OnChangeMenuHighlight

Anropas av ramverket när markeringar ändras för ett menyflikselement som finns på en meny.

virtual void OnChangeMenuHighlight(CMFCRibbonPanelMenuBar* pPanelMenuBar
    CMFCRibbonBaseElement* pHot);

Parametrar

pPanelMenuBar
[i] Den här parametern används inte.

pHot
[i] Den här parametern används inte.

Anmärkningar

Som standard gör den här metoden ingenting. Åsidosätt den här metoden för att uppdatera ett menyfliksområde som finns i en meny när markeringsmarkeringen ändras.

CMFCRibbonBaseElement::OnDraw

Anropas av ramverket för att rita menyfliksområdet.

virtual void OnDraw(CDC* pDC) = 0;

Parametrar

pDC-
[i] En pekare till en enhetskontext.

Anmärkningar

Åsidosätt den här metoden i en härledd klass om du vill anpassa ritningen av ett visst menyflikselement.

CMFCRibbonBaseElement::OnDrawKeyTip

Anropas av ramverket för att rita nyckelbeskrivningen för menyflikselementet.

virtual void OnDrawKeyTip(
    CDC* pDC,
    const CRect& rect,
    BOOL bIsMenu);

Parametrar

pDC-
[i] Pekare mot en enhetskontext.

rect
[i] Gränsrektangel för nyckelbeskrivningen.

bIsMenu
[i] SANT om knappbeskrivningen är för en popup-menyknapp; annars FALSKT.

Anmärkningar

CMFCRibbonBaseElement::OnDrawMenuImage

Anropas av ramverket när menybilden för menyelementet ritas.

virtual BOOL OnDrawMenuImage(
    CDC* pDC,
    CRect rect);

Parametrar

pDC-
[i] Pekare mot en enhetskontext.

rect
[i] Rektangel för menybild.

Returvärde

Returnerar alltid TRUE för att indikera att bilden ritades.

Anmärkningar

CMFCRibbonBaseElement::OnDrawOnList

Anropas av ramverket för att rita menyfliksområdet i en kommandolistruta.

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

Parametrar

pDC-
[i] Pekare till en enhetskontext för menyfliksområdets element.

strText
[i] Visningstexten.

nTextOffset
[i] Avstånd, i bildpunkter, från vänster sida av listrutan till visningstexten.

rect
[i] Visningsrektangeln för menyfliksområdet.

bIsSelected
[i] Den här parametern används inte.

bHighlighted
[i] Den här parametern används inte.

Anmärkningar

Kommandolistrutan visar menyflikselement så att användarna kan anpassa verktygsfältet för snabbåtkomst.

CMFCRibbonBaseElement::OnKey

Anropas av ramverket när användaren trycker på en knappbeskrivning och menyflikselementet har fokus.

virtual BOOL OnKey(BOOL bIsMenuKey);

Parametrar

bIsMenuKey
[i] SANT om knappbeskrivningen visar en popup-meny. annars FALSKT.

Returvärde

SANT om händelsen hanterades; annars FALSKT.

Anmärkningar

CMFCRibbonBaseElement::OnMenuKey

Anropas av ramverket när användaren trycker på en menyknappbeskrivning på huvudpanelen.

virtual BOOL OnMenuKey(UINT nUpperChar);

Parametrar

nUpperChar
[i] Den här parametern används inte.

Returvärde

Returnerar alltid FALSE.

Anmärkningar

Som standard returnerar den här metoden alltid FALSE. Åsidosätt den här metoden för att svara när en användare trycker på en menyknappbeskrivning på huvudpanelen.

CMFCRibbonBaseElement::OnProcessKey

Anropas av ramverket när användaren trycker på en genvägsnyckel.

virtual BOOL OnProcessKey(UINT nChar);

Parametrar

nChar
[i] Den här parametern används inte.

Returvärde

Returnerar alltid FALSE.

Anmärkningar

Åsidosätt den här metoden om du vill att menyflikselementet ska bearbeta en genvägsnyckel.

CMFCRibbonBaseElement::OnRTLChanged

Anropas av ramverket när layouten ändrar riktning.

virtual void OnRTLChanged(BOOL bIsRTL);

Parametrar

bIsRTL
[i] Den här parametern används inte.

Anmärkningar

Som standard gör den här metoden ingenting. Åsidosätt den här metoden för att justera menyfliksområdet när layouten ändrar riktning. Standardlayoutriktningen är från vänster till höger.

CMFCRibbonBaseElement::OnSetFocus

Anropas av ramverket när ett bandelement tar emot eller förlorar indatafokuset.

virtual void OnSetFocus(BOOL B);

Anmärkningar

Åsidosätt den här metoden i en härledd klass om du vill att programmet ska hantera en ändring i fokus för ett menyflikselement.

CMFCRibbonBaseElement::OnShow

Anropas av ramverket för att visa eller dölja menyflikselementet.

virtual void OnShow(BOOL bShow);

Parametrar

bShow
[i] Den här parametern används inte.

Anmärkningar

Som standard gör den här metoden ingenting. Åsidosätt den här metoden för att visa eller dölja menyflikselementet.

CMFCRibbonBaseElement::OnShowPopupMenu

Anropas av ramverket innan menyflikselementet visar en popup-meny.

virtual void OnShowPopupMenu();

Anmärkningar

Den här metoden meddelar det överordnade fönstret i menyfliksområdet att menyflikselementet visar en popup-meny.

CMFCRibbonBaseElement::P ostMenuCommand

Stänger popup-menyn för menyfliksområdet och skickar ett nära meddelande till den överordnade menyn.

void PostMenuCommand(UINT uiCmdId);

Parametrar

uiCmdId
[i] Parametern används inte.

Anmärkningar

Stängningsmeddelandet skickas endast om menyfliksområdet finns på en popup-meny.

CMFCRibbonBaseElement::Redraw

Uppdaterar visningen för menyflikselementet.

virtual void Redraw();

Anmärkningar

Den här metoden ritar om visningsrektangeln för menyflikselementet genom att anropa CWnd::RedrawWindow med RDW_INVALIDATE, RDW_ERASE och RDW_UPDATENOW flaggor inställda.

CMFCRibbonBaseElement::SetACCData

Anger hjälpmedelsdata för menyfliksområdets element.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parametrar

pParent
Det överordnade fönstret för menyfliksområdet.

data
Hjälpmedelsdata för menyfliksområdet.

Returvärde

Returnerar alltid TRUE.

Anmärkningar

Som standard anger den här metoden hjälpmedelsdata för menyflikselementet och returnerar alltid TRUE. Åsidosätt den här metoden för att ange hjälpmedelsdata och returnera ett värde som indikerar lyckad eller misslyckad.

CMFCRibbonBaseElement::SetCompactMode

Anger visningsstorleken för menyfliksområdets element.

virtual void SetCompactMode(BOOL bCompactMode = TRUE);

Parametrar

bCompactMode
[i] TRUE för att minska visningsstorleken för menyfliksområdet. FALSE för att öka visningsstorleken för menyfliksområdet.

Anmärkningar

I följande tabell sammanfattas logiken för den här metoden.

bCompactMode	Aktuell storlek på menyfliksområdets element	Ny storlek på menyfliksområdets element
SANN	Kompakt	Ingen ändring.
SANN	Intermediär	Kompakt om det är möjligt.
SANN	Stor	Mellanliggande om det är möjligt.
FALSK	Kompakt	Mellanliggande om det är möjligt; annars stor.

CMFCRibbonBaseElement::SetData

Associerar ett dataobjekt med menyfliksområdet.

void SetData(DWORD_PTR dwData);

Parametrar

dwData
[i] Datavärdet.

CMFCRibbonBaseElement::SetDefaultMenuLook

Anger att menyflikselementet ska visas som ett popup-kommando.

void SetDefaultMenuLook(BOOL bIsDefaultMenuLook = TRUE);

Parametrar

bIsDefaultMenuLook
[i] TRUE för att ange att menyflikselementet ska visas som ett popup-kommando. annars FALSKT.

Anmärkningar

CMFCRibbonBaseElement::SetDescription

Anger beskrivningen för menyflikselementet.

virtual void SetDescription(LPCTSTR lpszText);

Parametrar

lpszText
[i] Beskrivningen för menyflikselementet.

Anmärkningar

Ramverket visar den nya beskrivningen antingen i statusfältet eller i knappbeskrivningen eller under menyknappen.

CMFCRibbonBaseElement::SetID

Anger kommando-ID för menyflikselementet.

virtual void SetID(UINT nID);

Parametrar

nID
[i] Kommando-ID:t.

CMFCRibbonBaseElement::SetInitialMode

Anger den inledande visningsstorleken för menyfliksområdets element.

virtual void SetInitialMode(BOOL bOneRow = FALSE);

Parametrar

bOneRow
[i] TRUE för att begränsa visningsstorleken för menyfliksområdet till kompakt eller mellanliggande; annars FALSKT.

Anmärkningar

Visningsstorleken för bandelement kan vara kompakt, mellanliggande eller stor.

CMFCRibbonBaseElement::SetKeys

Anger knappbeskrivningarna för menyfliksområdets element.

virtual void SetKeys(
    LPCTSTR lpszKeys,
    LPCTSTR lpszMenuKeys=NULL);

Parametrar

lpszKeys
[i] Nyckelbeskrivningen för menyflikselementet.

lpszMenuKeys
[i] Nyckelbeskrivningen för popup-menyn i menyfliksområdet.

CMFCRibbonBaseElement::SetOriginal

Anger det ursprungliga menyflikselementet för menyflikselementet.

virtual void SetOriginal(CMFCRibbonBaseElement* pOriginal);

Parametrar

pOriginal
[i] Pekare till ett menyflikselement.

Anmärkningar

Bandelement som kopieras till en annan container behåller en pekare till det ursprungliga menyflikselementet.

CMFCRibbonBaseElement::SetParentCategory

Anger den överordnade kategorin för menyfliksområdet.

virtual void SetParentCategory(CMFCRibbonCategory* pParent);

Parametrar

pParent
[i] Pekare till en menyfliksområdeskategori.

Anmärkningar

Flikarna i menyflikskontroller kallas kategorier.

CMFCRibbonBaseElement::SetParentMenu

Anger den överordnade menycontainern för menyfliksområdet.

virtual void SetParentMenu(CMFCRibbonPanelMenuBar* pMenuBar);

Parametrar

pMenuBar
[i] Den överordnade menyn.

Anmärkningar

CMFCRibbonBaseElement::SetParentRibbonBar

Anger det överordnade menyfliksområdet för menyflikselementet.

virtual void SetParentRibbonBar(CMFCRibbonBar* pRibbonBar);

Parametrar

pRibbonBar
[i] Pekare till det överordnade menyfliksområdet.

Anmärkningar

CMFCRibbonBaseElement::SetRect

Anger dimensionerna för visningsrektangeln för menyflikselementet.

void SetRect(CRect rect);

Parametrar

rect
[i] Rektangelns dimensioner.

Anmärkningar

CMFCRibbonBaseElement::SetText

Anger text och nyckelbeskrivning för menyflikselementet.

virtual void SetText(LPCTSTR lpszText);

Parametrar

lpszText
[i] Text och nyckelbeskrivning för menyflikselementet.

Anmärkningar

Om du vill ange nyckelbeskrivningen för menyfliksområdet lägger du till den nya escape-sekvensen följt av nyckelbeskrivningstecken till lpszText.

Exempel

//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

Anger texten för menyflikselementet som ska visas till höger.

virtual void SetTextAlwaysOnRight(BOOL bSet = TRUE);

Parametrar

bSet
[i] TRUE för att visa texten till höger; annars FALSKT.

Anmärkningar

CMFCRibbonBaseElement::SetToolTipText

Anger knappbeskrivningstexten för menyflikselementet.

virtual void SetToolTipText(LPCTSTR lpszText);

Parametrar

lpszText
[i] Knappbeskrivningstexten.

CMFCRibbonBaseElement::SetVisible

Anger synligheten för menyflikselementet.

void SetVisible(BOOL bIsVisible);

Parametrar

bIsVisible
[i] TRUE för att visa menyflikselementet. FALSE för att dölja menyflikselementet.

Anmärkningar

CMFCRibbonBaseElement::StretchHorizontally

Sträcker ut bredden på menyfliksområdet.

virtual void StretchHorizontally();

Anmärkningar

Som standard genererar den här metoden ett kontrollfel i felsökningsversioner och bör därför inte anropas. Åsidosätt den här metoden för att sträcka ut bredden på menyflikselementet.

CMFCRibbonBaseElement::StretchToWholeRow

Ändrar visningshöjden för menyflikselementet till den angivna radhöjden.

virtual BOOL StretchToWholeRow(
    CDC* pDC,
    int nHeight);

Parametrar

pDC-
[i] Den här parametern används inte.

nHeight
[i] Höjden på raden.

Returvärde

SANT om visningshöjden har angetts. annars FALSKT.

Anmärkningar

Åsidosätt den här metoden för att ändra visningshöjden för menyflikselementet till den angivna radhöjden.

CMFCRibbonBaseElement::UpdateTooltipInfo

Uppdaterar knappbeskrivningstexten med hjälp av kommandoresursen för menyflikselementet.

virtual void UpdateTooltipInfo();

Anmärkningar

CMFCRibbonBaseElement::HasFocus

Anger om det överordnade elementet har tangentbordsfokus.

virtual BOOL HasFocus() const;

Dela via

CMFCRibbonBaseElement-klass

Syntax

Medlemmar

Offentliga konstruktorer

Offentliga metoder

Skyddade metoder

Anmärkningar

Exempel

Arvshierarki

Krav

CMFCRibbonBaseElement::AddToKeyList

Parametrar

Anmärkningar

CMFCRibbonBaseElement::AddToListBox

Parametrar

Returvärde

Anmärkningar

CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar

Returvärde

Anmärkningar

CMFCRibbonBaseElement::CanBeCompacted

Returvärde

Anmärkningar

CMFCRibbonBaseElement::CanBeStretched

Returvärde

Anmärkningar

CMFCRibbonBaseElement::CanBeStretchedHorizontally

Returvärde

Anmärkningar

CMFCRibbonBaseElement::CleanUpSizes

Anmärkningar

CMFCRibbonBaseElement::ClosePopupMenu

Anmärkningar

CMFCRibbonBaseElement::CopyFrom

Parametrar

Anmärkningar

CMFCRibbonBaseElement::D estroyCtrl

Anmärkningar

CMFCRibbonBaseElement::D rawImage

Parametrar

Anmärkningar

CMFCRibbonBaseElement::Find

Parametrar

Returvärde

Anmärkningar

CMFCRibbonBaseElement::FindByData

Parametrar

Returvärde

Anmärkningar

CMFCRibbonBaseElement::FindByID

Parametrar

Returvärde

Anmärkningar

CMFCRibbonBaseElement::FindByOriginal

Parametrar

Returvärde

Anmärkningar

CMFCRibbonBaseElement::GetCompactSize

Parametrar

Returvärde

CMFCRibbonBaseElement::GetData

Returvärde

CMFCRibbonBaseElement::GetDescription

Returvärde

CMFCRibbonBaseElement::GetDroppedDown

Returvärde

Anmärkningar

CMFCRibbonBaseElement::GetElements

Parametrar

Anmärkningar

CMFCRibbonBaseElement::GetElementsByID

Parametrar

Anmärkningar

CMFCRibbonBaseElement::GetHighlighted

Returvärde

Anmärkningar

CMFCRibbonBaseElement::GetID

Returvärde

CMFCRibbonBaseElement::GetImageSize