Pythonでプレゼンテーションテーブルを管理する

概要

PowerPoint のテーブルは情報を提示する効率的な方法です。セル（行と列）のグリッドに情報を配置することで、シンプルかつ分かりやすくなります。

Aspose.Slides は Table クラス、Cell クラス、その他の関連型を提供し、プレゼンテーション内のテーブルの作成、更新、管理を支援します。

スクラッチからテーブルを作成

このセクションでは、スライドにテーブルシェイプを追加し、行と列を定義し、正確なサイズを設定することで、Aspose.Slides でテーブルをゼロから作成する方法を示します。セルにテキストを入力し、配置や罫線を調整し、テーブルの外観をカスタマイズする方法も紹介します。

Presentation クラスのインスタンスを作成します。
インデックスでスライドへの参照を取得します。
列幅の配列を定義します。
行高さの配列を定義します。
スライドに Table を追加します。
各 Cell を反復処理し、上、下、右、左の罫線を設定します。
テーブルの最初の行の最初の 2 つのセルを結合します。
Cell の TextFrame にアクセスします。
TextFrame にテキストを追加します。
変更したプレゼンテーションを保存します。

以下の Python の例は、プレゼンテーションにテーブルを作成する方法を示しています:

import aspose.pydrawing as draw
import aspose.slides as slides

# プレゼンテーション ファイルを表す Presentation クラスのインスタンスを作成します。
with slides.Presentation() as presentation:
    # 最初のスライドにアクセスします。
    slide = presentation.slides[0]

    # 列幅と行高さを定義します。
    column_widths = [50, 50, 50]
    row_heights = [50, 30, 30, 30, 30]

    # スライドにテーブル シェイプを追加します。
    table = slide.shapes.add_table(100, 50, column_widths, row_heights)

    # 各セルの罫線書式を設定します。
    for row in table.rows:
        for cell in row:
            cell.cell_format.border_top.fill_format.fill_type = slides.FillType.SOLID
            cell.cell_format.border_top.fill_format.solid_fill_color.color = draw.Color.red
            cell.cell_format.border_top.width = 5

            cell.cell_format.border_bottom.fill_format.fill_type = slides.FillType.SOLID
            cell.cell_format.border_bottom.fill_format.solid_fill_color.color= draw.Color.red
            cell.cell_format.border_bottom.width = 5

            cell.cell_format.border_left.fill_format.fill_type = slides.FillType.SOLID
            cell.cell_format.border_left.fill_format.solid_fill_color.color =draw.Color.red
            cell.cell_format.border_left.width = 5

            cell.cell_format.border_right.fill_format.fill_type = slides.FillType.SOLID
            cell.cell_format.border_right.fill_format.solid_fill_color.color = draw.Color.red
            cell.cell_format.border_right.width = 5
        
    # セル (0 行, 0 列) から (1 行, 1 列) まで結合します。
    table.merge_cells(table.rows[0][0], table.rows[1][1], False)

    # 結合されたセルにテキストを追加します。
    table.rows[0][0].text_frame.text = "Merged Cells"

    # プレゼンテーションをディスクに保存します。
    presentation.save("table.pptx", slides.export.SaveFormat.PPTX)

標準テーブルの番号付け

標準テーブルでは、セルの番号付けはゼロベースで単純です。テーブル内の最初のセルは (0, 0)（列 0、行 0）としてインデックス付けされます。

たとえば、4 列 4 行のテーブルの場合、セルは次のように番号付けされます。

(0, 0)	(1, 0)	(2, 0)	(3, 0)
(0, 1)	(1, 1)	(2, 1)	(3, 1)
(0, 2)	(1, 2)	(2, 2)	(3, 2)
(0, 3)	(1, 3)	(2, 3)	(3, 3)

以下の Python の例は、このゼロベースの番号付けを使用してセルを参照する方法を示しています:

for row_index in range(len(table.rows)):
    for column_index in range(len(table.rows[row_index])):
        cell = table.rows[row_index][column_index]
        cell.text_frame.text = f"({column_index}, {row_index})"

既存テーブルへのアクセス

このセクションでは、Aspose.Slides を使用してプレゼンテーション内の既存テーブルを検索し、操作する方法を説明します。スライド上のテーブルを見つけ、行・列・セルにアクセスし、コンテンツや書式を更新する方法を学びます。

Presentation クラスのインスタンスを作成します。
インデックスでテーブルが含まれるスライドへの参照を取得します。
すべての Shape オブジェクトを反復処理し、テーブルを見つけるまで続けます。
Table オブジェクトを使用してテーブルを操作します。
変更したプレゼンテーションを保存します。

スライドに複数のテーブルがある場合は、alternative_text プロパティで必要なテーブルを検索した方が便利です。

以下の Python の例は、既存テーブルにアクセスして操作する方法を示しています:

import aspose.pydrawing as draw
import aspose.slides as slides

# PPTX ファイルをロードするために Presentation クラスのインスタンスを作成します。
with slides.Presentation("sample.pptx") as presentation:
    # 最初のスライドにアクセスします。
    slide = presentation.slides[0]

    table = None

    # シェイプを反復処理し、最初に見つかったテーブルを参照します。
    for shape in slide.shapes:
        if isinstance(shape, slides.Table):
            table = shape
            break

    # 最初の行の最初のセルのテキストを設定します。
    if table is not None:
        table.rows[0][0].text_frame.text = "Found"

    # 変更したプレゼンテーションをディスクに保存します。
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

テーブル内のテキスト配置

このセクションでは、Aspose.Slides を使用してテーブルセル内のテキスト配置を制御する方法を示します。セルの水平・垂直配置を設定し、コンテンツを明確かつ一貫した状態に保つ方法を学びます。

Presentation クラスのインスタンスを作成します。
インデックスでスライドへの参照を取得します。
スライドに Table オブジェクトを追加します。
テーブルから Cell オブジェクトにアクセスします。
テキストを垂直方向に配置します。
変更したプレゼンテーションを保存します。

以下の Python の例は、テーブル内のテキストを配置する方法を示しています:

import aspose.pydrawing as draw
import aspose.slides as slides

# Presentation クラスのインスタンスを作成します。
with slides.Presentation() as presentation:
    # 最初のスライドにアクセスします。
    slide = presentation.slides[0]

    # 列幅と行高さを定義します。
    column_widths = [40, 120, 120, 120]
    row_heights = [100, 100, 100, 100]

    # スライドにテーブル シェイプを追加します。
    table = slide.shapes.add_table(100, 50, column_widths, row_heights)
    table.rows[0][0].text_frame.text = "Numbers"
    table.rows[1][0].text_frame.text = "10"
    table.rows[2][0].text_frame.text = "20"
    table.rows[3][0].text_frame.text = "30"

    # テキストを中央揃えにし、垂直方向を設定します。
    cell = table.rows[0][0]
    cell.text_anchor_type = slides.TextAnchorType.CENTER
    cell.text_vertical_type = slides.TextVerticalType.VERTICAL270

    # プレゼンテーションをディスクに保存します。
    presentation.save("aligned_cell.pptx", slides.export.SaveFormat.PPTX)

テーブルレベルでのテキスト書式設定

このセクションでは、Aspose.Slides でテーブルレベルのテキスト書式設定を適用し、すべてのセルが統一されたスタイルを継承する方法を示します。フォントサイズ、配置、余白をグローバルに設定する方法を学びます。

Presentation クラスのインスタンスを作成します。
インデックスでスライドへの参照を取得します。
スライドに Table を追加します。
テキストのフォントサイズ（フォント高さ）を設定します。
段落の配置と余白を設定します。
垂直テキスト方向を設定します。
変更したプレゼンテーションを保存します。

以下の Python の例は、テーブル内テキストに好みの書式オプションを適用する方法を示しています:

import aspose.pydrawing as draw
import aspose.slides as slides

# Presentation クラスのインスタンスを作成します
with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    table = slide.shapes.add_table(20, 20, [100, 50, 30], [30, 50, 30])

    # すべてのテーブルセルのフォントサイズを設定します。
    portion_format = slides.PortionFormat()
    portion_format.font_height = 25
    table.set_text_format(portion_format)

    # すべてのテーブルセルに右寄せテキストと右マージンを設定します。
    paragraph_format = slides.ParagraphFormat()
    paragraph_format.alignment = slides.TextAlignment.RIGHT
    paragraph_format.margin_right = 20
    table.set_text_format(paragraph_format)

    # すべてのテーブルセルの垂直テキスト方向を設定します。
    text_frame_format = slides.TextFrameFormat()
    text_frame_format.text_vertical_type = slides.TextVerticalType.VERTICAL
    table.set_text_format(text_frame_format)

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

組み込みテーブルスタイルの適用

Aspose.Slides はコード内で事前定義されたスタイルを使用してテーブルをフォーマットできる機能を提供します。例ではテーブルを作成し、組み込みスタイルを適用し、結果を保存する手順を示しています。これにより、一貫したプロフェッショナルな書式設定が簡単に実現できます。

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    table = slide.shapes.add_table(10, 10, [100, 150], [5, 5, 5])

    table.style_preset = slides.TableStylePreset.DARK_STYLE1

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

テーブルのアスペクト比ロック

シェイプのアスペクト比は寸法の比率です。Aspose.Slides は aspect_ratio_locked プロパティを提供し、テーブルやその他のシェイプのアスペクト比をロックできます。

以下の Python の例は、テーブルのアスペクト比をロックする方法を示しています:

import aspose.pydrawing as draw
import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    table = slide.shapes.add_table(20, 20, [100, 50, 30], [30, 50, 30])

    print(f"Lock aspect ratio set: {table.shape_lock.aspect_ratio_locked}")
    table.shape_lock.aspect_ratio_locked = not table.shape_lock.aspect_ratio_locked
    print(f"Lock aspect ratio set: {table.shape_lock.aspect_ratio_locked}")

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

FAQ

テーブル全体とセル内のテキストに対して右から左 (RTL) 読み方向を有効にできますか？

はい。テーブルは right_to_left プロパティを公開し、段落は ParagraphFormat.right_to_left を持ちます。両方を使用することで、セル内の正しい RTL 順序と描画が保証されます。

最終ファイルでユーザーがテーブルを移動またはサイズ変更できないようにするにはどうすればよいですか？

shape locks を使用して、移動、サイズ変更、選択などを無効にします。これらのロックはテーブルにも適用されます。

セル内に画像を背景として挿入することはサポートされていますか？

はい。セルに対して picture fill を設定できます。画像は選択したモード（伸縮またはタイル）に従ってセル領域全体をカバーします。

Python を使用して PowerPoint テーブルの行と列を管理