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

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

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

class CXTPChartPalette;
class CXTPChartElement;
class CXTPChartFillStyle;
class CXTPPropExchange;

/**
 * @brief
 * This class represents the appearance of a chart element.
 */
class _XTP_EXT_CLASS CXTPChartElementAppearance : public CXTPChartElement
{
public:
	/**
	 * @brief
	 * Constructs a CXTPChartElementAppearance object.
	 *
	 * @param pOwner Pointer to an owner element.
	 */
	CXTPChartElementAppearance(CXTPChartElement* pOwner);

	/**
	 * @brief
	 * Destroys a CXTPChartElementAppearance object, handles cleanup
	 */
	virtual ~CXTPChartElementAppearance();

	/**
	 * @brief
	 * Applies implementation specific appearance settings to
	 * the device context provided.
	 *
	 * @param pDC Target device context pointer.
	 */
	virtual void ApplyToDeviceContext(CXTPChartDeviceContext* pDC);
};

/**
 * @brief
 * This class represents the appearance of a chart title.
 */
class _XTP_EXT_CLASS CXTPChartTitleAppearance : public CXTPChartElementAppearance
{
public:
	/**
	 * @brief
	 * Constructs a CXTPChartTitleAppearance object.
	 *
	 * @param pOwner Pointer to an owner element.
	 */
	CXTPChartTitleAppearance(CXTPChartElement* pOwner);

public:
	/**
	 * @brief
	 * Call this member function to Store/Load the properties related to the
	 * appearance of a chart title using the specified data object.
	 *
	 * @param pPX Source or destination CXTPPropExchange data object reference.
	 *
	 * @details
	 * This member function is used to store or load property data to or
	 * from a storage.
	 */
	void DoPropExchange(CXTPPropExchange* pPX);

public:
	CXTPChartColor TextColor; // The text color of chart title.
};

/**
 * @brief
 * This class represents the appearance of a chart legend.
 */
class _XTP_EXT_CLASS CXTPChartLegendAppearance : public CXTPChartElementAppearance
{
public:
	/**
	 * @brief
	 * Constructs a CXTPChartLegendAppearance object.
	 *
	 * @param pOwner Pointer to an owner element.
	 */
	CXTPChartLegendAppearance(CXTPChartElement* pOwner);

public:
	/**
	 * @brief
	 * Call this member function to Store/Load the properties related to the
	 * appearance of a chart legend using the specified data object.
	 *
	 * @param pPX Source or destination CXTPPropExchange data object reference.
	 *
	 * @details
	 * This member function is used to store or load property data to or
	 * from a storage.
	 */
	void DoPropExchange(CXTPPropExchange* pPX);

public:
	CXTPChartColor TextColor;		/**< The legend text color.*/
	CXTPChartColor BackgroundColor; /**< The legend background color.*/
	CXTPChartColor BorderColor;		/**< The legend border color.*/
};

/**
 * @brief
 * This class represents the appearance of a chart content. This class is
 * is subclassed from CXTPChartElementAppearance class.
 */
class _XTP_EXT_CLASS CXTPChartContentAppearance : public CXTPChartElementAppearance
{
public:
	/**
	 * @brief
	 * Constructs a CXTPChartContentAppearance object.
	 *
	 * @param pOwner Pointer to an owner element.
	 */
	CXTPChartContentAppearance(CXTPChartElement* pOwner);

	/**
	 * @brief
	 * Destroys a CXTPChartContentAppearance object, handles cleanup
	 */
	virtual ~CXTPChartContentAppearance();

public:
	/**
	 * @brief
	 * Call this member function to Store/Load the properties related to the
	 * appearance of a chart content using the specified data object.
	 *
	 * @param pPX Source or destination CXTPPropExchange data object reference.
	 *
	 * @details
	 * This member function is used to store or load property data to or
	 * from a storage.
	 */
	void DoPropExchange(CXTPPropExchange* pPX);

public:
	/**
	 * @brief
	 * Call this function to get the title appearance object pointer.
	 *
	 * @return Returns the pointer to CXTPChartTitleAppearance object.
	 */
	CXTPChartTitleAppearance* GetTitleAppearance() const;

	/**
	 * @brief
	 * Call this function to get the legend appearance object pointer.
	 *
	 * @return Returns the pointer to CXTPChartLegendAppearance object.
	 */
	CXTPChartLegendAppearance* GetLegendAppearance() const;

public:
	CXTPChartColor BackgroundColor; /**< The background color of the chart.*/
	CXTPChartColor BorderColor;		/**< The border color of the chart.*/

protected:
	CXTPChartTitleAppearance* m_pTitleAppearance;   /**< Pointer to the chart title appearance
													   object.*/
	CXTPChartLegendAppearance* m_pLegendAppearance; /**< Pointer to the legend appearance object.*/
};

/**
 * @brief
 * This class represents the appearance of a chart axis.This class is
 * is subclassed from CXTPChartElementAppearance class.
 */
class _XTP_EXT_CLASS CXTPChartAxisAppearance : public CXTPChartElementAppearance
{
public:
	/**
	 * @brief
	 * Constructs a CXTPChartAxisAppearance object.
	 *
	 * @param pOwner Pointer to an owner element.
	 */
	CXTPChartAxisAppearance(CXTPChartElement* pOwner);

	/**
	 * @brief
	 * Destroys a CXTPChartAxisAppearance object, handles cleanup
	 */
	virtual ~CXTPChartAxisAppearance();

public:
	/**
	 * @brief
	 * Call this member function to Store/Load the properties related to the
	 * appearance of a chart axis using the specified data object.
	 *
	 * @param pPX Source or destination CXTPPropExchange data object reference.
	 *
	 * @details
	 * This member function is used to store or load property data to or
	 * from a storage.
	 */
	void DoPropExchange(CXTPPropExchange* pPX);

public:
	CXTPChartColor Color;					 /**< The color of the axis.				*/
	CXTPChartColor InterlacedColor;			 /**< The primary interlaced color.		*/
	CXTPChartColor InterlacedColor2;		 /**< The secondary interlaced color.		*/
	CXTPChartFillStyle* InterlacedFillStyle; /**< The fill style used for interlacing.*/

	CXTPChartColor GridLinesColor;		/**< The color of the grid lines.		 */
	CXTPChartColor GridLinesMinorColor; /**< The minor color of the grid lines.*/
	CXTPChartColor AxisLabelTextColor;  /**< The text color of the axis label. */
	CXTPChartColor AxisTitleTextColor;  /**< The text color of the axis title. */

	CXTPChartColor ConstantLineColor;	 /**< The color of the contant line parallal to the axis.*/
	CXTPChartColor ConstantLineTextColor; /**< The text color of the contant color.				*/

	CXTPChartColor StripColor;  /**< The strip color.			*/
	CXTPChartColor StripColor2; /**< The strip gradient color.*/

#	ifdef _XTP_ACTIVEX
public:
	DECLARE_DISPATCH_MAP()
	DECLARE_INTERFACE_MAP()
	DECLARE_OLETYPELIB_EX(CXTPChartAxisAppearance);

	afx_msg OLE_COLOR OleGetColor();
	afx_msg void OleSetColor(OLE_COLOR clr);
	afx_msg OLE_COLOR OleGetInterlacedColor();
	afx_msg void OleSetInterlacedColor(OLE_COLOR clr);
	afx_msg OLE_COLOR OleGetInterlacedColor2();
	afx_msg void OleSetInterlacedColor2(OLE_COLOR clr);
	afx_msg LPDISPATCH OleGetInterlacedFillStyle();
	afx_msg OLE_COLOR OleGetGridLinesColor();
	afx_msg void OleSetGridLinesColor(OLE_COLOR clr);
	afx_msg OLE_COLOR OleGetGridLinesMinorColor();
	afx_msg void OleSetGridLinesMinorColor(OLE_COLOR clr);
	afx_msg OLE_COLOR OleGetAxisLabelTextColor();
	afx_msg void OleSetAxisLabelTextColor(OLE_COLOR clr);
	afx_msg OLE_COLOR OleGetAxisTitleTextColor();
	afx_msg void OleSetAxisTitleTextColor(OLE_COLOR clr);
	afx_msg OLE_COLOR OleGetConstantLineColor();
	afx_msg void OleSetConstantLineColor(OLE_COLOR clr);
	afx_msg OLE_COLOR OleGetConstantLineTextColor();
	afx_msg void OleSetConstantLineTextColor(OLE_COLOR clr);
	afx_msg OLE_COLOR OleGetStripColor();
	afx_msg void OleSetStripColor(OLE_COLOR clr);
	afx_msg OLE_COLOR OleGetStripColor2();
	afx_msg void OleSetStripColor2(OLE_COLOR clr);

#	endif
};

/**
 * @brief
 * This class represents the appearance of diagram in 2D. This class
 * is subclassed from CXTPChartElementAppearance class.
 */
class _XTP_EXT_CLASS CXTPChartDiagram2DAppearance : public CXTPChartElementAppearance
{
public:
	/**
	 * @brief
	 * Constructs a CXTPChartDiagram2DAppearance object.
	 *
	 * @param pOwner Pointer to an owner element.
	 */
	CXTPChartDiagram2DAppearance(CXTPChartElement* pOwner);

	/**
	 * @brief
	 * Destroys a CXTPChartDiagram2DAppearance object, handles cleanup
	 */
	virtual ~CXTPChartDiagram2DAppearance();

public:
	/**
	 * @brief
	 * Call this member function to Store/Load the properties related to the
	 * appearance of a diagram in 2D, using the specified data object.
	 *
	 * @param pPX Source or destination CXTPPropExchange data object reference.
	 *
	 * @details
	 * This member function is used to store or load property data to or
	 * from a storage.
	 */
	void DoPropExchange(CXTPPropExchange* pPX);

	/**
	 * @brief
	 *  Obtains axis appearance object pointer.
	 *
	 * @return Axis appearance object pointer.
	 */
	CXTPChartAxisAppearance* GetAxisAppearance() const;

public:
	CXTPChartColor BackgroundColor;			 /**< The first background color of the diagram.*/
	CXTPChartColor BackgroundColor2;		 /**< The second background color of the diagram.*/
	CXTPChartColor BorderColor;				 /**< The border color of the diagram.*/
	CXTPChartFillStyle* BackgroundFillStyle; /**< The background fill style of the diagram.*/

protected:
	CXTPChartAxisAppearance* m_pAxisAppearance; /**< Pointer to the chart axis appearance object.*/

#	ifdef _XTP_ACTIVEX
public:
	DECLARE_DISPATCH_MAP()
	DECLARE_INTERFACE_MAP()
	DECLARE_OLETYPELIB_EX(CXTPChartDiagram2DAppearance);

	afx_msg OLE_COLOR OleGetBackgroundColor();
	afx_msg void OleSetBackgroundColor(OLE_COLOR clr);
	afx_msg OLE_COLOR OleGetBackgroundColor2();
	afx_msg void OleSetBackgroundColor2(OLE_COLOR clr);
	afx_msg OLE_COLOR OleGetBorderColor();
	afx_msg void OleSetBorderColor(OLE_COLOR clr);
	afx_msg LPDISPATCH OleGetBackgroundFillStyle();
	afx_msg LPDISPATCH OleGetAxisAppearance();

#	endif
};

/**
 * @brief
 * This class represents the appearance of diagram in 3D. This class
 * is subclassed from CXTPChartElementAppearance class.
 */
class _XTP_EXT_CLASS CXTPChartDiagram3DAppearance : public CXTPChartElementAppearance
{
public:
	/**
	 * @brief
	 * Constructs a CXTPChartDiagram3DAppearance object.
	 *
	 * @param pOwner Pointer to an owner element.
	 */
	CXTPChartDiagram3DAppearance(CXTPChartElement* pOwner);

	/**
	 * @brief
	 * Destroys a CXTPChartDiagram3DAppearance object, handles cleanup
	 */
	virtual ~CXTPChartDiagram3DAppearance();

public:
	/**
	 * @brief
	 * Call this member function to Store/Load the properties related to the
	 * appearance of a diagram in 3D, using the specified data object.
	 *
	 * @param pPX Source or destination CXTPPropExchange data object reference.
	 *
	 * @details
	 * This member function is used to store or load property data to or
	 * from a storage.
	 */
	void DoPropExchange(CXTPPropExchange* pPX);

	/**
	 * @brief
	 * Applies implementation specific appearance settings to
	 * the device context provided.
	 *
	 * @param pDC Target device context pointer.
	 */
	virtual void ApplyToDeviceContext(CXTPChartDeviceContext* pDC);

public:
	CXTPPoint3f LightPosition; // Light position vector, each component is a normalized value in
							   // range [0..1].*/
	CXTPChartColor LightAmbientColor;	  /**< Light ambient color.*/
	CXTPChartColor LightDiffuseColor;	  /**< Light diffuse color.*/
	CXTPChartColor LightSpecularColor;	 /**< Light specular color.*/
	CXTPChartColor LightModelAmbientColor; /**< Light model ambient color.*/
	CXTPChartColor MaterialEmissionColor;  /**< Material emission color.*/
	CXTPChartColor MaterialDiffuseColor;   /**< Material diffuse color.*/
	CXTPChartColor MaterialSpecularColor;  /**< Material specular color.*/
	float MaterialShininess;			   /**< Material shininess factor in range [0..1].*/
	BOOL Antialiasing;					   /**< Antialiasing enable flag.*/

	static const CXTPPoint3f DefaultLightPosition;		   /**< Default light position vector, each
															  component		 is a normalized value in range
															  [0..1].*/
	static const CXTPChartColor DefaultLightAmbientColor;  /**< Default light ambient color.*/
	static const CXTPChartColor DefaultLightDiffuseColor;  /**< Default light diffuse color.*/
	static const CXTPChartColor DefaultLightSpecularColor; /**< Default light specular color.*/
	static const CXTPChartColor DefaultLightModelAmbientColor; /**< Default light model ambient
																  color.*/
	static const CXTPChartColor DefaultMaterialEmissionColor;  /**< Default material emission
																  color.*/
	static const CXTPChartColor DefaultMaterialDiffuseColor;  /**< Default material diffuse color.*/
	static const CXTPChartColor DefaultMaterialSpecularColor; /**< Default material specular
																 color.*/
	static const float DefaultMaterialShininess; /**< Default material shininess factor in range
													  [0..1].*/
	static const BOOL DefaultAntialiasing;		 /**< Default antialiasing enable flag.*/

#	ifdef _XTP_ACTIVEX
public:
	DECLARE_DISPATCH_MAP()
	DECLARE_INTERFACE_MAP()
	DECLARE_OLETYPELIB_EX(CXTPChartDiagram3DAppearance);

	afx_msg double OleGetLightPositionX();
	afx_msg void OleSetLightPositionX(double dValue);
	afx_msg double OleGetLightPositionY();
	afx_msg void OleSetLightPositionY(double dValue);
	afx_msg double OleGetLightPositionZ();
	afx_msg void OleSetLightPositionZ(double dValue);
	afx_msg OLE_COLOR OleGetLightAmbientColor();
	afx_msg void OleSetLightAmbientColor(OLE_COLOR clr);
	afx_msg OLE_COLOR OleGetLightDiffuseColor();
	afx_msg void OleSetLightDiffuseColor(OLE_COLOR clr);
	afx_msg OLE_COLOR OleGetLightSpecularColor();
	afx_msg void OleSetLightSpecularColor(OLE_COLOR clr);
	afx_msg OLE_COLOR OleGetLightModelAmbientColor();
	afx_msg void OleSetLightModelAmbientColor(OLE_COLOR clr);
	afx_msg OLE_COLOR OleGetMaterialEmissionColor();
	afx_msg void OleSetMaterialEmissionColor(OLE_COLOR clr);
	afx_msg OLE_COLOR OleGetMaterialDiffuseColor();
	afx_msg void OleSetMaterialDiffuseColor(OLE_COLOR clr);
	afx_msg OLE_COLOR OleGetMaterialSpecularColor();
	afx_msg void OleSetMaterialSpecularColor(OLE_COLOR clr);
	afx_msg double OleGetMaterialShininess();
	afx_msg void OleSetMaterialShininess(double dValue);
	afx_msg BOOL OleGetAntialiasing();
	afx_msg void OleSetAntialiasing(BOOL bValue);

#	endif
};

class _XTP_EXT_CLASS CXTPChartSeriesLabelAppearance : public CXTPChartElementAppearance
{
public:
	/**
	 * @brief
	 * Constructs a CXTPChartFinanceStyleAppearance object.
	 *
	 * @param pOwner Pointer to an owner element.
	 */
	CXTPChartSeriesLabelAppearance(CXTPChartElement* pOwner);

	/**
	 * @brief
	 * Destroys a CXTPChartFinanceStyleAppearance object, handles cleanup
	 */
	virtual ~CXTPChartSeriesLabelAppearance();

public:
	/**
	 * @brief
	 * Call this member function to Store/Load the properties related to the
	 * appearance of a diagram in 2D, using the specified data object.
	 *
	 * @param pPX Source or destination CXTPPropExchange data object reference.
	 *
	 * @details
	 * This member function is used to store or load property data to or
	 * from a storage.
	 */
	void DoPropExchange(CXTPPropExchange* pPX);

public:
	CXTPChartColor BackgroundColor;
	CXTPChartColor TextColor;
	CXTPChartColor BorderColor;
	CXTPChartColor ConnectorColor;
};

class _XTP_EXT_CLASS CXTPChartSeriesStyleAppearance : public CXTPChartElementAppearance
{
public:
	/**
	 * @brief
	 * Constructs a CXTPChartSeriesStyleAppearance object.
	 *
	 * @param pOwner Pointer to an owner element.
	 */
	CXTPChartSeriesStyleAppearance(CXTPChartElement* pOwner);

	/**
	 * @brief
	 * Destroys a CXTPChartSeriesStyleAppearance object, handles cleanup
	 */
	virtual ~CXTPChartSeriesStyleAppearance();

public:
	/**
	 * @brief
	 * Call this member function to Store/Load the properties related to the
	 * appearance of a diagram in 2D, using the specified data object.
	 *
	 * @param pPX Source or destination CXTPPropExchange data object reference.
	 *
	 * @details
	 * This member function is used to store or load property data to or
	 * from a storage.
	 */
	void DoPropExchange(CXTPPropExchange* pPX);

public:
	CXTPChartSeriesLabelAppearance* GetLabelAppearance() const;

protected:
	CXTPChartSeriesLabelAppearance* m_pLabelAppearance;
};

/**
 * @brief
 * This class represents the finance series appearance of the chart. Chart appearance determined
 * by the 2D digram appearance, chart content appearance and the color palette used.
 */
class _XTP_EXT_CLASS CXTPChartFinanceStyleAppearance : public CXTPChartSeriesStyleAppearance
{
public:
	/**
	 * @brief
	 * Constructs a CXTPChartFinanceStyleAppearance object.
	 *
	 * @param pOwner Pointer to an owner element.
	 */
	CXTPChartFinanceStyleAppearance(CXTPChartElement* pOwner);

	/**
	 * @brief
	 * Destroys a CXTPChartFinanceStyleAppearance object, handles cleanup
	 */
	virtual ~CXTPChartFinanceStyleAppearance();

public:
	/**
	 * @brief
	 * Call this member function to Store/Load the properties related to the
	 * appearance of a diagram in 2D, using the specified data object.
	 *
	 * @param pPX Source or destination CXTPPropExchange data object reference.
	 *
	 * @details
	 * This member function is used to store or load property data to or
	 * from a storage.
	 */
	void DoPropExchange(CXTPPropExchange* pPX);

public:
	CXTPChartColor UpColor;   /**< Up day line color.*/
	CXTPChartColor DownColor; /**< Down day line Color.*/
};

/**
 * @brief
 * This class represents the pie series appearance of the chart. Chart appearance determined by
 * the 2D digram appearance, chart content appearance and the color palette used.
 */
class _XTP_EXT_CLASS CXTPChartPieStyleAppearance : public CXTPChartSeriesStyleAppearance
{
public:
	/**
	 * @brief
	 * Constructs a CXTPChartPieStyleAppearance object.
	 *
	 * @param pOwner Pointer to an owner element.
	 */
	CXTPChartPieStyleAppearance(CXTPChartElement* pOwner);

	/**
	 * @brief
	 * Destroys a CXTPChartPieStyleAppearance object, handles cleanup
	 */
	virtual ~CXTPChartPieStyleAppearance();

public:
	/**
	 * @brief
	 * Call this member function to Store/Load the properties related to the
	 * appearance of a diagram in 2D, using the specified data object.
	 *
	 * @param pPX Source or destination CXTPPropExchange data object reference.
	 *
	 * @details
	 * This member function is used to store or load property data to or
	 * from a storage.
	 */
	void DoPropExchange(CXTPPropExchange* pPX);

public:
	CXTPChartColor BorderColor; /**< Border color.*/
};

/**
 * @brief
 * This class represents the appearance of the chart. Chart appearance determined by
 * the 2D digram appearance, chart content appearance and the color palette used.
 */
class _XTP_EXT_CLASS CXTPChartAppearance : public CXTPChartElementAppearance
{
public:
	/**
	 * @brief
	 * Constructs a CXTPChartAppearance object.
	 *
	 * @param pOwner Pointer to an owner element.
	 */
	CXTPChartAppearance(CXTPChartElement* pOwner);

	/**
	 * @brief
	 * Destroys a CXTPChartAppearance object, handles cleanup
	 */
	virtual ~CXTPChartAppearance();

public:
	/**
	 * @brief
	 * Call this function to get the 2D digram appearance object pointer of the chart.
	 *
	 * @return Returns the pointer to CXTPChartDiagram2DAppearance object.
	 */
	CXTPChartDiagram2DAppearance* GetDiagram2DAppearance() const;

	/**
	 * @brief
	 * Call this function to get the 3D digram appearance object pointer of the chart.
	 *
	 * @return Returns the pointer to CXTPChartDiagram3DAppearance object.
	 */
	CXTPChartDiagram3DAppearance* GetDiagram3DAppearance() const;

	/**
	 * @brief
	 * Call this function to get the content appearance object pointer of the chart.
	 *
	 * @return Returns the pointer to CXTPChartContentAppearance object.
	 */
	CXTPChartContentAppearance* GetContentAppearance() const;

	/**
	 * @brief
	 * Call this function to get the finance series appearance object pointer of the chart.
	 *
	 * @return Returns the pointer to CXTPChartFinanceSeriesAppearance object.
	 */
	CXTPChartFinanceStyleAppearance* GetFinanceStyleAppearance() const;

	/**
	 * @brief
	 * Call this function to get the series style appearance object pointer of the chart.
	 *
	 * @return Returns the pointer to CXTPChartSeriesStyleAppearance object pointer.
	 */
	CXTPChartSeriesStyleAppearance* GetSeriesStyleAppearance() const;

	/**
	 * @brief
	 * Call this function to get the pie style appearance object pointer of the chart.
	 *
	 * @return Returns the pointer to CXTPChartPieStyleAppearance object pointer.
	 */
	CXTPChartPieStyleAppearance* GetPieStyleAppearance() const;

	/**
	 * @brief
	 * Call this function to get the color palette object pointer of the chart.
	 *
	 * @return Returns the pointer to CXTPChartPalette object.
	 */
	CXTPChartPalette* GetPalette() const;

	/**
	 * @brief
	 * Call this member function to Store/Load the properties related to the
	 * appearance of a chart, here this function calls the DoPropExchange method
	 * of the constituent appearance elements.
	 *
	 * @param pPX Source or destination CXTPPropExchange data object reference.
	 *
	 * @details
	 * This member function is used to store or load property data to or
	 * from a storage.
	 */
	void DoPropExchange(CXTPPropExchange* pPX);

	/**
	 * @brief
	 * Call this function to get the pointer to the chart appeance object.
	 * @param pElement Pointer to CXTPChartElement element
	 * @return Returns the pointer to CXTPChartAppearance object.
	 */
	static CXTPChartAppearance* AFX_CDECL GetAppearance(const CXTPChartElement* pElement);

public:
	/**
	 * @brief
	 * Call this function to load the properties from a resource XML.
	 * @param lpszAppearance A name of an appearance to be loaded.
	 * @return BOOL value TRUE if the properties are loaded successfully, BOOL
	 *		  value FALSE if the function fails.
	 */
	BOOL LoadAppearance(LPCTSTR lpszAppearance);

	/**
	 * @brief
	 * Call this function to load the chart palette values from a resource XML.
	 * @param lpszPallete A name of a pallette to be loaded.
	 * @return BOOL value TRUE if the properties are loaded successfully, BOOL
	 *		  value FALSE if the function fails.
	 */
	BOOL LoadPalette(LPCTSTR lpszPallete);

public:
	static CXTPChartColor AFX_CDECL GetLightColor(const CXTPChartColor& clr);

#	ifdef _XTP_ACTIVEX
public:
	/** @cond */
	DECLARE_DISPATCH_MAP()
	DECLARE_INTERFACE_MAP()

	DECLARE_OLETYPELIB_EX(CXTPChartAppearance);
	afx_msg void OleSetAppearance(LPCTSTR lpszName);
	afx_msg void OleSetPalette(LPCTSTR lpszName);
	afx_msg void OleLoadAppearance(LPDISPATCH lpPropExchage);
	afx_msg void OleLoadPalette(LPDISPATCH lpPropExchage);
	afx_msg LPDISPATCH OleGetPalette();
	afx_msg LPDISPATCH OleGetDiagram2DAppearance();
	afx_msg LPDISPATCH OleGetDiagram3DAppearance();
	/** @endcond */
#	endif

protected:
	CXTPChartDiagram2DAppearance* m_pDiagram2DAppearance; /**< Pointer to chart diagram 2d
															 appearance object.*/
	CXTPChartDiagram3DAppearance* m_pDiagram3DAppearance; /**< Pointer to chart diagram 3d
															 appearance object.*/
	CXTPChartContentAppearance* m_pContentAppearance;	 /**< Pointer to chart content appearance
																object.*/
	CXTPChartPalette* m_pPalette;						  /**< Pointer to chart palette object.*/

	CXTPChartSeriesStyleAppearance* m_pSeriesStyleAppearance;
	CXTPChartFinanceStyleAppearance* m_pFinanceStyleAppearance; /**< Pointer to chart financial
																	 content appearance object.*/
	CXTPChartPieStyleAppearance* m_pPieStyleAppearance; /**< Pointer to chart Pie content appearance
															 object.*/
};

AFX_INLINE CXTPChartDiagram2DAppearance* CXTPChartAppearance::GetDiagram2DAppearance() const
{
	return m_pDiagram2DAppearance;
}
AFX_INLINE CXTPChartDiagram3DAppearance* CXTPChartAppearance::GetDiagram3DAppearance() const
{
	return m_pDiagram3DAppearance;
}
AFX_INLINE CXTPChartContentAppearance* CXTPChartAppearance::GetContentAppearance() const
{
	return m_pContentAppearance;
}

AFX_INLINE CXTPChartAxisAppearance* CXTPChartDiagram2DAppearance::GetAxisAppearance() const
{
	return m_pAxisAppearance;
}
AFX_INLINE CXTPChartPalette* CXTPChartAppearance::GetPalette() const
{
	return m_pPalette;
}
AFX_INLINE CXTPChartTitleAppearance* CXTPChartContentAppearance::GetTitleAppearance() const
{
	return m_pTitleAppearance;
}
AFX_INLINE CXTPChartLegendAppearance* CXTPChartContentAppearance::GetLegendAppearance() const
{
	return m_pLegendAppearance;
}
AFX_INLINE CXTPChartFinanceStyleAppearance* CXTPChartAppearance::GetFinanceStyleAppearance() const
{
	return m_pFinanceStyleAppearance;
}
AFX_INLINE CXTPChartSeriesStyleAppearance* CXTPChartAppearance::GetSeriesStyleAppearance() const
{
	return m_pSeriesStyleAppearance;
}
AFX_INLINE CXTPChartPieStyleAppearance* CXTPChartAppearance::GetPieStyleAppearance() const
{
	return m_pPieStyleAppearance;
}
AFX_INLINE CXTPChartSeriesLabelAppearance* CXTPChartSeriesStyleAppearance::GetLabelAppearance() const
{
	return m_pLabelAppearance;
}
/** @cond */
#	include "Common/Base/Diagnostic/XTPEnableNoisyWarnings.h"
#endif //#if !defined(__XTPCHARTAPPEARANCE_H__)
/** @endcond */