CMFCVisualManagerOffice2003 Class

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at CMFCVisualManagerOffice2003 Class.

CMFCVisualManagerOffice2003` gives an application a Microsoft Office 2003 appearance.

class CMFCVisualManagerOffice2003 : public CMFCVisualManagerOfficeXP  

Public Methods

NameDescription
CMFCVisualManagerOffice2003::DrawComboBorderWinXPDraws the combo box border using the current Windows XP theme. (Overrides CMFCVisualManager::DrawComboBorderWinXP.)
CMFCVisualManagerOffice2003::DrawComboDropButtonWinXPDraws a combo box drop-down button using the current Windows XP theme. (Overrides CMFCVisualManager::DrawComboDropButtonWinXP.)
CMFCVisualManagerOffice2003::DrawCustomizeButtonDraws a customize button.
CMFCVisualManagerOffice2003::DrawPushButtonWinXPDraws a push button using the current Windows XP theme. (Overrides CMFCVisualManager::DrawPushButtonWinXP.)
CMFCVisualManagerOffice2003::GetBaseThemeColorGets the base theme color.
CMFCVisualManagerOffice2003::GetHighlightMenuItemColorGets the color used for the highlighted menu item.
CMFCVisualManagerOffice2003::GetPropertyGridGroupColorThe framework calls this method to get the background color of a property list. (Overrides CMFCVisualManagerOfficeXP::GetPropertyGridGroupColor.)
CMFCVisualManagerOffice2003::GetPropertyGridGroupTextColorThe framework calls this method to retrieve the text color of a property list. (Overrides CMFCVisualManagerOfficeXP::GetPropertyGridGroupTextColor.)
CMFCVisualManagerOffice2003::GetShowAllMenuItemsHeightReturns the height of all menu items. (Overrides CMFCVisualManager::GetShowAllMenuItemsHeight.)
CMFCVisualManagerOffice2003::GetSmartDockingBaseGuideColorsSets the specified base group background color and border color. (Overrides CMFCVisualManagerOfficeXP::GetSmartDockingBaseGuideColors.)
CMFCVisualManagerOffice2003::GetSmartDockingHighlightToneColorGets the highlight tone color. (Overrides CMFCVisualManager::GetSmartDockingHighlightToneColor.)
CMFCVisualManagerOffice2003::GetTabFrameColorsThe framework calls this function when it has to retrieve the set of colors for drawing a tab window. (Overrides CMFCVisualManager::GetTabFrameColors.)
CMFCVisualManagerOffice2003::GetToolBarCustomizeButtonMarginGets the margin of the toolbar Customize button. (Overrides CMFCVisualManager::GetToolBarCustomizeButtonMargin.)
CMFCVisualManagerOffice2003::GetToolbarDisabledColorGets the disabled color for the toolbar. (Overrides CMFCVisualManager::GetToolbarDisabledColor.)
CMFCVisualManagerOffice2003::GetToolTipInfoCalled by the framework to get tooltip information. (Overrides CMFCVisualManager::GetToolTipInfo.)
CMFCVisualManagerOffice2003::IsDefaultWinXPColorsEnabledIndicates whether the visual manager uses native Windows XP theme colors.
CMFCVisualManagerOffice2003::IsDockingTabHasBorderReturns whether the current visual manager draws borders around panes that are docked and tabbed. (Overrides CMFCVisualManager::IsDockingTabHasBorder.)
CMFCVisualManagerOffice2003::IsHighlightOneNoteTabsIndicates whether OneNote tabs should be highlighted. (Overrides CMFCVisualManager::IsHighlightOneNoteTabs.)
CMFCVisualManagerOffice2003::IsOffsetPressedButtonCalled by the framework when drawing a toolbar button. (Overrides CMFCVisualManager::IsOffsetPressedButton.)
CMFCVisualManagerOffice2003::IsStatusBarOfficeXPLookIndicates whether there is a status bar with an Office XP look.
CMFCVisualManagerOffice2003::IsToolbarRoundShapeIndicates whether a specified toolbar has a round shape. (Overrides CMFCVisualManager::IsToolbarRoundShape.)
CMFCVisualManagerOffice2003::IsUseGlobalThemeIndicates whether a global Windows XP theme is used.
CMFCVisualManagerOffice2003::IsWindowsThemingSupportedIndicates whether Windows theming is supported. (Overrides CMFCVisualManager::IsWindowsThemingSupported.)
CMFCVisualManagerOffice2003::OnDrawAutoHideButtonBorderThe framework calls this method when it draws the border of an auto-hide button. (Overrides CMFCVisualManager::OnDrawAutoHideButtonBorder.)
CMFCVisualManagerOffice2003::OnDrawBarGripperCalled by the framework when it draws the gripper for a control bar. (Overrides CMFCVisualManagerOfficeXP::OnDrawBarGripper.)
CMFCVisualManagerOffice2003::OnDrawBrowseButtonThe framework calls this method when it draws the browse button for an edit control. (Overrides CMFCVisualManagerOfficeXP::OnDrawBrowseButton.)
CMFCVisualManagerOffice2003::OnDrawButtonBorderThe framework calls this method when it draws the border of a toolbar button. (Overrides CMFCVisualManagerOfficeXP::OnDrawButtonBorder.)
CMFCVisualManagerOffice2003::OnDrawCaptionBarBorderThe framework calls this method when it draws the border of a CMFCCaptionBar Class object. (Overrides CMFCVisualManager::OnDrawCaptionBarBorder.)
CMFCVisualManagerOffice2003::OnDrawCheckBoxExThe framework calls this method when it draws a checkbox. (Overrides CMFCVisualManager::OnDrawCheckBoxEx.)
CMFCVisualManagerOffice2003::OnDrawComboBorderThe framework calls this method when it draws the border around a CMFCToolBarComboBoxButton Class object. (Overrides CMFCVisualManagerOfficeXP::OnDrawComboBorder.)
CMFCVisualManagerOffice2003::OnDrawComboDropButtonThe framework calls this method when it draws the drop button of a CMFCToolBarComboBoxButton Class. (Overrides CMFCVisualManagerOfficeXP::OnDrawComboDropButton.)
CMFCVisualManagerOffice2003::OnDrawControlBorderThe framework calls this method when it draws the border of a control. (Overrides CMFCVisualManager::OnDrawControlBorder.)
CMFCVisualManagerOffice2003::OnDrawExpandingBoxThe framework calls this method when it draws an expanding box. (Overrides CMFCVisualManager::OnDrawExpandingBox.)
CMFCVisualManagerOffice2003::OnDrawHeaderCtrlBorderThe framework calls this method when it draws the border around an instance of the CMFCHeaderCtrl Class. (Overrides CMFCVisualManager::OnDrawHeaderCtrlBorder.)
CMFCVisualManagerOffice2003::OnDrawMenuBorderThe framework calls this method when it draws the border of a CMFCPopupMenu Class. (Overrides CMFCVisualManagerOfficeXP::OnDrawMenuBorder.)
CMFCVisualManagerOffice2003::OnDrawOutlookBarSplitterThe framework calls this method when it draws the splitter for an Outlook bar. (Overrides CMFCVisualManager::OnDrawOutlookBarSplitter.)
CMFCVisualManagerOffice2003::OnDrawOutlookPageButtonBorderCalled by the framework when it draws the border of an Outlook page button. (Overrides CMFCVisualManager::OnDrawOutlookPageButtonBorder.)
CMFCVisualManagerOffice2003::OnDrawPaneBorderThe framework calls this method when it draws the border of a CPane Class object. (Overrides CMFCVisualManagerOfficeXP::OnDrawPaneBorder.)
CMFCVisualManagerOffice2003::OnDrawPaneCaptionThe framework calls this method when it draws a caption for a CDockablePane Class object. (Overrides CMFCVisualManagerOfficeXP::OnDrawPaneCaption.)
CMFCVisualManagerOffice2003::OnDrawPopupWindowBorderThe framework calls this method when it draws the border of a popup window. (Overrides CMFCVisualManagerOfficeXP::OnDrawPopupWindowBorder.)
CMFCVisualManagerOffice2003::OnDrawPopupWindowButtonBorderThe framework calls this method when it draws the border of a button in a popup window. (Overrides CMFCVisualManagerOfficeXP::OnDrawPopupWindowButtonBorder.)
CMFCVisualManagerOffice2003::OnDrawPopupWindowCaptionThe framework calls this method when it draws the caption of a popup window. (Overrides CMFCVisualManagerOfficeXP::OnDrawPopupWindowCaption.)
CMFCVisualManagerOffice2003::OnDrawRibbonButtonsGroupThe framework calls this method when it draws a group of buttons on the ribbon. (Overrides CMFCVisualManager::OnDrawRibbonButtonsGroup.)
CMFCVisualManagerOffice2003::OnDrawRibbonCategoryCaptionThe framework calls this method when it draws the caption bar for a ribbon category. (Overrides CMFCVisualManager::OnDrawRibbonCategoryCaption.)
CMFCVisualManagerOffice2003::OnDrawRibbonCategoryTabThe framework calls this method when it draws the tab for a ribbon category. (Overrides CMFCVisualManager::OnDrawRibbonCategoryTab.)
CMFCVisualManagerOffice2003::OnDrawRibbonProgressBarThe framework calls this method when it draws a CMFCRibbonProgressBar Class. (Overrides CMFCVisualManager::OnDrawRibbonProgressBar.)
CMFCVisualManagerOffice2003::OnDrawRibbonQuickAccessToolBarSeparatorThe framework calls this method when it draws a separator on the Quick Access Toolbar of a ribbon. (Overrides CMFCVisualManagerOfficeXP::OnDrawRibbonQuickAccessToolBarSeparator.)
CMFCVisualManagerOffice2003::OnDrawRibbonSliderChannelThe framework calls this method when it draws the channel of a CMFCRibbonSlider Class. (Overrides CMFCVisualManager::OnDrawRibbonSliderChannel.)
CMFCVisualManagerOffice2003::OnDrawRibbonSliderThumbThe framework calls this method when it draws the thumb of a CMFCRibbonSlider object. (Overrides CMFCVisualManager::OnDrawRibbonSliderThumb.)
CMFCVisualManagerOffice2003::OnDrawRibbonSliderZoomButtonThe framework calls this method when it draws the zoom buttons for a CMFCRibbonSlider object. (Overrides CMFCVisualManager::OnDrawRibbonSliderZoomButton.)
CMFCVisualManagerOffice2003::OnDrawRibbonStatusBarPaneThe framework calls this method when it draws a pane on the status bar. (Overrides CMFCVisualManagerOfficeXP::OnDrawRibbonStatusBarPane.)
CMFCVisualManagerOffice2003::OnDrawScrollButtonsThe framework calls this method when it draws scroll buttons. (Overrides CMFCVisualManagerOfficeXP::OnDrawScrollButtons.)
CMFCVisualManagerOffice2003::OnDrawSeparatorThe framework calls this method when it draws a separator. (Overrides CMFCVisualManagerOfficeXP::OnDrawSeparator.)
CMFCVisualManagerOffice2003::OnDrawShowAllMenuItemsThe framework calls this method when it draws all the items in a menu. (Overrides CMFCVisualManager::OnDrawShowAllMenuItems.)
CMFCVisualManagerOffice2003::OnDrawStatusBarPaneBorderThe framework calls this method when it draws the border for a CMFCStatusBar Class object. (Overrides CMFCVisualManagerOfficeXP::OnDrawStatusBarPaneBorder.)
CMFCVisualManagerOffice2003::OnDrawStatusBarProgressThe framework calls this method when it draws the progress indicator on the CMFCStatusBar object. (Overrides CMFCVisualManager::OnDrawStatusBarProgress.)
CMFCVisualManagerOffice2003::OnDrawStatusBarSizeBoxThe framework calls this method when it draws the size box for a CMFCStatusBar. (Overrides CMFCVisualManager::OnDrawStatusBarSizeBox.)
CMFCVisualManagerOffice2003::OnDrawTabThe framework calls this method when it draws the tabs for a CMFCBaseTabCtrl Class object. (Overrides CMFCVisualManagerOfficeXP::OnDrawTab.)
CMFCVisualManagerOffice2003::OnDrawTabsButtonBorderThe framework calls this method when it draws the border of a tab button. (Overrides CMFCVisualManagerOfficeXP::OnDrawTabsButtonBorder.)
CMFCVisualManagerOffice2003::OnDrawTaskThe framework calls this method when it draws a CMFCTasksPaneTask Class object. (Overrides CMFCVisualManagerOfficeXP::OnDrawTask.)
CMFCVisualManagerOffice2003::OnDrawTasksGroupAreaBorderThe framework calls this method when it draws a border around a group on a CMFCTasksPane Class object. (Overrides CMFCVisualManagerOfficeXP::OnDrawTasksGroupAreaBorder.)
CMFCVisualManagerOffice2003::OnDrawTasksGroupCaptionThe framework calls this method when it draws the caption for a CMFCTasksPaneTaskGroup Class object. (Overrides CMFCVisualManagerOfficeXP::OnDrawTasksGroupCaption.)
CMFCVisualManagerOffice2003::OnDrawTearOffCaptionThe framework calls this method when it draws the caption for a CMFCPopupMenu Class object. (Overrides CMFCVisualManagerOfficeXP::OnDrawTearOffCaption.)
CMFCVisualManagerOffice2003::OnErasePopupWindowButtonThe framework calls this method when it erases a button in a popup window. (Overrides CMFCVisualManagerOfficeXP::OnErasePopupWindowButton.)
CMFCVisualManagerOffice2003::OnEraseTabsAreaThe framework calls this method when it erases the tab area of a tab window. (Overrides CMFCVisualManagerOfficeXP::OnEraseTabsArea.)
CMFCVisualManagerOffice2003::OnEraseTabsButtonThe framework calls this method when it erases the text and icon of a tab button. (Overrides CMFCVisualManagerOfficeXP::OnEraseTabsButton.)
CMFCVisualManagerOffice2003::OnEraseTabsFrameThe framework calls this method when it erases a frame on a CMFCBaseTabCtrl Class. (Overrides CMFCVisualManager::OnEraseTabsFrame.)
CMFCVisualManagerOffice2003::OnFillAutoHideButtonBackgroundThe framework calls this method when it fills the background of an auto-hide button. (Overrides CMFCVisualManager::OnFillAutoHideButtonBackground.)
CMFCVisualManagerOffice2003::OnFillBarBackgroundThe framework calls this method when it fills the background of a CBasePane Class object. (Overrides CMFCVisualManagerOfficeXP::OnFillBarBackground.)
CMFCVisualManagerOffice2003::OnFillButtonInteriorThe framework calls this method when it fills the background of a toolbar button. (Overrides CMFCVisualManagerOfficeXP::OnFillButtonInterior.)
CMFCVisualManagerOffice2003::OnFillCommandsListBackgroundThe framework calls this method when it fills the background of a toolbar button that belongs to a command list. (Overrides CMFCVisualManagerOfficeXP::OnFillCommandsListBackground.)
CMFCVisualManagerOffice2003::OnFillHeaderCtrlBackgroundThe framework calls this method when it fills the background of a header control. (Overrides CMFCVisualManager::OnFillHeaderCtrlBackground.)
CMFCVisualManagerOffice2003::OnFillHighlightedAreaThe framework calls this method when it fills the highlighted area of a toolbar button. (Overrides CMFCVisualManagerOfficeXP::OnFillHighlightedArea.)
CMFCVisualManagerOffice2003::OnFillOutlookBarCaptionThe framework calls this method when it fills the background of an Outlook caption bar. (Overrides CMFCVisualManager::OnFillOutlookBarCaption.)
CMFCVisualManagerOffice2003::OnFillOutlookPageButtonThe framework calls this method when it fills the interior of an Outlook page button. (Overrides CMFCVisualManager::OnFillOutlookPageButton.)
CMFCVisualManagerOffice2003::OnFillPopupWindowBackgroundThe framework calls this method when it fills the background of a pop-up window. (Overrides CMFCVisualManagerOfficeXP::OnFillPopupWindowBackground.)
CMFCVisualManagerOffice2003::OnFillTabThe framework calls this method when it fills the background of a tab window. (Overrides CMFCVisualManagerOfficeXP::OnFillTab.)
CMFCVisualManagerOffice2003::OnFillTasksGroupInteriorThe framework calls this method when it fills the interior of a CMFCTasksPaneTaskGroup Class object. (Overrides CMFCVisualManagerOfficeXP::OnFillTasksGroupInterior.)
CMFCVisualManagerOffice2003::OnFillTasksPaneBackgroundThe framework calls this method when it fills the background of a CMFCTasksPane control. (Overrides CMFCVisualManager::OnFillTasksPaneBackground.)
CMFCVisualManagerOffice2003::OnHighlightQuickCustomizeMenuButtonThe framework calls this method when it draws a highlighted quick-customize menu button. (Overrides CMFCVisualManagerOfficeXP::OnHighlightQuickCustomizeMenuButton.)
CMFCVisualManagerOffice2003::OnHighlightRarelyUsedMenuItemsThe framework calls this method when it draws a highlighted menu command. (Overrides CMFCVisualManagerOfficeXP::OnHighlightRarelyUsedMenuItems.)
CMFCVisualManagerOffice2003::OnUpdateSystemColorsThe framework calls this function when the system colors change. (Overrides CMFCVisualManagerOfficeXP::OnUpdateSystemColors.)
CMFCVisualManagerOffice2003::SetDefaultWinXPColorsSpecifies whether the visual manager should use native Windows XP theme colors or colors obtained from GetSysColor.
CMFCVisualManagerOffice2003::SetStatusBarOfficeXPLookSpecifies that the Windows XP global theme should be used.
CMFCVisualManagerOffice2003::SetUseGlobalThemeSpecifies whether the visual manager uses a global theme.

You use the CMFCVisualManagerOffice2003 class to change the visual appearance of your application to resemble Microsoft Office 2003.

The following example demonstrates how to set the office 2003 visual manager. This code snippet is part of the Desktop Alert Demo sample.

	CMFCVisualManager::SetDefaultManager (RUNTIME_CLASS (CMFCVisualManagerOffice2003));

CObject

CMFCBaseVisualManager

CMFCVisualManager

CMFCVisualManagerOfficeXP

CMFCVisualManagerOffice2003

Header: afxvisualmanageroffice2003.h

Draws the combo box border using the current Windows XP theme.

virtual BOOL DrawComboBorderWinXP(
    CDC* pDC,  
    CRect rect,  
    BOOL bDisabled,  
    BOOL bIsDropped,  
    BOOL bIsHighlighted);

Parameters

[in] pDC
A pointer to a device context.

[in] rect
Bounding rectangle of the combo box border.

[in] bDisabled
Specifies whether the combo box border is disabled.

[in] bIsDropped
Specifies whether the combo box border is dropped down.

[in] bIsHighlighted
Specifies whether the combo box border is highlighted.

Return Value

Returns TRUE if the theme API is enabled or FALSE if not.

Remarks

Draws a combo box drop-down button using the current Windows XP theme.

virtual BOOL DrawComboDropButtonWinXP(
    CDC* pDC,  
    CRect rect,  
    BOOL bDisabled,  
    BOOL bIsDropped,  
    BOOL bIsHighlighted);

Parameters

[in] pDC
A pointer to a device context.

[in] rect
The bounding rectangle of the combo box drop-down button.

[in] bDisabled
Specifies whether the combo box drop-down button is disabled.

[in] bIsDropped
Specifies whether the combo box drop-down button is dropped down.

[in] bIsHighlighted
Specifies whether the combo box drop-down button is highlighted.

Return Value

Returns TRUE if the theme API is enabled or FALSE if not.

Remarks

Draws a customize button.

virtual void DrawCustomizeButton(
    CDC* pDC,  
    CRect rect,  
    BOOL bIsHorz,  
    CMFCVisualManager::AFX_BUTTON_STATE state,  
    BOOL bIsCustomize,  
    BOOL bIsMoreButtons);

Parameters

[in] pDC
Pointer to a display context.

[in] rect
The bounding rectangle of the button

[in] bIsHorz
TRUE if the button is horizontal, or FALSE if it is vertical.

[in] state
The state of the button as it is to be drawn (regular, pressed or highlighted).

[in] bIsCustomize
TRUE if the customize arrow-down or arrow-left image should be drawn in the button rectangle, or FALSE if not.

[in] bIsMoreButtons
TRUE if the horizontal or vertical customize More-Buttons image should be drawn in the button rectangle, or FALSE if not.

Remarks

Draws a push button using the current Windows XP theme.

virtual BOOL DrawPushButtonWinXP(
    CDC* pDC,  
    CRect rect,  
    CMFCButton* pButton,  
    UINT uiState);

Parameters

[in] pDC
A pointer to a device context.

[in] rect
The bounding rectangle of the push button.

[in] pButton
A pointer to the CMFCButton Class object to draw.

[in] uiState
Ignored. The state is taken from pButton.

Return Value

TRUE if the Theme API is enabled; otherwise FALSE.

Remarks

Gets the base theme color.

virtual COLORREF GetBaseThemeColor();

Return Value

Returns the theme color of the base theme, if one is set, or the color-bar face color.

Remarks

Gets the color used for the highlighted menu item.

virtual COLORREF GetHighlightMenuItemColor() const;  

Return Value

Returns the color used for the highlighted menu item.

Remarks

The framework calls this method to get the background color of a property list.

virtual COLORREF GetPropertyGridGroupColor(CMFCPropertyGridCtrl* pPropList);

Parameters

[in] pPropList
A pointer to the property list that the framework is drawing.

Return Value

Returns the background color of pPropList.

Remarks

Override this function to customize the background color of a property list in your application.

The framework calls this method to retrieve the text color of a property list.

virtual COLORREF GetPropertyGridGroupTextColor(CMFCPropertyGridCtrl* pPropList);

Parameters

[in] pPropList
A pointer to the property list.

Return Value

Returns the text color of the specified property list.

Remarks

Override this function to customize the text color of a property list in your application.

Returns the height of all menu items.

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

Parameters

[in] pDC
A pointer to the device context.

[in] sizeDefault
Default menu size.

Return Value

By default, returns the height of all menu images plus margins.

Remarks

Sets the specified base group background color and border color.

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

Parameters

[in] clrBaseGroupBackground
Reference to a COLORREF to set to the background color.

[in] clrBaseGroupBorder
Reference to a COLORREF to set to the border color.

Remarks

Returns the highlight tone color.

virtual COLORREF GetSmartDockingHighlightToneColor();

Return Value

Returns a COLORREF that contains the highlight tone color.

Remarks

The framework calls this function when it has to retrieve the set of colors for drawing a tab window.

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

Parameters

[in] pTabWnd
A pointer to the tabbed window where the frame is drawing a tab.

[out] clrDark
A reference to a COLORREF parameter where this method stores the color for the dark border of a tab.

[out] clrBlack
A reference to a COLORREF parameter where this method stores the color for the border of the tab window. The default color for the border is black.

[out] clrHighlight
A reference to a COLORREF parameter where this method stores the color for the highlight state of the tab window.

[out] clrFace
A reference to a COLORREF parameter where this method stores the color for face of the tab window.

[out] clrDarkShadow
A reference to a COLORREF parameter where this method stores the color for the shadow of the tab window.

[out] clrLight
A reference to a COLORREF parameter where this method stores the color for the light edge of the tab window.

[out] pbrFace
A pointer to a reference for a brush. This method stores the brush that it uses to fill the face of the tab window in this parameter.

[out] pbrBlack
A pointer to a reference for a brush. This method stores the brush it uses to fill the black edge of the tab window in this parameter.

Remarks

Gets the margin for the toolbar Customize button.

virtual int GetToolBarCustomizeButtonMargin() const;  

Return Value

Returns the margin for the toolbar Customize button.

Remarks

Gets the disabled color for the toolbar.

virtual COLORREF GetToolbarDisabledColor() const;  

Return Value

Returns a COLORREF that contains the disabled color.

Remarks

Called by the framework to get tooltip information.

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

Parameters

[out] params
A reference to a CMFCToolTipInfo Class object where this method returns tooltip information.

[in] nType
Type information for the tooltip information to be returned.

Return Value

Returns TRUE if tooltip information is returned, and FALSE otherwise.

Remarks

Indicates whether the visual manager uses theme colors that are native to Windows XP.

static BOOL IsDefaultWinXPColorsEnabled();

Return Value

TRUE if the visual manager uses native colors; otherwise, FALSE.

Remarks

For more information about native colors, see CMFCVisualManagerOffice2003::SetDefaultWinXPColors.

Returns whether the current visual manager draws borders around panes that are docked and tabbed.

virtual BOOL IsDockingTabHasBorder();

Return Value

TRUE if the visual manager draws borders around panes that are docked and tabbed; FALSE otherwise.

Remarks

Indicates whether OneNote tabs should be highlighted.

virtual BOOL IsHighlightOneNoteTabs() const;  

Return Value

Returns TRUE.

Remarks

Called by the framework while drawing a toolbar button.

virtual BOOL IsOffsetPressedButton() const;  

Return Value

Remarks

The default implementation returns FALSE.

Indicates whether there is a status bar with an Office XP look.

static BOOL __stdcall IsStatusBarOfficeXPLook();

Return Value

Remarks

Returns TRUE if there is a status bar with an Office XP look, or FALSE if not.

Indicates whether a specified toolbar is round.

virtual BOOL IsToolbarRoundShape(CMFCToolBar* pToolBar);

Parameters

[in] pToolBar
Pointer to the toolbar in question.

Return Value

Returns TRUE if the toolbar is round, or FALSE if it is a menu bar.

Remarks

Indicates whether your application uses a Windows XP theme.

static BOOL IsUseGlobalTheme();

Return Value

TRUE if the visual manager uses a Windows XP theme; otherwise, FALSE.

Remarks

Use the method CMFCVisualManagerOffice2003::SetUseGlobalTheme to change whether your visual manager uses a Windows XP theme.

Indicates whether Windows theming is supported.

virtual BOOL IsWindowsThemingSupported() const;  

Return Value

Returns TRUE if Windows theming is supported, or FALSE if not.

Remarks

The framework calls this method when it draws the border of an auto-hide button.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rectBounds
The size and location of the auto-hide button.

[in] rectBorderSize
The sizes of the borders.

[in] pButton
A pointer to the auto-hide button. The framework is drawing the border for this button.

Remarks

Override this method in a derived class if you want to customize the appearance of the border of an auto-hide button. By default, this method fills a flat border with the default shadow color for your application.

The rectBorderSize parameter does not contain the coordinates of the border. It contains the size of the border in the top, bottom, left, and right data members. A value less than or equal to 0 indicates no border on that side of the auto-hide button.

Called by the framework when it draws the gripper for a control bar.

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

Parameters

[in] pDC
A pointer to the device context for a control bar.

[in] rectGripper
The bounding rectangle for the control bar.

[in] bHorz
A Boolean parameter that specifies whether the control bar is docked horizontally or vertically.

[in] pBar
A pointer to a control bar. The visual manager draws the gripper of this control bar.

Remarks

The default implementation of this method displays the standard gripper. To customize the appearance of the gripper, override this method in a custom class derived from the CMFCVisualManagerOffice2003 Class.

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

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

Parameters

[in] pDC
[in] rect
[in] pEdit
[in] state
[in] clrText

Return Value

Remarks

The framework calls this method when it draws the border of a toolbar button.

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

Parameters

[in] pDC
A pointer to the device context of a toolbar button.

[in] pButton
A pointer to a toolbar button. The framework draws the border of this button.

[in] rect
A rectangle that specifies the boundaries of the toolbar button.

[in] state
An enumerated data type that specifies the current state of the toolbar button.

Remarks

The default implementation of this method displays the standard border. Override this method in a derived visual manager to customize the appearance of the border of a toolbar button.

The possible states of a toolbar button are ButtonsIsRegular, ButtonsIsPressed, or ButtonsIsHighlighted.

The framework calls this method when it draws the border of a CMFCCaptionBar Class object.

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

Parameters

[in] pDC
A pointer to a device context.

[in] pBar
A pointer to a CMFCCaptionBar Class object. The framework draws this caption bar.

[in] rect
A rectangle that specifies the boundaries of the caption bar.

[in] clrBarBorder
The color of the border.

[in] bFlatBorder
TRUE if the border should have a flat, 2D appearance, or FALSE if not.

Remarks

Override this method in a derived class to customize the appearance of the border of a caption bar.

Called by the framework when drawing a checkbox.

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

Parameters

[in] pDC
Pointer to a device context.

[in] rect
The bounding rectangle of the checkbox.

[in] nState
The state of the checkbox: 0 if unchecked, 1 if checked, 2 if checked mixed.

[in] bHighlighted
TRUE if the checkbox is highlighted, or FALSE if not.

[in] bPressed
TRUE if the checkbox is pressed, or FALSE if not.

[in] bEnabled
TRUE if the checkbox is enabled, or FALSE if not.

Remarks

The framework calls this method when it draws the border around an instance of a CMFCToolBarComboBoxButton Class.

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

Parameters

[in] pDC
A pointer to the device context of a combo box button.

[in] rect
A rectangle that specifies the boundaries of the combo box button.

[in] bDisabled
A Boolean parameter that indicates whether the combo box button is unavailable.

[in] bIsDropped
A Boolean parameter that indicates whether the combo box is dropped down.

[in] bIsHighlighted
A Boolean parameter that indicates whether the combo box button is highlighted.

[in] pButton
A pointer to a CMFCToolBarComboBoxButton object. The framework draws this combo box button.

Remarks

Override this method in your derived visual manager to customize the appearance of the border of the combo box.

The framework calls this method when it draws the drop button of a CMFCToolBarComboBoxButton Class.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rect
A rectangle that specifies the boundaries of the drop button.

[in] bDisabled
A Boolean parameter that indicates whether the drop button is unavailable.

[in] bIsDropped
A Boolean parameter that indicates whether the combo box is dropped down.

[in] bIsHighlighted
A Boolean parameter that indicates whether the drop button is highlighted.

[in] pButton
A pointer to a CMFCToolBarComboBoxButton object. The framework draws the drop button for this combo box button

Remarks

Override this method in your derived visual manager to customize the appearance of the drop button of a combo box button.

The framework calls this method when it draws the border of a control.

virtual void OnDrawControlBorder(CWnd* pWndCtrl);

Parameters

[in] pWndCtrl
Pointer to a CWnd Class object representing the control for which to draw the border.

Remarks

Called by the framework while drawing an expanding box.

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

Parameters

[in] pDC
Pointer to the display context in which the expanding box is to be drawn.

[in] rect
The bounding rectangle of the expanding box to be drawn.

[in] bIsOpened
TRUE if the box to be drawn is opened, or FALSE if not.

[in] colorBox
The color of the outside border of the box to be drawn.

Remarks

The framework calls this method when it draws the border around an instance of the CMFCHeaderCtrl Class.

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

Parameters

[in] pCtrl
A pointer to a CMFCHeaderCtrl Class object. The framework draws the border of this header control.

[in] pDC
A pointer to a device context.

[in] rect
A rectangle that specifies the boundaries of the header control.

[in] bIsPressed
[in] bIsHighlighted
A Boolean parameter that indicates whether the header control is pressed.

Remarks

Override this method in a derived visual manager to customize the border of the header control.

The framework calls this method when it draws the border of a CMFCPopupMenu Class.

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

Parameters

[in] pDC
A pointer to the device context for a CMFCPopupMenu Class object.

[in] pMenu
A pointer to a CMFCPopupMenu Class object. The framework draws a border around this popup menu.

[in] rect
A rectangle that specifies the boundaries of the popup menu.

Remarks

The default implementation of this method displays the standard menu border. Override this method in a derived visual manager to customize the appearance of the menu border.

The framework calls this method when it draws the splitter for an Outlook bar.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rectSplitter
A rectangle that specifies the boundaries of the splitter.

Remarks

Override this method in a derived visual manager to customize the appearance of splitters on an Outlook bar.

Called by the framework when it draws the border of an Outlook page button.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rectBtn
A rectangle that specifies the boundary of the Outlook page button.

[in] bIsHighlighted
A Boolean that specifies whether the button is highlighted.

[in] bIsPressed
A Boolean that specifies whether the button is pressed.

Remarks

Override this method in a custom visual manager to change the appearance of the Outlook page button.

The framework calls this method when it draws the border of a CPane Class object.

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

Parameters

[in] pDC
A pointer to the device context of a control bar.

[in] pBar
A pointer to a pane. The visual manager draws the border of this pane.

[in] rect
A rectangle that indicates the boundaries of the pane.

Remarks

The default implementation of this method displays the standard border. Override this method in a derived class to customize the appearance of the border.

The framework calls this method when it draws a caption for a CDockablePane Class object.

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

Parameters

[in] pDC
A pointer to a device context.

[in] pBar
A pointer to a CDockablePane Class object. The framework draws the caption for this pane.

[in] bActive
A Boolean parameter that indicates whether the control bar is active.

[in] rectCaption
A rectangle that specifies the boundaries of the caption.

[in] rectButtons
A rectangle that specifies the boundaries of the caption buttons.

Return Value

A COLORREF parameter that indicates the text color of the caption.

Remarks

The framework calls this method when it draws the border of a popup window.

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

Parameters

[in] pDC
Pointer to the device context of the popup window.

[in] rect
The bounding rectangle of the popup window.

Remarks

The framework calls this method when it draws the border of button in a popup window.

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

Parameters

[in] pDC
Pointer to the device context of the button.

[in] rectClient
Bounding rectangle of the button.

[in] pButton
Pointer to the button (a CMFCDesktopAlertWndButton Class object).

Remarks

The framework calls this method when it draws the caption of a popup window.

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

Parameters

[in] pDC
Pointer to the device context of the caption.

[in] rectCaption
Bounding rectangle of the caption.

[in] pPopupWnd
Pointer to the popup window for which the caption is to be drawn.

Return Value

The text color of the caption.

Remarks

Override this method in a derived visual manager to customize the appearance of popup-window captions.

The framework calls this method when it draws a group of buttons on the ribbon.

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

Parameters

[in] pDC
A pointer to a device context.

[in] pGroup
A pointer to a group of buttons on the ribbon. The framework draws this group of buttons.

[in] rectGroup
A rectangle that specifies the boundaries of the group.

Return Value

A reserved value. The default implementation returns -1.

Remarks

Override this method in a derived visual manager to customize the appearance of a group of buttons on the ribbon.

The framework calls this method when it draws the caption bar for a ribbon category.

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

Parameters

[in] pDC
A pointer to the device context of the ribbon category.

[in] pContextCaption
A pointer to a caption bar. The visual manager draws this CMFCRibbonContextCaption Class.

Return Value

A COLORREF parameter that indicates the color of the text on the caption bar.

Remarks

Override this method in a derived class to customize the appearance of the caption bar for a ribbon category.

The framework calls this method when it draws the tab for a ribbon category.

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

Parameters

[in] pDC
A pointer to a device context.

[in] pTab
A pointer to a ribbon tab object. The framework draws this tab.

[in] bIsActive
TRUE if the tab is active, or FALSE if not.

Return Value

The color that is used for text on the ribbon category tab.

Remarks

Override this method in a derived visual manager to customize the appearance of a ribbon category tab.

The framework calls this method when it draws a CMFCRibbonProgressBar Classobject.

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

Parameters

[in] pDC
A pointer to a device context.

[in] pProgress
A pointer to a CMFCRibbonProgressBar Class object. The framework draws this progress bar.

[in] rectProgress
A rectangle that specifies the boundaries of the progress bar.

[in] rectChunk
A rectangle that specifies the boundaries of the area surrounding the progress bar.

[in] bInfiniteMode
TRUE if the bar is in infinite mode, or FALSE if not. The default implementation does not use this parameter.

Remarks

Override this method in a derived class to customize the appearance of a progress bar

The framework calls this method when it draws a separator on the Quick Access Toolbar of a ribbon.

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

Parameters

[in] pDC
A pointer to a device context.

[in] pSeparator
A pointer to a CMFCRibbonSeparator Class object. The framework draws this ribbon separator.

[in] rect
A rectangle that specifies the boundaries of the separator.

Remarks

Override this method in a derived class to customize the appearance of ribbon separators on the Quick Access Toolbar.

The framework calls this method when it draws the channel of a CMFCRibbonSlider Class.

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

Parameters

[in] pDC
Pointer to a device context.

[in] pSlider
A pointer to a CMFCRibbonSlider Class object. The framework draws the channel for this ribbon slider.

[in] rect
A rectangle that specifies the boundaries for the channel of the ribbon slider.

Remarks

Override this method in a derived class to customize the appearance of the channel of the ribbon slider.

The framework calls this method when it draws the thumb of a CMFCRibbonSlider Class object

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

Parameters

[in] pDC
A pointer to a device context.

[in] pSlider
A pointer to a CMFCRibbonSlider Class. The framework draws the thumb for this ribbon slider.

[in] rect
A rectangle that specifies the boundaries of the thumb for the ribbon slider.

[in] bIsHighlighted
A Boolean parameter that indicates whether the thumb is highlighted.

[in] bIsPressed
A Boolean parameter that indicates whether the thumb is pressed.

[in] bIsDisabled
A Boolean parameter that indicates whether the thumb is unavailable.

Remarks

Override this method in a derived visual manager to customize the appearance of the thumb for a ribbon slider.

The framework calls this method when it draws the zoom buttons for a CMFCRibbonSlider Class object.

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

Parameters

[in] pDC
A pointer to a device context.

[in] pSlider
A pointer to a CMFCRibbonSlider Class object. The framework draws this ribbon slider.

[in] rect
A rectangle that specifies the boundaries of the zoom buttons on the ribbon slider.

[in] bIsZoomOut
TRUE if the framework should draw the left button with a " -" for zoom out, or FALSE if the framework should draw the right button with a " +" for zoom in.

[in] bIsHighlighted
A Boolean parameter that indicates whether the button is highlighted.

[in] bIsPressed
A Boolean parameter that indicates whether the button is pressed.

[in] bIsDisabled
A Boolean parameter that indicates whether the button is unavailable.

Remarks

By default, the zoom buttons on the ribbon slider are a circle with either a + or - sign in the center. To customize the appearance of zoom buttons, override this method in a derived visual manager.

The framework calls this method when it draws a pane on the status bar.

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

Parameters

[in] pDC
A pointer to a device context.

[in] pBar
A pointer to the status bar that contains the pane.

[in] pPane
A pointer to a status bar pane. The framework draws this CMFCRibbonStatusBarPane Class object.

Return Value

A reserved value. The default implementation returns -1.

Remarks

Override this method in a derived visual manager to customize the appearance of a pane on the status bar.

The framework calls this method when it draws scroll buttons.

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

Parameters

[in] pDC
Pointer to a device context.

[in] rect
The bounding rectangle of the scroll buttons.

[in] nBorderSize
The size of the border to draw around the scroll buttons.

[in] iImage
An identifier of the image to draw in the scroll buttons.

[in] bHilited
TRUE if the scroll buttons are highlighted, or FALSE if not.

Remarks

The framework calls this method when it draws a separator.

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

Parameters

[in] pDC
A pointer to the device context for a control bar.

[in] pBar
A pointer to a pane that contains the separator.

[in] rect
A rectangle that specifies the boundaries of the separator.

[in] bIsHoriz
TRUE if the pane is docked horizontally, or FALSE if the pane is docked vertically.

Remarks

Separators are used on control bars to separate groups of related icons. The default implementation for this method displays the standard separator. Override this method in a derived visual manager to customize the appearance of the separator.

The framework calls this method when it draws all the items in a menu

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

Parameters

[in] pDC
Pointer to a device context.

[in] rect
The bounding rectangle of the menu to be drawn.

[in] state
The button state.

Remarks

The framework calls this method when it draws the border for a CMFCStatusBar Class object.

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

Parameters

[in] pDC
A pointer to a device context.

[in] pBar
A pointer to a CMFCStatusBar Class object. The framework draws this status bar object.

[in] rectPane
A rectangle that specifies the boundaries of the status bar.

[in] uiID
The ID of the status bar.

[in] nStyle
The style of the status bar.

Remarks

Override this method in a derived visual manager to customize the appearance of the border for a CMFCStatusBar object.

The framework calls this method when it draws the progress indicator on the CMFCStatusBar Class object

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

Parameters

[in] pDC
A pointer to the device context for the status bar

[in] pStatusBar
The CMFCStatusBar Class object that contains the progress bar.

[in] rectProgress
A rectangle that specifies the boundaries of the progress bar.

[in] nProgressTotal
The total number for the progress bar.

[in] nProgressCurr
The current progress for the progress bar.

[in] clrBar
The initial color for the progress bar. The value is either the start of a color gradient or the complete color of the progress bar.

[in] clrProgressBarDest
[in] clrProgressText
[in] bProgressText

Remarks

Override this method in a derived visual manager to customize the appearance of the progress bar on a status bar.

The framework calls this method when it draws the size box for a CMFCStatusBar Class.

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

Parameters

[in] pDC
A pointer to a device context.

[in] pStatBar
A pointer to a status bar. The framework draws the size box for this status bar.

[in] rectSizeBox
A rectangle that specifies the boundaries of the size box.

Remarks

Override this method in a derived visual manager to customize the appearance of the size box on a status bar.

The framework calls this method when it draws the tabs for a CMFCBaseTabCtrl Class object.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rectTab
A rectangle that specifies the boundaries of the tab control.

[in] iTab
The index of the tab that the framework draws.

[in] bIsActive
A Boolean parameter that specifies whether the tab is active.

[in] pTabWnd
A pointer to a CMFCBaseTabCtrl Class object. The framework draws this tab control.

Remarks

A CMFCBaseTabCtrl object calls this method when it processes the WM_PAINT message.Override this method in a derived class to customize the look of tabs.

The framework calls this method when it draws the border of a tab button.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rect
A rectangle that specifies the boundaries of the tab button.

[in] pButton
A pointer to the CMFCButton Class for which the framework draws the border.

[in] uiState
The state of the button (see CButton::GetState).

[in] pWndTab
A pointer to the parent tab window.

Remarks

Override this method in a derived visual manager to customize the appearance of the border of the tab button.

The framework calls this method when it draws a CMFCTasksPaneTask Class object.

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

Parameters

[in] pDC
A pointer to a device context.

[in] pTask
A pointer to a CMFCTasksPaneTask Class object. The framework draws this task.

[in] pIcons
A pointer to the image list associated with the task pane. Each task contains an index for an image in this list.

[in] bIsHighlighted
A Boolean parameter that specifies whether the displayed task is highlighted.

[in] bIsSelected
A Boolean parameter that specifies whether the displayed task is selected.

Remarks

The framework displays tasks on the task bar as both an icon and text. The pIcons parameter contains the icon for the task indicated by pTask. Override this method in a derived class to customize the appearance of tasks on the task bar.

The framework calls this method when it draws a border around a group on a CMFCTasksPane Class object.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rect
A rectangle that specifies the boundaries of the group area on the task pane.

[in] bSpecial
A Boolean parameter that specifies if the border is highlighted. A value of TRUE indicates that the border is highlighted.

[in] bNoTitle
A Boolean parameter that specifies whether the group area has a title. A value of TRUE indicates that the group area does not have a title.

Remarks

Override this function in a derived class to customize the border around a group area on the task pane.

The framework calls this method when it draws the caption for a CMFCTasksPaneTaskGroup Class object.

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

Parameters

[in] pDC
A pointer to a device context.

[in] pGroup
A pointer to a CMFCTasksPaneTaskGroup Class object. The framework draws the caption for this group.

[in] bIsHighlighted
A Boolean parameter that indicates whether the group is highlighted.

[in] bIsSelected
A Boolean parameter that indicates whether the group is currently selected.

[in] bCanCollapse
A Boolean parameter that indicates whether the group can be collapsed.

Remarks

Override this method in a derived class to customize the caption for a CMFCTasksPaneTaskGroup.

The framework calls this method when it draws the caption for a CMFCPopupMenu Class object.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rect
A rectangle that specifies the boundaries of the caption.

[in] bIsActive
TRUE if the caption is active; FALSE otherwise.

Remarks

This function is called by the framework when a CMFCPopupMenu Class object processes a WM_PAINT message and must draw a tear-off caption.

Override this method in a derived class to customize the look of captions for tear-off bars.

The framework calls this method when it erases a button in a popup window.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rectClient
The rectangle that specifies the client area of the popup window.

[in] pButton
Pointer to the button to be erased.

Remarks

The framework calls this method when it erases the tab area of a tab window.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rect
A rectangle that specifies the boundaries of the tab area.

[in] pTabWnd
A pointer to a tab window. The framework erases the tab area for the specified tab window.

Remarks

This function is called by the framework when a CMFCBaseTabCtrl Class object processes a WM_PAINT message and erases the tab area.

Override this method in a derived visual manager to customize the appearance of tabs.

The framework calls this method when it erases the text and icon of a tab button.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rect
A rectangle that specifies the boundaries of the tab button.

[in] pButton
A pointer to a tab button. The framework erases the text and icon for this button.

[in] pWndTab
A pointer to the tab control that contains the tab button.

Remarks

The framework erases the text and icon for a button when a CMFCBaseTabCtrl Class object processes the WM_ERASEBKGND message

Override this method in a derived visual manager to customize the appearance of tab buttons.

The framework calls this method when it erases a frame on a CMFCBaseTabCtrl Class object.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rect
A rectangle that specifies the boundaries of the tab window.

[in] pTabWnd
A pointer to a tab window. The framework erases a frame for this CMFCBaseTabCtrl Class.

Return Value

TRUE if the method is successful or FALSE if not.

Remarks

This method fills the area indicated by rect with the background color of the active tab. It is called when a CMFCBaseTabCtrl object processes a WM_PAINT message and erases a tab frame.

The framework calls this method when it fills the background of an auto-hide button.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rect
A rectangle that specifies the boundaries of the auto-hide button.

[in] pButton
A pointer to a CMFCAutoHideButton Class object. The framework fills the background for this auto-hide button.

Remarks

Override this method in a derived visual manager to customize the appearance of an auto-hide button.

The framework calls this method when it fills the background of a CBasePane Class object.

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

Parameters

[in] pDC
A pointer to the device context for a control bar.

[in] pBar
A pointer to a CBasePane Class object. The framework fills the background of this pane.

[in] rectClient
A rectangle that specifies the boundaries of the pane.

[in] rectClip
A rectangle that specifies the clipping area of the pane.

[in] bNCArea
A reserved value.

Remarks

The default implementation of this method fills the background of the bar with the 3d background color from the global variable afxGlobalData.

Override this method in a derived visual manager to customize the background of a pane.

The framework calls this method when it fills the background of a toolbar button.

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

Parameters

[in] pDC
A pointer to the device context of a toolbar button.

[in] pButton
A pointer to the button for which the framework is filling the background.

[in] rect
A rectangle that specifies the boundaries of the toolbar button.

[in] state
The state of the toolbar button (the possible states of a toolbar button are ButtonsIsRegular, ButtonsIsPressed, or ButtonsIsHighlighted).

Remarks

The default implementation of this method uses the default color to fill the background. Override this method in a derived visual manager to customize the background of a toolbar button.

The framework calls this method when it fills the background of a toolbar button that belongs to a command list. This command list is part of the customization dialog.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rect
A rectangle that specifies the boundaries of the button.

[in] bIsSelected
A Boolean parameter that indicates whether the button is selected.

Return Value

The text color for the toolbar button.

Remarks

For more information about the customization list, see CMFCToolBarButton::OnDrawOnCustomizeList. The default implementation for this method fills the background based on the color scheme of the currently selected skin.

The framework calls this method when it fills the background of a header control.

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

Parameters

[in] pCtrl
A pointer to a CMFCHeaderCtrl Class object. The framework fills the background for this header control.

[in] pDC
A pointer to a device context.

[in] rect
A rectangle that specifies the boundaries of the header control.

Remarks

Override this method in a derived visual manager to customize the appearance of a header control.

The framework calls this method when it fills the highlighted area of a toolbar button.

virtual void OnFillHighlightedArea(
    CDC* pDC,  
    CRect rect,  
    CBrush* pBrush,  
    CMFCToolBarButton* pButton);

Parameters

[in] pDC
Pointer to a device context.

[in] rect
The bounding rectangle of the highlighted area to fill.

[in] pBrush
The brush to use in filling the highlighted area.

[in] pButton
Pointer to the CMFCToolBarButton Class object for which to fill the highlighted area.

Remarks

The framework calls this method when it fills the background of an Outlook caption bar.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rectCaption
A rectangle that specifies the boundaries of the caption bar.

[out] clrText
A reference to a COLORREF object to which this method writes the color of text on the caption bar.

Remarks

The default implementation of this method fills the caption bar with the color for shadows based on the current skin.

Override this method in a derived visual manager to customize the color of the Outlook caption bar.

The framework calls this method when it fills the interior of an Outlook page button.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rect
A rectangle that specifies the boundaries of the Outlook page button.

[in] bIsHighlighted
A Boolean parameter that specifies whether the button is highlighted.

[in] bIsPressed
A Boolean parameter that specifies whether the button is pressed.

[out] clrText
A reference to a COLORREF object where this method stores the text color of the outlook page button.

Remarks

Override this function in a derived visual manager to customize the appearance of Outlook page buttons.

The framework calls this method when it fills the background of a pop-up window.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rect
A rectangle that specifies the boundaries of the popup window.

Remarks

Override this method in a derived visual manager to customize the appearance of pop-up windows.

The framework calls this method when it fills the background of a tab window.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rectFill
A rectangle that specifies the boundaries for the tab window.

[in] pbrFill
A pointer to the brush that the framework is using to fill the tab window.

[in] iTab
The zero-based tab index of a tab for which the framework fills the background.

[in] bIsActive
TRUE if the tab is active or FALSE if not.

[in] pTabWnd
A pointer to the parent tab control.

Remarks

Override this method in a derived visual manager to customize the appearance of tabs.

The framework calls this method when it fills the interior of a CMFCTasksPaneTaskGroup Class object.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rect
A rectangle that specifies the boundaries of the task group.

[in] bSpecial
A Boolean that indicates if the interior is filled with a special color.

Remarks

Override this method in a derived visual manager to customize the appearance of a task group.

The framework calls this method when it fills the background of a CMFCTasksPane Class control.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rectWorkArea
A rectangle that specifies the boundaries of the task pane.

Remarks

Override this method in a derived visual manager to customize the appearance of a CMFCTasksPane Class object.

The framework calls this method when it draws a highlighted quick-customize menu button.

virtual void OnHighlightQuickCustomizeMenuButton(
    CDC* pDC,  
    CMFCToolBarMenuButton* pButton,  
    CRect rect);

Parameters

[in] pDC
A pointer to the device context for the button.

[in] pButton
A pointer to the button.

[in] rect
The bounding rectangle of the button.

Remarks

The framework calls this method when it draws a highlighted menu command.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rectRarelyUsed
A rectangle that specifies the boundaries of the highlighted command.

Remarks

Override this method in a derived visual manager to customize the appearance of highlighted menu commands.

The framework calls this function when the system colors change.

virtual void OnUpdateSystemColors();

Remarks

The framework calls this method as a part of processing the WM_SYSCOLORCHANGE message. Override this method in a derived visual manager if you want to execute custom code when the colors change in your application.

Specifies whether the visual manager should use native Windows XP theme colors or colors obtained from GetSysColor.

static void SetDefaultWinXPColors(BOOL bDefaultWinXPColors = TRUE);

Parameters

[in] bDefaultWinXPColors
Specifies whether the visual manager will use native Windows XP colors.

Remarks

If bDefaultWinXPColors is TRUE, the visual manager will use native Windows XP colors such as blue, olive, or silver. Otherwise, the visual manager will use the colors obtained from GetSysColor. The visual manager uses visual elements such as COLOR_3DFACE, COLOR_3DSHADOW, COLOR_3DHIGHLIGHT, COLOR_3DDKSHADOW, and COLOR_3DLIGHT.

By default, a CMFCVisualManagerOffice2003 object uses native Windows XP theme colors.

Specifies that the Windows XP global theme should be used.

static void __stdcall SetStatusBarOfficeXPLook(BOOL bStatusBarOfficeXPLook = TRUE);

Parameters

[in] bStatusBarOfficeXPLook
TRUE if the Windows XP global theme should be used (the default), or FALSE if not.

Remarks

Specifies whether the visual manager uses a global theme.

static void SetUseGlobalTheme(BOOL bUseGlobalTheme = TRUE);

Parameters

[in] bUseGlobalTheme
TRUE if you want the visual manager to use a global theme; FALSE otherwise.

Remarks

If a CMFCVisualManagerOffice2003 object uses a global theme, it draws the GUI elements by using the CMFCVisualManagerWindows Class.

If a CMFCVisualManagerOffice2003 object does not use a global theme, it draws the GUI elements by using the CMFCVisualManagerOfficeXP Class.

Hierarchy Chart
Classes
CMFCVisualManager Class
CMFCVisualManagerOfficeXP Class
CMFCVisualManagerWindows Class

Show: