The Chart Control provides 2D and 3D views to visualize data series. The Chart Control can display one or multiple series and include various visual elements such as diagrams, series, legends, primary and secondary axes etc to help describe series data. The control uses a Chart Designer to allow users to customize how series data is displayed in the chart.
The following page describes the properties available when the chart control has been selected in the Report Designer.
For more information about the properties listed below, see Properties Common to Most Controls.
▪Actions: Align to Grid, Size to Grid, Center Horizontally, Center Vertically, Bring to Front, Send to Back, Fit Bounds to Container
▪Styles: Even Style, Odd Style, Style
▪Appearance: Background Color, Border Color, Border Dash Style, Border Width, Borders, Font Name, Font Size, Font Unit, Font Effects, Foreground Color, Padding
▪Behavior: Can Publish, Keep Together, Visible
▪Data: Tag
▪Design: Name
▪Layout: Location, Size
▪Navigation: Bookmark, Parent Bookmark, Navigation URL
For more information regarding each of the property groups, see the Control Reference.
Palette Name |
Type: String Sets the name of the palette which is currently used to draw the chart's elements. |
Image Type |
Specifies how the chart is rendered. Options for this property include the following: ▪Metafile: The quality of the rendered image is always good, but in particular cases, some details of the control can be lost. This is the default. ▪Bitmap: The quality of the rendered image is sometimes poor, but it allows the control to be drawn more precisely. |
Series Data Member |
Sets the name of the data field whose values are used to automatically generate and populate series. When a chart binding is used to automatically generate series, the Series Data Member property defines the rule that helps the chart control recognize the data records whose values are used to construct individual series objects. Each automatically generated series gets its name from the data field specified in the Series Data Member property. This name is used to identify a series within the chart control's legend. The template settings for the dynamically created series are defined by the specific properties which are available via the Series Template property of the chart control. The Argument Data Member and Value Data Member properties specify the data fields from which the arguments and data values of the series data points are obtained. If the Series Data Member property is not set for the control the series cannot be automatically generated, even if the Argument Data Member and Value Data Member properties are defined. |
Data Source |
Type: Object Sets the control's data source. If left empty, the report's data source is used. If a data source is set at the series level, the data source at the chart level is overridden. Setting the data source at the chart control level can force series objects to be created dynamically based upon the common template settings. To do so, set the Data Source and Series Data Member properties of a chart control and at the Series Template level, assign the required fields to the Argument Data Member and Value Data Member properties. Series objects obtained automatically from a data source will not exist within the Chart Series collection, they can instead be customized using the Series Template Settings. |
Data Member |
Type: String Specifies the data source table, which supplies data to the control. |
Pivot Grid Data Source Options: Automatic Binding Settings Enabled |
Type: Boolean Specifies whether data member names and value scale types are automatically gathered from the data source. Enabled by default. |
Pivot Grid Data Source Options: Automatic Layout Settings Enabled |
Type: Boolean Specifies whether the control automatically adjusts the chart layout for the XY diagram (the diagram used by XY charts), and for the simple diagram (the diagram used by pie, doughnut and funnel charts). With this setting enabled, the following layout properties are adjusted automatically: ▪If the argument scale type is date-time, the X-axis's Date Time Scale Options property's Measure Unit and Grid Alignment properties are set to data points' minimum measurement unit. ▪The Date Time Options property's Format and Format String values depend on the assigned measurement unit. ▪Since the specified measurement unit affects X-axis labels' text, the Axis Label Staggered property is enabled, and the Angle property is set to 0 by default. |
Parameters |
Specifies the data to be published in the chart at runtime. |
Refer to the following resources for additional help on implementing this control: