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
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).