Propriedade Chart.Name

Artigo
05/21/2013

Obtém o nome do controle de Chart .

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
ReadOnly Property Name As String

string Name { get; }

Valor de propriedade

Tipo: System.String
O nome do controle de Chart .

Comentários

Quando você cria um controle de Chart Excel, defina a propriedade de Name a cadeia de caracteres de “gráfico emsheetname ” em , onde é o número de elementos gráficos inseridos na planilha.Por exemplo, se você adicionar Chart a Sheet1 e é o primeiro elemento gráfico inserido na planilha, a propriedade de Name terá o valor Sheet1 gráfico 1.

Embora a propriedade de Name é somente leitura, você pode alterar uma parte do nome usando a propriedade de Name de Microsoft.Office.Interop.Excel.ChartObjectpai.O novo nome que você especificar o “substitui a última subsequência de caracteres de emgráfico” na cadeia de caracteres retornada pela propriedade de Name .Por exemplo, o código a seguir altera o valor da propriedade de Name de um controle de Chart de Sheet1 gráfico 1 a 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);
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

Chart Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via