Класс CMFCRibbonButton

Статья
06/10/2015

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

class CMFCRibbonButton : public CMFCRibbonBaseElement

Члены

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

Имя	Описание
CMFCRibbonButton::CMFCRibbonButton	Создает объект кнопки ленты.

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

Имя	Описание
CMFCRibbonButton::AddSubItem	Добавляет пункт меню в всплывающему меню, сопоставлено с кнопкой.
CMFCRibbonButton::CanBeStretched	(Переопределяет CMFCRibbonBaseElement::CanBeStretched).
CMFCRibbonButton::CleanUpSizes	(Переопределяет CMFCRibbonBaseElement::CleanUpSizes).
CMFCRibbonButton::ClosePopupMenu	(Переопределяет CMFCRibbonBaseElement::ClosePopupMenu).
CMFCRibbonButton::DrawBottomText
CMFCRibbonButton::DrawImage	(Переопределяет CMFCRibbonBaseElement::DrawImage).
CMFCRibbonButton::DrawRibbonText
CMFCRibbonButton::FindSubItemIndexByID	Возвращает индекс элемента раскрывающегося меню, который связан с указанным идентификатором команды
CMFCRibbonButton::GetCommandRect
CMFCRibbonButton::GetCompactSize	Возвращает компактный размер элемента ленты. (Переопределяет CMFCRibbonBaseElement::GetCompactSize).
CMFCRibbonButton::GetIcon
CMFCRibbonButton::GetImageIndex	Возвращает индекс образа, который связан с кнопкой.
CMFCRibbonButton::GetImageSize	Возвращает размер образа элемента ленты. (Переопределяет CMFCRibbonBaseElement::GetImageSize).
CMFCRibbonButton::GetIntermediateSize	Возвращает размер элемента ленты в своем промежуточном состоянии. (Переопределяет CMFCRibbonBaseElement::GetIntermediateSize).
CMFCRibbonButton::GetMenu	Возвращает дескриптор меню Windows, присвоено к кнопке ленты.
CMFCRibbonButton::GetMenuRect
CMFCRibbonButton::GetRegularSize	Возвращает обычный размер элемента ленты. (Переопределяет CMFCRibbonBaseElement::GetRegularSize).
CMFCRibbonButton::GetSubItems
CMFCRibbonButton::GetTextRowHeight
CMFCRibbonButton::GetToolTipText	Текст подсказки возвращений элемента ленты. (Переопределяет CMFCRibbonBaseElement::GetToolTipText).
CMFCRibbonButton::HasCompactMode	Указывает, имеет ли элемент на ленте компактный режим. (Переопределяет CMFCRibbonBaseElement::HasCompactMode).
CMFCRibbonButton::HasIntermediateMode	Указывает, имеет ли элемент на ленте промежуточный режим. (Переопределяет CMFCRibbonBaseElement::HasIntermediateMode).
CMFCRibbonButton::HasLargeMode	Указывает, имеет ли элемент лент большой режим. (Переопределяет CMFCRibbonBaseElement::HasLargeMode).
CMFCRibbonButton::HasMenu	(Переопределяет CMFCRibbonBaseElement::HasMenu).
CMFCRibbonButton::IsAlwaysDrawBorder
CMFCRibbonButton::IsAlwaysLargeImage	(Переопределяет CMFCRibbonBaseElement::IsAlwaysLargeImage).
CMFCRibbonButton::IsApplicationButton
CMFCRibbonButton::IsCommandAreaHighlighted
CMFCRibbonButton::IsDefaultCommand	Определяет, включена ли команду по умолчанию для кнопки ленты.
CMFCRibbonButton::IsDefaultPanelButton
CMFCRibbonButton::IsDrawTooltipImage
CMFCRibbonButton::IsLargeImage
CMFCRibbonButton::IsMenuAreaHighlighted
CMFCRibbonButton::IsMenuOnBottom
CMFCRibbonButton::IsPopupDefaultMenuLook
CMFCRibbonButton::IsRightAlignMenu	Определяет, является ли меню выравнивается по правому краю.
CMFCRibbonButton::IsSingleLineText
CMFCRibbonButton::OnCalcTextSize	(Переопределяет CMFCRibbonBaseElement::OnCalcTextSize).
CMFCRibbonButton::OnDrawBorder
CMFCRibbonButton::OnDraw	Вызываемый платформой для рисования элемента ленты. (Переопределяет CMFCRibbonBaseElement::OnDraw).
CMFCRibbonButton::OnFillBackground
CMFCRibbonButton::RemoveAllSubItems	Удаляет все пункты меню из раскрывающегося меню.
CMFCRibbonButton::RemoveSubItem	Удаляет пункт меню из раскрывающегося меню.
CMFCRibbonButton::SetACCData	(Переопределяет CMFCRibbonBaseElement::SetACCData).
CMFCRibbonButton::SetAlwaysLargeImage	Определяет, указывает ли кнопка большой или маленький образ, когда пользователь свернуть.
CMFCRibbonButton::SetDefaultCommand	Включает команду по умолчанию для кнопки ленты.
CMFCRibbonButton::SetDescription	Задает описание для элемента ленты. (Переопределяет CMFCRibbonBaseElement::SetDescription).
CMFCRibbonButton::SetImageIndex	Присвоит индекс в образу кнопки.
CMFCRibbonButton::SetMenu	Присвоит всплывающее меню к кнопке ленты.
CMFCRibbonButton::SetParentCategory	(Переопределяет CMFCRibbonBaseElement::SetParentCategory).
CMFCRibbonButton::SetRightAlignMenu	Выравнивает всплывающее меню справа от кнопки.
CMFCRibbonButton::SetText	Задает текст для элемента ленты. (Переопределяет CMFCRibbonBaseElement::SetText).

Защищенные методы

Имя	Описание
CMFCRibbonButton::OnClick	Вызываемый платформой, когда пользователь нажимает кнопку.

Пример

В следующем примере показано, как использовать различные методы класса CMFCRibbonButton. Примере показано, как создать объект класса CMFCRibbonButton, присвоит всплывающее меню к кнопке ленты, установите описание кнопки удаляет пункт меню из раскрывающегося меню справа выравнивание, а всплывающее меню к краю кнопки.

   strTemp.LoadString(IDS_RIBBON_STYLE);
    // The first parameter is the command ID of the button. 
    // The third parameter is a zero-based index of the button's small image in the  
    // image list of the parent category. 
    // The fourth parameter is a zero-based index of the button's large image in the  
    // image list of the parent category.
    CMFCRibbonButton* pVisualStyleButton = new CMFCRibbonButton(1, strTemp, -1, -1);
    
    pVisualStyleButton->SetMenu(IDR_THEME_MENU, TRUE, TRUE);

    strTemp.LoadString(IDS_RIBBON_STYLE_TIP);
    pVisualStyleButton->SetToolTipText(strTemp);
    strTemp.LoadString(IDS_RIBBON_STYLE_DESC);
    pVisualStyleButton->SetDescription(strTemp);
    pVisualStyleButton->RemoveSubItem(0);
    pVisualStyleButton->SetRightAlignMenu(TRUE);

Заметки

Чтобы использовать кнопки ленты в приложении создайте объект кнопки и добавьте его к соответствующему ленте панель.

CMFCRibbonPanel* pPanel = pCategory->AddPanel (
    _T("Clipboard"),                       // Panel name
    m_PanelIcons.ExtractIcon (0));  // Panel icon
// Create the first button ("Paste"):
CMFCRibbonButton* pPasteButton = 
    new CMFCRibbonButton (ID_EDIT_PASTE, _T("Paste"), -1, 0);
// The third parameter (-1) disables small images for button.
// This button is always displayed with a large image
// Associate a pop-up menu with the "Paste" button:
pPasteButton->SetMenu (IDR_CONTEXT_MENU);
// Add buttons to the panel. These buttons have only small images.
pPanel->Add (new CMFCRibbonButton (ID_EDIT_CUT, _T("Cut"), 1));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_COPY, _T("Copy"), 2));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_PAINT, _T("Paint"), 9));