Primeiros passos com o IronPPT

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

IronPowerPoint: Biblioteca PowerPoint for .NET

IronPPT é uma biblioteca para PowerPoint desenvolvida pela Iron Software. Destaca-se por oferecer funcionalidades robustas para trabalhar com apresentações do PowerPoint em aplicações .NET .

  • Carregar, manipular e salvar apresentações do PowerPoint. Trabalhe facilmente com arquivos .pptx e .ppt.
  • Configuração de slides: Configure o tamanho, a orientação, a cor de fundo e o layout dos slides.
  • Texto: Manipular conteúdo de texto, estilos, divisão, anexação de texto e adição de caixas de texto.
  • Estilo do texto: Gerencie a família da fonte, tamanho, cor, negrito, itálico, sublinhado e alinhamento.
  • Formas: Adicione e manipule formas, incluindo definir tamanho, posição, tipo e rotação.
  • Imagens: Insira imagens nos slides com opções de dimensionamento, alinhamento e posicionamento.

Instalação

Biblioteca IronPPT

A instalação do IronPPT é rápida e simples. Adicione o pacote usando o seguinte método:

Install-Package IronPPT

Alternativamente, você pode baixá-lo diretamente do site oficial do IronPPT no NuGet .

Após a instalação, simplesmente inclua using IronPPT; no início do seu código C# para começar.

Aplicando a chave de licença

Para usar o IronPPT, aplique uma licença válida ou uma chave de avaliação definindo a propriedade LicenseKey . Adicione o seguinte código imediatamente após a declaração de importação e antes de chamar qualquer método do 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.");
        }
    }
}
$vbLabelText   $csharpLabel

Exemplos de código

Vamos explorar alguns exemplos de código e os recursos disponíveis.

Criar arquivo PowerPoint

Crie a apresentação PowerPoint instanciando a classe PresentationDocument usando um de seus construtores. Use os métodos AddSlide e AddText para adicionar slides e texto, respectivamente. Depois disso, use o método Save para exportar a apresentação PowerPoint.

:path=/static-assets/ppt/content-code-examples/get-started/get-started-1.cs
using 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");
$vbLabelText   $csharpLabel

Adicionar forma

Você pode usar o método AddShape de um objeto de slide para adicionar formas. Várias propriedades da forma podem ser configuradas, como cor de preenchimento, cor do contorno, posição, ângulo, tipo, e mais.

:path=/static-assets/ppt/content-code-examples/get-started/get-started-2.cs
using 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");
$vbLabelText   $csharpLabel

Adicionar imagem

Adicionar uma imagem a qualquer slide também é uma tarefa simples. O exemplo de código abaixo adiciona uma imagem ao primeiro slide, modifica as propriedades da imagem, como posição, ângulo, nome, largura e altura, e então salva a apresentação atualizada como um arquivo .pptx.

:path=/static-assets/ppt/content-code-examples/get-started/get-started-3.cs
using 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");
$vbLabelText   $csharpLabel

Licenciamento e suporte disponíveis

IronPPT é uma biblioteca comercial, mas licenças de avaliação gratuitas estão disponíveis.

Para obter mais detalhes sobre a Iron Software, visite nosso site em:https://ironsoftware.com/ . Se precisar de ajuda ou tiver alguma dúvida, entre em contato com nossa equipe .

Suporte do Iron Software

Para assistência geral e questões técnicas, entre em contato conosco pelo e-mail:support@ironsoftware.com .

Curtis Chau
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais
Pronto para começar?
Nuget Downloads 4,319 | Versão: 2026.3 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronPPT
executar um exemplo Veja seu PDF se transformar em texto editável.