`PowerPoint` .NETコンポーネント

using IronPPT;

// Initialize a new presentation
var ppt = new PresentationDocument();

// Add Text to the new presentation
// TextBoxes[0] typically represents the title placeholder
ppt.Slides[0].TextBoxes[0].AddText("Welcome to IronPPT");

// TextBoxes[1] typically represents the subtitle or content area
ppt.Slides[0].TextBoxes[1].AddText("This slide was generated using IronPPT!");

// Save the presentation with a descriptive filename
ppt.Save("new_presentation.pptx");

using IronPPT;

// Initialize a new presentation
var ppt = new PresentationDocument();

// Add Text to the new presentation
// TextBoxes[0] typically represents the title placeholder
ppt.Slides[0].TextBoxes[0].AddText("Welcome to IronPPT");

// TextBoxes[1] typically represents the subtitle or content area
ppt.Slides[0].TextBoxes[1].AddText("This slide was generated using IronPPT!");

// Save the presentation with a descriptive filename
ppt.Save("new_presentation.pptx");

この例は、プレゼンテーションを作成する際の基本的なパターンを示しています。 APIがスライドやテキストボックスにアクセスする際に、おなじみのインデックス付けを使用している点に注目してください。 新しい PresentationDocument をインスタンス化すると、最初のスライド (インデックス 0) が自動的に作成されます。 各スライドには、レイアウトに基づいてあらかじめ定義されたテキストボックスがあり、そこにコンテンツを入力できます。

出力

using IronPPT;

// Load the existing pptx file
// The constructor accepts a file path to an existing presentation
var ppt = new PresentationDocument("new_presentation.pptx");

// Edit the existing text by accessing the Texts collection
// Texts[0] refers to the first text element in the text box
ppt.Slides[0].TextBoxes[0].Texts[0].Text = "Hello World!";

// Save the changes to a new file to preserve the original
ppt.Save("updated.pptx");

using IronPPT;

// Load the existing pptx file
// The constructor accepts a file path to an existing presentation
var ppt = new PresentationDocument("new_presentation.pptx");

// Edit the existing text by accessing the Texts collection
// Texts[0] refers to the first text element in the text box
ppt.Slides[0].TextBoxes[0].Texts[0].Text = "Hello World!";

// Save the changes to a new file to preserve the original
ppt.Save("updated.pptx");

IronPPTは、既存のプレゼンテーションを編集する際に、すべての書式設定と変更されていないコンテンツを保持します。 この例では、プレゼンテーションを読み込み、特定のテキスト要素を変更し、変更内容を保存する方法を示します。 テキストコレクションを使用すると、テキストボックス内の個々のテキストにアクセスできるため、コンテンツの更新を正確に制御できます。

出力

using IronPPT;
using IronPPT.Models;

// Load an existing presentation
var ppt = new PresentationDocument("updated.pptx");

// Create a new Image object
Image img = new Image();

// Load image from file - supports common formats (JPG, PNG, etc.)
img.LoadFromFile("IronPPT.png");

// Add the image to the presentation on slide 0
// The method returns a reference to the added image for further manipulation
var newImg = ppt.AddImage(img, 0);

// Position the image using coordinates (left, top)
newImg.Position = (150, 50);

// Set dimensions - maintain aspect ratio manually if needed
newImg.Width = 400;
newImg.Height = 150;

// Save the presentation with the embedded image
ppt.Save("image.pptx");

using IronPPT;
using IronPPT.Models;

// Load an existing presentation
var ppt = new PresentationDocument("updated.pptx");

// Create a new Image object
Image img = new Image();

// Load image from file - supports common formats (JPG, PNG, etc.)
img.LoadFromFile("IronPPT.png");

// Add the image to the presentation on slide 0
// The method returns a reference to the added image for further manipulation
var newImg = ppt.AddImage(img, 0);

// Position the image using coordinates (left, top)
newImg.Position = (150, 50);

// Set dimensions - maintain aspect ratio manually if needed
newImg.Width = 400;
newImg.Height = 150;

// Save the presentation with the embedded image
ppt.Save("image.pptx");

この例は、IronPPTの画像処理機能を示すものです。 Image クラスは、さまざまなソースから画像を読み込むためのメソッドを提供し、位置決めシステムは標準の PowerPoint 単位を使用します。 画像の位置やサイズを設定する際は、対象となるスライドの寸法を考慮するようにしてください。そうすることで、さまざまな表示環境で画像が正しく表示されるようになります。

出力

まず、以下のコード例を使ってプレゼンテーションにスライドを追加してみましょう。

using IronPPT;
using IronPPT.Models;

// Load the existing presentation
var ppt = new PresentationDocument("updated.pptx");

// Create a new slide object
Slide slide = new Slide();

// Add text to the new slide
// This creates a simple slide with a title
slide.AddText("Slide Two");

// Add the slide to the presentation
// The slide is appended to the end of the presentation
ppt.AddSlide(slide);

// Create another slide for demonstration
Slide slide3 = new Slide();
slide3.AddText("Slide Three");
ppt.AddSlide(slide3);

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

using IronPPT;
using IronPPT.Models;

// Load the existing presentation
var ppt = new PresentationDocument("updated.pptx");

// Create a new slide object
Slide slide = new Slide();

// Add text to the new slide
// This creates a simple slide with a title
slide.AddText("Slide Two");

// Add the slide to the presentation
// The slide is appended to the end of the presentation
ppt.AddSlide(slide);

// Create another slide for demonstration
Slide slide3 = new Slide();
slide3.AddText("Slide Three");
ppt.AddSlide(slide3);

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

スライドを追加する際、 IronPPTはプレゼンテーションの内部構造を自動的に処理します。 特に指定しない限り、新しいスライドにはデフォルトのレイアウトが適用されます。AddSlide メソッドはスライドをプレゼンテーションの最後に追加しますが、後述するように、簡単に順番を変更できます。

出力

プレゼンテーションに複数のスライドがある場合、それらを簡単に並べ替えることができます。

using IronPPT;

// Configure your license key to remove trial limitations
IronPPT.License.LicenseKey = "YOUR-LICENSE-KEY";

// Load the presentation with multiple slides
var ppt = new PresentationDocument("updated.pptx");

// Reorder slides by changing their Index property
// This moves the third slide (index 2) to the second position (index 1)
ppt.Slides[2].Index = 1;

// The library automatically adjusts other slide indices
// Original order: [0, 1, 2] -> New order: [0, 2, 1]

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

using IronPPT;

// Configure your license key to remove trial limitations
IronPPT.License.LicenseKey = "YOUR-LICENSE-KEY";

// Load the presentation with multiple slides
var ppt = new PresentationDocument("updated.pptx");

// Reorder slides by changing their Index property
// This moves the third slide (index 2) to the second position (index 1)
ppt.Slides[2].Index = 1;

// The library automatically adjusts other slide indices
// Original order: [0, 1, 2] -> New order: [0, 2, 1]

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

スライドの並べ替え機能は、プレゼンテーションを動的に作成する際に特に便利です。 スライドは生成された順序で追加し、その後、業務上のロジックやユーザーの好みに基づいて並べ替えることができます。 Indexプロパティを使うことで、この処理は直感的かつ効率的になります。

出力

これで、"スライド2"というテキストが入ったスライドが、プレゼンテーションの2番目のスライドとして正しい位置に再配置されました。