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 之间的一个整数,用于指定要应用于图表的布局的类型。
- ChartType
类型:System.Object
Microsoft.Office.Interop.Excel.XlChartType 值之一。
备注
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 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。