Compartilhar via


Método Chart.ApplyDataLabels (PowerPoint)

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.