ChartGroup Interface

Definition

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Represents one or more series plotted in a chart with the same format. The ChartGroup object is a member of the ChartGroups collection.

public interface class ChartGroup

[System.Runtime.InteropServices.Guid("00020859-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface ChartGroup

Public Interface ChartGroup

Attributes

GuidAttribute InterfaceTypeAttribute

Remarks

A chart contains one or more chart groups, each chart group contains one or more series, and each series contains one or more points. For example, a single chart might contain both a line chart group, containing all the series plotted with the line chart format, and a bar chart group, containing all the series plotted with the bar chart format.

Use ChartGroups(index), where index is the chart-group index number, to return a single ChartGroup object. If the chart has been activated, you can use the ActiveChart property.

Because the index number for a particular chart group can change if the chart format used for that group is changed, it may be easier to use one of the named chart group shortcut methods to return a particular chart group. The PieGroups(Object) method returns the collection of pie chart groups in a chart, the LineGroups(Object) method returns the collection of line chart groups, and so on. Each of these methods can be used with an index number to return a single ChartGroup object, or without an index number to return a ChartGroups collection. The following chart group methods are available:

• AreaGroups(Object) method
• BarGroups(Object) method
• ColumnGroups(Object) method
• DoughnutGroups(Object) method
• LineGroups(Object) method
• PieGroups(Object) method

Properties

Application	Returns an Application object that represents the creator of the specified object (you can use this property with an OLE Automation object to return the application of that object).
AxisGroup	Returns the group for the specified chart group or series.
BubbleScale	Returns or sets the scale factor for bubbles in the specified chart group. Can be an integer value from 0 (zero) to 300, corresponding to a percentage of the default size. Applies only to bubble charts.
Creator	Returns a 32-bit integer that indicates the application in which this object was created. If the object was created in Microsoft Excel, this property returns the string XCEL, which is equivalent to the hexadecimal number 5843454C.
DoughnutHoleSize	Returns or sets the size of the hole in a doughnut chart group. The hole size is expressed as a percentage of the chart size, between 10 and 90 percent.
DownBars	Returns a DownBars object that represents the down bars on a line chart. Applies only to line charts.
DropLines	Returns a DropLines object that represents the drop lines for a series on a line chart or area chart. Applies only to line charts or area charts.
FirstSliceAngle	Returns or sets the angle of the first pie-chart or doughnut-chart slice in degrees (clockwise from vertical). Applies only to pie, 3-D pie, and doughnut charts.
GapWidth	Bar and Column charts: Returns or sets the space between bar or column clusters as a percentage of the bar or column width. Pie of Pie and Bar of Pie charts: Returns or sets the space between the primary and secondary sections of the chart.
Has3DShading	True if the chart group has three-dimensional shading. This property only applies to surface charts and will return a run-time error if you try to set it to a non-surface chart.
HasDropLines	True if the line chart or area chart has drop lines. Applies only to line and area charts.
HasHiLoLines	True if the line chart has high-low lines. Applies only to line charts.
HasRadarAxisLabels	True if a radar chart has axis labels. Applies only to radar charts.
HasSeriesLines	True if a stacked column chart or bar chart has series lines or if a Pie of Pie chart or Bar of Pie chart has connector lines between the two sections. Applies only to stacked column charts, bar charts, Pie of Pie charts, or Bar of Pie charts.
HasUpDownBars	True if a line chart has up and down bars. Applies only to line charts.
HiLoLines	Returns a HiLoLines object that represents the high-low lines for a series on a line chart. Applies only to line charts.
Index	Returns the index number of the object within the collection of similar objects.
Overlap	Specifies how bars and columns are positioned. Can be a value between –100 and 100. Applies only to 2-D bar and 2-D column charts.
Parent	Returns the parent object for the specified object.
RadarAxisLabels	Returns a TickLabels object that represents the radar axis labels for the specified chart group.
SecondPlotSize	Returns or sets the size of the secondary section of either a Pie of Pie chart or a Bar of Pie chart, as a percentage of the size of the primary pie. Can be a value from 5 to 200.
SeriesLines	Returns a SeriesLines object that represents the series lines for a stacked bar chart or a stacked column chart. Applies only to stacked bar and stacked column charts.
ShowNegativeBubbles	True if negative bubbles are shown for the chart group. Valid only for bubble charts.
SizeRepresents	Returns or sets what the bubble size represents on a bubble chart. Can be either of the following XlSizeRepresents constants: xlSizeIsArea or xlSizeIsWidth.
SplitType	Returns or sets the way the two sections of either a Pie of Pie chart or a Bar of Pie chart are split.
SplitValue	Returns or sets the threshold value separating the two sections of either a Pie of Pie chart or a Bar of Pie chart.
SubType	Reserved for internal use.
Type	Reserved for internal use.
UpBars	Returns an UpBars object that represents the up bars on a line chart. Applies only to line charts.
VaryByCategories	True if Microsoft Excel assigns a different color or pattern to each data marker. The chart must contain only one series.

Methods

CategoryCollection(Object)	Returns an object that represents a collection of all of the visible categories (a CategoryCollection collection) in the chart group.
FullCategoryCollection(Object)	Returns an object that represents a collection of all of the visible and filtered categories (a CategoryCollection) in the chart group.
SeriesCollection(Object)	Returns an object that represents either a single series (a Series object) or a collection of all the series (a SeriesCollection collection) in the chart or chart group.