description | title | ms.date | f1_keywords | helpviewer_keywords | ms.assetid | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Learn more about: CMFCVisualManagerOffice2003 Class |
CMFCVisualManagerOffice2003 Class |
11/04/2016 |
|
|
115482cd-e349-450a-8dc4-c6023d092aab |
CMFCVisualManagerOffice2003
gives an application a Microsoft Office 2003 appearance.
class CMFCVisualManagerOffice2003 : public CMFCVisualManagerOfficeXP
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. |
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.
[!code-cppNVC_MFC_DesktopAlertDemo#6]
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);
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.
Returns TRUE if the theme API is enabled or FALSE if not.
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);
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.
Returns TRUE if the theme API is enabled or FALSE if not.
Draws a customize button.
virtual void DrawCustomizeButton(
CDC* pDC,
CRect rect,
BOOL bIsHorz,
CMFCVisualManager::AFX_BUTTON_STATE state,
BOOL bIsCustomize,
BOOL bIsMoreButtons);
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.
Draws a push button using the current Windows XP theme.
virtual BOOL DrawPushButtonWinXP(
CDC* pDC,
CRect rect,
CMFCButton* pButton,
UINT uiState);
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.
TRUE if the Theme API is enabled; otherwise FALSE.
Gets the base theme color.
virtual COLORREF GetBaseThemeColor();
Returns the theme color of the base theme, if one is set, or the color-bar face color.
Gets the color used for the highlighted menu item.
virtual COLORREF GetHighlightMenuItemColor() const;
Returns the color used for the highlighted menu item.
The framework calls this method to get the background color of a property list.
virtual COLORREF GetPropertyGridGroupColor(CMFCPropertyGridCtrl* pPropList);
pPropList
[in] A pointer to the property list that the framework is drawing.
Returns the background color of pPropList.
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);
pPropList
[in] A pointer to the property list.
Returns the text color of the specified property list.
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);
pDC
[in] A pointer to the device context.
sizeDefault
[in] Default menu size.
By default, returns the height of all menu images plus margins.
Sets the specified base group background color and border color.
virtual void GetSmartDockingBaseGuideColors(
COLORREF& clrBaseGroupBackground,
COLORREF& clrBaseGroupBorder);
clrBaseGroupBackground
[in] Reference to a COLORREF to set to the background color.
clrBaseGroupBorder
[in] Reference to a COLORREF to set to the border color.
Returns the highlight tone color.
virtual COLORREF GetSmartDockingHighlightToneColor();
Returns a COLORREF that contains the highlight tone color.
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);
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.
Gets the margin for the toolbar Customize button.
virtual int GetToolBarCustomizeButtonMargin() const;
Returns the margin for the toolbar Customize button.
Gets the disabled color for the toolbar.
virtual COLORREF GetToolbarDisabledColor() const;
Returns a COLORREF that contains the disabled color.
Called by the framework to get tooltip information.
virtual BOOL GetToolTipInfo(
CMFCToolTipInfo& params,
UINT nType = (UINT)(-1));
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.
Returns TRUE if tooltip information is returned, and FALSE otherwise.
Indicates whether the visual manager uses theme colors that are native to Windows XP.
static BOOL IsDefaultWinXPColorsEnabled();
TRUE if the visual manager uses native colors; otherwise, FALSE.
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();
TRUE if the visual manager draws borders around panes that are docked and tabbed; FALSE otherwise.
Indicates whether OneNote tabs should be highlighted.
virtual BOOL IsHighlightOneNoteTabs() const;
Returns TRUE.
Called by the framework while drawing a toolbar button.
virtual BOOL IsOffsetPressedButton() const;
The default implementation returns FALSE.
Indicates whether there is a status bar with an Office XP look.
static BOOL __stdcall IsStatusBarOfficeXPLook();
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);
pToolBar
[in] Pointer to the toolbar in question.
Returns TRUE if the toolbar is round, or FALSE if it is a menu bar.
Indicates whether your application uses a Windows XP theme.
static BOOL IsUseGlobalTheme();
TRUE if the visual manager uses a Windows XP theme; otherwise, FALSE.
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;
Returns TRUE if Windows theming is supported, or FALSE if not.
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);
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.
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);
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.
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.
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);
[in] pDC
[in] rect
[in] pEdit
[in] state
[in] clrText
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);
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.
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);
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.
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);
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.
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);
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.
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);
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
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);
pWndCtrl
[in] Pointer to a CWnd Class object representing the control for which to draw the border.
Called by the framework while drawing an expanding box.
virtual void OnDrawExpandingBox(
CDC* pDC,
CRect rect,
BOOL bIsOpened,
COLORREF colorBox);
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.
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);
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.
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);
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.
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);
pDC
[in] A pointer to a device context.
rectSplitter
[in] A rectangle that specifies the boundaries of the splitter.
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);
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.
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);
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.
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);
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.
A COLORREF parameter that indicates the text color of the caption.
The framework calls this method when it draws the border of a popup window.
virtual void OnDrawPopupWindowBorder(
CDC* pDC,
CRect rect);
pDC
[in] Pointer to the device context of the popup window.
rect
[in] The bounding rectangle of the popup window.
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);
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).
The framework calls this method when it draws the caption of a popup window.
virtual COLORREF OnDrawPopupWindowCaption(
CDC* pDC,
CRect rectCaption,
CMFCDesktopAlertWnd* pPopupWnd);
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.
The text color of the caption.
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);
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.
A reserved value. The default implementation returns -1.
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);
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.
A COLORREF parameter that indicates the color of the text on the caption bar.
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);
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.
The color that is used for text on the ribbon category tab.
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);
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.
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);
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.
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);
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.
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);
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.
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);
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.
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);
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.
A reserved value. The default implementation returns -1.
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);
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.
The framework calls this method when it draws a separator.
virtual void OnDrawSeparator(
CDC* pDC,
CBasePane* pBar,
CRect rect,
BOOL bIsHoriz);
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.
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);
pDC
[in] Pointer to a device context.
rect
[in] The bounding rectangle of the menu to be drawn.
state
[in] The button state.
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);
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.
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);
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
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);
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.
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);
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.
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);
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.
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);
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.
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);
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.
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);
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.
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);
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.
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);
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.
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);
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.
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);
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.
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);
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.
TRUE if the method is successful or FALSE if not.
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);
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.
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);
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.
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);
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
).
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);
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.
The text color for the toolbar button.
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);
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.
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);
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.
The framework calls this method when it fills the background of an Outlook caption bar.
virtual void OnFillOutlookBarCaption(
CDC* pDC,
CRect rectCaption,
COLORREF& clrText);
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.
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);
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.
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);
pDC
[in] A pointer to a device context.
rect
[in] A rectangle that specifies the boundaries of the popup window.
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);
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.
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);
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.
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);
pDC
[in] A pointer to a device context.
rectWorkArea
[in] A rectangle that specifies the boundaries of the task pane.
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);
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.
The framework calls this method when it draws a highlighted menu command.
virtual void OnHighlightRarelyUsedMenuItems(
CDC* pDC,
CRect rectRarelyUsed);
pDC
[in] A pointer to a device context.
rectRarelyUsed
[in] A rectangle that specifies the boundaries of the highlighted command.
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();
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);
bDefaultWinXPColors
[in] Specifies whether the visual manager will use native Windows XP colors.
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);
bStatusBarOfficeXPLook
[in] TRUE if the Windows XP global theme should be used (the default), or FALSE if not.
Specifies whether the visual manager uses a global theme.
static void SetUseGlobalTheme(BOOL bUseGlobalTheme = TRUE);
bUseGlobalTheme
[in] TRUE if you want the visual manager to use a global theme; FALSE otherwise.
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