Guia do Desenvolvedor

Este guia cobre as principais capacidades do Aspose.Slides FOSS para Python com exemplos de código executáveis para cada área de funcionalidade.

Nesta Seção

PageDescription
Recursos e CapacidadesLista completa de recursos suportados: slides, formas, texto, preenchimento, efeitos, formatação 3D, anotações, comentários, imagens e propriedades do documento.
Trabalhando com ImagensIncorpore imagens nos slides como quadros de imagem a partir de arquivo ou bytes; controle o modo de preenchimento (esticar, ladrilho).
Trabalhando com ConectoresAdicione conectores curvos, em cotovelo e retos entre formas; defina pontos de conexão e estilo de linha.
Trabalhando com Efeitos 3DAplique sombra externa, brilho, desfoque, chanfrado, predefinições de câmera, rigs de luz e materiais às formas.
Trabalhando com ComentáriosAdicione comentários de revisão em thread e notas do apresentador; gerencie autores de comentários; leia anotações.

Ponto de Entrada da API

Cada operação começa com um objeto Presentation. Sempre use‑o como um gerenciador de contexto:

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

# Open existing
with slides.Presentation("input.pptx") as prs:
    # work with prs
    prs.save("output.pptx", SaveFormat.PPTX)

# Create new
with slides.Presentation() as prs:
    # work with prs
    prs.save("new.pptx", SaveFormat.PPTX)

O gerenciador de contexto garante que os recursos internos COM/XML sejam liberados quando o bloco é encerrado. Não armazene uma referência Presentation fora do bloco with.

Formato de Saída Suportado

O único formato de salvamento suportado é PPTX (SaveFormat.PPTX). Exportar para PDF, HTML, SVG ou formatos de imagem não está disponível nesta edição.

Classes Principais

Classe / EnumCaminho de ImportaçãoDescrição
Presentationaspose.slides_fossContêiner raiz; use como gerenciador de contexto
ShapeTypeaspose.slides_fossEnum para tipos de forma (RECTANGLE, ELLIPSE, …)
FillTypeaspose.slides_fossEnum para tipos de preenchimento (SOLID, GRADIENT, …)
NullableBoolaspose.slides_fossBool de três estados para formatação (TRUE, FALSE, NOT_DEFINED)
SaveFormataspose.slides_foss.exportEnum de formato de saída (apenas PPTX suportado)
Coloraspose.slides_foss.drawingConstrutor de cor ARGB
PointFaspose.slides_foss.drawingPonto 2D float (usado para posições de comentários)

Limitações Conhecidas

As áreas a seguir geram NotImplementedError nesta edição:

  • Charts: sem criação ou modificação de gráficos
  • SmartArt: não suportado
  • Animations and transitions: transições de slides e animações de objetos não podem ser definidas
  • Export formats: apenas salvamento em PPTX é suportado; sem exportação para PDF, HTML, SVG ou imagem
  • Hyperlinks and action settings: objetos de link não são modificáveis
  • VBA macros and digital signatures: não acessível

Partes XML desconhecidas encontradas durante o carregamento são preservadas literalmente ao salvar, de modo que o round-tripping nunca remove conteúdo que a biblioteca ainda não entende.

Veja também

 Português