C#でPowerPointプレゼンテーションをプログラム的に作成および自動化する方法

ステップ1: IronPPTライブラリをインストールする。

Visual Studioのパッケージマネージャーコンソール(Tools > NuGet Package Manager > Package Manager Console)を開き、以下のコマンドを入力してください：

Install-Package IronPPT

あるいは、NuGetパッケージマネージャGUIで "IronPPT "を検索し、そこからインストールすることもできます。

NuGetパッケージマネージャ画面からIronPPTをインストールする。 VisualStudioのNuGetパッケージマネージャ、IronPPTライブラリのインストールを示す。

プログラムでスライドを追加および操作するにはどうすればよいですか?

プレゼンテーションはスライドの集まりです。 IronPPTはこれらのスライドを管理するためのシンプルで直感的なAPIを提供し、追加、読み込み、再利用が可能です。

既存のプレゼンテーションを読み込んでスライドを追加する

多くの場合、ゼロからプレゼンテーションを作成するのではなく、既存のプレゼンテーションを修正する必要があります。 .pptx<//code> ファイルをディスクから読み込むには、<code>PresentationDocument コンストラクタにそのパスを渡します。 一度読み込めば、新しいスライドを簡単に追加できます。

次の例は、以前に作成したプレゼンテーションを読み込み、新しい空白のスライドを追加します。

using IronPPT;

// Load an existing PowerPoint presentation
var presentation = new PresentationDocument("MyFirstPresentation.pptx");

// Add a new blank slide to the end of the presentation
presentation.AddSlide();

// Save the modified presentation
presentation.Save("PresentationWithTwoSlides.pptx");

using IronPPT;

// Load an existing PowerPoint presentation
var presentation = new PresentationDocument("MyFirstPresentation.pptx");

// Add a new blank slide to the end of the presentation
presentation.AddSlide();

// Save the modified presentation
presentation.Save("PresentationWithTwoSlides.pptx");

Imports IronPPT

' Load an existing PowerPoint presentation
Private presentation = New PresentationDocument("MyFirstPresentation.pptx")

' Add a new blank slide to the end of the presentation
presentation.AddSlide()

' Save the modified presentation
presentation.Save("PresentationWithTwoSlides.pptx")

この機能は、ロギングやステータス報告システムなど、時間をかけて情報を追加するアプリケーションに特に役立ちます。

2つの空白のスライド。 _同じプレゼンテーションに、C#コードを介して2番目の空白のスライドを追加しました。

using IronPPT;
using IronPPT.Models;

// Loading an existing presentation file
var ppt = new PresentationDocument("output.pptx");

// Add an additional slide
ppt.AddSlide();

// Save the updated presentation
ppt.Save("output.pptx");

using IronPPT;
using IronPPT.Models;

// Loading an existing presentation file
var ppt = new PresentationDocument("output.pptx");

// Add an additional slide
ppt.AddSlide();

// Save the updated presentation
ppt.Save("output.pptx");

Imports IronPPT
Imports IronPPT.Models

' Loading an existing presentation file
Private ppt = New PresentationDocument("output.pptx")

' Add an additional slide
ppt.AddSlide()

' Save the updated presentation
ppt.Save("output.pptx")

一貫したレイアウトのためにスライドを複製する

レポートや提案書の作成など、多くのビジネスシナリオでは、同じレイアウト、背景、ロゴやフッターなどのブランディング要素を共有する複数のスライドが必要です。 これらのスライドをそれぞれ手作業でコード化することは、繰り返しが多く、メンテナンスが困難です。

より効率的なアプローチは、プレゼンテーション内に「テンプレート」スライドを作成し、それをプログラムでクローンすることです。 IronPPTのパブリックAPIには直接的なClone()メソッドはありませんが、新しいスライドを作成し、テンプレートスライドから必要なプロパティや要素をコピーすることで実現できます。テンプレートでよく使われる、より直接的なアプローチは、あらかじめスライドをデザインし、それにデータを入力することです。 これは、Syncfusionのような他のライブラリにも見られる機能です。

テキスト、フォント、段落を扱う

テキストは、あらゆるプレゼンテーションにおいて最も一般的な要素です。 IronPPTでは、テキストはオブジェクトの階層を通して管理されます：Shape（テキストボックスとして機能）、Paragraph、Textです。 このような構成にすることで、位置やスタイルを細かく制御できます。

最初のスライドにスタイル付きタイトルを追加し、2番目のスライドに箇条書きリストを追加することによって、2つのスライドのプレゼンテーションを拡張してみましょう。

using IronPPT;
using IronPPT.Enums;
using System.Drawing;

// Load the presentation with two slides
var presentation = new PresentationDocument("PresentationWithTwoSlides.pptx");

// ---Modify the First Slide ---
Slide firstSlide = presentation.Slides;

// Clear existing text if any
firstSlide.ClearText();

// Add a title to the first slide. By default, AddText creates a textbox.
// For more control, we can create a Shape and add text to it.
Shape titleShape = firstSlide.AddShape(ShapeType.Rectangle, new Rectangle(50, 50, 860, 100));
titleShape.Fill.SetSolid(new Color("#003B5C")); // A dark blue background
Paragraph titleParagraph = titleShape.AddParagraph("Welcome to IronPPT");
titleParagraph.DefaultTextStyle.SetFont("Arial", 44).SetColor(Color.White).SetBold(true);
titleParagraph.Style.SetAlignment(TextAlignmentTypeValues.Center);

// ---Modify the Second Slide ---
Slide secondSlide = presentation.Slides;
secondSlide.AddText("Key Features", new Rectangle(50, 30, 860, 70))
   .DefaultTextStyle.SetFont("Calibri", 36).SetBold(true);

// Create a shape to act as a textbox for our bulleted list
Shape listShape = secondSlide.AddShape(ShapeType.Rectangle, new Rectangle(70, 120, 800, 300));

// Add a bulleted list
listShape.AddParagraph("Create presentations programmatically").Style.SetBullet(BulletType.Numeric);
listShape.AddParagraph("Add text, images, and shapes").Style.SetBullet(BulletType.Numeric);
listShape.AddParagraph("Style content with fonts, colors, and alignment").Style.SetBullet(BulletType.Numeric);
listShape.AddParagraph("Generate data-driven reports from templates").Style.SetBullet(BulletType.Numeric);

// Style all paragraphs in the list shape
foreach (var para in listShape.Paragraphs)
{
    para.DefaultTextStyle.SetFont("Arial", 28);
    para.Style.SetIndentation(30); // Indent the list
}

// Save the final presentation
presentation.Save("PresentationWithRichContent.pptx");

using IronPPT;
using IronPPT.Enums;
using System.Drawing;

// Load the presentation with two slides
var presentation = new PresentationDocument("PresentationWithTwoSlides.pptx");

// ---Modify the First Slide ---
Slide firstSlide = presentation.Slides;

// Clear existing text if any
firstSlide.ClearText();

// Add a title to the first slide. By default, AddText creates a textbox.
// For more control, we can create a Shape and add text to it.
Shape titleShape = firstSlide.AddShape(ShapeType.Rectangle, new Rectangle(50, 50, 860, 100));
titleShape.Fill.SetSolid(new Color("#003B5C")); // A dark blue background
Paragraph titleParagraph = titleShape.AddParagraph("Welcome to IronPPT");
titleParagraph.DefaultTextStyle.SetFont("Arial", 44).SetColor(Color.White).SetBold(true);
titleParagraph.Style.SetAlignment(TextAlignmentTypeValues.Center);

// ---Modify the Second Slide ---
Slide secondSlide = presentation.Slides;
secondSlide.AddText("Key Features", new Rectangle(50, 30, 860, 70))
   .DefaultTextStyle.SetFont("Calibri", 36).SetBold(true);

// Create a shape to act as a textbox for our bulleted list
Shape listShape = secondSlide.AddShape(ShapeType.Rectangle, new Rectangle(70, 120, 800, 300));

// Add a bulleted list
listShape.AddParagraph("Create presentations programmatically").Style.SetBullet(BulletType.Numeric);
listShape.AddParagraph("Add text, images, and shapes").Style.SetBullet(BulletType.Numeric);
listShape.AddParagraph("Style content with fonts, colors, and alignment").Style.SetBullet(BulletType.Numeric);
listShape.AddParagraph("Generate data-driven reports from templates").Style.SetBullet(BulletType.Numeric);

// Style all paragraphs in the list shape
foreach (var para in listShape.Paragraphs)
{
    para.DefaultTextStyle.SetFont("Arial", 28);
    para.Style.SetIndentation(30); // Indent the list
}

// Save the final presentation
presentation.Save("PresentationWithRichContent.pptx");

IRON VB CONVERTER ERROR developers@ironsoftware.com

この例では、いくつかの重要なコンセプトを紹介します：

• テキストボックスとしてのシェイプ：テキストのコンテナとして使用するために、Rectangle型のShapeを作成します。 このため、位置とサイズを正確にコントロールすることができます。
• 段落: テキストコンテンツは、Paragraphオブジェクトを介して追加されます。
• スタイリング: ParagraphのDefaultTextStyleプロパティは、フォント、サイズ、色、太さの流暢なスタイリングを可能にします。 Styleプロパティは、整列や箇条書きのような段落レベルの書式を制御します。

テキストとテキストボックスを追加する。 最初のスライドにはスタイル付きのタイトルが表示され、2番目のスライドには箇条書きのリストが表示されます。

画像の挿入と配置

魅力的なプレゼンテーションには、ロゴ、図表、製品画像などの視覚的要素が不可欠です。 IronPPTはファイルやメモリストリームから画像を簡単に追加できます。

次のコードでは、タイトルスライドの右下にIron Softwareのロゴを追加しています。

using IronPPT;
using System.Drawing;

var presentation = new PresentationDocument("PresentationWithRichContent.pptx");
Slide firstSlide = presentation.Slides;

// Load an image from a file
Image logo = new Image("iron_logo.png");

// Add the image to the slide and set its properties
var addedImage = firstSlide.AddImage(logo);
addedImage.Position = new Point(750, 450);
addedImage.Width = 150;
addedImage.Height = 75;

presentation.Save("PresentationWithImage.pptx");

using IronPPT;
using System.Drawing;

var presentation = new PresentationDocument("PresentationWithRichContent.pptx");
Slide firstSlide = presentation.Slides;

// Load an image from a file
Image logo = new Image("iron_logo.png");

// Add the image to the slide and set its properties
var addedImage = firstSlide.AddImage(logo);
addedImage.Position = new Point(750, 450);
addedImage.Width = 150;
addedImage.Height = 75;

presentation.Save("PresentationWithImage.pptx");

Imports IronPPT
Imports System.Drawing

Private presentation = New PresentationDocument("PresentationWithRichContent.pptx")
Private firstSlide As Slide = presentation.Slides

' Load an image from a file
Private logo As New Image("iron_logo.png")

' Add the image to the slide and set its properties
Private addedImage = firstSlide.AddImage(logo)
addedImage.Position = New Point(750, 450)
addedImage.Width = 150
addedImage.Height = 75

presentation.Save("PresentationWithImage.pptx")

AddImage メソッドは、スライドに追加された後、その Position, Width, Height, 回転 (Angle) をさらに操作できる Image オブジェクトを返します。

最初のスライドに画像を追加する。 _タイトルスライドには、右下に配置された画像が含まれるようになりました。

図形の描画とカスタマイズ

IronPPTはテキストボックスに使われる長方形以外にも、スライドに視覚的な構造と強調を加えるために様々な図形を描くことができます。 ジオメトリ、色、位置をコントロールできます。

2枚目のスライドに装飾的な図形を追加して、コンテンツを視覚的に分けてみましょう。

using IronPPT;
using IronPPT.Enums;
using System.Drawing;

var presentation = new PresentationDocument("PresentationWithImage.pptx");
Slide secondSlide = presentation.Slides;

// Add a circle shape to the second slide
Shape circle = secondSlide.AddShape(ShapeType.Ellipse, new Rectangle(400, 250, 200, 200));
circle.Name = "DecorativeCircle";

// Customize the shape's appearance
circle.Fill.SetSolid(new Color("#E0F7FA")); // A light cyan color
circle.Outline.SetColor(new Color("#00796B")).SetWidth(3); // A teal outline

presentation.Save("PresentationWithShapes.pptx");

using IronPPT;
using IronPPT.Enums;
using System.Drawing;

var presentation = new PresentationDocument("PresentationWithImage.pptx");
Slide secondSlide = presentation.Slides;

// Add a circle shape to the second slide
Shape circle = secondSlide.AddShape(ShapeType.Ellipse, new Rectangle(400, 250, 200, 200));
circle.Name = "DecorativeCircle";

// Customize the shape's appearance
circle.Fill.SetSolid(new Color("#E0F7FA")); // A light cyan color
circle.Outline.SetColor(new Color("#00796B")).SetWidth(3); // A teal outline

presentation.Save("PresentationWithShapes.pptx");

Imports IronPPT
Imports IronPPT.Enums
Imports System.Drawing

Private presentation = New PresentationDocument("PresentationWithImage.pptx")
Private secondSlide As Slide = presentation.Slides

' Add a circle shape to the second slide
Private circle As Shape = secondSlide.AddShape(ShapeType.Ellipse, New Rectangle(400, 250, 200, 200))
circle.Name = "DecorativeCircle"

' Customize the shape's appearance
circle.Fill.SetSolid(New Color("#E0F7FA")) ' A light cyan color
circle.Outline.SetColor(New Color("#00796B")).SetWidth(3) ' A teal outline

presentation.Save("PresentationWithShapes.pptx")

このコードでは、薄いシアン色の塗りつぶしとティール色の輪郭を持つ円を追加しています。プログラムで図形を追加したりスタイルを設定したりする機能は、カスタムダイアグラムやフローチャートを作成したり、自動化されたプレゼンテーションのビジュアルデザインを単純に向上させたりするのに非常に便利です。

スタイリングされた円。 2番目のスライドには、C#コードによって追加されたスタイル付きの円が表示されます。

動的レポートにテンプレートを使用する

using IronPPT;
using System.Collections.Generic;

// ---Sample Data ---
var reportData = new Dictionary<string, string>
{
    { "{{ClientName}}", "Global Tech Inc." },
    { "{{ReportDate}}", System.DateTime.Now.ToShortDateString() },
    { "{{TotalSales}}", "$1,250,000" },
    { "{{PreparedBy}}", "Automated Reporting System" }
};

// Load the presentation template
var presentation = new PresentationDocument("ReportTemplate.pptx");
Slide reportSlide = presentation.Slides;

// Iterate through all shapes on the slide to find and replace text
foreach (var shape in reportSlide.Shapes)
{
    // Iterate through all paragraphs within the shape
    foreach (var paragraph in shape.Paragraphs)
    {
        // Iterate through all text runs in the paragraph
        foreach (var textRun in paragraph.Texts)
        {
            foreach (var kvp in reportData)
            {
                if (textRun.Value.Contains(kvp.Key))
                - textRun.ReplaceText(kvp.Key, kvp.Value);
            }
        }
    }
}

// Save the generated report
presentation.Save("GeneratedClientReport.pptx");

using IronPPT;
using System.Collections.Generic;

// ---Sample Data ---
var reportData = new Dictionary<string, string>
{
    { "{{ClientName}}", "Global Tech Inc." },
    { "{{ReportDate}}", System.DateTime.Now.ToShortDateString() },
    { "{{TotalSales}}", "$1,250,000" },
    { "{{PreparedBy}}", "Automated Reporting System" }
};

// Load the presentation template
var presentation = new PresentationDocument("ReportTemplate.pptx");
Slide reportSlide = presentation.Slides;

// Iterate through all shapes on the slide to find and replace text
foreach (var shape in reportSlide.Shapes)
{
    // Iterate through all paragraphs within the shape
    foreach (var paragraph in shape.Paragraphs)
    {
        // Iterate through all text runs in the paragraph
        foreach (var textRun in paragraph.Texts)
        {
            foreach (var kvp in reportData)
            {
                if (textRun.Value.Contains(kvp.Key))
                - textRun.ReplaceText(kvp.Key, kvp.Value);
            }
        }
    }
}

// Save the generated report
presentation.Save("GeneratedClientReport.pptx");

IRON VB CONVERTER ERROR developers@ironsoftware.com