CMFCRibbonButtonsGroup – třída

Třída CMFCRibbonButtonsGroup umožňuje uspořádat sadu tlačítek pásu karet do skupiny. Všechna tlačítka ve skupině jsou přímo vedle sebe vodorovně a uzavřená v ohraničení.

Syntaxe

class CMFCRibbonButtonsGroup : public CMFCRibbonBaseElement

Členové

Veřejné konstruktory

Název	Popis
CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup	CMFCRibbonButtonsGroup Vytvoří objekt.

Veřejné metody

Název	Popis
CMFCRibbonButtonsGroup::AddButton	Přidá tlačítko do skupiny.
CMFCRibbonButtonsGroup::AddButtons	Přidá do skupiny seznam tlačítek.
CMFCRibbonButtonsGroup::GetButton	Vrátí ukazatel na tlačítko umístěné v zadaném indexu.
CMFCRibbonButtonsGroup::GetCount	Vrátí počet tlačítek ve skupině.
CMFCRibbonButtonsGroup::GetImageSize	Vrátí velikost obrázku normálních obrázků ve skupině pásu karet (přepíše CMFCRibbonBaseElement::GetImageSize.)
CMFCRibbonButtonsGroup::GetRegularSize	Vrátí běžnou velikost prvku pásu karet (přepisuje CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonButtonsGroup::HasImages	Zaznamenává, zda CMFCRibbonButtonsGroup objekt obsahuje obrázky panelu nástrojů.
CMFCRibbonButtonsGroup::OnDrawImage	Nakreslí příslušný obrázek pro zadané tlačítko v závislosti na tom, jestli je tlačítko normální, zvýrazněné nebo zakázané.
CMFCRibbonButtonsGroup::RemoveAll	Odebere všechna tlačítka z objektu CMFCRibbonButtonsGroup .
CMFCRibbonButtonsGroup::SetImages	Přiřadí obrázky ke skupině.
CMFCRibbonButtonsGroup::SetParentCategory	Nastaví nadřazený CMFCRibbonCategory CMFCRibbonButtonsGroup objekt a všechna tlačítka v něm (přepíše CMFCRibbonBaseElement::SetParentCategory.)

Poznámky

Skupina je odvozena z CMFCBaseRibbonElement a může být manipulována jako jedna entita. Skupinu můžete umístit na libovolný panel nebo místní nabídku.

Příklad

Následující příklad ukazuje, jak používat různé metody ve CMFCRibbonButtonsGroup třídě. Příklad ukazuje, jak vytvořit CMFCRibbonButtonsGroup objekt, přiřadit obrázky skupině tlačítek pásu karet a přidat tlačítko do skupiny tlačítek pásu karet. Tento fragment kódu je součástí ukázky Klienta kreslení.

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

Hierarchie dědičnosti

Objekt CObject

CMFCRibbonBaseElement

CMFCRibbonButtonsGroup

Požadavky

Hlavička: afxribbonbuttonsgroup.h

CMFCRibbonButtonsGroup::AddButton

Přidá tlačítko do skupiny.

void AddButton(CMFCRibbonBaseElement* pButton);

Parametry

pButton
[v] Ukazatel na tlačítko, které chcete přidat.

CMFCRibbonButtonsGroup::AddButtons

Přidá do skupiny seznam tlačítek.

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

Parametry

lstButtons
[v] Seznam ukazatelů na tlačítka, která chcete přidat.

CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup

CMFCRibbonButtonsGroup Vytvoří objekt.

CMFCRibbonButtonsGroup();
CMFCRibbonButtonsGroup(CMFCRibbonBaseElement* pButton);

Parametry

pButton
[v] Určuje tlačítko pro přidání do nově vytvořeného CMFCRibbonButtonsGroup objektu.

Návratová hodnota

Poznámky

CMFCRibbonButtonsGroup::GetButton

Vrátí ukazatel na tlačítko umístěné v zadaném indexu.

CMFCRibbonBaseElement* GetButton(int i) const;

Parametry

já
[v] Index tlačítka založený na nule, který se má vrátit.

Návratová hodnota

Ukazatel na tlačítko umístěné v zadaném indexu. Hodnota NULL, pokud zadaný index není v rozsahu.

Poznámky

CMFCRibbonButtonsGroup::GetCount

Vrátí počet tlačítek ve skupině.

int GetCount() const;

Návratová hodnota

Počet tlačítek ve skupině

CMFCRibbonButtonsGroup::GetImageSize

Načte zdrojovou velikost image chráněného CMFCToolBarImages člena m_Images.

const CSize GetImageSize() const;

Návratová hodnota

Vrátí velikost zdrojového obrázku obrázků panelu nástrojů, pokud jsou k dispozici, nebo nula CSize , pokud ne.

Poznámky

CMFCRibbonButtonsGroup::GetRegularSize

Načte maximální možnou velikost prvku skupiny pásu karet.

virtual CSize GetRegularSize(CDC* pDC);

Parametry

pDC
[v] Ukazatel na kontext zařízení ve skupině pásu karet

Návratová hodnota

Poznámky

CMFCRibbonButtonsGroup::HasImages

Zaznamenává, zda CMFCRibbonButtonsGroup objekt obsahuje obrázky panelu nástrojů.

BOOL HasImages() const;

Návratová hodnota

Vrátí hodnotu TRUE, pokud chráněný CMFCToolBarImages člen m_Images obsahuje jakékoli obrázky nebo NEPRAVDA, pokud ne.

Poznámky

CMFCRibbonButtonsGroup::OnDrawImage

Nakreslí příslušný obrázek pro zadané tlačítko v závislosti na tom, jestli je tlačítko normální, zvýrazněné nebo zakázané.

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

Parametry

pDC
[v] Ukazatel na kontext zařízení objektu CMFCRibbonButtonsGroup .

rectImage
[v] Obdélník, ve kterém chcete obrázek nakreslit.

pButton
[v] Tlačítko, pro které chcete obrázek nakreslit.

nImageIndex
[v] Index obrázku, který chcete nakreslit na tlačítko (v jednom ze tří polí obrázků pro normální, zvýrazněná nebo zakázaná tlačítka).

Poznámky

CMFCRibbonButtonsGroup::RemoveAll

Odebere všechna tlačítka z objektu CMFCRibbonButtonsGroup .

void RemoveAll();

Poznámky

CMFCRibbonButtonsGroup::SetImages

Přiřadí obrázky skupině tlačítek na pásu karet.

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

Parametry

pImages
[v] Běžné obrázky.

pHotImages
[v] Horké obrázky.

pDisabledImages
[v] Zakázané obrázky.

Poznámky

Před přidáním tlačítek do skupiny zavolejte SetImages . Počet obrázků musí být větší nebo roven počtu tlačítek, která se mají přidat do skupiny.

Poznámka:

Horké obrázky jsou obrázky, které se zobrazí, když uživatel na tlačítko najede myší. Zakázané obrázky jsou obrázky, které se zobrazí, když je tlačítko zakázané.

CMFCRibbonButtonsGroup::SetParentCategory

Nastaví nadřazený CMFCRibbonCategory CMFCRibbonButtonsGroup objekt a všechna tlačítka v něm.

virtual void SetParentCategory(CMFCRibbonCategory* pCategory);

Parametry

pCategory
[v] Ukazatel na nadřazenou kategorii, která se má nastavit (skupiny s kartami v ovládacích prvcích pásu karet se nazývají kategorie).

Poznámky

Viz také

Graf hierarchie
Třídy