CMFCRibbonGallery-klasse

Hiermee worden lintgalerieën in Office 2007-stijl geïmplementeerd. Zie de broncode in de map VC\atlmfc\src\mfc van uw Visual Studio-installatie voor meer informatie.

Syntaxis

class CMFCRibbonGallery : public CMFCRibbonButton

Leden

Openbare constructors

Openbare methoden

Beveiligde methoden

Opmerkingen

Een galerieknop gedraagt zich net als een gewone menuknop, behalve dat er een galerie wordt weergegeven wanneer een gebruiker deze opent. Wanneer u een item in een galerie selecteert, verzendt het framework het WM_COMMAND bericht samen met de opdracht-id van de knop. Wanneer u het bericht verwerkt, moet u CMFCRibbonGallery::GetLastSelectedItem aanroepen om te bepalen welk item is geselecteerd in de galerie.

Example

In het volgende voorbeeld ziet u hoe u verschillende methoden in de CMFCRibbonGallery klasse gebruikt om een CMFCRibbonGallery object te configureren. In het voorbeeld ziet u hoe u het aantal items per rij in de galerie opgeeft, het formaat van het menupaneel inschakelt, de zijbalk links van het snelmenu inschakelt en de lintgalerie rechtstreeks op de lintbalk weergeeft. Dit codefragment maakt deel uit van het voorbeeld van de draw-client.

CMFCRibbonGallery *pBtnStyles = new CMFCRibbonGallery(ID_OBJECT_STYLES, _T("Styles\nk"), 0, 0, IDB_STYLES, 40);
pBtnStyles->SetIconsInRow(7);
pBtnStyles->EnableMenuResize(TRUE, TRUE);
pBtnStyles->EnableMenuSideBar();
pBtnStyles->SetButtonMode(false);
pBtnStyles->RedrawIcons();

Overnamehiërarchie

CObject
└ CMFCRibbonBaseElement
 └ CMFCRibbonButton
  └ CMFCRibbonGallery

Requirements

Koptekst: afxRibbonPaletteGallery.h

CMFCRibbonGallery::AddGroup

Voegt een nieuwe groep toe aan de galerie.

void AddGroup(
    LPCTSTR lpszGroupName,
    UINT uiImagesPaletteResID,
    int cxPaletteImage);

void AddGroup(
    LPCTSTR lpszGroupName,
    CMFCToolBarImages& imagesGroup);

void AddGroup(
    LPCTSTR lpszGroupName,
    int nIconsNum);

Parameterwaarden

lpszGroupName
[in] Hiermee geeft u de naam van de groep.

uiImagesPaletteResID
[in] Hiermee geeft u de resource-id op van de lijst met installatiekopieën die de afbeeldingen voor de groep bevat.

cxPaletteImage
[in] Hiermee geeft u de breedte in pixels van een afbeelding.

imagesGroup
[in] Een verwijzing naar de lijst met afbeeldingen die groepsafbeeldingen bevat.

nIconsNum
[in] Hiermee geeft u het aantal pictogrammen in de groep. Deze parameter mag alleen worden opgegeven voor aangepaste (eigenaar getekende) groepen.

Opmerkingen

U kunt de items op een lintgalerie in meerdere groepen verdelen door deze methode aan te roepen. Elke groep kan een bijschrift hebben.

CMFCRibbonGallery::AddSubItem

Hiermee voegt u een nieuw menu-item toe aan de vervolgkeuzelijst.

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

Parameterwaarden

pSubItem
[in] Een aanwijzer naar het item dat u aan het menu wilt toevoegen.

nIndex
[in] Hiermee geeft u de op nul gebaseerde index op van een locatie waar het item moet worden ingevoegd.

bOnTop
[in] WAAR om op te geven dat het item moet worden ingevoegd vóór de lintgalerie; anders, ONWAAR.

Opmerkingen

U kunt pop-upgalerieën combineren met pop-upmenu-items door deze methode aan te roepen. Menu-items kunnen vóór of na de galerie worden geplaatst.

Als u het item vóór de galerie wilt invoegen, stelt u bOnTop in op TRUE. Stel bOnTop in op FALSE om het item onder de galerie in te voegen.

CMFCRibbonGallery::Clear

Hiermee wist u de inhoud van de galerie.

virtual void Clear();

Opmerkingen

Roep deze methode aan om alle inhoud uit de lintgalerie te verwijderen. U moet dit doen voordat u een nieuwe lintgalerie of groep groepen aan de lintgalerie koppelt.

CMFCRibbonGallery::CMFCRibbonGallery

Maakt en initialiseert een CMFCRibbonGallery-object .

CMFCRibbonGallery (
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex,
    int nLargeImageIndex,
    CMFCToolBarImages& imagesPalette);

CMFCRibbonGallery (
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex,
    int nLargeImageIndex,
    UINT uiImagesPaletteResID=0,
    int cxPaletteImage=0);

CMFCRibbonGallery (
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex,
    int nLargeImageIndex,
    CSize sizeIcon,
    int nIconsNum,
    BOOL bDefaultButtonStyle=TRUE);

Parameterwaarden

nID
Hiermee geeft u de opdracht-id van de opdracht die moet worden uitgevoerd wanneer een gebruiker op de knop klikt.

lpszText
Hiermee geeft u de tekst op die op de knop moet worden weergegeven.

nSmallImageIndex
De op nul gebaseerde index van de kleine afbeelding die op de knop wordt weergegeven.

nLargeImageIndex
De op nul gebaseerde index van de grote afbeelding die op de knop wordt weergegeven.

imagesPalette
Een verwijzing naar het CMFCToolBarImages-object dat de afbeeldingen bevat die in de galerie moeten worden weergegeven.

uiImagesPaletteResID
De resource-id van de lijst met afbeeldingen die in de galerie moeten worden weergegeven.

cxPaletteImage
Hiermee geeft u de breedte, in pixels, van de afbeelding in de galerie.

sizeIcon
Hiermee geeft u de grootte, in pixels, van de galerieafbeelding.

nIconsNum
Hiermee geeft u het aantal pictogrammen in de galerie.

bDefaultButtonStyle
Hiermee geeft u op of de standaardstijl of de door de eigenaar getekende knopstijl moet worden gebruikt.

Opmerkingen

CMFCRibbonGallery::EnableMenuResize

Hiermee schakelt u het formaat van het menupaneel in of uit.

void EnableMenuResize(
    BOOL bEnable = TRUE,
    BOOL bVertcalOnly = FALSE);

Parameterwaarden

bEnable
[in] TRUE om het formaat van het menu in te schakelen; anders, ONWAAR.

bVertcalOnly
[in] TRUE om op te geven dat de galerie alleen verticaal kan worden aangepast; FALSE om op te geven dat de galerie zowel verticaal als horizontaal kan worden aangepast.

Opmerkingen

Gebruik deze methode om het formaat van de galerie met linten in of uit te schakelen. Wanneer het formaat wordt gewijzigd, wordt in de lintgalerie een greep weergegeven die een gebruiker kan gebruiken om het formaat ervan te wijzigen.

CMFCRibbonGallery::EnableMenuSideBar

Hiermee schakelt u de zijbalk links van het pop-upmenu in of uit.

void EnablMenuSideBar(BOOL bEnable=TRUE);

Parameterwaarden

bEnable
[in] TRUE om op te geven dat de zijbalk is ingeschakeld; anders, ONWAAR.

Opmerkingen

Roep deze methode aan om de zijbalk van Office XP aan de linkerkant van het menu in of uit te schakelen.

CMFCRibbonGallery::GetCompactSize

virtual CSize GetCompactSize(CDC* pDC);

Parameterwaarden

[in] Pdc

Retourwaarde

Opmerkingen

CMFCRibbonGallery::GetDroppedDown

virtual CMFCRibbonBaseElement* GetDroppedDown();

Retourwaarde

Opmerkingen

CMFCRibbonGallery::GetGroupName

Retourneert de naam van de groep die zich in de opgegeven index bevindt.

LPCTSTR GetGroupName(int nGroupIndex) const;

Parameterwaarden

nGroupIndex
[in] Hiermee geeft u de op nul gebaseerde index voor de groep waarvan u de naam wilt ophalen.

Retourwaarde

De naam van de groep die zich in de opgegeven index bevindt. Het doorgeven van een ongeldige index resulteert in een mislukte assertie.

Opmerkingen

CMFCRibbonGallery::GetGroupOffset

virtual int GetGroupOffset() const;

Retourwaarde

Opmerkingen

CMFCRibbonGallery::GetIconsInRow

Retourneert het aantal items in een rij van de lintgalerie.

int GetIconsInRow() const;

Retourwaarde

Het aantal items in een rij.

Opmerkingen

CMFCRibbonGallery::GetItemToolTip

Retourneert de knopinfotekst die is gekoppeld aan een item in de galerie.

LPCTSTR GetItemToolTip(int nItemIndex) const;

Parameterwaarden

nItemIndex
[in] Hiermee geeft u de op nul gebaseerde index van het item waarvoor de knopinfotekst moet worden opgehaald.

Retourwaarde

Een aanwijzer naar de tekenreeks voor knopinfo die is toegewezen aan een item in de lintgalerie. Het kan NULL zijn als er geen knopinfo aan dat item is toegewezen.

Opmerkingen

CMFCRibbonGallery::GetLastSelectedItem

Retourneert de index van het laatste item in de lintgalerie die de gebruiker heeft geselecteerd.

static int GetLastSelectedItem(UINT uiCmdID);

Parameterwaarden

uiCmdID
[in] Hiermee geeft u de opdracht-id op van het menu-item dat de lintgalerie heeft geopend.

Retourwaarde

Wanneer de gebruiker een item in de lintgalerie selecteert, verzendt de bibliotheek het WM_COMMAND bericht, samen met de opdracht-id van de menuknop waarmee de lintgalerie is geopend.

Opmerkingen

CMFCRibbonGallery::GetPaletteID

Retourneert de opdracht-id van het huidige palet.

int GetPaletteID() const;

Retourwaarde

De opdracht-id van het geselecteerde palet.

Opmerkingen

CMFCRibbonGallery::GetRegularSize

virtual CSize GetRegularSize(CDC* pDC);

Parameterwaarden

[in] Pdc

Retourwaarde

Opmerkingen

CMFCRibbonGallery::GetSelectedItem

int GetSelectedItem() const;

Retourwaarde

Opmerkingen

CMFCRibbonGallery::HasMenu

virtual BOOL HasMenu() const;

Retourwaarde

Opmerkingen

CMFCRibbonGallery::IsButtonMode

Hiermee geeft u op of het palet is opgenomen in een galerieknop.

BOOL IsButtonMode() const;

Retourwaarde

WAAR als het palet wordt weergegeven als een vervolgkeuzemenuknop; ONWAAR als het palet rechtstreeks op het lint wordt weergegeven.

Opmerkingen

CMFCRibbonGallery::IsMenuResizeEnabled

Hiermee geeft u op of het formaat van het menu is ingeschakeld.

BOOL IsMenuResizeEnabled() const;

Retourwaarde

WAAR als het formaat van het menu is ingeschakeld; anders, ONWAAR.

Opmerkingen

CMFCRibbonGallery::IsMenuResizeVertical

BOOL IsMenuResizeVertical() const;

Retourwaarde

Opmerkingen

CMFCRibbonGallery::IsMenuSideBar

Hiermee geeft u op of de zijbalk is ingeschakeld of uitgeschakeld.

BOOL IsMenuSideBar() const;

Retourwaarde

WAAR als de zijbalk van Office XP aan de linkerkant van het pop-upmenu wordt getekend; anders, ONWAAR.

Opmerkingen

CMFCRibbonGallery::OnAfterChangeRect

virtual void OnAfterChangeRect(CDC* pDC);

Parameterwaarden

[in] Pdc

Opmerkingen

CMFCRibbonGallery::OnDraw

virtual void OnDraw(CDC* pDC);

Parameterwaarden

[in] Pdc

Opmerkingen

CMFCRibbonGallery::OnDrawPaletteIcon

Aangeroepen door het framework wanneer een galeriepictogram wordt getekend.

virtual void OnDrawPaletteIcon(
    CDC* pDC,
    CRect rectIcon,
    int nIconIndex,
    CMFCRibbonGalleryIcon* pIcon,
    COLORREF clrText);

Parameterwaarden

Pdc
[in] Een aanwijzer naar de apparaatcontext die wordt gebruikt voor tekenen.

rectIcon
[in] Hiermee geeft u de begrenzingsrechthoek van het pictogram om te tekenen.

nIconIndex
[in] Hiermee geeft u de op nul gebaseerde index op in de lijst met galeriepictogrammen van het pictogram dat moet worden getekend.

Picon
[in] Een aanwijzer naar het pictogram dat wordt getekend.

clrText
[in] Hiermee geeft u de kleur op voor de tekst van het item dat moet worden getekend.

Opmerkingen

U kunt deze methode in een afgeleide klasse overschrijven om het uiterlijk van een lintgalerie aan te passen.

CMFCRibbonGallery::OnEnable

virtual void OnEnable(BOOL bEnable);

Parameterwaarden

[in] bEnable

Opmerkingen

CMFCRibbonGallery::OnRTLChanged

virtual void OnRTLChanged(BOOL bIsRTL);

Parameterwaarden

[in] bIsRTL

Opmerkingen

CMFCRibbonGallery::RedrawIcons

De galerie opnieuw tekenen.

void RedrawIcons();

Opmerkingen

Roep deze functie aan om de galerie opnieuw te tekenen. U moet deze methode aanroepen als u de inhoud van de galerie tijdens runtime hebt gewijzigd.

CMFCRibbonGallery::RemoveItemToolTips

Hiermee verwijdert u de knopinfo uit alle items in de galerie.

void RemoveItemToolTips();

Opmerkingen

CMFCRibbonGallery::SelectItem

void SelectItem(int nItemIndex);

Parameterwaarden

[in] nItemIndex

Opmerkingen

CMFCRibbonGallery::SetACCData

Hiermee wordt het opgegeven CAccessibilityData object gevuld met behulp van toegankelijkheidsgegevens uit de lintgalerie.

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

Parameterwaarden

pParent
[in] Het bovenliggende venster van het lintgalerievenster.

gegevens
[uit] Een CAccessibilityData object dat de toegankelijkheidsgegevens van de lintgalerie ontvangt.

Retourwaarde

Opmerkingen

WAAR als de methode is geslaagd; anders, ONWAAR.

CMFCRibbonGallery::SetButtonMode

Hiermee bepaalt u of de lintgalerie moet worden weergegeven als een vervolgkeuzelijst of als palet rechtstreeks op het lint.

void SetButtonMode(BOOL bSet=TRUE);

Parameterwaarden

bSet
[in] WAAR om de lintgalerie weer te geven als een vervolgkeuzemenuknop; ONWAAR om de inhoud van de galerie met linten rechtstreeks op het lint weer te geven.

Opmerkingen

CMFCRibbonGallery::SetGroupName

Hiermee stelt u de naam van een groep in.

void SetGroupName(
    int nGroupIndex,
    LPCTSTR lpszGroupName);

Parameterwaarden

nGroupIndex
[in] Hiermee geeft u de op nul gebaseerde index op voor de groep waarvoor de naam wordt gewijzigd.

lpszGroupName
[in] Hiermee geeft u de nieuwe naam voor de groep.

Opmerkingen

De groep waarvan de naam wordt gewijzigd, moet zijn toegevoegd met behulp van de methode CMFCRibbonGallery::AddGroup .

CMFCRibbonGallery::SetIconsInRow

Hiermee geeft u het aantal items per rij in de galerie.

void SetIconsInRow(int nIconsInRow);

Parameterwaarden

nIconsInRow
[in] Hiermee geeft u het aantal items op dat in elke rij van de galerie moet worden weergegeven.

Opmerkingen

Gebruik deze methode om de breedte van de lintgalerie op te geven.

CMFCRibbonGallery::SetItemToolTip

Hiermee stelt u de knopinfotekst voor een item in de galerie in.

void SetItemToolTip(
    int nItemIndex,
    LPCTSTR lpszToolTip);

Parameterwaarden

nItemIndex
[in] De op nul gebaseerde index van het paletitem waarmee de knopinfo moet worden gekoppeld.

lpszToolTip
[in] De tekst die moet worden weergegeven op de knopinfo.

Opmerkingen

CMFCRibbonGallery::SetPalette

Een palet koppelen aan een lintgalerie.

void SetPalette(CMFCToolBarImages& imagesPalette);

void SetPalette(
    UINT uiImagesPaletteResID,
    int cxPaletteImage);

Parameterwaarden

imagesPalette
[in] Hiermee geeft u de lijst met afbeeldingen op die de pictogrammen bevat die in de galerie moeten worden weergegeven.

uiImagesPaletteResID
[in] Hiermee geeft u de resource-id op van de lijst met afbeeldingen die de pictogrammen bevat die in de galerie moeten worden weergegeven.

cxPaletteImage
[in] Hiermee geeft u de breedte, in pixels, van een afbeelding in de galerie.

Opmerkingen

CMFCRibbonGallery::SetPaletteID

Hiermee definieert u de opdracht-id die wordt verzonden in het WM_COMMAND bericht wanneer een gebruiker een galerie-item selecteert.

void SetPaletteID(UINT nID);

Parameterwaarden

nID
[in] Hiermee geeft u de opdracht-id op die wordt verzonden in het WM_COMMAND bericht wanneer een gebruiker een galerie-item selecteert.

Opmerkingen

Als u het specifieke item wilt bepalen dat een gebruiker in de galerie heeft geselecteerd, roept u de statische methode CMFCRibbonGallery::GetLastSelectedItem aan.

Zie ook

Hiërarchiegrafiek
Klassen
CMFCRibbonButton-klasse
CmFCRibbonGalleryMenuButton-klasse