Método Chart.ApplyDataLabels (PowerPoint)

Artigo
04/07/2023

Aplica rótulos de dados a todas as séries em um gráfico.

Sintaxe

expressão. ApplyDataLabels (Type, LegendKey, AutoText, HasLeaderLines, ShowSeriesName, ShowCategoryName, ShowValue, ShowPercentage, ShowBubbleSize, Separator)

expressão Uma variável que representa um objeto Chart.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Type	Opcional	XlDataLabelsType	Um dos valores de enumeração que especifica o tipo de rótulo de dados que será aplicado. Pode ser uma das constantes xlDataLabelsType .
LegendKey	Opcional	Variante	True para mostrar o código da legenda ao lado do ponto. O padrão é False.
AutoText	Opcional	Variante	True se o objeto gerar automaticamente o texto adequado com base no conteúdo.
HasLeaderLines	Opcional	Variante	Para os objetos Chart e Series, True se a série tiver linhas tracejadas.
ShowSeriesName	Opcional	Variante	True para habilitar o nome da série do rótulo de dados; Caso contrário, False.
ShowCategoryName	Opcional	Variante	True para habilitar o nome da categoria do rótulo de dados; Caso contrário, False.
ShowValue	Opcional	Variante	True para habilitar o valor para o rótulo de dados; Caso contrário, False.
ShowPercentage	Opcional	Variante	True para habilitar a porcentagem para o rótulo de dados; Caso contrário, False.
ShowBubbleSize	Opcional	Variante	True para habilitar o tamanho da bolha para o rótulo de dados; Caso contrário, False.
Separator	Opcional	Variante	O separador para o rótulo de dados.

Exemplo

Observação

[!OBSERVAçãO] Embora o código a seguir se aplique ao Microsoft Word, você poderá modificá-lo para se aplicar ao PowerPoint.

O exemplo a seguir aplica rótulos de categoria à primeira série do primeiro gráfico do documento ativo.

With ActiveDocument.InlineShapes(1)
    If .HasChart Then
        .Chart.SeriesCollection(1). _
            ApplyDataLabels Type:=xlDataLabelsShowLabel
    End If
End With

Observação

[!OBSERVAçãO] Se você usar uma cadeia de caracteres para o parâmetro separador, você receberá uma cadeia de caracteres como o separador. Se você usar xlDataLabelSeparatorDefault (= 1), obterá o separador de rótulo de dados padrão, que é uma vírgula ou uma nova linha, dependendo do rótulo de dados. Quando um valor de 1 é retornado, ele indica que o usuário não alterou o separador padrão, que é uma vírgula (,). Você também pode passar um valor de 1 para alterar o separador de volta para o separador padrão. Primeiro, o gráfico deve estar ativo antes que você possa acessar os rótulos de dados de forma programática; caso contrário, ocorrerá um erro em tempo de execução.

Confira também

Objeto Chart

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.

Compartilhar via