CMFCVisualManager 类
提供在全局级别更改应用程序外观的支持。 CMFCVisualManager
类与说明如何绘制应用程序中 GUI 控件的类一起使用,且使用一致样式。 这些其他类称为视觉管理器,从 CMFCBaseVisualManager
继承而来。
有关详细信息,请参阅所安装的 Visual Studio 的 C\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::DestroyInstance
static void __stdcall DestroyInstance(BOOL bAutoDestroyOnly = FALSE);
参数
[in] bAutoDestroyOnly
备注
CMFCVisualManager::DoDrawHeaderSortArrow
void DoDrawHeaderSortArrow(
CDC* pDC,
CRect rect,
BOOL bIsUp,
BOOL bDlgCtrl);
参数
[in] pDC
[in] rect
[in] bIsUp
[in] bDlgCtrl
备注
CMFCVisualManager::DrawComboBorderWinXP
virtual BOOL DrawComboBorderWinXP(CDC*,
CRect,
BOOL,
BOOL,
BOOL);
参数
[in] CDC*
[in] CRect
[in] BOOL
返回值
备注
CMFCVisualManager::DrawComboDropButtonWinXP
virtual BOOL DrawComboDropButtonWinXP(CDC*,
CRect,
BOOL,
BOOL,
BOOL);
参数
[in] CDC*
[in] CRect
[in] BOOL
返回值
备注
CMFCVisualManager::DrawPushButtonWinXP
virtual BOOL DrawPushButtonWinXP(CDC*,
CRect,
CMFCButton*,
UINT);
参数
[in] CDC*
[in] CRect
[in] CMFCButton*
[in] UINT
返回值
备注
CMFCVisualManager::DrawTextOnGlass
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] 一个指向自动隐藏按钮的指针。
返回值
一个 COLORREF 参数,指定 pButton 的文本颜色。
注解
在派生类中替代此方法,以自定义应用程序中自动隐藏按钮的文本颜色。 为此,请返回希望应用程序用作文本颜色的颜色。
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 类对象的指针。
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] 一个指向框架正在绘制的属性列表的指针。
返回值
一个 COLORREF 参数,指示 pPropList 的背景色。
备注
替代此函数以自定义应用程序中属性列表的背景色。
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;
参数
[in] 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*);
参数
[in] CMFCBaseTabCtrl*
返回值
注解
CMFCVisualManager::GetTabTextColor
virtual COLORREF GetTabTextColor(
const CMFCBaseTabCtrl*,
int,
BOOL);
参数
[in] CMFCBaseTabCtrl*
[in] int
[in] 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 在具有 state 所指示的状态时的文本颜色。
注解
CMFCToolBarButton 类对象的文本颜色取决于按钮的状态。 工具栏按钮可能处于 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;
参数
[in] CMFCDesktopAlertWndButton*
返回值
备注
CMFCVisualManager::IsDockingTabHasBorder
返回当前虚拟管理器是否绘制停靠窗格和选项卡式窗格的边框。
virtual BOOL IsDockingTabHasBorder();
返回值
如果虚拟管理器在选项卡式停靠窗格周围绘制边框,则为 TRUE;否则为 FALSE。
备注
当多个窗格停靠到同一位置时,停靠窗格会变为选项卡式。
CMFCVisualManager::IsEmbossDisabledImage
指定框架是否对不可用的图像设置浮雕。
BOOL IsEmbossDisabledImage() const;
返回值
如果框架为不可用的图像设置浮雕,则为非零值;否则为 0。
备注
CMFCToolBarImages::Draw 在工具栏上绘制不可用的图像时会调用此方法。
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*);
参数
[in] 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 参数不包含边框的坐标。 它包含 top
、bottom
、left
和 right
数据成员中的边框大小。 如果值小于或等于 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
、ButtonsIsPressed
和 ButtonsIsHighlighted
。
CMFCVisualManager::OnDrawButtonBorder
框架在绘制工具栏按钮的边框时调用此方法。
virtual void OnDrawButtonBorder(
CDC* pDC,
CMFCToolBarButton* pButton,
CRect rect,
CMFCVisualManager::AFX_BUTTON_STATE state);
参数
pDC
[in] 一个指向工具栏按钮的设备上下文的指针。
pButton
[in] 指向工具栏按钮的指针。 框架会绘制此按钮的边框。
rect
[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] rect
[in] state
[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::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] 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] 一个布尔参数,指定按钮是否突出显示。
备注
菜单系统按钮是位于标题栏上的“关闭”、“最小化”、“最大化”和“还原”按钮。
此方法的默认实现调用类型为 DFC_CAPTION 的 CDC::DrawFrameControl。 在派生的虚拟管理器类中替代此方法,以自定义系统按钮的外观。
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 类对象的边框时调用此方法。
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 类对象。
返回值
一个 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] color
[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
框架在绘制主面板上的 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] state
备注
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] 状态栏的 ID。
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。
备注
当 CMFCPopupMenu
对象处理 WM_PAINT 消息,并且必须绘制拖曳标题栏时,框架将调用此函数。
若要自定义拖曳栏的标题栏外观,请在派生类中替代此方法。
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。
注解
此方法使用活动选项卡的背景色填充 rect 指示的区域。当 CMFCBaseTabCtrl
对象处理 WM_PAINT 消息并擦除选项卡框架时,会调用它。
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
中的三维背景色填充栏的背景。 若要自定义窗格的背景,请在派生的虚拟管理器中替代此方法。
示例
下面的示例演示如何使用 CMFCVisualManager
类中的 OnFillBarBackground
。 此代码片段是 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] 工具栏按钮的状态。
备注
此方法的默认实现使用默认颜色填充背景。 若要自定义工具栏按钮的背景,请在派生的虚拟管理器中替代此方法。
工具栏按钮可能处于 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] 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] 对编辑控件上所选文本的颜色的引用。
备注
pEdit 所指示的 CMFCRibbonRichEditCtrl
可以是功能区上组合框按钮的一部分。
若要自定义 CMFCRibbonRichEditCtrl
的外观,请在派生的虚拟管理器中替代此方法。
CMFCVisualManager::OnFillRibbonMainPanelButton
框架在填充主面板上的功能区按钮的内部时会调用此方法。
virtual COLORREF OnFillRibbonMainPanelButton(
CDC* pDC,
CMFCRibbonButton* pButton);
参数
pDC
[in] 指向设备上下文的指针。
pButton
[in] 一个指向 CMFCRibbonButton 类对象的指针。 框架会填充此功能区按钮。
返回值
如果功能区按钮支持文本,则为 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] 突出显示的菜单项的当前文本颜色。 默认实现不使用此参数。
备注
此方法的默认实现不使用参数 pButton 或 clrText。 它使用标准背景色填充 rect 指定的矩形。
若要自定义突出显示的菜单项的外观,请在派生的虚拟管理器中替代此方法。 使用 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] color
返回值
注解
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] 一个布尔参数,指示虚拟管理器是否在突出显示的图像下显示阴影。
备注
默认禁用此功能。