Chart.ApplyLayout(Int32, Object) 方法

定義

命名空間:

Microsoft.Office.Tools.Excel

組件:

Microsoft.Office.Tools.Excel.dll

套用顯示在功能區上的配置。

public void ApplyLayout (int Layout, object ChartType);

abstract member ApplyLayout : int * obj -> unit

Public Sub ApplyLayout (Layout As Integer, Optional ChartType As Object)

參數

Layout

Int32

1 到 10 的整數，可以指定要套用至圖表的配置類型。

ChartType

Object

其中一個 XlChartType 值。

範例

下列程式代碼範例會套用圖表圖表類型 Chart_1 可用的第十個版面配置。 此外，此範例會使用 SetElement 方法來套用進一步的版面配置變更：將圖表標題的樣式設定為置中，並置於圖表網格線區域內、新增水準軸的標題，以及新增垂直軸的旋轉標題。 若要執行此程式碼範例，您必須將具有名稱 Chart_1 的叢集資料行二維圖表新增至預設工作表 Sheet1。

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

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

備註

參數的值Layout會對應至功能區 [設計] 索引標籤上 [圖表版面配置] 群組上的可用選項。 當您選取圖表時，可以使用 [ 設計 ] 索引標籤。

每種圖表類型都有自己的一組版面配置選項。 例如，餅圖的配置選項與柱形圖的配置選項不同。 如果您想要從不同的圖表類型套用版面配置，您可以使用 ChartType 參數來指定參數將參考的 Layout 圖表類型。 例如，如果您有柱形圖，而且想要從折線圖套用版面配置，請將 Microsoft.Office.Interop.Excel.XlChartType.xlLine 值傳遞至 ChartType 參數。 版面配置只會新增可用於該特定圖表類型的圖表元素。

選擇性參數

如需選擇性參數的相關信息，請參閱 Office 方案中的選擇性參數。