Export Notes and Handouts

Export speaker notes below slides and create handouts with several slides per PDF page. The notes example omits hidden slides by default; the handout explicitly selects three slides so its final page is partially filled. Check the final partially filled handout page when your slide count is not a multiple of the chosen layout.

Complete C# example

Copy a C# block into Program.cs in a .NET project with Aspose.Slides.NET6.CrossPlatform installed. Each block is a complete program. Run one block at a time. The ZIP contains the IDE-ready project and its verification checks. The copied program writes its files in the current working directory.

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

internal static class Program
{
    private static void Main()
    {
        string? licensePath = Environment.GetEnvironmentVariable("ASPOSE_LICENSE_PATH");
        if (!string.IsNullOrWhiteSpace(licensePath))
            new License().SetLicense(licensePath);

        using var source = CreateSource();
        source.Save("source.pptx", SaveFormat.Pptx);
        var notesOptions = new PdfOptions
        {
            SlidesLayoutOptions = new NotesCommentsLayoutingOptions
            {
                NotesPosition = NotesPositions.BottomFull
            }
        };
        source.Save("notes.pdf", SaveFormat.Pdf, notesOptions);
        var handoutOptions = new PdfOptions
        {
            ShowHiddenSlides = false,
            SlidesLayoutOptions = new HandoutLayoutingOptions
            {
                Handout = HandoutType.Handouts2,
                PrintSlideNumbers = true,
                PrintFrameSlide = true
            }
        };

        // These selected slide positions are one-based.
        int[] handoutSlides = [1, 2, 3];
        source.Save("handout.pdf", handoutSlides, SaveFormat.Pdf, handoutOptions);
        Console.WriteLine("Input summary: three visible slides with notes, one hidden slide.");
        Console.WriteLine("Created notes.pdf and handout.pdf.");
    }

    private static Presentation CreateSource()
    {
        var presentation = new Presentation();
        presentation.SlideSize.SetSize(640, 360, SlideSizeScaleType.DoNotScale);
        var blank = presentation.LayoutSlides.GetByType(SlideLayoutType.Blank);
        string[] labels = ["Alpha", "Bravo", "C", "Hide"];
        for (int i = 0; i < labels.Length; i++)
        {
            var slide = i == 0 ? presentation.Slides[0] : presentation.Slides.AddEmptySlide(blank);
            AddTitle(slide, labels[i]);
            slide.Hidden = i == labels.Length - 1;
            slide.NotesSlideManager.AddNotesSlide().NotesTextFrame.Text = labels[i];
        }

        return presentation;
    }

    private static IAutoShape AddTitle(ISlide slide, string text)
    {
        var title = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 30, 20, 580, 55);
        title.Name = "RecipeTitle";
        title.TextFrame.Text = text;
        title.TextFrame.Paragraphs[0].Portions[0].PortionFormat.FontHeight = 26;
        return title;
    }
}

Expected result

notes.pdf places each visible slide’s notes below that slide. handout.pdf places the three selected slides on two pages, with a frame and slide number for each. The hidden fourth slide is excluded. The console describes the input; the download verification inspects the exported files.

Continue with the detailed guide.

Open and run the complete project

Download the complete project, extract it and open Example.sln, or run:

dotnet restore Example.sln
dotnet run --project Example.csproj --configuration Release -- --mode evaluation

Use the current supported .NET 10 SDK/runtime. The project keeps a stable net8.0 target and accepts compatible stable SDKs; no exact SDK patch is required. Evaluation runs without a license and explicitly ignores license environment settings. It uses bounded fixtures and checks valid output while allowing the evaluation watermark and documented read-back text truncation. For unrestricted checks, use --mode licensed with your authorized ASPOSE_LICENSE_PATH. No license is included.

Inputs are copied from Fixtures into a separate output workspace. The program prints the absolute output path; execution.json records the actual runtime and verified action. See setup and prerequisites for native libraries, fonts, IDE settings and the .NET 8/9 runtime support boundary of 2026-11-10.