Slide Element Tutorial

更新日:6月 9, 2025

Translated

View the article in English

IronPPTは、.NET C#開発者がPowerPointプレゼンテーションを作成、読み込み、編集する機能をアプリケーションにシームレスに統合できるように設計された堅牢なPowerPointライブラリです。 PowerPointのプレゼンテーションでは、スライドはコンテンツを構成し、整理する基本的な要素です。

クイックスタート: 新規または既存のスライドにテキストを挿入する

この例では、IronPPTでいかに簡単にスライドにテキストを追加できるかを示しています。わずか2、3行で、最初のスライドに挿入するか、スライドを作成し、保存します。

Install IronPPT with NuGet Package Manager

PM > Install-Package IronPPT

Copy and run this code snippet.

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

Deploy to test on your live environment

Start using IronPPT in your project today with a free trial

Free 30 day Trial

テキストを追加する。
- テキストコンテンツ (追加、追加、削除)
- スタイル設定（フォントファミリーとサイズ、色、太字と斜体、取り消し線、下線）。
画像を追加する
- 画像を読み込む (File & FileStream)
- 寸法と角度を設定する (幅と高さ)
- ポジションを設定する。
形状を追加する。
- シェイプタイプを設定する。
- 寸法を設定する (幅と高さ)
- 塗りつぶしと輪郭の色を設定する。
- 位置を設定する。

テキストを追加する

テキストコンテンツ

新しいプレゼンテーションを作成する場合でも、既存のプレゼンテーションを編集する場合でも、テキスト管理ツールを使用すると、テキストの配置や書式を完全に制御できるため、メッセージを明確かつプロフェッショナルに伝えるスライドをデザインできます。

: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

Curtis Chau

今すぐエンジニアリングチームとチャット

テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT（Internet of Things）への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はいいですか?

Nuget ダウンロード 3,171 | バージョン: 2025.11 ただ今リリースされました