CMFCRibbonButtonsGroup 類別

發行項
02/28/2013

CMFCRibbonButtonsGroup 類別可讓您組織的一組功能區按鈕為群組。所有按鈕在群組中水平地直接彼此相鄰和置於邊界。

class CMFCRibbonButtonsGroup : public CMFCRibbonBaseElement

Members

公用建構函式

名稱	描述
CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup	建構 CMFCRibbonButtonsGroup 物件。

公用方法

名稱	描述
CMFCRibbonButtonsGroup::AddButton	將按鈕加入至群組。
CMFCRibbonButtonsGroup::AddButtons	將按鈕清單加入至群組。
CMFCRibbonButtonsGroup::GetButton	將指標傳回至位於指定索引處的按鈕。
CMFCRibbonButtonsGroup::GetCount	在群組中傳回按鈕的數目。
CMFCRibbonButtonsGroup::GetImageSize	在功能區群組 (覆寫 CMFCRibbonBaseElement::GetImageSize中傳回一般影像的影像大小)。
CMFCRibbonButtonsGroup::GetRegularSize	傳回功能區項目 (覆寫 CMFCRibbonBaseElement::GetRegularSize的一般大小)。
CMFCRibbonButtonsGroup::HasImages	報告 CMFCRibbonButtonsGroup 物件是否包含工具列影像。
CMFCRibbonButtonsGroup::OnDrawImage	繪製指定按鈕的適當的影像，取決於按鈕是否為一般，反白顯示或停用。
CMFCRibbonButtonsGroup::RemoveAll	從 CMFCRibbonButtonsGroup 物件移除所有按鈕。
CMFCRibbonButtonsGroup::SetImages	將影像指派給群組。
CMFCRibbonButtonsGroup::SetParentCategory	在其中設定 CMFCRibbonButtonsGroup 物件的父代 CMFCRibbonCategory 和所有按鈕 (覆寫 CMFCRibbonBaseElement::SetParentCategory)。

備註

群組衍生自 CMFCBaseRibbonElement 的類別，並可用來做為單一實體。您可以在任何面板或快顯功能表可以將群組。

範例

下列範例在 CMFCRibbonButtonsGroup 類別示範如何使用各種方法。這個範例顯示如何建構 CMFCRibbonButtonsGroup 物件，將影像指派給功能區按鈕群組和將按鈕加入至功能區按鈕的群組。這個程式碼片段是繪製用戶端範例的一部分。

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