Chart.ChartGroups Method
Gets either a single chart group (a ChartGroup object) or a collection of all the chart groups in the chart (a ChartGroups object).
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)
Syntax
'Declaration
Function ChartGroups ( _
Index As Object _
) As Object
Object ChartGroups(
Object Index
)
Parameters
- Index
Type: System.Object
The chart group number.
Return Value
Type: System.Object
Either a single chart group (a ChartGroup object) or a collection of all the chart groups in the chart (a ChartGroups object). The returned collection includes every type of group.
Remarks
Optional Parameters
For information on optional parameters, see Optional Parameters in Office Solutions.
Examples
The following code example creates a column Chart and then uses the ChartGroups method to modify the space between the columns.
Private Sub UseChartGroups()
Me.Range("A1", "A5").Value2 = 22
Me.Range("B1", "B5").Value2 = 55
Dim Chart1 As Microsoft.Office.Tools.Excel.Chart = _
Me.Controls.AddChart(Me.Range("D2", "H12"), "Chart1")
Chart1.SetSourceData(Me.Range("A1", "B5"), Excel.XlRowCol.xlColumns)
Chart1.ChartType = Excel.XlChartType.xl3DColumn
Dim group As Excel.ChartGroup = CType(Chart1.ChartGroups(1), _
Excel.ChartGroup)
group.GapWidth = 400
End Sub
private void UseChartGroups()
{
this.Range["A1", "A5"].Value2 = 22;
this.Range["B1", "B5"].Value2 = 55;
Microsoft.Office.Tools.Excel.Chart chart1 =
this.Controls.AddChart(this.Range["D2", "H12"],
"chart1");
chart1.SetSourceData(this.Range["A1", "B5"],
Excel.XlRowCol.xlColumns);
chart1.ChartType = Excel.XlChartType.xl3DColumn;
Excel.ChartGroup group =
(Excel.ChartGroup)chart1.ChartGroups(1);
group.GapWidth = 400;
}
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.