WorksheetBase.ChartObjects - метод

Статья
05/19/2013

Возвращает объект, представляющий либо отдельную внедренную диаграмму (объект Microsoft.Office.Interop.Excel.ChartObject), либо коллекцию всех внедренных диаграмм (коллекция Microsoft.Office.Interop.Excel.ChartObjects) на рабочем листе.

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v4.0.Utilities (в Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Синтаксис

'Декларация
Public Function ChartObjects ( _
    index As Object _
) As Object

public Object ChartObjects(
    Object index
)

Параметры

index
Тип: System.Object
Имя или номер диаграммы.В случае задания нескольких диаграмм этим аргументом может быть массив.

Возвращаемое значение

Тип: System.Object
Объект, представляющий либо отдельную внедренную диаграмму (объект Microsoft.Office.Interop.Excel.ChartObject), либо коллекцию всех внедренных диаграмм (коллекция Microsoft.Office.Interop.Excel.ChartObjects) на рабочем листе.

Заметки

Данный метод не равносилен свойству Charts.Метод возвращает внедренные диаграммы, в то время как свойство Charts возвращает листы диаграмм.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.

Примеры

В следующем примере кода демонстрируется использование метода ChartObjects для получения коллекции внедренных диаграмм и отдельной внедренной диаграммы.В примере сперва используется метод ChartObjects для получения коллекции Microsoft.Office.Interop.Excel.ChartObjects текущего рабочего листа и создания нового объекта Microsoft.Office.Interop.Excel.ChartObject.После форматирования нового объекта Microsoft.Office.Interop.Excel.ChartObject и присвоения объекту Microsoft.Office.Interop.Excel.ChartObject имени метод ChartObjects используется в примере для получения нового объекта Microsoft.Office.Interop.Excel.ChartObject (индексированного по имени). Затем выводится окно предварительного просмотра диаграммы перед печатью.

В этом примере демонстрируется настройка уровня документа.

Private Sub CreateAndPreviewChart()
    Me.Range("A1", "A3").Value2 = 11
    Me.Range("B1", "B3").Value2 = 55

    Dim ChartObjects1 As Excel.ChartObjects = _
        CType(Me.ChartObjects(), Excel.ChartObjects)
    Dim chartObject1 As Excel.ChartObject = _
        ChartObjects1.Add(100, 20, 400, 250)

    chartObject1.Chart.ChartWizard(Me.Range("A1", "B3"), _
        Excel.XlChartType.xl3DColumn, Title:="New Chart")
    chartObject1.Name = "NewChartObject"

    Dim chartObject2 As Excel.ChartObject = _
        CType(Me.ChartObjects("NewChartObject"), Excel.ChartObject)
    chartObject2.Chart.PrintPreview(False)
End Sub

private void CreateAndPreviewChart()
{
    this.Range["A1", "A3"].Value2 = 11;
    this.Range["B1", "B3"].Value2 = 55;

    Excel.ChartObjects ChartObjects1 =
        (Excel.ChartObjects)this.ChartObjects();
    Excel.ChartObject chartObject1 = ChartObjects1.Add(100, 20, 400, 250);

    chartObject1.Chart.ChartWizard(this.Range["A1", "B3"],
        Excel.XlChartType.xl3DColumn, "New Chart");
    chartObject1.Name = "NewChartObject";

    Excel.ChartObject chartObject2 =
        (Excel.ChartObject)this.ChartObjects("NewChartObject");
    chartObject2.Chart.PrintPreview(false);
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

WorksheetBase Класс

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через