BiGraphBase

This is the abstract base class for BiGraph and BiGraph2. If Mozilla support is needed use BiGraph2. If line chart and/or pie chart is needed then use BiGraph.

This class extends BiComponent and therefore all methods and fields available for BiComponent are also available for BiGraphBase .

Constructor

new BiGraphBase ( )

Parameters

No parameters.

Properties

NameTypegetsetDescripton
autoScaleBooleancheckedcheckedAllows you turn off the automatic scaling of the graph
categoriesBiChartCategory[]checkedcheckedThis is an array containing the categories used for the data of the graph. After this property is changed the graph component needs to be updated.
categoryAxisBiChartCategoryAxischeckedThis property points to the category axis component
chartAreaBiChartAreacheckedThis property points to the chart area component
chartsBiAbstractChart[]checkedThis is an array containing the chart components used to display the charts.
chartTypeStringcheckedcheckedThe type of the chart. Available types are:

bar
column
grid
line
pie
percentagestackedbar
percentagestackedcolum
stackedbar
stackedcolumn
grid
fontSizeNumbercheckedcheckedSets the font size for the legend and axes. If autoScale is true then this does not apply.
gridBiGridChartcheckedThis property returns the BiGrid used as the grid chart if the chart type is set to grid. Otherwise this is null.
gridLinesBiChartGridLinescheckedThis property points to the grid lines component
legendBiChartLegendcheckedThis property points to the legend component
pointsBiChartPoint[]checkedcheckedThis is an array containing the points used for the data of the graph.
presentationManagerBiChartPresentationManagercheckedThis returns the presentation manager for the graph
seriesBiChartSeries[]checkedcheckedThis is an array containing the series used for the data of the graph. After this property is changed the graph component needs to be updated.
valueAxis: BiChartValueAxischeckedThis property points to the value axis component

Methods

NameDescription
addCategoryAdds a category to the categories collection
addPointAdds a point to the points collection
addSeriesAdds a series to the series collection
clearCategoriesRemoves all categories from the categories collection
clearPointsRemoves all points from the points collection
clearSeriesRemoves all series from the series collection
fromXmlDocumentThis takes an XML document describing the graph data and the graph presentation and makes the graph reflect that information.
getCategoryByIdReturns the category with the given id
getChartForSeriesReturns the chart component used to display the series.
getChartPresentationBySeriesIdThis returns the chart presentation used to describe how to render chart belonging to a series.
getComponentByIdsThis returns the component used to render the section for a certain data point.
getContextMenuForPointThis method is used to return the context menu for a certain point. Override this method to provide yout own menus.
getPointByIdsReturns the point with the given series id and the given category id
getSeriesByIdReturns the series with the given id
getToolTipForPointThis method is used to return the tool tip to show for a certain point. Override this method to provide yout own tool tips.
removeCategoryRemoves a category from the categories collection
removePointRemoves a point from the points collection
removeSeriesRemoves a series from the series collection
toXmlDocumentSerializes the graph to an XML document.
updateUpdates the graph and recreates the internal charts. This should be called after changes to the graph.
updatePointUpdates the graph and recreates the internal representations for the given point. This should be called after changes to a point or a series. Leaving out the category makes this update all the points in the given series.

Events

NameTypeBubblesDescripton
pointclickBiChartMouseEventFires when the user clicks on a point in the graph
pointcontextmenuBiChartMouseEventFires when the user right clicks on a point
pointdblclickBiChartMouseEventFires when the user double clicks on a point
pointmousedownBiChartMouseEventFires when the user presses down the mouse button on a point
pointmousemoveBiChartMouseEventFires when the user moves the mouse over a point
pointmouseoutBiChartMouseEventFires when the mouse pointer leaves a point
pointmouseoverBiChartMouseEventFires when the mouse pointer enters a point
pointmouseupBiChartMouseEventFires when the releases the mouse button on a point
pointmousewheelBiChartMouseEventThis event is fired when the user scrolls the mouse wheel over a point

Static Methods

None.

Static Fields

None.

Remarks

None.

Method Details

addCategory

Adds a category to the categories collection

Syntax

object.addCategory ( oCategory )

Parameters

NameTypeOptionalDefaultDescripton
oCategoryBiChartCategoryThe category to add

Return Type

void

addPoint

Adds a point to the points collection

Syntax

object.addPoint ( oPoint )

Parameters

NameTypeOptionalDefaultDescripton
oPointBiChartPointThe point to add

Return Type

void

addSeries

Adds a series to the series collection

Syntax

object.addSeries ( oSeries )

Parameters

NameTypeOptionalDefaultDescripton
oSeriesBiChartSeriesThe series to add

Return Type

void

clearCategories

Removes all categories from the categories collection

Syntax

object.clearCategories ( )

Parameters

No arguments.

Return Type

void

clearPoints

Removes all points from the points collection

Syntax

object.clearPoints ( )

Parameters

No arguments.

Return Type

void

clearSeries

Removes all series from the series collection

Syntax

object.clearSeries ( )

Parameters

No arguments.

Return Type

void

fromXmlDocument

This takes an XML document describing the graph data and the graph presentation and makes the graph reflect that information.

Syntax

object.fromXmlDocument ( oDoc )

Parameters

NameTypeOptionalDefaultDescripton
oDocBiXmlDocument

Return Type

void

getCategoryById

Returns the category with the given id

Syntax

object.getCategoryById ( sId )

Parameters

NameTypeOptionalDefaultDescripton
sIdStringThe id of the category to retrieve

Return Type

BiChartCategory

getChartForSeries

Returns the chart component used to display the series.

Syntax

object.getChartForSeries ( oSeries )

Parameters

NameTypeOptionalDefaultDescripton
oSeriesBiChartSeriesThe series to get the chart for

Return Type

BiAbstractChart

getChartPresentationBySeriesId

This returns the chart presentation used to describe how to render chart belonging to a series.

Syntax

object.getChartPresentationBySeriesId ( sSeriesId )

Parameters

NameTypeOptionalDefaultDescripton
sSeriesIdStringBiChartPresentation

Return Type

BiChartPresentation

getComponentByIds

This returns the component used to render the section for a certain data point.

Syntax

object.getComponentByIds ( sSeriesId,sCategoryId )

Parameters

NameTypeOptionalDefaultDescripton
sSeriesIdStringThe id of the series to get the component for
sCategoryIdStringThe id of the category to get the component for

Return Type

BiAbstractChartSection

getContextMenuForPoint

This method is used to return the context menu for a certain point. Override this method to provide yout own menus.

Syntax

object.getContextMenuForPoint ( oSeries,oCategory )

Parameters

NameTypeOptionalDefaultDescripton
oSeriesBiChartSeriesThe series to get the tool tip for
oCategoryBiChartCategoryThe category to get the tool tip for

Return Type

BiMenu

getPointByIds

Returns the point with the given series id and the given category id

Syntax

object.getPointByIds ( sSeriesId,sCategoryId )

Parameters

NameTypeOptionalDefaultDescripton
sSeriesIdStringThe series id of the point to retrieve
sCategoryIdStringThe category id of the point to retrieve

Return Type

BiChartPoint

getSeriesById

Returns the series with the given id

Syntax

object.getSeriesById ( sId )

Parameters

NameTypeOptionalDefaultDescripton
sIdBiChartSeriesThe id of the series to retrieve

Return Type

BiChartSeries

getToolTipForPoint

This method is used to return the tool tip to show for a certain point. Override this method to provide yout own tool tips.

Syntax

object.getToolTipForPoint ( oSeries,oCategory )

Parameters

NameTypeOptionalDefaultDescripton
oSeriesBiChartSeriesThe series to get the tool tip for
oCategoryBiChartCategoryThe category to get the tool tip for

Return Type

BiToolTip

removeCategory

Removes a category from the categories collection

Syntax

object.removeCategory ( oCategory )

Parameters

NameTypeOptionalDefaultDescripton
oCategoryBiChartCategoryThe category to remove

Return Type

void

removePoint

Removes a point from the points collection

Syntax

object.removePoint ( oPoint )

Parameters

NameTypeOptionalDefaultDescripton
oPointBiChartPointThe point to remove

Return Type

void

removeSeries

Removes a series from the series collection

Syntax

object.removeSeries ( oSeries )

Parameters

NameTypeOptionalDefaultDescripton
oSeriesBiChartSeriesThe series to remove

Return Type

void

toXmlDocument

Serializes the graph to an XML document.

Syntax

object.toXmlDocument ( )

Parameters

No arguments.

Return Type

BiXmlDocument

update

Updates the graph and recreates the internal charts. This should be called after changes to the graph.

Syntax

object.update ( )

Parameters

No arguments.

Return Type

void

updatePoint

Updates the graph and recreates the internal representations for the given point. This should be called after changes to a point or a series. Leaving out the category makes this update all the points in the given series.

Syntax

object.updatePoint ( sSeriesId [ ,sCategoryId ] )

Parameters

NameTypeOptionalDefaultDescripton
sSeriesIdStringThe id of the series that the graph should be update to reflect. This usually updates the chart assosciated with the series.
sCategoryIdStringcheckedThe id of the category that the graph should be update to reflect. If provided this means that a point should be udpated. This usually updates means that a certain bar or marker is updated.

Return Type

void