CMFCRibbonButton 類別

發行項
02/28/2013

CMFCRibbonButton 類別實作您在功能區列項目上放置如面板、快速存取工具列和快顯功能表的按鈕。

class CMFCRibbonButton : public CMFCRibbonBaseElement

Members

公用建構函式

名稱	描述
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	傳回與指定的命令 ID. 快顯功能表項目的索引。
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));