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

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

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

/** @cond */

class _XTP_EXT_CLASS CXTPChartFunnelDiagramBaseImpl
{
protected:
	virtual ~CXTPChartFunnelDiagramBaseImpl()
	{
	}

	virtual void CalculateSeriesLayout(CXTPChartDeviceContext* pDC, CXTPChartDiagramView* pView);
};

/** @endcond */

/**
 * @brief
 * This class abstracts the funnel diagram. This class is a kind of
 * CXTPChartDiagram.
 *
 * @details
 * A funnel chart (or a circle graph) is a circular chart divided into sectors,
 * illustrating percents. In a funnel 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.
 */
template<class BaseDiagram>
class CXTPChartFunnelDiagramBase
	: public BaseDiagram
	, private CXTPChartFunnelDiagramBaseImpl
{
public:
	/**
	 * @brief
	 * Constructs a CXTPChartFunnelDiagramBase object.
	 */
	CXTPChartFunnelDiagramBase();

public:
	/**
	 * @brief
	 * Call this function to create the view of the funnel diagram.
	 *
	 * @param pDC           A pointer to the chart device context.
	 * @param pParent       A pointer to the parent view.
	 *
	 * @return
	 * A pointer to a CXTPChartDiagramView object which points to the newly created
	 * CXTPChartFunnelDiagramView object.
	 */
	virtual CXTPChartDiagramView* CreateView(CXTPChartDeviceContext* pDC,
											 CXTPChartElementView* pParent) = 0;

	/**
	 * @brief
	 * Call this function to calculate the funnel series layout.
	 *
	 * @param pDC           A pointer to the chart device context.
	 * @param pView         A pointer to the diagram view.
	 */
	virtual void CalculateSeriesLayout(CXTPChartDeviceContext* pDC, CXTPChartDiagramView* pView);
};

template<class BaseDiagram>
AFX_INLINE CXTPChartFunnelDiagramBase<BaseDiagram>::CXTPChartFunnelDiagramBase()
{
}

template<class BaseDiagram>
AFX_INLINE void CXTPChartFunnelDiagramBase<BaseDiagram>::CalculateSeriesLayout(
	CXTPChartDeviceContext* pDC, CXTPChartDiagramView* pView)
{
	CXTPChartFunnelDiagramBaseImpl::CalculateSeriesLayout(pDC, pView);
}

typedef CXTPChartFunnelDiagramBase<CXTPChart2dDiagram> CXTPChart2dFunnelDiagramBase;
typedef CXTPChartFunnelDiagramBase<CXTPChart3dDiagram> CXTPChart3dFunnelDiagramBase;
/** @cond */
#	include "Common/Base/Diagnostic/XTPEnableNoisyWarnings.h"
#endif //#if !defined(__XTPCHARTFUNNELDIAGRAMBASE_H__)
	   /** @endcond */