ChartSheetBase.ApplyLayout(Int32, Object) 方法

  • 参考

定义

命名空间:
Microsoft.Office.Tools.Excel
程序集:
Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

将指定的布局应用于图表。

public void ApplyLayout (int layout, object chartType);

参数

layout
Int32

1 到 10 之间的一个整数，用于指定要应用于图表的布局的类型。

chartType
Object

XlChartType 值之一。

示例

下面的代码示例应用了第10个布局，该布局可用于图表工作表中的图表类型 Chart1 。 此外，该示例使用 SetElement 方法来应用进一步的布局更改：将图表标题的样式设置为居中，并位于图表网格区域内，为水平轴添加标题，并为垂直轴添加旋转的标题。 若要运行此代码示例，工作簿必须包含一个名为的聚集柱形二维图表工作表 Chart1 。

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

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

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

    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

注解

参数的值 Layout 对应于功能区上 "设计" 选项卡上 "图表布局" 组中的可用选项。 选择图表时，"设计" 选项卡可用。

每种图表类型都有自己的一组布局选项。 例如，饼图的布局选项不同于柱形图的布局选项。 如果要从不同的图表类型应用布局，可以使用 ChartType 参数来指定 Layout 参数将引用的图表类型。 例如，如果您有一个柱形图，并且想要从折线图应用布局，请将 Microsoft.Office.Interop.Excel.XlChartType.xlLine 值传递给该 ChartType 参数。 布局仅添加可用于该特定图表类型的图表元素。

可选参数

有关可选参数的信息，请参阅Office 解决方案中的可选参数。

适用于