Compartilhar via


Objeto LegendEntry (PowerPoint)

Representa uma entrada de legenda em uma legenda de gráfico.

Comentários

O objeto LegendEntry é um membro da coleção LegendEntries. A coleção LegendEntries contém todos os objetos LegendEntry na legenda.

Cada entrada de legenda possui duas partes:

  • O texto da entrada, que é o nome da série ou a linha de tendência associada à entrada da legenda.

  • O marcador de entrada, que liga visualmente a entrada de legenda com a série associada ou a linha de tendência do gráfico.

As propriedades de formatação do marcador de entrada e sua linha de tendência ou série associada estão contidas no objeto LegendKey.

O texto de uma entrada de legenda não pode ser alterado. Os objetos LegendEntry suportam a formatação de fonte e podem ser excluídos. Nenhuma formatação de padrão é suportado para entradas de legenda. A posição e o tamanho das entradas é fixo.

Não há uma maneira direta de retornar a série ou a linha de tendência correspondente à entrada de legenda.

Após tem sido excluídas entradas de legenda, a única maneira de restaurá-los é remover e recriar a legenda que as continha definindo a propriedade HasLegend do gráfico como False e volta para True.

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.

Use LegendEntries (index), em que index é o número de índice de entrada da legenda, para retornar um único objeto LegendEntry . Você não pode retornar entradas de legenda por nome.

O número de índice representa a posição da entrada de legenda na legenda. LegendEntries(1) fica no início da legenda e LegendEntries(LegendEntries.Count) na parte inferior. O exemplo a seguir altera a fonte do texto da entrada de legenda no início da legenda (geralmente, a legenda da primeira série) do primeiro gráfico do documento ativo.

With ActiveDocument.InlineShapes(1)

    If .HasChart Then

        .Chart.Legend.LegendEntries(1).Font.Italic = True

    End If

End With

Confira também

Referência de modelo de objeto do PowerPoint

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.