CMFCRibbonButtonsGroup 類別
類別 CMFCRibbonButtonsGroup 可讓您將一組功能區按鈕組織成群組。 群組中的所有按鈕彼此水平直接相鄰，而且以框線框住。
語法
class CMFCRibbonButtonsGroup : public CMFCRibbonBaseElement
成員
公用建構函式
| 名稱 | 描述 |
|---|---|
| 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 | 設定物件的父CMFCRibbonCategoryCMFCRibbonButtonsGroup系及其內的所有按鈕（覆寫 CMFCRibbonBaseElement：：SetParentCategory.） |
備註
此群組衍生自 CMFCBaseRibbonElement ，而且可以操作為單一實體。 您可以將群組放置在任何面板或彈出視窗選單上。
範例
下例示範如何在 CMFCRibbonButtonsGroup 類別中使用各種方法。 此範例示範如何建構 CMFCRibbonButtonsGroup 物件、將影像指派給功能區按鈕群組，以及將按鈕新增至功能區按鈕群組。 這段程式碼片段是 Draw 用戶端範例的一部分。
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"));
繼承階層架構
需求
標頭： afxribbonbuttonsgroup.h
CMFCRibbonButtonsGroup：：AddButton
將按鈕新增至群組。
void AddButton(CMFCRibbonBaseElement* pButton);
參數
pButton
[in]要新增之按鈕的指標。
CMFCRibbonButtonsGroup：：AddButtons
將按鈕清單新增至群組。
void AddButtons(
const CList<CMFCRibbonBaseElement*,CMFCRibbonBaseElement*>& lstButtons);
參數
lstButtons
[in]您要新增之按鈕的指標清單。
CMFCRibbonButtonsGroup：：CMFCRibbonButtonsGroup
建構 CMFCRibbonButtonsGroup 物件。
CMFCRibbonButtonsGroup();
CMFCRibbonButtonsGroup(CMFCRibbonBaseElement* pButton);
參數
pButton
[in]指定要新增至新建立 CMFCRibbonButtonsGroup 物件的按鈕。
傳回值
備註
CMFCRibbonButtonsGroup：：GetButton
傳回位於指定索引處之按鈕的指標。
CMFCRibbonBaseElement* GetButton(int i) const;
參數
i
[in]要傳回之按鈕之以零起始的索引。
傳回值
位於指定索引處之按鈕的指標。 如果指定的索引超出範圍，則為 NULL。
備註
CMFCRibbonButtonsGroup：：GetCount
傳回群組中的按鈕數目。
int GetCount() const;
傳回值
群組中的按鈕數目。
CMFCRibbonButtonsGroup：：GetImageSize
擷取受保護 CMFCToolBarImages 成員 m_Images的來源映像大小。
const CSize GetImageSize() const;
傳回值
傳回工具列影像的來源影像大小，如果有的話，則 CSize 傳回零則傳回 。
備註
CMFCRibbonButtonsGroup：：GetRegularSize
擷取功能區群組專案的最大可能大小。
virtual CSize GetRegularSize(CDC* pDC);
參數
pDC
[in]功能區群組之裝置內容的指標。
傳回值
備註
CMFCRibbonButtonsGroup：：HasImages
報告物件是否 CMFCRibbonButtonsGroup 包含工具列影像。
BOOL HasImages() const;
傳回值
如果受保護的 CMFCToolBarImages 成員 m_Images 包含任何映像，則傳回 TRUE;如果沒有，則傳回 FALSE。
備註
CMFCRibbonButtonsGroup：：OnDrawImage
根據按鈕是否正常、反白顯示或停用，繪製指定按鈕的適當影像。
virtual void OnDrawImage(
CDC* pDC,
CRect rectImage,
CMFCRibbonBaseElement* pButton,
int nImageIndex);
參數
pDC
[in]對象的裝置內容的 CMFCRibbonButtonsGroup 指標。
rectImage
[in]要在其中繪製影像的矩形。
pButton
[in]要繪製影像的按鈕。
nImageIndex
[in]要繪製在按鈕上的影像索引（在一般、反白顯示或停用按鈕的三個影像陣列中之一）。
備註
CMFCRibbonButtonsGroup：：RemoveAll
從物件中移除所有按鈕 CMFCRibbonButtonsGroup 。
void RemoveAll();
備註
CMFCRibbonButtonsGroup：：SetImages
將影像指派給功能區按鈕群組。
void SetImages(
CMFCToolBarImages* pImages,
CMFCToolBarImages* pHotImages,
CMFCToolBarImages* pDisabledImages);
參數
pImages
[in]一般影像。
pHotImages
[in]熱門影像。
pDisabledImages
[in]已停用的影像。
備註
將按鈕新增至群組之前，請先呼叫 SetImages 。 影像數目必須大於或等於要新增至群組的按鈕數目。
注意
經常性影像是當使用者將滑鼠停留在按鈕上方時所顯示的影像。 停用的影像是停用按鈕時所顯示的影像。
CMFCRibbonButtonsGroup：：SetParentCategory
設定物件的父CMFCRibbonCategoryCMFCRibbonButtonsGroup代及其內的所有按鈕。
virtual void SetParentCategory(CMFCRibbonCategory* pCategory);
參數
pCategory
[in]要設定之父類別的指標（功能區控件中的索引卷標式群組稱為類別）。