Objeto DataLabel (Word)DataLabel object (Word)

Representa o rótulo de dados em um ponto de gráfico ou linha de tendência.Represents the data label on a chart point or trendline.

ComentáriosRemarks

Em uma série, o objeto DataLabel é um membro da coleção DataLabels.On a series, the DataLabel object is a member of the DataLabels collection. A coleção DataLabels contém um objeto DataLabel para cada ponto.The DataLabels collection contains a DataLabel object for each point. 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.For a series without definable points (such as an area series), the DataLabels collection contains a single DataLabel object.

ExemploExample

Use DataLabels (index), onde index é o número de índice do rótulo de dados, para retornar um único objeto DataLabel .Use DataLabels (index), where index is the data label index number, to return a single DataLabel object. O exemplo a seguir define o formato de número para o quinto rótulo de dados na primeira série do primeiro gráfico do documento ativo.The following example sets the number format for the fifth data label in the first series of the first chart in the active document.

With ActiveDocument.InlineShapes(1) 
 If .HasChart Then 
 .Chart.SeriesCollection(1).DataLabels(5).NumberFormat = "0.000" 
 End If 
End With 

Use a propriedade Point.DataLabel para retornar o objeto DataLabel para um único ponto.Use the Point.DataLabel property to return the DataLabel object for a single point. O exemplo a seguir ativa o rótulo de dados para o segundo ponto na primeira série do primeiro gráfico do documento ativo e define o texto do rótulo de dados como "Saturday".The following example turns on the data label for the second point in the first series of the first chart in the active document and sets the data label text to "Saturday."

With ActiveDocument.InlineShapes(1) 
 If .HasChart Then 
 With .Chart.SeriesCollection(1).Points(2) 
 .HasDataLabel = True 
 .DataLabel.Text = "Saturday" 
 End With 
 End If 
End With 

Em uma linha de tendência, a propriedade Trendline.DataLabel retorna o texto mostrado com a linha de tendência.On a trendline, the Trendline.DataLabel property returns the text shown with the trendline. Esse texto pode ser a equação, o valor R-quadrado ou ambos (se ambos estiverem sendo mostrados).This can be the equation, the R-squared value, or both (if both are showing). O exemplo a seguir configura o texto da linha de tendência para a primeira linha de tendência da primeira série do primeiro gráfico do documento ativo para mostrar somente a equação.The following example sets the trendline text for the first trendline in the first series of the first chart in the active document to show only the equation.

With ActiveDocument.InlineShapes(1) 
 If .HasChart Then 
 With .Chart.SeriesCollection(1).Trendlines(1) 
 .DisplayRSquared = False 
 .DisplayEquation = True 
 End With 
 End If 
End With

Confira tambémSee also

Referência do modelo de objeto do WordWord Object Model Reference

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.