CDLegendSetKeyStyle < Main

Tags: view all tags
---+ .LEGEND SET KEY STYLE

_This subroutine sets the icon key style of the "current" chart spec._

<br />%TOC%
---++ Usage:
<pre>      PASS         &lt;key_style&gt;                FIELD            SHARE? N
      GOSUB    0CD .LEGEND SET KEY STYLE
      *        Check for error
      IF       0CD .LEGEND SET KEY STYLE      NE
</pre>
---++ Description:

This subroutine set the icon key style of the icons in your legend (retangular icons only). This routine receives a single, optional value specifying one of the following: line or auto.

<div id="_mcePaste">By default, Chart Director 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), 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, Chart Director 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 subroutine can be used to force Chart Director to always use the "line style legend keys".</div>

If a parameter is not received or if the value received is blank, then the key style of the icons is cleared and the default edge will be rendered.

You have to define a Legend box via [[CDChartSetLegendBox][.CHART SET LEGEND BOX]] for this subroutine to have any effect.
---++ Comments:

_Read what other users have said about this page or add your own comments._

<br />%COMMENT%

-- Main.JeanNeron - 2011-09-27
Topic revision: r3 - 2012-02-19 - JeanNeron