ControlCollection.AddChart - метод (Double, Double, Double, Double, String)
Добавляет в заданное место листа новый элемент управления Chart указанного размера.
Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel (в Microsoft.Office.Tools.Excel.dll)
Синтаксис
'Декларация
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
)
Параметры
- left
Тип: System.Double
Расстояние в пунктах между левым краем элемента управления и левым краем листа.
- top
Тип: System.Double
Расстояние в пунктах между верхним краем элемента управления и верхним краем листа.
- width
Тип: System.Double
Ширина элемента управления в пунктах.
- height
Тип: System.Double
Высота элемента управления в пунктах.
- name
Тип: System.String
Имя элемента управления.
Возвращаемое значение
Тип: Microsoft.Office.Tools.Excel.Chart
Элемент управления Chart, добавленный в экземпляр ControlCollection.
Исключения
| Исключение | Условие |
|---|---|
| ArgumentNullException | Аргумент имени равен nullссылка NULL (Nothing в Visual Basic) или имеет нулевую длину. |
| ControlNameAlreadyExistsException | Элемент управления с таким именем уже имеется в данном экземпляре ControlCollection. |
Заметки
Метод AddChart используется для добавления элементов управления Chart в конец ControlCollection. Чтобы удалить добавленный программно элемент управления Chart, воспользуйтесь методом Remove.
Примеры
В следующем примере кода в ячейки от E1 до E3 вставляется число 16, а в ячейки от F1 до F3 вставляется число 24. Затем в верхней части листа создается элемент управления Chart, а ячейки от E1 до F3 передаются в метод SetSourceData для заполнения диаграммы данными.
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;
}
Безопасность платформы .NET Framework
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.