FH98ViewOnPlaneSoftware/Src/XtremeToolKitPro/Chart/Drawing/XTPChartTextDeviceCommand.h

// XTPChartTextDeviceCommand.h
//
// This file is a part of the XTREME TOOLKIT PRO MFC class library.
// (c)1998-2012 Codejock Software, All Rights Reserved.
//
// THIS SOURCE FILE IS THE PROPERTY OF CODEJOCK SOFTWARE AND IS NOT TO BE
// RE-DISTRIBUTED BY ANY MEANS WHATSOEVER WITHOUT THE EXPRESSED WRITTEN
// CONSENT OF CODEJOCK SOFTWARE.
//
// THIS SOURCE CODE CAN ONLY BE USED UNDER THE TERMS AND CONDITIONS OUTLINED
// IN THE XTREME TOOLKIT PRO LICENSE AGREEMENT. CODEJOCK SOFTWARE GRANTS TO
// YOU (ONE SOFTWARE DEVELOPER) THE LIMITED RIGHT TO USE THIS SOFTWARE ON A
// SINGLE COMPUTER.
//
// CONTACT INFORMATION:
// support@codejock.com
// http://www.codejock.com
//
/////////////////////////////////////////////////////////////////////////////

//{{AFX_CODEJOCK_PRIVATE
#if !defined(__XTPCHARTTEXTDEVICECOMMAND_H__)
#define __XTPCHARTTEXTDEVICECOMMAND_H__
//}}AFX_CODEJOCK_PRIVATE

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


class CXTPMarkupUIElement;

//===========================================================================
// Summary:
//     This class represents a text device command,which is a kind of CXTPChartDeviceCommand.
//     It specifically handles the rendering of texts in a chart.
// Remarks:
//===========================================================================
class _XTP_EXT_CLASS CXTPChartTextDeviceCommand : public CXTPChartDeviceCommand
{
public:
	//-----------------------------------------------------------------------
	// Summary:
	//     Constructs a CXTPChartTextDeviceCommand object.
	// Parameters:
	//     strText   - The text to be rendered.
	//     pFont     - The font used to render.
	//     color     - The color of the text.
	// Remarks:
	//-----------------------------------------------------------------------
	CXTPChartTextDeviceCommand(const CXTPChartString& strText, CXTPChartFont* pFont, const CXTPChartColor& color);

protected:

	//-----------------------------------------------------------------------
	// Summary:
	//     This is a virtual function override of base class CXTPChartDeviceContext,
	//     act polymorphically to do the actual drawing of the chart element, to which
	//     this device command is associated with.
	// Parameters:
	//     pDC      - The device context of the chart.
	// Remarks:
	//-----------------------------------------------------------------------
	virtual void ExecuteOverride(CXTPChartDeviceContext* pDC);

	//-----------------------------------------------------------------------
	// Summary:
	//     This function do the actual drawing of the chart element, to which
	//     this device command is associated with, here it renders the text.
	// Parameters:
	//     pDC      - The device context of the chart.
	// Remarks:
	//-----------------------------------------------------------------------
	virtual void ExecuteInternal(CXTPChartDeviceContext* pDC);

protected:
	CXTPChartString m_strText;   //The string to be rendered.
	CXTPChartFont* m_pFont;      //The font used to render the text.
	CXTPChartColor m_color;      //The color of the text.

};


//===========================================================================
// Summary:
//     This class represents a text device command,which is a kind of CXTPChartDeviceCommand.
//     This class does handles the smoothing of texts in chart and by using antialising.
// Remarks:
//===========================================================================
class _XTP_EXT_CLASS CXTPChartTextAntialiasingDeviceCommand : public CXTPChartDeviceCommand
{
public:
	//-----------------------------------------------------------------------
	// Summary:
	//     Constructs a CXTPChartTextAntialiasingDeviceCommand object.
	// Parameters:
	//     bAntialias   - TRUE if the antialiasing to be enabled, FALSE to not use
	//                    the antialiasing.The default value is TRUE.
	// Remarks:
	//-----------------------------------------------------------------------
	CXTPChartTextAntialiasingDeviceCommand(BOOL bAntialias = TRUE);

protected:

	//-----------------------------------------------------------------------
	// Summary:
	//     It is a virtual function override called just befor the drawing operation.
	//     Here it does some initial process to enable antialiasing to texts.
	// Parameters:
	//     pDC   - The chart device context.
	// Remarks:
	//-----------------------------------------------------------------------
	void BeforeExecute(CXTPChartDeviceContext* pDC);

	//-----------------------------------------------------------------------
	// Summary:
	//     It is a virtual function override called just after the drawing operation.
	//     Here it does some post process to enable antialiasing to texts.
	// Parameters:
	//     pDC   - The chart device context.
	// Remarks:
	//-----------------------------------------------------------------------
	void AfterExecute(CXTPChartDeviceContext* pDC);

protected:
	BOOL m_bAntiAlias;      //TRUE if antialiasing is enabled, FALSE if antialiasing is not used.
	int m_nOldTextRenderingHint;
};

//===========================================================================
// Summary:
//     This class represents a bounded text device command,which is a kind of
//     CXTPChartDeviceCommand.It handles the rendering of bounded texts in a chart.
// Remarks:
//===========================================================================
class _XTP_EXT_CLASS CXTPChartBoundedTextDeviceCommand : public CXTPChartTextDeviceCommand
{
public:
	//-----------------------------------------------------------------------
	// Summary:
	//     Constructs a CXTPChartBoundedTextDeviceCommand object.
	// Parameters:
	//     strText   - The text to be rendered.
	//     pFont     - The font used to render.
	//     color     - The color of the text.
	//     rectangle - The text bounds.
	// Remarks:
	//-----------------------------------------------------------------------
	CXTPChartBoundedTextDeviceCommand(const CXTPChartString& strText, CXTPChartFont* pFont, const CXTPChartColor& color, const CXTPChartRectF& rectangle);

protected:
	//-----------------------------------------------------------------------
	// Summary:
	//     This function do the actual drawing of the chart element, to which
	//     this device command is associated with, here it renders the text inside
	//     a rectangle.
	// Parameters:
	//     pDC      - The device context of the chart.
	// Remarks:
	//-----------------------------------------------------------------------
	virtual void ExecuteInternal(CXTPChartDeviceContext* pDC);

	virtual CXTPChartElement* HitTest(CPoint point, CXTPChartElement* pParent) const;

protected:
	CXTPChartRectF m_rect;   //The bounding rectangle of the text.
};


class CXTPChartMarkupElementDeviceCommand : public CXTPChartDeviceCommand
{
public:
	//-----------------------------------------------------------------------
	// Summary:
	//     Constructs a CXTPChartMarkupElementDeviceCommand object.
	// Parameters:
	//     strText   - The text to be rendered.
	//     pFont     - The font used to render.
	//     color     - The color of the text.
	//     rectangle - The text bounds.
	// Remarks:
	//-----------------------------------------------------------------------
	CXTPChartMarkupElementDeviceCommand(CXTPMarkupUIElement* pMarkupUIElement, CXTPChartFont* pFont, const CXTPChartColor& color, const CXTPChartRectF& rectangle);
	~CXTPChartMarkupElementDeviceCommand();

public:
	virtual void ExecuteOverride(CXTPChartDeviceContext* pDC);

	static CXTPChartSizeF AFX_CDECL MeasureElement(CXTPChartDeviceContext* pDC, CXTPMarkupUIElement* pMarkupUIElement, CXTPChartFont* pFont);

	CXTPChartElement* HitTest(CPoint point, CXTPChartElement* pParent) const;

protected:
	CXTPChartRectF m_rect;   //The bounding rectangle of the text.
	CXTPMarkupUIElement* m_pMarkupUIElement;
	CXTPChartColor m_color;
	CXTPChartFont* m_pFont;
};

#endif //#if !defined(__XTPCHARTTEXTDEVICECOMMAND_H__)