.NETでプレゼンテーションを作成する方法

Aspose.Slides FOSS for .NET は、Microsoft Office に依存せず、C# だけで PowerPoint プレゼンテーションを作成できます。このガイドでは、新しいプレゼンテーションの作成、スライドとシェイプの追加、テキストの書式設定、そして結果の保存方法を示します。

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

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

NuGet から Aspose.Slides FOSS をインストールします。NET 9.0 以降が必要です。

dotnet add package Aspose.Slides.Foss

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

using Aspose.Slides.Foss;

using var prs = new Presentation();
Console.WriteLine("Aspose.Slides FOSS ready");

他にシステムパッケージは必要ありません。

ステップ 2: 必要な名前空間をインポートする

プレゼンテーションの作成と保存に必要な名前空間を追加します。

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

すべてのシェイプタイプ定数は Aspose.Slides.Foss.ShapeType にあります。すべての書式設定タイプ（FillType、NullableBool）も Aspose.Slides.Foss にあります。

ステップ 3: プレゼンテーションの作成

new Presentation() を using ステートメントと共に使用します。新しいプレゼンテーションは空白のスライドが1枚で開始されます。

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
Console.WriteLine($"Slides in new presentation: {prs.Slides.Count}");
// work with prs
prs.Save("output.pptx", SaveFormat.Pptx);

重要: 常にPresentationをusingステートメントと共に使用してください。クラスはIDisposableを実装しており、これがないとリソースが正しく解放されません。

ステップ 4: スライドにアクセスする

最初のスライドはインデックス0です。空白のプレゼンテーションには正確に1枚のスライドがあります。

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];  // zero-based index
Console.WriteLine($"Slide at index 0: {slide}");
prs.Save("output.pptx", SaveFormat.Pptx);

ステップ5: シェイプを追加

slide.Shapes.AddAutoShape() を使用して AutoShape を追加します。パラメーターは (shapeType, x, y, width, height) で、すべてポイント単位です (1 ポイント = 1/72 インチ; 標準スライドは 720 x 540 pt)。

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];

// Rectangle at (50, 50) with 400 wide and 120 tall
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 400, 120);

// Attach a text frame
shape.AddTextFrame("Hello from Aspose.Slides FOSS!");

prs.Save("with-shape.pptx", SaveFormat.Pptx);

ステップ 6: プレゼンテーションを保存

オブジェクトが破棄される前に prs.Save(path, SaveFormat.Pptx) を呼び出してください。PPTX は唯一サポートされている出力形式です。

prs.Save("result.pptx", SaveFormat.Pptx);

ファイルは原子的に書き込まれます；この呼び出しの前にエラーが発生した場合、出力ファイルは作成されません。

完全な作業例

以下のプログラムは、最初のスライドにタイトルシェイプ、2番目のスライドにテーブルを配置した2枚のスライドからなるプレゼンテーションを作成します。

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();

// --- Slide 1: title shape ---
var slide1 = prs.Slides[0];
var title = slide1.Shapes.AddAutoShape(ShapeType.Rectangle, 40, 40, 640, 80);
var tf = title.AddTextFrame("Q1 Results: Executive Summary");
var fmt = tf.Paragraphs[0].Portions[0].PortionFormat;
fmt.FontHeight = 32;
fmt.FontBold = NullableBool.True;
fmt.FillFormat.FillType = FillType.Solid;
fmt.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 0, 70, 127);

// --- Slide 2: table ---
prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
var slide2 = prs.Slides[1];
var table = slide2.Shapes.AddTable(40, 40,
    new double[] { 200.0, 120.0, 120.0 },
    new double[] { 40.0, 40.0, 40.0 });

string[] headers = { "Region", "Revenue", "Growth" };
string[][] data = {
    new[] { "North", "$1.2M", "+8%" },
    new[] { "South", "$0.9M", "+4%" },
};

for (int col = 0; col < headers.Length; col++)
    table.Rows[0][col].TextFrame.Text = headers[col];

for (int row = 0; row < data.Length; row++)
    for (int col = 0; col < data[row].Length; col++)
        table.Rows[row + 1][col].TextFrame.Text = data[row][col];

prs.Save("q1-results.pptx", SaveFormat.Pptx);
Console.WriteLine("Saved q1-results.pptx");

一般的な問題と対処法

ObjectDisposedException

Presentation オブジェクトを using ブロックが終了した後に使用しています。すべての処理はオブジェクトが破棄される前に行う必要があります。

ShapeType の名前空間が見つからないエラー

ファイルの先頭に using Aspose.Slides.Foss; があることを確認してください。ShapeType、NullableBool、FillType、およびその他の列挙体はこの名前空間にあります。

SaveFormat 以外 Pptx

SaveFormat の任意の値を SaveFormat.Pptx 以外で渡しても例外はスローされません。format パラメータは黙って無視され、常に PPTX が生成されます。常に SaveFormat.Pptx を使用して明示的に指定してください。

よくある質問

デフォルトのスライドサイズは何ですか？

新しいPresentation()は、標準の10 × 7.5インチ（720 × 540ポイント）サイズのスライドを作成します。このエディションではスライドサイズの変更はまだサポートされていません。

スライドを複数追加できますか？

はい。prs.Slides.AddEmptySlide(prs.LayoutSlides[0]) を呼び出して空白スライドを追加し、インデックスでアクセスします:

prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
var slide2 = prs.Slides[1];

既存のファイルを開いてスライドを追加できますか？

はい：

using var prs = new Presentation("existing.pptx");
prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
prs.Save("existing.pptx", SaveFormat.Pptx);

保存できる形式は何ですか？

SaveFormat.Pptx のみがサポートされています。このエディションでは PDF、HTML、SVG、または画像へのエクスポートは利用できません。