Поделиться через

Класс CMFCRibbonGalleryMenuButton

  • Статья

Реализует кнопку меню ленты, которая содержит коллекцию лент. Дополнительные сведения см. в исходном коде, расположенном в папке VC\atlmfc\src\mfc установки Visual Studio.

Синтаксис

class CMFCRibbonGalleryMenuButton : public CMFCToolBarMenuButton

Участники

Открытые конструкторы

Имя Описание
CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton Создает и инициализирует объект CMFCRibbonGalleryMenuButton.

Открытые методы

Имя Описание
CMFCRibbonGalleryMenuButton::CopyFrom (Переопределения CMFCToolBarMenuButton::CopyFrom.)
CMFCRibbonGalleryMenuButton::CreatePopupMenu (Переопределения CMFCToolBarMenuButton::CreatePopupMenu.)
CMFCRibbonGalleryMenuButton::GetPalette
CMFCRibbonGalleryMenuButton::HasButton (Переопределяет CMFCToolBarMenuButton::HasButton.)
CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed (Переопределения CMFCToolBarMenuButton::IsEmptyMenuAllowed.)

Замечания

Кнопка коллекции отображается в качестве всплывающего меню со стрелкой. Когда пользователь нажимает эту кнопку, открывается коллекция изображений. При создании кнопки коллекции необходимо задать список необходимых изображений.

Пример

В этом примере демонстрируется, как можно отобразить коллекцию маркеров с помощью кнопки меню:

BOOL CMainFrame::OnShowPopupMenu (CMFCPopupMenu* pMenuPopup)
{
    int nBulletIndex = pMenuBar->CommandToIndex (ID_PARA_BULLETS);

    if (nBulletIndex>= 0)
    {
        CMFCToolBarButton* pExButton =
        pMenuBar->GetButton(nBulletIndex);
        ASSERT_VALID (pExButton);

        CMFCRibbonGalleryMenuButton paletteBullet (
        pExButton->m_nID,
        pExButton->GetImage (),
        pExButton->m_strText);

        InitBulletPalette (&paletteBullet.GetPalette ());

        pMenuBar->ReplaceButton (ID_PARA_BULLETS,
        paletteBullet);
    }
}

Иерархия наследования

CObject
└ CMFCToolBarButton
 └ CMFCToolBarMenuButton
  └ CMFCRibbonGalleryMenuButton

Требования

Заголовок: afxRibbonPaletteGallery.h

CMFCRibbonGalleryMenuButton::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

Параметры

[in] src

Замечания

CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton

Создает и инициализирует объект CMFCRibbonGalleryMenuButton .

CMFCRibbonGalleryMenuButton(
    UINT uiID,
    int iImage,
    LPCTSTR lpszText,
    CMFCToolBarImages& imagesPalette);

CMFCRibbonGalleryMenuButton(
    UINT uiID,
    int iImage,
    LPCTSTR lpszText,
    UINT uiImagesPaletteResID = 0,
    int cxPaletteImage = 0);

Параметры

uiID
Идентификатор команды кнопки. Это значение, отправленное в сообщении WM_COMMAND, когда пользователь нажимает эту кнопку.

iImage
Индекс изображения, отображаемого с помощью кнопки меню коллекции. Изображения хранятся в параметре imagesPalette .

lpszText
Текст, отображаемый на кнопке меню.

imagesPalette
Содержит список изображений, отображаемых в коллекции.

uiImagesPaletteResID
Идентификатор ресурса списка изображений для изображений, отображаемых в коллекции.

cxPaletteImage
Задает ширину в пикселях изображения, отображаемого в коллекции.

Замечания

Кнопка меню коллекции отображается в виде всплывающего меню со стрелкой. Когда пользователь нажимает эту кнопку, открывается коллекция изображений.

Пример

В следующем примере показано, как использовать конструктор CMFCRibbonGalleryMenuButton класса. Этот фрагмент кода является частью примера демонстрации MS Office 2007.

// CMFCToolBarButton pExButton
CMFCRibbonGalleryMenuButton paletteBullet(pExButton->m_nID, pExButton->GetImage(), pExButton->m_strText);

CMFCRibbonGalleryMenuButton::CreatePopupMenu

virtual CMFCPopupMenu* CreatePopupMenu();

Возвращаемое значение

Замечания

CMFCRibbonGalleryMenuButton::GetPalette

CMFCRibbonGallery& GetPalette();

Возвращаемое значение

Замечания

CMFCRibbonGalleryMenuButton::HasButton

virtual BOOL HasButton() const;

Возвращаемое значение

Замечания

CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed

virtual BOOL IsEmptyMenuAllowed() const;

Возвращаемое значение

Замечания

См. также

Диаграмма иерархии
Классы
Класс CMFCToolBarMenuButton
Класс CMFCRibbonGallery