Método Series.DataLabels (Excel)Series.DataLabels method (Excel)

Retorna um objeto que representa um único rótulo de dados (um objeto DataLabel ) ou uma coleção de todos os rótulos de dados da série (uma coleção DataLabels ).Returns an object that represents either a single data label (a DataLabel object) or a collection of all the data labels for the series (a DataLabels collection).

SintaxeSyntax

expression.expression. DataLabels( _Index_ )

expressão Uma variável que representa um objeto Series .expression A variable that represents a Series object.

ParâmetrosParameters

NomeName Obrigatório/OpcionalRequired/Optional Tipo de dadosData type DescriçãoDescription
IndexIndex OpcionalOptional VariantVariant O número do rótulo de dados.The number of the data label.

Valor de retornoReturn value

ObjetoObject

ComentáriosRemarks

Se a série tiver a opção de Mostrar valor ativada para os rótulos de dados, a coleção retornada pode conter até um rótulo para cada ponto.If the series has the Show Value option turned on for the data labels, the returned collection can contain up to one label for each point. Os rótulos de dados podem ser ativados ou desativados para pontos individuais na série.Data labels can be turned on or off for individual points in the series.

Se a série estiver em um gráfico de área e tiver a opção Mostrar rótulo ativada para os rótulos de dados, a coleção retornada contém um único rótulo, que é o rótulo da série de área.If the series is on an area chart and has the Show Label option turned on for the data labels, the returned collection contains only a single label, which is the label for the area series.

ExemploExample

Este exemplo define os rótulos de dados para a série um em Chart1 para mostrar seu códigos, assumindo que seus valores estejam visíveis quando o exemplo for executado.This example sets the data labels for series one in Chart1 to show their key, assuming that their values are visible when the example runs.

With Charts("Chart1").SeriesCollection(1) 
 .HasDataLabels = True 
 With .DataLabels 
 .ShowLegendKey = True 
 .Type = xlValue 
 End With 
End With

Confira tambémSee also

Objeto SeriesSeries Object