CMFCRibbonGallery 類別

發行項
02/28/2013

實作 Office 2007 的功能區陳列庫。

class CMFCRibbonGallery : public CMFCRibbonButton

Members

公用建構函式

名稱	描述
CMFCRibbonGallery::CMFCRibbonGallery	建構和 CMFCRibbonGallery 初始化物件。

公用方法

名稱	描述
CMFCRibbonGallery::AddGroup	若要加入新群組加入至這個組件庫。
CMFCRibbonGallery::AddSubItem	若要加入新的功能表項目加入至下拉式功能表。
CMFCRibbonGallery::Clear	清除的內容陳列庫。
CMFCRibbonGallery::EnableMenuResize	啟用或停用調整功能表面板。
CMFCRibbonGallery::EnableMenuSideBar	在快顯功能表左邊啟用或停用此提要欄位。
CMFCRibbonGallery::GetCompactSize	(覆寫 CMFCRibbonButton::GetCompactSize)。
CMFCRibbonGallery::GetDroppedDown	(覆寫 CMFCRibbonBaseElement::GetDroppedDown)。
CMFCRibbonGallery::GetGroupName	傳回位於指定索引處的群組名稱。
CMFCRibbonGallery::GetGroupOffset
CMFCRibbonGallery::GetIconsInRow	會傳回的項目數功能區陳列庫。
CMFCRibbonGallery::GetItemToolTip	傳回與陳列庫中某個項目的工具提示文字。
CMFCRibbonGallery::GetLastSelectedItem	傳回最後一個項目的索引使用者選取的陳列庫的。
CMFCRibbonGallery::GetPaletteID	傳回目前圖庫的命令 ID。
CMFCRibbonGallery::GetRegularSize	(覆寫 CMFCRibbonButton::GetRegularSize)。
CMFCRibbonGallery::GetSelectedItem
CMFCRibbonGallery::HasMenu	(覆寫 CMFCRibbonButton::HasMenu)。
CMFCRibbonGallery::IsButtonMode	指定這個一般模式庫是否在圖庫按鈕中。
CMFCRibbonGallery::IsMenuResizeEnabled	指定功能表調整大小是否啟用或停用。
CMFCRibbonGallery::IsMenuResizeVertical
CMFCRibbonGallery::IsMenuSideBar	指定這個提要欄位是否啟用或停用。
CMFCRibbonGallery::OnAfterChangeRect	(覆寫 CMFCRibbonButton::OnAfterChangeRect)。
CMFCRibbonGallery::OnDraw	(覆寫 CMFCRibbonButton::OnDraw)。
CMFCRibbonGallery::OnEnable	(覆寫 CMFCRibbonBaseElement::OnEnable)。
CMFCRibbonGallery::OnRTLChanged	(覆寫 CMFCRibbonBaseElement::OnRTLChanged)。
CMFCRibbonGallery::RedrawIcons	重繪陳列庫。
CMFCRibbonGallery::RemoveItemToolTips	從庫中的所有項目移除工具提示。
CMFCRibbonGallery::SelectItem
CMFCRibbonGallery::SetACCData	(覆寫 CMFCRibbonButton::SetACCData)。
CMFCRibbonGallery::SetButtonMode	指定是否顯示功能區陳列庫做為下拉式按鈕或做為調色盤直接在功能區上。
CMFCRibbonGallery::SetGroupName	設定群組名稱。
CMFCRibbonGallery::SetIconsInRow	定義項目數目表示圖庫的資料列。
CMFCRibbonGallery::SetItemToolTip	將某個項目的工具提示文字在陳列庫。
CMFCRibbonGallery::SetPalette	調色盤附加至功能區陳列庫。
CMFCRibbonGallery::SetPaletteID	定義在 WM_COMMAND 訊息傳送的命令 ID，當陳列庫項目已選取時。

受保護的方法

名稱	描述
CMFCRibbonGallery::OnDrawPaletteIcon	呼叫由架構，在繪製圖庫圖示。

備註

圖庫按鈕的行為如同一個規則功能表按鈕，但它會顯示陳列庫，當使用者開啟時。當您選取陳列庫中建立項目，這個架構與按鈕關聯的命令 ID WM_COMMAND 資訊一起傳送。當您處理訊息時，您應該呼叫 CMFCRibbonGallery::GetLastSelectedItem 判斷哪個項目從陳列庫中選取。

範例

下列範例會在 CMFCRibbonGallery 類別會示範如何使用各種方法設定 CMFCRibbonGallery 物件。在範例圖庫說明如何指定項目數目的每個資料列，以調整功能表面板，在快顯功能表左邊啟用提要欄位和顯示功能區陳列庫做為調色盤直接在功能區列。這個程式碼片段是繪製用戶端範例的一部分。

    CMFCRibbonGallery* pBtnStyles = new CMFCRibbonGallery(ID_OBJECT_STYLES, _T("Styles\nk"), 0, 0, IDB_STYLES, 40);
    pBtnStyles->SetIconsInRow(7);
    pBtnStyles->EnableMenuResize(TRUE, TRUE);
    pBtnStyles->EnableMenuSideBar();
    pBtnStyles->SetButtonMode(false);
    pBtnStyles->RedrawIcons();