Klasse CMFCRibbonButtonsGroup

Met CMFCRibbonButtonsGroup de klas kunt u een set lintknoppen indelen in een groep. Alle knoppen in de groep staan direct aan elkaar grenzen horizontaal en tussen een rand.

Syntaxis

class CMFCRibbonButtonsGroup : public CMFCRibbonBaseElement

Leden

Openbare constructors

Openbare methoden

Opmerkingen

De groep is afgeleid van CMFCBaseRibbonElement en kan worden bewerkt als één entiteit. U kunt de groep in elk deelvenster of pop-upmenu plaatsen.

Example

In het volgende voorbeeld ziet u hoe u verschillende methoden in de CMFCRibbonButtonsGroup klasse gebruikt. In het voorbeeld ziet u hoe u een CMFCRibbonButtonsGroup object maakt, afbeeldingen toewijst aan de groep lintknoppen en een knop toevoegt aan de groep lintknoppen. Dit codefragment maakt deel uit van het voorbeeld van de draw-client.

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

Overnamehiërarchie

CObject

CMFCRibbonBaseElement

CMFCRibbonButtonsGroup

Requirements

Koptekst: afxribbonbuttonsgroup.h

CMFCRibbonButtonsGroup::AddButton

Hiermee voegt u een knop toe aan een groep.

void AddButton(CMFCRibbonBaseElement* pButton);

Parameterwaarden

pButton
[in] Een aanwijzer naar een knop die u wilt toevoegen.

CMFCRibbonButtonsGroup::AddButtons

Hiermee voegt u een lijst met knoppen toe aan een groep.

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

Parameterwaarden

lstButtons
[in] Een lijst met aanwijzers naar de knoppen die u wilt toevoegen.

CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup

Maakt een CMFCRibbonButtonsGroup object.

CMFCRibbonButtonsGroup();
CMFCRibbonButtonsGroup(CMFCRibbonBaseElement* pButton);

Parameterwaarden

pButton
[in] Hiermee geeft u een knop op die moet worden toegevoegd aan het zojuist gemaakte CMFCRibbonButtonsGroup object.

Retourwaarde

Opmerkingen

CMFCRibbonButtonsGroup::GetButton

Hiermee wordt een aanwijzer geretourneerd naar de knop die zich in een opgegeven index bevindt.

CMFCRibbonBaseElement* GetButton(int i) const;

Parameterwaarden

Ik
[in] Een op nul gebaseerde index van een knop die moet worden geretourneerd.

Retourwaarde

Een aanwijzer naar de knop die zich in de opgegeven index bevindt. NULL als de opgegeven index buiten het bereik valt.

Opmerkingen

CMFCRibbonButtonsGroup::GetCount

Retourneert het aantal knoppen in de groep.

int GetCount() const;

Retourwaarde

Het aantal knoppen in de groep.

CMFCRibbonButtonsGroup::GetImageSize

Hiermee wordt de grootte van de bronafbeelding van het beveiligde CMFCToolBarImages lid m_Imagesopgehaald.

const CSize GetImageSize() const;

Retourwaarde

Retourneert de grootte van de bronafbeelding van de werkbalkafbeeldingen, indien aanwezig, of een CSize nul indien niet.

Opmerkingen

CMFCRibbonButtonsGroup::GetRegularSize

Hiermee haalt u de maximale grootte van het lintgroepelement op.

virtual CSize GetRegularSize(CDC* pDC);

Parameterwaarden

Pdc
[in] Aanwijzer naar de apparaatcontext van de lintgroep.

Retourwaarde

Opmerkingen

CMFCRibbonButtonsGroup::HasImages

Rapporteert of het CMFCRibbonButtonsGroup object werkbalkafbeeldingen bevat.

BOOL HasImages() const;

Retourwaarde

Retourneert TRUE als het beveiligde CMFCToolBarImages lid m_Images afbeeldingen bevat of ONWAAR als dat niet het geval is.

Opmerkingen

CMFCRibbonButtonsGroup::OnDrawImage

Hiermee tekent u de juiste afbeelding voor een opgegeven knop, afhankelijk van of de knop normaal, gemarkeerd of uitgeschakeld is.

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

Parameterwaarden

Pdc
[in] Aanwijzer naar de apparaatcontext van het CMFCRibbonButtonsGroup object.

rectImage
[in] De rechthoek waarin u de afbeelding wilt tekenen.

pButton
[in] De knop waarvoor u de afbeelding wilt tekenen.

nImageIndex
[in] De index van de afbeelding die op de knop moet worden getekend (in een van de drie afbeeldingsmatrices voor normale, gemarkeerde of uitgeschakelde knoppen).

Opmerkingen

CMFCRibbonButtonsGroup::RemoveAll

Hiermee verwijdert u alle knoppen uit het CMFCRibbonButtonsGroup object.

void RemoveAll();

Opmerkingen

CMFCRibbonButtonsGroup::SetImages

Hiermee worden afbeeldingen toegewezen aan de groep lintknoppen.

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

Parameterwaarden

pImages
[in] Gewone afbeeldingen.

pHotImages
[in] Dynamische afbeeldingen.

pDisabledImages
[in] Uitgeschakelde afbeeldingen.

Opmerkingen

Bellen SetImages voordat u knoppen aan een groep toevoegt. Het aantal afbeeldingen moet groter of gelijk zijn aan het aantal knoppen dat aan de groep moet worden toegevoegd.

CMFCRibbonButtonsGroup::SetParentCategory

Hiermee stelt u het bovenliggende CMFCRibbonCategoryCMFCRibbonButtonsGroup object en alle knoppen erin in.

virtual void SetParentCategory(CMFCRibbonCategory* pCategory);

Parameterwaarden

pCategory
[in] Aanwijzer naar de bovenliggende categorie die u wilt instellen (de groepen met tabbladen in lintbesturingselementen worden categorieën genoemd).

Opmerkingen

Zie ook

Hiërarchiegrafiek
Klassen