// XTPShortcutBarPaintManager.h interface for the CXTPShortcutBarPaintManager class.
//
// This file is a part of the XTREME SHORTCUTBAR MFC class library.
// (c)1998-2012 Codejock Software, All Rights Reserved.
//
// THIS SOURCE FILE IS THE PROPERTY OF CODEJOCK SOFTWARE AND IS NOT TO BE
// RE-DISTRIBUTED BY ANY MEANS WHATSOEVER WITHOUT THE EXPRESSED WRITTEN
// CONSENT OF CODEJOCK SOFTWARE.
//
// THIS SOURCE CODE CAN ONLY BE USED UNDER THE TERMS AND CONDITIONS OUTLINED
// IN THE XTREME TOOLKIT PRO LICENSE AGREEMENT. CODEJOCK SOFTWARE GRANTS TO
// YOU (ONE SOFTWARE DEVELOPER) THE LIMITED RIGHT TO USE THIS SOFTWARE ON A
// SINGLE COMPUTER.
//
// CONTACT INFORMATION:
// support@codejock.com
// http://www.codejock.com
//
/////////////////////////////////////////////////////////////////////////////
//{{AFX_CODEJOCK_PRIVATE
#if !defined(__XTPSHORTCUTBARPAINTMANAGER_H__)
#define __XTPSHORTCUTBARPAINTMANAGER_H__
//}}AFX_CODEJOCK_PRIVATE
#if _MSC_VER > 1000
#pragma once
#endif // _MSC_VER > 1000
class CXTPWinThemeWrapper;
//-----------------------------------------------------------------------
// Summary:
// XTPShortcutBarPaintTheme is an enumeration used by CXTPShortcutBar to set the theme of the control.
// Example:
// <code>
// m_wndShortcutBar.SetTheme(xtpShortcutThemeOffice2003);
// </code>
// See Also:
// CXTPShortcutBar::GetCurrentTheme, CXTPShortcutBar::SetTheme, CXTPShortcutBar::SetCustomTheme
//
// <KEYWORDS xtpShortcutThemeOffice2000, xtpShortcutThemeOfficeXP, xtpShortcutThemeOffice2003>
//-----------------------------------------------------------------------
enum XTPShortcutBarPaintTheme
{
xtpShortcutThemeOffice2000, // Office 2000 style theme.
xtpShortcutThemeOfficeXP, // Office XP style theme.
xtpShortcutThemeOffice2003, // Office 2003 style theme.
xtpShortcutThemeResource, // Office 2007/2010 style theme.
xtpShortcutThemeNativeWinXP
};
#define xtpShortcutThemeOffice2007 xtpShortcutThemeResource
class CXTPShortcutBar;
class CXTPShortcutBarItem;
class CXTPShortcutBarPane;
class CXTPShortcutBarPaneItem;
class CXTPImageManagerIcon;
//===========================================================================
// Summary:
// Standalone class used by CXTPShortcutBar as paint manager.
//===========================================================================
class _XTP_EXT_CLASS CXTPShortcutBarPaintManager : public CXTPCmdTarget
{
public:
//-----------------------------------------------------------------------
// Summary:
// Constructs a CXTPShortcutBarPaintManager object
//-----------------------------------------------------------------------
CXTPShortcutBarPaintManager();
//-----------------------------------------------------------------------
// Summary:
// Destroys a CXTPShortcutBarPaintManager object, handles cleanup and deallocation
//-----------------------------------------------------------------------
virtual ~CXTPShortcutBarPaintManager();
public:
//-----------------------------------------------------------------------
// Summary:
// This method is called to refresh the visual metrics of the shortcut
// bar paint manager.
// Remarks:
// This refreshes all the visual metrics of the shortcut bar such
// as the pane caption color, pane font, pane caption height, etc.
//-----------------------------------------------------------------------
virtual void RefreshMetrics();
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the specified item of the ShortcutBar item.
// Parameters:
// pDC - Points to the client device context.
// pItem - Item to be drawn.
//-----------------------------------------------------------------------
virtual void DrawShortcutItem(CDC* pDC, CXTPShortcutBarItem* pItem);
//-----------------------------------------------------------------------
// Summary:
// This method is called to fill the client area of the ShortcutBar control
// Parameters:
// pDC - Points to the client device context.
// pShortcutBar - Points to the ShortcutBar control
//-----------------------------------------------------------------------
virtual void FillShortcutBar(CDC* pDC, CXTPShortcutBar* pShortcutBar) = 0;
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the frame of the ShortcutBar control.
// Parameters:
// pDC - Points to the client device context.
// pShortcutBar - Points to the ShortcutBar control.
// Remarks:
// This is the border that is drawn around the entire shortcut bar.
//-----------------------------------------------------------------------
virtual void DrawShortcutBarFrame(CDC* pDC, CXTPShortcutBar* pShortcutBar) = 0;
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the specified item of the ShortcutBar control
// Parameters:
// pDC - Points to the client device context.
// pItem - Item to be drawn.
//-----------------------------------------------------------------------
virtual void FillShortcutItemEntry(CDC* pDC, CXTPShortcutBarItem* pItem) = 0;
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw gripper of the ShortcutBar control
// Parameters:
// pDC - Points to the client device context.
// pShortcutBar - Points to the ShortcutBar control
// bDraw - TRUE to draw, FALSE to determine size of the gripper.
// Returns:
// Size of the gripper.
//-----------------------------------------------------------------------
virtual int DrawGripper(CDC* pDC, CXTPShortcutBar* pShortcutBar, BOOL bDraw) = 0;
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the caption of the specified pane.
// Parameters:
// pDC - Points to the client device context.
// pPane - Shortcut Pane to be drawn
// bDraw - TRUE to draw pane, FALSE to determine size of the caption
// Remarks:
// Panes of the shortcut bar are displayed in the shortcut bar's client
// area. Each pane consists of a caption and one or more sub-panes.
// Each sub-pane has it's own caption and is drawn with the
// DrawPaneItemCaption method.
//
// The caption of the shortcut bar pane is the bar on the top the pane.
// The caption of the pane is set when the pane is created in the
// CXTPShortcutBarPane::Create method.
//
// The pane caption can be retrieved with CXTPShortcutBarPane::GetCaption
//
// Shortcut bar pane's have sub-item's which also have a caption that is
// drawn with the DrawPaneItemCaption method.
// Returns:
// Size of the caption. Unless overridden, the default caption is 24 pixes.
//-----------------------------------------------------------------------
virtual int DrawPaneCaption(CDC* pDC, CXTPShortcutBarPane* pPane, BOOL bDraw);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the caption of the specified shortcut
// pane item. This is the sub-pane of a shortcut bar pane.
// Parameters:
// pDC - Points to the client device context.
// pItem - Shortcut item pane to be drawn
// bDraw - bDraw - TRUE to draw, FALSE to determine size of the shortcut
// pane caption.
// Remarks:
// Panes of the shortcut bar are displayed in the shortcut bar's client
// area. Each pane consists of a caption and one or more sub-panes.
// Each sub-pane has it's own caption and is drawn with the
// DrawPaneItemCaption method.
//
// The caption of the pane item is set when the pane item is created in the
// CXTPShortcutBarPane::AddItem method.
//
// The sub-items of a pane can be retrieved with the CXTPShortcutBarPane::GetItem
// method.
// Returns:
// Size of the pane item caption. This is retrieved from m_nPaneItemHeight.
//-----------------------------------------------------------------------
virtual int DrawPaneItemCaption(CDC* pDC, CXTPShortcutBarPaneItem* pItem, BOOL bDraw);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw navigation item of minimized ShortcutBar
// Parameters:
// pDC - Points to the client device context.
// pItem - Shortcut item to be drawn
//-----------------------------------------------------------------------
virtual void DrawNavigationItem(CDC* pDC, CXTPShortcutBarItem* pItem);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw navigation item of minimized ShortcutBar
// Parameters:
// pDC - Points to the client device context.
// pItem - Shortcut item to be drawn
//-----------------------------------------------------------------------
virtual void FillNavigationItemEntry(CDC* pDC, CXTPShortcutBarItem* pItem);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the expand button.
// Parameters:
// pDC - Points to the client device context.
// rc - Client rectangle of the expand button.
//-----------------------------------------------------------------------
virtual void DrawExpandButton(CDC* pDC, CRect rc);
virtual void DrawPaneCaptionMinimizeButton(CDC* pDC, CXTPShortcutBarPane* pPane);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the image of a Shortcut Bar item.
// Parameters:
// pDC - Points to the client device context.
// pt - Location at which to draw the image within the specified
// device context.
// sz - Size of the image.
// pImage - Points to a CXTPImageManagerIcon object.
// bSelected - TRUE if the shortcut bar item is selected\has focus.
// I.e. When the user clicks on the item.
// bPressed - TRUE if the shortcut bar item is currently pressed.
// I.e. The user is clicking on the item.
// bChecked - TRUE if the shortcut bar item is checked. I.e.
// toggle buttons.
// bEnabled - TRUE to draw item enabled
// Remarks:
// This member draws the image of a shortcut bar item. The
// DrawShortcutItem method uses this method to draw shortcut bar
// images.
//-----------------------------------------------------------------------
virtual void DrawImage(CDC* pDC, CPoint pt, CSize sz, CXTPImageManagerIcon* pImage, BOOL bSelected, BOOL bPressed, BOOL bChecked, BOOL bEnabled) = 0;
public:
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw a rectangle. The rectangle is
// used to draw the shortcut items in the Office XP theme.
// Parameters:
// pDC - Pointer to a valid device context
// rc - Specifies the rectangle in logical units.
// nPen - Specifies the color used to paint the rectangle.
// nBrush - Specifies the color used to fill the rectangle.
//-----------------------------------------------------------------------
void Rectangle(CDC* pDC, CRect rc, int nPen, int nBrush);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the "gripper" lines in the gripper.
// Parameters:
// pDC - Points to the client device context.
// x0 - Specifies the logical x-coordinate of the start position.
// y0 - Specifies the logical y-coordinate of the start position.
// x1 - Specifies the logical x-coordinate of the endpoint for the line.
// y1 - Specifies the logical y-coordinate of the endpoint for the line.
// nPen - Specifies the color used to paint the line.
//-----------------------------------------------------------------------
void Line(CDC* pDC, int x0, int y0, int x1, int y1, int nPen);
//-----------------------------------------------------------------------
// Summary:
// This method is used to check whether the expanded shortcut item text
// item has been truncated because the shortcut item is not wide enough
// to display the entire string.
// Parameters:
// pDC - Points to the client device context.
// pItem - Pointer to CXTPShortcutBarItem to check to see if the caption
// text has been truncated.
// Remarks:
// Checks whether the caption text of an expanded
// item has been truncated because the caption width is too wide to
// display.
// Returns:
// Returns False if pItem it is not expanded or if the caption of an
// expanded item is not truncated and fully displayed.
// returns True if the item is not expanded or the caption text has
// been truncated.
//-----------------------------------------------------------------------
BOOL IsShortcutItemTruncated(CDC* pDC, CXTPShortcutBarItem* pItem);
public:
CFont m_fntText; // Text font.
CFont m_fntPaneCaption; // Caption font.
CFont m_fntPaneItemCaption; // Sub-caption font.
CFont m_fntVerticalText; // Nvaigation button Text font.
int m_nPaneItemHeight; // Height of sub-pane caption.
CXTPImageManagerIcon* m_pExpandIcon; // Pointer to expand icon
int m_nNormalIconWidth; // Width of the icons.
int m_nExpandedIconWidth; // Width of the expanded icons.
BOOL m_bBoldItemCaptionFont; // TRUE to draw item with bold font
BOOL m_bClearTypeTextQuality; // TRUE to use ClearType font
BOOL m_bUseStandardFont; // TRUE to use standard font
CRect m_rcCaptionPadding; // Padding of pane caption
CRect m_rcItemCaptionPadding; // Padding of item caption
CString m_strOfficeFont; // TRUE to use Office Tahoma font
BOOL m_bShowBorder;
BOOL m_bDrawTextNoPrefix;
public:
CXTPPaintManagerColor m_clrPushedText; // Color of Caption text when an CXTPShortcutBarItem is pressed.
CXTPPaintManagerColor m_clrSelectedText; // Color of Caption text when an CXTPShortcutBarItem is selected, this happens after the item is clicked.
CXTPPaintManagerColor m_clrHotText; // Color of Caption text when the mouse cursor is positioned over an CXTPShortcutBarItem.
CXTPPaintManagerColor m_clrNormalText; // Color of Caption text when an CXTPShortcutBarItem is displayed normally.
CXTPPaintManagerColor m_clrDisabledText; // Color of Caption text when an CXTPShortcutBarItem is disabled.
CXTPPaintManagerColorGradient m_grcSelected; // Color gradient of currently selected item,
CXTPPaintManagerColorGradient m_grcHot; // Color gradient of "hot" items. And item is hot when the mouse cursor is positioned over the item.
CXTPPaintManagerColorGradient m_grcPushed; // Color gradient of item when clicked on. This color is also used to color the currently selected item on mouse over. I.e. When the selected item is "hot."
CXTPPaintManagerColorGradient m_grcShortcutItem; // Color gradient of shortcut bar item's.
CXTPPaintManagerColor m_clrShortcutItemShadow; // Color of line border that goes around each item.
CXTPPaintManagerColorGradient m_grcShortcutBarGripper; // Color Gradient used to draw the shortcut bar gripper.
CXTPPaintManagerColor m_clrPopupFrame;
CXTPPaintManagerColor m_clrPopupBackground;
COLORREF m_clrFlatBackground;
COLORREF m_clrFlatTextColor;
COLORREF m_clrAppSplitterFace;
};
//===========================================================================
// Summary:
// CXTPShortcutBarOffice2003Theme is a CXTPShortcutBarPaintManager derived
// class that represents the Office 2003 shortcut bar theme.
//===========================================================================
class _XTP_EXT_CLASS CXTPShortcutBarOffice2003Theme : public CXTPShortcutBarPaintManager
{
public:
//-------------------------------------------------------------------------
// Summary:
// Constructs a CXTPShortcutBarOffice2003Theme object.
//-------------------------------------------------------------------------
CXTPShortcutBarOffice2003Theme();
public:
//-----------------------------------------------------------------------
// Summary:
// This method is called to fill the client area of the ShortcutBar control.
// Parameters:
// pDC - Points to the client device context.
// pShortcutBar - Points to the ShortcutBar control.
//-----------------------------------------------------------------------
void FillShortcutBar(CDC* pDC, CXTPShortcutBar* pShortcutBar);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the frame of the ShortcutBar control.
// Parameters:
// pDC - Points to the client device context.
// pShortcutBar - Points to the ShortcutBar control.
// Remarks:
// This is the border that is drawn around the entire shortcut bar.
//-----------------------------------------------------------------------
void DrawShortcutBarFrame(CDC* pDC, CXTPShortcutBar* pShortcutBar);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the specified item of the ShortcutBar control.
// Parameters:
// pDC - Points to the client device context.
// pItem - Item to be drawn.
//-----------------------------------------------------------------------
void FillShortcutItemEntry(CDC* pDC, CXTPShortcutBarItem* pItem);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw gripper of the ShortcutBar control
// Parameters:
// pDC - Points to the client device context.
// pShortcutBar - Points to the ShortcutBar control
// bDraw - TRUE to draw, FALSE to determine size of the gripper.
// Returns:
// Size of the gripper, which is 7 pixels for the Office 2003 theme.
//-----------------------------------------------------------------------
int DrawGripper(CDC* pDC, CXTPShortcutBar* pShortcutBar, BOOL bDraw);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the caption of the specified pane.
// Parameters:
// pDC - Points to the client device context.
// pPane - Shortcut Pane to be drawn
// bDraw - TRUE to draw pane, FALSE to determine size of the caption
// Remarks:
// Panes of the shortcut bar are displayed in the shortcut bar's client
// area. Each pane consists of a caption and one or more sub-panes.
// Each sub-pane has it's own caption and is drawn with the
// DrawPaneItemCaption method.
//
// The caption of the shortcut bar pane is the bar on the top the pane.
// The caption of the pane is set when the pane is created in the
// CXTPShortcutBarPane::Create method.
//
// The pane caption can be retrieved with CXTPShortcutBarPane::GetCaption
//
// Shortcut bar pane's have sub-item's which also have a caption that is
// drawn with the DrawPaneItemCaption method.
// Returns:
// Size of the caption. Which is 24 pixes.
//-----------------------------------------------------------------------
int DrawPaneCaption(CDC* pDC, CXTPShortcutBarPane* pPane, BOOL bDraw);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the caption of the specified shortcut
// pane item. This is the sub-pane of a shortcut bar pane.
// Parameters:
// pDC - Points to the client device context.
// pItem - Shortcut item pane to be drawn
// bDraw - TRUE to draw, FALSE to determine size of the shortcut
// pane caption.
// Remarks:
// Panes of the shortcut bar are displayed in the shortcut bar's client
// area. Each pane consists of a caption and one or more sub-panes.
// Each sub-pane has it's own caption and is drawn with the
// DrawPaneItemCaption method.
//
// The caption of the pane item is set when the pane item is created in the
// CXTPShortcutBarPane::AddItem method.
//
// The sub-items of a pane can be retrieved with the CXTPShortcutBarPane::GetItem
// method.
// Returns:
// Size of the pane item caption. This is retrieved from CXTPShortcutBarPaintManager::m_nPaneItemHeight.
//-----------------------------------------------------------------------
int DrawPaneItemCaption(CDC* pDC, CXTPShortcutBarPaneItem* pItem, BOOL bDraw);
//-------------------------------------------------------------------------
// Summary:
// This method is called to refresh the visual metrics of the shortcut
// bar paint manager.
// Remarks:
// This refreshes all the visual metrics of the shortcut bar such
// as the pane caption color, pane font, pane caption height, etc.
//
// If luna colors are enabled, the the shortcut bar will be colored
// to match the current system them if the XTPCurrentSystemTheme is
// xtpSystemThemeBlue, xtpSystemThemeSilver, or xtpSystemThemeOlive.
//-------------------------------------------------------------------------
void RefreshMetrics();
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the image of a Shortcut Bar item.
// Parameters:
// pDC - Points to the client device context.
// pt - Location at which to draw the image within the specified
// device context.
// sz - Size of the image.
// pImage - Points to a CXTPImageManagerIcon object.
// bSelected - TRUE if the shortcut bar item is selected\has focus.
// I.e. When the user clicks on the item.
// bPressed - TRUE if the shortcut bar item is currently pressed.
// I.e. The user is clicking on the item.
// bChecked - TRUE if the shortcut bar item is checked. I.e.
// toggle buttons.
// bEnabled - TRUE to draw item enabled
// Remarks:
// This member draws the image of a shortcut bar item. The
// DrawShortcutItem method uses this method to draw shortcut bar
// images.
//-----------------------------------------------------------------------
void DrawImage(CDC* pDC, CPoint pt, CSize sz, CXTPImageManagerIcon* pImage, BOOL bSelected, BOOL bPressed, BOOL bChecked, BOOL bEnabled);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw navigation item of minimized ShortcutBar
// Parameters:
// pDC - Points to the client device context.
// pItem - Shortcut item to be drawn
//-----------------------------------------------------------------------
void FillNavigationItemEntry(CDC* pDC, CXTPShortcutBarItem* pItem);
public:
CXTPPaintManagerColorGradient m_grcCaption; // Caption color
CXTPPaintManagerColorGradient m_grcItemCaption; // Items color
CXTPPaintManagerColorGradient m_grcItemHotCaption; // Items color
CXTPPaintManagerColor m_clrItemCaptionShadow; // Color of subcaption shadow
CXTPPaintManagerColor m_clrItemCaptionTop; // Color under subcaption rectangle
CXTPPaintManagerColor m_clrCaptionText; // Color of items text
CXTPPaintManagerColor m_clrItemCaptionText; // Color of subcaption text
BOOL m_bShowTopLeftCaptionShadow; // True to draw rectangle around items
BOOL m_bLunaColorDisabled;
};
//===========================================================================
// Summary:
// CXTPShortcutBarNativeWinXPTheme is a CXTPShortcutBarOffice2003Theme derived
// class that represents the Windows XP skinned shortcut bar theme.
//===========================================================================
class CXTPShortcutBarNativeWinXPTheme : public CXTPShortcutBarOffice2003Theme
{
public:
CXTPShortcutBarNativeWinXPTheme();
~CXTPShortcutBarNativeWinXPTheme();
public:
//-----------------------------------------------------------------------
// Summary:
// This method is called to refresh the visual metrics of the shortcut
// bar paint manager.
// Remarks:
// This refreshes all the visual metrics of the shortcut bar such
// as the pane caption color, pane font, pane caption height, etc.
//-----------------------------------------------------------------------
void RefreshMetrics();
public:
//-----------------------------------------------------------------------
// Summary:
// This method is called to fill the client area of the ShortcutBar control
// Parameters:
// pDC - Points to the client device context.
// pShortcutBar - Points to the ShortcutBar control
//-----------------------------------------------------------------------
void FillShortcutBar(CDC* pDC, CXTPShortcutBar* pShortcutBar);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the specified item of the ShortcutBar control.
// Parameters:
// pDC - Points to the client device context.
// pItem - Item to be drawn.
//-----------------------------------------------------------------------
void FillShortcutItemEntry(CDC* pDC, CXTPShortcutBarItem* pItem);
protected:
CXTPWinThemeWrapper* m_themeToolbar;
CXTPWinThemeWrapper* m_themeRebar;
};
//===========================================================================
// Summary:
// CXTPShortcutBarOffice2007Theme is a CXTPShortcutBarOffice2003Theme derived
// class that represents the Office 2007 shortcut bar theme.
//===========================================================================
class _XTP_EXT_CLASS CXTPShortcutBarOffice2007Theme : public CXTPShortcutBarOffice2003Theme
{
public:
//-------------------------------------------------------------------------
// Summary:
// Constructs a CXTPShortcutBarOffice2007Theme object.
//-------------------------------------------------------------------------
CXTPShortcutBarOffice2007Theme();
public:
//-------------------------------------------------------------------------
// Summary:
// This method is called to refresh the visual metrics of the shortcut
// bar paint manager.
// Remarks:
// This refreshes all the visual metrics of the shortcut bar such
// as the pane caption color, pane font, pane caption height, etc.
//-------------------------------------------------------------------------
virtual void RefreshMetrics();
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw gripper of the ShortcutBar control
// Parameters:
// pDC - Points to the client device context.
// pShortcutBar - Points to the ShortcutBar control
// bDraw - TRUE to draw, FALSE to determine size of the gripper.
// Returns:
// Size of the gripper, which is 7 pixels for the Office XP theme.
//-----------------------------------------------------------------------
int DrawGripper(CDC* pDC, CXTPShortcutBar* pShortcutBar, BOOL bDraw);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the specified item of the ShortcutBar control.
// Parameters:
// pDC - Points to the client device context.
// pItem - Item to be drawn.
//-----------------------------------------------------------------------
void FillShortcutItemEntry(CDC* pDC, CXTPShortcutBarItem* pItem);
//-----------------------------------------------------------------------
// Summary:
// This method is called to fill the client area of the ShortcutBar control.
// Parameters:
// pDC - Points to the client device context.
// pShortcutBar - Points to the ShortcutBar control.
//-----------------------------------------------------------------------
void FillShortcutBar(CDC* pDC, CXTPShortcutBar* pShortcutBar);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the caption of the specified shortcut
// pane item. This is the sub-pane of a shortcut bar pane.
// Parameters:
// pDC - Points to the client device context.
// pItem - Shortcut item pane to be drawn
// bDraw - bDraw - TRUE to draw, FALSE to determine size of the shortcut
// pane caption.
// Remarks:
// Panes of the shortcut bar are displayed in the shortcut bar's client
// area. Each pane consists of a caption and one or more sub-panes.
// Each sub-pane has it's own caption and is drawn with the
// DrawPaneItemCaption method.
//
// The caption of the pane item is set when the pane item is created in the
// CXTPShortcutBarPane::AddItem method.
//
// The sub-items of a pane can be retrieved with the CXTPShortcutBarPane::GetItem
// method.
// Returns:
// Size of the pane item caption. This is retrieved from m_nPaneItemHeight.
//-----------------------------------------------------------------------
virtual int DrawPaneItemCaption(CDC* pDC, CXTPShortcutBarPaneItem* pItem, BOOL bDraw);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the caption of the specified pane.
// Parameters:
// pDC - Points to the client device context.
// pPane - Shortcut Pane to be drawn
// bDraw - TRUE to draw pane, FALSE to determine size of the caption
// Remarks:
// Panes of the shortcut bar are displayed in the shortcut bar's client
// area. Each pane consists of a caption and one or more sub-panes.
// Each sub-pane has it's own caption and is drawn with the
// DrawPaneItemCaption method.
//
// The caption of the shortcut bar pane is the bar on the top the pane.
// The caption of the pane is set when the pane is created in the
// CXTPShortcutBarPane::Create method.
//
// The pane caption can be retrieved with CXTPShortcutBarPane::GetCaption
//
// Shortcut bar pane's have sub-item's which also have a caption that is
// drawn with the DrawPaneItemCaption method.
// Returns:
// Size of the caption. Unless overridden, the default caption is 24 pixes.
//-----------------------------------------------------------------------
virtual int DrawPaneCaption(CDC* pDC, CXTPShortcutBarPane* pPane, BOOL bDraw);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the expand button.
// Parameters:
// pDC - Points to the client device context.
// rc - Client rectangle of the expand button.
//-----------------------------------------------------------------------
virtual void DrawExpandButton(CDC* pDC, CRect rc);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw navigation item of minimized ShortcutBar
// Parameters:
// pDC - Points to the client device context.
// pItem - Shortcut item to be drawn
//-----------------------------------------------------------------------
virtual void FillNavigationItemEntry(CDC* pDC, CXTPShortcutBarItem* pItem);
virtual void DrawPaneCaptionMinimizeButton(CDC* pDC, CXTPShortcutBarPane* pPane);
public:
BOOL m_bFlatStyle;
};
//===========================================================================
// Summary:
// CXTPShortcutBarOfficeXPTheme is a CXTPShortcutBarPaintManager derived
// class that represents the Office 2003 shortcut bar theme.
//===========================================================================
class _XTP_EXT_CLASS CXTPShortcutBarOfficeXPTheme : public CXTPShortcutBarPaintManager
{
public:
//-----------------------------------------------------------------------
// Summary:
// This method is called to fill the client area of the ShortcutBar control.
// Parameters:
// pDC - Points to the client device context.
// pShortcutBar - Points to the ShortcutBar control.
//-----------------------------------------------------------------------
void FillShortcutBar(CDC* pDC, CXTPShortcutBar* pShortcutBar);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the frame of the ShortcutBar control.
// Parameters:
// pDC - Points to the client device context.
// pShortcutBar - Points to the ShortcutBar control.
// Remarks:
// This is the border that is drawn around the entire shortcut bar.
//-----------------------------------------------------------------------
void DrawShortcutBarFrame(CDC* pDC, CXTPShortcutBar* pShortcutBar);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the specified item of the ShortcutBar control.
// Parameters:
// pDC - Points to the client device context.
// pItem - Item to be drawn.
//-----------------------------------------------------------------------
void FillShortcutItemEntry(CDC* pDC, CXTPShortcutBarItem* pItem);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw gripper of the ShortcutBar control
// Parameters:
// pDC - Points to the client device context.
// pShortcutBar - Points to the ShortcutBar control
// bDraw - TRUE to draw, FALSE to determine size of the gripper.
// Returns:
// Size of the gripper, which is 7 pixels for the Office XP theme.
//-----------------------------------------------------------------------
int DrawGripper(CDC* pDC, CXTPShortcutBar* pShortcutBar, BOOL bDraw);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the image of a Shortcut Bar item.
// Parameters:
// pDC - Points to the client device context.
// pt - Location at which to draw the image within the specified
// device context.
// sz - Size of the image.
// pImage - Points to a CXTPImageManagerIcon object.
// bSelected - TRUE if the shortcut bar item is selected\has focus.
// I.e. When the user clicks on the item.
// bPressed - TRUE if the shortcut bar item is currently pressed.
// I.e. The user is clicking on the item.
// bChecked - TRUE if the shortcut bar item is checked. I.e.
// toggle buttons.
// bEnabled - TRUE to draw item enabled
// Remarks:
// This member draws the image of a shortcut bar item. The
// DrawShortcutItem method uses this method to draw shortcut bar
// images.
//-----------------------------------------------------------------------
void DrawImage(CDC* pDC, CPoint pt, CSize sz, CXTPImageManagerIcon* pImage, BOOL bSelected, BOOL bPressed, BOOL bChecked, BOOL bEnabled);
};
//===========================================================================
// Summary:
// CXTPShortcutBarOffice2000Theme is a CXTPShortcutBarPaintManager derived
// class that represents the Office 2003 shortcut bar theme.
//===========================================================================
class _XTP_EXT_CLASS CXTPShortcutBarOffice2000Theme : public CXTPShortcutBarPaintManager
{
public:
//-----------------------------------------------------------------------
// Summary:
// This method is called to fill the client area of the ShortcutBar control.
// Parameters:
// pDC - Points to the client device context.
// pShortcutBar - Points to the ShortcutBar control.
//-----------------------------------------------------------------------
void FillShortcutBar(CDC* pDC, CXTPShortcutBar* pShortcutBar);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the frame of the ShortcutBar control.
// Parameters:
// pDC - Points to the client device context.
// pShortcutBar - Points to the ShortcutBar control.
// Remarks:
// This is the border that is drawn around the entire shortcut bar.
//-----------------------------------------------------------------------
void DrawShortcutBarFrame(CDC* pDC, CXTPShortcutBar* pShortcutBar);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the specified item of the ShortcutBar control.
// Parameters:
// pDC - Points to the client device context.
// pItem - Item to be drawn.
//-----------------------------------------------------------------------
void FillShortcutItemEntry(CDC* pDC, CXTPShortcutBarItem* pItem);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw gripper of the ShortcutBar control
// Parameters:
// pDC - Points to the client device context.
// pShortcutBar - Points to the ShortcutBar control
// bDraw - TRUE to draw, FALSE to determine size of the gripper.
// Returns:
// Size of the gripper, which is 4 pixels for the Office 2000 theme.
//-----------------------------------------------------------------------
int DrawGripper(CDC* pDC, CXTPShortcutBar* pShortcutBar, BOOL bDraw);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw a rectangle. The rectangle is
// used to draw the shortcut items.
// Parameters:
// pDC - Pointer to a valid device context
// rc - Specifies the rectangle in logical units.
// nPen - Specifies the color used to paint the rectangle.
// nBrush - Specifies the color used to fill the rectangle.
// Remarks:
// Rectangle is used to draw the rectangle of the shortcut bar items
// in the Office XP theme. This will draw the normal, pressed, and
// hot versions of the item.
//-----------------------------------------------------------------------
void Rectangle(CDC* pDC, CRect rc, int nPen, int nBrush);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the "gripper" lines in the gripper.
// Parameters:
// pDC - Points to the client device context.
// x0 - Specifies the logical x-coordinate of the start position.
// y0 - Specifies the logical y-coordinate of the start position.
// x1 - Specifies the logical x-coordinate of the endpoint for the line.
// y1 - Specifies the logical y-coordinate of the endpoint for the line.
// nPen - Specifies the color used to paint the line.
//-----------------------------------------------------------------------
void Line(CDC* pDC, int x0, int y0, int x1, int y1, int nPen);
//-----------------------------------------------------------------------
// Summary:
// This method is called to draw the image of a Shortcut Bar item.
// Parameters:
// pDC - Points to the client device context.
// pt - Location at which to draw the image within the specified
// device context.
// sz - Size of the image.
// pImage - Points to a CXTPImageManagerIcon object.
// bSelected - TRUE if the shortcut bar item is selected\has focus.
// I.e. When the user clicks on the item.
// bPressed - TRUE if the shortcut bar item is currently pressed.
// I.e. The user is clicking on the item.
// bChecked - TRUE if the shortcut bar item is checked. I.e.
// toggle buttons.
// bEnabled - TRUE to draw item enabled
// Remarks:
// This member draws the image of a shortcut bar item. The
// DrawShortcutItem method uses this method to draw shortcut bar
// images.
//-----------------------------------------------------------------------
void DrawImage(CDC* pDC, CPoint pt, CSize sz, CXTPImageManagerIcon* pImage, BOOL bSelected, BOOL bPressed, BOOL bChecked, BOOL bEnabled);
};
#endif // !defined(__XTPSHORTCUTBARPAINTMANAGER_H__)