ChartSheet.ApplyLayout Метод (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Применяет заданный макет к диаграмме.

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

Синтаксис

'Декларация
Public Sub ApplyLayout ( _
    Layout As Integer, _
    ChartType As Object _
)
'Применение
Dim instance As ChartSheet
Dim Layout As Integer
Dim ChartType As Object

instance.ApplyLayout(Layout, ChartType)

public 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.

Примеры

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

Private Sub DesignChartSheet()
    Dim myChartSheet As Microsoft.Office.Tools.Excel.ChartSheet = _
        Globals.Chart1

    myChartSheet.ApplyLayout(10)

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

private void DesignChartSheet()
{
    Microsoft.Office.Tools.Excel.ChartSheet myChartSheet  =
        Globals.Chart1;

    myChartSheet.ApplyLayout(10, myChartSheet.ChartType);

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

Разрешения

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

См. также

Ссылки

ChartSheet Класс

ChartSheet - члены

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

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