共用方式為


CMFCVisualManager 類別

提供在全域層級上變更應用程式外觀的支援。 CMFCVisualManager 類別會使用一致的樣式,與提供繪製應用程式 GUI 控制項指令的類別搭配使用。 這些其他類別稱為視覺管理員,並且繼承自 CMFCBaseVisualManager

如需詳細資訊,請參閱 Visual Studio 安裝的 VC\atlmfc\src\mfc 資料夾中的原始程式碼

語法

class CMFCVisualManager : public CMFCBaseVisualManager

成員

公用建構函式

名稱 描述
CMFCVisualManager::CMFCVisualManager 預設建構函式。

公用方法

名稱 描述
CMFCVisualManager::AdjustFrames
CMFCVisualManager::AdjustToolbars
CMFCVisualManager::AlwaysHighlight3DTabs 由架構呼叫,以判斷是否一律使用醒目提示色彩繪製 3D 索引標籤。
CMFCVisualManager::D estroyInstance
CMFCVisualManager::D oDrawHeaderSortArrow
CMFCVisualManager::D rawComboDropButtonWinXP
CMFCVisualManager::D rawPushButtonWinXP
CMFCVisualManager::D rawTextOnGlass
CMFCVisualManager::GetAutoHideButtonTextColor 由架構呼叫以擷取自動隱藏按鈕的文字色彩。
CMFCVisualManager::GetButtonExtraBorder 由架構呼叫,以擷取目前視覺管理員需要繪製按鈕的增加按鈕大小。
CMFCVisualManager::GetCaptionBarTextColor 由架構呼叫以擷取標題列的文字色彩。
CMFCVisualManager::GetDockingTabsBordersSize 由架構呼叫,以擷取固定索引標籤列框線的框線大小。
CMFCVisualManager::GetHighlightedMenuItemTextColor
CMFCVisualManager::GetInstance 傳回 物件的指標 CMFCVisualManager
CMFCVisualManager::GetMDITabsBordersSize 由架構呼叫以擷取 MDITabs 視窗的框線大小。
CMFCVisualManager::GetMenuItemTextColor
CMFCVisualManager::GetMenuShadowDepth 傳回值,決定功能表陰影的寬度和高度。
CMFCVisualManager::GetNcBtnSize 由架構呼叫,以根據目前的視覺管理員來判斷系統按鈕的大小。 系統按鈕是對應至 [關閉 ]、[最小化]、 [最大化 ] 和 [還原 ] 命令 之主框架標題中的按鈕。
CMFCVisualManager::GetPopupMenuBorderSize 由架構呼叫以擷取快顯功能表的框線大小。
CMFCVisualManager::GetPropertyGridGroupColor 由架構呼叫以擷取屬性清單的背景色彩。
CMFCVisualManager::GetPropertyGridGroupTextColor 由架構呼叫以擷取屬性清單的文字色彩。
CMFCVisualManager::GetRibbonHyperlinkTextColor
CMFCVisualManager::GetRibbonPopupBorderSize
CMFCVisualManager::GetRibbonQuickAccessToolBarTextColor
CMFCVisualManager::GetRibbonSliderColors
CMFCVisualManager::GetShowAllMenuItemsHeight
CMFCVisualManager::GetSmartDockingBaseGuideColors
CMFCVisualManager::GetSmartDockingHighlightToneColor
CMFCVisualManager::GetSmartDockingTheme 傳回用來顯示智慧停駐標記的主題。
CMFCVisualManager::GetStatusBarPaneTextColor
CMFCVisualManager::GetTabFrameColors 由架構呼叫,以擷取繪製製表框時要使用的一組色彩。
CMFCVisualManager::GetTabTextColor
CMFCVisualManager::GetToolbarButtonTextColor 由架構呼叫以擷取工具列按鈕上文字的目前色彩。 此色彩會根據目前的視覺管理員和按鈕狀態而有所不同。
CMFCVisualManager::GetToolbarDisabledTextColor 由架構呼叫,以判斷停用工具列元素上顯示的文字色彩。
CMFCVisualManager::GetToolbarHighlightColor
CMFCVisualManager::GetToolTipInfo
CMFCVisualManager::HasOverlappedAutoHideButtons 指定自動隱藏按鈕是否重迭。
CMFCVisualManager::IsDockingTabHasBorder 指定目前的視覺管理員是否會在定位式停駐列周圍繪製框線。
CMFCVisualManager::IsEmbossDisabledImage 指定是否應該浮凸已停用的影像。
CMFCVisualManager::IsFadeInactiveImage 由架構呼叫,以判斷工具列或功能表上的非使用中影像是否呈現暗灰色。
CMFCVisualManager::IsMenuFlatLook 指定功能表按鈕是否具有扁平化的外觀。
CMFCVisualManager::IsOfficeXPStyleMenus 指定視覺管理員是否實作 Office XP 樣式功能表。
CMFCVisualManager::IsOwnerDrawCaption 指定目前的視覺化管理員是否實作框架視窗的擁有者繪製標題。
CMFCVisualManager::IsShadowHighlightedImage 指定醒目提示影像是否有陰影。
CMFCVisualManager::OnDrawAutoHideButtonBorder 當架構繪製自動隱藏按鈕的框線時,由架構呼叫。
CMFCVisualManager::OnDrawBarGripper 當架構繪製控制項列的夾板時,由架構呼叫。 使用者必須按一下控制夾才能移動控制列。
CMFCVisualManager::OnDrawBrowseButton 架構在繪製屬於編輯控制項的瀏覽按鈕時呼叫 ( CMFCEditBrowseCtrl 類別 )。
CMFCVisualManager::OnDrawButtonBorder 當架構繪製工具列按鈕的框線時,由架構呼叫。
CMFCVisualManager::OnDrawButtonSeparator
CMFCVisualManager::OnDrawCaptionBarBorder 當架構繪製標題條框線時,由架構呼叫。
CMFCVisualManager::OnDrawCaptionBarButtonBorder
CMFCVisualManager::OnDrawCaptionBarInfoArea
CMFCVisualManager::OnDrawCaptionButton 當架構繪製標題按鈕時,由架構呼叫。
CMFCVisualManager::OnDrawCheckBox
CMFCVisualManager::OnDrawCheckBoxEx
CMFCVisualManager::OnDrawComboBorder 當架構繪製下拉式方塊按鈕的框線時,由架構呼叫。
CMFCVisualManager::OnDrawComboDropButton 架構在繪製下拉式方塊下拉式按鈕時呼叫。
CMFCVisualManager::OnDrawControlBorder
CMFCVisualManager::OnDrawDefaultRibbonImage 當架構繪製預設功能區映射時,由架構呼叫。
CMFCVisualManager::OnDrawEditBorder 架構在 CMFCToolBarEditBoxButton 物件周圍 繪製框線時呼叫。
CMFCVisualManager::OnDrawExpandingBox
CMFCVisualManager::OnDrawFloatingToolbarBorder 當架構繪製浮動工具列的框線時,由架構呼叫。 浮動工具列是顯示為迷你框架視窗的工具列。
CMFCVisualManager::OnDrawHeaderCtrlBorder 當架構繪製包含標頭控制項的框線時,由架構呼叫。
CMFCVisualManager::OnDrawHeaderCtrlSortArrow 當架構繪製標頭控制項排序箭號時,由架構呼叫。
CMFCVisualManager::OnDrawMenuArrowOnCustomizeList
CMFCVisualManager::OnDrawMenuBorder 當架構繪製功能表框線時,由架構呼叫。
CMFCVisualManager::OnDrawMenuCheck
CMFCVisualManager::OnDrawMenuItemButton
CMFCVisualManager::OnDrawMenuLabel
CMFCVisualManager::OnDrawMenuResizeBar
CMFCVisualManager::OnDrawMenuScrollButton 架構在繪製功能表捲動按鈕時呼叫。
CMFCVisualManager::OnDrawMenuShadow
CMFCVisualManager::OnDrawMenuSystemButton 架構在繪製功能表系統按鈕 [關閉 ]、[最小化]、 [最大化 ] 和 [還原 ] 時呼叫。
CMFCVisualManager::OnDrawMiniFrameBorder
CMFCVisualManager::OnDrawOutlookBarSplitter 當架構繪製 Outlook 列的分隔器時,由架構呼叫。 分隔器是用來群組控制項的水準橫條。
CMFCVisualManager::OnDrawOutlookPageButtonBorder 當架構繪製 Outlook 頁面按鈕的框線時,由架構呼叫。 如果 [Outlook 列] 窗格包含的按鈕數目超過它所能顯示的按鈕,則會出現 Outlook 頁面按鈕。
CMFCVisualManager::OnDrawPaneBorder 當架構繪製 CPane 類別 框線時,由架構呼叫。
CMFCVisualManager::OnDrawPaneCaption 當架構繪製 的標題時,由架構呼叫 CPane
CMFCVisualManager::OnDrawPaneDivider
CMFCVisualManager::OnDrawPopupWindowBorder
CMFCVisualManager::OnDrawPopupWindowButtonBorder
CMFCVisualManager::OnDrawPopupWindowCaption
CMFCVisualManager::OnDrawRibbonApplicationButton 架構在繪製功能區上的 [主要按鈕 ] 時 呼叫。
CMFCVisualManager::OnDrawRibbonButtonBorder 當架構繪製功能區按鈕的框線時,由架構呼叫。
CMFCVisualManager::OnDrawRibbonButtonsGroup 架構在功能區上繪製一組按鈕時呼叫。
CMFCVisualManager::OnDrawRibbonCaption 架構在繪製主框架的標題時呼叫,但只有在功能區列與框架整合時才呼叫。
CMFCVisualManager::OnDrawRibbonCaptionButton 當架構繪製位於功能區列上的標題按鈕時,由架構呼叫。
CMFCVisualManager::OnDrawRibbonCategory 當架構繪製功能區類別時,由架構呼叫。
CMFCVisualManager::OnDrawRibbonCategoryCaption 當架構繪製功能區類別的標題時,由架構呼叫。
CMFCVisualManager::OnDrawRibbonCategoryScroll
CMFCVisualManager::OnDrawRibbonCategoryTab 當架構繪製功能區類別的索引標籤時,由架構呼叫。
CMFCVisualManager::OnDrawRibbonCheckBoxOnList
CMFCVisualManager::OnDrawRibbonColorPaletteBox
CMFCVisualManager::OnDrawRibbonDefaultPaneButtonCoNtext
CMFCVisualManager::OnDrawRibbonDefaultPaneButton 當架構繪製功能區面板預設按鈕時,由架構呼叫。 當使用者壓縮功能區面板時,會顯示預設按鈕,使其太小而無法顯示功能區元素。 預設按鈕會改為繪製,而且功能區元素會新增為下拉式功能表中的專案。
CMFCVisualManager::OnDrawRibbonDefaultPaneButtonIndicator
CMFCVisualManager::OnDrawRibbonGalleryBorder
CMFCVisualManager::OnDrawRibbonGalleryButton
CMFCVisualManager::OnDrawRibbonKeyTip
CMFCVisualManager::OnDrawRibbonLabel 當架構繪製功能區標籤時,由架構呼叫。
CMFCVisualManager::OnDrawRibbonMainPanelButtonBorder 當架構繪製位於 面板的功能區按鈕框線時,由架構呼叫。 [ 主要] 面板是當使用者按一下 [ 主按鈕 ] 時出現的面板。
CMFCVisualManager::OnDrawRibbonMainPanelFrame 架構在主 面板周圍 繪製框架時呼叫。
CMFCVisualManager::OnDrawRibbonMenuCheckFrame
CMFCVisualManager::OnDrawRibbonPanel 當架構繪製功能區面板時,由架構呼叫。
CMFCVisualManager::OnDrawRibbonPanelCaption 當架構繪製功能區面板的標題時,由架構呼叫。
CMFCVisualManager::OnDrawRibbonProgressBar 當架構繪製 CMFCRibbonProgressBar 物件時,由架構呼叫。
CMFCVisualManager::OnDrawRibbonQuickAccessToolBarSeparator 當架構在功能區的 快速存取工具列 上繪製分隔符號時,由架構呼叫。
CMFCVisualManager::OnDrawRibbonRecentFilesFrame 架構在最近檔案清單周圍繪製框架時呼叫。
CMFCVisualManager::OnDrawRibbonSliderChannel 當架構繪製 CMFCRibbonSlider 物件的通道時, 由架構呼叫。
CMFCVisualManager::OnDrawRibbonSliderThumb 當架構繪製 物件的拇指 CMFCRibbonSlider 時,由架構呼叫。
CMFCVisualManager::OnDrawRibbonSliderZoomButton 當架構繪製 物件的縮放按鈕 CMFCRibbonSlider 時,由架構呼叫。
CMFCVisualManager::OnDrawRibbonStatusBarPane 當架構繪製功能區的狀態列窗格時,由架構呼叫。
CMFCVisualManager::OnDrawRibbonTabsFrame 當架構在一組功能區索引標籤周圍繪製框架時,由架構呼叫。
CMFCVisualManager::OnDrawScrollButtons
CMFCVisualManager::OnDrawSeparator 架構在繪製分隔符號時呼叫。 分隔符號通常用於控制列來分隔圖示群組。
CMFCVisualManager::OnDrawShowAllMenuItems
CMFCVisualManager::OnDrawSpinButtons 由架構在繪製微調按鈕時呼叫。
CMFCVisualManager::OnDrawSplitterBorder 當架構繪製分割視窗的框線時,由架構呼叫。
CMFCVisualManager::OnDrawSplitterBox 當架構繪製分割視窗的分割器拖曳方塊時,由架構呼叫。
CMFCVisualManager::OnDrawStatusBarPaneBorder 架構在繪製狀態列窗格的框線時呼叫。
CMFCVisualManager::OnDrawStatusBarProgress 當架構繪製狀態列進度指示器時,由架構呼叫。
CMFCVisualManager::OnDrawStatusBarSizeBox 當架構繪製狀態列大小方塊時,由架構呼叫。
CMFCVisualManager::OnDrawTab 當架構繪製 CMFCTabCtrl 物件時,由架構呼叫。
CMFCVisualManager::OnDrawTabCloseButton 當架構繪製 使用中索引標籤上的 [關閉 ] 按鈕時,由架構呼叫。
CMFCVisualManager::OnDrawTabContent 當架構繪製索引標籤內部時,由架構呼叫(影像、文字)。
CMFCVisualManager::OnDrawTabsButtonBorder 當架構繪製索引標籤按鈕的框線時,由架構呼叫。
CMFCVisualManager::OnDrawTask 架構在工作窗格上繪製工作時呼叫。
CMFCVisualManager::OnDrawTasksGroupAreaBorder 當架構在工作窗格上的群組區域周圍繪製框線時,由架構呼叫。
CMFCVisualManager::OnDrawTasksGroupCaption 當架構繪製工作窗格上工作組的標題時,由架構呼叫。
CMFCVisualManager::OnDrawTasksGroupIcon
CMFCVisualManager::OnDrawTearOffCaption 當架構繪製卸載標題時,架構會呼叫卸載列。
CMFCVisualManager::OnDrawToolBoxFrame
CMFCVisualManager::OnEraseMDIClientArea 當架構清除 MDI 工作區時,由架構呼叫。
CMFCVisualManager::OnErasePopupWindowButton
CMFCVisualManager::OnEraseTabsArea 架構在清除索引標籤視窗中的索引標籤區域時呼叫。
CMFCVisualManager::OnEraseTabsButton 當架構清除索引標籤按鈕的圖示和文字時,由架構呼叫。
CMFCVisualManager::OnEraseTabsFrame 當架構清除製表框時,由架構呼叫。
CMFCVisualManager::OnFillAutoHideButtonBackground 當架構填滿自動隱藏按鈕的背景時,由架構呼叫。
CMFCVisualManager::OnFillBarBackground 當架構填滿控制項列的背景時,由架構呼叫。
CMFCVisualManager::OnFillButtonInterior 架構在填滿工具列按鈕的背景時呼叫。
CMFCVisualManager::OnFillCaptionBarButton
CMFCVisualManager::OnFillCommandsListBackground 當架構填滿屬於命令清單的工具列按鈕背景時,架構會呼叫該按鈕是自訂對話方塊的一部分。
CMFCVisualManager::OnFillHeaderCtrlBackground 當架構填滿標頭控制項的背景時,由架構呼叫。
CMFCVisualManager::OnFillMiniFrameCaption 當架構填滿迷你框架視窗的標題時,由架構呼叫。
CMFCVisualManager::OnFillOutlookBarCaption 當架構填滿 Outlook 列的背景時,由架構呼叫標題。
CMFCVisualManager::OnFillOutlookPageButton 當架構填滿 Outlook 頁面按鈕的內部時,由架構呼叫。
CMFCVisualManager::OnFillPopupWindowBackground 當架構填滿快顯視窗的背景時,由架構呼叫。
CMFCVisualManager::OnFillRibbonButton 當架構填滿功能區按鈕的內部時,由架構呼叫。
CMFCVisualManager::OnFillRibbonEdit 當架構填滿功能區編輯控制項的內部時,由架構呼叫。
CMFCVisualManager::OnFillRibbonMainPanelButton 當架構填滿位於 面板的功能區按鈕內部時,由架構呼叫。
CMFCVisualManager::OnFillRibbonMenuFrame 當架構填滿主功能區面板的功能表框時,由架構呼叫。
CMFCVisualManager::OnFillRibbonQuickAccessToolBarPopup
CMFCVisualManager::OnFillSplitterBackground 架構在填滿分割視窗的背景時呼叫。
CMFCVisualManager::OnFillTab 當架構填滿索引標籤的背景時,由架構呼叫。
CMFCVisualManager::OnFillTasksGroupInterior 當架構在 CMFCTasksPane 填滿 CMFCTaskSPaneTaskGroup 物件的內部 時,由架構呼叫。
CMFCVisualManager::OnFillTasksPaneBackground 當架構填滿控制項的背景時,由架構呼叫 CMFCTasksPane
CMFCVisualManager::OnHighlightMenuItem 當架構繪製醒目提示的功能表項目時,由架構呼叫。
CMFCVisualManager::OnHighlightRarelyUsedMenuItems 當架構繪製醒目提示且很少使用的功能表項目時,由架構呼叫。
CMFCVisualManager::OnNc小畫家 當架構繪製非工作區時,由架構呼叫。
CMFCVisualManager::OnSetWindowRegion 當架構設定包含框架和快顯功能表的區域時,由架構呼叫。
CMFCVisualManager::OnUpdateSystemColors 架構在變更系統色彩設定時呼叫。
CMFCVisualManager::RedrawAll 重新繪製應用程式中的所有控制列。
CMFCVisualManager::RibbonCategoryColorToRGB
CMFCVisualManager::SetDefaultManager 設定預設視覺效果管理員。
CMFCVisualManager::SetEmbossDisabledImage 啟用或停用已停用工具列影像的浮凸模式。
CMFCVisualManager::SetFadeInactiveImage 啟用或停用功能表或工具列上非使用中影像的光源效果。
CMFCVisualManager::SetMenuFlatLook 設定旗標,指出應用程式功能表按鈕是否有扁平化的外觀。
CMFCVisualManager::SetMenuShadowDepth 設定功能表陰影的寬度和高度。
CMFCVisualManager::SetShadowHighlightedImage 設定旗標,指出是否要在轉譯反白顯示影像時顯示陰影。

備註

因為 類別 CMFCVisualManager 會控制應用程式的 GUI,因此每個應用程式都可以有 一個 實例 CMFCVisualManager ,或衍生自 CMFCVisualManager 的類別的一個實例。 您的應用程式也可以在沒有 的情況下 CMFCVisualManager 運作。 使用靜態方法來 GetInstance 取得目前 CMFCVisualManager 衍生物件的指標。

若要變更應用程式的外觀,您必須使用其他類別來提供繪製應用程式所有視覺元素的方法。 這些類別的一些範例包括 CMFCVisualManagerOfficeXP 類別 CMFCVisualManagerOffice2003 類別 CMFCVisualManagerOffice2007 類別 。 當您想要變更應用程式的外觀時,請將其中一個視覺管理員傳遞至 方法 SetDefaultManager 。 如需示範應用程式如何模擬 Microsoft Office 2003 外觀的範例,請參閱 CMFCVisualManagerOffice2003 類別

所有繪圖方法都是虛擬的。 這可讓您為應用程式的 GUI 建立自訂視覺效果樣式。 如果您想要建立自己的視覺化樣式,請從其中一個視覺管理員類別衍生類別,並覆寫您想要變更的繪圖方法。

範例

此範例示範如何具現化標準和自訂 CMFCVisualManager 物件。

void CMFCSkinsApp::SetSkin (int iIndex)
{   // destroy the current visual manager
    if (CMFCVisualManager::GetInstance () != NULL)
    {
        delete CMFCVisualManager::GetInstance ();
    }
    switch (iIndex)
    {
    case 0:
        CMFCVisualManager::GetInstance ();
        // create the standard visual manager
        break;
    case 1:
        new CMyVisualManager ();
        // create the first custom visual manager
        break;
    case 2:
        new CMacStyle ();
        // create the second custom visual manager
        break;
    }
    // access the manager and set it properly
    CMFCVisualManager::GetInstance ()->SetLook2000 ();
    CMFCVisualManager::GetInstance ()->RedrawAll ();
}

下列範例示範如何擷取 物件的預設值 CMFCVisualManager 。 此程式碼片段是 [工作窗格] 範例 一部分。

int m_nVMargin;
int m_nHMargin;
int m_nGroupSpacing;
int m_nTaskSpacing;
int m_nCaptionHeight;
int m_nTaskOffset;
int m_nIconOffset;

繼承階層架構

CObject

CMFCBaseVisualManager

CMFCVisualManager

需求

標頭: afxvisualmanager.h

CMFCVisualManager::AdjustFrames

static void __stdcall AdjustFrames();

備註

CMFCVisualManager::AdjustToolbars

static void __stdcall AdjustToolbars();

備註

CMFCVisualManager::AlwaysHighlight3DTabs

架構會呼叫此方法,以判斷應用程式中是否一律應反白顯示 3D 索引標籤。

virtual BOOL AlwaysHighlight3DTabs() const;

傳回值

TRUE 如果應該反白顯示 3D 索引標籤,則為 。

備註

覆寫衍生視覺效果管理員中的此函式,如果一律應該反白顯示 3D 索引標籤,則傳回 TRUE。 這個方法的預設實作會傳回 FALSE。

CMFCVisualManager::CMFCVisualManager

CMFCVisualManager(BOOL bTemporary = FALSE);

參數

[in] bTemporary

備註

CMFCVisualManager::D estroyInstance

static void __stdcall DestroyInstance(BOOL bAutoDestroyOnly = FALSE);

參數

[in] bAutoDestroyOnly

備註

CMFCVisualManager::D oDrawHeaderSortArrow

void DoDrawHeaderSortArrow(
    CDC* pDC,
    CRect rect,
    BOOL bIsUp,
    BOOL bDlgCtrl);

參數

[in] Pdc
[in] 矩形
[in] bIsUp
[in] bDlgCtrl

備註

CMFCVisualManager::D rawComboBorderWinXP

virtual BOOL DrawComboBorderWinXP(CDC*,
    CRect,
    BOOL,
    BOOL,
    BOOL);

參數

[輸入] CDC*
[in] CRect
[in] Bool

傳回值

備註

CMFCVisualManager::D rawComboDropButtonWinXP

virtual BOOL DrawComboDropButtonWinXP(CDC*,
    CRect,
    BOOL,
    BOOL,
    BOOL);

參數

[輸入] CDC*
[輸入] CRect
[輸入] BOOL

傳回值

備註

CMFCVisualManager::D rawPushButtonWinXP

virtual BOOL DrawPushButtonWinXP(CDC*,
    CRect,
    CMFCButton*,
    UINT);

參數

[輸入] CDC*
[輸入] CRect
[輸入] CMFCButton*
[輸入] UINT

傳回值

備註

CMFCVisualManager::D rawTextOnGlass

virtual BOOL DrawTextOnGlass(
    CDC* pDC,
    CString strText,
    CRect rect,
    DWORD dwFlags,
    int nGlowSize = 0,
    COLORREF clrText = (COLORREF)-1);

參數

[in] Pdc
[in] strText
[in] 矩形
[in] dwFlags
[in] nGlowSize
[in] clrText

傳回值

備註

CMFCVisualManager::EnableToolbarButtonFill

void EnableToolbarButtonFill(BOOL bEnable = TRUE);

參數

[in] bEnable

備註

CMFCVisualManager::GetAutoHideButtonTextColor

架構會呼叫此方法,以擷取自動隱藏按鈕的文字色彩。

virtual COLORREF GetAutoHideButtonTextColor(CMFCAutoHideButton* pButton);

參數

pButton
[in]自動隱藏按鈕的指標。

傳回值

指定 pButton 文字色彩的 COLORREF 參數。

備註

覆寫衍生類別中的這個方法,以自訂應用程式中自動隱藏按鈕的文字色彩。 若要這樣做,請傳回您希望應用程式用來做為文字色彩的色彩。

CMFCVisualManager::GetButtonExtraBorder

架構會在繪製工具列按鈕時呼叫此方法。

virtual CSize GetButtonExtraBorder() const;

傳回值

CSize 物件,其中包含工具列按鈕的額外框線大小。

備註

有些面板必須延伸工具列按鈕的框線。 在自訂視覺效果管理員中覆寫此方法,以擴充應用程式中工具列按鈕的框線。 這個方法的預設實作會傳回空白大小。

CMFCVisualManager::GetCaptionBarTextColor

架構會呼叫此方法,以擷取標題列中的文字色彩。

virtual COLORREF GetCaptionBarTextColor(CMFCCaptionBar* pBar);

參數

pBar
[in]標題列的指標。

傳回值

COLORREF 參數,指出 pBar 文字的色彩。

備註

覆寫衍生類別中的這個方法,以自訂標題列的文字色彩。 在覆寫的 方法中,傳回所需的色彩。

CMFCVisualManager::GetCaptionButtonExtraBorder

virtual CSize GetCaptionButtonExtraBorder() const;

傳回值

備註

CMFCVisualManager::GetDockingPaneCaptionExtraHeight

virtual int GetDockingPaneCaptionExtraHeight() const;

傳回值

備註

CMFCVisualManager::GetDockingTabsBordersSize

架構會在繪製停駐和索引標籤的窗格時呼叫此方法。

virtual int GetDockingTabsBordersSize();

傳回值

整數,表示停駐和定位窗格的框線大小。

備註

當使用者將多個窗格停駐到您應用程式中的相同位置時,停駐窗格會變成索引標籤。

在自訂視覺效果管理員中覆寫這個方法,以變更固定索引標籤式控制列的框線大小。 預設的實作會傳回 -1。

CMFCVisualManager::GetHighlightedMenuItemTextColor

virtual COLORREF GetHighlightedMenuItemTextColor(CMFCToolBarMenuButton* pButton);

參數

[in] pButton

傳回值

備註

CMFCVisualManager::GetInstance

傳回應用程式的目前 CMFCVisualManager Class 物件的指標。

static CMFCVisualManager* GetInstance();

傳回值

CMFCVisualManager 物件的指標。

備註

應用程式只能有一個 CMFCVisualManager 與其相關聯的物件。 這包括衍生自 CMFCVisualManager 類別的任何物件。 這個方法會傳回相關聯 CMFCVisualManager 物件的指標。 如果應用程式沒有相關聯的 CMFCVisualManager 物件,這個方法會建立一個物件,並將它與應用程式產生關聯。

CMFCVisualManager::GetMDITabsBordersSize

架構會呼叫此方法,以在繪製視窗之前,先判斷 MDITabs 視窗的框線大小。

virtual int GetMDITabsBordersSize();

傳回值

MDITabs 視窗的框線大小。

備註

覆寫衍生類別中的這個函式,以自訂 MDITabs 視窗的框線大小。

CMFCVisualManager::GetMenuImageMargin

virtual int GetMenuImageMargin() const;

傳回值

備註

CMFCVisualManager::GetMenuItemTextColor

virtual COLORREF GetMenuItemTextColor(
    CMFCToolBarMenuButton* pButton,
    BOOL bHighlighted,
    BOOL bDisabled);

參數

[in] pButton
[in] bHighlighted
[in] bDisabled

傳回值

備註

CMFCVisualManager::GetMenuShadowDepth

擷取功能表陰影的寬度和高度。

int GetMenuShadowDepth() const;

傳回值

功能表陰影的寬度和高度,以圖元為單位。

備註

功能表陰影的寬度和高度是相等的。 預設值為 7 圖元。

CMFCVisualManager::GetNcBtnSize

當架構必須擷取系統按鈕的大小時,由架構呼叫。

virtual CSize GetNcBtnSize(BOOL bSmall) const;

參數

bSmall
[in]布林參數,指出是否 GetNcBtnSize 應該擷取小型或大型系統按鈕的大小。 如果 bSmall 為 TRUE, GetNcBtnSize 則傳回小型系統按鈕的大小。 否則,它會傳回大型系統按鈕的大小。

傳回值

CSize 參數,表示系統按鈕的大小。

備註

系統按鈕是對應至 [關閉 ]、[最小化]、 [最大化 ] 和 [還原 ] 命令 之框架視窗標題中的按鈕。 這些按鈕的大小取決於目前的視覺化管理員。 如果您想要自訂應用程式中系統按鈕的大小,請覆寫此方法。

CMFCVisualManager::GetPopupMenuBorderSize

架構會呼叫此方法,以取得快顯功能表的框線大小。

virtual int GetPopupMenuBorderSize() const;

傳回值

指定快顯功能表框線大小的整數。

備註

覆寫此方法,以自訂應用程式中快顯功能表的框線大小。

CMFCVisualManager::GetPopupMenuGap

virtual int GetPopupMenuGap() const;

傳回值

備註

CMFCVisualManager::GetPropertyGridGroupColor

架構會呼叫此方法以取得屬性清單的背景色彩。

virtual COLORREF GetPropertyGridGroupColor(CMFCPropertyGridCtrl* pPropList);

參數

pPropList
[in]架構所繪製之屬性清單的指標。

傳回值

指出 pPropList 背景色彩的 COLORREF 參數。

備註

覆寫此函式,以自訂應用程式中屬性清單的背景色彩。

CMFCVisualManager::GetPropertyGridGroupTextColor

架構會呼叫此方法,以擷取屬性清單的文字色彩。

virtual COLORREF GetPropertyGridGroupTextColor(CMFCPropertyGridCtrl* pPropList);

參數

pPropList
[in]屬性清單的指標。

傳回值

COLORREF 參數,表示屬性清單的文字色彩。

備註

覆寫此函式,以自訂應用程式中屬性清單的文字色彩。

CMFCVisualManager::GetRibbonHyperlinkTextColor

virtual COLORREF GetRibbonHyperlinkTextColor(CMFCRibbonLinkCtrl* pHyperLink);

參數

[in] pHyperLink

傳回值

備註

CMFCVisualManager::GetRibbonPopupBorderSize

virtual int GetRibbonPopupBorderSize(const CMFCRibbonPanelMenu*) const;

參數

[輸入] CMFCRibbonPanelMenu*

傳回值

備註

CMFCVisualManager::GetRibbonQuickAccessToolBarChevronOffset

virtual int GetRibbonQuickAccessToolBarChevronOffset();

傳回值

備註

CMFCVisualManager::GetRibbonQuickAccessToolBarRightMargin

virtual int GetRibbonQuickAccessToolBarRightMargin();

傳回值

備註

CMFCVisualManager::GetRibbonQuickAccessToolBarTextColor

virtual COLORREF GetRibbonQuickAccessToolBarTextColor(BOOL bDisabled = FALSE);

參數

[in] bDisabled

傳回值

備註

CMFCVisualManager::GetRibbonSliderColors

virtual void GetRibbonSliderColors(
    CMFCRibbonSlider* pSlider,
    BOOL bIsHighlighted,
    BOOL bIsPressed,
    BOOL bIsDisabled,
    COLORREF& clrLine,
    COLORREF& clrFill);

參數

[in] pSlider
[in] bIsHighlighted
[in] bIsPressed
[in] bIsDisabled
[in] clrLine
[in] clrFill

備註

CMFCVisualManager::GetRibbonStatusBarTextColor

virtual COLORREF GetRibbonStatusBarTextColor(CMFCRibbonStatusBar* pStatusBar);

參數

[in] pStatusBar

傳回值

備註

CMFCVisualManager::GetShowAllMenuItemsHeight

virtual int GetShowAllMenuItemsHeight(
    CDC* pDC,
    const CSize& sizeDefault);

參數

[in] Pdc
[in] sizeDefault

傳回值

備註

CMFCVisualManager::GetSmartDockingBaseGuideColors

virtual void GetSmartDockingBaseGuideColors(
    COLORREF& clrBaseGroupBackground,
    COLORREF& clrBaseGroupBorder);

參數

[in] clrBaseGroupBackground
[in] clrBaseGroupBorder

備註

CMFCVisualManager::GetSmartDockingHighlightToneColor

virtual COLORREF GetSmartDockingHighlightToneColor();

傳回值

備註

CMFCVisualManager::GetSmartDockingTheme

傳回用來顯示智慧停駐標記的主題。

virtual AFX_SMARTDOCK_THEME GetSmartDockingTheme();

傳回值

傳回下列其中一個列舉值:AFX_SDT_DEFAULT、AFX_SDT_VS2005、AFX_SDT_VS2008。

備註

CMFCVisualManager::GetStatusBarPaneTextColor

virtual COLORREF GetStatusBarPaneTextColor(
    CMFCStatusBar* pStatusBar,
    CMFCStatusBarPaneInfo* pPane);

參數

[in] pStatusBar
[in] pPane

傳回值

備註

CMFCVisualManager::GetTabFrameColors

架構必須擷取繪製索引標籤視窗的色彩集時,會呼叫此函式。

virtual void GetTabFrameColors(
    const CMFCBaseTabCtrl* pTabWnd,
    COLORREF& clrDark,
    COLORREF& clrBlack,
    COLORREF& clrHighlight,
    COLORREF& clrFace,
    COLORREF& clrDarkShadow,
    COLORREF& clrLight,
    CBrush*& pbrFace,
    CBrush*& pbrBlack);

參數

pTabWnd
[in]索引標籤視窗的指標,其中框架正在繪製索引標籤。

clrDark
[out]COLORREF 參數的 參考,這個方法會儲存索引標籤深框線的色彩。

clrBlack
[out]COLORREF 參數的參考,這個方法會儲存索引標籤視窗框線的色彩。 框線的預設色彩為黑色。

clrHighlight
[out]COLORREF 參數的參考,這個方法會儲存索引標籤視窗反白顯示狀態的色彩。

clrFace
[out]COLORREF 參數的參考,這個方法會儲存索引標籤視窗臉部的色彩。

clrDarkShadow
[out]COLORREF 參數的參考,這個方法會儲存索引標籤視窗陰影的色彩。

clrLight
[out]COLORREF 參數的參考,這個方法會儲存索引標籤視窗淺邊緣的色彩。

pbrFace
[out]筆刷參考的指標。 這個方法會儲存用來填滿此參數中索引標籤視窗臉部的筆刷。

pbrBlack
[out]筆刷參考的指標。 這個方法會儲存用來填滿此參數中索引標籤視窗黑色邊緣的筆刷。

備註

如果您想要自訂架構在繪製索引標籤視窗時所使用的一組色彩,請覆寫衍生類別中的這個函式。

CMFCVisualManager::GetTabHorzMargin

virtual int GetTabHorzMargin(const CMFCBaseTabCtrl*);

參數

[輸入] CMFCBaseTabCtrl*

傳回值

備註

CMFCVisualManager::GetTabTextColor

virtual COLORREF GetTabTextColor(
    const CMFCBaseTabCtrl*,
    int,
    BOOL);

參數

[輸入] CMFCBaseTabCtrl*
[輸入] int
[輸入] BOOL

傳回值

備註

CMFCVisualManager::GetTasksPaneGroupCaptionHeight

int GetTasksPaneGroupCaptionHeight() const;

傳回值

備註

CMFCVisualManager::GetTasksPaneGroupCaptionHorzOffset

int GetTasksPaneGroupCaptionHorzOffset() const;

傳回值

備註

CMFCVisualManager::GetTasksPaneGroupCaptionVertOffset

int GetTasksPaneGroupCaptionVertOffset() const;

傳回值

備註

CMFCVisualManager::GetTasksPaneGroupVertOffset

int GetTasksPaneGroupVertOffset() const;

傳回值

備註

CMFCVisualManager::GetTasksPaneHorzMargin

int GetTasksPaneHorzMargin() const;

傳回值

備註

CMFCVisualManager::GetTasksPaneIconHorzOffset

int GetTasksPaneIconHorzOffset() const;

傳回值

備註

CMFCVisualManager::GetTasksPaneIconVertOffset

int GetTasksPaneIconVertOffset() const;

傳回值

備註

CMFCVisualManager::GetTasksPaneTaskHorzOffset

int GetTasksPaneTaskHorzOffset() const;

傳回值

備註

CMFCVisualManager::GetTasksPaneVertMargin

int GetTasksPaneVertMargin() const;

傳回值

備註

CMFCVisualManager::GetToolbarButtonTextColor

架構會呼叫此方法,以判斷工具列按鈕的文字色彩。

virtual COLORREF GetToolbarButtonTextColor(
    CMFCToolBarButton* pButton,
    CMFCVisualManager::AFX_BUTTON_STATE state);

參數

pButton
[in]工具列按鈕的指標。

state
[in]工具列按鈕的狀態。

傳回值

pButton 的文字色彩 ,其狀態會以 狀態 表示。

備註

CMFCToolBarButton Class 物件的文字色彩 取決於按鈕的狀態。 工具列按鈕的可能狀態為 ButtonsIsRegularButtonsIsPressedButtonsIsHighlighted

覆寫此函式,以自訂應用程式中工具列按鈕的文字色彩。

CMFCVisualManager::GetToolBarCustomizeButtonMargin

virtual int GetToolBarCustomizeButtonMargin() const;

傳回值

備註

CMFCVisualManager::GetToolbarDisabledColor

virtual COLORREF GetToolbarDisabledColor() const;

傳回值

備註

CMFCVisualManager::GetToolbarDisabledTextColor

架構會呼叫此函式,以判斷無法使用之工具列按鈕的文字色彩。

virtual COLORREF GetToolbarDisabledTextColor();

傳回值

架構用於無法使用之工具列按鈕文字色彩的色彩。

備註

在自訂視覺效果管理員中覆寫這個方法,以設定無法使用的工具列按鈕文字色彩。

CMFCVisualManager::GetToolbarHighlightColor

virtual COLORREF GetToolbarHighlightColor();

傳回值

備註

CMFCVisualManager::GetToolTipInfo

virtual BOOL GetToolTipInfo(
    CMFCToolTipInfo& params,
    UINT nType = (UINT)(-1));

參數

[in] Params
[in] nType

傳回值

備註

CMFCVisualManager::HasOverlappedAutoHideButtons

傳回目前視覺化管理員中自動隱藏按鈕是否重迭。

virtual BOOL HasOverlappedAutoHideButtons() const;

傳回值

如果自動隱藏按鈕重迭,則為 TRUE;如果不是,則為 FALSE。

CMFCVisualManager::IsAutoDestroy

BOOL IsAutoDestroy() const;

傳回值

備註

CMFCVisualManager::IsDefaultWinXPPopupButton

virtual BOOL IsDefaultWinXPPopupButton(CMFCDesktopAlertWndButton*) const;

參數

[輸入] CMFCDesktopAlertWndButton*

傳回值

備註

CMFCVisualManager::IsDockingTabHasBorder

傳回目前視覺化管理員是否會在停駐和定位點窗格周圍繪製框線。

virtual BOOL IsDockingTabHasBorder();

傳回值

如果視覺管理員在停駐和定位窗格周圍繪製框線,則為 TRUE;否則為 FALSE。

備註

當多個窗格停駐至相同位置時,停駐窗格會變成索引標籤。

CMFCVisualManager::IsEmbossDisabledImage

指定架構是否會浮凸無法使用的映射。

BOOL IsEmbossDisabledImage() const;

傳回值

如果架構浮凸影像無法使用,則為非零;否則為 0。

備註

當 CMFCToolBarImages::D raw 在無法使用的工具列上繪製影像時,會呼叫 這個方法。

CMFCVisualManager::IsFadeInactiveImage

架構會在工具列或功能表中繪製非使用中的影像時,呼叫此方法。

BOOL IsFadeInactiveImage() const;

傳回值

如果架構在工具列或功能表中繪製非作用中的影像時使用光源效果,則為非零;否則為 0。

備註

您可以呼叫 CMFCVisualManager::SetFadeInactiveImage 來啟動或停用光源效果。 光源效果是讓無法使用的影像呈現淡出的結果。

CMFCVisualManager::IsFrameMenuCheckedItems

BOOL IsFrameMenuCheckedItems() const;

傳回值

備註

CMFCVisualManager::IsHighlightOneNoteTabs

virtual BOOL IsHighlightOneNoteTabs() const;

傳回值

備註

CMFCVisualManager::IsHighlight神秘leMenuItem

virtual BOOL IsHighlightWholeMenuItem();

傳回值

備註

CMFCVisualManager::IsLayeredRibbonKeyTip

virtual BOOL IsLayeredRibbonKeyTip() const;

傳回值

備註

CMFCVisualManager::IsMenuFlatLook

指出功能表按鈕是否顯示為一般。

BOOL IsMenuFlatLook() const;

傳回值

如果功能表按鈕顯示為一般,則為非零;否則為 0。

備註

根據預設,功能表按鈕不會顯示為一般。 使用 CMFCVisualManager::SetMenuFlatLook 方法來變更此行為。 當功能表按鈕顯示為一般時,當使用者按一下它們時,它們不會變更外觀。

CMFCVisualManager::IsOfficeXPStyleMenus

指出視覺管理員是否實作 Office XP 樣式功能表。

virtual BOOL IsOfficeXPStyleMenus() const;

傳回值

如果視覺效果管理員顯示 Office XP 樣式功能表,則為非零;否則為 0。

備註

CMFCPopupMenu 類別 必須繪製功能表和陰影時,會呼叫此方法。 根據預設,此方法會傳回 FALSE。 如果您想要使用類似于 Office XP 中快顯功能表的快顯功能表,請在自訂視覺效果管理員中覆寫此方法,並傳回 TRUE。

CMFCVisualManager::IsOffsetPressedButton

virtual BOOL IsOffsetPressedButton() const;

傳回值

備註

CMFCVisualManager::IsOwnerDrawCaption

指出目前的視覺化管理員是否實作擁有者繪製標題。

virtual BOOL IsOwnerDrawCaption();

傳回值

如果應用程式中的所有框架視窗都有擁有者繪製標題,則為 TRUE;否則為 FALSE。

CMFCVisualManager::IsOwnerDrawMenuCheck

virtual BOOL IsOwnerDrawMenuCheck();

傳回值

備註

CMFCVisualManager::IsShadowHighlightedImage

指出視覺化管理員在呈現醒目提示影像時是否顯示陰影。

BOOL IsShadowHighlightedImage() const;

傳回值

當視覺管理員在醒目提示影像下顯示陰影時,非零;否則為 0。

CMFCVisualManager::IsToolbarButtonFillEnabled

BOOL IsToolbarButtonFillEnabled() const;

傳回值

備註

CMFCVisualManager::IsToolbarRoundShape

virtual BOOL IsToolbarRoundShape(CMFCToolBar*);

參數

[輸入] CMFCToolBar*

傳回值

備註

CMFCVisualManager::IsWindowsThemingSupported

virtual BOOL IsWindowsThemingSupported() const;

傳回值

備註

CMFCVisualManager::OnActivateApp

virtual void OnActivateApp(
    CWnd* pWnd,
    BOOL bActive);

參數

[in] pWnd
[in] bActive

備註

CMFCVisualManager::OnDrawAutoHideButtonBorder

當它繪製自動隱藏按鈕的邊框時,架構會呼叫這個方法。

virtual void OnDrawAutoHideButtonBorder(
    CDC* pDC,
    CRect rectBounds,
    CRect rectBorderSize,
    CMFCAutoHideButton* pButton);

參數

pDC
[in]裝置內容的指標。

rectBounds
[in]自動隱藏按鈕的大小和位置。

rectBorderSize
[in] 包含框線大小的 CRect 參數。

pButton
[in]自動隱藏按鈕的指標。 架構正在繪製此按鈕的框線。

備註

如果您想要自訂自動隱藏按鈕框線的外觀,請覆寫衍生類別中的這個方法。 根據預設,此方法會以應用程式的預設陰影色彩填滿一般框線。

rectBorderSize 參數不包含框線的座標。 它包含 、 bottomleft 和資料 right 成員中 top 框線的大小。 小於或等於 0 的值表示自動隱藏按鈕的該邊沒有框線。

CMFCVisualManager::OnDrawBarGripper

當架構繪製控制項列的夾板時,由架構呼叫。

virtual void OnDrawBarGripper(
    CDC* pDC,
    CRect rectGripper,
    BOOL bHorz,
    CBasePane* pBar);

參數

pDC
[in]控制項列之裝置內容的指標。

rectGripper
[in]控制項列的周框。

bHorz
[in]布林參數,指定控制列是水準還是垂直停駐。

pBar
[in]控制項列的指標。 視覺效果管理員會繪製這個控制列的夾板。

備註

這個方法的預設實作會顯示標準夾。 若要自訂移駐夾的外觀,請在衍生自 類別的 CMFCVisualManager 自訂類別中覆寫此方法。

CMFCVisualManager::OnDrawBrowseButton

架構會在繪製編輯控制項的瀏覽按鈕時呼叫此方法。

virtual BOOL OnDrawBrowseButton(
    CDC* pDC,
    CRect rect,
    CMFCEditBrowseCtrl* pEdit,
    CMFCVisualManager::AFX_BUTTON_STATE state,
    COLORREF& clrText);

參數

pDC
[in]裝置內容的指標。

矩形
[in]指定瀏覽按鈕界限的矩形。

pEdit
[in]編輯控制項的指標。 視覺效果管理員會繪製此編輯控制項的瀏覽按鈕。

state
[in]指定按鈕狀態的列舉值。

clrText
[out]COLORREF 參數的 參考。 這是保留的值,目前未使用。

傳回值

如果成功,則為 TRUE,否則為 FALSE。

備註

如果您想要在 CMFCEditBrowseCtrl 類別 的實例中自訂瀏覽按鈕的外觀,請覆寫衍生類別中的 此函式。 按鈕 ButtonsIsRegular 狀態的可能值為 、 ButtonsIsPressedButtonsIsHighlighted

CMFCVisualManager::OnDrawButtonBorder

架構會在繪製工具列按鈕的框線時呼叫此方法。

virtual void OnDrawButtonBorder(
    CDC* pDC,
    CMFCToolBarButton* pButton,
    CRect rect,
    CMFCVisualManager::AFX_BUTTON_STATE state);

參數

pDC
[in]工具列按鈕之裝置內容的指標。

pButton
[in]工具列按鈕的指標。 架構會繪製此按鈕的框線。

矩形
[in]指定工具列按鈕界限的矩形。

state
[in]指定工具列按鈕目前狀態的列舉資料類型。

備註

這個方法的預設實作會顯示標準框線。 覆寫衍生視覺效果管理員中的這個方法,以自訂工具列按鈕框線的外觀。

工具列按鈕的可能狀態為 ButtonsIsRegularButtonsIsPressedButtonsIsHighlighted

CMFCVisualManager::OnDrawButtonSeparator

virtual void OnDrawButtonSeparator(
    CDC* pDC,
    CMFCToolBarButton* pButton,
    CRect rect,
    CMFCVisualManager::AFX_BUTTON_STATE state,
    BOOL bHorz);

參數

[in] Pdc
[in] pButton
[in] 矩形
[in] 狀態
[in] bHorz

備註

CMFCVisualManager::OnDrawCaptionBarBorder

架構會在繪製 CMFCCaptionBar 類別 物件的框線 時呼叫這個方法。

virtual void OnDrawCaptionBarBorder(
    CDC* pDC,
    CMFCCaptionBar* pBar,
    CRect rect,
    COLORREF clrBarBorder,
    BOOL bFlatBorder);

參數

pDC
[in]裝置內容的指標。

pBar
[in]物件的指標 CMFCCaptionBar 。 架構會繪製此標題列。

矩形
[in]指定標題列界限的矩形。

clrBarBorder
[in]框線的色彩。

bFlatBorder
[in]布林參數,指定框線是否具有平面 2D 外觀。

備註

覆寫衍生類別中的這個方法,以自訂標題列框線的框線外觀。

CMFCVisualManager::OnDrawCaptionBarButtonBorder

virtual void OnDrawCaptionBarButtonBorder(
    CDC* pDC,
    CMFCCaptionBar* pBar,
    CRect rect,
    BOOL bIsPressed,
    BOOL bIsHighlighted,
    BOOL bIsDisabled,
    BOOL bHasDropDownArrow,
    BOOL bIsSysButton);

參數

[in] Pdc
[in] pBar
[in] 矩形
[in] bIsPressed
[in] bIsHighlighted
[in] bIsDisabled
[in] bHasDropDownArrow
[in] bIsSysButton

備註

CMFCVisualManager::OnDrawCaptionBarInfoArea

virtual void OnDrawCaptionBarInfoArea(
    CDC* pDC,
    CMFCCaptionBar* pBar,
    CRect rect);

參數

[in] Pdc
[in] pBar
[in] 矩形

備註

CMFCVisualManager::OnDrawCaptionButton

架構會在繪製 CMFCCaptionButton 物件時呼叫此方法。

virtual void OnDrawCaptionButton (
    CDC* pDC,
    CMFCCaptionButton* pButton,
    BOOL bActive,
    BOOL bHorz,
    BOOL bMaximized,
    BOOL bDisabled,
    int nImageID = -1);

參數

pDC
[in]裝置內容的指標。

pButton
[in]物件的指標 CMFCCaptionButton 。 架構會繪製此標題按鈕。

bActive
[in]布林參數,指定按鈕是否為使用中。

bHorz
[in]布林參數,指定標題是否為水準。

bMaximized
[in]布林參數,指定父窗格是否最大化。

bDisabled
[in]布林參數,指定是否停用標題按鈕。

nImageID
[in]用於按鈕之圖示的影像索引。 如果 nImageID 是 -1,這個方法會使用 pButton 中記錄的 影像索引。

備註

這個方法的預設實作會顯示 類別全域實例 CMenuImages 中的小型按鈕。 按鈕會列在 的標頭檔中 CMenuImages 。 某些範例包括 CMenuImages::IdCloseCMenuImages::IdArowLeftCMenuImages::IdArowRightCMenuImages::IdArowDownCMenuImages::IdArowUp 、 和 CMenuImages::IdPinHorz

覆寫衍生類別中的這個方法,以自訂標題按鈕的外觀。

CMFCVisualManager::OnDrawCheckBox

virtual void OnDrawCheckBox(
    CDC* pDC,
    CRect rect,
    BOOL bHighlighted,
    BOOL bChecked,
    BOOL bEnabled);

參數

[in] Pdc
[in] 矩形
[in] bHighlighted
[in] bChecked
[in] bEnabled

備註

CMFCVisualManager::OnDrawCheckBoxEx

virtual void OnDrawCheckBoxEx(
    CDC* pDC,
    CRect rect,
    int nState,
    BOOL bHighlighted,
    BOOL bPressed,
    BOOL bEnabled);

參數

[in] Pdc
[in] 矩形
[in] nState
[in] bHighlighted
[in] bPressed
[in] bEnabled

備註

CMFCVisualManager::OnDrawComboBorder

當架構在 CMFCToolBarComboBoxButton 類別 的實例 周圍繪製框線時,會呼叫這個方法。

virtual void OnDrawComboBorder(
    CDC* pDC,
    CRect rect,
    BOOL bDisabled,
    BOOL bIsDropped,
    BOOL bIsHighlighted,
    CMFCToolBarComboBoxButton* pButton);

參數

pDC
[in]下拉式方塊按鈕之裝置內容的指標。

矩形
[in]指定下拉式方塊按鈕界限的矩形。

bDisabled
[in]布林參數,指出下拉式方塊按鈕是否無法使用。

bIsDropped
[in]布林參數,指出下拉式方塊是否已卸載。

bIsHighlighted
[in]布林參數,指出是否反白顯示下拉式方塊按鈕。

pButton
[in]物件的指標 CMFCToolBarComboBoxButton 。 架構會繪製此下拉式方塊按鈕。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂下拉式方塊框線的外觀。

CMFCVisualManager::OnDrawComboDropButton

架構會在繪製 CMFCToolBarComboBoxButton 下拉按鈕時呼叫此方法。

virtual void OnDrawComboDropButton(
    CDC* pDC,
    CRect rect,
    BOOL bDisabled,
    BOOL bIsDropped,
    BOOL bIsHighlighted,
    CMFCToolBarComboBoxButton* pButton);

參數

pDC
[in]裝置內容的指標。

矩形
[in]指定置放按鈕界限的矩形。

bDisabled
[in]布林參數,指出卸載按鈕是否無法使用。

bIsDropped
[in]布林參數,指出下拉式方塊是否已卸載。

bIsHighlighted
[in]布林參數,指出是否反白顯示下拉式按鈕。

pButton
[in]物件的指標 CMFCToolBarComboBoxButton 。 架構會繪製此下拉式方塊按鈕的下拉式按鈕。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂下拉式方塊按鈕的下拉式按鈕外觀。

CMFCVisualManager::OnDrawControlBorder

virtual void OnDrawControlBorder(CWnd* pWndCtrl);

參數

[in] pWndCtrl

備註

CMFCVisualManager::OnDrawDefaultRibbonImage

架構會在繪製用於功能區按鈕的預設影像時呼叫此方法。

virtual void OnDrawDefaultRibbonImage(
    CDC* pDC,
    CRect rectImage,
    BOOL bIsDisabled = FALSE,
    BOOL bIsPressed = FALSE,
    BOOL bIsHighlighted = FALSE);

參數

pDC
[in]裝置內容的指標。

rectImage
[in]指定預設影像界限的矩形。

bIsDisabled
[in]布林參數,指出功能區按鈕是否無法使用。

bIsPressed
[in]布林參數,指出是否按下功能區按鈕。

bIsHighlighted
[in]布林參數,指出功能區按鈕是否反白顯示。

備註

如果您想要自訂功能區按鈕所使用的影像,請覆寫衍生視覺效果管理員中的這個方法。

CMFCVisualManager::OnDrawEditBorder

架構在 CMFCToolBarEditBoxButton 類別 的實例 周圍繪製框線時,會呼叫這個方法。

virtual void OnDrawEditBorder(
    CDC* pDC,
    CRect rect,
    BOOL bDisabled,
    BOOL bIsHighlighted,
    CMFCToolBarEditBoxButton* pButton);

參數

pDC
[in]裝置內容的指標。

矩形
[in]指定 物件界限的 CMFCToolBarEditBoxButton 矩形。

bDisabled
[in]布林參數,指出按鈕是否無法使用。

bIsHighlighted
[in]布林參數,指出按鈕是否反白顯示。

pButton
[in]物件的指標 CMFCToolBarEditBoxButton 。 架構會繪製此編輯方塊按鈕的框線。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂物件的框線 CMFCToolBarEditBoxButton

CMFCVisualManager::OnDrawExpandingBox

virtual void OnDrawExpandingBox(
    CDC* pDC,
    CRect rect,
    BOOL bIsOpened,
    COLORREF colorBox);

參數

[in] Pdc
[in] 矩形
[in] bIsOpened
[in] colorBox

備註

CMFCVisualManager::OnDrawFloatingToolbarBorder

架構會在繪製浮動工具列的框線時呼叫此方法。

virtual void OnDrawFloatingToolbarBorder(
    CDC* pDC,
    CMFCBaseToolBar* pToolBar,
    CRect rectBorder,
    CRect rectBorderSize);

參數

pDC
[in]裝置內容的指標。

pToolBar
[in]浮動工具列的指標。

rectBorder
[in]指定浮動工具列界限的矩形。

rectBorderSize
[in]指定工具列框線大小的矩形。

備註

浮動工具列是顯示為迷你框架視窗的工具列。 通常,當使用者拖曳工具列,使其不再停駐時,就會發生這種情況。

框線的大小是由 rectBorderSize 中的 對應參數所指定。 例如,工具列上框線的寬度是由 rectBorderSize.top 指定。

覆寫衍生視覺效果管理員中的這個方法,以自訂浮動工具列框線的外觀。

CMFCVisualManager::OnDrawHeaderCtrlBorder

當架構在 CMFCHeaderCtrl 類別 的實例 周圍繪製框線時,會呼叫這個方法。

virtual void OnDrawHeaderCtrlBorder(
    CMFCHeaderCtrl* pCtrl,
    CDC* pDC,
    CRect& rect,
    BOOL bIsPressed,
    BOOL bIsHighlighted);

參數

pCtrl
[in]物件的指標 CMFCHeaderCtrl 。 架構會繪製此標頭控制項的框線。

pDC
[in]裝置內容的指標。

矩形
[in]指定標頭控制項界限的矩形。

bIsPressed
[in]布林參數,指出是否按下標頭控制項。

bIsHighlighted
[in]布林參數,指出標頭控制項是否反白顯示。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂標頭控制項的框線。

CMFCVisualManager::OnDrawHeaderCtrlSortArrow

架構會在繪製標頭控制項的排序箭號時呼叫此函式。

virtual void OnDrawHeaderCtrlSortArrow(
    CMFCHeaderCtrl* pCtrl,
    CDC* pDC,
    CRect& rect,
    BOOL bIsUp);

參數

pCtrl
[in]標頭控制項的指標。 視覺效果管理員會繪製這個 CMFCHeaderCtrl 類別物件的排序箭號

pDC
[in]裝置內容的指標。

矩形
[in]指定排序箭號界限的矩形。

bIsUp
[in]指定排序箭號方向的布林值。

備註

如果 bIsUp 為 TRUE,視覺化管理員會繪製向上排序箭號。 如果是 FALSE,視覺效果管理員會繪製向下排序箭號。 覆寫 OnDrawHeaderCtrlSortArrow 衍生類別中的 ,以自訂排序按鈕的外觀。

CMFCVisualManager::OnDrawMenuArrowOnCustomizeList

virtual void OnDrawMenuArrowOnCustomizeList(
    CDC* pDC,
    CRect rectCommand,
    BOOL bSelected);

參數

[in] Pdc
[in] rectCommand
[in] bSelected

備註

CMFCVisualManager::OnDrawMenuBorder

架構會在繪製 CMFCPopupMenu 框線時呼叫此方法。

virtual void OnDrawMenuBorder(
    CDC* pDC,
    CMFCPopupMenu* pMenu,
    CRect rect);

參數

pDC
[in]物件的裝置內容的 CMFCPopupMenu 指標。

pMenu
[in]物件的指標 CMFCPopupMenu 。 架構會在此快顯功能表周圍繪製框線。

矩形
[in]指定快顯功能表界限的矩形。

備註

這個方法的預設實作會顯示標準功能表框線。 覆寫衍生視覺效果管理員中的這個方法,以自訂功能表框線的外觀。

CMFCVisualManager::OnDrawMenuCheck

virtual void OnDrawMenuCheck(
    CDC* pDC,
    CMFCToolBarMenuButton* pButton,
    CRect rect,
    BOOL bHighlight,
    BOOL bIsRadio);

參數

[in] Pdc
[in] pButton
[in] 矩形
[in] bHighlight
[in] bIsRadio

備註

CMFCVisualManager::OnDrawMenuItemButton

virtual void OnDrawMenuItemButton(
    CDC* pDC,
    CMFCToolBarMenuButton* pButton,
    CRect rectButton,
    BOOL bHighlight,
    BOOL bDisabled);

參數

[in] Pdc
[in] pButton
[in] rectButton
[in] bHighlight
[in] bDisabled

備註

CMFCVisualManager::OnDrawMenuLabel

virtual COLORREF OnDrawMenuLabel(
    CDC* pDC,
    CRect rect);

參數

[in] Pdc
[in] 矩形

傳回值

備註

CMFCVisualManager::OnDrawMenuResizeBar

virtual void OnDrawMenuResizeBar(
    CDC* pDC,
    CRect rect,
    int nResizeFlags);

參數

[in] Pdc
[in] 矩形
[in] nResizeFlags

備註

CMFCVisualManager::OnDrawMenuScrollButton

架構會在繪製功能表捲動按鈕時呼叫此方法。

virtual void OnDrawMenuScrollButton(
    CDC* pDC,
    CRect rect,
    BOOL bIsScrollDown,
    BOOL bIsHighlited,
    BOOL bIsPressed,
    BOOL bIsDisabled);

參數

pDC
[in]裝置內容的指標。

矩形
[in]指定捲動按鈕界限的矩形。

bIsScrollDown
[in]布林值,指出視覺效果管理員繪製的按鈕類型。 TRUE 值表示視覺效果管理員繪製向下按鈕。

bIsHighlited
[in]布林值,指出按鈕是否反白顯示。

bIsPressed
[in]布林值,指出是否按下按鈕。

bIsDisabled
[in]布林值,指出按鈕是否停用。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂功能表捲動按鈕的外觀。 當功能表項目的總高度超過快顯功能表的高度時,功能表捲動按鈕會出現在快顯功能表的邊緣。

CMFCVisualManager::OnDrawMenuShadow

virtual void OnDrawMenuShadow(
    CDC* pDC,
    const CRect& rectClient,
    const CRect& rectExclude,
    int nDepth,
    int iMinBrightness,
    int iMaxBrightness,
    CBitmap* pBmpSaveBottom,
    CBitmap* pBmpSaveRight,
    BOOL bRTL);

參數

[in] Pdc
[in] rectClient
[in] rectExclude
[in] nDepth
[in] iMinBrightness
[in] iMaxBrightness
[in] pBmpSaveBottom
[in] pBmpSaveRight
[in] bRTL

備註

CMFCVisualManager::OnDrawMenuSystemButton

架構會在繪製應用程式的功能表系統按鈕時呼叫此方法。

virtual void OnDrawMenuSystemButton(
    CDC* pDC,
    CRect rect,
    UINT uiSystemCommand,
    UINT nStyle,
    BOOL bHighlight);

參數

pDC
[in]裝置內容的指標。

矩形
[in]指定按鈕界限的矩形。

uiSystemCommand
[in]旗標,指定哪個系統命令與按鈕相關聯。 可能的值為SC_CLOSE、SC_MINIMIZE和SC_RESTORE。

nStyle
[in]指定按鈕目前樣式的旗標。 可能的值為TBBS_PRESSED、TBBS_DISABLED和 0。

bHighlight
[in]布林參數,指定按鈕是否反白顯示。

備註

功能表系統按鈕是 位於標題列上的 [關閉 ]、 [最小化]、 [最大化 ] 和 [還原] 按鈕。

此方法的預設實作會呼叫 CDC::D rawFrameControl ,並具有DFC_CAPTION類型。 覆寫衍生視覺效果管理員類別中的這個方法,以自訂系統按鈕的外觀。

CMFCVisualManager::OnDrawMiniFrameBorder

virtual void OnDrawMiniFrameBorder(
    CDC* pDC,
    CPaneFrameWnd* pFrameWnd,
    CRect rectBorder,
    CRect rectBorderSize);

參數

[in] Pdc
[in] pFrameWnd
[in] rectBorder
[in] rectBorderSize

備註

CMFCVisualManager::OnDrawOutlookBarSplitter

架構會在繪製 Outlook 列的分隔器時呼叫此方法。

virtual void OnDrawOutlookBarSplitter(
    CDC* pDC,
    CRect rectSplitter);

參數

pDC
[in]裝置內容的指標。

rectSplitter
[in]指定分隔器界限的矩形。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂 Outlook 列上的分隔器外觀。

CMFCVisualManager::OnDrawOutlookPageButtonBorder

當架構繪製 Outlook 頁面按鈕的框線時,由架構呼叫。

virtual void OnDrawOutlookPageButtonBorder(
    CDC* pDC,
    CRect& rectBtn,
    BOOL bIsHighlighted,
    BOOL bIsPressed);

參數

pDC
[in]裝置內容的指標。

rectBtn
[in]指定 Outlook 頁面按鈕界限的矩形。

bIsHighlighted
[in]布林值,指定按鈕是否反白顯示。

bIsPressed
[in]布林值,指定是否按下按鈕。

備註

在自訂視覺效果管理員中覆寫這個方法,以變更 Outlook 頁面按鈕的外觀。

CMFCVisualManager::OnDrawPaneBorder

架構會在繪製 CPane Class 物件的框線 時呼叫此方法。

virtual void OnDrawPaneBorder(
    CDC* pDC,
    CBasePane* pBar,
    CRect& rect);

參數

pDC
[in]控制項列之裝置內容的指標。

pBar
[in]窗格的指標。 視覺效果管理員會繪製此窗格的框線。

矩形
[in]表示窗格界限的矩形。

備註

這個方法的預設實作會顯示標準框線。 覆寫衍生類別中的這個方法,以自訂框線的外觀。

CMFCVisualManager::OnDrawPaneCaption

架構會在繪製 CDockablePane 類別 實例 的標題時呼叫此方法。

virtual COLORREF OnDrawPaneCaption(
    CDC* pDC,
    CDockablePane* pBar,
    BOOL bActive,
    CRect rectCaption,
    CRect rectButtons);

參數

pDC
[in]裝置內容的指標。

pBar
[in]物件的指標 CDockablePane 。 架構會繪製此窗格的標題。

bActive
[in]布林值參數,指出控制列是否為使用中。

rectCaption
[in]指定標題界限的矩形。

rectButtons
[in]指定標題按鈕界限的矩形。

傳回值

COLORREF 參數,表示標題的文字色彩。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂窗格的外觀標題。

CMFCVisualManager::OnDrawPaneDivider

virtual void OnDrawPaneDivider(
    CDC* pDC,
    CPaneDivider* pSlider,
    CRect rect,
    BOOL bAutoHideMode);

參數

[in] Pdc
[in] pSlider
[in] 矩形
[in] bAutoHideMode

備註

CMFCVisualManager::OnDrawPopupWindowBorder

virtual void OnDrawPopupWindowBorder(
    CDC* pDC,
    CRect rect);

參數

[in] Pdc
[in] 矩形

備註

CMFCVisualManager::OnDrawPopupWindowButtonBorder

virtual void OnDrawPopupWindowButtonBorder(
    CDC* pDC,
    CRect rectClient,
    CMFCDesktopAlertWndButton* pButton);

參數

[in] Pdc
[in] rectClient
[in] pButton

備註

CMFCVisualManager::OnDrawPopupWindowCaption

virtual COLORREF OnDrawPopupWindowCaption(
    CDC* pDC,
    CRect rectCaption,
    CMFCDesktopAlertWnd* pPopupWnd);

參數

[in] Pdc
[in] rectCaption
[in] pPopupWnd

傳回值

備註

CMFCVisualManager::OnDrawRibbonApplicationButton

架構會在繪製功能區上的 [主按鈕 ] 時 呼叫此方法。

virtual void OnDrawRibbonApplicationButton(
    CDC* pDC,
    CMFCRibbonButton* pButton);

參數

pDC
[in]裝置內容的指標。

pButton
[in]功能區上 [主按鈕 ] 的指標

備註

如果您想要自訂主按鈕 的外觀,請覆寫衍生視覺效果管理員中的 這個方法。

CMFCVisualManager::OnDrawRibbonButtonBorder

架構會在繪製功能區上按鈕的框線時呼叫此方法。

virtual void OnDrawRibbonButtonBorder(
    CDC* pDC,
    CMFCRibbonButton* pButton);

參數

pDC
[in]裝置內容的指標。

pButton
[in]CMFCRibbonButton 物件的指標 。 架構會繪製這個功能區按鈕的框線。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂 的外觀 CMFCRibbonButton

CMFCVisualManager::OnDrawRibbonButtonsGroup

架構會在功能區上繪製一組按鈕時呼叫此方法。

virtual COLORREF OnDrawRibbonButtonsGroup(
    CDC* pDC,
    CMFCRibbonButtonsGroup* pGroup,
    CRect rectGroup);

參數

pDC
[in]裝置內容的指標。

pGroup
[in]功能區上按鈕群組的指標。 架構會繪製此按鈕群組。

rectGroup
[in]指定群組界限的矩形。

傳回值

保留的值。 預設的實作會傳回 -1。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂功能區上按鈕群組的外觀。

CMFCVisualManager::OnDrawRibbonCaption

架構會在繪製主框架視窗的標題列時呼叫此方法。 只有當功能區與主框架整合時,架構才會呼叫這個方法。

virtual void OnDrawRibbonCaption(
    CDC* pDC,
    CMFCRibbonBar* pBar,
    CRect rect,
    CRect rectText);

參數

pDC
[in]裝置內容的指標。

pBar
[in]功能區列的指標。 視覺效果管理員會繪製此功能區列。

矩形
[in]指定功能區列界限的矩形。

rectText
[in]矩形,指定標題列文字的界限。

備註

覆寫衍生視覺效果管理員中的此函式,以自訂標題列的外觀。 只有當功能區與主框架視窗整合時,這個方法才會影響標題列。

CMFCVisualManager::OnDrawRibbonCaptionButton

架構會在繪製位於功能區列上的標題按鈕時呼叫此方法。

virtual void OnDrawRibbonCaptionButton(
    CDC* pDC,
    CMFCRibbonCaptionButton* pButton);

參數

pDC
裝置內容的指標。

pButton
類別的 CMFCRibbonCaptionButton 指標。 架構會繪製此標題按鈕。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂功能區上標題按鈕的外觀。

CMFCVisualManager::OnDrawRibbonCategory

架構會在繪製 CMFCRibbonCategory 物件時呼叫此方法。

virtual void OnDrawRibbonCategory(
    CDC* pDC,
    CMFCRibbonCategory* pCategory,
    CRect rectCategory);

參數

pDC
[in]裝置內容的指標。

pCategory
[in]物件的指標 CMFCRibbonCategory 。 架構會繪製這個功能區類別。

rectCategory
[in]矩形,指定功能區上所有類別面板的界限。

備註

功能區類別是功能表命令的邏輯群組。 如需功能區類別的詳細資訊,請參閱 CMFCRibbonCategory 類別

覆寫衍生視覺效果管理員中的這個方法,以自訂功能區類別的外觀。

CMFCVisualManager::OnDrawRibbonCategoryCaption

架構會在繪製功能區類別的標題列時呼叫此方法。

virtual COLORREF OnDrawRibbonCategoryCaption(
    CDC* pDC,
    CMFCRibbonContextCaption* pContextCaption);

參數

pDC
[in]繪圖內容。

pCoNtextCaption
[in]標題列的指標。 視覺效果管理員會繪製此 CMFCRibbonCoNtextCaption Class 物件。

傳回值

COLORREF 參數,表示標題列上的文字色彩。

備註

覆寫衍生類別中的這個方法,以自訂功能區類別標題列的外觀。 如需標題列的詳細資訊,請參閱 CMFCRibbonCoNtextCaption 類別

CMFCVisualManager::OnDrawRibbonCategoryScroll

virtual void OnDrawRibbonCategoryScroll(
    CDC* pDC,
    CRibbonCategoryScroll* pScroll);

參數

[in] Pdc
[in] pScroll

備註

CMFCVisualManager::OnDrawRibbonCategoryTab

架構會在繪製功能區類別的索引標籤時呼叫此方法。

virtual COLORREF OnDrawRibbonCategoryTab(
    CDC* pDC,
    CMFCRibbonTab* pTab,
    BOOL bIsActive);

參數

pDC
[in]裝置內容的指標。

pTab
[in]類別實例的 CMFCRibbonTab 指標。 架構會繪製此索引標籤。

bIsActive
[in]布林參數,指出索引標籤是否為使用中。

傳回值

用於功能區類別索引標籤上文字的色彩。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂功能區類別索引標籤的外觀。如需功能區類別的詳細資訊,請參閱 CMFCRibbonCategory 類別

CMFCVisualManager::OnDrawRibbonCheckBoxOnList

virtual void OnDrawRibbonCheckBoxOnList(
    CDC* pDC,
    CMFCRibbonCheckBox* pCheckBox,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

參數

[in] Pdc
[in] pCheckBox
[in] 矩形
[in] bIsSelected
[in] bHighlighted

備註

CMFCVisualManager::OnDrawRibbonColorPaletteBox

virtual void OnDrawRibbonColorPaletteBox(
    CDC* pDC,
    CMFCRibbonColorButton* pColorButton,
    CMFCRibbonGalleryIcon* pIcon,
    COLORREF color,
    CRect rect,
    BOOL bDrawTopEdge,
    BOOL bDrawBottomEdge,
    BOOL bIsHighlighted,
    BOOL bIsChecked,
    BOOL bIsDisabled);

參數

[in] Pdc
[in] pColorButton
[in] pIcon
[in] 顏色
[in] 矩形
[in] bDrawTopEdge
[in] bDrawBottomEdge
[in] bIsHighlighted
[in] bIsChecked
[in] bIsDisabled

備註

CMFCVisualManager::OnDrawRibbonDefaultPaneButton

架構會在繪製功能區窗格的預設按鈕時呼叫此方法。

virtual void OnDrawRibbonDefaultPaneButton(
    CDC* pDC,
    CMFCRibbonButton* pButton);

參數

pDC
[in]裝置內容的指標。

pButton
[in]功能區面板預設按鈕的指標。

備註

當功能區窗格調整為最小大小時,架構會顯示預設按鈕,而且沒有顯示面板內容的區域。 當使用者按一下預設按鈕時,架構會顯示包含面板內容的下拉式功能表。

覆寫衍生視覺效果管理員中的這個方法,以自訂預設按鈕的外觀。

CMFCVisualManager::OnDrawRibbonDefaultPaneButtonCoNtext

virtual void OnDrawRibbonDefaultPaneButtonContext(
    CDC* pDC,
    CMFCRibbonButton* pButton);

參數

[in] Pdc
[in] pButton

備註

CMFCVisualManager::OnDrawRibbonDefaultPaneButtonIndicator

virtual void OnDrawRibbonDefaultPaneButtonIndicator(
    CDC* pDC,
    CMFCRibbonButton* pButton,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

參數

[in] Pdc
[in] pButton
[in] 矩形
[in] bIsSelected
[in] bHighlighted

備註

CMFCVisualManager::OnDrawRibbonGalleryBorder

virtual void OnDrawRibbonGalleryBorder(
    CDC* pDC,
    CMFCRibbonGallery* pButton,
    CRect rectBorder);

參數

[in] Pdc
[in] pButton
[in] rectBorder

備註

CMFCVisualManager::OnDrawRibbonGalleryButton

virtual void OnDrawRibbonGalleryButton(
    CDC* pDC,
    CMFCRibbonGalleryIcon* pButton);

參數

[in] Pdc
[in] pButton

備註

CMFCVisualManager::OnDrawRibbonKeyTip

virtual void OnDrawRibbonKeyTip(
    CDC* pDC,
    CMFCRibbonBaseElement* pElement,
    CRect rect,
    CString str);

參數

[in] Pdc
[in] pElement
[in] 矩形
[in] Str

備註

CMFCVisualManager::OnDrawRibbonLabel

架構會在繪製功能區標籤時呼叫此方法。

virtual void OnDrawRibbonLabel(
    CDC* pDC,
    CMFCRibbonLabel* pLabel,
    CRect rect);

參數

pDC
[in]裝置內容的指標。

pLabel
[in]CMFCRibbonLabel 物件的指標 。 架構會繪製這個功能區標籤。

矩形
[in]指定功能區面板界限的矩形。

備註

覆寫衍生類別中的這個方法,以自訂功能區標籤。

CMFCVisualManager::OnDrawRibbonMainPanelButtonBorder

架構會在繪製位於 Main 面板的 CMFCRibbonButton 框線時呼叫此方法。

virtual void OnDrawRibbonMainPanelButtonBorder(
    CDC* pDC,
    CMFCRibbonButton* pButton);

參數

pDC
[in]裝置內容的指標。

pButton
[in]位於功能區主面板上的 指標 CMFCRibbonButton 。 架構會繪製此按鈕的框線。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂主 面板上 框線的外觀 CMFCRibbonButton

CMFCVisualManager::OnDrawRibbonMainPanelFrame

當架構在 CMFCRibbonMainPanel 周圍 繪製框架時,會呼叫這個方法。

virtual void OnDrawRibbonMainPanelFrame(
    CDC* pDC,
    CMFCRibbonMainPanel* pPanel,
    CRect rect);

參數

pDC
[in]裝置內容的指標。

pPanel
[in]的 CMFCRibbonMainPanel 指標。

矩形
[in]指定 界限的 CMFCRibbonMainPanel 矩形。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂 框架的外觀 CMFCRibbonMainPanel

CMFCVisualManager::OnDrawRibbonMenuCheckFrame

virtual void OnDrawRibbonMenuCheckFrame(
    CDC* pDC,
    CMFCRibbonButton* pButton,
    CRect rect);

參數

[in] Pdc
[in] pButton
[in] 矩形

備註

CMFCVisualManager::OnDrawRibbonPanel

架構會在繪製 CMFCRibbonPanel 物件時呼叫此方法。

virtual COLORREF OnDrawRibbonPanel(
    CDC* pDC,
    CMFCRibbonPanel* pPanel,
    CRect rectPanel,
    CRect rectCaption);

參數

pDC
[in]裝置內容的指標。

pPanel
[in]物件的指標 CMFCRibbonPanel 。 架構會繪製這個功能區面板。

rectPanel
[in]指定面板界限的矩形。

rectCaption
[in]矩形,指定面板標題的界限。

傳回值

功能區面板上的文字色彩。

備註

覆寫衍生類別中的這個方法,以自訂功能區面板的外觀。

CMFCVisualManager::OnDrawRibbonPanelCaption

架構會在繪製 CMFCRibbonPanel 類別 標題時呼叫此方法。

virtual void OnDrawRibbonPanelCaption(
    CDC* pDC,
    CMFCRibbonPanel* pPanel,
    CRect rectCaption);

參數

pDC
[in]裝置內容的指標。

pPanel
[in]物件的指標 CMFCRibbonPanel 。 架構會繪製此功能區面板的標題。

rectCaption
[in]指定功能區面板標題界限的矩形。

備註

覆寫衍生類別中的這個方法,以自訂功能區面板標題的外觀。

CMFCVisualManager::OnDrawRibbonProgressBar

架構會在繪製 CMFCRibbonProgressBar 類別 時呼叫此方法。

virtual void OnDrawRibbonProgressBar(
    CDC* pDC,
    CMFCRibbonProgressBar* pProgress,
    CRect rectProgress,
    CRect rectChunk,
    BOOL bInfiniteMode);

參數

pDC
[in]裝置內容的指標。

pProgress
[in]物件的指標 CMFCRibbonProgressBar 。 架構會繪製此進度列。

rectProgress
[in]指定進度列界限的矩形。

rectChunk
[in]矩形,指定進度列周圍區域的界限。

bInfiniteMode
[in]布林參數,表示進度列的模式。 TRUE 值表示長條處於無限模式。 預設實作不會使用此參數。

備註

覆寫衍生類別中的這個方法,以自訂進度列的外觀。

CMFCVisualManager::OnDrawRibbonQuickAccessToolBarSeparator

當架構在功能區的快速存取工具列 繪製分隔符號時,架構會呼叫此方法。

virtual void OnDrawRibbonQuickAccessToolBarSeparator(
    CDC* pDC,
    CMFCRibbonSeparator* pSeparator,
    CRect rect);

參數

pDC
[in]裝置內容的指標。

pSeparator
[in]CMFCRibbonSeparator 物件的指標 。 架構會繪製這個功能區分隔符號。

矩形
[in]指定分隔符號界限的矩形。

備註

覆寫衍生類別中的這個方法,以自訂快速存取工具列 功能區分隔符號的外觀。

CMFCVisualManager::OnDrawRibbonRecentFilesFrame

當架構在最近檔案清單周圍繪製框架時,架構會呼叫此方法。

virtual void OnDrawRibbonRecentFilesFrame(
    CDC* pDC,
    CMFCRibbonMainPanel* pPanel,
    CRect rect);

參數

pDC
[in]裝置內容的指標。

pPanel
[in]功能區上 [主要 ] 面板的指標

矩形
[in]矩形,指定最近檔案清單方塊架的界限。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂最近檔案清單的外觀。

CMFCVisualManager::OnDrawRibbonSliderChannel

架構會在繪製 CMFCRibbonSlider 類別 通道時呼叫此方法。

virtual void OnDrawRibbonSliderChannel(
    CDC* pDC,
    CMFCRibbonSlider* pSlider,
    CRect rect);

參數

pDC
[in]裝置內容的指標。

pSlider
[in]CMFCRibbonSlider 物件的指標。 架構會繪製這個功能區滑杆的通道。

矩形
[in]指定功能區滑杆通道界限的矩形。

備註

覆寫衍生類別中的這個方法,以自訂功能區滑杆通道的外觀。

CMFCVisualManager::OnDrawRibbonSliderThumb

架構會在繪製 CMFCRibbonSlider 物件的拇指 時呼叫此方法。

virtual void OnDrawRibbonSliderThumb(
    CDC* pDC,
    CMFCRibbonSlider* pSlider,
    CRect rect,
    BOOL bIsHighlighted,
    BOOL bIsPressed,
    BOOL bIsDisabled);

參數

pDC
[in]裝置內容的指標。

pSlider
[in]的 CMFCRibbonSlider 指標。 架構會繪製這個功能區滑杆的拇指。

矩形
[in]矩形,指定功能區滑杆的拇指界限。

bIsHighlighted
[in]布林參數,指出拇指是否反白顯示。

bIsPressed
[in]布林參數,指出是否按下拇指。

bIsDisabled
[in]布林參數,指出拇指是否無法使用。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂 的拇指 CMFCRibbonSlider 外觀。

CMFCVisualManager::OnDrawRibbonSliderZoomButton

架構會在繪製 CMFCRibbonSlider 物件的縮放按鈕 時呼叫此方法。

virtual void OnDrawRibbonSliderZoomButton(
    CDC* pDC,
    CMFCRibbonSlider* pSlider,
    CRect rect,
    BOOL bIsZoomOut,
    BOOL bIsHighlighted,
    BOOL bIsPressed,
    BOOL bIsDisabled);

參數

pDC
[in]裝置內容的指標。

pSlider
[in]物件的指標 CMFCRibbonSlider 。 架構會繪製這個功能區滑杆。

矩形
[in]矩形,指定功能區滑杆上縮放按鈕的界限。

bIsZoomOut
[in]布林參數,指出架構所繪製的按鈕。 TRUE 值表示左按鈕的 「-」 用於縮小。FALSE 值表示右按鈕具有放大的 「+」。

bIsHighlighted
[in]布林參數,指出按鈕是否反白顯示。

bIsPressed
[in]布林參數,指出是否按下按鈕。

bIsDisabled
[in]布林參數,指出按鈕是否無法使用。

備註

根據預設,功能區滑杆上的縮放按鈕是具有 + 或 - 登入中心的圓形。 若要自訂縮放按鈕的外觀,請在衍生的視覺管理員中覆寫此方法。

CMFCVisualManager::OnDrawRibbonStatusBarPane

架構會在在狀態列上繪製窗格時呼叫此方法。

virtual COLORREF OnDrawRibbonStatusBarPane(
    CDC* pDC,
    CMFCRibbonStatusBar* pBar,
    CMFCRibbonStatusBarPane* pPane);

參數

pDC
[in]裝置內容的指標。

pBar
[in]包含窗格之狀態列的指標。

pPane
[in]狀態列窗格的指標。 架構會繪製此 CMFCRibbonStatusBarPane 物件。

傳回值

保留的值。 預設的實作會傳回 -1。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂狀態列上窗格的外觀。

CMFCVisualManager::OnDrawRibbonTabsFrame

當架構在一組功能區索引標籤周圍繪製框架時,會呼叫此方法。

virtual COLORREF OnDrawRibbonTabsFrame(
    CDC* pDC,
    CMFCRibbonBar* pWndRibbonBar,
    CRect rectTab);

參數

pDC
裝置內容的指標。

pWndRibbonBar
CMFCRibbonBar 物件的指標 。 架構會繪製此功能區列的框架。

rectTab
指定功能區索引標籤界限的矩形。

傳回值

保留的值。 根據預設,這個方法會傳回 -1。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂功能區上一組索引標籤周圍的框架。

CMFCVisualManager::OnDrawScrollButtons

virtual void OnDrawScrollButtons(
    CDC* pDC,
    const CRect& rect,
    const int nBorderSize,
    int iImage,
    BOOL bHilited);

參數

[in] Pdc
[in] 矩形
[in] nBorderSize
[in] iImage
[in] bHilited

備註

CMFCVisualManager::OnDrawSeparator

架構會在繪製分隔符號時呼叫此方法。

virtual void OnDrawSeparator(
    CDC* pDC,
    CBasePane* pBar,
    CRect rect,
    BOOL bIsHoriz);

參數

pDC
[in]控制項列之裝置內容的指標。

pBar
[in]包含分隔符號之窗格的指標。

矩形
[in]指定分隔符號界限的矩形。

bIsHoriz
[in]布林值參數,表示停駐窗格的方向。 TRUE 值表示窗格水準停駐。 FALSE 值表示窗格垂直停駐。

備註

控制列會使用分隔符號來分隔相關圖示群組。 這個方法的預設實作會顯示標準分隔符號。 覆寫衍生視覺效果管理員中的這個方法,以自訂分隔符號的外觀。

CMFCVisualManager::OnDrawShowAllMenuItems

virtual void OnDrawShowAllMenuItems(
    CDC* pDC,
    CRect rect,
    CMFCVisualManager::AFX_BUTTON_STATE state);

參數

[in] Pdc
[in] 矩形
[in] 狀態

備註

CMFCVisualManager::OnDrawSpinButtons

架構會在繪製 CMFCSpinButtonCtrl 類別 實例時呼叫此方法。

virtual void OnDrawSpinButtons(
    CDC* pDC,
    CRect rectSpin,
    int nState,
    BOOL bOrientation,
    CMFCSpinButtonCtrl* pSpinCtrl);

參數

pDC
[in]裝置內容的指標。

rectSpin
[in]指定微調控制項界限的矩形。

nState
[in]旗標,表示微調控制項的狀態。 如需詳細資訊,請參閱<備註>一節。

bOrientation
[in]指定微調控制項方向的布林參數。 TRUE 值表示微調控制項為水準。 否則,它是垂直的。

pSpinCtrl
[in]微調控制項的指標。 架構會繪製此控制項的按鈕。

備註

nState 參數表示微調控制項的狀態。 參數是下列其中一個值:

  • AFX_SPIN_PRESSEDUP

  • AFX_SPIN_PRESSEDDOWN

  • AFX_SPIN_HIGHLIGHTEDUP

  • AFX_SPIN_HIGHLIGHTEDDOWN

  • AFX_SPIN_DISABLED

覆寫衍生視覺效果管理員中的這個方法,以自訂微調控制項的外觀。

CMFCVisualManager::OnDrawSplitterBorder

架構在 CSplitterWndEx 類別 的實例 周圍繪製框線時,會呼叫這個方法。

virtual void OnDrawSplitterBorder(
    CDC* pDC,
    CSplitterWndEx* pSplitterWnd,
    CRect rect);

參數

pDC
[in]裝置內容的指標。

pSplitterWnd
[in]分隔器視窗的指標。 架構會繪製此視窗的框線。

矩形
[in]指定分隔器視窗界限的矩形。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂分隔器視窗的框線外觀。

CMFCVisualManager::OnDrawSplitterBox

架構會在繪製 CSplitterWndEx 類別 實例的 拖曳方塊時呼叫這個方法。 當使用者選取分隔列並變更子視窗的維度時,就會顯示拖曳方塊。

virtual void OnDrawSplitterBox(
    CDC* pDC,
    CSplitterWndEx* pSplitterWnd,
    CRect& rect);

參數

pDC
[in]裝置內容的指標。

pSplitterWnd
[in]分隔器視窗的指標。 架構會繪製此分隔器視窗的方塊。

矩形
[in]指定分隔器視窗界限的矩形。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂分割器視窗之拖曳方塊的外觀。

CMFCVisualManager::OnDrawStatusBarPaneBorder

架構會在繪製 CMFCStatusBar 物件的框線 時呼叫此方法。

virtual void OnDrawStatusBarPaneBorder(
    CDC* pDC,
    CMFCStatusBar* pBar,
    CRect rectPane,
    UINT uiID,
    UINT nStyle);

參數

pDC
[in]裝置內容的指標。

pBar
[in]物件的指標 CMFCStatusBar 。 架構會繪製此狀態列物件。

rectPane
[in]指定狀態列界限的矩形。

uiID
[in]狀態列的識別碼。

nStyle
[in]狀態列的樣式。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂物件的框線 CMFCStatusBar 外觀。

CMFCVisualManager::OnDrawStatusBarProgress

架構會在 CMFCStatusBar 物件上 繪製進度指標時呼叫此方法。

virtual void OnDrawStatusBarProgress(
    CDC* pDC,
    CMFCStatusBar* pStatusBar,
    CRect rectProgress,
    int nProgressTotal,
    int nProgressCurr,
    COLORREF clrBar,
    COLORREF clrProgressBarDest,
    COLORREF clrProgressText,
    BOOL bProgressText);

參數

pDC
[in]狀態列之裝置內容的指標。

pStatusBar
[in] CMFCStatusBar 包含進度列的物件。

rectProgress
[in]指定進度列界限的矩形。

nProgressTotal
[in]進度列的總數。

nProgressCurr
[in]進度列的目前進度。

clrBar
[in] COLORREF 參數,表示進度列的初始色彩。 此值為色彩漸層的開頭或進度列的完整色彩。

clrProgressBarDest
[in]COLORREF 參數,表示進度列的色彩漸層結尾。 如果 clrProgressBarDest 為 -1,架構就不會將進度列繪製為色彩漸層。 相反地,它會以 clrBar 指定的 色彩填滿整個進度列。

clrProgressText
[in]COLORREF 參數,表示目前進度之文字標記法的文字色彩。 如果 bProgressText 設定為 FALSE,則會忽略此參數。

bProgressText
[in]布林參數,指出是否要顯示目前進度的文字標記法。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂物件的外觀 CMFCStatusBar

CMFCVisualManager::OnDrawStatusBarSizeBox

架構會在繪製 CMFCStatusBar 的大小方塊 時呼叫此方法。

virtual void OnDrawStatusBarSizeBox(
    CDC* pDC,
    CMFCStatusBar* pStatBar,
    CRect rectSizeBox);

參數

pDC
[in]裝置內容的指標。

pStatBar
[in]狀態列的指標。 架構會繪製此狀態列的大小方塊。

rectSizeBox
[in]指定大小方塊界限的矩形。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂 上 CMFCStatusBar 大小方塊的外觀。

CMFCVisualManager::OnDrawTab

架構會在繪製 CMFCBaseTabCtrl 物件的索引標籤 時呼叫此方法。

virtual void OnDrawTab(
    CDC* pDC,
    CRect rectTab,
    int iTab,
    BOOL bIsActive,
    const CMFCBaseTabCtrl* pTabWnd);

參數

pDC
[in]裝置內容的指標。

rectTab
[in]指定索引標籤控制項界限的矩形。

iTab
[in]架構所繪製之索引標籤的索引。

bIsActive
[in]布林參數,指定索引標籤是否為使用中。

pTabWnd
[in]物件的指標 CMFCBaseTabCtrl 。 架構會繪製此索引標籤控制項。

備註

CMFCBaseTabCtrl物件會在處理WM_PAINT訊息時呼叫此方法。

覆寫衍生類別中的這個方法,以自訂索引標籤的外觀。

CMFCVisualManager::OnDrawTabCloseButton

架構會在使用中索引標籤上繪製 [ 關閉 ] 按鈕時呼叫此方法。

virtual void OnDrawTabCloseButton(
    CDC* pDC,
    CRect rect,
    const CMFCBaseTabCtrl* pTabWnd,
    BOOL bIsHighlighted,
    BOOL bIsPressed,
    BOOL bIsDisabled);

參數

pDC
[in]裝置內容的指標。

矩形
[in]指定 [關閉 ] 按鈕界限的 矩形。

pTabWnd
[in]索引標籤控制項的指標。 架構會繪製此索引標籤控制項的 [ 關閉 ] 按鈕。

bIsHighlighted
[in]布林參數,指出 [關閉 ] 按鈕是否 反白顯示。

bIsPressed
[in]布林參數,指出是否 按下 [關閉 ] 按鈕。

bIsDisabled
[in]布林參數,指出是否已 停用 [關閉 ] 按鈕。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂 pTabWnd 使用中索引標籤 上 [關閉 ] 按鈕的外觀

CMFCVisualManager::OnDrawTabContent

架構會在繪製位於 CMFCBaseTabCtrl 類別 實例 內部的內容時呼叫此方法。

virtual void OnDrawTabContent(
    CDC* pDC,
    CRect rectTab,
    int iTab,
    BOOL bIsActive,
    const CMFCBaseTabCtrl* pTabWnd,
    COLORREF clrText);

參數

pDC
[in]裝置內容的指標。

rectTab
[in]指定索引標籤內部界限的矩形。

iTab
[in]索引標籤以零起始的索引。架構會繪製此索引標籤的內部。

bIsActive
[in]布林參數,指出索引標籤是否為使用中。

pTabWnd
[in]索引標籤控制項的指標,其中包含要繪製的索引標籤。

clrText
[in]索引標籤內部的文字色彩。

備註

索引標籤的內部包含索引標籤的文字和圖示。覆寫衍生視覺效果管理員中的這個方法,以自訂索引標籤的外觀。

CMFCVisualManager::OnDrawTabsButtonBorder

架構會在繪製索引標籤按鈕的框線時呼叫此方法。

virtual void OnDrawTabsButtonBorder(
    CDC* pDC,
    CRect& rect,
    CMFCButton* pButton,
    UINT uiState,
    CMFCBaseTabCtrl* pWndTab);

參數

pDC
[in]裝置內容的指標。

矩形
[in]指定索引標籤按鈕界限的矩形。

pButton
[in]CMFCButton 物件的指標 。 架構會繪製這個 CMFCButton 實例的框線。

uiState
[in]指定按鈕狀態的不帶正負號整數。

pWndTab
[in]父索引標籤視窗的指標。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂索引標籤按鈕框線的外觀。

CMFCVisualManager::OnDrawTask

架構會在繪製 CMFCTasksPane 物件時呼叫此方法。

virtual void OnDrawTask(
    CDC* pDC,
    CMFCTasksPaneTask* pTask,
    CImageList* pIcons,
    BOOL bIsHighlighted = FALSE,
    BOOL bIsSelected = FALSE);

參數

pDC
[in]裝置內容的指標。

pTask
[in]CMFCTasksPaneTask 物件的指標 。 架構會繪製這項工作。

pIcons
[in]與工作窗格相關聯的影像清單指標。 每個工作都包含此清單中影像的索引。

bIsHighlighted
[in]布林參數,指定顯示的工作是否反白顯示。

bIsSelected
[in]布林參數,指定是否選取顯示的工作。

備註

架構會將工作列上的工作顯示為圖示和文字。 pIcons 參數包含 pTask 指示工作的圖示。

覆寫衍生類別中的這個方法,以自訂工作列上的工作外觀。

CMFCVisualManager::OnDrawTasksGroupAreaBorder

架構會在 CMFCTasksPane 類別 上的 群組周圍繪製框線時呼叫此方法。

virtual void OnDrawTasksGroupAreaBorder(
    CDC* pDC,
    CRect rect,
    BOOL bSpecial = FALSE,
    BOOL bNoTitle = FALSE);

參數

pDC
[in]裝置內容的指標。

矩形
[in]矩形,指定工作窗格上群組區域的界限。

bSpecial
[in]布林參數,指定框線是否反白顯示。 TRUE 的值表示框線已反白顯示。

bNoTitle
[in]布林參數,指定群組區域是否具有標題。 TRUE 值表示群組區域沒有標題。

備註

覆寫衍生類別中的此函式,以自訂工作窗格上群組區域周圍的框線。

CMFCVisualManager::OnDrawTasksGroupCaption

架構會在繪製 CMFCTasksPaneTaskGroup 物件的標題 時呼叫此方法。

virtual void OnDrawTasksGroupCaption(
    CDC* pDC,
    CMFCTasksPaneTaskGroup* pGroup,
    BOOL bIsHighlighted = FALSE,
    BOOL bIsSelected = FALSE,
    BOOL bCanCollapse = FALSE);

參數

pDC
[in]裝置內容的指標。

pGroup
[in]物件的指標 CMFCTasksPaneTaskGroup 。 架構會繪製此群組的標題。

bIsHighlighted
[in]布林參數,指出群組是否反白顯示。

bIsSelected
[in]布林參數,指出群組目前是否已選取。

bCanCollapse
[in]布林參數,指出是否可以折迭群組。

備註

工作組會出現在 CMFCTasksPane 物件上。

覆寫衍生類別中的這個方法,以自訂 的 CMFCTasksPaneTaskGroup 標題。

CMFCVisualManager::OnDrawTasksGroupIcon

virtual void OnDrawTasksGroupIcon(
    CDC* pDC,
    CMFCTasksPaneTaskGroup* pGroup,
    int nIconHOffset = 5,
    BOOL bIsHighlighted = FALSE,
    BOOL bIsSelected = FALSE,
    BOOL bCanCollapse = FALSE);

參數

[in] Pdc
[in] pGroup
[in] nIconHOffset
[in] bIsHighlighted
[in] bIsSelected
[in] bCanCollapse

備註

CMFCVisualManager::OnDrawTearOffCaption

架構會在繪製 CMFCPopupMenu 類別 的標題 時呼叫此方法。

virtual void OnDrawTearOffCaption(
    CDC* pDC,
    CRect rect,
    BOOL bIsActive);

參數

pDC
[in]裝置內容的指標。

矩形
[in]指定標題界限的矩形。

bIsActive
[in]如果標題為使用中,則為 TRUE;否則為 FALSE。

備註

當物件處理WM_PAINT訊息,且必須繪製卸載標題時 CMFCPopupMenu ,架構會呼叫此函式。

覆寫衍生類別中的這個方法,以自訂標題的卸載線外觀。

CMFCVisualManager::OnDrawToolBoxFrame

virtual void OnDrawToolBoxFrame(
    CDC* pDC,
    const CRect& rect);

參數

[in] Pdc
[in] 矩形

備註

CMFCVisualManager::OnEraseMDIClientArea

架構會在清除 MDI 工作區時呼叫此方法。

virtual BOOL OnEraseMDIClientArea(
    CDC* pDC,
    CRect rectClient);

參數

pDC
[in]裝置內容的指標。

rectClient
[in]指定 MDI 工作區界限的矩形。

傳回值

保留的值。 預設實作會傳回 FALSE。

備註

覆寫此方法,以在視覺管理員清除 MDI 工作區時執行自訂程式碼。

CMFCVisualManager::OnErasePopupWindowButton

virtual void OnErasePopupWindowButton(
    CDC* pDC,
    CRect rectClient,
    CMFCDesktopAlertWndButton* pButton);

參數

[in] Pdc
[in] rectClient
[in] pButton

備註

CMFCVisualManager::OnEraseTabsArea

架構會在清除索引標籤視窗的索引標籤區域時呼叫此方法。

virtual void OnEraseTabsArea(
    CDC* pDC,
    CRect rect,
    const CMFCBaseTabCtrl* pTabWnd);

參數

pDC
[in]裝置內容的指標。

矩形
[in]指定索引標籤區域界限的矩形。

pTabWnd
[in]索引標籤視窗的指標。 架構會清除指定索引標籤視窗的索引標籤區域。

備註

當 CMFCBaseTabCtrl 類別 物件處理WM_PAINT訊息並清除索引標籤區域時 ,架構會呼叫此函式。

覆寫衍生視覺效果管理員中的這個方法,以自訂索引標籤的外觀。

CMFCVisualManager::OnEraseTabsButton

架構會在清除索引標籤按鈕的文字和圖示時呼叫此方法。

virtual void OnEraseTabsButton(
    CDC* pDC,
    CRect rect,
    CMFCButton* pButton,
    CMFCBaseTabCtrl* pWndTab);

參數

pDC
[in]裝置內容的指標。

矩形
[in]指定索引標籤按鈕界限的矩形。

pButton
[in]索引標籤按鈕的指標。 架構會清除此按鈕的文字和圖示。

pWndTab
[in]包含索引標籤按鈕之索引標籤控制項的指標。

備註

當 CMFCBaseTabCtrl 物件處理WM_ERASEBKGND訊息時 ,架構會清除按鈕的文字和圖示。

覆寫衍生視覺效果管理員中的這個方法,以自訂索引標籤按鈕的外觀。

CMFCVisualManager::OnEraseTabsFrame

架構會在清除 CMFCBaseTabCtrl 類別 上的 框架時呼叫此方法。

virtual BOOL OnEraseTabsFrame(
    CDC* pDC,
    CRect rect,
    const CMFCBaseTabCtrl* pTabWnd);

參數

pDC
[in]裝置內容的指標。

矩形
[in]指定索引標籤視窗界限的矩形。

pTabWnd
[in]索引標籤視窗的指標。 架構會清除這個 CMFCBaseTabCtrl 的框架。

傳回值

如果方法成功,則為 TRUE;否則為 FALSE。

備註

這個方法會以使用中索引標籤的背景色彩填滿矩形 指示的區域。當物件處理WM_PAINT訊息並清除製表框時 CMFCBaseTabCtrl ,就會呼叫它。

CMFCVisualManager::OnFillAutoHideButtonBackground

當它填入自動隱藏按鈕的背景時,架構會呼叫這個方法。

virtual void OnFillAutoHideButtonBackground(
    CDC* pDC,
    CRect rect,
    CMFCAutoHideButton* pButton);

參數

pDC
[in]裝置內容的指標。

矩形
[in]指定自動隱藏按鈕界限的矩形。

pButton
[in]CMFCAutoHideButton 物件的指標 。 架構會填滿此自動隱藏按鈕的背景。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂自動隱藏按鈕的外觀。

CMFCVisualManager::OnFillBarBackground

架構會在填滿 CBasePane 物件的背景 時呼叫此方法。

virtual void OnFillBarBackground(
    CDC* pDC,
    CBasePane* pBar,
    CRect rectClient,
    CRect rectClip,
    BOOL bNCArea = FALSE);

參數

pDC
[in]控制項列之裝置內容的指標。

pBar
[in]物件的指標 CBasePane 。 架構會填入此窗格的背景。

rectClient
[in]指定窗格界限的矩形。

rectClip
[in]指定窗格裁剪區域的矩形。

bNCArea
[in]保留的值。

備註

此方法的預設實作會以全域變數 afxGlobalData 的 3d 背景色彩填滿橫條的背景。 覆寫衍生視覺效果管理員中的這個方法,以自訂窗格的背景。

範例

下列範例示範如何在 OnFillBarBackground 類別中使用 CMFCVisualManager 。 此程式碼片段是 Outlook 示範範例 一部分。

// CDC* pDC
// CRect rectClient
// The this pointer points to a CMailBar class which extends the CPaneDialog class.
CMFCVisualManager::GetInstance()->OnFillBarBackground(pDC, this, rectClient, rectClient);

CMFCVisualManager::OnFillButtonInterior

架構會在填滿工具列按鈕的背景時呼叫此方法。

virtual void OnFillButtonInterior(
    CDC* pDC,
    CMFCToolBarButton* pButton,
    CRect rect,
    CMFCVisualManager::AFX_BUTTON_STATE state);

參數

pDC
[in]工具列按鈕之裝置內容的指標。

pButton
[in]CMFCToolBarButton 指標。 架構會填滿此按鈕的背景。

矩形
[in]指定工具列按鈕界限的矩形。

state
[in]工具列按鈕的狀態。

備註

此方法的預設實作會使用預設色彩填滿背景。 覆寫衍生視覺效果管理員中的這個方法,以自訂工具列按鈕的背景。

工具列按鈕的可能狀態為 ButtonsIsRegularButtonsIsPressedButtonsIsHighlighted

CMFCVisualManager::OnFillCaptionBarButton

virtual COLORREF OnFillCaptionBarButton(
    CDC* pDC,
    CMFCCaptionBar* pBar,
    CRect rect,
    BOOL bIsPressed,
    BOOL bIsHighlighted,
    BOOL bIsDisabled,
    BOOL bHasDropDownArrow,
    BOOL bIsSysButton);

參數

[in] Pdc
[in] pBar
[in] 矩形
[in] bIsPressed
[in] bIsHighlighted
[in] bIsDisabled
[in] bHasDropDownArrow
[in] bIsSysButton

傳回值

備註

CMFCVisualManager::OnFillCommandsListBackground

架構會在填滿屬於命令清單的工具列按鈕背景時呼叫此方法。 此命令清單是自訂對話方塊的一部分。

virtual COLORREF OnFillCommandsListBackground(
    CDC* pDC,
    CRect rect,
    BOOL bIsSelected = FALSE);

參數

pDC
[in]裝置內容的指標。

矩形
[in]指定按鈕界限的矩形。

bIsSelected
[in]布林參數,指出是否已選取按鈕。

傳回值

工具列按鈕的文字色彩。

備註

如需自訂清單的詳細資訊,請參閱 CMFCToolBarButton::OnDrawOnCustomizeList 。 此方法的預設實作會根據目前選取之外觀的色彩配置填滿背景。

CMFCVisualManager::OnFillHeaderCtrlBackground

架構會在填滿標頭控制項的背景時呼叫此方法。

virtual void OnFillHeaderCtrlBackground(
    CMFCHeaderCtrl* pCtrl,
    CDC* pDC,
    CRect rect);

參數

pCtrl
[in]CMFCHeaderCtrl 物件的指標 。 架構會填入此標頭控制項的背景。

pDC
[in]裝置內容的指標。

矩形
[in]指定標頭控制項界限的矩形。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂標頭控制項的外觀。

CMFCVisualManager::OnFillMiniFrameCaption

架構會在填滿迷你框架視窗的標題列時呼叫此方法。

virtual COLORREF OnFillMiniFrameCaption(
    CDC* pDC,
    CRect rectCaption,
    CPaneFrameWnd* pFrameWnd,
    BOOL bActive);

參數

pDC
[in]裝置內容的指標。

rectCaption
[in]指定標題列界限的矩形。

pFrameWnd
[in]迷你框架視窗的指標。 架構會繪製此視窗的標題列。

bActive
[in]布林參數,指出視窗是否為使用中。

傳回值

用來填滿標題列背景的色彩。

備註

這個方法的預設實作會以使用中皮膚的目前標題色彩填滿標題列。

CMFCVisualManager::OnFillOutlookBarCaption

架構會在填滿 Outlook 標題 列的背景時呼叫此方法。

virtual void OnFillOutlookBarCaption(
    CDC* pDC,
    CRect rectCaption,
    COLORREF& clrText);

參數

pDC
[in]裝置內容的指標。

rectCaption
[in]指定標題列界限的矩形。

clrText
[out]COLORREF 參數的 參考。 方法會將標題列上的文字色彩寫入此參數。

備註

此方法的預設實作會以目前外觀為基礎的陰影色彩填滿標題列。 覆寫衍生視覺效果管理員中的這個方法,以自訂 Outlook 標題列的色彩。

CMFCVisualManager::OnFillOutlookPageButton

架構會在填滿 Outlook 頁面按鈕的內部時呼叫此方法。

virtual void OnFillOutlookPageButton(
    CDC* pDC,
    const CRect& rect,
    BOOL bIsHighlighted,
    BOOL bIsPressed,
    COLORREF& clrText);

參數

pDC
[in]裝置內容的指標。

矩形
[in]指定 Outlook 頁面按鈕界限的矩形。

bIsHighlighted
[in]布林參數,指定按鈕是否反白顯示。

bIsPressed
[in]布林參數,指定是否按下按鈕。

clrText
[out]COLORREF 參數的 參考。 這個方法會將 outlook 頁面按鈕的文字色彩儲存在此參數中。

備註

在衍生視覺效果管理員中覆寫此函式,以自訂 Outlook 頁面按鈕的外觀。

CMFCVisualManager::OnFillPopupWindowBackground

架構會在填滿快顯視窗的背景時呼叫此方法。

virtual void OnFillPopupWindowBackground(
    CDC* pDC,
    CRect rect);

參數

pDC
[in]裝置內容的指標。

矩形
[in]指定快顯視窗界限的矩形。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂快顯視窗的外觀。

CMFCVisualManager::OnFillRibbonButton

架構會在填滿功能區按鈕的內部時呼叫此方法。

virtual COLORREF OnFillRibbonButton(
    CDC* pDC,
    CMFCRibbonButton* pButton);

參數

pDC
[in]裝置內容的指標。

pButton
[in]CMFCRibbonButton 物件的指標 。 架構會填滿這個功能區按鈕的內部。

傳回值

如果功能區按鈕支援文字,則 pButton 指定功能區按鈕的文字色彩。 如果功能區按鈕的文字無效,則值為 -1。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂功能區按鈕的外觀。

CMFCVisualManager::OnFillRibbonEdit

架構會在填滿 類別實例 CMFCRibbonRichEditCtrl 的內部時呼叫這個方法。

virtual void OnFillRibbonEdit(
    CDC* pDC,
    CMFCRibbonRichEditCtrl* pEdit,
    CRect rect,
    BOOL bIsHighlighted,
    BOOL bIsPaneHighlighted,
    BOOL bIsDisabled,
    COLORREF& clrText,
    COLORREF& clrSelBackground,
    COLORREF& clrSelText);

參數

pDC
[in]裝置內容的指標。

pEdit
[in]物件的指標 CMFCRibbonRichEditCtrl 。 架構會填滿此編輯控制項的內部。

矩形
[in]指定編輯控制項界限的矩形。

bIsHighlighted
[in]布林參數,指出是否反白顯示編輯控制項。

bIsPaneHighlighted
[in]布林參數,指出是否反白顯示父窗格。

bIsDisabled
[in]布林參數,指出編輯控制項是否無法使用。

clrText
[in]編輯控制項文字色彩的參考。

clrSelBackground
[in]反白顯示編輯控制項的背景色彩參考。

clrSelText
[in]編輯控制項上所選文字色彩的參考。

備註

CMFCRibbonRichEditCtrlpEdit 指示的 可以是功能區上下拉式方塊按鈕的一部分。

覆寫衍生視覺效果管理員中的這個方法,以自訂 的外觀 CMFCRibbonRichEditCtrl

CMFCVisualManager::OnFillRibbonMainPanelButton

架構會在填滿位於 Main 面板的功能區按鈕內部時呼叫此方法。

virtual COLORREF OnFillRibbonMainPanelButton(
    CDC* pDC,
    CMFCRibbonButton* pButton);

參數

pDC
[in]裝置內容的指標。

pButton
[in]CMFCRibbonButton Class 物件的指標 。 架構會填入此功能區按鈕。

傳回值

如果功能區按鈕支援文字,則 pButton 指定功能區按鈕的文字色彩。 如果功能區按鈕的文字無效,則值為 -1。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂主 面板上 功能區按鈕的外觀。

CMFCVisualManager::OnFillRibbonMenuFrame

架構會在填滿功能區面板的功能表框時呼叫此方法。

virtual void OnFillRibbonMenuFrame(
    CDC* pDC,
    CMFCRibbonMainPanel* pPanel,
    CRect rect);

參數

pDC
[in]裝置內容的指標。

pPanel
[in]CMFCRibbonMainPanel 類別 實例的 指標。 架構會填入此功能區面板的功能表框。

矩形
[in]指定功能表框界限的矩形。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂 的功能表列 CMFCRibbonMainPanel 外觀。

CMFCVisualManager::OnFillRibbonQuickAccessToolBarPopup

virtual void OnFillRibbonQuickAccessToolBarPopup(
    CDC* pDC,
    CMFCRibbonPanelMenuBar* pMenuBar,
    CRect rect);

參數

[in] Pdc
[in] pMenuBar
[in] 矩形

備註

CMFCVisualManager::OnFillSplitterBackground

架構會在填滿分隔器視窗的背景時呼叫此方法。

virtual void OnFillSplitterBackground(
    CDC* pDC,
    CSplitterWndEx* pSplitterWnd,
    CRect rect);

參數

pDC
[in]裝置內容的指標。

pSplitterWnd
[in]CSplitterWndEx 類別 實例的 指標。 架構會填入這個分隔器視窗的背景。

矩形
[in]指定分隔器視窗界限的矩形。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂分割器視窗的外觀。

CMFCVisualManager::OnFillTab

架構會在填滿索引標籤視窗的背景時呼叫此方法。

virtual void OnFillTab(
    CDC* pDC,
    CRect rectFill,
    CBrush* pbrFill,
    int iTab,
    BOOL bIsActive,
    const CMFCBaseTabCtrl* pTabWnd);

參數

pDC
[in]裝置內容的指標。

rectFill
[in]指定索引標籤視窗界限的矩形。

pbrFill
[in]筆刷的指標。 架構會使用此筆刷填滿索引標籤視窗。

iTab
[in]架構填滿背景之索引標籤之索引標籤的以零起始的索引標籤。

bIsActive
[in]如果索引標籤為使用中,則為 TRUE;否則為 FALSE。

pTabWnd
[in]父索引標籤控制項的指標。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂索引標籤的外觀。

CMFCVisualManager::OnFillTasksGroupInterior

架構會在填滿 CMFCTasksPaneTaskGroup 物件的內部 時呼叫此方法。

virtual void OnFillTasksGroupInterior(
    CDC* pDC,
    CRect rect,
    BOOL bSpecial = FALSE);

參數

pDC
[in]裝置內容的指標。

矩形
[in]指定工作組界限的矩形。

bSpecial
[in]布林值,指出內部是否填滿特殊色彩。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂工作組的外觀。

CMFCVisualManager::OnFillTasksPaneBackground

架構會在填滿 CMFCTasksPane 控制項的背景 時呼叫此方法。

virtual void OnFillTasksPaneBackground(
    CDC* pDC,
    CRect rectWorkArea);

參數

pDC
[in]裝置內容的指標。

rectWorkArea
[in]指定工作窗格界限的矩形。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂物件的外觀 CMFCTasksPane

CMFCVisualManager::OnHighlightMenuItem

架構會在繪製醒目提示的功能表項目時呼叫此方法。

virtual void OnHighlightMenuItem(
    CDC* pDC,
    CMFCToolBarMenuButton* pButton,
    CRect rect,
    COLORREF& clrText);

參數

pDC
[in]功能表之裝置內容的指標。

pButton
[in]要顯示的 CMFCToolBarMenuButton 物件的指標 。 預設實作不會使用此參數。

矩形
[in]指定功能表項目界限的矩形。

clrText
[in]醒目提示功能表項目的目前文字色彩。 預設實作不會使用此參數。

備註

這個方法的預設實作不會使用 pButton clrText 參數 。 它會以標準背景色彩填滿矩形 指定的矩形。

覆寫衍生視覺效果管理員中的這個方法,以自訂醒目提示功能表項目的外觀。 使用 clrText 參數來修改醒目提示功能表項目的文字色彩。

CMFCVisualManager::OnHighlightRarelyUsedMenuItems

架構會在繪製醒目提示的功能表命令時呼叫此方法。

virtual void OnHighlightRarelyUsedMenuItems(
    CDC* pDC,
    CRect rectRarelyUsed);

參數

pDC
[in]裝置內容的指標。

rectRarelyUsed
[in]指定醒目提示命令界限的矩形。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂醒目提示功能表命令的外觀。

CMFCVisualManager::OnNcActivate

virtual BOOL OnNcActivate(
    CWnd* pWnd,
    BOOL bActive);

參數

[in] pWnd
[in] bActive

傳回值

備註

CMFCVisualManager::OnNc小畫家

架構會在繪製非工作區時呼叫此方法。

virtual BOOL OnNcPaint(
    CWnd* pWnd,
    const CObList& lstSysButtons,
    CRect rectRedraw);

參數

pWnd
[in]視窗的指標,其架構所繪製的非工作區。

lstSysButtons
[in]系統按鈕的清單。 這些也稱為標題按鈕。

rectRedraw
[in]指定非工作區界限的矩形。

傳回值

保留的值。 預設實作會傳回 FALSE。

備註

覆寫衍生視覺效果管理員中的這個方法,以自訂視窗框架和標題按鈕的外觀。

CMFCVisualManager::OnSetWindowRegion

架構會在設定包含框架和快顯功能表的區域之後呼叫此方法。

virtual BOOL OnSetWindowRegion(
    CWnd* pWnd,
    CSize sizeWindow);

參數

pWnd
[in]具有已變更區域之視窗的指標。

sizeWindow
[in]視窗的大小。

傳回值

如果方法成功,則為 TRUE;否則為 FALSE。

備註

架構會呼叫這個方法,通知視覺管理員已設定框架和快顯功能表的區域。 如需詳細資訊,請參閱 CWindow::SetWindowRgn

CMFCVisualManager::OnUpdateSystemColors

架構會在變更系統色彩時呼叫此函式。

virtual void OnUpdateSystemColors();

備註

架構會呼叫此方法作為處理WM_SYSCOLORCHANGE訊息的一部分。 預設實作不做任何動作。 如果您想要在應用程式中的色彩變更時執行自訂程式碼,請在衍生視覺效果管理員中覆寫這個方法。

CMFCVisualManager::RedrawAll

立即重新繪製應用程式中的所有控制列。

static void RedrawAll();

CMFCVisualManager::RibbonCategoryColorToRGB

virtual COLORREF RibbonCategoryColorToRGB(AFX_RibbonCategoryColor color);

參數

[in] 顏色

傳回值

備註

CMFCVisualManager::SetDefaultManager

設定預設管理者。

static void SetDefaultManager(CRuntimeClass* pRTI);

參數

pRTI
[in]視覺化管理員之執行時間資訊的指標。

備註

CMFCVisualManager使用 類別和任何衍生的視覺管理員來自訂應用程式的外觀。 設定預設視覺效果管理員之後,這個方法會使用新的視覺效果管理員來重新繪製應用程式。 如需如何使用視覺管理員的詳細資訊,請參閱 視覺效果管理員

使用此方法可變更應用程式所使用的視覺管理員。

CMFCVisualManager::SetEmbossDisabledImage

啟用或停用已停用工具列影像的浮凸模式。

void SetEmbossDisabledImage (BOOL bEmboss = TRUE);

參數

bEmboss
[in]布林值參數,指出是否啟用已停用工具列影像的浮凸模式。

備註

使用 CMFCVisualManager::IsEmbossDisabledImage 函數來判斷是否啟用浮凸模式。

CMFCVisualManager::SetFadeInactiveImage

啟用或停用功能表或工具列上非使用中影像的光源效果。

void SetFadeInactiveImage(BOOL bFade = TRUE);

參數

bFade
[in]布林參數,指定是否啟用光源效果。

備註

此功能可控制非作用中的影像是否會在功能表或工具列上顯示淡出。 使用 CMFCVisualManager::IsFadeInactiveImage 方法來 判斷是否啟用此功能。

CMFCVisualManager::SetMenuFlatLook

設定旗標,指出功能表按鈕是否顯示為一般。 否則,它們會顯示三維。

void SetMenuFlatLook(BOOL bMenuFlatLook = TRUE);

參數

bMenuFlatLook
[in]布林參數,指出功能表按鈕是否顯示為一般。

備註

根據預設,此功能不會啟用。

CMFCVisualManager::SetMenuShadowDepth

設定功能表陰影的寬度和高度。

void SetMenuShadowDepth(int nDepth);

參數

nDepth
[in]整數,指定以圖元為單位的功能表陰影深度。

備註

功能表陰影的高度和寬度必須相同。 預設值為 7 圖元。

CMFCVisualManager::SetShadowHighlightedImage

設定旗標,指出 CMFCVisualManager 是否 顯示醒目提示影像的陰影。

void SetShadowHighlightedImage(BOOL bShadow = TRUE);

參數

bShadow
[in]布林參數,指出視覺管理員是否在醒目提示影像下顯示陰影。

備註

根據預設,此功能已停用。

另請參閱

階層架構圖表
類別
CMFCVisualManager::GetInstance
視覺化管理員