Aspose.Slides FOSS
Python
Guia de Desenvolvedores
Características e capacidades

Características e capacidades

Características e capacidades

Aspose.Slides FOSS for Python provides a broad set of capabilities for working with PowerPoint .pptx Esta página lista todas as áreas de recursos suportadas com exemplos de código representativos.

Apresentação de I/O

Abrir um sistema existente . .pptx arquivo ou criar um novo, em seguida, salvar de volta para o formato PPTX.

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

# Open an existing presentation
with slides.Presentation("input.pptx") as prs:
    print(f"Slide count: {len(prs.slides)}")
    prs.save("output.pptx", SaveFormat.PPTX)

# Create a blank presentation from scratch (starts with one empty slide)
with slides.Presentation() as prs:
    prs.save("new.pptx", SaveFormat.PPTX)

Nota: O formato de armazenamento é o único suportado nesta edição do FOSS. A chamada de salva serializa a gráfica completa da apresentação para o contêiner OOXML.

Partes XML desconhecidas no arquivo de origem são preservadas literalmente em salvar, então abrir e re-salvar um .pptx Nunca vai tirar conteúdo que a biblioteca ainda não entende.

Gestão de diapositivas

Utilização: prs.slides para adicionar diapositivas vazias com: add_empty_slide(), remova os já existentes ou verifique a contagem total de slides:

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

with slides.Presentation() as prs:
    # Access the first slide
    slide = prs.slides[0]

    # Add an additional blank slide at the end
    prs.slides.add_empty_slide(prs.layout_slides[0])

    print(f"Total slides: {len(prs.slides)}")
    prs.save("multi-slide.pptx", SaveFormat.PPTX)

Formas de papel

Adicionar AutoShapes, PictureFrames e Connectors a um slide.

AutoShapes

Chama-me . slide.shapes.add_auto_shape() com um ShapeType, posição, e tamanho, então ligue para o telefone. add_text_frame() para definir o conteúdo do texto:

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

with slides.Presentation() as prs:
    slide = prs.slides[0]
    # Add a rectangle at (x=50, y=50) with width=300, height=100
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 300, 100)
    shape.add_text_frame("Aspose.Slides FOSS")
    prs.save("shapes.pptx", SaveFormat.PPTX)

Tabelas de dados

Utilização: slide.shapes.add_table() com largura de coluna e altura das linhas, em seguida acessar células via table.rows[row][col]:

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

with slides.Presentation() as prs:
    slide = prs.slides[0]
    # Column widths and row heights in points
    col_widths = [120.0, 120.0, 120.0]
    row_heights = [40.0, 40.0, 40.0]
    table = slide.shapes.add_table(50, 50, col_widths, row_heights)
    table.rows[0][0].text_frame.text = "Product"
    table.rows[0][1].text_frame.text = "Quantity"
    table.rows[0][2].text_frame.text = "Price"
    prs.save("table.pptx", SaveFormat.PPTX)

Conectores

Chama-me . slide.shapes.add_connector() e definido start_shape_connected_to e a) end_shape_connected_to para ligar duas formas com uma linha de ligação:

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

with slides.Presentation() as prs:
    slide = prs.slides[0]
    box1 = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 100, 150, 60)
    box2 = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 350, 100, 150, 60)
    conn = slide.shapes.add_connector(ShapeType.BENT_CONNECTOR3, 0, 0, 10, 10)
    conn.start_shape_connected_to = box1
    conn.start_shape_connection_site_index = 3  # right side
    conn.end_shape_connected_to = box2
    conn.end_shape_connection_site_index = 1    # left side
    prs.save("connector.pptx", SaveFormat.PPTX)

Formato de texto

Acessos portion_format em cada um dos seguintes: Portion para definir a altura da fonte, negrito, itálico e cor de preenchimento no nível do caractere:

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, NullableBool, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 500, 150)
    tf = shape.add_text_frame("Bold blue heading")

    fmt = tf.paragraphs[0].portions[0].portion_format
    fmt.font_height = 28
    fmt.font_bold = NullableBool.TRUE
    fmt.fill_format.fill_type = FillType.SOLID
    fmt.fill_format.solid_fill_color.color = Color.from_argb(255, 0, 70, 127)

    prs.save("text.pptx", SaveFormat.PPTX)

NullableBool.TRUE define explicitamente a propriedade; NullableBool.NOT_DEFINED herda do mestre de slides.

Tipos de preenchimento

Set (s) shape.fill_format.fill_type a) para o FillType.SOLID e configurar a cor de preenchimento via solid_fill_color.color Utilizando um valor ARGB:

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 300, 150)

    # Solid fill
    shape.fill_format.fill_type = FillType.SOLID
    shape.fill_format.solid_fill_color.color = Color.from_argb(255, 30, 120, 200)

    prs.save("fill.pptx", SaveFormat.PPTX)

Efeitos visuais

Aplique sombra externa, brilho, borda macia, desfoque, reflexão e sombra interna às formas.

As propriedades do efeito são acessíveis através de: shape.effect_format.- Está pronto . outer_shadow_effect, glow_effect, soft_edge_effect, blur_effect, reflection_effect, ou inner_shadow_effect para configurar cada um de forma independente.

3D Formatting

Aplicar 3D bevel, câmera, equipamento de iluminação, material e profundidade extrusão via shape.three_d_format.Este controla a profundidade visual e o modelo de iluminação para a reprodução de formas em visualizadores PPTX que suportam efeitos 3D.

Notas do orador

Acessos notes_slide_manager em qualquer diapositiva e chamada add_notes_slide() para criar uma página de notas, em seguida, definir o texto das notas diretamente:

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

with slides.Presentation() as prs:
    notes = prs.slides[0].notes_slide_manager.add_notes_slide()
    notes.notes_text_frame.text = "Key talking point: emphasize the ROI benefit."
    prs.save("notes.pptx", SaveFormat.PPTX)

Comentários

Criar um autor de comentários com: prs.comment_authors.add_author(),Então , liga-me . author.comments.add_comment() com as coordenadas de deslizamento e posição:

import aspose.slides_foss as slides
from aspose.slides_foss.drawing import PointF
from aspose.slides_foss.export import SaveFormat
from datetime import datetime

with slides.Presentation() as prs:
    author = prs.comment_authors.add_author("Jane Smith", "JS")
    slide = prs.slides[0]
    author.comments.add_comment(
        "Please verify this data before the presentation.",
        slide,
        PointF(2.0, 2.0),
        datetime.now()
    )
    prs.save("comments.pptx", SaveFormat.PPTX)

Imagens incorporadas

Incorporar uma imagem de um caminho de arquivo na apresentação e adicioná-la a um slide como um PictureFrame.

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

with slides.Presentation() as prs:
    with open("logo.png", "rb") as f:
        image_data = f.read()
    image = prs.images.add_image(image_data)
    slide = prs.slides[0]
    slide.shapes.add_picture_frame(
        slides.ShapeType.RECTANGLE, 50, 50, 200, 150, image
    )
    prs.save("with-image.pptx", SaveFormat.PPTX)

Propriedades do documento

Acessos prs.document_properties para ler ou escrever propriedades padrão, tais como título, autor e assunto, mais pares de valores personalizados:

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

with slides.Presentation() as prs:
    props = prs.document_properties

    # Core properties
    props.title = "Q1 Results"
    props.author = "Finance Team"
    props.subject = "Quarterly Review"
    props.keywords = "Q1, finance, results"

    # Custom property
    props.set_custom_property_value("ReviewedBy", "Legal Team")

    prs.save("deck.pptx", SaveFormat.PPTX)

Limitações conhecidas

As seguintes áreas de interesse social são: NotImplementedError e não estão disponíveis nesta edição:

Área de exploraçãoEstatuto da União Europeia
GráficosNão aplicada
SmartArtNão aplicada
Animações e transiçõesNão aplicada
Exportação de PDF / HTML / SVG / imagemNão implementado (apenas PPTX)
Macros VBANão aplicada
Assinaturas digitaisNão aplicada
Hiperligações e configurações de açãoNão aplicada
Objetos OLENão aplicada
Texto matemáticoNão aplicada

Ver também:

 Português