C# 投影片元素教學 – IronPPT

Curtis Chau

更新:1月 10, 2026

Translated

View the article in English

IronPPT 是一個強大的 PowerPoint 庫，旨在幫助 .NET C# 開發人員將創建、讀取和編輯 PowerPoint 簡報的功能無縫整合到他們的應用程式中。在 PowerPoint 簡報中，投影片是建立和組織內容的基礎元素。

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

這個例子展示了使用 IronPPT 如何輕鬆地在投影片中新增文字。只需幾行程式碼，即可將其插入到第一張投影片中（如果存在），或建立新投影片，然後儲存－設定快速，操作簡單。

使用 NuGet 套件管理器安裝 IronPPT
PM > Install-Package IronPPT

複製並運行這段程式碼。

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");

部署到您的生產環境進行測試
立即開始在您的專案中使用 IronPPT，免費試用！
免費試用30天

-新增文字 -文字內容（新增、追加和刪除） -設定樣式（字型和字號、顏色、粗體和斜體、刪除線、底線） -新增圖片 -載入圖片（檔案和檔案流） -設定尺寸和角度（寬度和高度） -設定位置 -新增形狀 -設定形狀類型 -設定尺寸（寬度和高度） -設定填滿和輪廓顏色 -設定位置

新增文字

文字內容

無論您是建立新的簡報還是編輯現有的簡報，文字管理工具都能讓您完全控製文字的位置和格式，從而設計出清晰、專業地傳達訊息的幻燈片。

:path=/static-assets/ppt/content-code-examples/tutorials/slide-element-add-text.cs

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.Content += " 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");

Imports IronPPT
Imports IronPPT.Models

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

' Ensure there is at least one slide to work with
If document.Slides.Count = 0 Then
	document.Slides.Add(New Slide())
End If

' Add text to the first slide
Dim text = document.Slides(0).AddText("Hello")

' Append text to the existing text on the slide
text.Content &= " There!"

' Check if there is any text element to remove from the first slide
If document.Slides(0).Texts.Count > 0 Then
	document.Slides(0).Texts(0).Remove()
End If

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

$vbLabelText $csharpLabel

造型

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

:path=/static-assets/ppt/content-code-examples/tutorials/slide-element-text-style.cs

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

// 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 = StrikeValue.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"

Imports IronPPT
Imports IronPPT.Models ' Ensure the library is available

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

' Define and customize the text style
Private textStyle = New TextStyle With {
	.IsBold = True,
	.IsItalic = True,
	.Color = Color.Blue,
	.Strike = StrikeValue.SingleStrike,
	.Outline = True,
	.NoProof = True,
	.Spacing = 10.0,
	.Underline = New Underline With {
		.LineValue = UnderlineValues.Single,
		.Color = Color.Red
	},
	.Languages = "en-US",
	.SpecVanish = False
}

' Create text content and apply the defined style
Private 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 Then
	document.Slides.Add(New Slide()) ' Add a new slide to the document
End If

' 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"

$vbLabelText $csharpLabel

新增圖片

調整影像設定以獲得最佳顯示效果。正確的配置可確保圖像在視覺上吸引人，並與其上下文相符。

:path=/static-assets/ppt/content-code-examples/tutorials/slide-element-add-image.cs

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")

$vbLabelText $csharpLabel

添加形狀

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

:path=/static-assets/ppt/content-code-examples/tutorials/slide-element-add-shape.cs

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,
    FillColor = new Color("#444444"),
    OutlineColor = Color.Black,

    // Position is set via assumed X and Y positioning properties.
    // It's important that these properties are set to valid coordinates for display on the slide.
    XPosition = 200,
    YPosition = 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");

Imports IronPPT
Imports IronPPT.Models
Imports IronPPT.Enums

' Load a PowerPoint presentation.
' The PresentationDocument is assumed to represent an entire PPTX file loaded from disk.
Private document = New PresentationDocument("output.pptx")

' Configure a new shape.
' Shape is assumed to be a model object representing drawable elements on a slide.
Private shape As New Shape With {
	.Name = "triangle",
	.Type = ShapeType.Triangle,
	.Width = 100,
	.FillColor = New Color("#444444"),
	.OutlineColor = Color.Black,
	.XPosition = 200,
	.YPosition = 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")

$vbLabelText $csharpLabel