Chart.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 解决方案中的可选参数

示例

下面的代码示例应用可供 Chart_1 图表的图表类型使用的第 10 个布局。 此外,该示例还使用 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 命名空间