XML/SWF Charts| CSS/XML Timeline Eons(New)| Timeline Eons| SlickBoard

 < previousnext > 

 

chart_guide

 

<chart_guide horizontal='boolean'
             vertical='boolean'
             thickness='number'
             color='string'
             alpha='number'
             type='string'
             snap_h='boolean'
             snap_v='boolean'
             connect='boolean'
             
             radius='number'
             fill_color='string'
             fill_alpha='number'
             line_color='string'
             line_alpha='number'
             line_thickness='number'
             
             text_h_alpha='number'
             text_v_alpha='number'
             prefix_h='string'
             suffix_h='string'
             prefix_v='string'
             suffix_v='string'
             decimals='int'
             decimal_char='string'
             separator='string'
             font='string'
             bold='boolean'
             size='number'
             text_color='string'
             background_color='string'
             /> 
            


Description

chart_guide sets one or two guide lines to connect the cursor position with the axes and simplify reading their values. The guides are the two red lines that move with the cursor when the mouse is over this chart:

 

The guide lines, the red circle that highlights data points, and the red labels that display axes values are all optional. Guide lines can be combined with chart_label and chart_data label to display an additional cursor label over data points.

The circle that highlights data point is supported by all chart types. Guide lines are supported by all chart types except for 3d, pie, and polar charts.

 

  • horizontal: A boolean that determines whether the horizontal guide is visible or not. Valid values are true or false. The default is false (no horizontal guide).

  • vertical: A boolean that determines whether the vertical guide is visible or not. Valid values are true or false. The default is false (no vertical guide).

  • thickness: The thickness of the guide lines. Valid values are 1 and above. The default is 1.

  • color: The guide's line color. This is a string holding triple hexadecimal values representing the red, green, and blue components of a color. The default is "000000" (black).

  • alpha: The guide's line transparency value. Valid values are 0 (fully transparent) to 100 (fully opaque). The default is 20.

  • type: The guide's line type. Valid values are solid, dotted, and dashed. The default is solid.

  • snap_h: A boolean that determines whether the horizontal guide snaps to data points or not. Valid values are true or false. The default is true.

  • snap_v: A boolean that determines whether the vertical guide snaps to data points or not. Valid values are true or false. The default is true.

  • connect: By default, guides appear when the cursor is inside chart_rect. This attribute is a boolean that determines whether the guides appear when the cursor is outside of chart_rect. This can be used to connect the guides of different charts in a composite chart. Valid values are true or false. The default is false (show guides only when the cursor is inside chart_rect).



  • radius: Guides can optionally have a circle that highlights data points when the cursor gets close to them. The radius attribute sets the radius of this circle in pixels. The default is 4.

  • fill_color: The color inside the data circle. This is a string holding triple hexadecimal values representing the red, green, and blue components of a color. The default is "000000" (black).

  • fill_alpha: The transparency value inside the data circle. Valid values are 0 (fully transparent) to 100 (fully opaque). The default is 0. To hide the circle, set both fill_alpha and line_alpha to zero.

  • line_color: The data circle's border color. This is a string holding triple hexadecimal values representing the red, green, and blue components of a color. The default is "000000" (black).

  • line_alpha: The data circle's border transparency value. Valid values are 0 (fully transparent) to 100 (fully opaque). The default is 0. To hide the circle, set both fill_alpha and line_alpha to zero.

  • line_thickness: The data circle's border thickness. The default is 0 pixels (no border).



  • text_h_alpha: Guides can optionally have labels that display the axes values. This determines the labels' transparency for the horizontal guide. Valid values are 0 (fully transparent) to 100 (fully opaque). The default is 50. To hide the label for the horizontal guide, set this attribute to zero.

  • text_v_alpha: Guides can optionally have labels that display the axes values. This determines the labels' transparency for the vertical guide. Valid values are 0 (fully transparent) to 100 (fully opaque). The default is 50. To hide the label for the vertical guide, set this attribute to zero.

  • prefix_h: The characters to add before the guide's horizontal label (example: $10). The default is nothing.

  • suffix_h: The characters to add after the guide's horizontal label (example: 10%). The default is nothing.

  • prefix_v: This characters to add before the guide's vertical label (example: $10). The default is nothing.

  • suffix_v: The characters to add after the guide's vertical label (example: 10%). The default is nothing.

  • decimals: The number of decimal places to the right of the decimal point in the guide's number label (example: 10.45). It does not affect the string label. The default is zero (no decimals).

  • decimal_char: The character to use at the left of a decimal fraction in the guide's number label (example: 10.5). It does not affect the string label. The default is '.' (dot or full stop).

  • separator: The character to place between every group of thousands in the guide's number label (example: 1,00,000). It does not affect the string label. The default is nothing.

  • font: The font used in the guide's labels (see Fonts). The default is Arial.

  • bold: A boolean that indicates whether the font is bold or not in the guide's labels. The default is true.

  • size: The font's size in the guide's labels. The default is 12.

  • text_color: The font's color in the guide's labels. This is a string holding triple hexadecimal values representing the red, green, and blue components of a color. The default is "000000" (black).

  • background_color: This determines the labels' background color to make them visible over the graph. This is a string holding triple hexadecimal values representing the red, green, and blue components of a color. When omitted, guide labels have no background. The default is omitted (no background).

 

 

Example

<chart>

   <chart_type>line</chart_type>
   
   <!-- show only a horizontal line -->
   <chart_guide horizontal='true'
                vertical='false'
                thickness='1' 
                color='ff4400' 
                alpha='75' 
                type='dashed' 
                
                 
                radius='8'
                fill_alpha='0'
                line_color='ff4400'
                line_alpha='75'
                line_thickness='4'
             
                size='10'
                text_color='ffffff'
                background_color='ff4400'
                text_h_alpha='90'
                text_v_alpha='90' 
                />

   <!-- use chart_label in combination with chart_guide -->
   <chart_label position='cursor' />
   
</chart>

 

 < previousnext > 


Copyright © 2003-2017, maani.us