PythonでPowerPointに図形を追加する方法

Aspose.Slides FOSS for Python は、AutoShapes、Tables、Connectors、PictureFrames をプレゼンテーションスライドに追加することをサポートします。すべてのシェイプタイプは slide.shapes コレクションを通じて追加されます。

ステップバイステップガイド

ステップ 1: パッケージをインストールする

pip install aspose-slides-foss

インストールを確認する:

import aspose.slides_foss as slides
print("Ready")

ステップ 2: プレゼンテーションを作成する

常にPresentationをコンテキストマネージャとして使用してください。

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

with slides.Presentation() as prs:
    slide = prs.slides[0]
    # ... add shapes ...
    prs.save("output.pptx", SaveFormat.PPTX)

ステップ 3: AutoShape を追加

slide.shapes.add_auto_shape(shape_type, x, y, width, height) は、指定された位置とサイズ（すべてポイント単位）に形状を配置します。ShapeType 定数を使用して形状を選択してください。

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]

    # Rectangle
    rect = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 300, 100)
    rect.add_text_frame("Rectangle shape")

    # Ellipse
    ellipse = slide.shapes.add_auto_shape(ShapeType.ELLIPSE, 400, 50, 200, 100)
    ellipse.add_text_frame("Ellipse shape")

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

ステップ 4: テーブルを追加

slide.shapes.add_table(x, y, col_widths, row_heights) は指定された位置にテーブルを作成します。列幅と行高さはポイント値のリストです。

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

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

    col_widths = [150.0, 150.0, 150.0]
    row_heights = [40.0, 40.0, 40.0]
    table = slide.shapes.add_table(50, 200, col_widths, row_heights)

    # Set header row text
    headers = ["Product", "Units", "Revenue"]
    for col, text in enumerate(headers):
        table.rows[0][col].text_frame.text = text

    # Set data rows
    rows = [
        ["Widget A", "120", "$2,400"],
        ["Widget B", "85", "$1,700"],
    ]
    for row_idx, row_data in enumerate(rows):
        for col, text in enumerate(row_data):
            table.rows[row_idx + 1][col].text_frame.text = text

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

ステップ 5: コネクタを追加

コネクタは2つのシェイプを視覚的にリンクします。まずシェイプを作成し、次にコネクタを追加して開始点と終了点の接続ポイントを設定します。

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)
    box1.add_text_frame("Start")

    box2 = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 350, 100, 150, 60)
    box2.add_text_frame("End")

    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 of box1
    conn.end_shape_connected_to = box2
    conn.end_shape_connection_site_index = 1    # left side of box2

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

矩形の接続サイトインデックスは 0–3 に番号付けされます: top=0、left=1、bottom=2、right=3。

ステップ 6: ピクチャーフレームを追加

画像を埋め込み、スライドに PictureFrame として追加します。まず画像バイトを読み取り、プレゼンテーションの画像コレクションに追加し、次にフレームを作成します。

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
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(
        ShapeType.RECTANGLE,  # bounding shape type
        50, 50,               # x, y in points
        200, 150,             # width, height in points
        image
    )

    prs.save("with-image.pptx", SaveFormat.PPTX)

一般的な問題と対策

スライドの表示領域外にシェイプが表示されます

スライドはデフォルトで 720 × 540 ポイントです。x または y の値がこれらの範囲を超えると、シェイプがスライド外に配置されます。x < 720 と y < 540 を保持し、x + width <= 720 と y + height <= 540 を確実にしてください。

AttributeError: 'NoneType' object has no attribute 'text_frame'

add_auto_shape() はシェイプオブジェクトを直接返します。None が表示された場合は、戻り値を破棄していないか確認してください。

割り当て後にテーブルセルのテキストが空になる

正しいプロパティは .text_frame.text（セル上に直接 .text ではありません）。セルにアクセスするには table.rows[row_index][col_index].text_frame.text = "value" を使用します。

よくある質問

スライドに追加できる図形の数はいくつですか？

ライブラリが課す制限はありません。実際の制限はファイルサイズと、対象の PPTX ビューアのレンダリング機能に依存します。

追加した後にシェイプの位置を変更できますか？

はい。add_auto_shape() が返すシェイプオブジェクトには、設定できる x、y、width、および height プロパティがあります：

shape.x = 100
shape.y = 200
shape.width = 400
shape.height = 80

シェイプのアウトライン（枠線）の色を設定できますか？

はい、shape.line_format経由で：

from aspose.slides_foss.drawing import Color
shape.line_format.fill_format.solid_fill_color.color = Color.from_argb(255, 200, 0, 0)

チャートはサポートされていますか？

いいえ。Charts、SmartArt、および OLE オブジェクトはこのエディションでは実装されておらず、NotImplementedError が発生します。