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