CMFCVisualManagerOffice2003 Class

Article
08/03/2021

CMFCVisualManagerOffice2003 gives an application a Microsoft Office 2003 appearance.

Syntax

class CMFCVisualManagerOffice2003 : public CMFCVisualManagerOfficeXP

Members

Public Methods

Name	Description
CMFCVisualManagerOffice2003::DrawComboBorderWinXP	Draws the combo box border using the current Windows XP theme. (Overrides CMFCVisualManager::DrawComboBorderWinXP.)
CMFCVisualManagerOffice2003::DrawComboDropButtonWinXP	Draws a combo box drop-down button using the current Windows XP theme. (Overrides CMFCVisualManager::DrawComboDropButtonWinXP.)
CMFCVisualManagerOffice2003::DrawCustomizeButton	Draws a customize button.
CMFCVisualManagerOffice2003::DrawPushButtonWinXP	Draws a push button using the current Windows XP theme. (Overrides CMFCVisualManager::DrawPushButtonWinXP.)
CMFCVisualManagerOffice2003::GetBaseThemeColor	Gets the base theme color.
CMFCVisualManagerOffice2003::GetHighlightMenuItemColor	Gets the color used for the highlighted menu item.
CMFCVisualManagerOffice2003::GetPropertyGridGroupColor	The framework calls this method to get the background color of a property list. (Overrides `CMFCVisualManagerOfficeXP::GetPropertyGridGroupColor`.)
CMFCVisualManagerOffice2003::GetPropertyGridGroupTextColor	The framework calls this method to retrieve the text color of a property list. (Overrides `CMFCVisualManagerOfficeXP::GetPropertyGridGroupTextColor`.)
CMFCVisualManagerOffice2003::GetShowAllMenuItemsHeight	Returns the height of all menu items. (Overrides CMFCVisualManager::GetShowAllMenuItemsHeight.)
CMFCVisualManagerOffice2003::GetSmartDockingBaseGuideColors	Sets the specified base group background color and border color. (Overrides `CMFCVisualManagerOfficeXP::GetSmartDockingBaseGuideColors`.)
CMFCVisualManagerOffice2003::GetSmartDockingHighlightToneColor	Gets the highlight tone color. (Overrides CMFCVisualManager::GetSmartDockingHighlightToneColor.)
CMFCVisualManagerOffice2003::GetTabFrameColors	The framework calls this function when it has to retrieve the set of colors for drawing a tab window. (Overrides CMFCVisualManager::GetTabFrameColors.)
CMFCVisualManagerOffice2003::GetToolBarCustomizeButtonMargin	Gets the margin of the toolbar Customize button. (Overrides `CMFCVisualManager::GetToolBarCustomizeButtonMargin`.)
CMFCVisualManagerOffice2003::GetToolbarDisabledColor	Gets the disabled color for the toolbar. (Overrides `CMFCVisualManager::GetToolbarDisabledColor`.)
CMFCVisualManagerOffice2003::GetToolTipInfo	Called by the framework to get tooltip information. (Overrides CMFCVisualManager::GetToolTipInfo.)
CMFCVisualManagerOffice2003::IsDefaultWinXPColorsEnabled	Indicates whether the visual manager uses native Windows XP theme colors.
CMFCVisualManagerOffice2003::IsDockingTabHasBorder	Returns whether the current visual manager draws borders around panes that are docked and tabbed. (Overrides CMFCVisualManager::IsDockingTabHasBorder.)
CMFCVisualManagerOffice2003::IsHighlightOneNoteTabs	Indicates whether OneNote tabs should be highlighted. (Overrides `CMFCVisualManager::IsHighlightOneNoteTabs`.)
CMFCVisualManagerOffice2003::IsOffsetPressedButton	Called by the framework when drawing a toolbar button. (Overrides `CMFCVisualManager::IsOffsetPressedButton`.)
CMFCVisualManagerOffice2003::IsStatusBarOfficeXPLook	Indicates whether there is a status bar with an Office XP look.
CMFCVisualManagerOffice2003::IsToolbarRoundShape	Indicates whether a specified toolbar has a round shape. (Overrides CMFCVisualManager::IsToolbarRoundShape.)
CMFCVisualManagerOffice2003::IsUseGlobalTheme	Indicates whether a global Windows XP theme is used.
CMFCVisualManagerOffice2003::IsWindowsThemingSupported	Indicates whether Windows theming is supported. (Overrides CMFCVisualManager::IsWindowsThemingSupported.)
CMFCVisualManagerOffice2003::OnDrawAutoHideButtonBorder	The framework calls this method when it draws the border of an auto-hide button. (Overrides CMFCVisualManager::OnDrawAutoHideButtonBorder.)
CMFCVisualManagerOffice2003::OnDrawBarGripper	Called by the framework when it draws the gripper for a control bar. (Overrides `CMFCVisualManagerOfficeXP::OnDrawBarGripper`.)
CMFCVisualManagerOffice2003::OnDrawBrowseButton	The framework calls this method when it draws the browse button for an edit control. (Overrides `CMFCVisualManagerOfficeXP::OnDrawBrowseButton`.)
CMFCVisualManagerOffice2003::OnDrawButtonBorder	The framework calls this method when it draws the border of a toolbar button. (Overrides `CMFCVisualManagerOfficeXP::OnDrawButtonBorder`.)
CMFCVisualManagerOffice2003::OnDrawCaptionBarBorder	The framework calls this method when it draws the border of a CMFCCaptionBar Class object. (Overrides CMFCVisualManager::OnDrawCaptionBarBorder.)
CMFCVisualManagerOffice2003::OnDrawCheckBoxEx	The framework calls this method when it draws a checkbox. (Overrides CMFCVisualManager::OnDrawCheckBoxEx.)
CMFCVisualManagerOffice2003::OnDrawComboBorder	The framework calls this method when it draws the border around a CMFCToolBarComboBoxButton Class object. (Overrides `CMFCVisualManagerOfficeXP::OnDrawComboBorder`.)
CMFCVisualManagerOffice2003::OnDrawComboDropButton	The framework calls this method when it draws the drop button of a CMFCToolBarComboBoxButton Class. (Overrides `CMFCVisualManagerOfficeXP::OnDrawComboDropButton`.)
CMFCVisualManagerOffice2003::OnDrawControlBorder	The framework calls this method when it draws the border of a control. (Overrides CMFCVisualManager::OnDrawControlBorder.)
CMFCVisualManagerOffice2003::OnDrawExpandingBox	The framework calls this method when it draws an expanding box. (Overrides CMFCVisualManager::OnDrawExpandingBox.)
CMFCVisualManagerOffice2003::OnDrawHeaderCtrlBorder	The framework calls this method when it draws the border around an instance of the CMFCHeaderCtrl Class. (Overrides CMFCVisualManager::OnDrawHeaderCtrlBorder.)
CMFCVisualManagerOffice2003::OnDrawMenuBorder	The framework calls this method when it draws the border of a CMFCPopupMenu Class. (Overrides `CMFCVisualManagerOfficeXP::OnDrawMenuBorder`.)
CMFCVisualManagerOffice2003::OnDrawOutlookBarSplitter	The framework calls this method when it draws the splitter for an Outlook bar. (Overrides CMFCVisualManager::OnDrawOutlookBarSplitter.)
CMFCVisualManagerOffice2003::OnDrawOutlookPageButtonBorder	Called by the framework when it draws the border of an Outlook page button. (Overrides CMFCVisualManager::OnDrawOutlookPageButtonBorder.)
CMFCVisualManagerOffice2003::OnDrawPaneBorder	The framework calls this method when it draws the border of a CPane Class object. (Overrides `CMFCVisualManagerOfficeXP::OnDrawPaneBorder`.)
CMFCVisualManagerOffice2003::OnDrawPaneCaption	The framework calls this method when it draws a caption for a CDockablePane Class object. (Overrides `CMFCVisualManagerOfficeXP::OnDrawPaneCaption`.)
CMFCVisualManagerOffice2003::OnDrawPopupWindowBorder	The framework calls this method when it draws the border of a popup window. (Overrides `CMFCVisualManagerOfficeXP::OnDrawPopupWindowBorder`.)
CMFCVisualManagerOffice2003::OnDrawPopupWindowButtonBorder	The framework calls this method when it draws the border of a button in a popup window. (Overrides `CMFCVisualManagerOfficeXP::OnDrawPopupWindowButtonBorder`.)
CMFCVisualManagerOffice2003::OnDrawPopupWindowCaption	The framework calls this method when it draws the caption of a popup window. (Overrides `CMFCVisualManagerOfficeXP::OnDrawPopupWindowCaption`.)
CMFCVisualManagerOffice2003::OnDrawRibbonButtonsGroup	The framework calls this method when it draws a group of buttons on the ribbon. (Overrides CMFCVisualManager::OnDrawRibbonButtonsGroup.)
CMFCVisualManagerOffice2003::OnDrawRibbonCategoryCaption	The framework calls this method when it draws the caption bar for a ribbon category. (Overrides CMFCVisualManager::OnDrawRibbonCategoryCaption.)
CMFCVisualManagerOffice2003::OnDrawRibbonCategoryTab	The framework calls this method when it draws the tab for a ribbon category. (Overrides CMFCVisualManager::OnDrawRibbonCategoryTab.)
CMFCVisualManagerOffice2003::OnDrawRibbonProgressBar	The framework calls this method when it draws a CMFCRibbonProgressBar Class. (Overrides CMFCVisualManager::OnDrawRibbonProgressBar.)
CMFCVisualManagerOffice2003::OnDrawRibbonQuickAccessToolBarSeparator	The framework calls this method when it draws a separator on the Quick Access Toolbar of a ribbon. (Overrides `CMFCVisualManagerOfficeXP::OnDrawRibbonQuickAccessToolBarSeparator`.)
CMFCVisualManagerOffice2003::OnDrawRibbonSliderChannel	The framework calls this method when it draws the channel of a CMFCRibbonSlider Class. (Overrides CMFCVisualManager::OnDrawRibbonSliderChannel.)
CMFCVisualManagerOffice2003::OnDrawRibbonSliderThumb	The framework calls this method when it draws the thumb of a CMFCRibbonSlider object. (Overrides CMFCVisualManager::OnDrawRibbonSliderThumb.)
CMFCVisualManagerOffice2003::OnDrawRibbonSliderZoomButton	The framework calls this method when it draws the zoom buttons for a CMFCRibbonSlider object. (Overrides CMFCVisualManager::OnDrawRibbonSliderZoomButton.)
CMFCVisualManagerOffice2003::OnDrawRibbonStatusBarPane	The framework calls this method when it draws a pane on the status bar. (Overrides `CMFCVisualManagerOfficeXP::OnDrawRibbonStatusBarPane`.)
CMFCVisualManagerOffice2003::OnDrawScrollButtons	The framework calls this method when it draws scroll buttons. (Overrides `CMFCVisualManagerOfficeXP::OnDrawScrollButtons`.)
CMFCVisualManagerOffice2003::OnDrawSeparator	The framework calls this method when it draws a separator. (Overrides `CMFCVisualManagerOfficeXP::OnDrawSeparator`.)
CMFCVisualManagerOffice2003::OnDrawShowAllMenuItems	The framework calls this method when it draws all the items in a menu. (Overrides CMFCVisualManager::OnDrawShowAllMenuItems.)
CMFCVisualManagerOffice2003::OnDrawStatusBarPaneBorder	The framework calls this method when it draws the border for a CMFCStatusBar Class object. (Overrides `CMFCVisualManagerOfficeXP::OnDrawStatusBarPaneBorder`.)
CMFCVisualManagerOffice2003::OnDrawStatusBarProgress	The framework calls this method when it draws the progress indicator on the CMFCStatusBar object. (Overrides CMFCVisualManager::OnDrawStatusBarProgress.)
CMFCVisualManagerOffice2003::OnDrawStatusBarSizeBox	The framework calls this method when it draws the size box for a CMFCStatusBar. (Overrides CMFCVisualManager::OnDrawStatusBarSizeBox.)
CMFCVisualManagerOffice2003::OnDrawTab	The framework calls this method when it draws the tabs for a CMFCBaseTabCtrl Class object. (Overrides `CMFCVisualManagerOfficeXP::OnDrawTab`.)
CMFCVisualManagerOffice2003::OnDrawTabsButtonBorder	The framework calls this method when it draws the border of a tab button. (Overrides `CMFCVisualManagerOfficeXP::OnDrawTabsButtonBorder`.)
CMFCVisualManagerOffice2003::OnDrawTask	The framework calls this method when it draws a CMFCTasksPaneTask Class object. (Overrides `CMFCVisualManagerOfficeXP::OnDrawTask`.)
CMFCVisualManagerOffice2003::OnDrawTasksGroupAreaBorder	The framework calls this method when it draws a border around a group on a CMFCTasksPane Class object. (Overrides `CMFCVisualManagerOfficeXP::OnDrawTasksGroupAreaBorder`.)
CMFCVisualManagerOffice2003::OnDrawTasksGroupCaption	The framework calls this method when it draws the caption for a CMFCTasksPaneTaskGroup Class object. (Overrides `CMFCVisualManagerOfficeXP::OnDrawTasksGroupCaption`.)
CMFCVisualManagerOffice2003::OnDrawTearOffCaption	The framework calls this method when it draws the caption for a CMFCPopupMenu Class object. (Overrides `CMFCVisualManagerOfficeXP::OnDrawTearOffCaption`.)
CMFCVisualManagerOffice2003::OnErasePopupWindowButton	The framework calls this method when it erases a button in a popup window. (Overrides `CMFCVisualManagerOfficeXP::OnErasePopupWindowButton`.)
CMFCVisualManagerOffice2003::OnEraseTabsArea	The framework calls this method when it erases the tab area of a tab window. (Overrides `CMFCVisualManagerOfficeXP::OnEraseTabsArea`.)
CMFCVisualManagerOffice2003::OnEraseTabsButton	The framework calls this method when it erases the text and icon of a tab button. (Overrides `CMFCVisualManagerOfficeXP::OnEraseTabsButton`.)
CMFCVisualManagerOffice2003::OnEraseTabsFrame	The framework calls this method when it erases a frame on a CMFCBaseTabCtrl Class. (Overrides CMFCVisualManager::OnEraseTabsFrame.)
CMFCVisualManagerOffice2003::OnFillAutoHideButtonBackground	The framework calls this method when it fills the background of an auto-hide button. (Overrides CMFCVisualManager::OnFillAutoHideButtonBackground.)
CMFCVisualManagerOffice2003::OnFillBarBackground	The framework calls this method when it fills the background of a CBasePane Class object. (Overrides `CMFCVisualManagerOfficeXP::OnFillBarBackground`.)
CMFCVisualManagerOffice2003::OnFillButtonInterior	The framework calls this method when it fills the background of a toolbar button. (Overrides `CMFCVisualManagerOfficeXP::OnFillButtonInterior`.)
CMFCVisualManagerOffice2003::OnFillCommandsListBackground	The framework calls this method when it fills the background of a toolbar button that belongs to a command list. (Overrides `CMFCVisualManagerOfficeXP::OnFillCommandsListBackground`.)
CMFCVisualManagerOffice2003::OnFillHeaderCtrlBackground	The framework calls this method when it fills the background of a header control. (Overrides CMFCVisualManager::OnFillHeaderCtrlBackground.)
CMFCVisualManagerOffice2003::OnFillHighlightedArea	The framework calls this method when it fills the highlighted area of a toolbar button. (Overrides `CMFCVisualManagerOfficeXP::OnFillHighlightedArea`.)
CMFCVisualManagerOffice2003::OnFillOutlookBarCaption	The framework calls this method when it fills the background of an Outlook caption bar. (Overrides CMFCVisualManager::OnFillOutlookBarCaption.)
CMFCVisualManagerOffice2003::OnFillOutlookPageButton	The framework calls this method when it fills the interior of an Outlook page button. (Overrides CMFCVisualManager::OnFillOutlookPageButton.)
CMFCVisualManagerOffice2003::OnFillPopupWindowBackground	The framework calls this method when it fills the background of a pop-up window. (Overrides `CMFCVisualManagerOfficeXP::OnFillPopupWindowBackground`.)
CMFCVisualManagerOffice2003::OnFillTab	The framework calls this method when it fills the background of a tab window. (Overrides `CMFCVisualManagerOfficeXP::OnFillTab`.)
CMFCVisualManagerOffice2003::OnFillTasksGroupInterior	The framework calls this method when it fills the interior of a CMFCTasksPaneTaskGroup Class object. (Overrides `CMFCVisualManagerOfficeXP::OnFillTasksGroupInterior`.)
CMFCVisualManagerOffice2003::OnFillTasksPaneBackground	The framework calls this method when it fills the background of a CMFCTasksPane control. (Overrides CMFCVisualManager::OnFillTasksPaneBackground.)
CMFCVisualManagerOffice2003::OnHighlightQuickCustomizeMenuButton	The framework calls this method when it draws a highlighted quick-customize menu button. (Overrides `CMFCVisualManagerOfficeXP::OnHighlightQuickCustomizeMenuButton`.)
CMFCVisualManagerOffice2003::OnHighlightRarelyUsedMenuItems	The framework calls this method when it draws a highlighted menu command. (Overrides `CMFCVisualManagerOfficeXP::OnHighlightRarelyUsedMenuItems`.)
CMFCVisualManagerOffice2003::OnUpdateSystemColors	The framework calls this function when the system colors change. (Overrides `CMFCVisualManagerOfficeXP::OnUpdateSystemColors`.)
CMFCVisualManagerOffice2003::SetDefaultWinXPColors	Specifies whether the visual manager should use native Windows XP theme colors or colors obtained from GetSysColor.
CMFCVisualManagerOffice2003::SetStatusBarOfficeXPLook	Specifies that the Windows XP global theme should be used.
CMFCVisualManagerOffice2003::SetUseGlobalTheme	Specifies whether the visual manager uses a global theme.

Remarks

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

Example

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));

Inheritance Hierarchy

CObject

CMFCBaseVisualManager

CMFCVisualManager

CMFCVisualManagerOfficeXP

CMFCVisualManagerOffice2003

Requirements

Header: afxvisualmanageroffice2003.h

CMFCVisualManagerOffice2003::DrawComboBorderWinXP

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

pDC
[in] A pointer to a device context.

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

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

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

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

Return Value

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

Remarks

CMFCVisualManagerOffice2003::DrawComboDropButtonWinXP

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

pDC
[in] A pointer to a device context.

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

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

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

bIsHighlighted
[in] 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

CMFCVisualManagerOffice2003::DrawCustomizeButton

Draws a customize button.

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

Parameters

pDC
[in] Pointer to a display context.

rect
[in] The bounding rectangle of the button

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

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

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

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

Remarks

CMFCVisualManagerOffice2003::DrawPushButtonWinXP

Draws a push button using the current Windows XP theme.

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

Parameters

pDC
[in] A pointer to a device context.

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

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

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

Return Value

TRUE if the Theme API is enabled; otherwise FALSE.

Remarks

CMFCVisualManagerOffice2003::GetBaseThemeColor

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

CMFCVisualManagerOffice2003::GetHighlightMenuItemColor

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

CMFCVisualManagerOffice2003::GetPropertyGridGroupColor

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

virtual COLORREF GetPropertyGridGroupColor(CMFCPropertyGridCtrl* pPropList);

Parameters

pPropList
[in] 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.

CMFCVisualManagerOffice2003::GetPropertyGridGroupTextColor

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

virtual COLORREF GetPropertyGridGroupTextColor(CMFCPropertyGridCtrl* pPropList);

Parameters

pPropList
[in] 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.

CMFCVisualManagerOffice2003::GetShowAllMenuItemsHeight

Returns the height of all menu items.

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

Parameters

pDC
[in] A pointer to the device context.

sizeDefault
[in] Default menu size.

Return Value

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

Remarks

CMFCVisualManagerOffice2003::GetSmartDockingBaseGuideColors

Sets the specified base group background color and border color.

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

Parameters

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

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

Remarks

CMFCVisualManagerOffice2003::GetSmartDockingHighlightToneColor

Returns the highlight tone color.

virtual COLORREF GetSmartDockingHighlightToneColor();

Return Value

Returns a COLORREF that contains the highlight tone color.

Remarks

CMFCVisualManagerOffice2003::GetTabFrameColors

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

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

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

clrBlack
[out] 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.

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

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

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

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

pbrFace
[out] 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.

pbrBlack
[out] 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

CMFCVisualManagerOffice2003::GetToolBarCustomizeButtonMargin

Gets the margin for the toolbar Customize button.

virtual int GetToolBarCustomizeButtonMargin() const;

Return Value

Returns the margin for the toolbar Customize button.

Remarks

CMFCVisualManagerOffice2003::GetToolbarDisabledColor

Gets the disabled color for the toolbar.

virtual COLORREF GetToolbarDisabledColor() const;

Return Value

Returns a COLORREF that contains the disabled color.

Remarks

CMFCVisualManagerOffice2003::GetToolTipInfo

Called by the framework to get tooltip information.

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

Parameters

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

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

Return Value

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

Remarks

CMFCVisualManagerOffice2003::IsDefaultWinXPColorsEnabled

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.

CMFCVisualManagerOffice2003::IsDockingTabHasBorder

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

CMFCVisualManagerOffice2003::IsHighlightOneNoteTabs

Indicates whether OneNote tabs should be highlighted.

virtual BOOL IsHighlightOneNoteTabs() const;

Return Value

Returns TRUE.

Remarks

CMFCVisualManagerOffice2003::IsOffsetPressedButton

Called by the framework while drawing a toolbar button.

virtual BOOL IsOffsetPressedButton() const;

Return Value

Remarks

The default implementation returns FALSE.

CMFCVisualManagerOffice2003::IsStatusBarOfficeXPLook

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.

CMFCVisualManagerOffice2003::IsToolbarRoundShape

Indicates whether a specified toolbar is round.

virtual BOOL IsToolbarRoundShape(CMFCToolBar* pToolBar);

Parameters

pToolBar
[in] Pointer to the toolbar in question.

Return Value

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

Remarks

CMFCVisualManagerOffice2003::IsUseGlobalTheme

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.

CMFCVisualManagerOffice2003::IsWindowsThemingSupported

Indicates whether Windows theming is supported.

virtual BOOL IsWindowsThemingSupported() const;

Return Value

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

Remarks

CMFCVisualManagerOffice2003::OnDrawAutoHideButtonBorder

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

pDC
[in] A pointer to a device context.

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

rectBorderSize
[in] The sizes of the borders.

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

CMFCVisualManagerOffice2003::OnDrawBarGripper

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

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

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

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

pBar
[in] 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.

CMFCVisualManagerOffice2003::OnDrawBrowseButton

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

CMFCVisualManagerOffice2003::OnDrawButtonBorder

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

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

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

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

state
[in] 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.

CMFCVisualManagerOffice2003::OnDrawCaptionBarBorder

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

pDC
[in] A pointer to a device context.

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

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

clrBarBorder
[in] The color of the border.

bFlatBorder
[in] 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.

CMFCVisualManagerOffice2003::OnDrawCheckBoxEx

Called by the framework when drawing a checkbox.

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

Parameters

pDC
[in] Pointer to a device context.

rect
[in] The bounding rectangle of the checkbox.

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

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

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

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

Remarks

CMFCVisualManagerOffice2003::OnDrawComboBorder

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

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

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

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

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

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

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

CMFCVisualManagerOffice2003::OnDrawComboDropButton

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

pDC
[in] A pointer to a device context.

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

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

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

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

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

CMFCVisualManagerOffice2003::OnDrawControlBorder

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

virtual void OnDrawControlBorder(CWnd* pWndCtrl);

Parameters

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

Remarks

CMFCVisualManagerOffice2003::OnDrawExpandingBox

Called by the framework while drawing an expanding box.

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

Parameters

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

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

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

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

Remarks

CMFCVisualManagerOffice2003::OnDrawHeaderCtrlBorder

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

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

pDC
[in] A pointer to a device context.

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

CMFCVisualManagerOffice2003::OnDrawMenuBorder

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

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

Parameters

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

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

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

CMFCVisualManagerOffice2003::OnDrawOutlookBarSplitter

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

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

Parameters

pDC
[in] A pointer to a device context.

rectSplitter
[in] 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.

CMFCVisualManagerOffice2003::OnDrawOutlookPageButtonBorder

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

pDC
[in] A pointer to a device context.

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

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

bIsPressed
[in] 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.

CMFCVisualManagerOffice2003::OnDrawPaneBorder

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

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

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

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

CMFCVisualManagerOffice2003::OnDrawPaneCaption

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

pDC
[in] A pointer to a device context.

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

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

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

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

Return Value

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

Remarks

CMFCVisualManagerOffice2003::OnDrawPopupWindowBorder

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

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

Parameters

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

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

Remarks

CMFCVisualManagerOffice2003::OnDrawPopupWindowButtonBorder

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

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

rectClient
[in] Bounding rectangle of the button.

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

Remarks

CMFCVisualManagerOffice2003::OnDrawPopupWindowCaption

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

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

Parameters

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

rectCaption
[in] Bounding rectangle of the caption.

pPopupWnd
[in] 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.

CMFCVisualManagerOffice2003::OnDrawRibbonButtonsGroup

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

pDC
[in] A pointer to a device context.

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

rectGroup
[in] 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.

CMFCVisualManagerOffice2003::OnDrawRibbonCategoryCaption

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

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

Parameters

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

pContextCaption
[in] 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.

CMFCVisualManagerOffice2003::OnDrawRibbonCategoryTab

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

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

Parameters

pDC
[in] A pointer to a device context.

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

bIsActive
[in] 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.

CMFCVisualManagerOffice2003::OnDrawRibbonProgressBar

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

pDC
[in] A pointer to a device context.

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

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

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

bInfiniteMode
[in] 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

CMFCVisualManagerOffice2003::OnDrawRibbonQuickAccessToolBarSeparator

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

pDC
[in] A pointer to a device context.

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

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

CMFCVisualManagerOffice2003::OnDrawRibbonSliderChannel

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

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

Parameters

pDC
[in] Pointer to a device context.

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

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

CMFCVisualManagerOffice2003::OnDrawRibbonSliderThumb

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

pDC
[in] A pointer to a device context.

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

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

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

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

bIsDisabled
[in] 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.

CMFCVisualManagerOffice2003::OnDrawRibbonSliderZoomButton

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

pDC
[in] A pointer to a device context.

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

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

bIsZoomOut
[in] 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.

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

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

bIsDisabled
[in] 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.

CMFCVisualManagerOffice2003::OnDrawRibbonStatusBarPane

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

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

Parameters

pDC
[in] A pointer to a device context.

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

pPane
[in] 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.

CMFCVisualManagerOffice2003::OnDrawScrollButtons

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

pDC
[in] Pointer to a device context.

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

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

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

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

Remarks

CMFCVisualManagerOffice2003::OnDrawSeparator

The framework calls this method when it draws a separator.

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

Parameters

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

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

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

bIsHoriz
[in] 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.

CMFCVisualManagerOffice2003::OnDrawShowAllMenuItems

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

pDC
[in] Pointer to a device context.

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

state
[in] The button state.

Remarks

CMFCVisualManagerOffice2003::OnDrawStatusBarPaneBorder

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

pDC
[in] A pointer to a device context.

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

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

uiID
[in] The ID of the status bar.

nStyle
[in] 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.

CMFCVisualManagerOffice2003::OnDrawStatusBarProgress

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

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

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

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

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

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

clrBar
[in] 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.

CMFCVisualManagerOffice2003::OnDrawStatusBarSizeBox

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

pDC
[in] A pointer to a device context.

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

rectSizeBox
[in] 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.

CMFCVisualManagerOffice2003::OnDrawTab

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

pDC
[in] A pointer to a device context.

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

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

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

pTabWnd
[in] 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.

CMFCVisualManagerOffice2003::OnDrawTabsButtonBorder

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

pDC
[in] A pointer to a device context.

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

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

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

pWndTab
[in] 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.

CMFCVisualManagerOffice2003::OnDrawTask

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

pDC
[in] A pointer to a device context.

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

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

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

bIsSelected
[in] 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.

CMFCVisualManagerOffice2003::OnDrawTasksGroupAreaBorder

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

pDC
[in] A pointer to a device context.

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

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

bNoTitle
[in] 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.

CMFCVisualManagerOffice2003::OnDrawTasksGroupCaption

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

pDC
[in] A pointer to a device context.

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

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

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

bCanCollapse
[in] 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.

CMFCVisualManagerOffice2003::OnDrawTearOffCaption

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

pDC
[in] A pointer to a device context.

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

bIsActive
[in] 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.

CMFCVisualManagerOffice2003::OnErasePopupWindowButton

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

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

Parameters

pDC
[in] A pointer to a device context.

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

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

Remarks

CMFCVisualManagerOffice2003::OnEraseTabsArea

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

pDC
[in] A pointer to a device context.

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

pTabWnd
[in] 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.

CMFCVisualManagerOffice2003::OnEraseTabsButton

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

pDC
[in] A pointer to a device context.

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

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

pWndTab
[in] 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.

CMFCVisualManagerOffice2003::OnEraseTabsFrame

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

pDC
[in] A pointer to a device context.

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

pTabWnd
[in] 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.

CMFCVisualManagerOffice2003::OnFillAutoHideButtonBackground

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

pDC
[in] A pointer to a device context.

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

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

CMFCVisualManagerOffice2003::OnFillBarBackground

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

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

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

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

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

bNCArea
[in] 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.

CMFCVisualManagerOffice2003::OnFillButtonInterior

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

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

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

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

state
[in] 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.

CMFCVisualManagerOffice2003::OnFillCommandsListBackground

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

pDC
[in] A pointer to a device context.

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

bIsSelected
[in] 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.

CMFCVisualManagerOffice2003::OnFillHeaderCtrlBackground

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

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

Parameters

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

pDC
[in] A pointer to a device context.

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

CMFCVisualManagerOffice2003::OnFillHighlightedArea

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

pDC
[in] Pointer to a device context.

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

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

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

Remarks

CMFCVisualManagerOffice2003::OnFillOutlookBarCaption

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

pDC
[in] A pointer to a device context.

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

clrText
[out] 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.

CMFCVisualManagerOffice2003::OnFillOutlookPageButton

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

pDC
[in] A pointer to a device context.

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

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

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

clrText
[out] 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.

CMFCVisualManagerOffice2003::OnFillPopupWindowBackground

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

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

Parameters

pDC
[in] A pointer to a device context.

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

CMFCVisualManagerOffice2003::OnFillTab

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

pDC
[in] A pointer to a device context.

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

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

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

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

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

Remarks

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

CMFCVisualManagerOffice2003::OnFillTasksGroupInterior

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

pDC
[in] A pointer to a device context.

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

bSpecial
[in] 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.

CMFCVisualManagerOffice2003::OnFillTasksPaneBackground

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

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

Parameters

pDC
[in] A pointer to a device context.

rectWorkArea
[in] 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.

CMFCVisualManagerOffice2003::OnHighlightQuickCustomizeMenuButton

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

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

Parameters

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

pButton
[in] A pointer to the button.

rect
[in] The bounding rectangle of the button.

Remarks

CMFCVisualManagerOffice2003::OnHighlightRarelyUsedMenuItems

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

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

Parameters

pDC
[in] A pointer to a device context.

rectRarelyUsed
[in] 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.

CMFCVisualManagerOffice2003::OnUpdateSystemColors

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.

CMFCVisualManagerOffice2003::SetDefaultWinXPColors

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

static void SetDefaultWinXPColors(BOOL bDefaultWinXPColors = TRUE);

Parameters

bDefaultWinXPColors
[in] 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.

CMFCVisualManagerOffice2003::SetStatusBarOfficeXPLook

Specifies that the Windows XP global theme should be used.

static void __stdcall SetStatusBarOfficeXPLook(BOOL bStatusBarOfficeXPLook = TRUE);

Parameters

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

Remarks

CMFCVisualManagerOffice2003::SetUseGlobalTheme

Specifies whether the visual manager uses a global theme.

static void SetUseGlobalTheme(BOOL bUseGlobalTheme = TRUE);

Parameters

bUseGlobalTheme
[in] 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.

Share via

CMFCVisualManagerOffice2003 Class

Syntax

Members

Public Methods

Remarks

Example

Inheritance Hierarchy

Requirements

CMFCVisualManagerOffice2003::DrawComboBorderWinXP

Parameters

Return Value

Remarks

CMFCVisualManagerOffice2003::DrawComboDropButtonWinXP

Parameters

Return Value

Remarks

CMFCVisualManagerOffice2003::DrawCustomizeButton

Parameters

Remarks

CMFCVisualManagerOffice2003::DrawPushButtonWinXP

Parameters

Return Value

Remarks

CMFCVisualManagerOffice2003::GetBaseThemeColor

Return Value

Remarks

CMFCVisualManagerOffice2003::GetHighlightMenuItemColor

Return Value

Remarks

CMFCVisualManagerOffice2003::GetPropertyGridGroupColor

Parameters

Return Value

Remarks

CMFCVisualManagerOffice2003::GetPropertyGridGroupTextColor

Parameters

Return Value

Remarks

CMFCVisualManagerOffice2003::GetShowAllMenuItemsHeight

Parameters

Return Value

Remarks

CMFCVisualManagerOffice2003::GetSmartDockingBaseGuideColors

Parameters

Remarks

CMFCVisualManagerOffice2003::GetSmartDockingHighlightToneColor

Return Value

Remarks

CMFCVisualManagerOffice2003::GetTabFrameColors

Parameters

Remarks

CMFCVisualManagerOffice2003::GetToolBarCustomizeButtonMargin

Return Value

Remarks

CMFCVisualManagerOffice2003::GetToolbarDisabledColor

Return Value

Remarks

CMFCVisualManagerOffice2003::GetToolTipInfo

Parameters

Return Value

Remarks

CMFCVisualManagerOffice2003::IsDefaultWinXPColorsEnabled

Return Value

Remarks

CMFCVisualManagerOffice2003::IsDockingTabHasBorder

Return Value

Remarks

CMFCVisualManagerOffice2003::IsHighlightOneNoteTabs

Return Value

Remarks

CMFCVisualManagerOffice2003::IsOffsetPressedButton

Return Value

Remarks

CMFCVisualManagerOffice2003::IsStatusBarOfficeXPLook

Return Value

Remarks

CMFCVisualManagerOffice2003::IsToolbarRoundShape

Parameters

Return Value

Remarks