CMFCRibbonButtonsGroup-Klasse

Mit der CMFCRibbonButtonsGroup Klasse können Sie eine Gruppe von Menübandschaltflächen in einer Gruppe organisieren. Alle Schaltflächen der Gruppe liegen innerhalb eines Rahmens direkt horizontal nebeneinander.

Syntax

class CMFCRibbonButtonsGroup : public CMFCRibbonBaseElement

Member

Öffentliche Konstruktoren

Name Beschreibung
CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup Erstellt ein CMFCRibbonButtonsGroup-Objekt.

Öffentliche Methoden

Name Beschreibung
CMFCRibbonButtonsGroup::AddButton Fügt einer Gruppe eine Schaltfläche hinzu.
CMFCRibbonButtonsGroup::AddButtons Fügt einer Gruppe eine Liste von Schaltflächen hinzu.
CMFCRibbonButtonsGroup::GetButton Gibt einen Zeiger auf die Schaltfläche zurück, die sich an einem angegebenen Index befindet.
CMFCRibbonButtonsGroup::GetCount Gibt die Anzahl der Schaltflächen in der Gruppe zurück.
CMFCRibbonButtonsGroup::GetImageSize Gibt die Bildgröße der normalen Bilder in der Menübandgruppe zurück (überschreibt CMFCRibbonBaseElement::GetImageSize.)
CMFCRibbonButtonsGroup::GetRegularSize Gibt die normale Größe des Menübandelements zurück (überschreibt CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonButtonsGroup::HasImages Gibt an, ob das CMFCRibbonButtonsGroup Objekt Symbolleistenbilder enthält.
CMFCRibbonButtonsGroup::OnDrawImage Zeichnet das entsprechende Bild für eine angegebene Schaltfläche, je nachdem, ob die Schaltfläche normal, hervorgehoben oder deaktiviert ist.
CMFCRibbonButtonsGroup::RemoveAll Entfernt alle Schaltflächen aus dem CMFCRibbonButtonsGroup Objekt.
CMFCRibbonButtonsGroup::SetImages Weist der Gruppe Bilder zu.
CMFCRibbonButtonsGroup::SetParentCategory Legt das übergeordnete CMFCRibbonCategory CMFCRibbonButtonsGroup Objekt und alle darin enthaltenen Schaltflächen fest (setzt CMFCRibbonBaseElement::SetParentCategory außer Kraft.)

Hinweise

Die Gruppe wird von CMFCBaseRibbonElement abgeleitet und kann als einzelne Entität bearbeitet werden. Sie können die Gruppe in einem beliebigen Bereich oder Popupmenü positionieren.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung verschiedener Methoden in der CMFCRibbonButtonsGroup -Klasse. Das Beispiel zeigt, wie Sie ein CMFCRibbonButtonsGroup Objekt erstellen, der Gruppe der Menübandschaltflächen Bilder zuweisen und der Gruppe der Menübandschaltflächen eine Schaltfläche hinzufügen. Dieser Codeausschnitt ist Teil des Draw Client-Beispiels.

CMFCRibbonButtonsGroup *pSBGroup = new CMFCRibbonButtonsGroup;

CMFCToolBarImages images;
images.SetImageSize(CSize(14, 14));

CMFCToolBarImages hotimages;
hotimages.SetImageSize(CSize(14, 14));

if (images.Load(IDB_STATUSBAR_1) && hotimages.Load(IDB_STATUSBAR_2))
{
   pSBGroup->SetImages(&images, &hotimages, NULL);
}

pSBGroup->AddButton(new CMFCRibbonButton(ID_FILE_PRINT_PREVIEW, _T(""), 0));
pSBGroup->AddButton(new CMFCRibbonButton(ID_FILE_SUMMARYINFO, _T(""), 1));

// CMFCRibbonStatusBar m_wndStatusBar
m_wndStatusBar.AddExtendedElement(pSBGroup, _T("View Shortcuts"));

Vererbungshierarchie

CObject

CMFCRibbonBaseElement

CMFCRibbonButtonsGroup

Anforderungen

Header: afxribbonbuttonsgroup.h

CMFCRibbonButtonsGroup::AddButton

Fügt einer Gruppe eine Schaltfläche hinzu.

void AddButton(CMFCRibbonBaseElement* pButton);

Parameter

pButton
[in] Ein Zeiger auf eine Schaltfläche, die hinzugefügt werden soll.

CMFCRibbonButtonsGroup::AddButtons

Fügt einer Gruppe eine Liste von Schaltflächen hinzu.

void AddButtons(
    const CList<CMFCRibbonBaseElement*,CMFCRibbonBaseElement*>& lstButtons);

Parameter

lstButtons
[in] Eine Liste der Zeiger auf die Schaltflächen, die Sie hinzufügen möchten.

CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup

Erstellt ein CMFCRibbonButtonsGroup-Objekt.

CMFCRibbonButtonsGroup();
CMFCRibbonButtonsGroup(CMFCRibbonBaseElement* pButton);

Parameter

pButton
[in] Gibt eine Schaltfläche an, die dem neu erstellten CMFCRibbonButtonsGroup Objekt hinzugefügt werden soll.

Rückgabewert

Bemerkungen

CMFCRibbonButtonsGroup::GetButton

Gibt einen Zeiger auf die Schaltfläche zurück, die sich an einem angegebenen Index befindet.

CMFCRibbonBaseElement* GetButton(int i) const;

Parameter

i
[in] Ein nullbasierter Index einer Schaltfläche, die zurückgegeben werden soll.

Rückgabewert

Ein Zeiger auf die Schaltfläche, die sich am angegebenen Index befindet. NULL, wenn der angegebene Index außerhalb des Bereichs liegt.

Hinweise

CMFCRibbonButtonsGroup::GetCount

Gibt die Anzahl der Schaltflächen in der Gruppe zurück.

int GetCount() const;

Rückgabewert

Die Anzahl der Schaltflächen in der Gruppe.

CMFCRibbonButtonsGroup::GetImageSize

Ruft die Quellbildgröße des geschützten CMFCToolBarImages Elements m_Imagesab.

const CSize GetImageSize() const;

Rückgabewert

Gibt die Quellbildgröße der Symbolleistenbilder zurück, falls vorhanden, oder eine CSize von Null, wenn dies nicht der Fall ist.

Hinweise

CMFCRibbonButtonsGroup::GetRegularSize

Ruft die maximal mögliche Größe des Menübandgruppenelements ab.

virtual CSize GetRegularSize(CDC* pDC);

Parameter

pDC
[in] Zeigen Sie auf den Gerätekontext der Menübandgruppe.

Rückgabewert

Bemerkungen

CMFCRibbonButtonsGroup::HasImages

Gibt an, ob das CMFCRibbonButtonsGroup Objekt Symbolleistenbilder enthält.

BOOL HasImages() const;

Rückgabewert

Gibt WAHR zurück, wenn das geschützte CMFCToolBarImages Element m_Images Bilder oder FALSE enthält, wenn dies nicht der Fall ist.

Hinweise

CMFCRibbonButtonsGroup::OnDrawImage

Zeichnet das entsprechende Bild für eine angegebene Schaltfläche, je nachdem, ob die Schaltfläche normal, hervorgehoben oder deaktiviert ist.

virtual void OnDrawImage(
    CDC* pDC,
    CRect rectImage,
    CMFCRibbonBaseElement* pButton,
    int nImageIndex);

Parameter

pDC
[in] Zeiger auf den Gerätekontext des CMFCRibbonButtonsGroup Objekts.

rectImage
[in] Das Rechteck, in dem das Bild gezeichnet werden soll.

pButton
[in] Die Schaltfläche, für die das Bild gezeichnet werden soll.

nImageIndex
[in] Der Index des Bilds, das auf der Schaltfläche gezeichnet werden soll (in einem der drei Bildarrays für normale, hervorgehobene oder deaktivierte Schaltflächen).

Hinweise

CMFCRibbonButtonsGroup::RemoveAll

Entfernt alle Schaltflächen aus dem CMFCRibbonButtonsGroup Objekt.

void RemoveAll();

Hinweise

CMFCRibbonButtonsGroup::SetImages

Weist der Gruppe der Menübandschaltflächen Bilder zu.

void SetImages(
    CMFCToolBarImages* pImages,
    CMFCToolBarImages* pHotImages,
    CMFCToolBarImages* pDisabledImages);

Parameter

pImages
[in] Normale Bilder.

pHotImages
[in] Heiße Bilder.

pDisabledImages
[in] Deaktivierte Bilder.

Hinweise

Rufen Sie auf SetImages , bevor Sie einer Gruppe Schaltflächen hinzufügen. Die Anzahl der Bilder muss größer oder gleich der Anzahl der Schaltflächen sein, die der Gruppe hinzugefügt werden sollen.

Hinweis

Hot images are images that are displayed when the user hovers over the button. Deaktivierte Bilder sind Bilder, die angezeigt werden, wenn die Schaltfläche deaktiviert ist.

CMFCRibbonButtonsGroup::SetParentCategory

Legt das übergeordnete CMFCRibbonCategory CMFCRibbonButtonsGroup Objekt und alle darin enthaltenen Schaltflächen fest.

virtual void SetParentCategory(CMFCRibbonCategory* pCategory);

Parameter

pCategory
[in] Zeiger auf die festzulegende übergeordnete Kategorie (die Registerkartengruppen in Menübandsteuerelementen werden als Kategorien bezeichnet).

Hinweise

Weitere Informationen

Hierarchiediagramm
Klassen