共用方式為


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::OnNcPaint 當架構繪製非工作區時,由架構呼叫。
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] rect
[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] rect
[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::IsHighlightWholeMenuItem

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]裝置內容的指標。

rect
[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]工具列按鈕的指標。 架構會繪製此按鈕的框線。

rect
[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] rect
[in]
[in] bHorz

備註

CMFCVisualManager::OnDrawCaptionBarBorder

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

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

參數

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

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

rect
[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] rect
[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] rect

備註

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] rect
[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] rect
[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]下拉式方塊按鈕之裝置內容的指標。

rect
[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]裝置內容的指標。

rect
[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]裝置內容的指標。

rect
[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] rect
[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]裝置內容的指標。

rect
[in]指定標頭控件界限的矩形。

bIsPressed
[in]布爾參數,指出是否按下標頭控件。

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

備註

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

CMFCVisualManager::OnDrawHeaderCtrlSortArrow

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

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

參數

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

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

rect
[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 物件的指標。 架構會在此快捷功能表周圍繪製框線。

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

備註

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

CMFCVisualManager::OnDrawMenuCheck

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

參數

[in] pDC
[in] pButton
[in] rect
[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] rect

傳回值

備註

CMFCVisualManager::OnDrawMenuResizeBar

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

參數

[in] pDC
[in] rect
[in] nResizeFlags

備註

CMFCVisualManager::OnDrawMenuScrollButton

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

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

參數

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

rect
[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]裝置內容的指標。

rect
[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]窗格的指標。 視覺效果管理員會繪製此窗格的框線。

rect
[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] rect
[in] bAutoHideMode

備註

CMFCVisualManager::OnDrawPopupWindowBorder

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

參數

[in] pDC
[in] rect

備註

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]功能區列的指標。 視覺效果管理員會繪製此功能區列。

rect
[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] rect
[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] rect
[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] rect
[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] rect
[in] str

備註

CMFCVisualManager::OnDrawRibbonLabel

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

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

參數

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

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

rect
[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指標。

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

備註

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

CMFCVisualManager::OnDrawRibbonMenuCheckFrame

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

參數

[in] pDC
[in] pButton
[in] rect

備註

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 物件的指標。 架構會繪製這個功能區分隔符。

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

備註

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

CMFCVisualManager::OnDrawRibbonRecentFilesFrame

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

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

參數

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

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

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

備註

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

CMFCVisualManager::OnDrawRibbonSliderChannel

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

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

參數

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

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

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

備註

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

CMFCVisualManager::OnDrawRibbonSliderThumb

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

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

參數

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

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

rect
[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 物件的指標。 架構會繪製這個功能區滑桿。

rect
[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] rect
[in] nBorderSize
[in] iImage
[in] bHilited

備註

CMFCVisualManager::OnDrawSeparator

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

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

參數

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

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

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

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

備註

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

CMFCVisualManager::OnDrawShowAllMenuItems

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

參數

[in] pDC
[in] rect
[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]分隔器視窗的指標。 架構會繪製此視窗的框線。

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

備註

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

CMFCVisualManager::OnDrawSplitterBox

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

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

參數

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

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

rect
[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]裝置內容的指標。

rect
[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]裝置內容的指標。

rect
[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]裝置內容的指標。

rect
[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]裝置內容的指標。

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

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

備註

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

覆寫衍生類別中的這個方法,以自定義卸除列標題的外觀。

CMFCVisualManager::OnDrawToolBoxFrame

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

參數

[in] pDC
[in] rect

備註

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]裝置內容的指標。

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

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

備註

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

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

CMFCVisualManager::OnEraseTabsButton

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

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

參數

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

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

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

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

備註

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

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

CMFCVisualManager::OnEraseTabsFrame

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

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

參數

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

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

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

傳回值

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

備註

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

CMFCVisualManager::OnFillAutoHideButtonBackground

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

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

參數

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

rect
[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指標。 架構會填滿此按鈕的背景。

rect
[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] rect
[in] bIsPressed
[in] bIsHighlighted
[in] bIsDisabled
[in] bHasDropDownArrow
[in] bIsSysButton

傳回值

備註

CMFCVisualManager::OnFillCommandsListBackground

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

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

參數

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

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

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

傳回值

工具列按鈕的文字色彩。

備註

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

CMFCVisualManager::OnFillHeaderCtrlBackground

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

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

參數

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

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

rect
[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]裝置內容的指標。

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

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

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

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

備註

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

CMFCVisualManager::OnFillPopupWindowBackground

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

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

參數

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

rect
[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 物件的指標。 架構會填滿此編輯控制件的內部。

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

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

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

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

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

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

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

備註

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

覆寫衍生視覺效果管理員中的這個方法,以自定義 的外觀 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 類別實例的指標。 架構會填入此功能區面板的功能表框。

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

備註

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

CMFCVisualManager::OnFillRibbonQuickAccessToolBarPopup

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

參數

[in] pDC
[in] pMenuBar
[in] rect

備註

CMFCVisualManager::OnFillSplitterBackground

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

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

參數

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

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

rect
[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]裝置內容的指標。

rect
[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 物件的指標。 默認實作不會使用此參數。

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

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

備註

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

覆寫衍生視覺效果管理員中的這個方法,以自定義醒目提示功能表項的外觀。 使用 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::OnNcPaint

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

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
視覺化管理員