Personalizar Legendas de Gráficos em Apresentações com Python

Visão geral

Aspose.Slides for Python fornece controle total sobre legendas de gráficos, permitindo que você torne os rótulos de dados claros e prontos para apresentação. Você pode mostrar ou ocultar a legenda, escolher sua posição no slide e ajustar o layout para evitar sobreposição com a área de plotagem. A API permite estilizar texto e marcadores, refinar o preenchimento e o plano de fundo, e formatar bordas e preenchimentos para combinar com o seu tema. Os desenvolvedores também podem acessar legendas individuais para renomear ou filtrar, garantindo que apenas as séries mais relevantes sejam exibidas. Com esses recursos, seus gráficos permanecem legíveis, consistentes e alinhados com os padrões de design da apresentação.

Posicionamento da Legenda

Usando Aspose.Slides, você pode controlar rapidamente onde a legenda do gráfico aparece e como ela se ajusta ao layout do slide. Aprenda a posicionar a legenda com precisão.

  1. Crie uma instância da classe Presentation.
  2. Obtenha uma referência ao slide.
  3. Adicione um gráfico ao slide.
  4. Defina as propriedades da legenda.
  5. Salve a apresentação como um arquivo PPTX.

No exemplo abaixo, definimos a posição e o tamanho da legenda do gráfico:

import aspose.slides.charts as charts
import aspose.slides as slides

# Crie uma instância da classe Presentation.
with slides.Presentation() as presentation:

    # Obtenha uma referência ao slide.
    slide = presentation.slides[0]

    # Adicione um gráfico de colunas agrupadas ao slide.
    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 50, 50, 600, 300)

    # Defina as propriedades da legenda.
    chart.legend.x = 80 / chart.width
    chart.legend.y = 20 / chart.height
    chart.legend.width = 100 / chart.width
    chart.legend.height = 100 / chart.height

    # Salve a apresentação no disco.
    presentation.save("legend_positioning.pptx", slides.export.SaveFormat.PPTX)

Definir o Tamanho da Fonte da Legenda

A legenda de um gráfico deve ser tão legível quanto os dados que explica. Esta seção mostra como ajustar o tamanho da fonte da legenda para combinar com a tipografia da sua apresentação e melhorar a acessibilidade.

  1. Instancie a classe Presentation.
  2. Crie um gráfico.
  3. Defina o tamanho da fonte.
  4. Salve a apresentação no disco.
import aspose.slides.charts as charts
import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 50, 50, 600, 400)
    chart.legend.text_format.portion_format.font_height = 20

    presentation.save("font_size.pptx", slides.export.SaveFormat.PPTX)

Definir o Tamanho da Fonte para uma Entrada de Legenda

Aspose.Slides permite aprimorar a aparência das legendas de gráficos formatando entradas individuais. O exemplo abaixo mostra como focalizar um item específico da legenda e definir suas propriedades sem alterar o restante da legenda.

  1. Instancie a classe Presentation.
  2. Crie um gráfico.
  3. Acesse uma entrada de legenda.
  4. Defina as propriedades da entrada.
  5. Salve a apresentação no disco.
import aspose.slides.charts as charts
import aspose.slides as slides
import aspose.pydrawing as draw

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 50, 50, 600, 400)
    text_format = chart.legend.entries[1].text_format

    text_format.portion_format.font_bold = slides.NullableBool.TRUE
    text_format.portion_format.font_height = 20
    text_format.portion_format.font_italic = slides.NullableBool.TRUE
    text_format.portion_format.fill_format.fill_type = slides.FillType.SOLID
    text_format.portion_format.fill_format.solid_fill_color.color = draw.Color.blue

    presentation.save("legend_entry.pptx", slides.export.SaveFormat.PPTX)

Perguntas Frequentes

Posso ativar a legenda para que o gráfico aloque espaço automaticamente em vez de sobrepor a área de plotagem?

Sim. Use o modo sem sobreposição (overlay = false); neste caso, a área de plotagem será reduzida para acomodar a legenda.

Posso criar rótulos de legenda com várias linhas?

Sim. Rótulos longos quebram automaticamente quando o espaço é insuficiente; quebras de linha forçadas são suportadas por meio de caracteres de nova linha no nome da série.

Como faço a legenda seguir o esquema de cores do tema da apresentação?

Não defina cores/preenchimentos/fontes explícitos para a legenda ou seu texto. Eles herdarão do tema e serão atualizados corretamente quando o design mudar.