C# Slide Element Tutorial – IronPPT

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPPT es una biblioteca de PowerPoint robusta diseñada para ayudar a los desarrolladores de .NET C# a integrar sin esfuerzo la capacidad de crear, leer y editar presentaciones de PowerPoint en sus aplicaciones. En el contexto de una presentación de PowerPoint, las diapositivas son los elementos fundamentales que estructuran y organizan el contenido.

Guía Rápida: Insertar texto en una diapositiva nueva o existente

Este ejemplo muestra lo fácilmente que puedes agregar texto a una diapositiva con IronPPT. En solo un par de líneas, inserta en la primera diapositiva si existe o crea una, luego guarda ‒ configuración rápida, mínimo alboroto.

  1. Instala IronPPT con el Administrador de Paquetes NuGet

    PM > Install-Package IronPPT
  2. Copie y ejecute este fragmento de código.

    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. Despliegue para probar en su entorno real

    Comienza a usar IronPPT en tu proyecto hoy mismo con una prueba gratuita

    arrow pointer

Tabla de contenido

Agregar texto

Contenido del texto

Ya sea que estés creando una nueva presentación o editando una existente, las herramientas de gestión de texto te brindan control total sobre la colocación y el formato del texto, permitiéndote diseñar diapositivas que transmitan tu mensaje de manera clara y profesional.

: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

Establecer estilo

Estilizar el texto te permite personalizar su apariencia visual definiendo atributos como el tamaño de fuente, color, estilo, tachado y subrayado. Aplicar estos estilos mejora la presentación del texto y mejora el aspecto general del documento.

: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

Agregar imágenes

Ajusta la configuración de imágenes para visualización óptima. La configuración adecuada asegura que las imágenes sean visualmente atractivas y adecuadas a su contexto.

: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

Agregar formas

Agrega y personaliza fácilmente formas en tu presentación definiendo su tipo, dimensiones (ancho y alto), colores de relleno y contorno, y posición en la diapositiva.

: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

Preguntas Frecuentes

¿Para qué se utiliza IronPPT?

IronPPT es una biblioteca integral de PowerPoint para desarrolladores de .NET C#, que les permite crear, leer y editar presentaciones de PowerPoint sin problemas dentro de sus aplicaciones.

¿Cómo agrego texto a una diapositiva usando IronPPT?

Para añadir texto a una diapositiva usando IronPPT, simplemente puedes usar un par de líneas de código para insertar texto en una diapositiva existente o crear una nueva, y luego guardar la presentación.

¿Puedo personalizar el estilo del texto en IronPPT?

Sí, IronPPT te permite personalizar el estilo del texto definiendo atributos como tamaño de fuente, color, estilo, tachado y subrayado para mejorar la apariencia del texto.

¿Cómo puedo añadir imágenes a una presentación de PowerPoint con IronPPT?

IronPPT proporciona herramientas para cargar imágenes desde archivos o FileStreams y configurar sus dimensiones, ángulo y posición para asegurar una visualización óptima en tus presentaciones.

¿Es posible añadir formas en IronPPT?

Sí, puedes añadir y personalizar formas en IronPPT definiendo su tipo, dimensiones, colores de relleno y contorno, y posición en la diapositiva.

¿IronPPT soporta la edición de presentaciones de PowerPoint existentes?

IronPPT te permite tanto crear nuevas presentaciones como editar las existentes, dándote control total sobre el contenido y el formato.

¿Puedo establecer la posición del texto y las imágenes en IronPPT?

Sí, IronPPT te permite establecer la posición de texto y las imágenes en las diapositivas, permitiendo una colocación precisa para ajustarse al diseño de tu presentación.

¿Qué formatos de archivo se soportan para la inserción de imágenes en IronPPT?

IronPPT soporta la inserción de imágenes desde varios formatos de archivo, asegurando compatibilidad con los activos visuales de tu presentación.

¿Cómo mejora IronPPT el atractivo visual de la presentación?

IronPPT mejora el atractivo visual proporcionando herramientas para personalizar el estilo del texto, configuraciones de imagen y diseños de formas, asegurando una apariencia profesional de la presentación.

¿Es IronPPT compatible con diferentes versiones de PowerPoint?

IronPPT está diseñado para ser compatible con varias versiones de PowerPoint, permitiendo una integración fluida en tus aplicaciones de C#.

Curtis Chau
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Nuget Descargas 5,142 | Versión: 2026.5 just released
Still Scrolling Icon

¿Aún desplazándote?

¿Quieres una prueba rápida? PM > Install-Package IronPPT
ejecuta una muestra y observa cómo tu PDF se convierte en texto editable.