CMFCRibbonMainPanel 類別
實作當您按兩下 CMFCRibbonApplicationButton 時所顯示的功能區面板。
語法
class CMFCRibbonMainPanel : public CMFCRibbonPanel
成員
公用建構函式
| 名稱 | 描述 |
|---|---|
CMFCRibbonMainPanel::CMFCRibbonMainPanel |
預設建構函式。 |
CMFCRibbonMainPanel::~CMFCRibbonMainPanel |
解構函式。 |
公用方法
| 名稱 | 描述 |
|---|---|
| CMFCRibbonMainPanel：：Add | 將功能區元素新增至應用程式按鈕面板的左窗格。 （覆寫 CMFCRibbonPanel：：Add.） |
| CMFCRibbonMainPanel：：AddRecentFilesList | 將文字字串新增至最近的檔案清單功能表。 |
| CMFCRibbonMainPanel：：AddToBottom | 將功能區專案加入功能區應用程式面板的底部窗格。 |
| CMFCRibbonMainPanel：：AddToRight | 將功能區專案新增至應用程式按鈕面板的右窗格。 |
CMFCRibbonMainPanel::CreateObject |
由建立此類別類型的動態執行個體架構所使用。 |
| CMFCRibbonMainPanel：：GetCommandsFrame | 會傳回矩形，代表功能區主面板的區域。 |
CMFCRibbonMainPanel::GetThisClass |
由架構用來取得與這個類別類型相關聯之 CRuntimeClass 物件的指標。 |
備註
架構會在您開啟應用程式面板時顯示 CMFCRibbonMainPanel 。 其中包含三個窗格：
左窗格包含與檔案相關聯的命令，例如 [開啟]、[儲存]、[列印] 和 [關閉]。 若要將命令新增至此窗格，請呼叫 CMFCRibbonMainPanel：：Add。
右窗格包含選項，可修改您在左窗格中單擊的命令。 例如，如果您從左窗格單擊 [ 另存新檔] ，右窗格可以顯示可用的檔類型。 若要將專案新增至此窗格，請呼叫 CMFCRibbonMainPanel：：AddToRight。
底部窗格包含按鈕，可讓您變更應用程式的設定並結束程式。 若要將專案新增至此窗格，請呼叫 CMFCRibbonMainPanel：：AddToBottom。
繼承階層架構
需求
標頭： afxRibbonMainPanel.h
CMFCRibbonMainPanel：：Add
將功能區元素新增至應用程式按鈕面板的左窗格。
virtual void Add(CMFCRibbonBaseElement* pElem);
參數
pElem
[in， out]要加入至主面板之功能區元素的指標。
備註
將功能區專案新增至面板。 使用這個方法新增的元素將會位於主面板的左側數據行。
CMFCRibbonMainPanel：：AddRecentFilesList
將文字字串新增至最近的檔案清單功能表。
void AddRecentFilesList(
LPCTSTR lpszLabel,
int nWidth = 300);
參數
lpszLabel
指定要新增至最近檔案清單的字串。
nWidth
指定最近檔案清單面板的寬度，以像素為單位。
備註
CMFCRibbonMainPanel：：AddToBottom
將功能區專案加入功能區應用程式面板的底部窗格。
void AddToBottom(CMFCRibbonMainPanelButton* pElem);
參數
pElem
[in， out]要新增至主面板底部的功能區元素指標。
備註
CMFCRibbonMainPanel：：AddToRight
將功能區專案新增至應用程式按鈕面板的右窗格。
void AddToRight(
CMFCRibbonBaseElement* pElem,
int nWidth = 300);
參數
pElem
要新增至主面板右側之功能區專案的指標。
nWidth
指定右面板的寬度，以像素為單位。
備註
使用此函式將功能區專案新增至右面板。 右面板通常會顯示最近的檔案清單，但您可以在這裡新增任何其他功能區元素。
CMFCRibbonMainPanel：：GetCommandsFrame
會傳回矩形，代表功能區主面板的區域。
CRect GetCommandsFrame() const;
傳回值
矩形，表示功能區主面板的區域。