You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

419 lines
15 KiB
C

2 years ago
// XTPChartAxisView.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(__XTPCHARTAXISVIEW_H__)
#define __XTPCHARTAXISVIEW_H__
//}}AFX_CODEJOCK_PRIVATE
#if _MSC_VER >= 1000
#pragma once
#endif // _MSC_VER >= 1000
class CXTPChartDiagram2DAxisView;
class CXTPChartAxisRange;
class CXTPChartAxis;
class CXTPChartSeriesView;
//===========================================================================
// Summary:
// This class represents a tick mark in the axis.
// Remarks:
// See Also:
//===========================================================================
class _XTP_EXT_CLASS CXTPChartAxisViewTick
{
public:
double m_dValue; //The value of the tick mark.
CXTPChartString m_strLabel; //The tick mark lablel.
CSize m_szBounds; //The boundary.
CXTPChartSizeF m_szLabel; //The size of the label.
};
class _XTP_EXT_CLASS CXTPChartAxisView : public CXTPChartElementView
{
protected:
//-----------------------------------------------------------------------
// Summary:
// Constructs a CXTPChartAxisView object.
// Parameters:
// pAxis - Pointer to a CXTPChartAxis object.
// pParentView - Pointer to a CXTPChartElementView object.
// Remarks:
// See Also:
//-----------------------------------------------------------------------
CXTPChartAxisView(CXTPChartAxis* pAxis, CXTPChartElementView* pParentView);
~CXTPChartAxisView();
public:
//-------------------------------------------------------------------------
// Summary:
// Returns associated axis
// Remarks:
// See Also:
//-------------------------------------------------------------------------
CXTPChartAxis* GetAxis() const;
public:
virtual void CreateView(CXTPChartDeviceContext* pDC) = 0;
virtual void CalcSize(CXTPChartDeviceContext* pDC, CRect rcDiagram) = 0;
virtual void SetBounds(CXTPChartDeviceContext* pDC, CRect rcBounds) = 0;
public:
//-------------------------------------------------------------------------
// Summary:
// This function returns the spacing of the grid lines.
// Returns:
// A double value denoting the grid seperation.
// Remarks:
// See Also:
//-------------------------------------------------------------------------
double GetGridSpacing() const;
public:
double GetRangeMinValue() const;
double GetRangeMaxValue() const;
double GetViewRangeMinValue() const;
double GetViewRangeMaxValue() const;
double GetAxisRangeMinValue() const;
double GetAxisRangeMaxValue() const;
double ValueToAxis(double dValue) const;
double AxisToValue(double dValue) const;
public:
void AddLegendItems();
protected:
//-------------------------------------------------------------------------
// Summary:
// This function calculates the spacing of the grid lines.
// Parameters:
// nAxisRangeDelta - The difference between the min and max value of the range.
// nScreenDelta - The length of the diagram, if width is greater an height
// then nscreenDelta is width and vice versa.
// nGridSpacingFactor - The grid spacing factor.
// Returns:
// A double value denoting the grid separation.
// Remarks:
// See Also:
//-------------------------------------------------------------------------
double CalculateGridSpacing(double nAxisRangeDelta, double nScreenDelta, double nGridSpacingFactor);
public:
CArray<CXTPChartSeriesView*, CXTPChartSeriesView*> m_arrSeries;
CXTPChartAxis* m_pAxis; //The chart axis
double m_dGridSpacing; //The grid spacing.
};
//===========================================================================
// Summary:
// This class abstracts the view of a chart axis and its child items in
// a bounding rectangle context.
// Remarks:
// See Also:
//===========================================================================
class _XTP_EXT_CLASS CXTPChartDiagram2DAxisView : public CXTPChartAxisView
{
public:
//-----------------------------------------------------------------------
// Summary:
// Constructs a CXTPChartDiagram2DAxisView object.
// Parameters:
// pAxis - Pointer to a CXTPChartAxis object.
// pParentView - Pointer to a CXTPChartElementView object.
// Remarks:
// See Also:
//-----------------------------------------------------------------------
CXTPChartDiagram2DAxisView(CXTPChartAxis* pAxis, CXTPChartElementView* pParentView);
~CXTPChartDiagram2DAxisView();
public:
CRect GetBounds() const;
public:
//-------------------------------------------------------------------------
// Summary:
// Override this function create a CXTPChartDeviceCommand object, this object
// represents the rendering of an axis in the chart.
// Parameters:
// pDC - Pointer to a CXTPChartDeviceContext object.
// Returns:
// Returns CXTPChartDeviceCommand object, this object handles
// the rendering of an element in the chart.Here it handles
// the drawing of an axis.
// Remarks:
// See Also:
//-------------------------------------------------------------------------
virtual CXTPChartDeviceCommand* CreateDeviceCommand(CXTPChartDeviceContext* pDC);
//-------------------------------------------------------------------------
// Summary:
// This function create a CXTPChartDeviceCommand object, this object
// represents the rendering of the grid lines the chart axis.
// Parameters:
// pDC - Pointer to a CXTPChartDeviceContext object.
// rcPane - The bounding rectange.
// Returns:
// Returns a pointer to CXTPChartDeviceCommand object, this polymorphic object
// handles the rendering of an element in the chart.Here it handles the drawing
// of the grid lines in an axis.
// Remarks:
// See Also:
//-------------------------------------------------------------------------
CXTPChartDeviceCommand* CreateGridLinesDeviceCommand(CXTPChartDeviceContext* pDC, CRect rcPane);
//-------------------------------------------------------------------------
// Summary:
// This function create a CXTPChartDeviceCommand object, this object
// represents the rendering of the interlaced strips in the chart.
// Parameters:
// pDC - Pointer to a CXTPChartDeviceContext object.
// rcPane - The bounding rectange.
// Returns:
// Returns a pointer to CXTPChartDeviceCommand object, this polymorphic object
// handles the rendering of an element in the chart.Here it handles the drawing
// of the interlaced strips in the chart.
// Remarks:
// See Also:
//-------------------------------------------------------------------------
CXTPChartDeviceCommand* CreateInterlacedDeviceCommand(CXTPChartDeviceContext* pDC, CRect rcPane);
//-------------------------------------------------------------------------
// Summary:
// This function create a CXTPChartDeviceCommand object, this object
// represents the rendering of the tick marks in the axis.
// Parameters:
// pDC - Pointer to a CXTPChartDeviceContext object.
// rcPane - The bounding rectange.
// Returns:
// Returns a pointer to CXTPChartDeviceCommand object, this polymorphic object
// handles the rendering of an element in the chart.Here it handles the drawing
// of the tick marks in the axis.
// Remarks:
// See Also:
//-------------------------------------------------------------------------
CXTPChartDeviceCommand* CreateTickMarksDeviceCommand(CXTPChartDeviceContext* pDC);
CXTPChartDeviceCommand* CreateScrollBarDeviceCommand(CXTPChartDeviceContext* pDC);
void PerformMouseWheel(short zDelta, CPoint pt);
void PerformPaneDragging(int dx, int dy);
void OnLButtonDown(UINT nFlags, CPoint point);
void OnMouseMove(UINT nFlags, CPoint point);
//-------------------------------------------------------------------------
// Summary:
// This function create a CXTPChartDeviceCommand object, this object
// represents the rendering of the labels in the axis.
// Parameters:
// pDC - Pointer to a CXTPChartDeviceContext object.
// rcPane - The bounding rectange.
// Returns:
// Returns a pointer to CXTPChartDeviceCommand object, this polymorphic object
// handles the rendering of an element in the chart.Here it handles the drawing
// of the labels in the axis.
// Remarks:
// See Also:
//-------------------------------------------------------------------------
CXTPChartDeviceCommand* CreateLabelsDeviceCommand(CXTPChartDeviceContext* pDC);
//-------------------------------------------------------------------------
// Summary:
// This function create a CXTPChartDeviceCommand object, this object
// represents the rendering of the axis title.
// Parameters:
// pDC - Pointer to a CXTPChartDeviceContext object.
// rcPane - The bounding rectange.
// Returns:
// Returns a pointer to CXTPChartDeviceCommand object, this polymorphic object
// handles the rendering of an element in the chart.Here it handles the drawing
// of the axis title.
// Remarks:
// See Also:
//-------------------------------------------------------------------------
CXTPChartDeviceCommand* CreateTitleDeviceCommand(CXTPChartDeviceContext* pDC);
//-------------------------------------------------------------------------
// Summary:
// This function create a CXTPChartDeviceCommand object, this object
// represents the rendering of the contant lines perpendicular to an axis.
// Parameters:
// pDC - Pointer to a CXTPChartDeviceContext object.
// rcPane - The bounding rectange.
// Returns:
// Returns a pointer to CXTPChartDeviceCommand object, this polymorphic object
// handles the rendering of an element in the chart.Here it handles the drawing
// of the contant lines perpendicular to an axis.
// Remarks:
// See Also:
//-------------------------------------------------------------------------
CXTPChartDeviceCommand* CreateConstantLinesDeviceCommand(CXTPChartDeviceContext* pDC, CRect rcPane, BOOL bBehind);
//-------------------------------------------------------------------------
// Summary:
// This function create a CXTPChartDeviceCommand object, this object
// represents the rendering of the strips parallel to an axis.
// Parameters:
// pDC - Pointer to a CXTPChartDeviceContext object.
// rcPane - The bounding rectange.
// Returns:
// Returns a pointer to CXTPChartDeviceCommand object, this polymorphic object
// the rendering of an element in the chart.Here it handles the drawing
// handles of the strips parallel to an axis.
// Remarks:
// See Also:
//-------------------------------------------------------------------------
CXTPChartDeviceCommand* CreateStripsDeviceCommand(CXTPChartDeviceContext* pDC, CRect rcPane);
//-------------------------------------------------------------------------
// Summary:
// Call this function to create chart axis view.
// Parameters:
// pDC - The chart device context object.
// Remarks:
// This function create the view of an axis and its contituent elemets
// like contant lines and strips.
// See Also:
//-------------------------------------------------------------------------
void CreateView(CXTPChartDeviceContext* pDC);
//-------------------------------------------------------------------------
// Summary:
// This function calculates the size of axis, including the constituent elements
// like, tick marks, labels amd axis title etc.
// Parameters:
// pDC - The chart device context object.
// rcDiagram - The rectangle of the diagram.
// Remarks:
// See Also:
//-------------------------------------------------------------------------
void CalcSize(CXTPChartDeviceContext* pDC, CRect rcDiagram);
//-------------------------------------------------------------------------
// Summary:
// This function the bounds for the axis.
// Parameters:
// pDC - The chart device context object.
// rcBounds - The bounding rectangle.
// Remarks:
// See Also:
//-------------------------------------------------------------------------
void SetBounds(CXTPChartDeviceContext* pDC, CRect rcBounds);
//-------------------------------------------------------------------------
// Summary:
// Call this function to get a point on the axis from a value within the range.
// Parameters:
// nValue - A point within the axis range.
// Remarks:
// See Also:
//-------------------------------------------------------------------------
double ValueToPoint(double nValue) const;
double PointToValue(int nPoint) const;
//-------------------------------------------------------------------------
// Summary:
// Call this function to get the distance of a point from the axis origin.
// Parameters:
// nDistance - A point within the axis range.
// Remarks:
// See Also:
//-------------------------------------------------------------------------
double DistanceToPoint(double nDistance) const;
double GetScale() const;
BOOL IsScollBarVisible() const;
//-------------------------------------------------------------------------
// Summary:
// This function returns the size of the axis.
// Returns:
// x - A point within the axis range.
// Remarks:
// See Also:
//-------------------------------------------------------------------------
int GetSize() const;
//-------------------------------------------------------------------------
// Summary:
// This function returns whether the the axis is vertical.
// Returns:
// TRUE if the axis is vertical and FALSE if the axis is horizontal.
// Remarks:
// See Also:
//-------------------------------------------------------------------------
BOOL IsVertical() const;
protected:
//-------------------------------------------------------------------------
// Summary:
// This function create the axis tick marks.
// Parameters:
// pDC - The device context.
// rcDiagram - The bounding rectangle of the diagram.
// Remarks:
// See Also:
//-------------------------------------------------------------------------
void CreateTickMarks(CXTPChartDeviceContext* pDC, CRect rcDiagram);
public:
CArray<CXTPChartAxisViewTick, CXTPChartAxisViewTick&> m_arrTicks; //The collection of tick marks.
CArray<double, double&> m_arrMinorTicks;
protected:
CRect m_rcBounds; //The diagram boundary.
int m_nSize; //The axis size;
CPoint m_ptOldPosition;
CXTPChartRectF m_rcScrollBar;
CXTPChartRectF m_rcThumb;
};
AFX_INLINE CXTPChartAxis* CXTPChartAxisView::GetAxis() const {
return m_pAxis;
}
AFX_INLINE int CXTPChartDiagram2DAxisView::GetSize() const {
return m_nSize;
}
AFX_INLINE CRect CXTPChartDiagram2DAxisView::GetBounds() const {
return m_rcBounds;
}
AFX_INLINE double CXTPChartAxisView::GetGridSpacing() const {
return m_dGridSpacing;
}
#endif //#if !defined(__XTPCHARTAXISVIEW_H__)