Chart.Name プロパティ
Chart コントロールの名前を取得します。
名前空間: Microsoft.Office.Tools.Excel
アセンブリ: Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll 内)
構文
'宣言
ReadOnly Property Name As String
string Name { get; }
プロパティ値
型 : System.String
Chart コントロールの名前を返します。
解説
Chart コントロールを作成すると、Excel は Name プロパティを sheetname Chart n" と言う文字列に設定します (n はワークシート上の埋め込みグラフの数)。たとえば、Chart を Sheet1 に追加し、それがワークシートの最初の埋め込みグラフの場合は、Name プロパティの値は Sheet1 グラフ 1 になります。
Name プロパティは読み取り専用ですが、親 Microsoft.Office.Interop.Excel.ChartObject の Name プロパティを使用して名前の一部を変更することができます。指定した新しい名前で、Name プロパティによって返される文字列の "Chart n" 部分が置き換わります。たとえば、次のコードは、Chart コントロールのName プロパティ値を Sheet1 グラフ 1 から Sheet1 SalesChart に変更します。
Private Sub RenameChart()
' Set some test data and create a new Chart.
Globals.Sheet1.Range("A1", "A5").Value2 = 22
Globals.Sheet1.Range("B1", "B5").Value2 = 55
Dim Chart1 As Microsoft.Office.Tools.Excel.Chart = _
Globals.Sheet1.Controls.AddChart(Globals.Sheet1.Range("D2", "H12"), _
"renameChartExample")
Chart1.SetSourceData(Me.Range("A1", "B5"), Excel.XlRowCol.xlColumns)
Chart1.ChartType = Excel.XlChartType.xl3DColumn
' Displays "Sheet1 Chart 1".
MessageBox.Show("The default chart name is: " & Chart1.Name)
' Set the name of the parent ChartObject of this embedded Chart.
Dim ChartObjectParent As Excel.ChartObject = TryCast(Chart1.Parent, Excel.ChartObject)
ChartObjectParent.Name = "SalesChart"
' Displays "Sheet1 SalesChart".
MessageBox.Show("The default chart name is: " & Chart1.Name)
End Sub
private void RenameChart()
{
// Set some test data and create a new Chart.
Globals.Sheet1.Range["A1", "A5"].Value2 = 22;
Globals.Sheet1.Range["B1", "B5"].Value2 = 55;
Microsoft.Office.Tools.Excel.Chart chart1 = Globals.Sheet1.Controls.AddChart(
Globals.Sheet1.Range["D2", "H12"], "renameChartExample");
chart1.SetSourceData(Globals.Sheet1.Range["A1", "B5"], Excel.XlRowCol.xlColumns);
chart1.ChartType = Excel.XlChartType.xl3DColumn;
// This message box displays "Sheet1 Chart 1".
MessageBox.Show("The default chart name is: " + chart1.Name);
// Set the name of the parent ChartObject of this embedded Chart.
Excel.ChartObject chartObjectParent = chart1.Parent as Excel.ChartObject;
chartObjectParent.Name = "SalesChart";
// This message box displays "Sheet1 SalesChart".
MessageBox.Show("The new chart name is: " + chart1.Name);
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。