Syncfusion is excited to announce the availability of another valuable control,PDF Viewer, for the.NET MAUI platform in the2022 Volume 4 release.

The new .NET MAUI PDF Viewer control allows you to easily add PDF viewing capabilities within your applications. It is supported in Windows, macOS, iOS, and Android platforms.

In this blog, we’ll explore the features of the .NET MAUI PDF Viewer and the steps to get started with it.

Key features

The key features of the new .NET MAUI PDF Viewer are:

• Virtual scrolling : Easily scroll through the pages in a PDF document with a fluent experience. The pages are rendered on demand in order to enhance the loading and scrolling performance.
• Magnification : The content of a PDF document can be efficiently zoomed in and out by pinching or changing the zoom factor programmatically.
• Page navigation : Navigate to the desired pages instantly using the programmatic page navigation or by dragging the scroll box in the UI.
• Opening password-protected PDFs : Load and view password-protected PDFs in a hassle-free way. Also, you can design a custom password request view and integrate the functionality easily with built-in options.

Getting started with .NET MAUI PDF Viewer

Let’s see how to integrate the Syncfusion .NET MAUI PDF Viewer control in your application and use its basic features.

Creating a .NET MAUI application with the PDF Viewer

Step 1: First, create anew .NET MAUI application inVisual Studio.

Step 2: Then, add theSyncfusion.Maui.PdfViewer NuGet package reference to your project from theNuGet Gallery.

Step 3 : Then, register the handler for the Syncfusion core package in theMauiProgram.cs file. Refer to the following code.

usingSyncfusion.Maui.Core.Hosting;namespacePdfViewerExample{publicstaticclassMauiProgram{publicstaticMauiAppCreateMauiApp(){varbuilder=MauiApp.CreateBuilder();builder.UseMauiApp<App>().ConfigureFonts(fonts=>{fonts.AddFont("OpenSans-Regular.ttf","OpenSansRegular");fonts.AddFont("OpenSans-Semibold.ttf","OpenSansSemibold");});builder.ConfigureSyncfusionCore();returnbuilder.Build();}}}

Step 4: Add a new folder to the project namedAssets and add the PDF document you want to view (such asPDF_Succinctly.pdf ) using the PDF Viewer.

Note: You can also load PDF files fromlocal storage or aURL.

Step 5: We are going to use the MVVM binding technique. So, create a new view model class namedPdfViewerViewModel.cs and add the following code to it.

usingSystem.ComponentModel;usingSystem.Reflection;namespacePdfViewerExample{internalclassPdfViewerViewModel:INotifyPropertyChanged{privateStream?m_pdfDocumentStream;/// <summary>/// An event to detect the change in the value of a property./// </summary>publiceventPropertyChangedEventHandler?PropertyChanged;/// <summary>/// The PDF document stream that is loaded into the instance of the PDF viewer./// </summary>publicStreamPdfDocumentStream{get{returnm_pdfDocumentStream;}set{m_pdfDocumentStream=value;OnPropertyChanged("PdfDocumentStream");}}/// <summary>/// Constructor of the view model class./// </summary>publicPdfViewerViewModel(){//Accessing the PDF document that is added as an embedded resource as a stream.m_pdfDocumentStream=typeof(App).GetTypeInfo().Assembly.GetManifestResourceStream("PdfViewerExample.Assets.PDF_Succinctly.pdf");}publicvoidOnPropertyChanged(stringname){PropertyChanged?.Invoke(this,newPropertyChangedEventArgs(name));}}}

Step 6: In theMainPage.xaml page, import the control namespaceSyncfusion.Maui.PdfViewer , initialize theSfPdfViewer control, and bind the createdPdfDocumentStream to theSfPdfViewer.DocumentSourceproperty. Refer to the following code example.

Note: TheDocumentSource property accepts both stream and byte[] instances.

<?xml version="1.0" encoding="utf-8" ?><ContentPagexmlns="http://schemas.microsoft.com/dotnet/2021/maui"xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"xmlns:syncfusion="clr-namespace:Syncfusion.Maui.PdfViewer;assembly=Syncfusion.Maui.PdfViewer"xmlns:local="clr-namespace:PdfViewerExample"x:Class="PdfViewerExample.MainPage"><ContentPage.BindingContext><local:PdfViewerViewModelx:Name="viewModel"/></ContentPage.BindingContext><ContentPage.Content><syncfusion:SfPdfViewerx:Name="PdfViewer"DocumentSource="{Binding PdfDocumentStream}"></syncfusion:SfPdfViewer></ContentPage.Content></ContentPage>

Note: If you are using multiple pages in your app, then make sure to unload the document from theSfPdfViewer class while leaving the page that has it to release the memory and resources consumed by the loaded PDF document. You can unload documents by calling theUnloadDocument method. Also, while changing or opening different documents on the same page, the previously loaded document will be unloaded automatically by theSfPdfViewer.

Step 7: Finally, run the app. Refer to the following output image.

Note: For more details, refer to the.NET MAUI PDF Viewer GitHub demo.

Creating a custom toolbar

Currently, we do not support a built-in toolbar in the .NET MAUI PDF Viewer. However, we have provided APIs for performing magnification and page navigation programmatically.

Therefore, you can design a simple custom toolbar and invoke the operations using the following APIs.

Load document API

Page navigation APIs

ZoomAPIs

Note: For more details, refer to the.NET MAUI PDF Viewer with a custom toolbar demo on GitHub.

Opening a password-protected PDF

To open a password-protected or encrypted PDF document, you can use theLoadDocument() method by providing the password along with the document stream.

Refer to the following code example.

stringpassword="PASSWORD";pdfViewer.LoadDocument(pdfDocumentStream,password);

Using the following APIs, you can determine whether a PDF document is password protected.

Note: For more details, refer to theopening a password-protected PDF using the .NET MAUI PDF Viewer demo on GitHub.

Reference

Refer to the.NET MAUI PDF Viewer documentation to learn about its other features.

Coming soon

We have planned and are working to support the following major features in the .NET MAUI PDF Viewer control in upcoming releases:

• Built-in toolbar.
• Text search.
• Text selection and copy.
• Bookmark, TOC, and hyperlink navigation.
• Localization.
• Accessibility.
• RTL text.
• The ability to add, edit, save, and remove annotations.
• Form filling with edit and save functions.
• Single-page layout mode.
• Thumbnails.
• Themes.

Conclusion

Thanks for reading! I hope you enjoyed learning about the new Syncfusion.NET MAUI PDF Viewer introduced in2022 Volume 4. You can download and check out our MAUI demo app fromGoogle Playand theMicrosoft Store.

Also, check out ourRelease Notes and theWhat’s New pages to see the other updates in this release.

For current customers, the new version is available for download from theLicense and Downloads page. If you are not yet a Syncfusion customer, you can try our 30-dayfree trial to check out our newest features.

You can share your feedback and questions through the comments section below or contact us through oursupport forums,support portal, orfeedback portal. We are always happy to assist you!

Related blogs

• Introducing the New .NET MAUI Rating Control
• Introducing the Sixth Set of .NET MAUI Controls
• Authenticate the .NET MAUI App with Azure AD
• Agenda View in .NET MAUI Scheduler: A Perfect Tool for Modern-Day Office Management