Método ControlCollection.AddChart (Double, Double, Double, Double, String)

Adiciona um novo controle de Chart a planilha no tamanho e o local especificados.

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

Sintaxe

'Declaração
Function AddChart ( _
    left As Double, _
    top As Double, _
    width As Double, _
    height As Double, _
    name As String _
) As Chart

Chart AddChart(
    double left,
    double top,
    double width,
    double height,
    string name
)

Parâmetros

• left
  Tipo: System.Double
  Os pontos a distância entre a borda esquerda de controle e a borda esquerda da planilha.

• top
  Tipo: System.Double
  Os pontos a distância entre a borda superior do controle e a borda superior da planilha.

• width
  Tipo: System.Double
  A largura do controle em pontos.

• height
  Tipo: System.Double
  A altura do controle em pontos.

• name
  Tipo: System.String
  O nome do controle.

Valor de retorno

Tipo: Microsoft.Office.Tools.Excel.Chart
O controle de Chart que foi adicionado à instância de ControlCollection .

Exceções

Exceção	Condição
ArgumentNullException	O argumento do nome é nulluma referência nula (Nothing no Visual Basic) ou tem comprimento zero.
ControlNameAlreadyExistsException	Um controle com o mesmo nome já está na instância de ControlCollection .

Comentários

O método de AddChart permite que você adicione controles de Chart ao final de ControlCollection. Para remover Chart controle que foi adicionado anteriormente por meio de programação, usando o método de Remove .

Exemplos

O exemplo de código insere o número 16 células E1 com E3 e o número 24 células F1 com F3. O código então cria um controle de Chart à parte superior da planilha e passa células E1 com F3 para o método de SetSourceData para preencher o gráfico com dados.

Private Sub ExcelAddChart()
    Me.Range("E1", "E3").Value2 = 16
    Me.Range("F1", "F3").Value2 = 24

    Dim Chart1 As Microsoft.Office.Tools.Excel. _
        Chart = Me.Controls.AddChart(0, 0, 130, _
        130, "Chart1")

    Chart1.SetSourceData(Me.Range("E1", "F3"), _
        Excel.XlRowCol.xlColumns)
    Chart1.ChartType = Excel.XlChartType. _
        xlColumnClustered

End Sub

private void ExcelAddChart()
{
    this.Range["E1", "E3"].Value2 = 16;
    this.Range["F1", "F3"].Value2 = 24;

    Microsoft.Office.Tools.Excel.Chart chart1 =
        this.Controls.AddChart(0, 0, 130, 130, "chart1");

    chart1.SetSourceData(this.Range["E1", "F3"], Excel.XlRowCol.xlColumns);
    chart1.ChartType = Excel.XlChartType.xlColumnClustered;
}

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

Consulte também

Referência

ControlCollection Interface

Sobrecargas AddChart

Namespace Microsoft.Office.Tools.Excel