Chart.ChartWizard - метод

Статья
08/11/2011

Изменяет свойства данного элемента управления Chart. Этот метод может использоваться для быстрого форматирования элемента управления Chart без необходимости устанавливать каждое свойство отдельно. Данный метод не является интерактивным и изменяет только указанные свойства.

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

Синтаксис

'Декларация
Sub ChartWizard ( _
    Source As Object, _
    Gallery As Object, _
    Format As Object, _
    PlotBy As Object, _
    CategoryLabels As Object, _
    SeriesLabels As Object, _
    HasLegend As Object, _
    Title As Object, _
    CategoryTitle As Object, _
    ValueTitle As Object, _
    ExtraTitle As Object _
)

void ChartWizard(
    Object Source,
    Object Gallery,
    Object Format,
    Object PlotBy,
    Object CategoryLabels,
    Object SeriesLabels,
    Object HasLegend,
    Object Title,
    Object CategoryTitle,
    Object ValueTitle,
    Object ExtraTitle
)

Параметры

Source
Тип: System.Object
Диапазон, содержащий источник данных для новой диаграммы.Если этот аргумент не указан, Microsoft Office Excel производит редактирование активного листа диаграммы или выделенного элемента управления Chart на активном рабочем листе.

Gallery
Тип: System.Object
XlChartType.Тип диаграммы.

Format
Тип: System.Object
Номер параметра для встроенных автоформатов.Может представлять собой число от 1 до 10 в зависимости от типа коллекции.Если этот аргумент не указан, Excel выбирает значение по умолчанию в соответствии с типом коллекции и источником данных.

PlotBy
Тип: System.Object
Определяет размещение данных для каждого ряда по столбцам или строкам.Может быть одной из следующих констант XlRowCol: xlRows или xlColumns.

CategoryLabels
Тип: System.Object
Целое число, определяющее количество строк или столбцов в исходном диапазоне, содержащем подписи категорий.Допустимые значения — от нуля (0) до максимального числа соответствующих категорий или рядов минус 1.

SeriesLabels
Тип: System.Object
Целое число, определяющее количество строк или столбцов в исходном диапазоне, содержащем подписи рядов.Допустимые значения — от нуля (0) до максимального числа соответствующих категорий или рядов минус 1.

HasLegend
Тип: System.Object
При значении true включается легенда.

Title
Тип: System.Object
Текст заголовка элемента управления Chart.

CategoryTitle
Тип: System.Object
Текст названия оси категорий.

ValueTitle
Тип: System.Object
Текст названия оси значений.

ExtraTitle
Тип: System.Object
Название оси рядов для объемных диаграмм или название второй оси значений для плоских диаграмм.

Заметки

Если параметр Source не указан, а выделенный объект не является внедренной диаграммой либо активный лист не является существующей диаграммой, при выполнении данного метода произойдет сбой и возникнет ошибка.

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

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

Примеры

В следующем примере кода метод ChartWizard используется для создания объемной гистограммы, в которой отображаются ряды данных в диапазоне ячеек от А1 до B5.

Private Sub Create3DColumnChart()
    Me.Range("A1", "A5").Value2 = 22
    Me.Range("B1", "B5").Value2 = 55

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

    Chart1.ChartWizard(Me.Range("A1", "B5"), _
        Excel.XlChartType.xl3DColumn, PlotBy:=Excel.XlRowCol.xlColumns)
End Sub

private void Create3DColumnChart()
{
    this.Range["A1", "A5"].Value2 = 22;
    this.Range["B1", "B5"].Value2 = 55;

    Microsoft.Office.Tools.Excel.Chart chart1 =
        this.Controls.AddChart(this.Range["D2", "H12"], 
        "chart1");

    chart1.ChartWizard(this.Range["A1", "B5"], 
        Excel.XlChartType.xl3DColumn, missing, 
        Excel.XlRowCol.xlColumns, missing, missing, missing,
        missing, missing, missing, missing);
}

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

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

См. также

Ссылки

Chart Интерфейс

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

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