Bar, Line, and Area Charts

WebFOCUS Online Help > Creating Charts With Graph Tools > Customizing Graphs With the Graph Editor > Bar, Line, and Area Charts

How to:

Bar, Line, and Area chart options are available in the Graph Editor menu when a bar, line, or area graph is selected in the Graph Type menu. Bar, Line & Area Chart Options enable you to:

Draw from zero line and data text appears.

Define riser types (bar, line, area) for each series.
Apply a 3D effect to the graph.
Define the look of bar risers.
Select marker types and sizes.

Top of page

Procedure: How to Define General Bar, Line, and Area Settings

Select the General tab from Bar, Line & Area Chart Options.

Select from the following options:
Draw from Zero Line

Enables and disables drawing of risers from zero. In applications where the data range can include negative numbers, this field determines whether the risers will be drawn pointing up and down from a zero line or whether all risers will draw straight up from the "bottom" of the graph. The default is for this field to be selected.

Show Data Values

Enables and disables the display of data values next to risers or markers in a chart. The default value is disabled.

When the Show Data Values check box is selected (ž), use the Position and Distance slider bars to define where the data values appear.

Position

When the Show Data Values field is selected (ž), this field sets an angle from the center point from which all data text is drawn. The default value is 90 degrees.

Distance

When the Show Data Values field is selected (ž), this field sets the radius that a data text value will be drawn out from the center of a chart riser. The default value is 20.

Select the Apply button to add these selections to the chart.

Top of page

Syntax: How to Add Properties and Methods for General Bar, Line, and Area Options

Selections in the associated dialog boxes add the following properties and methods to the code that defines this chart:

Editor Field	Property/Method
Draw from Zero Line	setScaleFromZero ( true \| false );
Show Data Values	setDisplay (getDataText(), true \| false );
Position	setDataTextAngle ( value );
Distance	setDataTextRadius ( value );

Top of page

Procedure: How to Define Bar, Line, and Area Combo Settings

Select the Combo tab from Bar, Line & Area Chart Options.

Select a riser in the chart in the editor window. Then choose one of the selections in this dialog to assign a riser type (bar, line, area, or default for chart type) to the series.

Select the Apply button to add these selections to the chart.

Top of page

Syntax: How to Add Properties and Methods for Bar, Line, and Area Combo Settings

Selections in the associated dialog boxes add the following properties and methods to the code that defines this chart:

Editor Field	Property/Method
Bar	setSeriesType ( getSeries(#), 1);
Line	setSeriesType ( getSeries(#), 2);
Area	setSeriesType ( getSeries(#), 3 );
Default for Graph type	setSeriesType ( getSeries(#), 0 );

Top of page

Procedure: How to Define Bar, Line, and Area Extrude Settings

Select the Extrude tab from Bar, Line & Area Chart Options.

Use 3D Extrusion Effect enables and disables the application of a 3D effect on a 2D chart. When this check box is selected (ž), use the Direction, Thickness, and Line Thickness slider bars to define the depth angle and thickness of the 3D extrusion effect.
Use 3D Extrusion

Determines whether or not a 3D effect is applied to this 2D graph. When it is selected (ž), use the Direction and Thickness fields to specify how much 3D effect is applied to the chart frame and risers. The default value is selected (ž).

Direction

When the Use 3D Extrusion field is selected (ž), this field sets the angle of a line from the front of the chart frame to the back (in degrees). The default value is 45.

Thickness

When the Use 3D Extrusion field is selected (ž), this field sets how far out the extruded frame will be extended. Small values produce a very narrow chart, larger values produce a thicker chart. The default value is 25.

Line Thickness

When the Use 3D Extrusion field is selected for a vertical or horizontal line chart or a combo chart with lines, this field 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 1 produces very thin lines, a value of 100 produces very thick 3D ribbons. The default value is 30.

Select the Apply button to add these selections to the chart.

Top of page

Syntax: How to Add Properties and Methods for Bar, Line, and Area Extrude Settings

Selections in the associated dialog boxes add the following properties and methods to the code that defines this chart:

Editor Field	Property/Method
Use 3D Extrusion (not selected)	setDepthRadius( 0 );
Direction	setDepthAngle ( value );
Thickness	setDepthRadius ( value );
Line Thickness	setDataLineThickness ( value );

Top of page

Procedure: How to Define Bar, Line and Area Options 1

Select the Options tab from Bar, Line & Area Chart Options.

The Show as Pictograph check box enables and disables the display of bar risers as a pictograph. Enable Bar Resizing... enables and disables the ability of the user to resize bars in a chart with the CTRL/primary mouse button. Use the Width and Spacing slider bars to define the width of bar risers and the spacing between them.
Show as Pictograph

Enables and disables the display of bars as pictographs in a flat 2D chart. The default value is disabled. Note that the "Use 3D Extrusion" field in the Extrude Settings dialog must be disabled in order to use this feature.

Enable Bar Resizing with CTRL+Resize

Enables and disables resize bar mode. When it is enabled (ž), the user interface will allow resizing of bars. The user can change the size of bars by using the control key and mouse to stretch or reduce the size of the bars. This action will also change the internal data value assigned to the bar. If data callbacks are being used to provide data input to the chart, any resize operation will be reset to the value provided by the data call back. The default value is selected (the user can resize bars).

Width

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 field is set to 100, all bars touch each other and there is no space in between them. When this field is set to zero, the bars appear as thin lines with no space detectable. The default value is 75.

Spacing

For bar graphs only, 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 field is set to zero, there is no space between the bars within a group and all bars within the group will touch each other. When this field is set to 100, the bars within a group are as far apart as possible. The default value is zero.

Select the Apply button to add these selections to the chart.

Top of page

Syntax: How to Add Properties and Methods for Bar, Line, and Area Options 1

Selections in the associated dialog boxes add the following properties and methods to the code that defines this chart:

Editor Field	Property/Method
Show as Pictograph	setDisplayBarAsPictograph ( true \| false );
Enable Bar Resizing with CTRL+Resize	setResizeBarMode ( true \| false);
Width	setRiserWidth ( value );
Spacing	setRiserBarGroupSpacing ( value );

Top of page

Procedure: How to Define Bar, Line, and Area Options 2

Select the Options tab from Bar, Line & Area Chart Options.

For line charts, the Show Marker check box enables and disables the display of markers. When this check box is selected, the Marker Shape and Marker Size fields define the shape and size of the markers. Use Marker Shapes on Legends enables and disables the use of the selected marker shapes in the legend area of the chart. Show Lines enables or disables the display of connecting lines in a line chart.
Show Marker

Enables and disables the display of markers in a 2D chart. Use this field to turn off markers in a Line Chart when you only want to see the lines themselves and not the markers. The default value is selected (markers appear). Note that the Thickness field in the Extrude dialog must be set to zero in order for this selection to be properly applied to the chart.

Marker Shape

When Show Marker is selected for a line chart, use this field to select a marker shape for each series in the chart. Click on a series in the chart and then select a marker shape in this dialog.

Marker Size

When Show Marker is selected for a line chart, use this field to select the size of markers. The default value is 30.

Use Marker Shapes on Legends

Enables and disables the use of the series shapes selected in the Marker Shape field in the legend area of the chart.

Show Lines

Enables and disables the display of connecting markers in a line chart. When this field is not selected in a line chart, the result will be a "floating marker" effect with only markers and no connecting lines.

Select the Apply button to add these selections to the chart.

Top of page

Syntax: How to Add Properties and Methods for Bar, Line, and Area Chart Options

Selections in the associated dialog boxes add the following properties and methods to the code that defines this chart:

Editor Field	Property/Method
Show Marker	setMarkerDisplay ( true \| false );
Marker Shape	setMarkerShape ( getSeries(#), value );
Marker Size	setMarkerSize ( getSeries(#), value );
Use Marker Shapes on Legends	setUseSeriesShapes ( true \| false );
Show Lines	setConnectLineMarkers ( true \| false);

Top of page

Procedure: How to Display Markers for Bar, Line, and Area Chart Options

Select the Markers tab from Bar, Line, & Area Chart Options.

The Select Pareto Series check box enables and disables the display
Select Pareto Series

This property affects how the Pareto series bars are drawn. The integer value is between 0 and the number of series in the data set. 0 is the default value.

Connect the Bars

Select this option connect the Pareto series bars.

Select the Apply button to add these selections to the chart.

Top of page

Syntax: How to Add Properties and Methods for Displaying Markers

Selections in the associated dialog boxes add the following properties and methods to the code that defines this chart:

Editor Field	Property/Method
Select Pareto Series	setDisplayParetoSeries (value);
Connect the Bars	setConnectParetoBars ( true \| false );

WebFOCUS