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 的整數,可以指定要套用至圖表的配置類型。
- ChartType
型別:System.Object
其中一個 Microsoft.Office.Interop.Excel.XlChartType 值。
備註
Layout 參數的值會對應至功能區 [設計] 索引標籤上之 [圖表版面配置] 群組中的可用選項。 當您選取圖示時,[設計] 索引標籤就可以使用。
每個類型的圖表都有自己的配置選項。 例如,圓形圖的配置選項會和直條圖的配置選項不一樣。 如果您想要套用不同圖表類型中的配置,您可以使用 ChartType 參數來指定 Layout 參數要參考的圖表類型。 例如,如果您有直條圖,而想要套用折線圖中的配置,請將 XlChartType.xlLine 值傳遞給 ChartType 參數。 配置只會將特定圖表類型適用的圖表項目加入。
選擇性參數
如需選擇性參數的詳細資訊,請參閱Office 方案中的選擇性參數。
範例
下列程式碼範例會套用可用於 Chart_1 圖表之圖表類型的第十個配置。 此外,此範例還會使用 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 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。