C# Slide Element Tutorial – IronPPT

Updated: 2026年6月29日

IronPPT 是一款功能強大的 PowerPoint 程式庫，旨在協助 .NET C# 開發人員將建立、讀取及編輯 PowerPoint 簡報的功能無縫整合至其應用程式中。在 PowerPoint 簡報的語境中，投影片是結構化與組織內容的基礎元素。

快速入門：將文字插入新投影片或現有投影片

此範例展示了您如何輕鬆地使用 IronPPT 在投影片中加入文字。只需幾行程式碼，若已有第一張投影片則插入其中，否則直接建立一張，然後節省設定時間，省時省力。

1Install IronPPT with NuGet Package Manager
PM > Install-Package IronPPT
```
Install-Package IronPPT
```

2複製並運行這段程式碼片段。

var doc = new IronPPT.PresentationDocument();
var text = doc.Slides.Count > 0 ? doc.Slides[0].AddText("Quick Option") : doc.Slides.Add(new IronPPT.Models.Slide()).AddText("Quick Option");
doc.Save("quick.pptx");

var doc = new IronPPT.PresentationDocument();
var text = doc.Slides.Count > 0 ? doc.Slides[0].AddText("Quick Option") : doc.Slides.Add(new IronPPT.Models.Slide()).AddText("Quick Option");
doc.Save("quick.pptx");

3部署以在您的實時環境中測試

今天就開始在您的專案中使用IronPPT，透過免費試用

新增文字
- 文字內容（新增、追加與移除）
- 設定樣式（字型家族與大小、顏色、粗體與斜體、刪除線、底線）
新增圖片
- 載入圖片 (File 與 FileStream)
- 設定尺寸與角度（寬度與高度）
- 設定位置
新增形狀
- 設定形狀型別
- 設定尺寸（寬度與高度）
- 設定填充色與輪廓色
- 設定位置

新增文字

文字內容

無論您是製作新的簡報，還是編輯現有的簡報，文字管理工具都能讓您完全掌控文字的排版與格式，讓您設計出能清晰且Professional地傳達訊息的投影片。

using IronPPT;
using IronPPT.Models;

// Create a new PowerPoint presentation
var document = new PresentationDocument();

// Ensure there is at least one slide to work with
if (document.Slides.Count == 0)
{
    document.Slides.Add(new Slide());
}

// Add text to the first slide
var text = document.Slides[0].AddText("Hello");

// Append text to the existing text on the slide
text.Text += " There!";

// Check if there is any text element to remove from the first slide
if (document.Slides[0].Texts.Count > 0)
{
    document.Slides[0].Texts[0].Remove();
}

// Export the PowerPoint presentation with the specified file name
document.Save("addText.pptx");

using IronPPT;
using IronPPT.Models;

// Create a new PowerPoint presentation
var document = new PresentationDocument();

// Ensure there is at least one slide to work with
if (document.Slides.Count == 0)
{
    document.Slides.Add(new Slide());
}

// Add text to the first slide
var text = document.Slides[0].AddText("Hello");

// Append text to the existing text on the slide
text.Text += " There!";

// Check if there is any text element to remove from the first slide
if (document.Slides[0].Texts.Count > 0)
{
    document.Slides[0].Texts[0].Remove();
}

// Export the PowerPoint presentation with the specified file name
document.Save("addText.pptx");

設定樣式

透過文字樣式設定，您可以透過定義字型大小、顏色、樣式、刪除線和底線等屬性，自訂文字的外觀。套用這些樣式可提升文字的呈現效果，並改善文件的整體視覺效果。

using IronPPT;
using IronPPT.Models; // Ensure the library is available
using IronPPT.Enums;

// Create a new presentation document
var document = new PresentationDocument();

// Define and customize the text style
var textStyle = new TextStyle
{
    IsBold = true,                      // Text is bold
    IsItalic = true,                    // Text is italic
    Color = Color.Blue,                 // Text color is blue
    Strike = StrikValue.SingleStrike,   // Text is single struck-off
    Outline = true,                     // Text has an outline
    NoProof = true,                     // Disables proofing for the text
    Spacing = 10.0,                     // Text spacing is set to 10
    Underline = new Underline 
    {
        LineValue = UnderlineValues.Single,   // Single underline
        Color = Color.Red                     // Underline color is red
    },
    Languages = "en-US",               // Text language is set to U.S. English
    SpecVanish = false,                // Text does not vanish when special formatting is applied
};

// Create text content and apply the defined style
var text = new Text("Hello World");   // Instantiate text with a string
text.TextStyle = textStyle;           // Apply the defined style to the text

// Add a new slide if none exist
if (document.Slides.Count == 0)
{
    document.Slides.Add(new Slide());   // Add a new slide to the document
}

// Add the styled text to the first slide
document.Slides[0].AddText(text);      // Add the newly created text object to the first slide

// Save the presentation document to a file
document.Save("textStyle.pptx");        // Save the document with the filename "textStyle.pptx"

using IronPPT;
using IronPPT.Models; // Ensure the library is available
using IronPPT.Enums;

// Create a new presentation document
var document = new PresentationDocument();

// Define and customize the text style
var textStyle = new TextStyle
{
    IsBold = true,                      // Text is bold
    IsItalic = true,                    // Text is italic
    Color = Color.Blue,                 // Text color is blue
    Strike = StrikValue.SingleStrike,   // Text is single struck-off
    Outline = true,                     // Text has an outline
    NoProof = true,                     // Disables proofing for the text
    Spacing = 10.0,                     // Text spacing is set to 10
    Underline = new Underline 
    {
        LineValue = UnderlineValues.Single,   // Single underline
        Color = Color.Red                     // Underline color is red
    },
    Languages = "en-US",               // Text language is set to U.S. English
    SpecVanish = false,                // Text does not vanish when special formatting is applied
};

// Create text content and apply the defined style
var text = new Text("Hello World");   // Instantiate text with a string
text.TextStyle = textStyle;           // Apply the defined style to the text

// Add a new slide if none exist
if (document.Slides.Count == 0)
{
    document.Slides.Add(new Slide());   // Add a new slide to the document
}

// Add the styled text to the first slide
document.Slides[0].AddText(text);      // Add the newly created text object to the first slide

// Save the presentation document to a file
document.Save("textStyle.pptx");        // Save the document with the filename "textStyle.pptx"

新增圖片

請調整圖片設定以獲得最佳顯示效果。正確的配置可確保圖片視覺上美觀且與上下文相符。

using IronPPT;
using IronPPT.Models;
using System.Drawing;

// This script demonstrates the creation of a PowerPoint presentation using the IronPPT library.
// An image is added to the presentation, its properties are modified, and then the presentation is saved.

// Create a new PowerPoint presentation
var document = new PresentationDocument();

// Create a new Image object and load an image file.
var image = new Image();
image.LoadFromFile("sample.png");

// Add the image to the first slide (index 0) of the presentation.
var newImage = document.AddImage(image, 0);

// Set the properties of the added image.
// Position property is set using a Point object, which holds X and Y coordinates.
newImage.Position = new Point(200, 200); // Set image position on the slide
newImage.Angle = 45; // Set the rotation angle of the image
newImage.Name = "new image"; // Assign a descriptive name to the image
newImage.Width = 150; // Set the width of the image in pixels
newImage.Height = 150; // Set the height of the image in pixels

// Export the PowerPoint presentation to a file named "addImage.pptx"
document.Save("addImage.pptx");

using IronPPT;
using IronPPT.Models;
using System.Drawing;

// This script demonstrates the creation of a PowerPoint presentation using the IronPPT library.
// An image is added to the presentation, its properties are modified, and then the presentation is saved.

// Create a new PowerPoint presentation
var document = new PresentationDocument();

// Create a new Image object and load an image file.
var image = new Image();
image.LoadFromFile("sample.png");

// Add the image to the first slide (index 0) of the presentation.
var newImage = document.AddImage(image, 0);

// Set the properties of the added image.
// Position property is set using a Point object, which holds X and Y coordinates.
newImage.Position = new Point(200, 200); // Set image position on the slide
newImage.Angle = 45; // Set the rotation angle of the image
newImage.Name = "new image"; // Assign a descriptive name to the image
newImage.Width = 150; // Set the width of the image in pixels
newImage.Height = 150; // Set the height of the image in pixels

// Export the PowerPoint presentation to a file named "addImage.pptx"
document.Save("addImage.pptx");

Imports IronPPT
Imports IronPPT.Models
Imports System.Drawing

' This script demonstrates the creation of a PowerPoint presentation using the IronPPT library.
' An image is added to the presentation, its properties are modified, and then the presentation is saved.

' Create a new PowerPoint presentation
Private document = New PresentationDocument()

' Create a new Image object and load an image file.
Private image = New Image()
image.LoadFromFile("sample.png")

' Add the image to the first slide (index 0) of the presentation.
Dim newImage = document.AddImage(image, 0)

' Set the properties of the added image.
' Position property is set using a Point object, which holds X and Y coordinates.
newImage.Position = New Point(200, 200) ' Set image position on the slide
newImage.Angle = 45 ' Set the rotation angle of the image
newImage.Name = "new image" ' Assign a descriptive name to the image
newImage.Width = 150 ' Set the width of the image in pixels
newImage.Height = 150 ' Set the height of the image in pixels

' Export the PowerPoint presentation to a file named "addImage.pptx"
document.Save("addImage.pptx")

Imports IronPPT
Imports IronPPT.Models
Imports System.Drawing

' This script demonstrates the creation of a PowerPoint presentation using the IronPPT library.
' An image is added to the presentation, its properties are modified, and then the presentation is saved.

' Create a new PowerPoint presentation
Private document = New PresentationDocument()

' Create a new Image object and load an image file.
Private image = New Image()
image.LoadFromFile("sample.png")

' Add the image to the first slide (index 0) of the presentation.
Dim newImage = document.AddImage(image, 0)

' Set the properties of the added image.
' Position property is set using a Point object, which holds X and Y coordinates.
newImage.Position = New Point(200, 200) ' Set image position on the slide
newImage.Angle = 45 ' Set the rotation angle of the image
newImage.Name = "new image" ' Assign a descriptive name to the image
newImage.Width = 150 ' Set the width of the image in pixels
newImage.Height = 150 ' Set the height of the image in pixels

' Export the PowerPoint presentation to a file named "addImage.pptx"
document.Save("addImage.pptx")

新增圖形

透過定義形狀的型別、尺寸（寬度和高度）、內填色與輪廓色，以及在投影片上的位置，即可輕鬆在簡報中新增並自訂形狀。

using IronPPT;
using IronPPT.Models;
using IronPPT.Enums;

// Load a PowerPoint presentation.
// The PresentationDocument is assumed to represent an entire PPTX file loaded from disk.
var document = new PresentationDocument("output.pptx");

// Configure a new shape.
// Shape is assumed to be a model object representing drawable elements on a slide.
Shape shape = new Shape
{
    Name = "triangle",
    Type = ShapeType.Triangle,
    Width = 100,
    Height = 100,
    FillColor = new Color("#444444"),
    OutlineColor = Color.Black,

    // Position is set via the Position property, which accepts an (x, y) tuple.
    // It's important that these coordinates are valid for display on the slide.
    Position = (200, 200)
};

// Add the shape to the first slide in the presentation.
// Slides[0] refers to the first slide in the collection. Ensure a slide exists at this index.
document.Slides[0].AddShape(shape);

// Export the modified PowerPoint presentation.
// Saves the changes to a new file, ensuring the original presentation is not overwritten.
document.Save("addShape.pptx");

using IronPPT;
using IronPPT.Models;
using IronPPT.Enums;

// Load a PowerPoint presentation.
// The PresentationDocument is assumed to represent an entire PPTX file loaded from disk.
var document = new PresentationDocument("output.pptx");

// Configure a new shape.
// Shape is assumed to be a model object representing drawable elements on a slide.
Shape shape = new Shape
{
    Name = "triangle",
    Type = ShapeType.Triangle,
    Width = 100,
    Height = 100,
    FillColor = new Color("#444444"),
    OutlineColor = Color.Black,

    // Position is set via the Position property, which accepts an (x, y) tuple.
    // It's important that these coordinates are valid for display on the slide.
    Position = (200, 200)
};

// Add the shape to the first slide in the presentation.
// Slides[0] refers to the first slide in the collection. Ensure a slide exists at this index.
document.Slides[0].AddShape(shape);

// Export the modified PowerPoint presentation.
// Saves the changes to a new file, ensuring the original presentation is not overwritten.
document.Save("addShape.pptx");