Guia do Desenvolvedor
Este guia cobre as principais capacidades do Aspose.Slides FOSS para Java com exemplos de código executáveis para cada área de funcionalidade.
Nesta Seção
| Page | Description |
|---|---|
| Recursos e Capacidades | Lista completa de recursos suportados: slides, formas, texto, preenchimento, efeitos, formatação 3D, notas, comentários, imagens e propriedades do documento. |
| Trabalhando com Imagens | Incorpore imagens em slides como quadros de imagem a partir de arquivo ou bytes; controle o modo de preenchimento (esticar, ladrilho). |
| Trabalhando com Conectores | Adicione conectores curvos, em cotovelo e retos entre formas; defina pontos de conexão e estilo de linha. |
| Trabalhando com Efeitos 3D | Aplique sombra externa, brilho, desfoque, chanfrado, predefinições de câmera, rigs de luz e materiais às formas. |
| Trabalhando com Comentários | Adicione comentários de revisão em thread e notas de falante; 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 dentro de um bloco try‑with‑resources:
import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.export.SaveFormat;
// Open existing
try (Presentation prs = new Presentation("input.pptx")) {
// work with prs
prs.save("output.pptx", SaveFormat.PPTX);
}
// Create new
try (Presentation prs = new Presentation()) {
// work with prs
prs.save("new.pptx", SaveFormat.PPTX);
}O bloco try-with-resources garante que os recursos XML internos sejam liberados quando o bloco é encerrado. Não armazene uma referência Presentation fora do bloco try.
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
| Class / Enum | Package | Description |
|---|---|---|
Presentation | org.aspose.slides.foss | Contêiner raiz; use em try-with-resources |
ShapeType | org.aspose.slides.foss | Enum para tipos de forma (RECTANGLE, ELLIPSE, …) |
FillType | org.aspose.slides.foss | Enum para tipos de preenchimento (SOLID, GRADIENT, …) |
NullableBool | org.aspose.slides.foss | Bool de três estados para formatação (TRUE, FALSE, NOT_DEFINED) |
SaveFormat | org.aspose.slides.foss.export | Enum de formato de saída (apenas PPTX suportado) |
Color | org.aspose.slides.foss.drawing | Construtor de cor ARGB |
PointF | org.aspose.slides.foss.drawing | Ponto 2D em float (usado para posições de comentários) |
Limitações Conhecidas
As áreas a seguir levantam UnsupportedOperationException 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
- Introdução: Instalação e primeiro programa
- Referência da API: Referência de classes e métodos
- Guias Práticos: Artigos práticos orientados por tarefas