CMFCRibbonButton osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Az CMFCRibbonButton osztály olyan gombokat implementál, amelyeket elhelyezhet a menüszalagsáv elemein, például a paneleken, a gyorselérési eszköztárakon és az előugró menükben.

További részletekért tekintse meg a Visual Studio-telepítés VC\atlmfc\src\mfc mappájában található forráskódot.

Szemantika

class CMFCRibbonButton : public CMFCRibbonBaseElement

Tagok

Nyilvános konstruktorok

Név	Description
CMFCRibbonButton::CMFCRibbonButton	Menüszalag gombobjektumot hoz létre.

Nyilvános metódusok

Név	Description
CMFCRibbonButton::AddSubItem	Hozzáad egy menüelemet a gombhoz társított előugró menühöz.
CMFCRibbonButton::CanBeStretched	(Felülbírálja a CMFCRibbonBaseElement::CanBeStretched.)
CMFCRibbonButton::CleanUpSizes	(Felülbírálja a CMFCRibbonBaseElement::CleanUpSizes.)
CMFCRibbonButton::ClosePopupMenu	(Felülbírálja a CMFCRibbonBaseElement::ClosePopupMenu.)
CMFCRibbonButton::D rawBottomText
CMFCRibbonButton::D rawImage	(Felülbírálja a CMFCRibbonBaseElement::D rawImage.)
CMFCRibbonButton::D rawRibbonText
CMFCRibbonButton::FindSubItemIndexByID	A megadott parancsazonosítóhoz társított előugró menüelem indexét adja vissza.
CMFCRibbonButton::GetCommandRect
CMFCRibbonButton::GetCompactSize	A menüszalag elem kompakt méretét adja vissza. (Felülbírálja a CMFCRibbonBaseElement::GetCompactSize.)
CMFCRibbonButton::GetIcon
CMFCRibbonButton::GetImageIndex	A gombhoz társított kép indexét adja vissza.
CMFCRibbonButton::GetImageSize	A menüszalag elem képméretét adja vissza. (Felülbírálja a CMFCRibbonBaseElement::GetImageSize.)
CMFCRibbonButton::GetIntermediateSize	A menüszalag elemének méretét adja vissza a köztes állapotában. (Felülbírálja a CMFCRibbonBaseElement::GetIntermediateSize.)
CMFCRibbonButton::GetMenu	Egy fogópontot ad vissza egy Windows-menünek, amely a menüszalag gombhoz van rendelve.
CMFCRibbonButton::GetMenuRect
CMFCRibbonButton::GetRegularSize	A menüszalag elemének normál méretét adja vissza. (Felülbírálja a CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonButton::GetSubItems
CMFCRibbonButton::GetTextRowHeight
CMFCRibbonButton::GetToolTipText	A menüszalag elemleírásának szövegét adja vissza. (Felülbírálja a CMFCRibbonBaseElement::GetToolTipText.)
CMFCRibbonButton::HasCompactMode	Azt határozza meg, hogy a menüszalag elem kompakt üzemmóddal rendelkezik-e. (Felülbírálja a CMFCRibbonBaseElement::HasCompactMode.)
CMFCRibbonButton::HasIntermediateMode	Azt határozza meg, hogy a menüszalag elemének van-e köztes módja. (Felülbírálja a CMFCRibbonBaseElement::HasIntermediateMode.)
CMFCRibbonButton::HasLargeMode	Meghatározza, hogy a szalagelem rendelkezik-e nagy módban. (Felülbírálja a CMFCRibbonBaseElement::HasLargeMode.)
CMFCRibbonButton::HasMenu	(Felülbírálja a CMFCRibbonBaseElement::HasMenu.)
CMFCRibbonButton::IsAlwaysDrawBorder
CMFCRibbonButton::IsAlwaysLargeImage	(Felülbírálja a CMFCRibbonBaseElement::IsAlwaysLargeImage.)
CMFCRibbonButton::IsApplicationButton
CMFCRibbonButton::IsCommandAreaHighlighted
CMFCRibbonButton::IsDefaultCommand	Meghatározza, hogy engedélyezte-e egy menüszalaggomb alapértelmezett parancsát.
CMFCRibbonButton::IsDefaultPanelButton
CMFCRibbonButton::IsDrawTooltipImage
CMFCRibbonButton::IsLargeImage
CMFCRibbonButton::IsMenuAreaHighlighted
CMFCRibbonButton::IsMenuOnBottom
CMFCRibbonButton::IsPopupDefaultMenuLook
CMFCRibbonButton::IsRightAlignMenu	Meghatározza, hogy a menü megfelelően van-e igazítva.
CMFCRibbonButton::IsSingleLineText
CMFCRibbonButton::OnCalcTextSize	(Felülbírálja a CMFCRibbonBaseElement::OnCalcTextSize.)
CMFCRibbonButton::OnDrawBorder
CMFCRibbonButton::OnDraw	A keretrendszer meghívta a menüszalag elemének rajzolásához. (Felülbírálja a CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonButton::OnFillBackground
CMFCRibbonButton::RemoveAllSubItems	Eltávolítja az összes menüelemet az előugró menüből.
CMFCRibbonButton::RemoveSubItem	Eltávolít egy menüelemet az előugró menüből.
CMFCRibbonButton::SetACCData	(Felülbírálja a CMFCRibbonBaseElement::SetACCData.)
CMFCRibbonButton::SetAlwaysLargeImage	Megadja, hogy a gomb nagy vagy kis méretű képet jelenít-e meg, amikor a felhasználó összecsukja a gombot.
CMFCRibbonButton::SetDefaultCommand	Engedélyezi a menüszalag gomb alapértelmezett parancsát.
CMFCRibbonButton::SetDescription	Beállítja a menüszalag elemének leírását. (Felülbírálja a CMFCRibbonBaseElement::SetDescription parancsot.)
CMFCRibbonButton::SetImageIndex	Indexet rendel a gomb képéhez.
CMFCRibbonButton::SetMenu	Előugró menü hozzárendelése a menüszalag gombjához.
CMFCRibbonButton::SetParentCategory	(Felülbírálja a CMFCRibbonBaseElement::SetParentCategory.)
CMFCRibbonButton::SetRightAlignMenu	Az előugró menü igazítása a gombtól jobbra.
CMFCRibbonButton::SetText	Beállítja a menüszalag elemének szövegét. (Felülbírálja a CMFCRibbonBaseElement::SetText.)

Védett metódusok

Név	Description
CMFCRibbonButton::OnClick	A keretrendszer meghívta, amikor a felhasználó a gombra kattint.

Example

Az alábbi példa bemutatja, hogyan használható a különböző metódusok az CMFCRibbonButton osztályban. A példa bemutatja, hogyan hozhat létre egy objektumot az CMFCRibbonButton osztályban, rendelhet hozzá egy előugró menüt a menüszalag gombjához, hogyan állíthatja be a gomb leírását, hogyan távolíthat el egy menüelemet az előugró menüből, és hogyan igazíthatja jobbra az előugró menüt a gomb széléhez.

strTemp.LoadString(IDS_RIBBON_STYLE);
// The first parameter is the command ID of the button.
// The third parameter is a zero-based index of the button's small image in the
// image list of the parent category.
// The fourth parameter is a zero-based index of the button's large image in the
// image list of the parent category.
CMFCRibbonButton *pVisualStyleButton = new CMFCRibbonButton(1, strTemp, -1, -1);

pVisualStyleButton->SetMenu(IDR_THEME_MENU, TRUE, TRUE);

strTemp.LoadString(IDS_RIBBON_STYLE_TIP);
pVisualStyleButton->SetToolTipText(strTemp);
strTemp.LoadString(IDS_RIBBON_STYLE_DESC);
pVisualStyleButton->SetDescription(strTemp);
pVisualStyleButton->RemoveSubItem(0);
pVisualStyleButton->SetRightAlignMenu(TRUE);

Megjegyzések

Ha menüszalaggombot szeretne használni egy alkalmazásban, hozza létre a gombobjektumot, és adja hozzá a megfelelő menüszalagpanelhez.

CMFCRibbonPanel* pPanel = pCategory->AddPanel (
    _T("Clipboard"), // Panel name
    m_PanelIcons.ExtractIcon (0)); // Panel icon

// Create the first button ("Paste"):
CMFCRibbonButton* pPasteButton =
    new CMFCRibbonButton (ID_EDIT_PASTE, _T("Paste"), -1, 0);

// The third parameter (-1) disables small images for button.
// This button is always displayed with a large image
// Associate a pop-up menu with the "Paste" button:
pPasteButton->SetMenu (IDR_CONTEXT_MENU);

// Add buttons to the panel. These buttons have only small images.
pPanel->Add (new CMFCRibbonButton (ID_EDIT_CUT, _T("Cut"), 1));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_COPY, _T("Copy"), 2));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_PAINT, _T("Paint"), 9));

Öröklési hierarchia

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

Requirements

Fejléc: afxribbonbutton.h

CMFCRibbonButton::AddSubItem

Hozzáad egy menüelemet a gombhoz társított előugró menühöz.

void AddSubItem(
    CMFCRibbonBaseElement* pSubItem,
    int nIndex=-1);

Paraméterek

pSubItem
[in] A hozzáadni kívánt új elemre mutató mutatót ad meg.

nIndex
[in] Azt az indexet adja meg, amelynél az elemet hozzá szeretné adni a gomb menüelemeinek tömbhöz; -1 a menüelemek tömbjének végén lévő elem hozzáadásához.

CMFCRibbonButton::CanBeStretched

virtual BOOL CanBeStretched();

Visszaadott érték

Megjegyzések

CMFCRibbonButton::CleanUpSizes

virtual void CleanUpSizes();

Megjegyzések

CMFCRibbonButton::ClosePopupMenu

virtual void ClosePopupMenu();

Megjegyzések

CMFCRibbonButton::CMFCRibbonButton

Menüszalag gombobjektumot hoz létre.

CMFCRibbonButton(
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex=-1,
    int nLargeImageIndex=-1,
    BOOL bAlwaysShowDescription=FALSE);

CMFCRibbonButton(
    UINT nID,
    LPCTSTR lpszText,
    HICON hIcon,
    BOOL bAlwaysShowDescription=FALSE,
    HICON hIconSmall=NULL,
    BOOL bAutoDestroyIcon=FALSE,
    BOOL bAlphaBlendIcon=FALSE);

Paraméterek

nID
[in] Megadja a gomb parancsazonosítóját.

lpszText
[in] Megadja a gomb szövegfeliratát.

nSmallImageIndex
[in] A gomb kis képének nulla alapú indexét adja meg a szülőkategória képlistájában.

nLargeImageIndex
[in] A gomb nagyméretű képének nulla alapú indexét adja meg a szülőkategória képlistájában.

hIcon
[in] Megadja az alkalmazás által a gomb képeként használt ikon leíróját.

Example

Az alábbi példa bemutatja, hogyan hozhat létre objektumot CMFCRibbonButton .

strTemp.LoadString(IDS_RIBBON_CUT);
CMFCRibbonButton *butn = new CMFCRibbonButton(ID_EDIT_CUT, strTemp, 1);
butn->SetKeys(_T("k"));

CMFCRibbonButton::D rawBottomText

CSize DrawBottomText(
    CDC* pDC,
    BOOL bCalcOnly);

Paraméterek

[in] Pdc
[in] bCalcOnly

Visszaadott érték

Megjegyzések

CMFCRibbonButton::D rawImage

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

Paraméterek

[in] Pdc
[in] Típus
[in] rectImage

Megjegyzések

CMFCRibbonButton::D rawRibbonText

virtual int DrawRibbonText(
    CDC* pDC,
    const CString& strText,
    CRect rectText,
    UINT uiDTFlags,
    COLORREF clrText = (COLORREF)-1);

Paraméterek

[in] Pdc
[in] strText
[in] rectText
[in] uiDTFlags
[in] clrText

Visszaadott érték

Megjegyzések

CMFCRibbonButton::FindSubItemIndexByID

A megadott parancsazonosítóhoz társított előugró menüelem indexét adja vissza.

int FindSubItemIndexByID(UINT uiID) const;

Paraméterek

uiID
[in] Megadja az előugró menüelem parancsazonosítóját.

Visszaadott érték

A uiID-hez társított alelem nullaalapú indexe. -1, ha nincs ilyen alelem.

CMFCRibbonButton::GetCommandRect

CRect GetCommandRect() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::GetCompactSize

virtual CSize GetCompactSize(CDC* pDC);

Paraméterek

[in] Pdc

Visszaadott érték

Megjegyzések

CMFCRibbonButton::GetIcon

HICON GetIcon(BOOL bLargeIcon = TRUE) const;

Paraméterek

[in] bLargeIcon

Visszaadott érték

Megjegyzések

CMFCRibbonButton::GetImageIndex

A gombhoz társított kép indexét adja vissza.

int GetImageIndex(BOOL bLargeImage) const;

Paraméterek

bLargeImage
[in] Ha IGAZ, a nagyméretű képeket tartalmazó képlistában szereplő képindexet adja vissza; ellenkező esetben visszaadja a képindexet a kis képeket tartalmazó képlistában.

Visszaadott érték

A gomb képének indexe a társított képlistában.

CMFCRibbonButton::GetImageSize

virtual CSize GetImageSize(RibbonImageType type) const;

Paraméterek

[in] Típus

Visszaadott érték

Megjegyzések

CMFCRibbonButton::GetIntermediateSize

virtual CSize GetIntermediateSize(CDC* pDC);

Paraméterek

[in] Pdc

Visszaadott érték

Megjegyzések

CMFCRibbonButton::GetMenu

Egy fogópontot ad vissza egy Windows-menünek, amely a menüszalag gombhoz van rendelve.

HMENU GetMenu() const;

Visszaadott érték

A gombhoz rendelt Windows-menü fogópontja; NULL érték, ha nincs hozzárendelve menü.

CMFCRibbonButton::GetMenuRect

CRect GetMenuRect() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::GetRegularSize

virtual CSize GetRegularSize(CDC* pDC);

Paraméterek

[in] Pdc

Visszaadott érték

Megjegyzések

CMFCRibbonButton::GetSubItems

const CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& GetSubItems() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::GetTextRowHeight

int GetTextRowHeight() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::GetToolTipText

virtual CString GetToolTipText() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::HasCompactMode

virtual BOOL HasCompactMode() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::HasIntermediateMode

virtual BOOL HasIntermediateMode() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::HasLargeMode

virtual BOOL HasLargeMode() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::HasMenu

virtual BOOL HasMenu() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::IsAlwaysDrawBorder

virtual BOOL IsAlwaysDrawBorder() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::IsAlwaysLargeImage

virtual BOOL IsAlwaysLargeImage() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::IsApplicationButton

virtual BOOL IsApplicationButton() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::IsCommandAreaHighlighted

virtual BOOL IsCommandAreaHighlighted() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::IsDefaultCommand

Megadja, hogy engedélyezve van-e egy menüszalaggomb alapértelmezett parancsa.

BOOL IsDefaultCommand() const;

Visszaadott érték

IGAZ, ha engedélyezte egy menüszalaggomb alapértelmezett parancsát; HAMIS egyéb esetben.

CMFCRibbonButton::IsDefaultPanelButton

virtual BOOL IsDefaultPanelButton() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::IsDrawTooltipImage

virtual BOOL IsDrawTooltipImage() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::IsLargeImage

BOOL IsLargeImage() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::IsMenuAreaHighlighted

virtual BOOL IsMenuAreaHighlighted() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::IsMenuOnBottom

BOOL IsMenuOnBottom() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::IsPopupDefaultMenuLook

virtual BOOL IsPopupDefaultMenuLook() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::IsRightAlignMenu

Megadja, hogy a menü jobbra van-e igazítva.

BOOL IsRightAlignMenu() const;

Visszaadott érték

IGAZ, ha a menü jobbra van igazítva; egyéb esetben HAMIS.

CMFCRibbonButton::IsSingleLineText

BOOL IsSingleLineText() const;

Visszaadott érték

Megjegyzések

CMFCRibbonButton::OnCalcTextSize

virtual void OnCalcTextSize(CDC* pDC);

Paraméterek

[in] Pdc

Megjegyzések

CMFCRibbonButton::OnClick

A keretrendszer meghívta, amikor a felhasználó a gombra kattint.

virtual void OnClick(CPoint point);

Paraméterek

Pont
[in] Az egérkattintás helyét adja meg.

Megjegyzések

Bírálja felül ezt a metódust egy származtatott osztályban, ha kezelni szeretné ezt az eseményt.

CMFCRibbonButton::OnDraw

virtual void OnDraw(CDC* pDC);

Paraméterek

[in] Pdc

Megjegyzések

CMFCRibbonButton::OnDrawBorder

virtual void OnDrawBorder(CDC* pDC);

Paraméterek

[in] Pdc

Megjegyzések

CMFCRibbonButton::OnFillBackground

virtual COLORREF OnFillBackground(CDC* pDC);

Paraméterek

[in] Pdc

Visszaadott érték

Megjegyzések

CMFCRibbonButton::RemoveAllSubItems

Eltávolítja az összes menüelemet az előugró menüből.

void RemoveAllSubItems();

CMFCRibbonButton::RemoveSubItem

Eltávolít egy menüelemet az előugró menüből.

BOOL RemoveSubItem(int nIndex);

Paraméterek

nIndex
[in] Megadja az eltávolítani kívánt menüelem nullaalapú indexét.

Visszaadott érték

IGAZ, ha a megadott elemet sikeresen eltávolították; ellenkező esetben HAMIS, ha az nIndex negatív vagy meghaladja az előugró menüben lévő menüelemek számát.

CMFCRibbonButton::SetACCData

Beállítja a menüszalag gomb akadálymentességi adatait.

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

Paraméterek

pParent
A menüszalag elemének szülőablaka.

adat
A menüszalag elemének akadálymentességi adatai.

Visszaadott érték

Igaz értéket ad vissza, ha sikeres; egyéb esetben HAMIS.

Megjegyzések

CMFCRibbonButton::SetAlwaysLargeImage

Megadja, hogy a gomb nagy vagy kis méretű képet jelenít-e meg, amikor a felhasználó összecsukja a gombot.

void SetAlwaysLargeImage(BOOL bSet=TRUE);

Paraméterek

bSet
[in] Ha IGAZ, a gomb egy nagy képet jelenít meg. Ellenkező esetben a gomb egy kis képet jelenít meg.

CMFCRibbonButton::SetDefaultCommand

Engedélyezi a menüszalag gomb alapértelmezett parancsát.

void SetDefaultCommand(BOOL bSet=TRUE);

Paraméterek

bSet
[in] Ha IGAZ, a gomb végrehajthatja az alapértelmezett parancsot. Ha HAMIS, a gomb nem tudja végrehajtani az alapértelmezett parancsot.

Megjegyzések

A bSet csak akkor releváns, ha a gomb rendelkezik menüvel. Ha a bSet ÉRTÉKE IGAZ, a gomb végrehajthatja az alapértelmezett parancsot, és a hozzárendelt előugró menü csak akkor jelenik meg, ha a felhasználó a gomb jobb szélén lévő nyílra kattint. Ellenkező esetben a gomb nem tudja végrehajtani az alapértelmezett parancsot, és az előugró menü attól függetlenül megjelenik, hogy a felhasználó melyik területre kattint.

CMFCRibbonButton::SetDescription

virtual void SetDescription(LPCTSTR lpszText);

Paraméterek

[in] lpszText

Megjegyzések

CMFCRibbonButton::SetImageIndex

Indexet rendel a gomb képéhez.

void SetImageIndex(
    int nIndex,
    BOOL bLargeImage);

Paraméterek

nIndex
[in] A képindexet adja meg.

bLargeImage
[in] Ha IGAZ, a megadott index a nagyméretű képek listájára hivatkozik. Ellenkező esetben az index a kis képek listájára hivatkozik.

CMFCRibbonButton::SetMenu

Előugró menü hozzárendelése a menüszalag gombjához.

void SetMenu(
    HMENU hMenu,
    BOOL bIsDefaultCommand=FALSE,
    BOOL bRightAlign=FALSE);

void SetMenu(
    UINT uiMenuResID,
    BOOL bIsDefaultCommand=FALSE,
    BOOL bRightAlign=FALSE);

Paraméterek

hMenu
Egy Windows-menü fogópontja.

bIsDefaultCommand
Ha IGAZ, a gomb végrehajthatja az alapértelmezett parancsot; ellenkező esetben a gomb egy előugró menüt jelenít meg.

bRightAlign
Ha IGAZ, a menü jobbra van igazítva. Ellenkező esetben a menü balra van igazítva.

uiMenuResID
Egy menüerőforrás-azonosító.

Megjegyzések

Amikor az alkalmazás hozzárendeli a menüt a gombhoz, a gomb egy nyíllal jelenik meg a jobb oldalán. Ha a bIsDefaultCommand értéke IGAZ, a menü csak akkor jelenik meg, ha a felhasználó a nyílra kattint. Ha a felhasználó a gombra kattint, a rendszer végrehajtja az alapértelmezett parancsot. Ha a bIsDefaultCommand ÉRTÉKE HAMIS, a menü a gomb tetszőleges pontjára kattintva jelenik meg.

CMFCRibbonButton::SetParentCategory

virtual void SetParentCategory(CMFCRibbonCategory* pParent);

Paraméterek

[in] pParent

Megjegyzések

CMFCRibbonButton::SetRightAlignMenu

Az előugró menüt a gomb széléhez igazítja.

void SetRightAlignMenu(BOOL bSet=TRUE);

Paraméterek

bSet
[in] Ha IGAZ, a menü jobbra van igazítva. Ellenkező esetben a menü balra van igazítva

CMFCRibbonButton::SetText

virtual void SetText(LPCTSTR lpszText);

Paraméterek

[in] lpszText

Megjegyzések

Lásd még

hierarchiadiagram
osztályok