Chart legend

The properties of a chart legend are:

Property Description
General
Class Type Indicates the class type of the object. This property is read only.
Data Inherit Indicates whether the dataset for this object is inherited from another object. This property is read only.
Dataset Indicates the dataset used by the object. This property is read only.
Geometry
Height Specifies the height of the object, in inches or centimeters. Enter a numeric value to change the height.

Data type: Float
Width Specifies the width of the object, in inches or centimeters. Enter a numeric value to change the width.

Data type: Float
X Specifies the horizontal coordinate of the top left corner of the object, relative to its parent container. Enter a numeric value to change the position in inches or centimeters.

Data type: Float
Y Specifies the vertical coordinate of the top left corner of the object, relative to its parent container. Enter a numeric value to change the position in inches or centimeters.

Data type: Float
CSS
Class Specifies a CSS class to be applied to the object which is a valid class in the CSS file.

Data type: String
External CSS Class Selector Specifies a class selector to be applied to the object when exported as HTML. Enter a valid class name from the CSS file.

Data type: String
Style The property can be used in two ways.
  • Specifies a style to be applied to the object. Choose a style from the drop-down list which is available when a Style Group has been selected at the report level and when there are styles in the Style Group that can be applied to the object, or type in the style name.
  • Specifies a CSS selector to be applied to the object. Enter a valid class name from the CSS file.

Data type: String
Legend
Auto Size Specifies whether to resize the legend automatically.

Data type: Boolean
Bottom Margin Specifies the distance between the legend labels and the bottom border of the legend. Enter a numeric value to change the margin.

Data type: Float
Label Format Source Specifies the data format option for the chart legend labels. Choose an option from the drop-down list.
  • Axis Data Format - If selected, the data format of the legend labels will follow that of the axis data: if the chart has series axis, the legend label format will be the same as the series axis data format; if not, the category axis data format will be used to the legend labels.
  • Legend Data Format - If selected, the data format of the legend labels will be controlled by the property Legend Data Format.

Data type: Enumeration
Label Horizontal Spacing Specifies the horizontal distance between two adjacent legend labels. Enter a numeric value to change the distance.

Data type: Float
Label Vertical Spacing Specifies the vertical distance between two adjacent legend labels. Enter a numeric value to change the distance.

Data type: Float
Left Margin Specifies the distance between the legend labels and the left border of the legend. Enter a numeric value to change the margin.

Data type: Float
Legend Data Format Specifies the data format of the legend labels manually, applying if Label Format Source is set to Legend Data Format. Click in the value cell to specify the format in the Data Format dialog.

Data type: String
Placement Specifies the position of the legend in the platform. Choose an option from the drop-down list.

Data type: Enumeration
Right Margin Specifies the distance between the legend labels and the right border of the legend. Enter a numeric value to change the margin.

Data type: Float
Secondary Placement Specifies the position of the legend further based on the setting of the property Placement. Choose an option from the drop-down list.

Data type: Enumeration
Show Tips Specifies whether to show the corresponding data information when the mouse pointer points at a target in the chart legend area in view mode or in HTML/DHTML result.

Data type: Boolean
Top Margin Specifies the distance between the legend labels and the top border of the legend. Enter a numeric value to change the margin.

Data type: Float
Background
Border Color Specifies the color of the border of the object. Choose a color from the drop-down list, enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.

Data type: String
Border End Caps Specifies the ending style of the legend border line. Choose an option from the drop-down list.

Data type: Enumeration
Border Joint Specifies the joint style of the legend border line. Choose an option from the drop-down list.

Data type: Enumeration
Border Outlined Specifies whether to show the legend border line in Outline Path. If the property is set to true, the legend border line will be shown in Outline Path; otherwise, in Fill Path.

Data type: Boolean
Border Style Specifies the line style of the legend borders. Choose an option from the drop-down list.

Data type: Enumeration
Border Thickness Specifies the width of the border in inches or centimeters. Enter a numeric value to change the thickness.

Data type: Float
Border Transparency Specifies the transparency of the legend borders, in percent. Enter a numeric value to change the transparency.

Data type: Integer
Border Type Specifies the border type of the legend. Choose an option from the drop-down list.

Data type: Enumeration
Border Variable Dash Specifies whether to resize the dash automatically.
  • true - The dash size will be adjusted automatically. And the option Auto Adjust Dash in the Format Legend dialog will take effect.
  • false - The dash size will be of fixed size. And the option Fixed Dash Size in the Format Legend dialog will take effect.

Data type: Boolean
Color Specifies the color of the legend background, applying if the property Fill Type is set to color. Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.

Data type: String
Fill Transparency Specifies the transparency of the background, in percent. Enter a numeric value to change the transparency.

Data type: Integer
Fill Type Specifies the fill pattern for the legend background. Choose an option from the drop-down list.

Data type: Enumeration
Gradient End Color Specifies the color of the point where the gradient ends. Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.

Data type: String
Gradient End X Specifies the horizontal position where the gradient ends, measured in a percentage of the legend width.

Data type: Integer
Gradient End Y Specifies the vertical position where the gradient ends, measured in a percentage of the legend height.

Data type: Integer
Gradient Start Color Specifies the color of the point where the gradient begins. Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.

Data type: String
Gradient Start X Specifies the horizontal position where the gradient begins, measured in a percentage of the legend width.

Data type: Integer
Gradient Start Y Specifies the vertical position where the gradient begins, measured in a percentage of the legend height.

Data type: Integer
Gradient Style Specifies the gradient style for the legend background, applying if the property Fill Type is set to gradient. Choose an option from the drop-down list.

Data type: Enumeration
Image File Specifies the file name of the image, a portion of which will be displayed as the legend background, applying if the property Fill Type is set to image.

Data type: String
Image Height The four properties, Image X, Image Y, Image Width, and Image Height, together are used to define a portion of an image (the portion is a rectangle).

Image Height specifies the height of the image portion, measured in a percentage of the image height.

Data type: Integer
Image Layout Specifies the layout style for the image. Choose an option from the drop-down list.

Data type: Enumeration
Image Width The four properties, Image X, Image Y, Image Width, and Image Height, together are used to define a portion of an image (the portion is a rectangle).

Image Width specifies the width of the image portion, measured in a percentage of the image width.

Data type: Integer
Image X The four properties, Image X, Image Y, Image Width, and Image Height, together are used to define a portion of an image (the portion is a rectangle).

Image X specifies the distance between the left border of image and the portion that will contain the pattern, measured in a percentage of the image width.

Data type: Integer
Image Y The four properties, Image X, Image Y, Image Width, and Image Height, together are used to define a portion of an image (the portion is a rectangle).

Image Y specifies the distance between the top border of image and the portion that will contain the pattern, measured in a percentage of the image height.

Data type: Integer
Inset Bottom Specifies the bottom position of the background area, measured in a percentage of the legend height, from the bottom edge of the legend.

Data type: Float
Inset Left Specifies the left position of the background area, measured in a percentage of the legend width, from the left edge of the legend.

Data type: Float
Inset Right Specifies the right position of the background area, measured in a percentage of the legend width, from the right edge of the legend.

Data type: Float
Inset Top Specifies the top position of the background area, measured in a percentage of the legend height, from the top edge of the legend.

Data type: Float
Texture Background Color Specifies the background color of the texture. Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.

Data type: String
Texture Foreground Color Specifies the foreground color of the texture. Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.

Data type: String
Texture Style Specifies the texture style of the legend background, applying if the property Fill Type is set to texture. Choose an option from the drop-down list.

Data type: Enumeration
Label
Color Specifies the color of the label, applying if the property Fill Type is set to color. Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.

Data type: String
Fill Transparency Specifies the transparency of the background, in percent. Enter a numeric value to change the transparency.

Data type: Integer
Fill Type Specifies the fill pattern for the label. Choose an option from the drop-down list.

Data type: Enumeration
Font Effect Specifies the special effect for the label text. Choose an option from the drop-down list.

Data type: Enumeration
Font Face Specifies the font face for the legend labels. Choose an option from the drop-down list.

Data type: Enumeration
Font Rotation Specifies the rotation angle of each legend label around its center, in degrees. The default value is 0. Enter a numeric value to change the rotation.

Data type: Float
Font Script Specifies whether the label text will in superscript or subscript form, or neither of them. Choose an option from the drop-down list.

Data type: Enumeration
Font Shearing Specifies the shearing transformation of each legend label around its center. The default value is 0. Enter a numeric value to change the shearing.

Data type: Float
Font Size Specifies the font size for the legend labels. Enter an integer value to change the size.

Data type: Integer
Font Strikethrough Specifies the style of the line by which the label texts are struck through. Choose an option from the drop-down list.

Data type: Enumeration
Font Style Specifies the font style for the legend labels. Choose an option from the drop-down list.

Data type: Enumeration
Font Underline Specifies the underline style for the legend labels. Choose an option from the drop-down list.

Data type: Enumeration
Gradient End Color Specifies the color of the point where the gradient ends. Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.

Data type: String
Gradient End X Specifies the horizontal position where the gradient ends, measured in a percentage of the label text width.

Data type: Integer
Gradient End Y Specifies the vertical position where the gradient ends, measured in a percentage of the label text height.

Data type: Integer
Gradient Start Color Specifies the color of the point where the gradient begins. Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.

Data type: String
Gradient Start X Specifies the horizontal position where the gradient begins, measured in a percentage of the label text width.

Data type: Integer
Gradient Start Y Specifies the vertical position where the gradient begins, measured in a percentage of the label text height.

Data type: Integer
Gradient Style Specifies the gradient style for the label, applying if the property Fill Type is set to gradient. The image fill type does not apply to the legend label. Choose an option from the drop-down list.

Data type: Enumeration
Outline Color Specifies the color for the label text outline. Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.

Data type: String
Outline End Caps Specifies the ending style for the label text outline. Choose an option from the drop-down list.

Data type: Enumeration
Outline Joint Specifies the joint style for the label text outline. Choose an option from the drop-down list.

Data type: Enumeration
Outline Outlined Specifies whether to show the label text outline in outline form. If the property is set to true, the outline will be shown in outline form; otherwise, in whole form.

Data type: Boolean
Outline Style Specifies the style for the label text outline. Choose an option from the drop-down list.

Data type: Enumeration
Outline Thickness Specifies the thickness for the label text outline. Enter a numeric value to change the thickness.

Data type: Float
Outline Transparency Specifies the transparency for the label text outline, in percent. Enter a numeric value to change the transparency.

Data type: Integer
Outline Variable Dash Specifies whether to resize the dash automatically. If the property is set to true, the dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.

Data type: Boolean
Percent Format Specifies the number format for percentage values. Applies to pie, bench/bar charts that have only one value axis. Click in the value cell to specify the format.

Data type: String
Reverse Labels Specifies whether to reverse the order of the labels in the legend object.

Data type: Boolean
Show Percent Specifies whether to show the percentage of each legend. Applies to pie, bench/bar charts that have only one value axis.

Data type: Boolean
Show Values Specifies whether to show the value of each legend. Applies to pie, bench/bar charts that have only one value axis.

Data type: Boolean
Texture Background Color Specifies the background color of the texture. Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.

Data type: String
Texture Foreground Color Specifies the foreground color of the texture. Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.

Data type: String
Texture Style Specifies the texture style for the label, applying if the property Fill Type is set to texture. Choose an option from the drop-down list.

Data type: Enumeration
Value Format Specifies the number format for the legend values. Applies to pie, bench/bar charts that have only one value axis. Click in the value cell to specify the format.

Data type: String
Word Wrap Specifies whether to enable the word wrap function for the label text. If the text contains special characters (such as ",", "." and space), it will be broken at the position of one of the special characters.

Data type: Boolean

Note: The word wrap function does not apply to radar charts, bubble charts, scatter charts and gauge charts.
Icon
Border Color Specifies the color of the icon borders. Choose a color from the drop-down list, enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.

Data type: String
Border End Caps Specifies the ending style of the icon border line. Choose an option from the drop-down list.

Data type: Enumeration
Border Joint Specifies the joint style of the icon border line. Choose an option from the drop-down list.

Data type: Enumeration
Border Outlined Specifies whether to show the icon border line in Outline Path. If the property is set to true, the icon border line will be shown in Outline Path; otherwise, in Fill Path.

Data type: Boolean
Border Style Specifies the line style of the icon borders. Choose an option from the drop-down list.

Data type: Enumeration
Border Thickness Specifies the width of the icon borders in inches or centimeters. Enter a numeric value to change the thickness.

Data type: Float
Border Transparency Specifies the transparency of the icon borders, in percent. Enter a numeric value to change the transparency.

Data type: Integer
Border Variable Dash Specifies whether to resize the dash automatically. If the property is set to true, the dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.

Data type: Boolean
Height Specifies the height of the icon, in inches or centimeters. Enter a numeric value to change the width.

Data type: Float
Icon Alignment Specifies the relative position of the icon to the legend. Choose an option from the drop-down list.

Data type: Enumeration
Icon Text Gap Specifies the distance between each legend label and icon. Enter a numeric value to change the gap.

Data type: Float
Style List Specifies the style for the icon of each category name, and the icon style for each category name can be different. Click in the value cell to specify the style list.

Data type: String
Width Specifies the width of the icon, in inches or centimeters. Enter a numeric value to change the width.

Data type: Float