Objeto LegendEntry (Excel)

  • Artigo

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 associada à entrada de legenda, e um marcador de entrada, que vincula visualmente a entrada de legenda à sua série ou linha de tendência associada no gráfico. As propriedades de formatação para o marcador de entrada e sua série ou linha de tendência associadas 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á nenhuma maneira direta de retornar a série ou a linha de tendência correspondente à entrada da legenda.

Depois que as entradas de legenda tiverem sido excluídas, a única maneira de restaurá-las é remover e recriar a legenda que as continha definindo a propriedade HasLegend para o gráfico como False e, em seguida, voltar para True.

Exemplo

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 na parte superior da legenda (geralmente é a legenda da primeira série) no gráfico inserido um na planilha chamada Sheet1.

Worksheets("sheet1").ChartObjects(1).Chart _ 
 .Legend.LegendEntries(1).Font.Italic = True

Métodos

Propriedades

Confira também

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.