ChartDirector 7.0 (Perl Edition)

LegendBox.setLineStyleKey


Usage

setLineStyleKey([ b ])

Description

Determines whether to always use "line style legend keys" or not.

By default, ChartDirector will use a small colored square box as the legend key icon. This allows people to determine the colors for the data representations.

In some cases, colors alone cannot distinguish the data representations. For example, in a line chart with multiple lines, it is possible all lines are of the same color, and are distinguished by line styles (solid, dash, dotted, etc), etc), or the lines may be distinguished by data symbols (small circles, squares, etc) on the lines.

For charts with non-solid lines (eg. dash, dotted, etc) or lines with data symbols, ChartDirector will use "line style legend keys" for the lines. A line style legend key consist a of line with an optional data symbol, which reflects the line style and data symbol representing the data series.

This method can be used to force ChartDirector to always use the "line style legend keys".

Arguments

ArgumentDefaultDescription
btrue (non-zero)A true (non-zero) value means to always use "line style legend keys". A false (zero) value means to automatically determined if "line style legend keys" should be used.

Return Value

None