ChartSheet.ApplyLayout 方法
將指定的配置套用至圖表。
命名空間: Microsoft.Office.Tools.Excel
組件: Microsoft.Office.Tools.Excel.v4.0.Utilities (在 Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 中)
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 之圖表類型的第十個配置。此外,此範例還會使用 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 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。