ControlCollection.AddChart Метод (Double, Double, Double, Double, String) (2007 System)
Обновлен: Ноябрь 2007
Добавляет в заданное место листа новый элемент управления Chart указанного размера.
Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)
Синтаксис
'Декларация
Public Function AddChart ( _
left As Double, _
top As Double, _
width As Double, _
height As Double, _
name As String _
) As Chart
'Применение
Dim instance As ControlCollection
Dim left As Double
Dim top As Double
Dim width As Double
Dim height As Double
Dim name As String
Dim returnValue As Chart
returnValue = instance.AddChart(left, _
top, width, height, name)
public 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;
}
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.