/**
 * @file XTPTabThemePropertyPage2003.h
 *
 * @copyright
 * (c) 1998-2025 Codejock Software, All Rights Reserved.
 *
 * This source file is the property of Codejock Software and must not be
 * redistributed by any means without the explicit written permission of
 * Codejock Software.
 *
 * The use of this source code is governed by the terms and conditions specified
 * in the Toolkit Pro license agreement. Codejock Software grants you, as a
 * single software developer, the limited right to use this software on one
 * computer only.
 *
 * Contact Information:
 * support@codejock.com
 * http://www.codejock.com
 *
 */

/** @cond */
#if !defined(__XTPTABTHEMEPROPERTYPAGE2003_H__)
#	define __XTPTABTHEMEPROPERTYPAGE2003_H__
/** @endcond */

#	if _MSC_VER > 1000
#		pragma once
#	endif // _MSC_VER > 1000

#	include "Common/Base/Diagnostic/XTPDisableNoisyWarnings.h"

/**
 * @brief
 * CAppearanceSetPropertyPage2003 implements an Office 2003 tab appearance.
 * @details
 * To use the Office 2003 appearance, SetAppearance is used to apply
 * the xtpTabAppearancePropertyPage2003 XTPTabAppearanceStyle.
 *
 * CAppearanceSetPropertyPage2003 supports the following XTPTabColorStyle:
 * <b>xtpTabColorDefault</b>: Default color style.
 * <b>xtpTabColorOffice2003</b>: Office 2003 color style.
 * <b>xtpTabColorVisualStudio2005</b>: Visual Studio 2005 color style.
 *
 * By default, m_bDoubleHighlightedBorder is FALSE.
 * If m_bDoubleHighlightedBorder is TRUE, then a double border is
 * drawn on mouse over when hot tracking is enabled.
 * @see
 * XTPTabColorStyle, XTPTabAppearanceStyle, SetAppearance, GetAppearance,
 * GetAppearanceSet, SetColor, GetColor, GetColorSet, SetColorSet, SetAppearanceSet
 */
class _XTP_EXT_CLASS CAppearanceSetPropertyPage2003 : public CXTPTabPaintManagerTheme
{
public:
	/**
	 * @brief
	 * Constructs a CAppearanceSetPropertyPage2003 object.
	 */
	CAppearanceSetPropertyPage2003()
	{
		m_rcHeaderMargin.SetRect(2, 3, 6, 0);
		m_bDoubleHighlightedBorder = FALSE;
	}

	/**
	 * @brief
	 * Gets the top, left, right, and bottom margins of the tab header.
	 * @return
	 * The top, left, right, and bottom margins of the tab header.
	 * @details
	 * The margins of the tab header are the space placed around
	 * the tab buttons inside the tab header.
	 *
	 * The margins of the tab header are not placed around each
	 * tab button. Instead, they are placed around all tab buttons.
	 * @see
	 * CXTPTabPaintManager::GetHeaderRect
	 */
	virtual CRect GetHeaderMargin()
	{
		return CRect(m_rcHeaderMargin.left + m_nButtonHeight, m_rcHeaderMargin.top,
					 m_rcHeaderMargin.right, m_rcHeaderMargin.bottom);
	}

	/**
	 * @brief
	 * Refreshes the appearance metrics.
	 * Override this member to change the appearance metrics.
	 * @details
	 * This method is used to refresh the appearance metrics
	 * such as font, button height, margin size, etc.
	 */
	virtual void RefreshMetrics();

	/**
	 * @brief
	 * Draws a single tab button in the tab client header area.
	 * @param pDC   Pointer to a valid device context.
	 * @param pItem Pointer to the tab button to draw.
	 * @details
	 * This method is only used to draw the tab button. This method does not
	 * draw the button's icon or text.
	 *
	 * DrawSingleButton calls CXTPTabPaintManager::DrawSingleButtonIconAndText
	 * after the button is drawn to draw the button's icon and text.
	 *
	 * If m_bDoubleHighlightedBorder is TRUE, then a double border is
	 * drawn on mouse over when hot tracking is enabled.
	 * @see
	 * CXTPTabPaintManager::DrawTabControlEx,
	 * CXTPTabPaintManager::DrawSingleButtonIconAndText, m_bDoubleHighlightedBorder
	 */
	virtual void DrawSingleButton(CDC* pDC, CXTPTabManagerItem* pItem);

	/**
	 * @brief
	 * Fills both the tab header and the tab client area and then
	 * draws the tab client frame.
	 * @param pTabManager Pointer to the tab manager to fill.
	 * @param pDC         Pointer to a valid device context.
	 * @param rcControl   Bounding rectangle of the tab manager control.
	 * See CXTPTabManager::GetControlRect.
	 * @return
	 * The bounding rectangle of the tab header.
	 * @details
	 * If CXTPTabPaintManager::m_bFillBackground is TRUE, then the tab client space
	 * is filled using CXTPTabPaintManagerColorSet::m_clrControlFace.
	 * CXTPTabPaintManager::m_bFillBackground is only FALSE when drawing
	 * docking pane panel auto-hide tabs because there is no client area to draw.
	 * @see
	 * CXTPTabPaintManagerTheme::GetHeaderRect, CXTPTabPaintManager::m_bFillBackground,
	 * XTPTabClientFrame, CXTPTabPaintManager::m_clientFrame
	 */
	virtual CRect FillTabControl(CXTPTabManager* pTabManager, CDC* pDC, CRect rcControl);

	/**
	 * @brief
	 * Gets the default value of the color set for this theme.
	 * @return
	 * The default value of the color set for this theme.
	 * @see
	 * GetSupportedColorSets
	 */
	virtual XTPTabColorStyle GetDefaultColorSet()
	{
		return xtpTabColorOffice2003;
	}

	/**
	 * @brief
	 * Retrieves the bounding rectangle of a specified drawing item.
	 * @param pItem Pointer to the drawing item with
	 * the bounding rectangle to retrieve.
	 * @return
	 * The bounding rectangle of the specified drawing item.
	 * @see
	 * CXTPTabManagerItem::GetRect
	 */
	virtual CRect GetButtonDrawRect(const CXTPTabManagerItem* pItem);

public:
	BOOL m_bDoubleHighlightedBorder; /**< TRUE to draw a double border on mouse over when hot
										tracking is enabled. */
};

#	include "Common/Base/Diagnostic/XTPEnableNoisyWarnings.h"
/** @cond */
#endif // !defined(__XTPTABTHEMEPROPERTYPAGE2003_H__)
/** @endcond */