`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) が自動的に作成されます。 各スライドには、レイアウトに基づいて事前定義されたテキスト ボックスが含まれており、そこにコンテンツを入力できます。

出力

! IronPPTライブラリのホームページには、PowerPointプレゼンテーションの作成、スライドの追加、.NET APIを使用したドキュメントの保存方法を示す実用的なC#コード例が掲載されています。

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 はすべての書式と変更されていないコンテンツを保持します。 この例では、プレゼンテーションを読み込み、特定のテキスト要素を変更し、変更を保存する方法を示します。 Texts コレクションは、テキスト ボックス内の個々のテキスト ランへのアクセスを提供し、コンテンツの更新を正確に制御できるようにします。

出力

! IronPPT .NET コンポーネントを使用してプログラム的に作成された PowerPoint プレゼンテーションの例。書式設定されたテキストコンテンツを含むスライドを生成するライブラリの機能を示しています。

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単位を使用します。 さまざまな表示シナリオで画像が正しく表示されるように、位置とサイズを設定するときは、対象のスライドの寸法を考慮してください。

出力

! IronPPT .NETコンポーネントを使用してプログラム的に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メソッドAddSlideプレゼンテーションの最後にスライドを追加しますが、次に示すように、スライドの順序は簡単に変更できます。

出力

! IronPPTライブラリを使用して生成された、テキストコンテンツと埋め込まれたプロモーションバナー画像の両方を備えたPowerPointスライドの例

プレゼンテーションに複数のスライドがある場合、簡単に順序を変更できます。

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 プロパティにより、このプロセスは直感的かつ効率的になります。

出力

! IronPPTを使用してプログラム的に作成されたPowerPointプレゼンテーションの出力例。複数のスライドが表示され、最初のスライドにはサンプルテキストが含まれています。

これで、"スライド 2"というテキストを含むスライドが、プレゼンテーションの 2 番目のスライドとして適切な位置に並べ替えられました。