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

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

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

class CXTPChartSeriesView;

/**
 * @brief
 * This class abstracts the label of a point series. It is a kind of chart
 * series label.
 */
class _XTP_EXT_CLASS CXTPChartDiagram2DSeriesLabel : public CXTPChartSeriesLabel
{
	DECLARE_DYNAMIC(CXTPChartDiagram2DSeriesLabel);

public:
	/**
	 * @brief
	 * Constructs a CXTPChartDiagram2DSeriesLabel object.
	 */
	CXTPChartDiagram2DSeriesLabel();

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

public:
	void DoPropExchange(CXTPPropExchange* pPX);

protected:
};

/**
 * @brief
 * This class abstracts the view of the label of a point series. It is a kind of chart
 * series label view.
 */
class _XTP_EXT_CLASS CXTPChartDiagram2DSeriesLabelView : public CXTPChartSeriesLabelView
{
public:
	/**
	 * @brief
	 * Constructs a CXTPChartDiagram2DSeriesLabelView object.
	 *
	 * @param pLabel		 The pointer to a chart series label object.
	 * @param pPointView  A pointer to a chart series view.
	 * @param pParentView Parent view pointer.
	 */
	CXTPChartDiagram2DSeriesLabelView(CXTPChartSeriesLabel* pLabel,
									  CXTPChartSeriesPointView* pPointView,
									  CXTPChartElementView* pParentView);

	/**
	 * @brief
	 * This function creates a CXTPChartDeviceCommand object. This object
	 * represents the rendering of the chart series label.
	 *
	 * @param pDC Pointer to a CXTPChartDeviceContext object.
	 *
	 * @return Returns a pointer to a CXTPChartDeviceCommand object. This polymorphic object
	 *		  handles the rendering of an element in the chart. Here it handles the drawing
	 *		  of the chart series label.
	 */
	virtual CXTPChartDeviceCommand* CreateDeviceCommand(CXTPChartDeviceContext* pDC);

	/**
	 * @brief
	 * This function creates a CXTPChartDeviceCommand object. This object
	 * represents the rendering of the chart series label.
	 *
	 * @param pDC Pointer to a CXTPChartDeviceContext object.
	 * @param ptCenterPoint Center point.
	 *
	 * @return Returns a pointer to a CXTPChartDeviceCommand object. This polymorphic object
	 *		  handles the rendering of an element in the chart. Here it handles the drawing
	 *		  of the chart series label.
	 */
	virtual CXTPChartDeviceCommand* CreateDeviceCommand(CXTPChartDeviceContext* pDC,
														CXTPChartPointF ptCenterPoint);

	/**
	 * @brief
	 * This function creates a CXTPChartDeviceCommand object. This object
	 * represents the rendering of the chart series label.
	 *
	 * @param pDC Pointer to a CXTPChartDeviceContext object.
	 * @param ptCenterPoint Center point.
	 * @param text Text.
	 *
	 * @return Returns a pointer to a CXTPChartDeviceCommand object. This polymorphic object
	 *		  handles the rendering of an element in the chart. Here it handles the drawing
	 *		  of the chart series label.
	 */
	virtual CXTPChartDeviceCommand* CreateDeviceCommand(CXTPChartDeviceContext* pDC,
														CXTPChartPointF ptCenterPoint,
														const CXTPChartString& text);

	/**
	 * @brief
	 * This function creates a CXTPChartDeviceCommand object. This object
	 * represents the rendering of the chart series label.
	 *
	 * @param pDC Pointer to a CXTPChartDeviceContext object.
	 * @param text Text.
	 * @param ptAnchorPoint Anchor point.
	 * @param dAnchorAngle Anchor angle.
	 *
	 * @return Returns a pointer to a CXTPChartDeviceCommand object. This polymorphic object
	 *		  handles the rendering of an element in the chart. Here it handles the drawing
	 *		  of the chart series label.
	 */
	virtual CXTPChartDeviceCommand* CreateDeviceCommand(CXTPChartDeviceContext* pDC,
														const CXTPChartPointF& ptAnchorPoint,
														double dAnchorAngle,
														const CXTPChartString& text);

	/**
	 * @brief
	 * This function calculates the anchor point of the label stem.
	 *
	 * @return A CXTPChartPointF object denoting the anchor point.
	 */
	virtual CXTPChartPointF GetAnchorPoint() const;
	virtual double GetAnchorAngle() const;

	virtual void CalculateLayout(CXTPChartDeviceContext* pDC);
	void CalculateLayout(CXTPChartDeviceContext* pDC, CXTPChartPointF ptCenterPoint);

	void CalculateLayout(CXTPChartDeviceContext* pDC, const CXTPChartPointF& ptAnchorPoint,
						 double dAnchorAngle, const CXTPChartString& text);
	void CalculateLayout(CXTPChartDeviceContext* pDC, CXTPChartPointF ptCenterPoint,
						 const CXTPChartString& text);

protected:
	CRect GetPaneRect() const;
};
/** @cond */
#	include "Common/Base/Diagnostic/XTPEnableNoisyWarnings.h"
#endif //#if !defined(__XTPCHARTDIAGRAM2DSERIESLABEL_H__)
	   /** @endcond */