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 之圖表類型的第十個配置。 此外，此範例還會使用 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 命名空間