crossing charts developer's reference guide · crossing charts allows you to render different...

212
Crossing Charts .NET Edition Version 15.3 Fast Realtime Rendering Chart Engine Charting component for .NET applications © All Rights Reserved www.crossingcharts.com REFERENCE GUIDE

Upload: others

Post on 27-Jul-2020

34 views

Category:

Documents


2 download

TRANSCRIPT

Page 1: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts .NET Edition

Version 15.3

Fast Realtime Rendering Chart Engine

Charting component for .NET applications

© All Rights Reserved www.crossingcharts.com

REFERENCE GUIDE

Page 2: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

TABLE OF CONTENTS

Introduction .................................................................................................................................... 8

Version history ............................................................................................................................... 9

Installation and Deployment .................................................................................................. 16

Library Usage ............................................................................................................................... 17

Windows application projects ........................................................................................................................ 17

ASP.NET application project (web application) .................................................................................. 18

Populating the Chart and the SeriesFactory helper class ............................................................. 21

Tips ................................................................................................................................................................................. 22

Advanced feature: combo charts ................................................................................................................. 23

Advanced feature: SVG charts (vector charts) .................................................................................... 25

Advanced feature: PDF export (… and chart printing) ................................................................... 29

Advanced feature: serialization .................................................................................................................... 30

Advanced feature: zoom and panning ...................................................................................................... 31

Advanced feature: additional markers with optional labels ........................................................ 32

Sample code for Windows application (VB.NET) ............................................................ 33

Sample code for C# (Windows application) ..................................................................... 35

Sample code: creating charts without using forms (C#) ............................................ 36

Library Quick Reference ........................................................................................................... 37

Properties ................................................................................................................................................................... 37

Methods ....................................................................................................................................................................... 44

Events ........................................................................................................................................................................... 45

Library Reference ....................................................................................................................... 46

Animate ....................................................................................................................................................................... 46

AnimateTo .................................................................................................................................................................. 47

Autorefresh ............................................................................................................................................................... 48

BackColor ................................................................................................................................................................... 49

BackStyle .................................................................................................................................................................... 50

BorderColor ............................................................................................................................................................... 51

BubbleMaxRadius .................................................................................................................................................. 52

BuiltinDialogAllowed ........................................................................................................................................... 53

BuiltinDialogLanguage ....................................................................................................................................... 54

Calculation ................................................................................................................................................................. 55

CalculationLineStyle ............................................................................................................................................ 56

CastShadows ............................................................................................................................................................ 57

ChartAddNew ........................................................................................................................................................... 58

Page 3: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 3 of 212

ChartAdd ..................................................................................................................................................................... 59

ChartItem ................................................................................................................................................................... 60

ChartRemove ............................................................................................................................................................ 61

CreateAnimatedGIF .............................................................................................................................................. 62

CreatePDF .................................................................................................................................................................. 63

CreateSVG .................................................................................................................................................................. 64

DataSource ................................................................................................................................................................ 65

DataSourceMode .................................................................................................................................................... 66

DataTableBackColor ............................................................................................................................................. 67

DataTableColor ........................................................................................................................................................ 68

DataTableFont ......................................................................................................................................................... 69

DataTableText ......................................................................................................................................................... 70

EnableDragItems ................................................................................................................................................... 71

EnableDragItemsWithControlKey ................................................................................................................ 72

EnableRotationOnSurfaceArea ...................................................................................................................... 73

Depth............................................................................................................................................................................. 74

GanttSetToday ......................................................................................................................................................... 75

GanttSetTodayLabel ............................................................................................................................................. 76

GaugeBackStyle ...................................................................................................................................................... 77

GaugeBigTickStyle ................................................................................................................................................ 78

GaugeBorderStyle ................................................................................................................................................. 79

GaugeCentralCircleBackStyle ......................................................................................................................... 80

GaugeCentralCircleBorderStyle..................................................................................................................... 81

GaugeCentralCircleRadius ................................................................................................................................ 82

GaugeCentralCircleRadius ................................................................................................................................ 83

GaugeMarginFactor .............................................................................................................................................. 84

GaugeNeedleStyle ................................................................................................................................................. 85

GaugeSmallTickStyle ........................................................................................................................................... 86

GridBackgroundImage ....................................................................................................................................... 87

GridBackgroundImageTransparency ......................................................................................................... 88

GridLineStyle ............................................................................................................................................................ 89

HoleSize ....................................................................................................................................................................... 90

HotSpotBackColor ................................................................................................................................................. 91

HotSpotBackColor ................................................................................................................................................. 92

HotSpotColor ............................................................................................................................................................ 93

HotSpotsCrossLineStyle..................................................................................................................................... 94

HotSpotsEnabled .................................................................................................................................................... 95

Page 4: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 4 of 212

HotSpotsDateTimeFormat ................................................................................................................................ 96

HotSpotsNumericFormat ................................................................................................................................... 97

HotSpotHitTestPrecision ................................................................................................................................... 98

Image ........................................................................................................................................................................... 99

ItemsHighlight ...................................................................................................................................................... 100

ItemsLegend .......................................................................................................................................................... 101

LegendAlignment ................................................................................................................................................. 102

LegendBackColor ................................................................................................................................................. 103

LegendColor ............................................................................................................................................................ 104

LegendColorChartSteps ................................................................................................................................... 105

LegendFont .............................................................................................................................................................. 106

LegendText .............................................................................................................................................................. 107

LicenseeIdentifier ............................................................................................................................................... 108

MarginBottom ........................................................................................................................................................ 109

MarginLeft ................................................................................................................................................................ 110

MarginRight ............................................................................................................................................................. 111

MarginTop ................................................................................................................................................................ 112

MarkHighest ............................................................................................................................................................ 113

MarkLowest ............................................................................................................................................................. 114

PieBorderStyle ....................................................................................................................................................... 115

PointSize ................................................................................................................................................................... 116

PointStyle ................................................................................................................................................................. 117

Quality ........................................................................................................................................................................ 118

QualityMarkers ...................................................................................................................................................... 119

Reset ........................................................................................................................................................................... 120

Resolution ................................................................................................................................................................ 121

SelectionAddItem ................................................................................................................................................ 122

SelectionAutoHighlight .................................................................................................................................... 123

SelectionAutoHighlightColor ......................................................................................................................... 124

Series .......................................................................................................................................................................... 125

SeriesColor .............................................................................................................................................................. 126

SeriesBorderStyle ................................................................................................................................................ 127

SeriesFillStyle ........................................................................................................................................................ 129

SeriesLegend .......................................................................................................................................................... 130

SeriesLineStyle ..................................................................................................................................................... 131

SeriesPicture .......................................................................................................................................................... 132

SettingsFromString ............................................................................................................................................ 133

Page 5: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 5 of 212

ShadowColored ..................................................................................................................................................... 134

ShadowOffset ......................................................................................................................................................... 135

ShadowSmooth ..................................................................................................................................................... 136

ShowDataTable ..................................................................................................................................................... 137

ShowDividerX......................................................................................................................................................... 138

ShowItemsLegend .............................................................................................................................................. 139

ShowLegend ........................................................................................................................................................... 140

ShowLegendInDataTable ................................................................................................................................ 141

ShowPoints .............................................................................................................................................................. 142

ShowSolidColors .................................................................................................................................................. 143

ShowSurface3d ..................................................................................................................................................... 144

ShowValues ............................................................................................................................................................. 145

ShowValuesMax .................................................................................................................................................... 146

ShowValuesMin ..................................................................................................................................................... 147

ShowXAxis ............................................................................................................................................................... 148

SlantX ......................................................................................................................................................................... 149

SlantY ......................................................................................................................................................................... 150

Style ............................................................................................................................................................................. 151

Thickness .................................................................................................................................................................. 152

Title .............................................................................................................................................................................. 153

TitleColor .................................................................................................................................................................. 154

TitleFont .................................................................................................................................................................... 155

ValuesAlignment .................................................................................................................................................. 156

ValuesBackColor ................................................................................................................................................... 157

ValuesColor ............................................................................................................................................................. 158

ValuesFont ............................................................................................................................................................... 159

ValuesFormat ......................................................................................................................................................... 160

ValuesLocationStyle ........................................................................................................................................... 161

ValuesStyle .............................................................................................................................................................. 162

WallsBackColorPrincipal .................................................................................................................................. 163

WallsBackColorSecondary .............................................................................................................................. 164

WallsBackStyle ...................................................................................................................................................... 165

WallsStyle ................................................................................................................................................................ 166

XAxisColor ................................................................................................................................................................ 167

XAxisDirection ....................................................................................................................................................... 168

XAxisDividersCount ............................................................................................................................................ 169

XAxisHeight ............................................................................................................................................................. 170

Page 6: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 6 of 212

XAxisLabelsRotated ........................................................................................................................................... 171

XAxisLabelsRotated90 ...................................................................................................................................... 172

XAxisNumericFormat ......................................................................................................................................... 173

XAxisScaleMaximum .......................................................................................................................................... 174

XAxisScaleMaximumDateTime .................................................................................................................... 175

XAxisScaleMinimum ........................................................................................................................................... 176

XAxisScaleMinimumCalculated .................................................................................................................... 177

XAxisScaleMaximumCalculated .................................................................................................................. 178

XAxisScaleMinimumDateTime...................................................................................................................... 179

XAxisScaleMode .................................................................................................................................................... 180

XAxisTitle ................................................................................................................................................................. 181

XAxisTitleFont ....................................................................................................................................................... 182

XAxisValuesFont .................................................................................................................................................. 183

YAxisColor ................................................................................................................................................................ 184

YAxisDividersCount ............................................................................................................................................ 185

YAxisDirection ....................................................................................................................................................... 186

YAxisIndicators .................................................................................................................................................... 187

YAxisLabelsRotated ............................................................................................................................................ 188

YAxisLocation ........................................................................................................................................................ 189

YAxisNumericFormat ......................................................................................................................................... 190

YAxisScaleMaximum .......................................................................................................................................... 191

YAxisScaleMinimum ........................................................................................................................................... 192

YAxisScaleMode .................................................................................................................................................... 193

YAxisScaleMinimumCalculated .................................................................................................................... 194

YAxisScaleMaximumCalculated ................................................................................................................... 195

YAxisShowDividers ............................................................................................................................................. 196

YAxisTitle .................................................................................................................................................................. 197

YAxisTitleFont ........................................................................................................................................................ 198

YAxisValuesFont ................................................................................................................................................... 199

XAxisDirection ....................................................................................................................................................... 200

ZAxisDirection ....................................................................................................................................................... 201

ZAxisScaleMaximum .......................................................................................................................................... 202

ZAxisScaleMinimum ........................................................................................................................................... 203

ZAxisScaleMinimumCalculated .................................................................................................................... 204

ZAxisScaleMaximumCalculated ................................................................................................................... 205

ZoomEnabled .......................................................................................................................................................... 206

ZoomFactor ............................................................................................................................................................. 207

Page 7: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 7 of 212

ZoomInterval ......................................................................................................................................................... 208

ZoomMode................................................................................................................................................................ 209

End-User License Agreement ............................................................................................... 210

Page 8: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 8 of 212

Introduction

Crossing Charts is a native .NET library for chart rendering. From version 4, can be used either as an user control (draggable on a WinForm) and as a rendering component for use in ASP.NET web applications (although it’s not a web control).

Crossing Charts allows you to render different nice charts with great flexibility. Using its

properties and methods you can show or hide any element, or display them with the look you prefer. Current version allows several types of charts, like bars, stacked bars, scatter, bubble, spline, area and pie. The library also supports several 3D chart types like bars, stacked area,

line and pie. Please refer to www.crossingcharts.com for a list with the current charts available.

This document explains in a summarized form the functionality of the library, its properties and methods.

If you need further help about anything, don’t hesitate to contact us at [email protected] or on our website at www.crossingcharts.com.

We heartly recommend to take a look at our tutorials and sample code at our website

since this document becomes quickly obsolete.

Page 9: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 9 of 212

Version history

Version 15.3

Gauge values can be hidden using ShowYAxis = false Internal code refactoring / reorganization

New event SelecionMouseAdd Added EnableRotationOnSurfaceArea

Version 15.2

Added QualityMarkers. Added SelectionHighlight* properties. Added EnableDragItems (similar to EnableDragItemsWithControlKey but not requires

pressing Control key)

Version 15.1

Added EnableDragItemsWithControlKey to enable/disable dragging chart ítems while

pressing CONTROL key. Added events SelectionDragStart, SelectionDragEnd

Version 15

Improved rendering speed by +200% to cope with realtime applications Added AdditionalMarkersManager class to manage custom/additional markers on the chart

with labelling support Version 14.5

Added selection methods for items in charts: SelectionReduce, SelectionGrow,

SelectionRemoveItem, SelectionMoveLeft, SelectionMoveRight, SelectionMoveUp, SelectionMoveDown, SelectionOpAdd, SelectionOpMultiply.

Added color ramps for legends in surface charts

Improved rendering speed and XYZ rotation. Added support for horizontal scroll bar (in XY charts)

Version 14.4

Added XAxisDirection, YAxisDirection and ZAxisDirection to specify the direction

(orientation) of each axis in XYZ charts (-1 or 1).

Version 14.3

Added SurfaceGradientColors property to support new gradient option in Surface charts.

Version 14.2

Added zoom support for XYZ charts Fixed X-Axis labels bug in XYZ charts

Page 10: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 10 of 212

Version 14.1

New SelectionAdditem, SelectionClear methods to hightlight custom values by code Fixed zoom & panning bugs when mixing two or more charts Some bugs fixed

Version 14.0

New Zooming and Panning features (only X/Y family of charts) Added ZoomFactor, ZoomInterval, ZoomEnabled, ZoomOffsetX and ZoomOffsetY

Can zoom/pan using mousewheel and dragging the chart Can show the same Y-axis on both sides (added YAxisLocationStyleBoth).

Added AnimateTo method. Some bugs fixed

Version 12.5

Added Databinding support Ability to select chart items and move them with mouse Ability to rotate XYZ charts using mouse

New submenu in context menu “Selection” with several options Added HotSpotOutlineEnabled and HotSpotOutlineStyle

Added DataTableAddionalRowTitle and DataTableAdditionalValues Added ShowFrontLayer and FrontLayerColor Added SurfaceWireOnly

Some bugs fixed

Version 12.1

New chart style: Tornado chart!

Improved multi-gauge charts Added HotSpotsHitTestPrecision

Some bugs fixed Version 12.0:

Improved Gauge charts appearance with Range Colors (see new properties like GaugeRangeColors)

New SeriesGap property to allow specify the factor of space between series in a bar chart

(from 0 to 1). Support for Hatch styles in Bar and Pie charts

Ability to read data from Excel files in XYZ charts Can specify empty values (Nothing values or use SeriesFactory’s method AddValueEmpty) New values back style: shadowed (use ValuesBackColor to specify shadow color)

Smart location of values in 2D Pie chart improved Using Calculation = AVERAGE in XY charts draws a Trend Line between 2D points.

New CalculationTrendLine property (returns equation of trend line y=bx+a) Can hide YAxisIndicator caption Some bugs fixed

Version 11.5:

Page 11: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 11 of 212

SeriesFactory class: new method AddPointsFromFile (reads XYZ data from Excel file) Can set background image for entire control (before background image worked only for

grid’s background)

New properties: SeriesPointSize, SeriesPointStyle for setting size and style of points of each serie in XY charts

New context menu option to save chart to disk in animated GIF format

Some context menu options now can take effect on only one chart in a combo chart Fixed: incorrect date/time string format in X-axis

Improved X/Y/Z charts Can draw Surface chart from any number of random XYZ points using Delaunay

triangulation algorithm

Version 11:

New chart types: 3D XYZ Scatter, 3D XYZ Lines, 3D XYZ Mesh, 3D XYZ Surface Ability to rotate chart in 3D (only XYZ charts) Improved smart setting for caption/values location

Added lot of new options to context menu Added YAxisTickLength, XAxisTickLength, ZAxisTickLength, ShowYAxis, ShowZAxis,

ZAxisScaleMode, ZAxisScaleMinimum, ZAxisScaleMaximum, ZAxisValuesFont, ZAxisDividersCount, ZAxisNumericFormat, ZAxisColor and other Z axis related properties

SeriesFactory: added formula function in new AddPoints method

SeriesFactory: added AddValueCaption method to specify a string for value captioning instead of normal numeric value (numeric value can be preserved using special tag $$ in

the string passed). Caption can be hidden assigning “” to any ValueCaption or include the original value in a phrase using $$ reserved tag.

Added ValueClick mouse event

Version 10.7:

New chart type: 2D Stacked Spline Area New properties: DataTableStartIndex / DataTableLastIndex for selecting a range of values

to display in the datatable (base 1). Default to zero to show all values.

Fixed legend ítems order in stacked charts

Version 10.6:

New property: PieBorderStyle for setting a custom border for pie segments (2D/3D) Changed implementation of YAxisIndicators

Rendering and control handling in Visual Studio .NET is faster now! Fixed: memory leak caused VS IDE crash when using many controls on same Windows

Form

Fixed: tooltips don’t show correctly in X/Y charts Fixed: some charts appear distorted when exported to PDF

Some minor bugs fixed

Version 10.5:

New chart type: X/Y line Improved pie and doughnut labels location for SMART setting

Can specify min and max range for values’ caption visibility (ShowValuesMax and ShowValuesMin properties)

Page 12: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 12 of 212

Version 10.4:

New chart type: Radar chart GridLineStyle property added

Version 10.3:

Complete serialization/deserialization functionality (see SettingsFactory class) Reset method added

Improved tooltips (HotSpots) Improved context menu

Some bugs fixed

Version 10.2:

Ability to export/import look and feel settings (SettingsFromString and Settings class) Chart Wizard Tool included in package (helps customizing charts and generates code)

Some bugs fixed

Version 10.1:

New chart type: Gantt chart Improved smart positioning algorithm of values Some bugs fixed

Version 10.0:

New feature! Export any chart to PDF format New property: SeriesBorderStyle Clone method implemented (returns an independent copy of the chart control)

Tooltips enhanced (see new Tooltip* properties) Some bugs fixed

Version 9.5:

New chart styles: STYLE2D_GAUGE, STYLE2D_XY_SPLINE New feature! Y-AXIS INDICATORS. Show referente lines over the chart.

Version 9.2:

New chart style: STYLE2D_LINE_DATETIME

Version 9.1:

New chart style: STYLE2D_SCATTER_DATETIME New additional calculation style for Scatter and Bubble: CALCULATION_AVERAGE

New scale mode for X/Y axis: SCALEMODE_AUTOMATIC_MINIMUM_ZERO Improved values location algorithm for 2D pie chart

Minor bugs fixed

Version 9.0:

Page 13: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 13 of 212

New major feature: support for SVG (Scalable Vector Graphics) format New major feature: hotspots (tooltips) New X-axis scale mode: DateTime

Change datatable and legend font: see DataTableFont, LegendFont properties

Version 8.6:

New point style: triangle Fixed initialization of some arrays Fixed fill style for 2d stacked area

Fixed legend location when set to top/middle or bottom/middle

Version 8.5:

New major feature: create high quality animated gifs! New chart types: 2d fixed stacked bars, 3d stacked bars, 3d stacked columns.

New animation style: STYLEANIMATION_WAVE Enhanced shadows (see ShadowColored, ShadowSmooth and ShadowOffset properties)

Can hide Y-Axis dividers (see YAxisShowDividers property) X-Axis labels can now be rotated either 90º or 45º Can make chart control transparent

Many small refinements

Version 8.0:

New major feature: combo charts! New chart type: 2d horizontal bar

May set the height of the space allocated for X-Axis labels May specify the location of the Y-Axis: left or right

Set individual colors for Y-Axis and X-Axis values (YAxisColor and XAxisColor properties) New LegendBackColor property Can specify the number of elements to be shown in X-Axis (default value is 0 = all)

Some bug fixes

Version 7.5:

Can specify individual fonts for each axis (YAxisValuesFont and XAxisValuesFont) May set the inner margins for any lateral (MarginBottom, MarginLeft, MarginRight and

MarginTop) SeriesFactory helper class

Lot of improvements and some bugfixes Extended Reference Guide

Version 7.1:

A few bug fixes and improvements

Version 7.0:

New chart types: 2d and 3d cylinder chart, 3d spline chart, 2d rounded bars, 3d spline area and 3d spline stacked area!

Enhanced 3d stacked area

New additional calculations: maximum line and spline maximum line

Page 14: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 14 of 212

Corrections for 3d doughnut chart

Built-in contextual dialog: allow your users to customiza the chart in real-time with no code!! (only winforms)

English and Spanish languages supported Minor enhancements and bugfixes

Version 6.5:

New chart type: 2d and 3d doughnut charts (with explode option) Specify both axis titles and fonts (YAxisTitle, YAxisTitleFont, XAxisTitle and XAxisTitleFont)

Specify depth (thickness) for pie or doughnut charts (Depth property) Specify position of legend (LegendAlignment property)

Specify hole size for doughnut charts (HoleSize property) Show or hide additional points or marks over line, spline and area charts (ShowPoints

property) Minor enhancements to some charts and bugfixes

Version 6.0:

New chart types: pyramid and picture chart!

New background gradient styles. Can specify numeric format for both axis.

Choose between automatic or fixed scale mode. Grid supports background pictures with transparency. Enhanced 2D and 3D exploded pie charts.

Version 5.5:

Better text rendering options (if quality property is set to HighQuality, ClearType is activated for all text rendering; “antialias” is also supported now)

X and Y axis labels can be rotated 45º (XAxisLabelsRotated and YAxisLabelsRotated) Option to mark highest and lowest values (MarkHighest and MarkLowest) Minor enhancements to some charts and bugfixes

Version 5.0:

Two new 2d charts: scatter and bubble. Possibility to specify fill-style for grid: transparent, bands or chess-pattern.

Aesthetic enhancements to data table with possibility to specify colors for text and background.

Incide the bars values are drawn bottom-up direction and in cursive for better

readability. New properties for points (PointSize and PointStyle).

Better line drawing Smart values location: avoid label overlap (new value for ValuesLocationStyle)

Version 4.0:

Chart library can be used in ASP.NET web applications.

Sample ASP.NET application. Some minor enhancements and bug-fixes.

Version 3.0:

Page 15: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 15 of 212

Can assign colour and gradient style to chart background. Can show an additional and automatic calculation over the main chart (an average spline

or PARETO chart). Show or hide values on X axis. New 2d chart styles: high-low, high-low-close, candlestick y spline.

Can specify values location: Standard or inside the bar. New events.

Version 2.0:

Renders the chart over the form fast and reflects changes in properties in real time. Can specify output bitmap resolution (great for printing; by default, screen resolution is

used).

Allows exporting the bitmap in any of the following formats: BMP, GIF, JPG, PNG, TIFF y WMF.

Can show/hide any element (data table, legend, horizontal dividers, vertical dividers, values, …)

Assign any style, font, color or gradient to the chart.

Many chart styles and more coming in each version of the library Automatic or manual refresh when changing a property of the user control.

Animation: one call to Animate() allows to animate the chart, running each serie from 0 to the original values.

Can specify X or Y slant for 3d charts. Optional can show surface line on 3d charts (a nice graphical division from positive and

negative values).

Can show/hide walls on 3d charts.

Page 16: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 16 of 212

Installation and Deployment

The product is provided as single, lightweight yet powerful, DLL.

The library has no other dependency than .NET Framework so to deploy the component just copy the single DLL file to the installation folder of your application (usually /bin folder) or

register it into the GAC. You may want to register it in the Global Assembly Cache so it will be available to both web

and desktop applications. If you want to manually deploy the library to a production server you should copy the single DLL to any folder and register the library into the Gac with the following

command:

Gacutil –i CrossingChartsLibrary.dll

Note that for desktop applications, it’s enough to add a reference to the library and deploy it along with your application (usually in /bin folder).

Important note:

If you have previously installed trial version and when using licensed version “Trial Version” continues showing on the chart, please do the following:

1.- Uninstall from GAC and/or remove from disk any copy of the library.

2.- Copy the licensed version to a “secure” folder (and register it into the GAC with gacutil if necessary). 3.- Remove current reference to trial version (should appear as missing reference) and

reference the new licensed DLL.

Page 17: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 17 of 212

Library Usage

In desktop applications, you add the control to the toolbox window of the Visual Studio IDE.

In web applications all the chart functionality must be used directly with code since the library is not a web control. However, this way you can use the library both in ASP.NET and ASP

applications provided you have .NET Framework installed. Let’s begin with a Windows application project:

Windows application projects

To use this library as an user control in a WinForm, you only need to add it to the toolbox palette. Click right button over the toolbox palette and select Add/Remove elements…:

Next, if we have registered the component with gacutil, it should be listed on the available component list. If not, click on Browse… button to locate CrossingChartsLibrary.dll file and then

you Hill be able to see it on the toolbox, ready to be dragged over the form:

Page 18: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 18 of 212

ASP.NET application project (web application)

In ASP.NET projects, the operation of the component is different, because it’s not a web control. Only two steps are needed to display charts on your web pages. First, you need to create a asp.net page that instantiate the library and renders the chart to the browser. Second,

you need to reference this asp.net page in the web page you want the chart to appear.

For example, assume that you want to show a chart on the page webform1.aspx. In this page, you only need to include an HTML element like this:

<img src="SampleChart.aspx">

SampleChart.aspx will be the page that will instantiate of chart library, calls its members and renders the chart on the Page_load event. This way, chart will be shown on your page without

the need of create any temporary file. In the following page, you can see an example of SampleChart.aspx (you can also examine the

demo application downloadable from http://www.crossingcharts.com)

Page 19: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load

Dim oGraph As New CrossingChartsLibrary.CrossingCharts

' First, create a sample 2d Bar chart

' Get some random values ...

Dim arrSeries(1) As ArrayList

For k As Integer = 0 To UBound(arrSeries)

arrSeries(k) = New ArrayList

For j As Integer = 0 To 5

arrSeries(k).Add(Rnd() * 1000 - 500)

Next

Next

' Assign properties to Crossing Charts control ...

With oGraph

' All of the following lines are optional, change them as needed; from here...

.AutoRefresh = False ' This prevents internal buffer to be painted after each

property changes

.Series = arrSeries ' Assign previous random values to the chart control

.Title = "2d Bar Chart" ' Title of the chart

.SeriesLegend = New String() {"Apples", "Pearls"} ' Names for each serie

.Style = CrossingChartsLibrary.STYLE2D3D.STYLE2D_BAR ' 2d bar classic chart

.Width = 450 ' Chart width

.Height = 300 ' Char height

.BackColor = Color.LightYellow ' Background color

.BackStyle = CrossingChartsLibrary.STYLEBACKGROUND.STYLEBACKGROUND_GRADIENT_INVERTED

.Calculation = CrossingChartsLibrary.CALCULATION.CALCULATION_AVERAGE_SPLINE ' Calculate

an average spline and draw it

.ValuesLocationStyle = CrossingChartsLibrary.STYLECAPTIONLOCATION.STYLECAPTIONLOCATION_INSIDE ' Put values

inside the bars

.ShowDataTable = False ' Don't need to show the datatable this time

.CastShadows = True ' Add a subtle shadow to each bar

.Quality = Drawing2D.SmoothingMode.HighQuality ' Best result

' ... to here.

.RefreshChart() ' Draw the chart on an internal buffer

End With

' Now, let's output the drawn chart...

' Change the response headers to output a JPEG image.

Response.Clear()

Page 20: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 20 of 212

Response.ContentType = "image/jpeg"

' Write the image to the response stream in JPEG format.

oGraph.Image.Save(Response.OutputStream, System.Drawing.Imaging.ImageFormat.Jpeg)

' Dispose of the graph control

oGraph.Dispose()

End Sub

Page 21: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Populating the Chart and the SeriesFactory helper class

Without SeriesFactory class, you must create an Array of ArrayList (one ArrayList for each

serie) and add a value to each of the ArrayList. Then pass the whole variable to Series property.

In order to make easier to populate the chart with values, a helper class is included in the library. Its called “SeriesFactory” class and here’s an example of use:

Dim helper As New CrossingChartsLibrary.SeriesFactory

With helper

.AddValue(15) '<-- Add values to the first serie

.AddValue(25)

.AddValue(20)

.NewSerie() '<-- Begin a new serie, #2

.AddValue(18)

.AddValue(23)

.AddValue(21)

.ApplyTo(CrossingCharts1) '<-- Assign values to current chart

End With

For comparison purposes, here is an example of an straight use of Series property, the

traditional way of assigning values to the chart: Dim arrSeries(1) As ArrayList '<-- 2 series (0 counts).

arrSeries(0) = new ArrayList

arrSeries(0).Add(15)

arrSeries(0).Add(25)

arrSeries(0).Add(20)

arrSeries(1) = new ArrayList

arrSeries(1).Add(18)

arrSeries(1).Add(23)

arrSeries(1).Add(21)

CrossingChartsLibrary.Series = arrSeries

It’s up to you to use either SeriesFactory class or the Series property.

SeriesFactory includes many native methods to make more easy to feed the chart control as well as some special methods to read data from file, such as AddPointsFromFile. For more help

and guidance, send your question to our support department.

Page 22: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 22 of 212

Tips

1. Speed

To improve the speed of the rendering, set AutoRefresh to False prior to setting any other property. Then set AutoRefresh back to True to display the changes in only one paint.

For example: Dim chart as CrossingChartsLibrary

With chart

.AutoRefresh = False

‘ … Set other properties, like Style, Fonts, Values, etc.

.AutoRefresh = True

End With

2. Output quality

We recommend to use PNG as output format whenever possible (ie. Saving the chart to file

or rendering on web applications).

3. Online tutorials

Don’t forget to visit us at www.crossingcharts.com from time to time! We eventually publish new sample code as well as library updates.

Page 23: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 23 of 212

Advanced feature: combo charts

Beginning version 8, you can combine two or more charts into a single chart. Crossing Charts

will render your main chart, and then, the rest of the suitable elements of the remaining charts in the collection. As a result, now you can have bar/line charts, area/bar/point charts, and so on (only 2d charts are supported by now).

The following sample code shows how to draw a Price/Volume chart (bar/line chart). This

sample assumes CrossingCharts1 is an existing chart control on a form, then a new chart control is created in memory and added to the main chart.

Step 1: Customize main bar chart and populate with 250 random values. Examine the code and look at fourh line: it’s recommended to use AutoRefresh=false when assigning properties to the

library to improve speed.

Dim arrBarChartValues(0) As ArrayList

' Configure Volume bar chart

arrBarChartValues(0) = New ArrayList

With CrossingCharts1

.AutoRefresh = False

.BackColor = Color.Black

.WallsBackStyle = STYLEWALLBACKGROUND.STYLEWALLBACKGROUND_TRANSPARENT

.TitleColor = Color.White

.Title = "Price/Volume Chart Sample"

For k As Integer = 0 To 250

arrBarChartValues(0).Add(Rnd() * 35000)

Next

.Series = arrBarChartValues

.SeriesLegend = New String() {"Volume"}

.YAxisScaleMode = SCALEMODE.SCALEMODE_FIXED

.YAxisScaleMaximum = 100000

.YAxisScaleMinimum = 0

.YAxisColor = Color.White

.YAxisTitle = ""

.Calculation = CALCULATION.CALCULATION_NONE

.ShowDividerX = False

.ShowValues = False

.ShowLegend = True

.ShowDataTable = False

.LegendColor = Color.White

.LegendBackColor = Color.Black

End With

Step 2: Create a secondary chart (oLineChart) and customize it. Nothing is drawn yet in the

form.

' Define Price line chart

Dim oLineChart As New CrossingChartsLibrary.CrossingCharts

Dim arrSeries(0) As ArrayList, arrItems(250) As String

arrSeries(0) = New ArrayList

Dim p As Integer = Rnd() * 50

With oLineChart

.AutoRefresh = False

For k As Integer = 0 To 250

arrSeries(0).Add(p)

p += Rnd() * 10 - 5

Page 24: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 24 of 212

arrItems(k) = k

Next

.Series = arrSeries

.Style = STYLE2D3D.STYLE2D_LINE

.YAxisLocation = STYLEYAXISLOCATION.STYLEYAXISLOCATION_RIGHT

.YAxisDividersCount = 10

.YAxisColor = Color.White

.SeriesLegend = New String() {"Price"}

.SeriesLineStyle = New Pen() {New Pen(Color.White)}

.SeriesColor = New Color() {Color.White}

.ItemsLegend = arrItems

.ShowValues = False

.ShowPoints = False

.ShowDividerX = True

.XAxisColor = Color.White

.XAxisDividersCount = 10

.XAxisLabelsRotated = True

.ShowXAxis = True

End With

Step 3: Add the line chart to the render engine of the main chart control.

' Add the second chart to current chart

CrossingCharts1.ChartAdd(oLineChart)

Step 4: Now, let Crossing Charts show the results…

' Draw the composition

CrossingCharts1.RefreshChart()

Step 5: Finally, we no longer need the secondary chart, so you can remove it from memory

(it’s optional). LineChart is second in the chain (first is the main chart), so we pass a 2 to ChartRemove method.

' Remove line chart from composite manager

CrossingCharts1.ChartRemove(2)

Page 25: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 25 of 212

Advanced feature: SVG charts (vector charts)

SVG (Scalable Vector Graphics) is supported from version 9.

SVG is different from raster (bitmap) formats because charts in SVG format use a standard XML instead of pixels. This standard XML (the SVG standard) is defined by the w3c. The output

is very similar to Adobe Flash. In fact, Adobe has published a SVG plugin for IE.

SVG charts can be resized and transformed in high-quality because it’s a vector format. They also require a “plugin”. Firefox and Opera has builtin SVG support. For IE, you can use

the free Adobe SVG plugin (you probably have already it installed).

For more information about SVG standard and viewers go to: http://www.w3.org/Graphics/SVG/

http://wiki.svg.org/Viewer_Implementations Note that at this moment not all chart types can be exported to SVG format. Future versions

will increase the number of chart types compatibles. The following chart types are available for SVG export in version 9:

2D chart types supported: area, stacked area, bar area, stacked bar (proportional), line, pie, point, rounded bar, scatter, spline, stacked bar (fixed), horizontal bars, bubble, candlestick,

cylinders, high-low, high-low-close, pyramid.

3D chart types supported: stacked area, bar (accumulated), stacked bar, columns (accumulated), stacked columns, line, spline area, spline stacked area.

The following sample code shows how to export the SVG document used to render the chart in the web browser (note that a SVG plugin is required – see above).

First, you need to create a asp.net page that instantiate the library and renders the SVG chart to the browser. Second, you need to put an <embed> tag in the page where you want to draw

the chart.

For example, assume that you want to show a SVG chart on the page webform1.aspx. In this page, you only need to include an HTML element like this:

<embed width="500" height="400" src="StackedBarChart.aspx?.svg"

pluginspage="http://www.adobe.com/svg/viewer/install/" type="image/svg+xml" />

Let’s examine the above line:

1.- Embed tag is preferred since every browser will understand it. You may also use <object> or <iframe> tags.

2.- Width and Height are set to fit the browser page. Note that you will need to set also “scaleToFit” parameter later. 3.- The “src” argument indicates the name of the aspx page that deals with the library and

renders the SVG. Note the strange ?.svg suffix. This is necessary to avoid mime conflicts under IIS or Visual Studio.

Page 26: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 26 of 212

4.- The “pluginspace” argument indicates the URL where the user may download a SVG viewer

plugin if none is installed. 5.- Finally, the “type” argument indicates that the embedded object is a SVG image.

StackedBarChart.aspx will be the page that will instantiate of chart library, calls its members and renders the chart on the Page_load event. This way, chart will be shown on your page

without the need of create any temporary file.

In the following page, you can see an example of StackedBarChart.aspx. In the Page_Load event, an object of Crossing Charts is created and populated. Then, a call to

CreateSVG method is made to obtain the SVG document that describes the chart.

CreateSVG accepts only one boolean parameter to indicate if the SVG will scale to fit the container or not. Set it to true if you want the SVG to occupy the entire space defined in the <embed> tag.

Next, a few calls to Response object are made to render the content of the SVG to the browser.

Page 27: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load

Dim oGraph As New CrossingChartsLibrary.CrossingCharts

Dim svg As String

' First, create a sample chart

' Get some random values ...

Dim arrSeries(1) As ArrayList

For k As Integer = 0 To UBound(arrSeries)

arrSeries(k) = New ArrayList

For j As Integer = 0 To 5

arrSeries(k).Add(Rnd() * 1000)

Next

Next

' Assign properties to Crossing Charts control ...

With oGraph

.AutoRefresh = False ' This prevents internal buffer to be painted after each

property changes

.LicenseeIdentifier = "PREM2007"

.Series = arrSeries ' Assign previous random values to the chart control

.Title = "Equipment Chart" ' Title of the chart

.Style = CrossingChartsLibrary.STYLE2D3D.STYLE3D_STACKED_BAR

.CastShadows = True

.Width = 500 ' Chart width

.Height = 300 ' Char height

.BackColor = System.Drawing.Color.LightYellow ' Background color

.BackStyle = CrossingChartsLibrary.STYLEBACKGROUND.STYLEBACKGROUND_GRADIENT_TUBULAR_INVERTED

.Calculation = CrossingChartsLibrary.CALCULATION.CALCULATION_AVERAGE_SPLINE ' Calculate

an average spline and draw it

.ShowDataTable = False ' Don't need to show the datatable this time

.ShowLegend = False ' Don't show legend

.ShowDividerX = False ' Don't show vertical dividers

.YAxisNumericFormat = "0" ' No decimals on Y-axis

.ValuesFormat = "0" ' No decimals on values

.Quality = System.Drawing.Drawing2D.SmoothingMode.HighQuality ' Best result

' Get SVG xml document and write to response stream

svg = oGraph.CreateSVG(False)

End With

' Dispose of the graph control

oGraph.Dispose()

' Change the response headers to output a SVG graph.

Page 28: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 28 of 212

Response.Clear()

Response.ContentType = "image/svg+xml"

Response.Write(svg)

Response.End()

End Sub

Page 29: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Advanced feature: PDF export (… and chart printing)

PDF format is supported from version 10.

With CreatePDF method you can quickly obtain a PDF representation of the current chart.

This method returns a PDF file in a byte array so you can save it to a file, display in a browser in realtime, etc.

CreatePDF has the following interface:

Public Function CreatePDF(ByVal orientation As STYLE_ORIENTATION, ByVal margin As

Integer) As Byte()

The resulting PDF is a 100% PDF 1.4 version compatible file, which can be opened with

Acrobat Reader so you can also print the chart from there.

This method will use current chart image at current resolution (by default, if you don’t specify a value with Resolution property, image resolution would be 72 dpi – screen resolution). If you want a better image quality for printing purposes you may increase the resolution of the

chart just before calling CreatePDF method. Example: Imports System.IO

Dim buffer as Byte()

With CrossingCharts1

.Resolution = 150

Buffer = CreatePDF(ORIENTATION_LANDSCAPE, 50)

File.WriteAllBytes(“c:\chart.pdf”, buffer)

.Resolution = 72 ‘Back to screen resolution

End With

Please, check new samples of CreatePDF usage in our website at http://www.crossingcharts.com.

Page 30: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 30 of 212

Advanced feature: serialization

Beginning version 10.3, you can save current properties of a chart object (serialization) and

recover them later onto a new chart object (deserialization). Serialization in Crossing Charts is achieved through SettingsFactory inner class which is

available with the Settings property.

See online tutorial for usage sample: http://crossingcharts.com/forum/index.php?topic=28.0

1. To serialize / save all properties to a string variable:

CrossingCharts1.Settings().GetSettings(discardData as Boolean)

This will return all properties in a compressed string value. Then you can store the returned string data into a file or database. The parameter discardData allows you to include or exclude current values of chart (replace "CrossingCharts1" with your chart object name).

2. To deserialize / recover all properties from a string variable:

CrossingCharts1.Settings().Apply(data as String, discardData as Boolean)

Pass previous collected string data to "data" parameter and specify if you want to discard any data included in the string data or not (discardData parameter).

Notes:

- Settings included are all non-readonly properties available in CrossingCharts class.

- Your activation code (LicenseIdentifier property value) will also be included.

Page 31: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 31 of 212

Advanced feature: zoom and panning

Version 14 and later introduces the ability to zoom and pan on X/Y charts familiy (X/Y scatter,

X/Y line, X/Y datetime, X/Y line datetime and X/Y spline). See online tutorial for usage sample:

http://crossingcharts.com/forum/index.php?topic=60.0

This feature must be enabled first, using ZoomEnabled = true or from the context menu. Once zoom is enabled, the user can control the zoom and panning using his/her mouse. The

mouse wheel controls the zoom (zoom in/out). To pan press down left button and drag.

Zoom can affect both axis, X-axis or Y-axis alone. This can be specified using ZoomMode property or choosing an option from the context menu.

There’re a few useful properties if you need to control the zoom/pan from code:

- ZoomFactor: single value that represents the magnifying factor, from 0.00001 to infinite.

- ZoomOffsetX and ZoomOffsetY specifies the offset displacement of the chart (panning).

- ZoomInterval: single value that specifies the zoom stepping. Can be increased

to accelerate zoom when using mouse wheel.

To quickly restore the chart to its original position and cancel zoom call ZoomRestore.

Page 32: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 32 of 212

Advanced feature: additional markers with optional labels

Beginning version 15, you can add your own markers to the chart using the new

AdditionalMarkersManager class. Just call SetMarker and SetLabel to add a new marker with desired shape and a text next to

it.

The markers will always be drawn on each RefreshChart() call. If you just want to refresh the markers and not the entire chart (good for real-time applications), then call QuickRefresh() of the AdditionalMarkersManager instead.

Sample code:

// Prepare location and Font Random r = new Random(); Font font = new Font("Verdana", 10, FontStyle.Regular, GraphicsUnit.Point); Single x = r.Next(30); Single z = r.Next(30); Single y = r.Next(10) + 5; // Set a new marker at x,y,z position with custom style, color and size AdditionalMarker marker = chart.AdditionalMarkersManager.SetMarker(0, x, y, z, STYLEPOINT.STYLEPOINT_CIRCLE, Color.Yellow, 10, true); // Draw a label next to it marker.SetLabel("Sample 12345 label", font, 8, -16, Color.Yellow, Color.DarkBlue, Color.Cyan, 2, Color.Black); // Quickly refresh the markers chart.AdditionalMarkersManager.QuickRefresh();

Page 33: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 33 of 212

Sample code for Windows application (VB.NET)

All charts require assigning some values to Series properties. The type of Series properties is Array of ArrayList. This property contains all the series and each series contains at leat one

value. Value can be any numeric expression, although we recommend using Single or Double.

Standard chart types only require one numeric value for each element on the chart (for example, column charts only need one numeric to specify column height). A few chart types, requires two numbers for each value (such as high-low or scatter type; high-low requires a

high and a low number for each value; scatter requires one number for X position and another for Y position).

Bubble and high-low-close requires three numbers for each value (in case of bubble, first number defines X position, second number Y position and third number is used to calculate

radius of the bubble).

Finally, candlestick charts requires tour numbers for each value. They are also known as stock charts and represents open, close, minimum and maximum scores.

The following code assumes that the user control is named oGraph and can be used to draw any chart type of one dimension (one number for each value). Please refer to ASP.NET sample

application for more examples of two, three and four numbers for each value.

' Get some random values ...

Dim arrSeries(1) As ArrayList

For k As Integer = 0 To UBound(arrSeries)

arrSeries(k) = New ArrayList

For j As Integer = 0 To 5

arrSeries(k).Add(Rnd() * 1000 - 500)

Next

Next

With oGraph

' All of the following lines are optional, change them as needed; from here...

.AutoRefresh = False ' This prevents internal buffer to be painted after

each property changes

.Series = arrSeries ' Assign previous random values to the chart control

.Title = "2d Bar Chart" ' Title of the chart

.SeriesLegend = New String() {"Apples", "Pearls"} ' Names for each serie

.Style = CrossingChartsLibrary.STYLE2D3D.STYLE2D_BAR ' 2d bar classic chart

.Width = 450 ' Chart width

.Height = 300 ' Char height

.BackColor = Color.LightYellow ' Background color

.BackStyle =

CrossingChartsLibrary.STYLEBACKGROUND.STYLEBACKGROUND_GRADIENT_INVERTED

.Calculation = CrossingChartsLibrary.CALCULATION.CALCULATION_AVERAGE_SPLINE

' Calculate an average spline and draw it

.ValuesLocationStyle =

CrossingChartsLibrary.STYLECAPTIONLOCATION.STYLECAPTIONLOCATION_INSIDE ' Put values inside

the bars

Page 34: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 34 of 212

.ShowDataTable = False ' Don't need to show the datatable this time

.CastShadows = True ' Add a subtle shadow to each bar

.Quality = Drawing2D.SmoothingMode.HighQuality ' Best result

' ... to here.

.RefreshChart() ' Draw the chart on an internal buffer

End UIT

Page 35: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 35 of 212

Sample code for C# (Windows application)

All charts require assigning some values to Series properties. The type of Series properties is Array of ArrayList. This property contains all the series and each series contains at leat one

value. Value can be any numeric expression, although we recommend using Single or Double.

Standard chart types only require one numeric value for each element on the chart (for example, column charts only need one numeric to specify column height). A few chart types, requires two numbers for each value (such as high-low or scatter type; high-low requires a

high and a low number for each value; scatter requires one number for X position and another for Y position).

Bubble and high-low-close requires three numbers for each value (in case of bubble, first number defines X position, second number Y position and third number is used to calculate

radius of the bubble).

Finally, candlestick charts requires tour numbers for each value. They are also known as stock charts and represents open, close, minimum and maximum scores.

The following code illustrates how to assign values to Series property:

ArrayList[] data = new ArrayList[2];

Random rnd = new Random();

for (int serie=0;serie<2;serie++)

{

data[serie] = new ArrayList(); // Each ArrayList corresponds to a "serie"

for(int k =0;k<5;k++)

{

// Put two values for each "serie"

data[serie].Add ( rnd.Next(-100,100) );

data[serie].Add ( rnd.Next(100) );

}

}

CrossingCharts1.Series = data;

CrossingCharts1.RefreshChart();

Page 36: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 36 of 212

Sample code: creating charts without using forms (C#)

It’s very easy to render a chart using only code and no forms (useful for a Windows service or if you don’t want to use the chart as an user control for example):

CrossingChartsLibrary.CrossingCharts oGraph = new CrossingChartsLibrary.CrossingCharts();

ArrayList[] data = new ArrayList[2];

Random rnd = new Random();

for (int serie=0;serie<2;serie++)

{

data[serie] = new ArrayList(); // Each ArrayList corresponds to a "serie"

for(int k =0;k<5;k++)

{

// Put two values for each "serie"

data[serie].Add ( rnd.Next(-100,100) );

data[serie].Add ( rnd.Next(100) );

}

}

oGraph.Width = 700;

oGraph.Height = 400;

oGraph.Series = data;

oGraph.Image.Save("c:\\test.png", System.Drawing.Imaging.ImageFormat.Png);

Page 37: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Library Quick Reference

Properties

Version Member Type Description Default value

2 AutoRefresh Boolean Set it chart is refreshed after any change to properties. If set to false, you need to call

RefreshChart to manually refresh of chart.

True

3 BackColor System. Drawing.Color Chart’s background color Color.White

3 BackStyle STYLEBACKGROUND Chart’s background style. Can be any of the following: STYLEBACKGROUND_SOLID = 0 STYLEBACKGROUND_GRADIENT = 1

STYLEBACKGROUND_GRADIENT_INVERTED = 2

STYLEBACKGROUND_SOLID

1 BorderColor System. Drawing.Color Chart’s border color Color.Red

5 BubbleMaxRadius Long Maximum size of a bubble (bubble chart only) 100

7 BuiltinDialogAllowed Boolean Enable or disable right-button contextual menú True

7 BuiltinDialogLanguage LANGUAGE Contextual menú language LANGUAGE.LANG_ENGLISH

3 Calculation CALCULATION Additional calculation to draw on chart: CALCULATION_NONE = 0 CALCULATION_AVERAGE = 10 CALCULATION_AVERAGE_SPLINE = 11 CALCULATION_PARETO = 20

CALCULATION_NONE

3 CalculationLineStyle Pen Line style for additional calculation New Pen(Color.Blue, 3)

12 CalculationTrendLine TrendLine Returns a TrendLine object containing the parameters of the line (slope and y-displacement)

Nothing

1 CastShadows Boolean Show/hide a shadow False

12.5 DataSource (DataGridView control) A DataGridView control to databind Nothing

12.5 DataSourceMode DATASOURCE_SCHEME Specifies how the data in datasource must be

interpreted

Nothing

12.5 DataTableAdditionalRowTitle String Title for an additional fixed row of custom values “”

15.5 DataTableAdditionalRowValues String() Values of an additional and optional row of

custom values

Nothing

5 DataTableBackColor Color Datatable’s background color Color.White

5 DataTableColor Color Datatable’s text color Color.Black

9 DataTableFont Font Datatable’s text font New Font("Arial", 12,

FontStyle.Regular,

GraphicsUnit.Point)

12 DataTableLastIndex Integer Index of last value to be displayed in the (Last item)

Page 38: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 38 of 212

datatable

12 DataTableStartIndex Integer Index of first value to be displayed in the datatable

1

4 DataTableText String Datatable’s caption “Datatable”

6.5 Depth Integer Thickness of 3d pie or 3c doughnut charts 30

15.2 EnableDragItems Boolean Allows dragging chart items with mouse False

15.2 EnableDragItemsWithControlKey Boolean Allows dragging chart items with mouse while pressing control key

True

15.3 EnableRotationOnSurfaceArea Boolean Allows rotating XYZ chart when dragging over the

chart surface. If set to false, rotation would only

occur if user drags outside the surface area.

True

12.5 ShowFrontLayer Boolean Show/hide a front solid layer which can be partially transparent

False

12.5 FrontLayerColor System.Drawing.Color Color for the front layer Nothing

10.1 GanttSetToday DateTime Position for the “today” line in a Gantt chart Now

10.1 GanttSetTodayLabel String Text to draw at the “today” line “Today”

9.5 GaugeBackStyle SolidBrush Gauge’s background style Nothing

9.5 GaugeBigTickStyle Pen Gauge’s big tick pen style Nothing

9.5 GaugeBorderStyle Pen Gauge’s border style Nothing

9.5 GaugeCentralCircleRadius Single Gauge’s central circle radius 0

9.5 GaugeCentralCircleBackStyle SolidBrush Gauge’s central circle background style Nothing

9.5 GaugeCentralCircleBorderStyle Pen Gauge’s central circle border style Nothing

9.5 GaugeMarginFactor Single Image to be rendered on the grid’s background 0.1

9.5 GaugeNeedleStyle Pen Gauge’s needle pen style Nothing

12 GaugeRangeColors ArrayList() For each serie can specify intervals which are painted with custom color. The array length must match the number of series and in each ArrayList you may specify any number of intervals in the

form of (low, high, color).

Nothing

9.5 GaugeSmallTickStyle Pen Gauge’s small tick pen style Nothing

12 GaugeTitles String () Each gauge’s top title Nothing

12 GaugeTitlesFont Font Font style for all gauges’ titles New Font("Verdana", 10)

6 GridBackgroundImage Image Image to be rendered on the grid’s background Nothing

6 GridBackgroundImage Transparency

Integer Transparency percentage factor (0= fully visible, 100=transparent)

0

10.4 GridLineStyle Pen Grid line style and color Pen(Color.DarkGray)

6.5 HoleSize Integer Size of central hole in doughtnut charts 30

9 HotSpotBackColor Color Background color of value tooltips Color.FromArgb(220, 255, 255,

64)

9 HotSpotColor Color Text color of value tooltips Color.FromArgb(255, 0, 0, 128)

10 HotSpotCrossLineStyle Pen Line style of tooltip cross (see Pen(Color.FromArgb(255, 220,

32, 32))

Page 39: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 39 of 212

HotSpotShowCross)

10 HotSpotDateTimeFormat String Text format when tooltip shows a date/time value “d”

9 HotSpotsEnabled Boolean Activate/deactivate hotspots (tooltips) “N”

10 HotSpotNumericFormat String Numeric format when tooltip shows a numeric value

“N”

12.1 HotSpotHitTestPrecision Integer Distance threshold for hotspot detection when mouse hovers the chart

10

12.5 HotSpotOutlineEnabled Boolean Allows user selection of chart items using mouse True

12.5 HotSpotOutlineStyle Pen Specifies outline style for items being selected New Pen(Color.Yellow)

10.2 HotSpotTooltips ArrayList() Allows manual setting of each item tooltip Nothing (automatic)

10 HotSpotShowCross Boolean Show/hide a cross over the tooltip False

14.5 HScrollBar Accesor to the HScrollBar component

1 Image Bitmap Current chart bitmap

6 ItemsHighLight String() Assign any text to any item to explode pie chart. For example, ItemsHighlight(3) = “explode”

would cause item #3 to separate in a pie chart. Now you can assign any text. In future versions, this text could be shown over each exploded sector of the pie chart describing the cause it is “highlighted”

Empty

2 ItemsLegend String() X axis ítems names Empty

6.5 LegendAlignment STYLEALIGNMENT Position for legend STYLEALIGNMENT_MIDDLE_RIGHT

8 LegendBackColor Color Legend’s back color Color.White

2 LegendColor Color Legend’s text color Color.Black

14.5 LegendColorChartSteps Integer Number of colors/rows for the color-ramp legend in surface charts

5

9 LegendFont Font Legend’s text font New Font("Arial", 12,

FontStyle.Regular,

GraphicsUnit.Point)

4 LegendText String Legend’s caption “Legend”

5 LicenseeIdentifier Long Unique identity number for licensed user 0

5.5 MarkHighest Boolean Draws label for highest value in yellow background and blue text

False

5.5 MarkLowest Boolean Draws label for lowest value in red background and yellow text

False

7.5 MarginBottom Integer Inner distance in pixels between lower limit of the chart and the border

20

7.5 MarginLeft Integer Inner distance in pixels between left limit of the chart and the border

20

7.5 MarginRight Integer Inner distance in pixels between right limit of the chart and the border

20

7.5 MarginTop Integer Inner distance in pixels between top limit of the 20

Page 40: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 40 of 212

chart and the border

10.6 PieBorderStyle Pen Line style for the borders of pie segmengs New Pen(Color.Transparent)

5 PointStyle STYLEPOINT Point style (point and scatter charts) STYLEPOINT_CIRCLE

5 PointSize Integer Point size (point and scatter charts) 4

2 Quality System.Drawing. Drawing2d. SmoothingMode

Render quality of chart HighQuality

15.2 QualityMarkers System.Drawing. Drawing2d.

SmoothingMode

Render quality of selection, markers and highlights

HighQuality

1 Resolution Long Bitmap resolution (ppp) 72

14.5 SelectionAddItem Integer, Integer Will add item defined by serieIndex + itemIndex to current selection

14.5 SelectionClear Clears current selection

14.5 SelectionMoveLeft Integer Moves all items in selection to the left by amount specified (XYZ charts)

14.5 SelectionMoveRight Integer Moves all items in selection to the right by

amount specified (XYZ charts)

14.5 SelectionMoveUp Integer Moves all items in selection to the next row by amount specified (XYZ charts)

14.5 SelectionMoveDown Integer Moves all items in selection to the previous row by amount specified (XYZ charts)

14.5 SelectionRemoveItem Integer, Integer Will remove item defined by serieIndex + itemIndex from current selection

14.5 SelectionGrow Integer Will surround current selected items in XYZ charts by an amount of positions (usually 1)

1

14.5 SelectionReduce Will shrink current selection in XYZ charts 1

1 Series ArrayList List of arrays containing the values for each serie. For pie chart, only first serie is taken in account.

(2 series with eight random values each)

10 SeriesBorderStyle Array of System. Drawing.Pen

Contains a pen object for each serie’s bar borders

1 SeriesColor Array of System. Drawing.Color

Array with each series color. For pie chart, each sector colors correspond to each value on the first serie

Random

1 SeriesFillStyle Array of System.

Drawing.Brush

Contains a brush object for each serie (only for

Line chart type)

Nothing (automatic)

11.6 SeriesGap Single() Specify distance from each serie in percentage (i.e. 0.5) or fixed amount (i.e. 40 pixels)

0.25

1 SeriesLegend Array of String Series names

1 SeriesLineStyle Array of System. Drawing.Pen

Contains a pen object for each serie (only for Line chart type)

Nothing (automatic)

6 SeriesPicture Array of Image Contains an image object for each serie of the Nothing

Page 41: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 41 of 212

chart. Must be used in picture charts.

11.1 SeriesPointSize Integer() Allows setting individual series’ point size Nothing (automatic)

11.1 SeriesPointStyle STYLEPOINT() Allows setting individual series’ point style Nothing (automatic)

10.2 SettingsFromString String Apply look and feel settings generated with Chart wizard tool or with Settings.GetSettings function

8.5 ShadowColored Boolean Draw shadows in color or in gray False (in gray)

8.5 ShadowSmooth Boolean Use diffuse shadows True

8.5 ShadowOffset Integer Distance of the shadow in pixels 5

1 ShowDataTable Boolean Show/hide data table True

1 ShowDividerX Boolean Show/hide vertical separators True

1 ShowDividerZ Boolean Show/hide depth separators True

2 ShowItemsLegend Boolean Show/hide X axis items names False

1 ShowLegend Boolean Show/hide items legend True

9 ShowLegendInDataTable Boolean Show/hide series legend in data table True

6.5 ShowPoints Boolean Whether additional marks or points are shown over line, spline or area charts

True

1 ShowSolidColors Boolean Set to true if you don’t want gradients on fills False

2 ShowSurface3d Boolean Show/hide surface line on 3d charts False

1 ShowValues Boolean Show/hide values on chart True

10.5 ShowValuesMax Double Max value to be displayed Double.Max (unlimited)

10.5 ShowValuesMin Double Min value to be displayed Double.Min (unlimited)

3 ShowXAxis Boolean Show/hide values over X Axis True

11 ShowYAxis Boolean Show/hide values over Y Axis True

11 ShowZAxis Boolean Show/hide values over Z Axis True

2 SlantX Single X axis offset for 3d effect 30

2 SlantY Single Y axis offset for 3d effect 30

1 Style STYLE2D3D Chart’s style STYLE2D_BAR

11.1 SurfaceBrushMaxBrightness Integer In Surface charts, the brightness of the peak 100

11.1 SurfaceBrushMinBrightness Integer In Surface charts, the brightness of the valley 0

11.1 SurfaceBrushStyle Brush In Surface charts, the brush of the terrain SolidBrush(Color.FromArgb(128,

128, 128, 128))

12.5 SurfaceWireOnly Boolean In Surface charts, only renders a wireframe False

1 Style STYLE2D3D Chart’s style STYLE2D_BAR

7 Thickness Integer 3D cylinders’ width 30

1 Title String Chart’s title “Title”

1 TitleFont System. Drawing.Font Chart title’s font

1 TitleColor System. Drawing.Color Chart title’s text colour Color.Black

9 ValuesAlignment StringAlignment Alignment for values in the datatable StringAlignment.Far

2 ValuesBackColor System. Drawing.Color Background colour for values Color.Orange

11 ValuesCaptions String() Allows specify individual item’s captions Nothing (automatic)

2 ValuesColor System. Drawing.Color Text colour for values Color.Black

Page 42: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 42 of 212

2 ValuesFont System. Drawing.Font Values’ font

2 ValuesFormat String String format for values “N”

3 ValuesLocationStyle STYLECAPTIONLOCATION Location style for values STYLECAPTIONLOCATION_DEFAULT

2 ValuesStyle STYLECAPTION Appearance style for values STYLECAPTION_ROUNDED_SQUARE

5 WallsBackStyle STYLEWALLBACKGROUND Fill style for grid STYLEWALLBACKGROUND_BANDS

5 WallsBackColor Principal Color Main colour for grid background Color.FromArgb(64, 148, 232, 255)

5 WallsBackColor Secondary Color Secondary colour for grid background Color.FromArgb(128, 148, 232, 255)

2 WallStyle STYLEWALLS Style for walls (only 3d charts) STYLEWALLS_NOWALLS

11 XAxisAngle Single Rotation angle for X-Axis (only XYZ charts) PI / 10

8 XAxisColor Color Color for X-axis texts Color.Black

8 XAxisDividerCount Integer Maximum number of items in the X-Axis 0 (all items are shown by default)

14.4 XAxisDirection Integer (-1 or 1) Orientation of X axis (only XYZ charts) 1

8 XAxisHeight Integer Height in pixels for the space allocated for X-Axis labels

1000

5.5 XAxisLabelsRotated Boolean Draws X-axis labels rotated 45º False

8.5 XAxisLabelsRotated90 Boolean Draws X-axis labels rotated 90º False

6 XAxisNumericFormat String Expression format for X-axis values. Use “0” for integer values onlX.

“N”

6 XAxisScaleMode SCALEMODE Scale mode for X-axis (automatic or fixed). If

fixed, use XAxisScaleMinimum and XAxisScaleMaximum to set the scale range.

SCALEMODE.AUTOMATIC

6 XAxisScaleMaximum Single Maximum value for X-axis scale 0

6 XAxisScaleMaximumDateTime DateTime Maximum value for X-axis scale in DateTime mode

6 XAxisScaleMinimum Single Minimum value for X-axis scale 0

6 XAxisScaleMinimumDateTime DateTime Minimum value for X-axis scale in DateTime

mode

11 XAxisTickLength Integer Length in pixels of X-axis ticks 5

6.5 XAxisTitle String X-Axis title “”

6.5 XAxisTitleFont Font X-Axis title’s font Font("Arial", 11, FontStyle.Bold, GraphicsUnit.Point)

9 XAxisValuesFont Font X-Axis labels’ font Font("Arial", 12, FontStyle.Bold,

GraphicsUnit.Point)

11 YAxisAngle Single Rotation angle for Y-Axis (only XYZ charts) PI / 5

8 YAxisColor Color Color for Y-Axis texts Color.Black

1 YAxisDividersCount Long Number of Y axis dividers. If set to 10, you can emulate a percentage axis. If set to zero, no divider is shown.

10

14.4 YAxisDirection Integer (-1 or 1) Orientation of Y axis (only XYZ charts) 1

9.5 YAxisIndicators Array of Array of Y_AXIS_INDICATORS structure. Each Nothing

Page 43: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 43 of 212

Y_AXIS_INDICATORS indicator draws an horizontal line over the chart useful for marking special limits.

5.5 YAxisLabelsRotated Boolean Draws Y-axis labels rotated 45º False

8 YAxisLocation STYLEYAXISLOCATION Location for Y-Axis (left or right) STYLEYAXISLOCATION_LEFT

6 YAxisNumericFormat String Expression format for Y-axis values. Use “0” for integer values only.

“N”

6 YAxisScaleMode SCALEMODE Scale mode for y-axis (automatic or fixed). If

fixed, use YAxisScaleMinimum and YAxisScaleMaximum to set the scale range.

SCALEMODE.AUTOMATIC

6 YAxisScaleMaximum Single Maximum value for y-axis scale 0

6 YAxisScaleMinimum Single Minimum value for y-axis scale 0

10 YAxisTickLength Integer Length in pixels of Y-axis ticks 5

6.5 YAxisTitle String Y-Axis title “”

6.5 YAxisTitleFont Font Y-Axis title’s font Font("Arial", 11, FontStyle.Bold, GraphicsUnit.Point)

9 YAxisValuesFont Font Y-Axis labels’ font Font("Arial", 12, FontStyle.Bold, GraphicsUnit.Point)

11 ZAxisAngle Single Rotation angle for Z-Axis (only XYZ charts) PI / 5

11 ZAxisColor Color Color for Z-Axis texts Color.Black

11 ZAxisDividersCount Long Number of Z axis dividers. If set to 10, you can

emulate a percentage axis. If set to zero, no divider is shown.

10

14.4 ZAxisDirection Integer (-1 or 1) Orientation of Z axis (only XYZ charts) 1

11 ZAxisNumericFormat String Expression format for Y-axis values. Use “0” for integer values only.

“N”

11 ZAxisScaleMode SCALEMODE Scale mode for y-axis (automatic or fixed). If fixed, use ZAxisScaleMinimum and

ZAxisScaleMaximum to set the scale range.

SCALEMODE.AUTOMATIC

11 ZAxisScaleMaximum Single Maximum value for y-axis scale 0

11 ZAxisScaleMinimum Single Minimum value for y-axis scale 0

11 ZAxisTickLength Integer Length in pixels of Y-axis ticks 5

11 ZAxisTitle String Y-Axis title “”

11 ZAxisTitleFont Font Y-Axis title’s font Font("Arial", 11, FontStyle.Bold, GraphicsUnit.Point)

11 ZAxisValuesFont Font Y-Axis labels’ font Font("Arial", 12, FontStyle.Bold, GraphicsUnit.Point)

14 ZoomEnabled Boolean Enable/Disable both zoom and panning features False

14 ZoomFactor Single Magnifying factor when zoom is enabled 1.0

14 ZoomInterval Single Stepping factor when zooming using mouse wheel

0.1

14 ZoomOffsetX Single X-axis displacement amount (panning) 0

Page 44: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 44 of 212

14 ZoomOffsetY Single Y-axis displacement amount (panning) 0

Methods

Version Member Parameters Description

2 Animate None Animate the chart beginning with zero for all values to original values.

14 AnimateTo ByVal style As STYLEANIMATION, ByVal

stepping As Integer, ByVal

targetSeriesData As ArrayList()

Animate the chart from current values to specified values

8 ChartAddNew None Adds a new initialized chart to the render engine

8 ChartAddNew ByVal oChart As

CrossingChartsLibrary.CrossingCharts Adds a chart object to the render engine

8 ChartCount Integer Returns the number of chart instances

8 ChartItem ByVal item As Integer Returns a reference to the chart object specified by Item (1, 2, 3..)

8 ChartRemove ByVal item As Integer Removes from chart engine the chart object specified by item

8.5 CreateAnimatedGIF ByVal intFrames As Integer, ByVal

intSpeed As Integer, ByVal blnLoop As

Boolean, ByVal style As STYLEANIMATION

Returns an animated GIF image

10 CreatePDF ByVal orientation As STYLE_ORIENTATION,

ByVal margin As Integer Returns a PDF representation of current chart

9 CreateSVG ByVal scaleToFit As boolean True will scale the chart to fit the entire space defined in the holding tag (embed, object or iframe)

2 RefreshChart None Force a chart update.

10.3 Reset None Clears all data and returns all properties to default values

12 SetAllSeriesLineStyle Pen p Assigns the same line style (p) to all series

14.5 SelectionAddItem ByVal seriesIndex as Integer, byval itemIndex

as Integer

Highlight/selects an existing value in Series collection

14 ZoomRestore None Reset chart position and cancel zoom

Page 45: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 45 of 212

Events

Version Nombre Parameters Description

3 BeginPaint g as graphics Chart is cleared and before anything is drawn

3 BeforeEndPaint G as graphics Just before image is updated on the form

3 AfterPaint G as graphics After image is updated on the form

11 ValueClick ByVal g As

Graphics,

ByVal serie As

Integer, ByVal

itemIndex As

Integer

Occurs when user click over an item (bar, point, …)

15.1 SelectionDragStart ByVal g As

Graphics Occurs when user start dragging and moving the selection with the mouse and Control key

15.1 SelectionDragEnd ByVal g As

Graphics Occurs when user release the mouse and has dragged/moved the selection with the mouse and Control key

15.3 SelectionMouseAdd ByVal g As

Graphics,

ByVal serie As

Integer, ByVal

itemIndex As

Integer,

ByRef cancel

as boolean

Occurs when a selection is going to be added due to user interaction with mouse. If cancel is set to

true, the new selected item will not be added.

Page 46: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Library Reference

Animate

Description

Start chart animation. Animation style depends on parameters specified.

Definition

Public Sub Animate(ByVal style As STYLEANIMATION, ByVal stepping As Integer)

Parameters

style Can be one of the following: STYLEANIMATION_RISE = 1

STYLEANIMATION_WAVE = 2

stepping Animation speed, from 1 (slowest) to 100 (fastest)

Page 47: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 47 of 212

AnimateTo

Description

Smoothly animates chart from current values to specified target/new values.

Definition

Public Sub AnimateTo(

ByVal style As STYLEANIMATION,

ByVal stepping As Integer,

ByVal targetSeriesData As ArrayList())

Parameters

style Can be one of the following: STYLEANIMATION_RISE = 1

STYLEANIMATION_WAVE = 2

Stepping Animation speed, from 1 (slowest) to 100 (fastest)

targetSeriesData Target/new series values

Page 48: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 48 of 212

Autorefresh

Description

Set control’s refreshing mode. True = automatic refresh, False = manual refresh.

- Automatic (default): control will be repainted after any method call that could change its

appearance, such as BorderColor.

- Manual: control will not be repainted until a call to RefreshChart. Setting Autorefresh to

automatic will also repaint the control.

Definition

Property AutoRefresh() As Boolean

Parameters

Boolean True (automatic) or False (manual).

Returns

Current state of control’s autorefreshing mode (true or false).

Page 49: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 49 of 212

BackColor

Description

Set control’s background color. Note that this property only changes the base color for the background.

The final appearance of background depends on BackStyle property.

Default value is White.

Definition

Public Overrides Property BackColor() As System.Drawing.Color

Parameters

System.Drawing.Color Any color may be used (you can create any color using Color.FromArgb

static function).

Returns

Current background color.

Page 50: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 50 of 212

BackStyle

Description

Set control’s background style: solid or gradient fill. If you choose a gradient fill, the initial and end

colors of the gradient will be calculated using the base color set with BackColor property.

Default value is STYLEBACKGROUND_SOLID.

Definition

Public Property BackStyle() As STYLEBACKGROUND

Parameters

STYLEBACKGROUND Can be any of the following values: STYLEBACKGROUND_SOLID = 0

STYLEBACKGROUND_GRADIENT = 1

STYLEBACKGROUND_GRADIENT_INVERTED = 2

STYLEBACKGROUND_GRADIENT_TUBULAR = 3

STYLEBACKGROUND_GRADIENT_TUBULAR_INVERTED = 4

Returns

Current style for background.

Page 51: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 51 of 212

BorderColor

Description

Set control’s border color

Default value is Color.Red.

Definition

Property BorderColor() As Color

Parameters

Color Any color may be used (you can create any color using Color.FromArgb static function).

Returns

Current color of the control’s border.

Page 52: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 52 of 212

BubbleMaxRadius

Description

Specify the maximum diameter of bubbles (only applies to Bubble Chart).

The diameter of any one bubble is calculated taking the maximum diameter and multiplying it by

value/maximum value.

Default value is 100 pixels.

Definition

Property BubbleMaxRadius() As Integer

Parameters

Integer Maximum diameter of the bubbles in pixels.

Returns

Current maximum diameter of the bubbles in pixels.

Page 53: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 53 of 212

BuiltinDialogAllowed

Description

Set if contextual menu is shown when user right-clicks the chart control.

Default value is TRUE.

Definition

Property BuiltinDialogAllowed() As Boolean

Parameters

Boolean Allow or not allow contextual menu

Returns

Current contextual menu preference (allowed or not allowed).

Page 54: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 54 of 212

BuiltinDialogLanguage

Description

Set contextual menu language.

Default value is LANGUAGE.LANG_ENGLISH

Definition

Property BuiltinDialogLanguage() As LANGUAGE

Parameters

LANGUAGE May be one of the following values: LANGUAGE.LANG_ENGLISH

LANGUAGE.LANG_SPANISH

Returns

Current contextual menu language preference.

Page 55: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 55 of 212

Calculation

Description

Performs an additional calculation and draw it over the chart. Setting this property you can easly add an

average spline or a line that links the top of the bars. The calculation only is applied to some type of

charts, like bars, cylinder, pyramid and point chart.

Default value is CALCULATION_NONE

Definition

Property Calculation() As Calculation

Parameters

CALCULATION May be one of the following values: CALCULATION_NONE = 0

CALCULATION_AVERAGE = 10

CALCULATION_AVERAGE_SPLINE = 11

CALCULATION_PARETO = 20

CALCULATION_TOP_LINE = 30

CALCULATION_TOP_SPLINE = 31

Returns

Current calculation preference.

Page 56: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 56 of 212

CalculationLineStyle

Description

Specify the line style of the additional calculation.

Default value is Pen(Color.Blue, 3)

Definition

Property CalculationLineStyle() As Pen

Parameters

Pen Any System.Drawing.Pen object.

Returns

Pen object holding the current calculation line style

Page 57: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 57 of 212

CastShadows

Description

Draw a subtle shadow behind the graph elements or not.

Default value is False.

Definition

Property CastShadows() As Boolean

Parameters

Boolean Either a subtle shadow is drawn behind the graph elements or not.

Returns

Current preference.

Page 58: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 58 of 212

ChartAddNew

Description

Adds a new, initialized chart object to the render engine of another chart. This method is used to

combine two or more charts into a single chart. No changes are visible until RefreshChart is called.

See Advanced Features at the beginning of this guide for more information.

Definition

Public Sub ChartAddNew()

Parameters

None.

Returns

Nothing.

Page 59: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 59 of 212

ChartAdd

Description

Adds an previously created chart object to the render engine of another chart. This method is used to

combine two or more charts into a single chart. No changes are visible until RefreshChart is called.

See Advanced Features at the beginning of this guide for more information.

Definition

Public Sub ChartAdd(ByVal oChart As CrossingChartsLibrary.CrossingCharts)

Parameters

oChart Chart to be added to the main chart

Returns

Nothing.

Page 60: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 60 of 212

ChartItem

Description

Returns a chart object identified by index.

Definition

Public Function ChartItem(ByVal index As Integer) As

CrossingChartsLibrary.CrossingCharts

Parameters

index Integer index (1=main chart, 2 and above returns additional charts previously

added with ChartAdd or ChartAddNew)

Returns

CrossingCharts object

Page 61: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 61 of 212

ChartRemove

Description

Removes an existing chart object in the render engine of another chart identified by index.

Definition

Public Sub ChartRemove(ByVal index As Integer)

Parameters

index Integer index (MUST be 2 or greater)

Returns

Nothing

Page 62: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 62 of 212

CreateAnimatedGIF

Description

Returns an image object containing an animated GIF image.

Definition

Public Function CreateAnimatedGIF(ByVal intFrames As Integer, ByVal intSpeed As Integer,

ByVal blnLoop As Boolean, ByVal style As STYLEANIMATION) As Image

Parameters

intFrames Number of frames

intSpeed Delay in ms between frames

blnLoop True -> repeat animation forever

style Type of animation. Can be one of the following values: STYLEANIMATION_RISE = 1

STYLEANIMATION_WAVE = 2

Returns

Image object.

Note: you can use Image.Save method to export it to a disk file for example:

Page 63: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 63 of 212

CreatePDF

Description

Returns a PDF representation of current chart.

Definition

Public Function CreatePDF(ByVal orientation As STYLE_ORIENTATION, ByVal margin As

Integer) As Byte()

Parameters

orientation Can be one of the following: ORIENTATION_PORTRAIT = 0

ORIENTATION_LANDSCAPE = 1

Margin Amount of margin in points (eg: 50)

Returns

PDF containing chart image.

Note: see chapter “Advanced feature: PDF Export” for more information.

Page 64: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 64 of 212

CreateSVG

Description

Returns an xml document in SVG format describing the current chart.

Definition

Public Function CreateSVG(ByVal scaleToFit As Boolean) As String

Parameters

scaleToFit True -> scale to fit canvas

Returns

SVG xml document.

Note: see chapter “Advanced feature: SVG charts” for more information.

Page 65: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 65 of 212

DataSource

Description

Allows databinding to another DataGridView control.

You must also set DataSourceMode to help chart control understand the underlying data structure.

Please, refer to online tutorials for databinding samples (XYZ chart databind tutorial for example).

Definition

Property DataSource() As DataGridView

Parameters

DataGridView The control to which databind chart.

Returns

Reference to current databound control

Page 66: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 66 of 212

DataSourceMode

Description

Helps chart control understand the underlying data structure of the databound control.

Definition

Public Property DataSourceMode() As DATASOURCE_SCHEME

Parameters

DATASOURCE_SCHEME Structure of underlying data.

Must be one of the following values:

NONE = 0

Value when databinding is not enabled

XZ_HEADERS_Y_CELLS = 1

Only for XYZ charts. In this case, the X axis range is determined by column headers values and the Z

axis range is determined by row headers values. Y values are the cells’ values.

CELL_VALUES = 2

Only for 1D charts (bar, pie, …). Each row corresponds to a serie. Each value/point equals to a cell in

that row.

Returns

Reference to current databound control

Page 67: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 67 of 212

DataTableBackColor

Description

Sets datatable’s background color.

Default value is Color.White.

Definition

Property DataTableBackColor() As Color

Parameters

Color Any color may be used (you can create any color using Color.FromArgb static

function).

Returns

Current datatable’s background color.

Page 68: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 68 of 212

DataTableColor

Description

Sets datatable’s text color.

Default value is Color.Black.

Definition

Property DataTableColor() As Color

Parameters

Color Any color may be used (you can create any color using Color.FromArgb static

function).

Returns

Current datatable’s text color.

Page 69: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 69 of 212

DataTableFont

Description

Sets datatable’s text font.

Default value is New Font("Arial", 12, FontStyle.Regular, GraphicsUnit.Point).

Definition

Property DataTableFont () As Font

Parameters

Font Any font object may be used.

Returns

Current datatable’s text font.

Page 70: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 70 of 212

DataTableText

Description

Specify datatable’s title.

Default value is “Datatable”.

Definition

Property DataTableText() As String

Parameters

String Title or caption for datatable.

Returns

Current datatable’s title.

Page 71: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 71 of 212

EnableDragItems

Description

Allows user drag of current selection using the mouse left button.

Default value is true

Definition

Property EnableDragItems () As Boolean

Parameters

Boolean Set to false to prevent dragging of selected items using mouse and left click.

Returns

Current state of property.

Page 72: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 72 of 212

EnableDragItemsWithControlKey

Description

Allows user drag of current selection using the mouse left button AND while pressing Control Key.

Default value is true

Definition

Property EnableDragItems () As Boolean

Parameters

Boolean Set to false to prevent dragging of selected items using mouse left click and

control key.

Returns

Current state of property.

Page 73: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 73 of 212

EnableRotationOnSurfaceArea

Description

Allows user rotate XYZ chart by dragging over the surface area.

Default value is true

Definition

Property EnableRotationOnSurfaceArea () As Boolean

Parameters

Boolean Set to false to prevent rotating the chart when dragging over the surface

(only XYZ charts). In this case rotation can only occur if user drags outside

the surface area.

Returns

Current state of property.

Page 74: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 74 of 212

Depth

Description

Specify thickness (vertical size) for 3D pie and doughnut charts.

Default value is 30 pixels.

Definition

Public Property Depth() As Integer

Parameters

Integer Vertical size of pies or doughnut charts

Returns

Current size in pixels.

Page 75: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 75 of 212

GanttSetToday

Description

Set or retrieves the date assigned to the “Today” vertical line in a Gantt chart.

Default value is Now.

Definition

Public Property GanttSetToday() As DateTime

Parameters

DateTime Instant value for the “today” line position

Returns

Current value.

Page 76: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 76 of 212

GanttSetTodayLabel

Description

Set or retrieves the text assigned to the “Today” vertical line in a Gantt chart.

Default value is “Today”.

Definition

Public Property GanttSetTodayLabel() As String

Parameters

String Text for the “today” line position

Returns

Current value.

Page 77: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 77 of 212

GaugeBackStyle

Description

Array of SolidBrush objects for background style of each gauge. Note that you can draw several gauges

at once.

Default value is Nothing, so it’s mandatory that you set this property prior to draw gauge charts.

Definition

Public Property GaugeBackStyle() As SolidBrush()

Parameters

SolidBrush() Array of SolidBrush objects.

Returns

Current values.

Page 78: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 78 of 212

GaugeBigTickStyle

Description

Array of Pen objects for big ticks of each gauge. Note that you can draw several gauges at once.

Default value is Nothing, so it’s mandatory that you set this property prior to draw gauge charts.

Definition

Public Property GaugeBigTickStyle() As Pen()

Parameters

Pen() Array of Pen objects.

Returns

Current values.

Page 79: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 79 of 212

GaugeBorderStyle

Description

Array of Pen objects for border style of each gauge. Note that you can draw several gauges at once.

Default value is Nothing, so it’s mandatory that you set this property prior to draw gauge charts.

Definition

Public Property GaugeBorderStyle() As Pen()

Parameters

Pen() Array of Pen objects.

Returns

Current values.

Page 80: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 80 of 212

GaugeCentralCircleBackStyle

Description

Array of SolidBrush objects for the central circle background style of each gauge. Note that you can

draw several gauges at once.

Default value is Nothing, so it’s mandatory that you set this property prior to draw gauge charts.

Definition

Public Property GaugeCentralCircleBackStyle() As SolidBrush()

Parameters

SolidBrush() Array of SolidBrush objects.

Returns

Current values.

Page 81: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 81 of 212

GaugeCentralCircleBorderStyle

Description

Array of Pen objects for the central circle border style of each gauge. Note that you can draw several

gauges at once.

Default value is Nothing, so it’s mandatory that you set this property prior to draw gauge charts.

Definition

Public Property GaugeCentralCircleBorderStyle() As Pen()

Parameters

Pen() Array of Pen objects.

Returns

Current values.

Page 82: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 82 of 212

GaugeCentralCircleRadius

Description

Array of Single values for the radius of each gauge. Note that you can draw several gauges at once.

Default value is Nothing, so it’s mandatory that you set this property prior to draw gauge charts.

Definition

Public Property GaugeCentralCircleRadius() As Single()

Parameters

Single() Array of Single values.

Returns

Current values.

Page 83: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 83 of 212

GaugeCentralCircleRadius

Description

Array of Single values for the radius of each gauge. Note that you can draw several gauges at once.

Default value is Nothing, so it’s mandatory that you set this property prior to draw gauge charts.

Definition

Public Property GaugeCentralCircleRadius() As Single()

Parameters

Single() Array of Single values.

Returns

Current values.

Page 84: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 84 of 212

GaugeMarginFactor

Description

Percentage factor for inner margin between each gauge.

Default value is 0.1. You may set a higher or lower value than 0.1.

Definition

Public Property GaugeMarginFactor() As Single

Parameters

Single Decimal value that’s the percentage of separation among each gauge graph.

Returns

Current values.

Page 85: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 85 of 212

GaugeNeedleStyle

Description

Array of Pen objects for each gauge’s central needle. Note that you can draw several gauges at once.

Default value is Nothing, so it’s mandatory that you set this property prior to draw gauge charts.

Definition

Public Property GaugeNeedleStyle() As Pen()

Parameters

Pen() Array of Pen objects.

Returns

Current values.

Page 86: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 86 of 212

GaugeSmallTickStyle

Description

Array of Pen objects for small ticks of each gauge. Note that you can draw several gauges at once.

Default value is Nothing, so it’s mandatory that you set this property prior to draw gauge charts.

Definition

Public Property GaugeSmallTickStyle() As Pen()

Parameters

Pen() Array of Pen objects.

Returns

Current values.

Page 87: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 87 of 212

GridBackgroundImage

Description

Assign an image object to grid’s background.

Default value is Nothing.

Definition

Public Property GridBackgroundImage() As Image

Parameters

Image Image object to be set as grid’s background.

Returns

Current background image object.

Page 88: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 88 of 212

GridBackgroundImageTransparency

Description

Set a level of transparency to grid background image.

Default value is 0 (opaque).

Definition

Public Property GridBackgroundImageTransparency() As Integer

Parameters

Integer % of transparency (0=opaque, 100=fully transparent)

Returns

Current transparency level.

Page 89: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 89 of 212

GridLineStyle

Description

Set the line style and color for grid’s vertical and horizontal lines.

Default value is Pen(Color.DarkGray).

Definition

Public Property GridLineStyle() As Pen

Parameters

Pen Pen object with color and line style

Returns

Current line style and color (pen object)

Page 90: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 90 of 212

HoleSize

Description

Specify hole size in pixels for doughnut charts.

Default value is 30 pixels.

Definition

Property HoleSize() As Integer

Parameters

Integer Hole size in pixels

Returns

Current hole size in pixels.

Page 91: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 91 of 212

HotSpotBackColor

Description

Specify background color for hotspot (tooltips shown when mouse moves over a value).

Default value is Color.FromArgb(220, 255, 255, 64)

Definition

Public Property HotSpotBackColor() As Color

Parameters

Color Background color. Use Color.FromArgb to create a new color.

Returns

Current setting.

Page 92: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 92 of 212

HotSpotBackColor

Description

Specify background color for hotspots (tooltips shown when mouse moves over a value).

Default value is Color.FromArgb(220, 255, 255, 64)

Definition

Public Property HotSpotBackColor() As Color

Parameters

Color Background color. Use Color.FromArgb to create a new color.

Returns

Current setting.

Page 93: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 93 of 212

HotSpotColor

Description

Specify text color for hotspots (tooltips shown when mouse moves over a value).

Default value is Color.FromArgb(255, 0, 0, 128)

Definition

Public Property HotSpotColor() As Color

Parameters

Color Text forecolor. Use Color.FromArgb to create a new color.

Returns

Current setting.

Page 94: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 94 of 212

HotSpotsCrossLineStyle

Description

Set or returns current line style of tooltip cross. See also HotSpotShowCross property.

Default value is Pen(Color.FromArgb(255, 220, 32, 32)).

Definition

Public Property HotSpotCrossLineStyle() As Pen

Parameters

Pen Any pen object specifying color and/or line style.

Returns

Current setting.

Page 95: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 95 of 212

HotSpotsEnabled

Description

Set whether values tooltips will be shown when mouse if moved over the chart.

Default value is False

Definition

Public Property HotSpotsEnabled() As Boolean

Parameters

Boolean Enable/disable tooltips

Returns

Current setting.

Page 96: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 96 of 212

HotSpotsDateTimeFormat

Description

Set or returns datetime format for tooltips when a date/time is shown. Only works in charts that have a

datetime range in the x-axis, like X/Y DateTime, X/Y Line DateTime or any chart which x-axis is set to

FIXED_DATETIME.

Default value is “d”

Definition

Public Property HotSpotDateTimeFormat() As String

Parameters

String Custom datetime string format (see Visual Studio .NET help for a list of supported codes)

Returns

Current setting.

Page 97: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 97 of 212

HotSpotsNumericFormat

Description

Set or returns datetime format for tooltips when a numeric value is shown.

Default value is “N” (which includes 2 decimals).

Definition

Public Property HotSpotNumericFormat() As String

Parameters

String Custom numeric string format (see Visual Studio .NET help for a list of supported codes)

For example, use “0” (zero) for integer numbers only.

Returns

Current setting.

Page 98: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 98 of 212

HotSpotHitTestPrecision

Description

Set or returns the maximum distance in pixels from the mouse to a chart element to be considered as

highlighted.

Default value is 10 pixels.

If you pass a negative value, then the hit testing function will return the nearest point to the mouse

pointer with a distance less than this precision value.

Definition

Public Property HotSpotHitTestPrecision () As Integer

Parameters

Integer The distance in pixels.

Returns

Current setting.

Page 99: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 99 of 212

Image

Description

Returns last chart rendering as an bitmap object.

Definition

ReadOnly Property Image() As Bitmap

Parameters

None.

Returns

Last chart rendered.

Page 100: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 100 of 212

ItemsHighlight

Description

Use this property to explode any number of sectors in a pie or doughnut chart (either 2d or 3d style).

Definition

Property ItemsHighlight() As String()

Parameters

String() Array of strings. Each item corresponds to a sector of the pie. If the item contains any

character, the sector is exploded.

For example:

Dim explode() as string = String() { “1”, “”, “OK”, “This”, “” }

The previous array would result in exploding the first, third and fourth sectors. “1”, “OK”

and “This” are irrelevant in this version. What is important is that the string item must be

different from “”. Future versions of the library may use the string item to show a

particular message over each exploded sector.

Returns

Current explode configuration as an array of Strings.

Page 101: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 101 of 212

ItemsLegend

Description

Array of strings containing item names for each value in a serie (all series share the same item names).

This is useful in pie charts, where each value may have a description or name associated.

Definition

Property ItemsLegend() As String()

Parameters

String() Array of strings. It is important to note that the length of this array must be equal to the

number of values in any serie (all series should have the same number of values).

Returns

Current explode configuration as an array of Strings.

Page 102: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 102 of 212

LegendAlignment

Description

Specify location for legend.

Default value is STYLEALIGNMENT_MIDDLE_RIGHT

Definition

Property LegendAlignment() As STYLEALIGNMENT

Parameters

STYLEALIGNMENT Location enumeration. Can be one of the following: STYLEALIGNMENT_MIDDLE_RIGHT = 0

STYLEALIGNMENT_BOTTOM_RIGHT = 1

STYLEALIGNMENT_BOTTOM_CENTER = 2

STYLEALIGNMENT_BOTTOM_LEFT = 3

STYLEALIGNMENT_MIDDLE_LEFT = 4

STYLEALIGNMENT_TOP_LEFT = 5

STYLEALIGNMENT_TOP_CENTER = 6

STYLEALIGNMENT_TOP_RIGHT = 7

Note that top center and bottom center options will draw the legend horizontally

while the rest of options will draw the legend vertically.

Returns

Current explode configuration as an array of Strings.

Page 103: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 103 of 212

LegendBackColor

Description

Specify color for legend’s background. Only applies to the legend title.

Default value is Color.White

Definition

Public Property LegendBackColor() As Color

Parameters

Color Any color may be used (you can create any color using Color.FromArgb static

function).

Returns

Current legend’s backcolor.

Page 104: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 104 of 212

LegendColor

Description

Set legend text color.

Default value is Color.Black

Definition

Property LegendColor() As Color

Parameters

Color Any color may be used (you can create any color using Color.FromArgb static function).

Returns

Current color of the legend text.

Page 105: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 105 of 212

LegendColorChartSteps

Description

Specify the number of intervals for the color-ramp legend

Default value is 5

Definition

Property LegendColorChartSteps() As Integer

Parameters

Integer Number of intervals (minimum 2)

Returns

Current number of intervals.

Page 106: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 106 of 212

LegendFont

Description

Sets legend’s text font.

Default value is New Font("Arial", 12, FontStyle.Regular, GraphicsUnit.Point).

Definition

Property LegendFont () As Font

Parameters

Font Any font object may be used.

Returns

Current legend’s text font.

Page 107: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 107 of 212

LegendText

Description

Set legend’s title.

Default value is “Legend”

Definition

Property LegendText() As String

Parameters

String Legend’s title.

Returns

Current legend’s title.

Page 108: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 108 of 212

LicenseeIdentifier

Description

Set serial number and unlock the trial version. This function should be the first call to the control just

after its creation.

Definition

Property LicenseeIdentifier() As String

Parameters

String Unique licensee’s serial number.

Returns

Current serial number.

Page 109: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 109 of 212

MarginBottom

Description

Specify the inner bottom margin in pixels (distance between the border and the lower limit of the chart).

Default value is 20

Definition

Property MarginBottom() As Integer

Parameters

Integer Distance in pixels

Returns

Current preference.

Page 110: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 110 of 212

MarginLeft

Description

Specify the inner left margin in pixels (distance between the border and the left limit of the chart).

Default value is 20

Definition

Property MarginLeft() As Integer

Parameters

Integer Distance in pixels

Returns

Current preference.

Page 111: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 111 of 212

MarginRight

Description

Specify the inner right margin in pixels (distance between the border and the right limit of the chart).

Default value is 20

Definition

Property MarginRight() As Integer

Parameters

Integer Distance in pixels

Returns

Current preference.

Page 112: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 112 of 212

MarginTop

Description

Specify the inner top margin in pixels (distance between the border and the top limit of the chart).

Default value is 20

Definition

Property MarginTop() As Integer

Parameters

Integer Distance in pixels

Returns

Current preference.

Page 113: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 113 of 212

MarkHighest

Description

Whether maximum value of the entire chart should be highlighted from the rest.

Default value is False

Definition

Property MarkHighest() As Boolean

Parameters

Boolean Highlight or not the maximum value of the chart.

Returns

Current preference.

Page 114: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 114 of 212

MarkLowest

Description

Whether minimum value of the entire chart should be highlighted from the rest.

Default value is False

Definition

Property MarkLowest () As Boolean

Parameters

Boolean Highlight or not the minimum value of the chart.

Returns

Current preference.

Page 115: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 115 of 212

PieBorderStyle

Description

Specify the line style for the borders of pie segments (2D and 3D pies).

Default value is Pen(Color.Transparent). If this property is not set, then borders will share the

segment color.

Definition

Property PieBorderStyle As Pen = new Pen(Color.Transparent)

Parameters

Pen object Pen object with line style, width, color…

Returns

Current setting value.

Page 116: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 116 of 212

PointSize

Description

Specify the size in pixels of points (see PointStyle or ShowPoints properties).

Default value is 4

Definition

Property PointSize() As Integer

Parameters

Integer Point size in pixels

Returns

Current points’ size.

Page 117: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 117 of 212

PointStyle

Description

Specify the point style when a point is drawn over the chart. Applies to point or scatter charts, and line

or area charts when ShowPoints is enabled.

Default value is STYLEPOINT_CIRCLE

Definition

Property PointStyle() As STYLEPOINT

Parameters

POINTSTYLE Can be one of the following values: STYLEPOINT_CIRCLE = 0

STYLEPOINT_RECTANGLE = 1

STYLEPOINT_TRIANGLE = 2

Returns

Current preference.

Page 118: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 118 of 212

Quality

Description

Set the overall rendering quality factor.

Default value is SmoothingMode.HighQuality

Definition

Public Property Quality() As SmoothingMode

Parameters

SmoothingMode Choose one of the following values:

HighSpeed (Faster)

Default (Standard)

AntiAlias (Better but slower)

HighQuality (Best, slowest)

Returns

Current quality factor.

Page 119: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 119 of 212

QualityMarkers

Description

Set the rendering quality factor for selections, highlights and additional markers.

Default value is SmoothingMode.HighQuality

Definition

Public Property QualityMarkers() As SmoothingMode

Parameters

SmoothingMode Choose one of the following values:

HighSpeed (Faster)

Default (Standard)

AntiAlias (Better but slower)

HighQuality (Best, slowest)

Returns

Current quality factor.

Page 120: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 120 of 212

Reset

Description

Clears all data and assign default values to all properties.

Generally, Reset is used before any other library commands.

Definition

Public Sub Reset()

Parameters

None.

Returns

None..

Page 121: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 121 of 212

Resolution

Description

Specify the output resolution in DPI (dots per inch).

Default value is 72 (screen resolution). Increase this value for printing purposes (for example 200 or

300).

Definition

Property Resolution() As Integer

Parameters

Integer Maximum value recommended depends on memory available.

Returns

Current resolution.

Page 122: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 122 of 212

SelectionAddItem

Description

Highlight/select a value of the chart. Use SelectionClear to remove any selection.

Definition

Public Sub SelectionAddItem(ByVal seriesIndex As Integer, ByVal itemIndex As Integer)

Parameters

seriesIndex, itemIndex Indexes of the value in the Series collection

Returns

Nothing

Page 123: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 123 of 212

SelectionAutoHighlight

Description

Highlight new selected items chart area. Currently supports XYZ quad surface charts.

Definition

Property SelectionAutoHighlight() As Boolean

Parameters

Boolean State of auto highlight

Returns

Nothing

Page 124: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 124 of 212

SelectionAutoHighlightColor

Description

Color used for SelectionAutoHighlight.

Definition

Property SelectionAutoHighlightColor() As Color

Parameters

Color Color for the highlight effect.

Returns

Nothing

Page 125: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 125 of 212

Series

Description

Assign values to the chart.

Values in the chart are expressed as an array of ArrayList. The array has one arraylist for each serie.

The arraylist (each serie) may have any number of values. A value in an arraylist usually is an

integer/single/double value, but it may be also an array in case of a multidimensional chart, like scatter

(2 dimensions), bubble and high-low-close (3 dimensions) or candlestick (4 dimensions).

For example, in a 2d bar chart, each bar only needs a single value (1 dimension). In scatter charts, each

value must be a pair of single (x and y position for point) expressed as an array of single. In bubble

charts, each value must be an array of three singles (x, y and size of the bubble), an so on.

Instead of using this property, you may also use the SeriesFactory helper class. See “Populating the

chart with values” chapter for more information.

Definition

Property Series() As ArrayList()

Parameters

ArrayList() Array of ArrayLists

Returns

Current chart values.

Page 126: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 126 of 212

SeriesColor

Description

One dimension array of colors for series. Each color in the array corresponds to a serie (all values in a

serie share the same colors, except for pie and doughnut charts, where each value in array corresponds

to one value).

Definition

Property SeriesColor() As Color()

Parameters

Color() Array of System.Drawing.Color values.

Returns

Current colors for series.

Page 127: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 127 of 212

SeriesBorderStyle

Description

One dimension array of pen objects for each series’ bar borders. Each pen in the array corresponds to a

serie (all values in a serie share the same pen style).

Definition

Property SeriesBorderStyle () As Pen()

Parameters

Pen () Array of System.Drawing.Pen objects

Returns

Current pen styles for series.

Page 128: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 128 of 212

Page 129: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 129 of 212

SeriesFillStyle

Description

One dimension array of brush objects for series. Each brush in the array corresponds to a serie (all

values in a serie share the same brush style). This property only applies to Line Chart.

Definition

Property SeriesFillStyle() As Brush()

Parameters

Brush () Array of System.Drawing.Brush object

Returns

Current brush styles for series.

Page 130: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 130 of 212

SeriesLegend

Description

One dimension array of string values containing series titles.

Definition

Property SeriesLegend() As String()

Parameters

String() Array of series titles.

Returns

Current series titles.

Page 131: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 131 of 212

SeriesLineStyle

Description

Array of System.Drawing.Pen objects containing a pen object for each serie. This property only applies

to Line Chart style.

Definition

Property SeriesLineStyle() As Pen()

Parameters

String() Array of Pen objects

Returns

Current pen objects used for line drawing.

Page 132: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 132 of 212

SeriesPicture

Description

Array of Image objects containing a Image object for each serie. This property only applies to Picture

Chart style.

Definition

Property SeriesPictures() As Image()

Parameters

Image() Array of Image objects

Returns

Current image objects used for picture drawings.

Page 133: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 133 of 212

SettingsFromString

Description

This function will apply look and feel settings packed in a string value (the string may be large – from 4

to 50+ Kbytes, depending on which settings saved, pictures, …)

Definition

Public WriteOnly Property SettingsFromString() As String

Parameters

String Look and feel settings packed in a base64 encoded string

Returns

Nothing

Page 134: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 134 of 212

ShadowColored

Description

Use colored shadows. Set this property to false and shadows will be gray.

Default value is false.

Definition

Property ShadowColored() As Boolean

Parameters

Boolean True=colored shadows, False=gray shadows.

Returns

Current preference.

Page 135: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 135 of 212

ShadowOffset

Description

Distance of the shadow in pixels. Note that shadows will begin to dim if you set this value too high (this

is a nice effect).

Default value is 5.

Definition

Property ShadowOffset () As Integer

Parameters

Integer Distance in pixels.

Returns

Current preference.

Page 136: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 136 of 212

ShadowSmooth

Description

Use diffuse/soft shadows. If set to false shadows will be solid.

Default value is true.

Definition

Property ShadowColored() As Boolean

Parameters

Boolean True=soft shadows, False=solid shadows.

Returns

Current preference.

Page 137: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 137 of 212

ShowDataTable

Description

Whether a table with series’ data is shown at the bottom of the control.

Default value is true.

Definition

Property ShowDataTable() As Boolean

Parameters

Boolean Show or not the datatable

Returns

Current preference.

Page 138: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 138 of 212

ShowDividerX

Description

Whether vertical separator lines are drawn over the chart, grouping the items of different series.

Also affects to vertical lines in the datatable.

Default value is true.

Definition

Property ShowDividerX() As Boolean

Parameters

Boolean Show or not the vertical lines

Returns

Current preference.

Page 139: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 139 of 212

ShowItemsLegend

Description

Useful for pie or doughnut charts, where items usually have names. Set this property to TRUE to show

the items names on the datatable. Must be used in conjunction with ItemsLegend property.

Default value is false

Definition

Property ShowItemsLegend() As Boolean

Parameters

Boolean Show or not the names of the items on the datatable.

Returns

Current preference.

Page 140: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 140 of 212

ShowLegend

Description

Show or hide the legend. To specify the position for the legend use LegendAlignment property.

Default value is true.

Definition

Property ShowLegend() As Boolean

Parameters

Boolean Show or not the legend

Returns

Current preference.

Page 141: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 141 of 212

ShowLegendInDataTable

Description

Show or hide the legend names on the first column of the datatable.

Default value is true.

Definition

Public Property ShowLegendInDataTable() As Boolean

Parameters

Boolean Show or not the legend in the datatable

Returns

Current preference.

Page 142: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 142 of 212

ShowPoints

Description

Draw additional markers over some styles of charts, like line or area charts.

Default value is false.

Definition

Property ShowPoints() As Boolean

Parameters

Boolean Show or not points or additional markers.

Returns

Current preference.

Page 143: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 143 of 212

ShowSolidColors

Description

Deactivate gradients and use only plain colors. When you specify a color for an element (say a bar

serie), when ShowSolidColors = false, the bar is drawn using a gradient of colors based upon the color

you specified for the element. The range for the gradient is calculated adding a 20% of dark to the

original color for one limit and adding a 20% of brightness to the original color for the other limit.

Setting this property to TRUE, will ignore the gradient and use the same color for the entire element.

Default value is false.

Definition

Property ShowSolidColors() As Boolean

Parameters

Boolean True will use only plain colors, False will use gradients.

Returns

Current preference.

Page 144: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 144 of 212

ShowSurface3d

Description

Draws a ocean-like surface for 3d charts. Negatives values sinks into the water while positive values

arise. This property is useful to enhance the positive values versus the negative values.

Default value is false.

Definition

Property ShowSurface3d() As Boolean

Parameters

Boolean Show or not “surface line”.

Returns

Current preference.

Page 145: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 145 of 212

ShowValues

Description

Show or not the values over the chart.

Default value is true.

Definition

Property ShowValues() As Boolean

Parameters

Boolean Show or not the values over the chart.

Returns

Current preference.

Page 146: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 146 of 212

ShowValuesMax

Description

Maximum value for items’ captions to be displayed.

Default value is Double.Max (unlimited).

Definition

Property ShowValuesMax() As Double

Parameters

Double Max range.

Returns

Current preference.

Page 147: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 147 of 212

ShowValuesMin

Description

Minimum value for items’ captions to be displayed.

Default value is Double.Min (unlimited).

Definition

Property ShowValuesMin() As Double

Parameters

Double Min range.

Returns

Current preference.

Page 148: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 148 of 212

ShowXAxis

Description

Show or not the X-Axis (and its values).

Default value is False.

Definition

Property ShowXAxis() As Boolean

Parameters

Boolean Show or not the X-axis (ant is values).

Returns

Current preference.

Page 149: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 149 of 212

SlantX

Description

Specify the amount in pixels for X displacement resulting in a pseudo Y-Axis rotation. Only applies to 3d

charts.

Default value is 30.

Definition

Public Property SlantX() As Single

Parameters

Single Amount in pixels for the X-axis displacement.

Returns

Current preference.

Page 150: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 150 of 212

SlantY

Description

Specify the amount in pixels for Y displacement resulting in a pseudo X-Axis rotation. Only applies to 3d

charts.

Default value is 30.

Definition

Public Property SlantX() As Single

Parameters

Single Amount in pixels for the X-axis displacement.

Returns

Current preference.

Page 151: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 151 of 212

Style

Description

Set the chart style (type). Default value is STYLE2D3D.STYLE2D_BAR.

Definition Property Style() As STYLE2D3D

Parameters

STYLE2D3D Can be one of the following values: STYLE2D_BAR = 1

STYLE2D_ACUM = 2

STYLE2D_LINE = 3

STYLE2D_POINT = 4

STYLE2D_PIE = 5

STYLE2D_STACKED_AREA = 6

STYLE2D_CANDLESTICK = 7

STYLE2D_HIGHLOWCLOSE = 8

STYLE2D_HIGHLOW = 9

STYLE2D_SPLINE = 10

STYLE2D_XY = 11

STYLE2D_BUBBLE = 12

STYLE2D_PYRAMID = 13

STYLE2D_PICTURES = 14

STYLE2D_DOUGHNUT = 15

STYLE2D_CYLINDER = 16

STYLE2D_ROUNDED_BAR = 17

STYLE2D_HORIZONTAL_BAR = 18

STYLE2D_ACUM_FIXED = 19

STYLE2D_XY_DATETIME = 20

STYLE2D_GAUGE = 22

STYLE2D_LINE_DATETIME = 21

STYLE2D_XY_SPLINE = 23

STYLE2D_XY_SPLINE_DEV = 24

STYLE2D_GANTT = 25

STYLE2D_RADAR = 26

STYLE3D_ACUM_BAR = 101

STYLE3D_LINE = 102

STYLE3D_STACKED_AREA = 103

STYLE3D_COLUMN = 104

STYLE3D_PIE = 105

STYLE3D_DOUGHNUT = 106

STYLE3D_CYLINDER = 107

STYLE3D_SPLINE = 108

STYLE3D_SPLINE_AREA = 109

STYLE3D_SPLINE_STACKED_AREA = 110

STYLE3D_STACKED_BAR = 111

STYLE3D_STACKED_COLUMN = 112

Returns

Current preference.

Page 152: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 152 of 212

Thickness

Description

Specify the width in pixels of cylinders in a cylinder chart.

Default value is 30 pixels.

Definition

Property Thickness() As Integer

Parameters

Integer Amount in pixels for the width of cylinder charts.

Returns

Current preference

Page 153: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 153 of 212

Title

Description

Specify the main title of the chart. Set to “” to hide the title.

Default value is “Title”.

Definition

Property Title() As String

Parameters

String Chart’s title

Returns

Current chart’s title.

Page 154: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 154 of 212

TitleColor

Description

Specify the text color for main title.

Default value is black.

Definition

Property TitleColor() As Color

Parameters

Color Text color for main title.

Returns

Current text color of main title.

Page 155: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 155 of 212

TitleFont

Description

Specify the font for the main title of the chart.

Default value: Font("Arial", 15, FontStyle.Bold, GraphicsUnit.Point)

Definition

Property TitleFont() As Font

Parameters

Font Font of chart’s title

Returns

Current font of chart’s title.

Page 156: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 156 of 212

ValuesAlignment

Description

Specify the alignment for values in the datatable.

Default value is StringAlignment.Far.

Definition

Property ValuesAlignment() As StringAlignment

Parameters

StringAlignment Far (right), Center or Near (left)

Returns

Current setting.

Page 157: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 157 of 212

ValuesBackColor

Description

Specify the text backcolor for values. To show/hide vales use ShowValues property.

Default value is Color.FromArgb(255, 192, 255, 255).

Definition

Property ValuesBackColor() As Color

Parameters

Color Text color for values.

Returns

Current background color of values.

Page 158: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 158 of 212

ValuesColor

Description

Specify the text color for values. To show/hide vales use ShowValues property.

Default value is black.

Definition

Property ValuesColor() As Color

Parameters

Color Text color for values.

Returns

Current text color of values.

Page 159: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 159 of 212

ValuesFont

Description

Specify the font used for values over the chart (for datatable see DataTableFont property).

Default value is Font("Arial", 12, FontStyle.Regular, GraphicsUnit.Point)

Definition

Property ValuesFont() As Font

Parameters

Font Any font object.

Returns

Current setting.

Page 160: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 160 of 212

ValuesFormat

Description

Specify the string format for values. Sample format are “p” (percentage) and “N” (standard number).

Refer to .NET documentation for standard and custom string formats.

Default value is “N”.

Definition

Property ValuesFormat() As String

Parameters

String Format string for values.

Returns

Current format string.

Page 161: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 161 of 212

ValuesLocationStyle

Description

Specify the location style for values.

Default value is STYLECAPTIONLOCATION_SMART_PLACEMENT.

Definition

Property ValuesLocationStyle() As STYLECAPTIONLOCATION

Parameters

STYLECAPTIONLOCATION Location style. Can be one of the following values: STYLECAPTIONLOCATION_DEFAULT = 0

STYLECAPTIONLOCATION_INSIDE = 1

STYLECAPTIONLOCATION_SMART_PLACEMENT = 2

Note: Inside only applies to 2d bar charts. Smart placement will avoid label overlapping. We suggest you

experiment with different values.

Returns

Current location style for values.

Page 162: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 162 of 212

ValuesStyle

Description

Specify the appearance of values.

Default value is STYLECAPTION_ROUNDED_SQUARE.

Definition

Property ValuesStyle() As STYLECAPTION

Parameters

STYLECAPTION Appearance style for values. Can be one of the following values: STYLECAPTION_STANDARD = 0

STYLECAPTION_ROUNDED_SQUARE = 1

Returns

Current values style.

Page 163: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 163 of 212

WallsBackColorPrincipal

Description

Specify the main color for grid background.

Default value is Color.FromArgb(64, 148, 232, 255).

Definition

Property WallsBackColorPrincipal() As Color

Parameters

Color Any System.Drawing.Color

Returns

Current preference.

Page 164: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 164 of 212

WallsBackColorSecondary

Description

Specify the secondary color for grid background.

Default value is Color.FromArgb(128, 148, 232, 255).

Definition

Property WallsBackColorSecondary() As Color

Parameters

Color Any System.Drawing.Color

Returns

Current preference.

Page 165: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 165 of 212

WallsBackStyle

Description

Specify the fill style for walls in 3d charts.

Default value is STYLEWALLBACKGROUND_BANDS.

Definition

Property WallsBackStyle() As STYLEWALLBACKGROUND

Parameters

STYLEWALLBACKGROUND Can be one of the following values: STYLEWALLBACKGROUND_TRANSPARENT = 0

STYLEWALLBACKGROUND_BANDS = 1

STYLEWALLBACKGROUND_CHESS = 2

Returns

Current preference.

Page 166: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 166 of 212

WallsStyle

Description

Specify the style of grids in 3d charts.

Default value is STYLEWALLS_NOWALLS.

Definition

Public Property WallStyle() As STYLEWALLS

Parameters

STYLEWALLS Can be one of the following values:

STYLEWALLS_NOWALLS = 0

STYLEWALLS_BOXED = 1

STYLEWALLS_VISIBLE = 2

Returns

Current preference.

Page 167: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 167 of 212

XAxisColor

Description

Specify the color for X-axis items.

Default value is Color.Black.

Definition

Property XAxisColor() As Color

Parameters

Color Any System.Drawing.Color

Returns

Current preference.

Page 168: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 168 of 212

XAxisDirection

Description

Specifies the orientation (direction) of the X-Axis in XYZ charts.

A value of 1 indicates left to right direction (for instance, the zero level will be at the left of the chart

from a front-view). A value of -1 indicates right to left (zero will be at the rightest part of the chart).

Default value is 1 (left to right).

Definition

Property XAxisDirection () As Long

Parameters

Long Direction of X-Axis (-1 or 1)

Returns

Current preference.

Page 169: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 169 of 212

XAxisDividersCount

Description

Number of X-axis line dividers and labels.

Default value is 0 (automatic).

Definition

Property XAxisDividersCount() As Long

Parameters

Long Number of X-Axis dividers.

Returns

Current setting.

Page 170: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 170 of 212

XAxisHeight

Description

Height of the space allocated for X-Axis labels. Maximum effective value will be the size needed to show

any X-Axis label without word-wrap. If your labels are too long, try reducing this value so word-

wrapping may occur.

Default value is 1000.

Definition

Property YAxisHeight () As Integer

Parameters

Integer Height in pixels for X-Axis labels space

Returns

Current height.

Page 171: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 171 of 212

XAxisLabelsRotated

Description

Labels of XAxis will be rotated 45 degrees if this property is set to True. Rotating labels reduces the

space they occupy and improve results when labels are too long.

Default value is False.

Definition

Property XAxisLabelsRotated() As Boolean

Parameters

Boolean Rotate or not the X-Axis labels.

Returns

Current preference.

Page 172: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 172 of 212

XAxisLabelsRotated90

Description

Labels of XAxis will be rotated 90 degrees if this property is set to True. Rotating labels reduces the

space they occupy and improve results when labels are too long.

Default value is False.

Definition

Property XAxisLabelsRotated90() As Boolean

Parameters

Boolean Rotate or not the X-Axis labels.

Returns

Current preference.

Page 173: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 173 of 212

XAxisNumericFormat

Description

Specify the string format for X-axis values. Sample format are “p” (percentage) and “N” (standard

number). Refer to .NET documentation for standard and custom string formats. This property should be

used in scatter charts.

Default value is “N”.

Definition

Property XAxisNumericFormat () As String

Parameters

String Format string for values.

Returns

Current format string.

Page 174: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 174 of 212

XAxisScaleMaximum

Description

Set the upper limit for the X-Axis scale. Must be used with XAxisScaleMode = SCALEMODE_FIXED.

Default value is 0.

Definition

Property XAxisScaleMaximum() As Single

Parameters

Single Upper limit for the X-Axis scale.

Returns

Current preference.

Page 175: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 175 of 212

XAxisScaleMaximumDateTime

Description

Set the upper limit for the X-axis scale where XAxisScaleMode is set to SCALEMODE_FIXED_DATETIME.

Default value is 0.

Definition

Property XAxisScaleMaximumDateTime() As DateTime

Parameters

DateTime Upper limit for the X-Axis scale.

Returns

Current preference.

Page 176: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 176 of 212

XAxisScaleMinimum

Description

Set the lower limit for the X-Axis scale. Must be used with XAxisScaleMode = SCALEMODE_FIXED.

Default value is 0.

Definition

Property XAxisScaleMinimum() As Single

Parameters

Single Lower limit for the X-Axis scale.

Returns

Current preference.

Page 177: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 177 of 212

XAxisScaleMinimumCalculated

Description

Readonly property that returns the actual calculated minimum value for X Axis. Note that you can have

XAxisScaleMinimum ignored with XAxisScaleMode set to automatic. Then this function will return the

minimum value in source data for X Axis.

Default value is 0.

Definition

Property XAxisScaleMinimumCalculated() As Single

Parameters

Returns

Current calculated minimum X Axis value.

Page 178: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 178 of 212

XAxisScaleMaximumCalculated

Description

Readonly property that returns the actual calculated maximum value for X Axis. Note that you can have

XAxisScaleMaximum ignored with XAxisScaleMode set to automatic. Then this function will return the

maximum value in source data for X Axis.

Default value is 0.

Definition

Property XAxisScaleMaximumCalculated() As Single

Parameters

Returns

Current calculated maximum X Axis value.

Page 179: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 179 of 212

XAxisScaleMinimumDateTime

Description

Set the lower limit for the X-axis scale where XAxisScaleMode is set to SCALEMODE_FIXED_DATETIME.

Default value is 0.

Definition

Property XAxisScaleMinimumDateTime() As DateTime

Parameters

DateTime Lower limit for the X-Axis scale.

Returns

Current preference.

Page 180: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 180 of 212

XAxisScaleMode

Description

Specify the scale mode for X-Axis rule. By default, X-Axis rule values are calculated automatically from

the values of the chart (minimum value of the X-Axis rule equals the minimum X of any value in the

chart). Set this property to SCALEMODE_FIXED so you can set the minimum and maximum values for

the rule (see XAxisScaleMinimum and XAxisScaleMaximum properties).

Default value is SCALEMODE.AUTOMATIC

Definition

Property XAxisScaleMode () As SCALEMODE

Parameters

SCALEMODE Can be one of the following values: SCALEMODE_AUTOMATIC = 0

SCALEMODE_FIXED = 1

SCALEMODE_FIXED_DATETIME = 2

SCALEMODE_AUTOMATIC_MINIMUM_ZERO = 3

Returns

Current preference.

Page 181: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 181 of 212

XAxisTitle

Description

Set the title for the X-Axis. Set this property to “” to hide the X-Axis title.

Default value is “” (title hidden).

Definition

Property XAxisTitle() As String

Parameters

String Title for X-axis.

Returns

Current X-axis’ title.

Page 182: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 182 of 212

XAxisTitleFont

Description

Specify the font to be used for the X-Axis title.

Default value is Font("Arial", 11, FontStyle.Bold, GraphicsUnit.Point).

Definition

Property XAxisTitleFont() As Font

Parameters

Font Any System.Drawing.Font object.

Returns

Current X-axis’ title font.

Page 183: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 183 of 212

XAxisValuesFont

Description

Specify the font to be used for the X-Axis labels.

Default value is Font("Arial", 12, FontStyle.Regular, GraphicsUnit.Point).

Definition

Property XAxisValuesFont() As Font

Parameters

Font Any System.Drawing.Font object.

Returns

Current X-axis’ title font.

Page 184: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 184 of 212

YAxisColor

Description

Specify the color for Y-axis items.

Default value is Color.Black.

Definition

Property YAxisColor() As Color

Parameters

Color Any System.Drawing.Color

Returns

Current preference.

Page 185: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 185 of 212

YAxisDividersCount

Description

Number of Y-Axis line dividers. To hide Y-Axis dividers set this property to 0 (zero). Set this property to

10 and each line would be useful to mark intervals of 10%.

Default value is 10.

Definition

Property YAxisDividersCount () As Long

Parameters

Long Number of Y-Axis dividers.

Returns

Current preference.

Page 186: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 186 of 212

YAxisDirection

Description

Specifies the orientation (direction) of the Y-Axis in XYZ charts.

A value of 1 indicates upwards direction (for instance, the zero level will be at the bottom of the chart).

A value of -1 indicates downwards direction.

Default value is 1 (upwards).

Definition

Property YAxisDirection () As Long

Parameters

Long Direction of Y-Axis (-1 or 1)

Returns

Current preference.

Page 187: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 187 of 212

YAxisIndicators

Description

Array or Y_AXIS_INDICATORS structure objects. Each indicator represents an horizontal line over the

chart useful for marking special limits.

Default value is Nothing.

Y_AXIS_INDICATORS structure:

Public Structure YAXIS_INDICATORS

Dim Caption As String ‘ Text to show

Dim CaptionColor As Color ‘ Text-color

Dim CaptionBackColor As Color ‘ Text-backcolor

Dim CaptionFont As Font ‘ Text-font

Dim CaptionStyle As STYLECAPTION ‘ Text-backstyle (standard or rounded filled)

Dim Value As Single ‘ Value for the Y-axis location of the line

Dim LineStyle As Pen ‘ Pen object for drawing the line

End Structure

Definition

Public Property YAxisIndicators() As YAXIS_INDICATORS()

Parameters

Long Number of Y-Axis dividers.

Returns

Current preference.

Page 188: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 188 of 212

YAxisLabelsRotated

Description

Labels of Y-Axis will be rotated 45 degrees if this property is set to True. Rotating labels reduces the

space they occupy and improve results when labels are too long.

Default value is False.

Definition

Property YAxisLabelsRotated() As Boolean

Parameters

Boolean Rotate or not the Y-Axis labels.

Returns

Current preference.

Page 189: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 189 of 212

YAxisLocation

Description

You may specify if Y-Axis is drawn on the left or on the right side of the chart.

Default value is STYLEYAXISLOCATION_LEFT.

Definition

Property YAxisLocation() As STYLEYAXISLOCATION

Parameters

STYLEYAXISLOCATION May be one of the following values:

STYLEYAXISLOCATION_LEFT = 0

STYLEYAXISLOCATION_RIGHT = 1

Returns

Current preference.

Page 190: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 190 of 212

YAxisNumericFormat

Description

Specify the string format for Y-axis values. Sample format are “p” (percentage) and “N” (standard

number). Refer to .NET documentation for standard and custom string formats.

If you want big numbers to be divided, use the following formats:

“0,” -> one comma will divide the value by 1000.

“0,,” -> two commas will divide the value by 1000000.

“0,.00” -> one comma plus a dot and 00 will show the value divided by 1000 and two decimals.

Default value is “N”.

Definition

Property YAxisNumericFormat () As String

Parameters

String Format string for values.

Returns

Current format string.

Page 191: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 191 of 212

YAxisScaleMaximum

Description

Set the upper limit for the Y-Axis scale. Must be used with YAxisScaleMode = SCALEMODE_FIXED.

Default value is 0.

Definition

Property YAxisScaleMaximum() As Single

Parameters

Single Upper limit for the Y-Axis scale..

Returns

Current preference.

Page 192: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 192 of 212

YAxisScaleMinimum

Description

Set the lower limit for the Y-Axis scale. Must be used with YAxisScaleMode = SCALEMODE_FIXED.

Default value is 0.

Definition

Property YAxisScaleMinimum() As Single

Parameters

Single Lower limit for the Y-Axis scale..

Returns

Current preference.

Page 193: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 193 of 212

YAxisScaleMode

Description

Specify the scale mode for Y-Axis rule. By default, Y-Axis rule values are calculated automatically from

the values of the chart (minimum value of the Y-Axis rule equals the minimum Y of any value in the

chart). Set this property to SCALEMODE_FIXED so you can set the minimum and maximum values for

the rule (see YAxisScaleMinimum and YAxisScaleMaximum properties).

Default value is SCALEMODE.AUTOMATIC

Definition

Property YAxisScaleMode () As SCALEMODE

Parameters

SCALEMODE Can be one of the following values: SCALEMODE_AUTOMATIC = 0

SCALEMODE_FIXED = 1

SCALEMODE_AUTOMATIC_MINIMUM_ZERO = 3

Returns

Current preference.

Page 194: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 194 of 212

YAxisScaleMinimumCalculated

Description

Readonly property that returns the actual calculated minimum value for Y Axis. Note that you can have

YAxisScaleMinimum ignored with YAxisScaleMode set to automatic. Then this function will return the

minimum value in source data for Y Axis.

Default value is 0.

Definition

Property YAxisScaleMinimumCalculated() As Single

Parameters

Returns

Current calculated minimum Y Axis value.

Page 195: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 195 of 212

YAxisScaleMaximumCalculated

Description

Readonly property that returns the actual calculated maximum value for Y Axis. Note that you can have

YAxisScaleMaximum ignored with YAxisScaleMode set to automatic. Then this function will return the

maximum value in source data for Y Axis.

Default value is 0.

Definition

Property YAxisScaleMaximumCalculated() As Single

Parameters

Returns

Current calculated maximum Y Axis value.

Page 196: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 196 of 212

YAxisShowDividers

Description

Show or not the Y-axis line dividers (note, this property only controls line drawing – see

YAxisDividerCount to control the number of Y-Axis labels).

Default value is True.

Definition

Property YAxisShowDividers() As Boolean

Parameters

Boolean Show/hide y-axis line dividers.

Returns

Current setting.

Page 197: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 197 of 212

YAxisTitle

Description

Set the title for the Y-Axis. Set this property to “” to hide the Y-Axis title.

Default value is “” (title hidden).

Definition

Property YAxisTitle() As String

Parameters

String Title for Y-axis.

Returns

Current Y-axis’ title.

Page 198: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 198 of 212

YAxisTitleFont

Description

Specify the font to be used for the Y-Axis title.

Default value is Font("Arial", 11, FontStyle.Bold, GraphicsUnit.Point).

Definition

Property YAxisTitleFont() As Font

Parameters

Font Any System.Drawing.Font object.

Returns

Current Y-axis’ title font.

Page 199: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 199 of 212

YAxisValuesFont

Description

Specify the font to be used for the Y-Axis labels.

Default value is Font("Arial", 12, FontStyle.Regular, GraphicsUnit.Point).

Definition

Property YAxisValuesFont() As Font

Parameters

Font Any System.Drawing.Font object.

Returns

Current Y-axis’ title font.

Page 200: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 200 of 212

XAxisDirection

Description

Specifies the orientation (direction) of the X-Axis in XYZ charts.

A value of 1 indicates left to right direction (for instance, the zero level will be at the left of the chart

from a front-view). A value of -1 indicates right to left (zero will be at the rightest part of the chart).

Default value is 1 (left to right).

Definition

Property XAxisDirection () As Long

Parameters

Long Direction of X-Axis (-1 or 1)

Returns

Current preference.

Page 201: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 201 of 212

ZAxisDirection

Description

Specifies the orientation (direction) of the Z-Axis in XYZ charts.

A value of 1 indicates front to back direction (for instance, the zero level will be nearer to the viewer

from a front-view perspective). A value of -1 indicates back to front (zero will be at the farthest position

of the chart).

Default value is 1 (front to back).

Definition

Property ZAxisDirection () As Long

Parameters

Long Direction of Z-Axis (-1 or 1)

Returns

Current preference.

Page 202: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 202 of 212

ZAxisScaleMaximum

Description

Set the upper limit for the Z-Axis scale. Must be used with ZAxisScaleMode = SCALEMODE_FIXED.

Default value is 0.

Definition

Property ZAxisScaleMaximum() As Single

Parameters

Single Upper limit for the Z-Axis scale.

Returns

Current preference.

Page 203: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 203 of 212

ZAxisScaleMinimum

Description

Set the lower limit for the Z-Axis scale. Must be used with ZAxisScaleMode = SCALEMODE_FIXED.

Default value is 0.

Definition

Property ZAxisScaleMinimum() As Single

Parameters

Single Lower limit for the Z-Axis scale.

Returns

Current preference.

Page 204: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 204 of 212

ZAxisScaleMinimumCalculated

Description

Readonly property that returns the actual calculated minimum value for Z Axis. Note that you can have

ZAxisScaleMinimum ignored with ZAxisScaleMode set to automatic. Then this function will return the

minimum value in source data for Z Axis.

Default value is 0.

Definition

Property ZAxisScaleMinimumCalculated() As Single

Parameters

Returns

Current calculated minimum Z Axis value.

Page 205: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 205 of 212

ZAxisScaleMaximumCalculated

Description

Readonly property that returns the actual calculated maximum value for Z Axis. Note that you can have

ZAxisScaleMaximum ignored with ZAxisScaleMode set to automatic. Then this function will return the

maximum value in source data for Z Axis.

Default value is 0.

Definition

Property ZAxisScaleMaximumCalculated() As Single

Parameters

Returns

Current calculated maximum Z Axis value.

Page 206: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 206 of 212

ZoomEnabled

Description

Enables/disables zoom and pan features.

Default value is False (disabled)

Definition

Public Property ZoomEnabled() As Boolean

Parameters

Boolean True = zoom/panning can be used; False = no zoom/pan.

Returns

Current zoom/pan state.

Page 207: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 207 of 212

ZoomFactor

Description

Single value that represents the magnifying factor, from 0.00001 to infinite.

Default value is 1.0

Definition

Public Property ZoomFactor () As Single

Parameters

Single Set/get zoom magnifying factor.

Returns

Current factor value.

Page 208: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 208 of 212

ZoomInterval

Description

Single value that specifies the zoom stepping. Can be increased to accelerate zoom when using mouse

wheel.

Default value is 0.1

Definition

Public Property ZoomInterval() As Single

Parameters

Single Set/get zoom stepping value.

Returns

Current stepping value.

Page 209: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 209 of 212

ZoomMode

Description

Specifies if zoom or panning affects both axis or only one of them (either x-axis or y-axis).

Default value is both axis.

Definition

Public Property ZoomMode () As ZOOM_MODE

Parameters

ZOOM_MODE Can be one of the following enum values:

Public Enum ZOOM_MODE

BOTH_AXIS = 0

XAXIS_ONLY = 1

YAXIS_ONLY = 2

End Enum

Returns

Current zoom mode.

Page 210: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 210 of 212

End-User License Agreement

END-USER LICENSE AGREEMENT FOR “CROSSING CHARTS FOR .NET” AND “CROSSINGCHARTS.COM”

IMPORTANT PLEASE READ THE TERMS AND CONDITIONS OF THIS LICENSE AGREEMENT CAREFULLY BEFORE CONTINUING WITH THIS PROGRAM INSTALL

Both “Crossing Charts for .NET” software and the website www.crossingcharts.com are property of:

Ramiro Oliva Navas NIF 52314630A

Contact info:

[email protected]

Contact Address:

Avda. Libertad 38A 11500 El Puerto de Santa María

SPAIN

This End-User License Agreement ("EULA") is a legal agreement between you (either an individual or a single entity) and Ramiro Oliva Navas for Crossing Charts which include associated software components (tutorials and demo application), media, printed materials, and "online" or electronic documentation ("SOFTWARE PRODUCT"). By installing,

copying, or otherwise using the SOFTWARE PRODUCT, you agree to be bound by the terms of this EULA. This license

agreement represents the entire agreement concerning the program between you and Ramiro Oliva Navas, (referred to as "licenser"), and it supersedes any prior proposal, representation, or understanding between the parties. If you do

not agree to the terms of this EULA, do not install or use the SOFTWARE PRODUCT.

The SOFTWARE PRODUCT is protected by copyright laws and international copyright treaties, as well as other

intellectual property laws and treaties. The SOFTWARE PRODUCT is licensed, not sold.

1. GRANT OF LICENSE.

The SOFTWARE PRODUCT is licensed as follows:

(a) Installation and Use.

Upon purchasing, Ramiro Oliva Navas grants you:

- Non-exclusive, perpetual, right to install and use copies of the SOFTWARE PRODUCT on your computers for development purposes.

- Non-exclusive, perpetual, right to distribute the SOFTWARE PRODUCT along with your application royalty-free under conditions of 2.b).

To use the SOFTWARE PRODUCT an activation code must be used. This activation code is linked uniquely to

your company and is issued by Ramiro Oliva Navas to you after purchasing a license.

(b) Backup Copies.

You may also make copies of the SOFTWARE PRODUCT as may be necessary for backup and archival purposes,

including the activation code.

Page 211: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 211 of 212

2. DESCRIPTION OF OTHER RIGHTS AND LIMITATIONS.

(a) Maintenance of Copyright Notices.

You must not remove or alter any copyright notices on any and all copies of the SOFTWARE PRODUCT.

(b) Distribution.

You may distribute binary or compiled copies of the SOFTWARE PRODUCT for free along with your own

applications as long as you reasonably hide or prevent access to the activation code to others.

You are not allowed to distribute, share or publish the SOFTWARE PRODUCT in its source code format.

(c) Prohibition on Reverse Engineering, Decompilation, and Disassembly.

You may not reverse engineer, decompile, or disassemble the SOFTWARE PRODUCT, except and only to the

extent that such activity is expressly permitted by an specific license grant (ie. custom license) or applicable law

notwithstanding this limitation.

(d) Rental.

You may not rent, lease, or lend the SOFTWARE PRODUCT.

(e) Support Services.

Ramiro Oliva Navas provide you with free e-mail and forum-based support related to the SOFTWARE PRODUCT

("Support Services"). Any supplemental software code provided to you as part of the Support Services shall be considered part of the SOFTWARE PRODUCT and subject to the terms and conditions of this EULA.

Standard License includes 6 months of free email support and free upgrades of the SOFTWARE PRODUCT.

Other licenses may offer extended support services.

(f) Compliance with Applicable Laws.

You must comply with all applicable laws regarding use of the SOFTWARE PRODUCT.

3. TERMINATION

Without prejudice to any other rights, Ramiro Oliva Navas may terminate this EULA if you fail to comply with the terms

and conditions of this EULA. In such event, you must destroy all copies of the SOFTWARE PRODUCT in your possession.

4. COPYRIGHT

All title, including but not limited to copyrights, in and to the SOFTWARE PRODUCT and any copies thereof are owned

by Ramiro Oliva Navas or its suppliers. All title and intellectual property rights in and to the content which may be

accessed through use of the SOFTWARE PRODUCT is the property of the respective content owner and may be protected by applicable copyright or other intellectual property laws and treaties. This EULA grants you no rights to use

such content. All rights not expressly granted are reserved by Ramiro Oliva Navas.

5. NO WARRANTIES

Ramiro Oliva Navas expressly disclaims any warranty for the SOFTWARE PRODUCT. The SOFTWARE PRODUCT is

provided 'As Is' without any express or implied warranty of any kind, including but not limited to any warranties of merchantability, noninfringement, or fitness of a particular purpose. Ramiro Oliva Navas does not warrant or assume

responsibility for the accuracy or completeness of any information, text, graphics, links or other items contained within

the SOFTWARE PRODUCT. Ramiro Oliva Navas makes no warranties respecting any harm that may be caused by the transmission of a computer virus, worm, time bomb, logic bomb, or other such computer program. Ramiro Oliva Navas

further expressly disclaims any warranty or representation to Authorized Users or to any third party.

Page 212: Crossing Charts Developer's Reference Guide · Crossing Charts allows you to render different nice charts with great flexibility. Using its properties and methods you can show or

Crossing Charts Library Reference

Page 212 of 212

6. LIMITATION OF LIABILITY

In no event shall Ramiro Oliva Navas be liable for any damages (including, without limitation, lost profits, business

interruption, or lost information) rising out of 'Authorized Users' use of or inability to use the SOFTWARE PRODUCT,

even if Ramiro Oliva Navas has been advised of the possibility of such damages. In no event will Ramiro Oliva Navas be liable for loss of data or for indirect, special, incidental, consequential (including lost profit), or other damages based in

contract, tort or otherwise. Ramiro Oliva Navas shall have no liability with respect to the content of the SOFTWARE PRODUCT or any part thereof, including but not limited to errors or omissions contained therein, libel, infringements of

rights of publicity, privacy, trademark rights, business interruption, personal injury, loss of privacy, moral rights or the

disclosure of confidential information.