Metodo ControlCollection.AddChart (Range, String)

  • Articolo

Aggiunge un nuovo controllo Chart al foglio di lavoro in corrispondenza dell'intervallo specificato.

Spazio dei nomi:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
Function AddChart ( _
    range As Range, _
    name As String _
) As Chart

Chart AddChart(
    Range range,
    string name
)

Parametri

Valore restituito

Tipo: Microsoft.Office.Tools.Excel.Chart
Controllo Chart aggiunto all'istanza di ControlCollection.

Eccezioni

Eccezione Condizione
ArgumentNullException

L'argomento relativo al nome o all'intervallo è nullriferimento null (Nothing in Visual Basic) oppure la lunghezza dell'argomento relativo al nome è zero.
ControlNameAlreadyExistsException

Nell'istanza di ControlCollection è già presente un controllo con lo stesso nome.
InvalidRangeException

L'intervallo specificato non è valido. Impossibile utilizzare gli intervalli di più aree. L'intervallo deve trovarsi nello stesso foglio di lavoro dell'istanza di ControlCollection.

Note

Il metodo AddChart consente di aggiungere controlli Chart alla fine dell'oggetto ControlCollection. Per rimuovere un controllo Chart aggiunto in precedenza a livello di codice, utilizzare il metodo Remove.

Esempi

Nell'esempio di codice riportato di seguito vengono aggiunti il numero 16 nelle celle comprese tra E1 e E3 e il numero 24 nelle celle comprese tra F1 e F3. Il codice crea quindi un controllo Chart nelle celle comprese tra A1 e C8 e passa le celle comprese tra E1 e F3 al metodo SetSourceData per inserire dati nel grafico.

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

    Dim Chart1 As Microsoft.Office.Tools.Excel.Chart _
        = Me.Controls.AddChart(Me.Range("A1", "C8"), _
        "Chart1")

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

End Sub 

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

    Microsoft.Office.Tools.Excel.Chart chart1 =
        this.Controls.AddChart(this.Range["A1", "C8"], "Chart1");

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

Sicurezza di .NET Framework

Vedere anche

Riferimenti

ControlCollection Interfaccia

Overload AddChart

Spazio dei nomi Microsoft.Office.Tools.Excel