Chart.Name (Propiedad)
Obtiene el nombre del control Chart.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)
Sintaxis
'Declaración
ReadOnly Property Name As String
Get
string Name { get; }
Valor de propiedad
Tipo: System.String
Nombre del control Chart.
Comentarios
Al crear un control Chart, Excel establece la propiedad Name en la cadena "sheetname Chart n", donde n es el número de gráficos incrustados en la hoja de cálculo. Por ejemplo, si agrega Chart a Hoja1 y es el primer gráfico incrustado en la hoja de cálculo, la propiedad Name tendrá el valor Hoja1 Gráfico 1.
Aunque la propiedad Name es de solo lectura, puede modificar una parte del nombre usando la propiedad Name del Microsoft.Office.Interop.Excel.ChartObject primario. El nuevo nombre que se especifica reemplaza la subcadena "Gráfico n" en la cadena devuelta por la propiedad Name. Por ejemplo, el código siguiente cambia el valor de propiedad Name de un control Chart de Hoja1 Gráfico 1 a Hoja1 GráficoVentas.
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);
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.