`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庫主頁展示了一個實用的C#程式碼範例，示範如何使用.NET API建立PowerPoint簡報、新增投影片和儲存文件。

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 類別提供了從各種來源載入影像的方法，定位系統使用標準單位。 設定位置和大小時，請記住考慮目標投影片的尺寸，以確保影像在不同的顯示場景中正確顯示。

輸出

首先，讓我們使用以下程式碼範例為簡報新增投影片：

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 屬性使這個過程直觀且有效率。

輸出

現在，帶有"幻燈片二"字樣的幻燈片已重新排列到正確的位置，成為我們簡報中的第二張幻燈片。