| name | syncfusion-winforms-pdf-viewer |
| description | Create WinForms applications featuring the Syncfusion WinForms PDF Viewer, customized to meet specific user requirements. It supports essential PDF operations such as loading, saving, printing, text search, text extraction, and bookmark or hyperlink navigation. Additional capabilities include zooming, interaction modes, localization, theming, rendering engine selection, and robust error handling, enabling the creation of tailored and fully functional PDF viewing solutions. |
| compatibility | Requires .NET Framework 4.5+ or .NET Core/NET 8+ and Syncfusion.PdfViewer.Windows. |
| metadata | {"author":"Syncfusion Inc","version":"34.1.29"} |
Syncfusion WinForms PdfViewer - UI Sample generator
Generate C# Code for the User's Project (default)
Trigger keywords: "code", "snippet", "how to write", "Program.cs", "show me", "sample", "integrate", "example code", "generate code for", "create sample", "winforms pdfviewer".
Purpose: Generate clean, ready-to-use C# code snippets that directly insert into their WinForms application when working with Syncfusion WinForms PdfViewer control.
Workflow:
- Build the C# code using the snippets provided in the references/*.md files.
- Before generating the sample, ask the user whether the code should be:Integrated into an existing WinForms project, or
Created as a new WinForms application.
- If the user chooses to create a new WinForms project, ask them which target framework they want to use:
-.NET Framework (e.g., 4.6, 4.7, 4.8) — uses Syncfusion.PdfViewer.WinForms and targets the classic .NET Framework.
-.NET / .NET Core (e.g., .NET 8, .NET 10) — uses Syncfusion.PdfViewer.WinForms with net8.0-windows (or the selected version).
- Based on the user's choice:
Generate the .csproj file with the correct value.
Add the required NuGet packages.
Tailor any framework-specific code, such as namespace imports, form initialization, startup code (Program.cs), and PDF Viewer setup, accordingly.
- Add only the APIs required to satisfy the user's requested functionality. Do not include optional APIs, additional.
Code References
All templates and snippets are in the references/ folder. Each file is a focused snippet or template the agent will combine when generating sample:
| File | Contents |
|---|
| view-pdfviewer.md | NuGet setup, add PdfViewerControl/PdfDocumentView, load PDF |
| saving-pdf-files.md | Save PDF via toolbar, programmatic save using LoadedDocument.Save(), BeginSave and EndSave events |
| printing-pdf-files.md | Print PDF via toolbar, silent printing using Print(), customize print size (ActualSize, Fit, CustomScale), print orientation (Auto, Portrait, Landscape), hide print status dialog, BeginPrint, PrintProgress, and EndPrint events |
| extract-text.md | Extract text from a single page using ExtractText(pageIndex, out textLines), extract text from entire file using PageCount loop, extract text with line bounds via TextLines/TextLine, extract words with bounds via WordCollection/TextWord |
| pdf-rendering-engines.md | Switch rendering engine using RenderingEngine property (PDFium default, SfPdf alternative), set custom PDFium binary path via ReferencePath for restricted-access environments |
| searching-text.md | Search next/previous text instance using SearchNextText()/SearchPreviousText(), find all instances with bounds using FindText(), count total matches, enable/disable highlight all instances via TextSearchSettings.HighlightAllInstance, customize highlight colors via TextSearchSettings.CurrentInstanceColor/OtherInstanceColor |
| navigation.md | Bookmark navigation, hyperlink handling, and page navigation (programmatic GoToBookmark(), HyperlinkClicked/HyperlinkMouseOver, GoToPageAtIndex()) |
Prerequisites
- Development Environment:Visual Studio 2022 or Visual Studio insider 2026(recommended for .NET 10).
- .NET Framework 4.5+ or .NET Core/NET 8+
- Syncfusion WinForms NuGet Package: Syncfusion.PdfViewer.Windows
Documentations
