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

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

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

class CXTPChartDiagramView;
class CXTPChartSeries;

/**
 * @brief
 * This class abstracts the pie series style. This class is a kind of
 * CXTPChartPieSeriesStyleBase.
 *
 * @details
 * A pie chart (or a circle graph) is a circular chart divided into sectors,
 * illustrating percents. In a pie chart, the arc length of each sector (and
 * consequently its central angle and area), is proportional to the quantity
 * it represents. Together, the sectors create a full disk.
 */
class _XTP_EXT_CLASS CXTPChart3dPieSeriesStyle : public CXTPChartPieSeriesStyleBase
{
	/** @cond */
	DECLARE_SERIAL(CXTPChart3dPieSeriesStyle)
	/** @endcond */
public:
	/**
	 * @brief
	 * Constructs a CXTPChart3dPieSeriesStyle object.
	 */
	CXTPChart3dPieSeriesStyle();

	/**
	 * @brief
	 * Call this function to create the pie diagram object.
	 *
	 * @return
	 * A pointer to a CXTPChartDiagram object which points to the newly created
	 * CXTPChart3dPieDiagramBase object.
	 */
	virtual CXTPChartDiagram* CreateDiagram();

	/**
	 * @brief
	 * Call this function to create the view of the pie series.
	 *
	 * @param pSeries       A pointer to the chart series  object.
	 * @param pDiagramView  A pointer to the diagram view object.
	 *
	 * @return
	 * Returns a pointer to the associated series view object.
	 */
	virtual CXTPChartSeriesView* CreateView(CXTPChartSeries* pSeries,
											CXTPChartDiagramView* pDiagramView);

	/**
	 * @brief
	 * Obtains rotation parameters for 3D chart.
	 *
	 * @return
	 * Rotation parameters for 3D chart.
	 *
	 * @see
	 * Set3dRotation
	 */
	virtual CXTPChart3dRotation Get3dRotation() const;

	/**
	 * @brief
	 * Obtains depth value.
	 *
	 * @return
	 * Depth value.
	 *
	 * @see
	 * SetDepth
	 */
	virtual int GetDepth() const;

	/**
	 * @brief
	 * Sets depth value.
	 *
	 * @param dDepth New depth value.
	 *
	 * @see
	 * GetDepth
	 */
	void SetDepth(int dDepth);

	/**
	 * @brief
	 * Checks if the chart has to be drawn as a torus instead of a pie.
	 *
	 * @return
	 * TRUE if the chart is to be drawn as a torus, FALSE otherwise.
	 *
	 * @see
	 * SetTorus
	 */
	BOOL IsTorus() const;

	/**
	 * @brief
	 * Sets torus appearance of the chart.
	 *
	 * @param bTorus If TRUE, then the chart will be drawn as a torus.
	 *				If FALSE, then the chart will be drawn as a pie.
	 *
	 * @see
	 * IsTorus
	 */
	void SetTorus(BOOL bTorus);

	/**
	 * @brief
	 * Call this member function to Store/Load an event using the
	 * specified data object.
	 *
	 * @param pPX Source or destination CXTPPropExchange data object reference.
	 *
	 * @details
	 * This member function is used to store event data to or load event
	 * data from storage.
	 */
	virtual void DoPropExchange(CXTPPropExchange* pPX);

#	ifdef _XTP_ACTIVEX
public:
	/** @cond */
	DECLARE_DISPATCH_MAP()
	DECLARE_INTERFACE_MAP()
	DECLARE_OLETYPELIB_EX(CXTPChart3dPieSeriesStyle);
	DECLARE_OLECREATE_EX(CXTPChart3dPieSeriesStyle);
	/** @endcond */
#	endif

private:
	int OleGetDepth();
	void OleSetDepth(int dDepth);
	BOOL OleGetIsTorus();
	void OleSetTorus(BOOL bTorus);

private:
	int m_nDepth;
	BOOL m_bTorus;
};

AFX_INLINE int CXTPChart3dPieSeriesStyle::GetDepth() const
{
	return m_nDepth;
}

AFX_INLINE void CXTPChart3dPieSeriesStyle::SetDepth(int nDepth)
{
	m_nDepth = nDepth;
	OnChartChanged();
}

AFX_INLINE BOOL CXTPChart3dPieSeriesStyle::IsTorus() const
{
	return m_bTorus;
}

AFX_INLINE void CXTPChart3dPieSeriesStyle::SetTorus(BOOL bTorus)
{
	m_bTorus = bTorus;
	OnChartChanged();
}
/** @cond */
#	include "Common/Base/Diagnostic/XTPEnableNoisyWarnings.h"
#endif //#if !defined(__XTPCHART3DPIESERIESSTYLE_H__)
	   /** @endcond */