Implementing.NET MAUI PDF Viewer
A comprehensive skill for implementing and customizing the Syncfusion.NET MAUI PDF Viewer (SfPdfViewer) control. The PDF Viewer provides powerful document viewing and management capabilities including navigation, annotations, form filling, text operations, signatures, redaction, and printing with a built-in customizable toolbar.
When to Use This Skill
Use this skill when you need to:
- View and navigate PDF documents in.NET MAUI applications
- Load PDF documents from application‑provided streams or byte arrays.
- Unload documents to release memory and resources (synchronous/asynchronous methods)
- Add and manage annotations (ink, shapes, stamps, text markups, sticky notes)
- Fill and validate PDF form fields; import/export form data (XFDF, FDF, JSON, XML)
- Search and select text within PDF documents
- Add electronic signatures (handwritten, image-based, text)
- Redact sensitive content permanently
- Print PDF documents with quality settings
- Customize toolbars, appearance, and localization
- Migrate from Xamarin.Forms PDF Viewer to.NET MAUI
Component Overview
SfPdfViewer is a comprehensive PDF viewing and management control for.NET MAUI with these capabilities:
- Document Management: Load with password support, unload (sync/async) for memory management, save with flattening, print with quality settings
- Annotations: Ink, shapes, stamps, sticky notes, text markups, free text, eraser with full editing support
- Forms & Text: All AcroForm types, validation, import/export (XFDF/FDF/JSON/XML), async search, text selection
- Signatures & Redaction: Electronic signatures (handwritten/image/text), text/area/page-based redaction
- Navigation & UI: Page layouts, zoom, bookmarks, hyperlinks, customizable toolbar (desktop/mobile), localization, RTL, liquid glass effect
Documentation and Navigation Guide
Getting Started & Setup
📄 Read: references/basic-sample.md
- Installation, NuGet package, and handler registration (ConfigureSyncfusionCore)
- Basic PDF Viewer implementation (XAML & C#), DocumentSource binding
- Loading PDFs from different sources and platform-specific setup
Document Operations
📄 Read: references/document-operations.md
- Loading PDFs with password support
- Unloading documents (UnloadDocument, UnloadDocumentAsync) for proper memory management
- Saving with modifications and annotation flattening
- Printing with quality settings and page range selection
Annotations
📄 Read: references/annotations.md
- Adding/removing annotations (AddAnnotation, RemoveAnnotation)
- Ink, shapes, stamps, sticky notes, text markups, free text, ink eraser
- Annotation properties (color, opacity, bounds, stroke, rotation) and events
Form Fields
📄 Read: references/form-fields.md
- Viewing, accessing, and filling all AcroForm field types
- Field validation, import/export (XFDF, FDF, JSON, XML), flattening
- Form field events and interaction handling
Navigation & Viewing
📄 Read: references/viewing.md
- Page navigation (GoToPage, PageNumber), layout modes (Single, Continuous)
- Bookmarks, hyperlinks, zoom (ZoomMode, ZoomFactor), FitMode options
- Coordinate conversion (PageToClient, ClientToPage)
Text Search
📄 Read: references/text-search.md
- Async text search (SearchTextAsync), match navigation (GoToNextMatch, GoToPreviousMatch)
- Search highlighting, case-sensitive/whole-word options, custom search UI
Text Selection
📄 Read: references/text-selection.md
- Enabling text selection, SelectedText property, clipboard copy
- Selection customization (colors, opacity), TextSelectionChanged event
Electronic Signatures
📄 Read: references/electronic-signature.md
- Handwritten, image-based, and text signatures
- Signature field management, appearance customization, validation workflows
Redaction
📄 Read: references/redaction.md
- Text/area/page-based redaction (RedactText, RedactArea, RedactPage)
- Permanent content removal, appearance customization, saving redacted documents
Toolbar Customization
📄 Read: references/toolbar-customization.md
- Desktop vs mobile toolbar layouts
- Add/remove/hide/reorder toolbar items, AnnotationToolbarItemClicked event
- Custom toolbar creation and visibility control
UI Settings & Localization
📄 Read: references/ui-settings.md
- Localization, FlowDirection for RTL layouts, culture-specific formatting
- Liquid glass effect, theme customization, platform-specific UI adjustments
Gesture Events & Interaction
📄 Read: references/gesture-events.md
- DocumentTapped event with PageNumber and Position
- Touch gesture handling, custom interactions, event-driven workflows
Migration from Xamarin
📄 Read: references/migration-xamarin-to-maui.md
- API differences, property/method mappings, namespace changes
- Handler registration differences, breaking changes, migration checklist