Riser & Marker Properties

ConnectLineMarkers

For line charts and polar charts, this property enables/disables lines that connect markers. Setting this to property to false will produce a "floating marker" effect with only markers and no connecting lines. MarkerSizeDefault defines the size of markers.

DATA TYPE:

boolean

RANGE:

true / false; true = Draw Connecting Lines, false = Do not draw connecting lines

DEFAULT:

true (draw connecting lines)

SYNTAX:

void setConnectLineMarkers(boolean newValue);
boolean getConnectLineMarkers();

EXAMPLE:

setDepthRadius(0);
setMarkerSizeDefault(60);
setConnectLineMarkers(true);
setGraphType(41);

setConnectLineMarkers(false);

ConnectScatterMarkers

This property enables/disables the drawing of connecting lines between markers in a scatter chart. Setting this property to true draws a line connecting all markers in the same series in the order the points are in the data matrix. The color of each line matches the color of the series marker. MarkerSizeDefault defines the size of the markers.

DATA TYPE:

boolean

RANGE:

true (draw connecting lines) / false (do not draw connecting lines)

DEFAULT:

false (do not draw connecting lines)

SYNTAX:

void setConnectScatterMarkers(boolean newValue);
boolean getConnectScatterMarkers();

EXAMPLE:

setMarkerSizeDefault(60);
setGraphType(61);
setConnectScatterMarkers(true);

setConnectScatterMarkers(false);

NOTE:

A scatter chart must be selected with the GraphType property.

ALSO SEE:

ConnectLineMarkers, MarkerSizeDefault

DataLineThickness

When a "2.5D effect" is applied to a vertical or horizontal line chart with DepthAngle and DepthRadius, the DataLineThickness property defines the width of the "fake 3D" lines in the chart. It is expressed as a value in the range 1 to 100. A value of one produces very thin lines, a value of 100 produces very thick 3D ribbons.

DATA TYPE:

integer

RANGE:

1...100

DEFAULT:

30

SYNTAX:

void setDataLineThickness(int newValue);
int getDataLineThickness();

EXAMPLE:

setGraphType(53);
setDataLineThickness(90);

setDataLineThickness(10);

ALSO SEE:

DepthAngle, DepthRadius

DisplayBarAsPictograph

This property enables (true) / disables (false) the display of bars as pictographs in a flat 2D chart. When this property is set to true, the picture(.GIF image) identified by the setTextureURL() method will be applied to the bar. The setTextureURL() method must be used to identify a valid .GIF image. If a texture has not been identified with setTextureURL(), this property may cause jagged lines to be displayed on the bars. The setFillType() method should also be set to identify textures (i.e., setFillType (3); ) as the fill type.

DATA TYPE:

boolean

RANGE:

true / false; true = Display bars as pictographs, false = Display bars normally

DEFAULT:

false

SYNTAX:

void setDisplayBarAsPictograph(boolean newValue);
boolean getDisplayBarAsPictograph();

EXAMPLE:

setFillType(getSeries(3),3);
setFillType(getSeries(4),3);
setTextureDisplayMode(0);
setTextureURL(getSeries(3),"file:/C:/PJE/tiles/Azul_Granite.gif");
setTextureURL(getSeries(4),"file:/C:/PJE/tiles/Azul_Granite.gif");
setDisplayBarAsPictograph(true);

ALSO SEE:

setTextureURL(), setTextureDisplayMode(), setFillType()

MarkerDisplay

This property controls the display of markers in a line chart. Use this property to turn off markers (false) in a Line Chart when you only want to see the lines themselves and not the markers.

DATA TYPE:

boolean

RANGE:

true / false; true = Display markers, false = Do not display markers

DEFAULT:

true

SYNTAX:

void setMarkerDisplay(boolean newValue)
boolean getMarkerDisplay();

EXAMPLE:

setGraphType(41);
setMarkerDisplay(true);

setMarkerDisplay(false);

ALSO SEE:

ConnectLineMarkers, ConnectScatterMarkers, MarkerSizeDefault, setMarkerShape(), setMarkerSize()

MarkerSizeDefault

This property defines the size of markers in line, scatter, bubble, polar, and radar line charts. The setMarkerSize() method can override this property by assigning a marker size to a specific series/group point.

DATA TYPE:

integer

RANGE:

0...100

DEFAULT:

30

SYNTAX:

void setMarkerSizeDefault(int newValue);
int getMarkerSizeDefault();

EXAMPLE:

setGraphType(41);
setDepthRadius(0);
setMarkerSizeDefault(90);

setMarkerSizeDefault(60);

ALSO SEE:

ConnectLineMarkers, ConnectScatterMarkers, MarkerDisplay, UseSeriesShapes setMarkerShape(), setMarkerSize()

RiserBarGroupSpacing

For bar graphs only, this property sets the spacing between bars within a group (clusters) in a side-by-side bar graph. A larger number creates more space between bars within a group. When this property is set to zero, there is no space between the bars and all bars in the group will touch each other. When this property is set to 100, bars in a group are as far apart as possible. Negative values allow risers to overlap. A value of -100 draws all the series in a group on top of each other giving the "appearance" of a stacked bar chart. However, values are not accumulated so all series but the last will be partially or completely covered by other series.

DATA TYPE:

integer

RANGE:

-100...100

DEFAULT:

0

SYNTAX:

void setRiserBarGroupSpacing(int newValue);
int getRiserBarGroupSpacing();

EXAMPLE:

setRiserWidth(40);
setDepthRadius(0);
setRiserBarGroupSpacing(20);

setRiserBarGroupSpacing(50);

setRiserBarGroupSpacing(-50);

setRiserBarGroupSpacing(-100);

NOTE:

ALSO SEE:

RiserWidth

RiserBorderMode

This property defines when riser borders are drawn. Automatic mode (0) only draws borders for small data sets that consist of less than 900 risers. You can also set the property so that riser borders are always drawn or never drawn.

DATA TYPE:

integer

RANGE:

0...2; 0 = automatic, borders drawn only for small datasets (fewer than 900 risers), 1 = borders never drawn, 2 = borders are always drawn

DEFAULT:

2

SYNTAX:

void setRiserBorderMode(int newValue);
int getRiserBorderMode();

EXAMPLE:

setRiserBorderMode(0);

setRiserBorderMode(1);

ALSO SEE:

SeriesDefaultBorderColor, SeriesDefaultTransparentBorderColor, UseSeriesBorderDefaults

RiserWidth

For bar, stock, and histogram charts, this property controls the width of bars in a graph. The riser width is expressed as a percentage of the space available for each group of bars. When this property is set to 100, all bars touch each other and there is no space in between them. When this property is set to zero, the bars are displayed as thin lines with no space detectable.

DATA TYPE:

integer

RANGE:

0...100

DEFAULT:

75

SYNTAX:

void setRiserWidth(int newValue);
int getRiserWidth();

EXAMPLE:

setRiserWidth(20);
setDepthRadius(0);
setRiserBarGroupSpacing(75);

setRiserWidth(100);

NOTE:

ALSO SEE:

RiserBarGroupSpacing

SquareMarkers

This property enables (true) / disables (false) square markers in the legend area. If different marker shapes (circle, plus, triangle, etc.) are used for each series by UseSeriesShapes, the marker shape will be redrawn within a square rectangle area. The legend marker position must not be set for the legend labels to appear on of the legend markers.

DATA TYPE:

boolean

RANGE:

true / false; true = Force markers to be square, false = Markers do not need to be square

DEFAULT:

true

SYNTAX:

void setSquareMarkers(boolean newValue);
boolean getSquareMarkers();

EXAMPLE:

setGraphType(67);
setUseSeriesShapes(true);
setSquareMarkers(true);

setSquareMarkers(false);

NOTE:

This property is ignored if LegendMarkerPosition(4) is used.

ALSO SEE:

LegendMarkerPosition, UseSeriesShapes