ChartSheetBase.ApplyLayout メソッド
指定されたレイアウトをグラフに適用します。
名前空間: Microsoft.Office.Tools.Excel
アセンブリ: Microsoft.Office.Tools.Excel.v4.0.Utilities (Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 内)
構文
'宣言
Public Sub ApplyLayout ( _
layout As Integer, _
chartType As Object _
)
public 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 という名前の 2-D 集合縦棒グラフが含まれている必要があります。
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 セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。