Chart.ApplyLayout - метод

Статья
05/19/2013

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

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

Синтаксис

'Декларация
Sub ApplyLayout ( _
    Layout As Integer, _
    ChartType As Object _
)

void ApplyLayout(
    int Layout,
    Object ChartType
)

Параметры

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

ChartType
Тип: System.Object
Одно из значений Microsoft.Office.Interop.Excel.XlChartType.

Заметки

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

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

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

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

Примеры

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

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

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);
}

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

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

См. также

Ссылки

Chart Интерфейс

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

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