Introduction
Displaying large amounts of technical data in a chart can be a frustrating task. You can find tons of charting controls with fancy effects and useless features, but when it comes to displaying many curves at once, independently scaled on different axes, most of them fail. Maybe CXGraph is the solution:
CXGraph can display unlimited series of data on multiple axes.
The documentation is sparse, because I do not have the time to write documentation. However, the included demo is hopefully a help in understanding how to use the control.
Features
- unlimited data series
- unlimited axes (your monitor is the limit)
- logarithmic scales
- autoscaling
- automatic/manual axis placement
- nearly every visual aspect can be customized
- legends
- bitmaps
- cursor (add data notation marks by clicking)
- zoom
- pan
- color ranges
- object selection with the mouse
- linear trend
- cubic trend
- nth order polynomial trend
- data notation marks
- moving average (simple, linear, sine-weighted ...)
- property persistence (save and load properties, data and axes)
- Support for Windows CE
- axis markers
- UNICODE support
- polygon filling between curves
- cursor synchronization
- data editing
- measuring mode
Classes
CXGraph
CXGraphDataSerie& SetData(TDataPoint* pValues, long nCount, int nCurve, int nXAxis, int nYAxis, bool bAutoDelete) |
Adds/sets a data series. |
CXGraphAxis& GetXAxis(int nAxis) |
Returns reference to specified X-axis. |
CXGraphAxis& GetYAxis(int nAxis) |
Returns reference to specified y-axis. |
CXGraphDataSerie& GetCurve(int nCurve) |
Returns reference to specified curve. |
bool SelectCurve(int nCurve) |
Selects the specified curve. |
bool SelectXAxis(int nAxis) |
Selects the specified x-axis. |
bool SelectYAxis(int nAxis) |
Selects the specified y-axis. |
int GetXAxisCount() |
Returns x-axis count. |
int GetYAxisCount() |
Returns y-axis count. |
int GetCurveCount() |
Returns curve count. |
void Zoom() |
Zoom-mode. User can zoom into the graph with the mouse. |
void ResetZoom() |
Resets all axes to optimal values. |
void Pan() |
Pan-mode. User can pan the graph with the mouse. |
void NoOp() |
Select-mode. User can select objects with the mouse. |
void Cursor() |
Cursor-mode. A cursor is being displayed showing the values at the current mouse position. |
void Measure() |
Measuring mode. User can measure the distance between two data points. |
void Edit() |
Editing mode. User can edit the curve data. |
CXGraphLabel& InsertLabel(CString cText) |
Inserts a text-label. Returns reference to a CXGraphLabel object. |
void PrintGraph(CDC *pDC) |
Prints the graph. |
void SetBackColor(COLORREF color) |
Sets the chart's backcolor. |
void SetGraphColor(COLORREF color) |
Sets the chart's exterior color. |
void SetInnerColor(COLORREF color) |
Sets the chart's interior color. |
void SetDoubleBuffer(bool bValue) |
Sets double buffering on/off. |
void SetShowLegend(bool bValue) |
Sets legend display on/off. |
void SetLegendAlignment(EAlignment align) |
Sets the legend alignment (left, right). |
void SetSnapCursor(bool bValue) |
Sets snap cursor mode (on/off). |
void SetInteraction(bool bValue) |
Enable/disable interaction. |
bool GetInteraction() |
|
void SetSnapRange(int nValue) |
Sets snap cursor range. |
bool Save(const CString cFile, UINT nFlags) |
Stores chart properties, data and axes. Use one or more of the following values to specify what to be stored:
PERSIST_PROPERTIES: store chart properties.
PERSIST_DATA: store chart data and axes.
PERSIST_OBJECTS: store chart objects (labels, ...). |
bool Load(const CString cFile) |
Loads chart properties, data and axes. |
bool SaveBitmap(const CString cFile) |
Saves the chart as bitmap. |
bool DeleteCurve(int nCurve) |
Deletes the specified curve. |
bool DeleteYAxis(int nAxis) |
Removes the specified y-axis. |
bool DeleteXAxis(int nAxis) |
Removes the specified x-axis. |
int GetZoomDepth() |
Determines the zoom depth (history). |
void RestoreLastZoom() |
Restores the last zoom stage. |
void SetBackgroundBitmap(CBitmap* pBitmap, UINT nFlags) |
Sets a background image. |
void InsertBitmap(CRect rect, CBitmapEx* pBitmap) |
Inserts a bitmap-object. |
CXGraphLabel
SetFont(LOGFONT* pLogFont) |
Sets the label's font. |
SetText(CString cText) |
Sets the label's text. |
SetColor(COLORREF color) |
Sets the label's background color. |
SetTextColor(COLORREF color) |
Sets the label's text color. |
SetBorder(bool bValue) |
Sets the label's border. |
SetTransparent(bool bValue) |
Sets the label's transparency. |
SetAlignment(UINT nValue) |
Sets the label's text alignment. |
SetCurve(int nCurve) |
Links the label to the specified curve. |
CString GetText() |
Returns the label's text. |
COLORREF GetColor() |
Returns the label's background color. |
COLORREF GetTextColor() |
Returns the label's text color. |
bool GetBorder() |
Returns true if label has a border, otherwise false. |
bool GetTransparent() |
Returns true if label is transparent. otherwise false. |
UINT GetAlignment() |
Returns the label's text alignment. |
int GetCurve() |
Returns the label's associated curve (or -1 if not associated). |
CXGraphAxis
See source code
CXGraphDataSerie
See source code
Notifications
XG_YAXISCLICK
XG_XAXISCLICK
XG_CURVECLICK
XG_YAXISDBLCLICK
XG_XAXISDBLCLICK
XG_CURVEDBLCLICK
XG_GRAPHDBLCLICK
XG_RBUTTONUP
XG_CURSORMOVED
Usage
To use this control in your own application, add XGraph10.lib to your project and make sure XGraph10.dll is accessible. Create an instance of CXGraph and call Create on it. Take a look at the sample application for further details.
Credits
- James White - Color button.
- Chris Maunder, Alexander Bischofberger - Color popup.
- Dennis Crain (MSDN) - Routines for line-hit testing.
- Keith Rule -
CMemDC.
- Ishay Sivan (bug fixing).
- Pavel Klocek (bug fixing).
- J.G. Hattingh (parts of Device Context Utilities).
- J�rg Blattner (bug fixing, improvements).
History & Bug fixes
| Date |
Version |
Comment |
| 21 Mar 2002 |
1.00 |
|
| 25 Mar 2002 |
1.01 |
- Fixed
DateTime-bug in cursor mode.
- Fixed crash when adding trend or moving average.
|
| 17 Apr 2002 |
1.02 |
- Panning in cursor mode added.
- Added support for very large and very small numbers.
- Values greater/less than 10E6/10E-6 are now automatically shown in exponential format.
- Completely redesigned autoscaling (only for normal axes,
DateTime types follow).
- Added data notation marks.
- Added Get/Set member functions.
- Added nth-order-polynomial trend.
|
| 20 Sep 2002 |
1.03 |
- Now compiles under VC7.
- Load/save for properties/data/object persistence.
- Lots of bug fixes.
|
| 20 Nov 2003 |
1.04 |
- Added Unicode support.
- Fixed crash when resizing chart to small dimensions.
- Corrected tab-order in property pages.
- Added background bitmaps.
- Added gradient color ranges.
- Added axis markers.
- Added bitmap objects.
|
| 13 Jan 2005 |
1.05 |
- Added support for Windows CE (needs improvement).
- Logarithmic axes (thanks to ...).
- Added polygon filling between two curves.
- Several bugs fixed by Joerg Blattner.
- Added Cursor-Synchronization.
- Curve editing mode.
- Measuring mode.
|
Known issues
- Clipping in print preview still doesn't work.
