Chart.ApplyLayout(Int32, Object) Метод

Ссылка

Определение

Пространство имен:: Microsoft.Office.Tools.Excel

Сборка:: Microsoft.Office.Tools.Excel.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Применение макетов, приведенных на ленте.

public void ApplyLayout (int Layout, object ChartType);

abstract member ApplyLayout : int * obj -> unit

Public Sub ApplyLayout (Layout As Integer, Optional ChartType As Object)

Параметры

Layout: Int32

Целое число от 1 до 10, определяющее тип макета, применяемого к диаграмме.

ChartType: Object

Одно из значений перечисления XlChartType.

Примеры

В следующем примере кода применяется десятый макет, доступный для типа диаграммы Chart_1 . Кроме того, в примере используется SetElement метод для применения дальнейших изменений макета: установка стиля заголовка диаграммы, который должен быть центрирован и расположен внутри области сетки диаграммы, добавление заголовка для горизонтальной оси и добавление повернутого заголовка для вертикальной оси. Чтобы выполнить этот пример кода, необходимо добавить двумерную диаграмму с кластеризованным столбцом с именем Chart_1 на лист Sheet1по умолчанию .

private void DesignChart()
{
    Microsoft.Office.Tools.Excel.Chart myChart =
        Globals.Sheet1.Chart_1;

    myChart.ApplyLayout(10, myChart.ChartType);

    myChart.SetElement(
        Microsoft.Office.Core.MsoChartElementType.
        msoElementChartTitleCenteredOverlay);
    myChart.SetElement(
        Microsoft.Office.Core.MsoChartElementType.
        msoElementPrimaryCategoryAxisTitleHorizontal);
    myChart.SetElement(
        Microsoft.Office.Core.MsoChartElementType.
        msoElementPrimaryValueAxisTitleRotated);
}

Private Sub DesignChart()
    Dim myChart As Microsoft.Office.Tools.Excel.Chart = _
        Globals.Sheet1.Chart_1

    myChart.ApplyLayout(10)

    myChart.SetElement(Microsoft.Office.Core.MsoChartElementType. _
                       msoElementChartTitleCenteredOverlay)
    myChart.SetElement(Microsoft.Office.Core.MsoChartElementType. _
                       msoElementPrimaryCategoryAxisTitleHorizontal)
    myChart.SetElement(Microsoft.Office.Core.MsoChartElementType. _
                       msoElementPrimaryValueAxisTitleRotated)
End Sub

Значения Layout параметра соответствуют параметрам, доступным в группе Макеты диаграммы на вкладке Конструктор на ленте. Вкладка Конструктор доступна при выборе диаграммы.

Каждый тип диаграммы имеет собственный набор параметров макета. Например, параметры макета круговой диаграммы отличаются от параметров макета гистограммы. Если вы хотите применить макет диаграммы другого типа, можно использовать ChartType параметр , чтобы указать тип диаграммы, на который Layout будет ссылаться параметр. Например, если у вас есть гистограмма и вы хотите применить макет из графика, передайте Microsoft.Office.Interop.Excel.XlChartType.xlLine значение в ChartType параметр . Макет добавляет только элементы диаграммы, доступные для конкретного типа диаграммы.

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

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

Применяется к

Share via