Darmowa biblioteka C# .NET do generowania PowerPoint PPTX z szablonu

Rozpoczęcie pracy z PPTXTemplater

Zalecanym sposobem instalacji PPTXTemplater jest użycie GitHub. Proszę użyć następującego polecenia, aby przeprowadzić płynną instalację.

 git clone https://github.com/tkrotoff/PptxTemplater.git

Generowanie plików PPTX na podstawie szablonu przy użyciu C#

Podstawą PptxTemplater jest podejście oparte na szablonach. Zaczynasz od stworzenia standardowej prezentacji PowerPoint, która będzie służyć jako szablon. W tym szablonie możesz definiować miejsca zastępcze dla dynamicznej treści, używając prostej i intuicyjnej składni, zazwyczaj {{placeholder_name}}. To pozwala projektować slajdy bezpośrednio w PowerPoint, dając pełną kontrolę nad wizualnymi aspektami prezentacji. Oto prosty przykład, który pokazuje, jak stworzyć szablon PowerPoint z dwoma slajdami przy użyciu biblioteki C#?

const string srcFileName = "template.pptx";
const string dstFileName = "final.pptx";
File.Delete(dstFileName);
File.Copy(srcFileName, dstFileName);

Pptx pptx = new Pptx(dstFileName, FileAccess.ReadWrite);
int nbSlides = pptx.SlidesCount();
Assert.AreEqual(2, nbSlides);

// First slide
{
    PptxSlide slide = pptx.GetSlide(0);
    slide.ReplaceTag("{{hello}}", "HELLO HOW ARE YOU?", PptxSlide.ReplacementType.Global);
    slide.ReplaceTag("{{bonjour}}", "BONJOUR TOUT LE MONDE", PptxSlide.ReplacementType.Global);
    slide.ReplaceTag("{{hola}}", "HOLA MAMA QUE TAL?", PptxSlide.ReplacementType.Global);
}

// Second slide
{
    PptxSlide slide = pptx.GetSlide(1);
    slide.ReplaceTag("{{hello}}", "H", PptxSlide.ReplacementType.Global);
    slide.ReplaceTag("{{bonjour}}", "B", PptxSlide.ReplacementType.Global);
    slide.ReplaceTag("{{hola}}", "H", PptxSlide.ReplacementType.Global);
}

Zastępowanie tekstu w prezentacji PPTX przy użyciu C#

Jedną z najważniejszych funkcji PptxTemplater jest możliwość zastępowania miejsc zastępczych tekstu Twoimi danymi. Jest to niezwykle przydatne do personalizacji prezentacji za pomocą imion, dat, liczb i innych informacji tekstowych. Oto prosty przykład, który pokazuje, jak programiści mogą zamieniać tekst w prezentacji PPTX w aplikacjach C# .NET.

using PptxTemplater;

// Load the template
using (var presentation = new Presentation("template.pptx"))
{
    // Define the data
    var data = new Dictionary
    {
        { "name", "John Doe" },
        { "date", DateTime.Now.ToShortDateString() }
    };

    // Fill the template
    presentation.Fill(data);

    // Save the new presentation
    presentation.SaveAs("output.pptx");
}

Zastępowanie obrazów w prezentacji PPTX przy użyciu C#

Biblioteka open source PptxTemplater nie ogranicza się tylko do tekstu. Programiści mogą również wymieniać obrazy w swoich szablonach przy użyciu zaledwie kilku linii kodu. Jest to szczególnie przydatne przy generowaniu katalogów produktów, identyfikatorów pracowników lub innych prezentacji wymagających dynamicznych obrazów. Oto prosty przykład pokazujący, jak wymienić obrazy w prezentacjach PPTX. Aby wymienić obraz, najpierw musisz dodać obraz zastępczy w szablonie i nadać mu określoną nazwę (np. "photo1").

// Assuming you have a slide with an image named "photo1"
var slide = presentation.Slides[0];
slide.ReplacePicture("photo1", "new_image.png");

Dodawanie, usuwanie lub klonowanie slajdu przy użyciu C#

Biblioteka open source PptxTemplater daje Ci szczegółową kontrolę nad slajdami w prezentacji. Możesz klonować istniejące slajdy, aby tworzyć dynamiczne sekcje, lub usuwać slajdy, które nie są potrzebne w oparciu o Twoje dane. Co więcej, możliwe jest także dodawanie nowych slajdów i usuwanie niechcianych. Poniższy przykład pokazuje, jak klonować lub usuwać slajd w aplikacjach C#.

/// Clone a slide
var newSlide = presentation.CloneSlide(0);

// Remove a slide
presentation.RemoveSlide(1);