Método Chart.ColumnGroups

Artigo
05/21/2013

2d Em um gráfico, retorna um objeto que representa um único grupo de gráfico de coluna (um objeto de ChartGroup ) ou uma coleção de grupos de gráfico de coluna (uma coleção de ChartGroups ).

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

Sintaxe

'Declaração
Function ColumnGroups ( _
    Index As Object _
) As Object

Object ColumnGroups(
    Object Index
)

Parâmetros

Index
Tipo: System.Object
Especifica o grupo de gráfico.

Valor de retorno

Tipo: System.Object
Um objeto que representa um único grupo de gráfico de coluna (um objeto de ChartGroup ) ou uma coleção de grupos de gráfico de coluna (uma coleção de ChartGroups ).

Comentários

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir cria uma coluna Chart e usa o método de ColumnGroups para definir o espaço entre colunas.

Private Sub UseColumnGroups()
    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.xlColumnClustered

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

    group.GapWidth = 400
End Sub

private void UseColumnGroups()
{
    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.xlColumnClustered;

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

    group.GapWidth = 400;
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

Chart Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via