Chart Label Properties
This topic describes the properties of a Chart Label object.
Designer provides some properties only when you use the object in certain report types. You can get details from the Available For column in the property table.
Property Name | Available For | Description |
---|---|---|
General | ||
Class Type | Query Page Report | Shows the class type of the object. Read only. |
Data Inherit | Query Page Report | Shows whether the object inherits dataset from another object. Read only. |
Dataset | Query Page Report | Shows the dataset the object applies. Read only. |
Instance Name | Query Page Report | Shows the instance name of the object. Read only. |
Geometry | ||
Height | Page Report, Web Report, Library Component | Specifies the height of the object. Type a numeric value to change the height. Data type: Float |
Width | Page Report, Web Report, Library Component | Specifies the width of the object. Type a numeric value to change the width. Data type: Float |
X | Page Report, Web Report, Library Component | Specifies the horizontal coordinate of the object's top left corner, relative to its parent container. Type a numeric value to change the coordinate.
Data type: Float |
Y | Page Report, Web Report, Library Component | Specifies the vertical coordinate of the object's top left corner, relative to its parent container. Type a numeric value to change the coordinate.
Data type: Float |
CSS | ||
Class | Page Report, Web Report, Library Component | Specifies the name of the Class Selector to apply to the object, which you define in the CSS file of the style the report applies.
For example, if you define the CSS file as follows:
To apply the Class Selector in the file to the object, type C in the value cell. Data type: String |
Style | Page Report, Web Report, Library Component | Specifies the style you want to apply to the object. You can specify the style in two ways:
Data type: String |
Accessibility | ||
External CSS Class Selector | Query Page Report | Specifies the name of the Class Selector for the object in the HTML output. Data type: String |
Label (for customizing the text in the chart label) | ||
Bottom Margin | Page Report, Web Report, Library Component | Specifies the distance between the text and the bottom border of the label, based on the alignment of the text. Type a numeric value to change the margin.
Data type: Float |
Color | Page Report, Web Report, Library Component | Specifies the color to fill the element, when you set Fill Type of the element to "color". Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Fill Transparency | Page Report, Web Report, Library Component | Specifies the transparency for the fill pattern of the element, in percent. Type a numeric value to change the transparency.
Data type: Integer |
Fill Type | Page Report, Web Report, Library Component | Specifies how you want to fill the element, by color, texture, or gradient, or not to fill it. Choose an option from the drop-down list.
Data type: Enumeration |
Font Effect | Page Report, Web Report, Library Component | Specifies the special effect of the label text. Choose an option from the drop-down list.
Data type: Enumeration |
Font Face | Page Report, Web Report, Library Component | Specifies the font face of the label text. Choose an option from the drop-down list.
Data type: Enumeration |
Font Rotation | Page Report, Web Report, Library Component | Specifies the rotation angle of the label text around its center, in degrees. Type a numeric value to change the rotation. Data type: Float |
Font Script | Page Report, Web Report, Library Component | Specifies to apply superscript or subscript formatting to the label text, or neither of them. Choose an option from the drop-down list.
Data type: Enumeration |
Font Shearing | Page Report, Web Report, Library Component | Specifies the shearing transformation of the label text around its center. Type a numeric value to change the shearing. Data type: Float |
Font Size | Page Report, Web Report, Library Component | Specifies the font size of the label text. Type an integer value to change the size. Data type: Integer |
Font Strikethrough | Page Report, Web Report, Library Component | Specifies the style of the line to draw through the label text. Choose an option from the drop-down list. Data type: Enumeration |
Font Style | Page Report, Web Report, Library Component | Specifies the font style of the label text. Choose an option from the drop-down list. Data type: Enumeration |
Font Underline | Page Report, Web Report, Library Component | Specifies the style of the horizontal line under the label text. Choose an option from the drop-down list. "patterned line" or "bold patterned" draws a line or bold line in the pattern of the text.
Data type: Enumeration Web Report Studio and JDashboard do not support underlining chart text so this property will be ignored when the chart runs in Web Report Studio or is used in a dashboard. |
Gradient End Color | Page Report, Web Report, Library Component | Specifies the ending color of the gradient, when you set Fill Type of the element to "gradient". Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Gradient End X | Page Report, Web Report, Library Component | Specifies the horizontal position where the gradient ends when you set Fill Type of the element to "gradient", measured in a percentage of the element's width, from the left edge of the element.
Data type: Integer |
Gradient End Y | Page Report, Web Report, Library Component | Specifies the vertical position where the gradient ends when you set Fill Type of the element to "gradient", measured in a percentage of the element's height, from the bottom edge of the element.
Data type: Integer |
Gradient Start Color | Page Report, Web Report, Library Component | Specifies the starting color of the gradient, when you set Fill Type of the element to "gradient". Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Gradient Start X | Page Report, Web Report, Library Component | Specifies the horizontal position where the gradient begins when you set Fill Type of the element to "gradient", measured in a percentage of the element's width, from the left edge of the element.
Data type: Integer |
Gradient Start Y | Page Report, Web Report, Library Component | Specifies the vertical position where the gradient begins when you set Fill Type of the element to "gradient", measured in a percentage of the element's height, from the bottom edge of the element.
Data type: Integer |
Gradient Style | Page Report, Web Report, Library Component | Specifies the style of the gradient to fill the element, when you set Fill Type of the element to "gradient". Choose an option from the drop-down list.
Data type: Enumeration |
Left Margin | Page Report, Web Report, Library Component | Specifies the distance between the text and the left border of the label, based on the alignment of the text. Type a numeric value to change the margin.
Data type: Float |
Outline Color | Page Report, Web Report, Library Component | Specifies the color of the text outline, when you set Font Effect to "outlined" or "shadowed & outlined". Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Outline End Caps | Page Report, Web Report, Library Component | Specifies the ending style of the text outline, when you set Font Effect to "outlined" or "shadowed & outlined". Choose an option from the drop-down list.
Data type: Enumeration |
Outline Joint | Page Report, Web Report, Library Component | Specifies the joint style of the text outline, when you set Font Effect to "outlined" or "shadowed & outlined". Choose an option from the drop-down list.
Data type: Enumeration |
Outline Outlined | Page Report, Web Report, Library Component | Specifies whether to use outline path for the text outline, when you set Font Effect to "outlined" or "shadowed & outlined". Default is to apply fill path.
Data type: Boolean |
Outline Style | Page Report, Web Report, Library Component | Specifies the style of the text outline, when you set Font Effect to "outlined" or "shadowed & outlined". Choose an option from the drop-down list. Data type: Enumeration |
Outline Thickness | Page Report, Web Report, Library Component | Specifies the width of the text outline, when you set Font Effect to "outlined" or "shadowed & outlined". Type a numeric value to change the thickness. Data type: Float |
Outline Transparency | Page Report, Web Report, Library Component | Specifies the transparency of the text outline, when you set Font Effect to "outlined" or "shadowed & outlined". Type a numeric value to change the transparency. Data type: Integer |
Outline Variable Dash | Page Report, Web Report, Library Component | Specifies whether to resize the dash automatically when you select a dash line style for Outline Style. Default is to apply fixed dash size. Data type: Boolean |
Right Margin | Page Report, Web Report, Library Component | Specifies the distance between the text and the right border of the label, based on the alignment of the text. Type a numeric value to change the margin.
Data type: Float |
Text | Page Report, Web Report, Library Component | Specifies the text of the label. Type a string to change the text.
Data type: String |
Text Alignment | Page Report, Web Report, Library Component | Specifies the alignment of the text in the label. Choose an option from the drop-down list.
Data type: Enumeration |
Texture Background Color | Page Report, Web Report, Library Component | Specifies the background color of the texture, when you set Fill Type of the element to "texture". Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Texture Foreground Color | Page Report, Web Report, Library Component | Specifies the foreground color of the texture, when you set Fill Type of the element to "texture". Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Texture Style | Page Report, Web Report, Library Component | Specifies the style of the texture to fill the element, when you set Fill Type of the element to "texture". Choose an option from the drop-down list.
Data type: Enumeration |
Top Margin | Page Report, Web Report, Library Component | Specifies the distance between the text and the top border of the label, based on the alignment of the text. Type a numeric value to change the margin.
Data type: Float |
Word Wrap | Page Report, Web Report, Library Component | Specifies whether to wrap the text according to the width of the label. If the text contains special characters (such as ",", ".", and space), it wraps at the position of one of the characters.
Data type: Boolean This property does not take effect for radar charts, bubble charts, scatter charts, or gauge charts. |
Background (for customizing fill pattern of the chart label) | ||
Border Color | Page Report, Web Report, Library Component | Specifies the color for the border of the object. Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Border End Caps | Page Report, Web Report, Library Component | Specifies the ending style for the border of the element. Choose an option from the drop-down list.
Data type: Enumeration |
Border Joint | Page Report, Web Report, Library Component | Specifies the joint style for the border of the element. Choose an option from the drop-down list.
Data type: Enumeration |
Border Outlined | Page Report, Web Report, Library Component | Specifies whether to use outline path for the border of the element. Default is to apply fill path.
Data type: Boolean |
Border Style | Page Report, Web Report, Library Component | Specifies the line style for the border of the object. Choose an option from the drop-down list.
Data type: Enumeration |
Border Thickness | Page Report, Web Report, Library Component | Specifies the width for the border of the object. Type a numeric value to change the thickness.
Data type: Float |
Border Transparency | Page Report, Web Report, Library Component | Specifies the transparency for the border of the element, in percent. Type a numeric value to change the transparency.
Data type: Integer |
Border Type | Page Report, Web Report, Library Component | Specifies the type for the border of the element.
Data type: Enumeration |
Border Variable Dash | Page Report, Web Report, Library Component | Specifies whether to resize the dash automatically when you select a dash line style for Border Style. Default is to apply fixed dash size. Data type: Boolean |
Color | Page Report, Web Report, Library Component | Specifies the color to fill the element, when you set Fill Type of the element to "color". Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Fill Transparency | Page Report, Web Report, Library Component | Specifies the transparency for the fill pattern of the element, in percent. Type a numeric value to change the transparency.
Data type: Integer |
Fill Type | Page Report, Web Report, Library Component | Specifies how you want to fill the element, by color, texture, gradient, or image, or not to fill it. Choose an option from the drop-down list.
Data type: Enumeration |
Gradient End Color | Page Report, Web Report, Library Component | Specifies the ending color of the gradient, when you set Fill Type of the element to "gradient". Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Gradient End X | Page Report, Web Report, Library Component | Specifies the horizontal position where the gradient ends when you set Fill Type of the element to "gradient", measured in a percentage of the element's width or the width of the inset in the element if you define an inset, from the left edge of the element or inset.
Data type: Integer |
Gradient End Y | Page Report, Web Report, Library Component | Specifies the vertical position where the gradient ends when you set Fill Type of the element to "gradient", measured in a percentage of the element's height or the height of the inset in the element if you define an inset, from the bottom edge of the element or inset.
Data type: Integer |
Gradient Start Color | Page Report, Web Report, Library Component | Specifies the starting color of the gradient, when you set Fill Type of the element to "gradient". Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Gradient Start X | Page Report, Web Report, Library Component | Specifies the horizontal position where the gradient begins when you set Fill Type of the element to "gradient", measured in a percentage of the element's width or the width of the inset in the element if you define an inset, from the left edge of the element or inset.
Data type: Integer |
Gradient Start Y | Page Report, Web Report, Library Component | Specifies the vertical position where the gradient begins when you set Fill Type of the element to "gradient", measured in a percentage of the element's height or the height of the inset in the element if you define an inset, from the bottom edge of the element or inset.
Data type: Integer |
Gradient Style | Page Report, Web Report, Library Component | Specifies the style of the gradient to fill the element, when you set Fill Type of the element to "gradient". Choose an option from the drop-down list.
Data type: Enumeration |
Image File | Page Report, Web Report, Library Component | Specifies the file name of the image, a portion of which you want to use to fill the element, when you set Fill Type of the element to "image". Type the file name with suffix in the value cell. If the image is outside the current catalog, you should include the full path of the image correctly.
Data type: String |
Image Height | Page Report, Web Report, Library Component | You can use the four properties, Image Height, Image Width, Image X, and Image Y, to define a portion of an image (the portion is a rectangle) to fill the element, when you set Fill Type of the element to "image".
Image Height specifies the height of the portion, measured in a percentage of the image's height. Data type: Integer |
Image Layout | Page Report, Web Report, Library Component | Specifies the layout of the image portion to fill the element, when you set Fill Type of the element to "image". Choose an option from the drop-down list.
Data type: Enumeration |
Image Width | Page Report, Web Report, Library Component | You can use the four properties, Image Height, Image Width, Image X, and Image Y, to define a portion of an image (the portion is a rectangle) to fill the element, when you set Fill Type of the element to "image".
Image Width specifies the width of the portion, measured in a percentage of the image's width. Data type: Integer |
Image X | Page Report, Web Report, Library Component | You can use the four properties, Image Height, Image Width, Image X, and Image Y, to define a portion of an image (the portion is a rectangle) to fill the element, when you set Fill Type of the element to "image".
Image X specifies the left position of the portion, measured in a percentage of the image's width, from the left edge of the image. Data type: Integer |
Image Y | Page Report, Web Report, Library Component | You can use the four properties, Image Height, Image Width, Image X, and Image Y, to define a portion of an image (the portion is a rectangle) to fill the element, when you set Fill Type of the element to "image".
Image Y specifies the top position of the portion, measured in a percentage of the image's height, from the bottom edge of the image. Data type: Integer |
Inset Bottom | Page Report, Web Report, Library Component | You can use the four properties, Inset Bottom, Inset Left, Inset Right, and Inset Top, to define an inset in the element and fill the inset instead of the entire element.
Inset Bottom specifies the bottom position of the inset, measured in a percentage of the element's height, from the bottom edge of the element. Data type: Float |
Inset Left | Page Report, Web Report, Library Component | You can use the four properties, Inset Bottom, Inset Left, Inset Right, and Inset Top, to define an inset in the element and fill the inset instead of the entire element.
Inset Left specifies the left position of the inset, measured in a percentage of the element's width, from the left edge of the element. Data type: Float |
Inset Right | Page Report, Web Report, Library Component | You can use the four properties, Inset Bottom, Inset Left, Inset Right, and Inset Top, to define an inset in the element and fill the inset instead of the entire element.
Inset Right specifies the right position of the inset, measured in a percentage of the element's width, from the right edge of the element. Data type: Float |
Inset Top | Page Report, Web Report, Library Component | You can use the four properties, Inset Bottom, Inset Left, Inset Right, and Inset Top, to define an inset in the element and fill the inset instead of the entire element.
Inset Top specifies the top position of the inset, measured in a percentage of the element's height, from the top edge of the element. Data type: Float |
Texture Background Color | Page Report, Web Report, Library Component | Specifies the background color of the texture, when you set Fill Type of the element to "texture". Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Texture Foreground Color | Page Report, Web Report, Library Component | Specifies the foreground color of the texture, when you set Fill Type of the element to "texture". Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Texture Style | Page Report, Web Report, Library Component | Specifies the style of the texture to fill the element, when you set Fill Type of the element to "texture". Choose an option from the drop-down list.
Data type: Enumeration |
Icon (for customizing the icon in the chart label) | ||
Border Color | Page Report, Web Report, Library Component | Specifies the color for the border of the object. Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Border End Caps | Page Report, Web Report, Library Component | Specifies the ending style for the border of the element. Choose an option from the drop-down list.
Data type: Enumeration |
Border Joint | Page Report, Web Report, Library Component | Specifies the joint style for the border of the element. Choose an option from the drop-down list.
Data type: Enumeration |
Border Outlined | Page Report, Web Report, Library Component | Specifies whether to use outline path for the border of the element. Default is to apply fill path.
Data type: Boolean |
Border Style | Page Report, Web Report, Library Component | Specifies the line style for the border of the object. Choose an option from the drop-down list.
Data type: Enumeration |
Border Thickness | Page Report, Web Report, Library Component | Specifies the width for the border of the object. Type a numeric value to change the thickness.
Data type: Float |
Border Transparency | Page Report, Web Report, Library Component | Specifies the transparency for the border of the element, in percent. Type a numeric value to change the transparency.
Data type: Integer |
Border Variable Dash | Page Report, Web Report, Library Component | Specifies whether to resize the dash automatically when you select a dash line style for Border Style. Default is to apply fixed dash size. Data type: Boolean |
Color | Page Report, Web Report, Library Component | Specifies the color to fill the element, when you set Fill Type of the element to "color". Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Fill Transparency | Page Report, Web Report, Library Component | Specifies the transparency for the fill pattern of the element, in percent. Type a numeric value to change the transparency.
Data type: Integer |
Fill Type | Page Report, Web Report, Library Component | Specifies how you want to fill the element, by color, texture, gradient, or image, or not to fill it. Choose an option from the drop-down list.
Data type: Enumeration |
Gradient End Color | Page Report, Web Report, Library Component | Specifies the ending color of the gradient, when you set Fill Type of the element to "gradient". Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Gradient End X | Page Report, Web Report, Library Component | Specifies the horizontal position where the gradient ends when you set Fill Type of the element to "gradient", measured in a percentage of the element's width, from the left edge of the element.
Data type: Integer |
Gradient End Y | Page Report, Web Report, Library Component | Specifies the vertical position where the gradient ends when you set Fill Type of the element to "gradient", measured in a percentage of the element's height, from the bottom edge of the element.
Data type: Integer |
Gradient Start Color | Page Report, Web Report, Library Component | Specifies the starting color of the gradient, when you set Fill Type of the element to "gradient". Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Gradient Start X | Page Report, Web Report, Library Component | Specifies the horizontal position where the gradient begins when you set Fill Type of the element to "gradient", measured in a percentage of the element's width, from the left edge of the element.
Data type: Integer |
Gradient Start Y | Page Report, Web Report, Library Component | Specifies the vertical position where the gradient begins when you set Fill Type of the element to "gradient", measured in a percentage of the element's height, from the bottom edge of the element.
Data type: Integer |
Gradient Style | Page Report, Web Report, Library Component | Specifies the style of the gradient to fill the element, when you set Fill Type of the element to "gradient". Choose an option from the drop-down list.
Data type: Enumeration |
Height | Page Report, Web Report, Library Component | Specifies the height of the icon. Type a numeric value to change the height.
Data type: Float |
Icon Alignment | Page Report, Web Report, Library Component | Specifies the alignment of the icon relative to the text in the label. Choose an option from the drop-down list.
Data type: Enumeration |
Icon Style | Page Report, Web Report, Library Component | Specifies the style of the icon to display in the label. Choose an option from the drop-down list.
Data type: Enumeration |
Icon Text Gap | Page Report, Web Report, Library Component | Specifies the distance between the icon and the label text. Type a numeric value to change the gap. Data type: Float |
Image File | Page Report, Web Report, Library Component | Specifies the file name of the image, a portion of which you want to use to fill the icon, when you set Fill Type of the icon to "image". Type the file name with suffix in the value cell. If the image is outside the current catalog, you should include the full path of the image correctly. Data type: String |
Image Height | Page Report, Web Report, Library Component | You can use the four properties, Image Height, Image Width, Image X, and Image Y, to define a portion of an image (the portion is a rectangle) to fill the icon, when you set Fill Type of the icon to "image".
Image Height specifies the height of the image portion, measured in a percentage of the image's height. Data type: Integer |
Image Layout | Page Report, Web Report, Library Component | Specifies the layout of the image portion to fill the element, when you set Fill Type of the element to "image". Choose an option from the drop-down list.
Data type: Enumeration |
Image Width | Page Report, Web Report, Library Component | You can use the four properties, Image Height, Image Width, Image X, and Image Y, to define a portion of an image (the portion is a rectangle) to fill the icon, when you set Fill Type of the icon to "image".
Image Width specifies the width of the image portion, measured in a percentage of the image's width. Data type: Integer |
Image X | Page Report, Web Report, Library Component | You can use the four properties, Image Height, Image Width, Image X, and Image Y, to define a portion of an image (the portion is a rectangle) to fill the icon, when you set Fill Type of the icon to "image".
Image X specifies the left position of the portion, measured in a percentage of the image's width, from the left edge of the image. Data type: Integer |
Image Y | Page Report, Web Report, Library Component | You can use the four properties, Image Height, Image Width, Image X, and Image Y, to define a portion of an image (the portion is a rectangle) to fill the icon, when you set Fill Type of the icon to "image".
Image Y specifies the top position of the portion, measured in a percentage of the image's height, from the bottom edge of the image. Data type: Integer |
Texture Background Color | Page Report, Web Report, Library Component | Specifies the background color of the texture, when you set Fill Type of the element to "texture". Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Texture Foreground Color | Page Report, Web Report, Library Component | Specifies the foreground color of the texture, when you set Fill Type of the element to "texture". Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Texture Style | Page Report, Web Report, Library Component | Specifies the style of the texture to fill the element, when you set Fill Type of the element to "texture". Choose an option from the drop-down list.
Data type: Enumeration |
Width | Page Report, Web Report, Library Component | Specifies the width of the icon. Type a numeric value to change the width.
Data type: Float |