Some test text!

Custom viewer

Display a PDF in PDFViewCtrl for your UWP viewer

In this tutorial you will be able to display a PDF file in PDFViewCtrl. To begin working with PDFViewCtrl, you must have first added it to your project and initialized the library (get started with UWP ).

  1. Now that the project is set up, let us add a PDFViewCtrl as the main feature of the project. First, we need to set up the page to contain the PDFViewCtrl. We want to add a main viewing area for the PDFViewCtrl, and an area at the bottom where we can later add in some options. Open up “MainPage.xaml” and find the Grid element. Add some row definitions as follows:

//@data {"ga":8075024121}// <Grid.RowDefinitions>

The second row will be used for our options bar, while the
first row will use whatever space is left to display the PDFViewCtrl.

To this Grid, let's add a Border which will host the `PDFViewCtrl` and then a stack panel with a button to open a document.


 <Grid Background="{StaticResource 
     <RowDefinition Height="*"/>     
     <RowDefinition Height="Auto"/> 
     <Border x:Name="PDFViewBorder" Grid.Row="0"/> 
     <StackPanel Grid.Row="1" Orientation="Horizontal" HorizontalAlignment="Right" Margin="5">    
     <Button x:Name="OpenButton">Open</Button> 
  1. Now, we want to add the PDFViewCtrl to the app. We do this in “MainPage.xaml.cs”. Open up “MainPage.xaml.cs” and add a member variable that references a PDFViewCtrl.

//@data {"ga":4257640203}// public sealed partial class MainPage : Page { pdftron.PDF.PDFViewCtrl MyPDFViewCtrl; ... }

Next, we need to create a `PDFViewCtrl`, so let's do this in the constructor of the MainPage. We also need to make the `PDFViewCtrl` the child of the PDFViewBorder.


  public MainPage()
      MyPDFViewCtrl = new pdftron.PDF.PDFViewCtrl();
      PDFViewBorder.Child = MyPDFViewCtrl;
  1. We also have to add a handler for the Open button. Let's do that in MainPage's constructor after we have created a PDFViewCtrl.

//@data {"ga":5350327681}// public MainPage() { ... MyPDFViewCtrl = new pdftron.PDF.PDFViewCtrl(); PDFViewBorder.Child = MyPDFViewCtrl; OpenButton.Click += OpenButton_Click; }

void OpenButton_Click(object sender, RoutedEventArgs e)
     throw new NotImplementedException();
Inside this click function, we need to open a Document. First, let's include two new namespaces that we need for the file picker and for the storage file.


using Windows.Storage;
using Windows.Storage.Pickers;

Also, OpenButton_Click needs to be async in order to handle some of the asynchronous API's needed here. So, replace the old OpenButton_Click with the following:

async void OpenButton_Click(object sender, RoutedEventArgs e)
     // Get a file from the file picker.
     FileOpenPicker fileOpenPicker = new FileOpenPicker();
     fileOpenPicker.ViewMode = PickerViewMode.List;
     StorageFile file = await fileOpenPicker.PickSingleFileAsync();

     // Create a PDFDocument and use it as the source for the PDFViewCtrl
     if (file != null)
         Windows.Storage.Streams.IRandomAccessStream stream = await
         pdftron.PDF.PDFDoc doc = new pdftron.PDF.PDFDoc(stream);

Build and launch the app and we should now have a very basic PDF document viewer.

Do note that in Windows 8.1, the file picker works differently. Please see this guide for how to use file pickers in Windows Phone 8.1:

Get the answers you need: Support

UPCOMING WEBINAR: Live tech update and run-through. October 21 @ 11am PDT