Chart.AreaGroups Method

Article
06/14/2013

On a 2-D chart, gets an object that represents either a single area chart group (a ChartGroup object) or a collection of the area chart groups (a ChartGroups collection).

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
Function AreaGroups ( _
    Index As Object _
) As Object

Object AreaGroups(
    Object Index
)

Parameters

Index
Type: System.Object

The chart group number.

Return Value

Type: System.Object

Remarks

Optional Parameters

For information on optional parameters, see Optional Parameters in Office Solutions.

Examples

The following code example creates an area Chart and then uses the AreaGroups method to add drop lines to the chart.

Private Sub UseAreaGroups()
    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.xlAreaStacked

    Dim group As Excel.ChartGroup = _
        CType(Chart1.AreaGroups(1), Excel.ChartGroup)

    group.HasDropLines = True 
End Sub

private void UseAreaGroups()
{
    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.xlAreaStacked;

    Excel.ChartGroup group =
        (Excel.ChartGroup)chart1.AreaGroups(1);

    group.HasDropLines = true;
}

.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.