1. IronPPT
  2. Tutoriales
  3. Elemento de diapositiva

Tutorial de elementos de diapositivas en C# – IronPPT

Curtis Chau
Curtis Chau
Actualizado:
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.

como-encabezado:2(Inicio Rápido: 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.

Nuget IconEmpieza a crear PDF con NuGet ahora:

  1. Instalar IronPPT con el gestor 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

    Empieza a utilizar 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
Curtis Chau
Curtis Chau
  Chatea con el equipo de ingeniería ahora
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 3,325 | Version: 2025.11 recién lanzado