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

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

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

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

dotnet add package Aspose.Slides.Foss

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

using Aspose.Slides.Foss;
Console.WriteLine("Ready");

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

常にPresentationをusingステートメントと一緒に使用してください。

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

using var prs = new Presentation();
var slide = prs.Slides[0];
// ... add shapes ...
prs.Save("output.pptx", SaveFormat.Pptx);

ステップ 3: AutoShape を追加

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

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

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

// Rectangle
var rect = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 300, 100);
rect.AddTextFrame("Rectangle shape");

// Ellipse
var ellipse = slide.Shapes.AddAutoShape(ShapeType.Ellipse, 400, 50, 200, 100);
ellipse.AddTextFrame("Ellipse shape");

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

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

slide.Shapes.AddTable(x, y, columnWidths, rowHeights) は指定された位置にテーブルを作成します。列幅と行高さはポイント値の配列です。

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

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

var colWidths = new double[] { 150.0, 150.0, 150.0 };
var rowHeights = new double[] { 40.0, 40.0, 40.0 };
var table = slide.Shapes.AddTable(50, 200, colWidths, rowHeights);

// Set header row text
string[] headers = { "Product", "Units", "Revenue" };
for (int col = 0; col < headers.Length; col++)
    table.Rows[0][col].TextFrame.Text = headers[col];

// Set data rows
string[][] rows = {
    new[] { "Widget A", "120", "$2,400" },
    new[] { "Widget B", "85", "$1,700" },
};
for (int rowIdx = 0; rowIdx < rows.Length; rowIdx++)
    for (int col = 0; col < rows[rowIdx].Length; col++)
        table.Rows[rowIdx + 1][col].TextFrame.Text = rows[rowIdx][col];

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

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

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

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

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

var box1 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 100, 150, 60);
box1.AddTextFrame("Start");

var box2 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 350, 100, 150, 60);
box2.AddTextFrame("End");

var conn = slide.Shapes.AddConnector(ShapeType.BentConnector3, 0, 0, 10, 10);
conn.StartShapeConnectedTo = box1;
conn.StartShapeConnectionSiteIndex = 3;  // right side of box1
conn.EndShapeConnectedTo = box2;
conn.EndShapeConnectionSiteIndex = 1;    // left side of box2

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

矩形の接続サイトインデックスは 0〜3 に番号付けされます: 上=0、左=1、下=2、右=3。

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

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

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

using var prs = new Presentation();
byte[] imageData = File.ReadAllBytes("logo.png");
var image = prs.Images.AddImage(imageData);

var slide = prs.Slides[0];
slide.Shapes.AddPictureFrame(
    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 を確実にしてください。

NullReferenceException アクセス時 TextFrame

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

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

正しいプロパティは .TextFrame.Text（セル上に直接 .Text ではありません）。セルにアクセスするには table.Rows[rowIndex][colIndex].TextFrame.Text = "value" を使用します。

よくある質問

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

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

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

はい。AddAutoShape() が返すシェイプオブジェクトには、設定できる X、Y、Width、および Height プロパティがあります:

shape.X = 100;
shape.Y = 200;
shape.Width = 400;
shape.Height = 80;

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

はい、shape.LineFormat経由で：

using Aspose.Slides.Foss.Drawing;
shape.LineFormat.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 200, 0, 0);

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

いいえ。このエディションでは、チャート、SmartArt、OLE オブジェクトは実装されていません。