Version

ComboChartGroups Property

Returns a collection of the ComboChartGroup instances associated with this chart.
Syntax
'Declaration
 
Public ReadOnly Property ComboChartGroups As ComboChartGroupCollection
public ComboChartGroupCollection ComboChartGroups {get;}
Remarks

The properties of the WorksheetChart class which apply only to a specific chart type are not applicable for combo charts. For example, the GapWidth property, which applies to bar charts, is not used for bar charts which appear within a combo chart. The reason for this is that combo charts support multiple occurrences of the same chart type, making the WorksheetChart-level properties ambiguous in the context of a combo chart.

This class makes it possible to set chart-specific properties for one or more occurrences of a particular chart type, for a particular axis group.

For example, consider a combo chart with two ClusteredColumn series, one on the primary axis and another on the secondary. To set the GapWidth property for the chart on the primary axis, add an item to this collection with a ChartType of ClusteredColumn, and an Infragistics.Documents.Excel.Charts.AxisGroup of Primary. On the ComboChartGroup instance returned from the collection's Add method, set the GapWidth property to the desired value.

When the chart is serialized, this collection is checked against each series in the combo chart. If the ChartType and the AxisGroup match the respective properties on a ComboChartGroup instance, the value of that instance's GapWidth property is applied to the chart element for that series. Because the other clustered column series exists on the secondary axis, the property is not applied to that series, since while it has the same ChartType, its AxisGroup is different.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also