Chart Control

Description

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.

Properties Common to Most Controls

For more information about the properties listed below, see Properties Common to Most Controls.

For more information regarding each of the property groups, see the Control Reference.

Appearance

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.

Data

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.

Related Tutorials

Refer to the following resources for additional help on implementing this control:

© 2020 VertiGIS North America Ltd. All Rights Reserved.

Documentation Version 5.10