Objeto DataLabel (Excel)

Representa o rótulo de dados em um ponto de gráfico ou linha de tendência.

Comentários

Numa série, o objeto DataLabel é membro da coleção DataLabels . A coleção DataLabels contém um objeto DataLabel para cada ponto. Para uma série sem pontos definíveis (por exemplo, uma série de área), a coleção DataLabels contém um único objeto DataLabel.

Exemplo

Utilize DataLabels (índice), em que o índice é o número de índice da etiqueta de dados, para devolver um único objeto DataLabel . O exemplo a seguir define o formato do número para o quinto rótulo de dados na série um do gráfico incorporado um na planilha um.

Worksheets(1).ChartObjects(1).Chart _ 
 .SeriesCollection(1).DataLabels(5).NumberFormat = "0.000"

Utilize a propriedade DataLabel do objeto Ponto para devolver o objeto DataLabel para um único ponto. O exemplo seguinte ativa a etiqueta de dados para o segundo ponto da primeira série na folha de gráfico com o nome Gráfico1 e define o texto da etiqueta de dados para sábado.

With Charts("chart1") 
 With .SeriesCollection(1).Points(2) 
 .HasDataLabel = True 
 .DataLabel.Text = "Saturday" 
 End With 
End With

Numa linha de tendência, a propriedade DataLabel devolve o texto apresentado com a linha de tendência. Esse texto pode ser a equação, o valor R-quadrado ou ambos (se ambos estiverem sendo mostrados). O exemplo seguinte define o texto da linha de tendência para mostrar apenas a equação e, em seguida, coloca o texto da etiqueta de dados na célula A1 na folha de cálculo denominada Folha1.

With Charts("chart1").SeriesCollection(1).Trendlines(1) 
 .DisplayRSquared = False 
 .DisplayEquation = True 
 Worksheets("sheet1").Range("a1").Value = .DataLabel.Text 
End With

Métodos

• Delete
• Select

Propriedades

• Application
• AutoText
• Caption
• Characters
• Creator
• Formato
• Fórmula
• FormulaLocal
• FormulaR1C1
• FormulaR1C1Local
• Height
• HorizontalAlignment
• Left
• Name
• NumberFormat
• NumberFormatLinked
• NumberFormatLocal
• Orientation
• Parent
• Position
• ReadingOrder
• Separator
• Shadow
• ShowBubbleSize
• ShowCategoryName
• ShowLegendKey
• ShowPercentage
• ShowRange
• ShowSeriesName
• ShowValue
• Text
• Top
• VerticalAlignment
• Width

Confira também

• Referência do modelo de objeto do Excel

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.