/**
 * @file XTPTabThemeOffice2000.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(__XTPTABTHEMEOFFICE2000_H__)
#	define __XTPTABTHEMEOFFICE2000_H__
/** @endcond */

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

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

/**
 * @brief
 * CXTPTabThemeOffice2000 implements an Office 2000 tab appearance.
 * @details
 * To use the Office 2000 appearance, SetAppearance is used to apply
 * the xtpTabAppearancePropertyPage XTPTabAppearanceStyle.
 *
 * CXTPTabThemeOffice2000 supports the following XTPTabColorStyle:
 * <b>xtpTabColorDefault</b>: Default color style.
 * <b>xtpTabColorOffice2003</b>: Office 2003 color style.
 * <b>xtpTabColorWinNative</b>: Windows XP color style.
 * @see
 * XTPTabColorStyle, XTPTabAppearanceStyle, SetAppearance, GetAppearance,
 * GetAppearanceSet, SetColor, GetColor, GetColorSet, SetColorSet, SetAppearanceSet
 */
class _XTP_EXT_CLASS CXTPTabThemeOffice2000 : public CXTPTabPaintManagerTheme
{
public:
	/**
	 * @brief
	 * Constructs a CXTPTabThemeOffice2000 object.
	 */
	CXTPTabThemeOffice2000()
	{
		m_rcHeaderMargin.SetRect(2, 3, 6, 0);
	}

	/**
	 * @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.
	 * @see
	 * CXTPTabPaintManager::DrawTabControlEx,
	 * CXTPTabPaintManager::DrawSingleButtonIconAndText
	 */
	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 xtpTabColorDefault;
	}

	/**
	 * @brief
	 * Gets the top, left, right, and bottom margins of the tab client area.
	 * @return
	 * The top, left, right, and bottom margins of the tab client area.
	 * @details
	 * The margins of the tab client area are the space placed around
	 * the tab client area in the tab control.
	 *
	 * <b>Example:</b>
	 * <pre>
	 * // Set the top, left, right, and bottom tab header margins to 5 pixels.  This will
	 * // place a margin of 5 pixels around the tab buttons in the tab header.
	 * m_wndTabControl.GetPaintManager()->GetAppearanceSet()->m_rcHeaderMargin.SetRect(5, 5, 5, 5);
	 *
	 * // Set the top, left, right, and bottom tab control margins to 4 pixels.  This will
	 * // place a margin of 4 pixels around the entire tab control (Includes tab header and tab
	 * client area). m_wndTabControl.GetPaintManager()->m_rcControlMargin.SetRect(4, 4, 4, 4);
	 *
	 * // Set the top, left, right, and bottom tab button margins to 2 pixels.  This will
	 * // place a margin of 2 pixels around the text and icon in the tab buttons.
	 * m_wndTabControl.GetPaintManager()->m_rcButtonMargin.SetRect(2, 2, 2, 2);
	 *
	 * // Set the top, left, right, and bottom tab client margins to 10 pixels.  This will
	 * // place a margin of 10 pixels around the tab client area.
	 * m_wndTabControl.GetPaintManager()->m_rcClientMargin.SetRect(10, 10, 10, 10);
	 * </pre>
	 * @see
	 * CXTPTabPaintManagerTheme::GetHeaderMargin
	 */
	virtual CRect GetClientMargin();

	/**
	 * @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);

	/**
	 * @brief
	 * Gets the clip box of the tab header area.
	 * @param pDC         Pointer to a CDC object.
	 * @param pTabManager Pointer to a CXTPTabManager object.
	 * @return
	 * The clip box of the tab header area.
	 */
	virtual CRect GetHeaderClipBox(CDC* pDC, CXTPTabManager* pTabManager);
};

class _XTP_EXT_CLASS CXTPTabPaintManager::CAppearanceSetPropertyPage : public CXTPTabThemeOffice2000
{
};

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