CMFCVisualManager 類別
提供在全域層級上變更應用程式外觀的支援。 CMFCVisualManager
類別會使用一致的樣式,與提供繪製應用程式 GUI 控制項指令的類別搭配使用。 這些其他類別稱為視覺管理員,並且繼承自 CMFCBaseVisualManager
。
如需詳細資訊,請參閱 Visual Studio 安裝的 VC\atlmfc\src\mfc 資料夾中的原始程式碼 。
語法
class CMFCVisualManager : public CMFCBaseVisualManager
成員
公用建構函式
名稱 | 描述 |
---|---|
CMFCVisualManager::CMFCVisualManager |
預設建構函式。 |
公用方法
備註
因為 類別 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;
繼承階層架構
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]自動隱藏按鈕的指標。
傳回值
備註
覆寫衍生類別中的這個方法,以自訂應用程式中自動隱藏按鈕的文字色彩。 若要這樣做,請傳回您希望應用程式用來做為文字色彩的色彩。
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
則傳回小型系統按鈕的大小。 否則,它會傳回大型系統按鈕的大小。
傳回值
備註
系統按鈕是對應至 [關閉 ]、[最小化]、 [最大化 ] 和 [還原 ] 命令 之框架視窗標題中的按鈕。 這些按鈕的大小取決於目前的視覺化管理員。 如果您想要自訂應用程式中系統按鈕的大小,請覆寫此方法。
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 物件的文字色彩 取決於按鈕的狀態。 工具列按鈕的可能狀態為 ButtonsIsRegular
、 ButtonsIsPressed
或 ButtonsIsHighlighted
。
覆寫此函式,以自訂應用程式中工具列按鈕的文字色彩。
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 參數不包含框線的座標。 它包含 、 bottom
、 left
和資料 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
狀態的可能值為 、 ButtonsIsPressed
和 ButtonsIsHighlighted
。
CMFCVisualManager::OnDrawButtonBorder
架構會在繪製工具列按鈕的框線時呼叫此方法。
virtual void OnDrawButtonBorder(
CDC* pDC,
CMFCToolBarButton* pButton,
CRect rect,
CMFCVisualManager::AFX_BUTTON_STATE state);
參數
pDC
[in]工具列按鈕之裝置內容的指標。
pButton
[in]工具列按鈕的指標。 架構會繪製此按鈕的框線。
矩形
[in]指定工具列按鈕界限的矩形。
state
[in]指定工具列按鈕目前狀態的列舉資料類型。
備註
這個方法的預設實作會顯示標準框線。 覆寫衍生視覺效果管理員中的這個方法,以自訂工具列按鈕框線的外觀。
工具列按鈕的可能狀態為 ButtonsIsRegular
、 ButtonsIsPressed
或 ButtonsIsHighlighted
。
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::IdClose
、 CMenuImages::IdArowLeft
、 CMenuImages::IdArowRight
、 CMenuImages::IdArowDown
、 CMenuImages::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]工具列按鈕的狀態。
備註
此方法的預設實作會使用預設色彩填滿背景。 覆寫衍生視覺效果管理員中的這個方法,以自訂工具列按鈕的背景。
工具列按鈕的可能狀態為 ButtonsIsRegular
、 ButtonsIsPressed
或 ButtonsIsHighlighted
。
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]編輯控制項上所選文字色彩的參考。
備註
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 類別 實例的 指標。 架構會填入此功能區面板的功能表框。
矩形
[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]布林參數,指出視覺管理員是否在醒目提示影像下顯示陰影。
備註
根據預設,此功能已停用。
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應