Introducción a IronPPT
IronPowerPoint: Biblioteca de PowerPoint para .NET
IronPPT es una biblioteca de PowerPoint desarrollada por Iron Software. Destaca en proporcionar una funcionalidad robusta para trabajar con presentaciones de PowerPoint en aplicaciones .NET.
- Cargar, manipular y guardar presentaciones de PowerPoint. Trabaje fácilmente con archivos .pptx y .ppt.
- Configuración de diapositiva: configure el tamaño de la diapositiva, orientación, color de fondo y diseño.
- Texto: Maneje el contenido de texto, estilos, división, adición de texto y adición de cuadros de texto.
- Estilo de texto: Gestione la familia de fuentes, tamaño, color, negrita, cursiva, subrayado y alineación.
- Formas: Añadir y manipular formas, incluyendo tamaño, posición, tipo y rotación.
- Imágenes: Insertar imágenes en diapositivas con opciones de escalado, alineamiento y posicionamiento.
Biblioteca C# de presentaciones de PowerPoint para .NET
- Descargue la biblioteca C# para manejar presentaciones de PowerPoint
- Crear y modificar documentos .pptx o .ppt
- Administrar propiedades de diapositivas como orden, visibilidad y rotación de contenido
- Agregue elementos de diapositiva como texto, imágenes y formas
- Dale estilo al contenido con facilidad
Instalación
Biblioteca IronPPT
Instalar IronPPT es rápido y sencillo. Agregue el paquete utilizando el siguiente método:
Install-Package IronPPT
Alternativamente, puede descargarlo directamente desde el sitio web oficial de IronPPT NuGet.
Después de la instalación, simplemente incluya using IronPPT; al inicio de su código C# para comenzar.
Aplicar clave de licencia
Para usar IronPPT, aplique una clave de licencia válida o de prueba configurando la propiedad LicenseKey. Agregue el siguiente código inmediatamente después de la declaración de importación y antes de llamar a cualquier método de IronPPT:
:path=/static-assets/ppt/content-code-examples/get-started/get-started-license.cs/// <summary>
/// This code sets the license key for the IronPPT library.
/// Ensure you have the correct namespace access by installing the IronPPT NuGet package
/// and adjust the license key appropriately for your use case.
/// </summary>
using System; // Required for Console output
using IronPPT; // Ensure the IronPPT library is referenced in your project.
namespace IronPPTApplication
{
class Program
{
public static void Main(string[] args)
{
// Calling the method to set the IronPPT license key.
SetIronPPTLicense();
}
/// <summary>
/// Sets the license key for the IronPPT library to unlock its full features.
/// </summary>
private static void SetIronPPTLicense()
{
// Correctly setting the license for the IronPPT library.
// Replace "IRONPPT.MYLICENSE.KEY.1EF01" with your actual key.
IronPPT.License.LicenseKey = "IRONPPT.MYLICENSE.KEY.1EF01";
// Inform the user that the license key has been set.
Console.WriteLine("IronPPT license key has been set.");
}
}
}''' <summary>
''' This code sets the license key for the IronPPT library.
''' Ensure you have the correct namespace access by installing the IronPPT NuGet package
''' and adjust the license key appropriately for your use case.
''' </summary>
Imports System ' Required for Console output
Imports IronPPT ' Ensure the IronPPT library is referenced in your project.
Namespace IronPPTApplication
Friend Class Program
Public Shared Sub Main(ByVal args() As String)
' Calling the method to set the IronPPT license key.
SetIronPPTLicense()
End Sub
''' <summary>
''' Sets the license key for the IronPPT library to unlock its full features.
''' </summary>
Private Shared Sub SetIronPPTLicense()
' Correctly setting the license for the IronPPT library.
' Replace "IRONPPT.MYLICENSE.KEY.1EF01" with your actual key.
IronPPT.License.LicenseKey = "IRONPPT.MYLICENSE.KEY.1EF01"
' Inform the user that the license key has been set.
Console.WriteLine("IronPPT license key has been set.")
End Sub
End Class
End NamespaceEjemplos de código
Exploremos algunos ejemplos de código y las funciones disponibles.
Crear archivo de PowerPoint
Cree la presentación de PowerPoint instanciando la clase PresentationDocument usando uno de sus constructores. Utilice los métodos AddSlide y AddText para agregar diapositivas y texto, respectivamente. Después de eso, utilice el método Save para exportar la presentación de PowerPoint.
:path=/static-assets/ppt/content-code-examples/get-started/get-started-1.csusing IronPPT;
// This code demonstrates the creation of a PowerPoint presentation and saving it as a file.
// Create a new PowerPoint presentation document
var document = new PresentationDocument();
// Create a new slide object
var slide = new Slide();
// Add text content to the slide
slide.AddText("Hello!");
// Add the newly created slide with text to the document
document.AddSlide(slide);
// Export the PowerPoint presentation to a file named "output.pptx"
document.Save("output.pptx");Imports IronPPT
' This code demonstrates the creation of a PowerPoint presentation and saving it as a file.
' Create a new PowerPoint presentation document
Private document = New PresentationDocument()
' Create a new slide object
Private slide = New Slide()
' Add text content to the slide
slide.AddText("Hello!")
' Add the newly created slide with text to the document
document.AddSlide(slide)
' Export the PowerPoint presentation to a file named "output.pptx"
document.Save("output.pptx")Añadir forma
Puede utilizar el método AddShape de un objeto de diapositiva para agregar formas. Se pueden configurar varias propiedades de la forma, como color de relleno, color de contorno, posición, ángulo, tipo y más.
:path=/static-assets/ppt/content-code-examples/get-started/get-started-2.csusing IronPPT;
using IronPPT.Drawing; // Assuming this namespace contains `Shape` and `Color` classes
using IronPPT.Enums; // Assuming this namespace contains the `ShapeType` enum
// Load a PowerPoint presentation from the specified file
var document = new PresentationDocument("output.pptx");
// Create and configure a new shape, in this case, a triangle
Shape shape = new Shape
{
Name = "triangle", // Assign a name to the shape
Type = ShapeType.Triangle, // Set the shape type to Triangle
Width = 100, // Set the width of the shape
Height = 100, // Assumed height for the shape, should be set for visibility
FillColor = new Color("#444444"), // Set the fill color of the shape
OutlineColor = Color.Black, // Set the outline color to black
Position = new System.Drawing.Point(200, 200) // Set the position of the shape
};
// Ensure that the slides array has at least one slide to add the shape to
if (document.Slides.Count > 0)
{
// Add the shape to the first slide
document.Slides[0].AddShape(shape);
}
else
{
// If there are no slides, handle the error or add a slide
document.Slides.Add(new Slide()); // Assuming there's a way to add new slides
document.Slides[0].AddShape(shape); // Add the shape to the newly added slide
}
// Export the PowerPoint presentation to a new file
document.Save("addShape.pptx");Imports IronPPT
Imports IronPPT.Drawing ' Assuming this namespace contains `Shape` and `Color` classes
Imports IronPPT.Enums ' Assuming this namespace contains the `ShapeType` enum
' Load a PowerPoint presentation from the specified file
Private document = New PresentationDocument("output.pptx")
' Create and configure a new shape, in this case, a triangle
Private shape As New Shape With {
.Name = "triangle",
.Type = ShapeType.Triangle,
.Width = 100,
.Height = 100,
.FillColor = New Color("#444444"),
.OutlineColor = Color.Black,
.Position = New System.Drawing.Point(200, 200)
}
' Ensure that the slides array has at least one slide to add the shape to
If document.Slides.Count > 0 Then
' Add the shape to the first slide
document.Slides(0).AddShape(shape)
Else
' If there are no slides, handle the error or add a slide
document.Slides.Add(New Slide()) ' Assuming there's a way to add new slides
document.Slides(0).AddShape(shape) ' Add the shape to the newly added slide
End If
' Export the PowerPoint presentation to a new file
document.Save("addShape.pptx")Añadir imagen
Agregar una imagen a cualquier diapositiva también es una tarea sencilla. El siguiente ejemplo de código agrega una imagen a la primera diapositiva, modifica las propiedades de la imagen como posición, ángulo, nombre, ancho y altura, y luego guarda la presentación actualizada como un archivo .pptx.
:path=/static-assets/ppt/content-code-examples/get-started/get-started-3.csusing IronPPT;
using System.Drawing;
// This code demonstrates creating a new PowerPoint presentation, adding an image to it,
// modifying the image's properties, and exporting the presentation.
// Create a new PowerPoint presentation
var document = new PresentationDocument();
// Ensure there's at least one slide in the presentation
// Create the first slide if it doesn't exist yet
if (document.Slides.Count == 0)
{
document.Slides.Add();
}
// Initialize an Image object
// Load an image from a file specified by the file path
// Ensure that "sample.png" exists at the specified path
Image image = new Image();
image.LoadFromFile("sample.png");
// Add the image to the first slide of the presentation
var newImage = document.Slides[0].AddImage(image);
// Edit the image's properties
// Set the position of the image using X and Y coordinates
newImage.Position = new Point(200, 200);
// Set the rotation angle of the image in degrees
newImage.Angle = 45;
// Set a name for the image, which can be useful for identification
newImage.Name = "new image";
// Set the dimensions of the image
newImage.Width = 150;
newImage.Height = 150;
// Export the PowerPoint presentation with the new image
document.Save("addImage.pptx");Imports IronPPT
Imports System.Drawing
' This code demonstrates creating a new PowerPoint presentation, adding an image to it,
' modifying the image's properties, and exporting the presentation.
' Create a new PowerPoint presentation
Private document = New PresentationDocument()
' Ensure there's at least one slide in the presentation
' Create the first slide if it doesn't exist yet
If document.Slides.Count = 0 Then
document.Slides.Add()
End If
' Initialize an Image object
' Load an image from a file specified by the file path
' Ensure that "sample.png" exists at the specified path
Dim image As New Image()
image.LoadFromFile("sample.png")
' Add the image to the first slide of the presentation
Dim newImage = document.Slides(0).AddImage(image)
' Edit the image's properties
' Set the position of the image using X and Y coordinates
newImage.Position = New Point(200, 200)
' Set the rotation angle of the image in degrees
newImage.Angle = 45
' Set a name for the image, which can be useful for identification
newImage.Name = "new image"
' Set the dimensions of the image
newImage.Width = 150
newImage.Height = 150
' Export the PowerPoint presentation with the new image
document.Save("addImage.pptx")Licencias y soporte disponibles
IronPPT es una biblioteca comercial, pero se encuentran licencias de prueba gratuitas disponibles.
Para obtener más detalles sobre Iron Software, visite nuestro sitio web en: https://ironsoftware.com/. Si necesita apoyo o tiene alguna consulta, por favor contacte a nuestro equipo.
Soporte de software de hierro
Para asistencia general y preguntas técnicas, siéntase libre de enviarnos un correo electrónico a: support@ironsoftware.com.







