ChartSheet.ApplyLayout 方法

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

命名空间:  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 之间的一个整数,用于指定要应用于图表的布局的类型。

备注

Layout 参数的值对应于功能区上的**“设计”选项卡上“图表布局”**组中的选项。 **“设计”**选项卡在选择图表后可用。

每种图表类型各有一组布局选项。 例如,饼图的布局选项与柱形图的布局选项不同。 如果想应用另一种图表类型的布局,可以使用 ChartType 参数指定 Layout 参数将引用的图表类型。 例如,如果您有一个柱形图,但是想应用折线图的布局,可以将 XlChartType.xlLine 值传递给 ChartType 参数。 布局将只添加对于该特定图表类型可用的图表元素。

可选参数

有关可选参数的信息,请参见Office 解决方案中的可选参数

示例

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

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

.NET Framework 安全性

请参见

参考

ChartSheet 接口

Microsoft.Office.Tools.Excel 命名空间