Lesson 1 - Create a PDF Viewer

• Aug 03, 2020
• 3 minutes to read

This document demonstrates how to create a WPF PDF Viewer application. This tutorial consists of the following steps.

• Step 1. Create a New Project and Add a PDF Viewer
• Step 2. Change the Command Bar Style
• Step 3. Provide a Start Screen
• Result

Step 1. Create a New Project and Add a PDF Viewer

Perform the following actions to add a PdfViewerControl to your application.

• Run Microsoft Visual Studio 2012, 2013, 2015, 2017 or 2019 and create a new WPF Application project.
• Add a PdfViewerControl component to the project. Drag the PdfViewerControl from the DX.19.2: Data & Analytics Toolbox tab and drop it onto the main window.

• Right-click the PDF Viewer and select Layout | Reset All to fill the entire window.

  

  After this action, your XAML appears as follows.

  XAML

  <Window
          xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
          xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
          xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
          xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
          xmlns:local="clr-namespace:PDF_Viewer"
          xmlns:dxpdf="http://schemas.devexpress.com/winfx/2008/xaml/pdf" x:Class="PDF_Viewer.MainWindow"
          mc:Ignorable="d"
          Title="PDF Viewer" x:Name="pdfViewer" Height="350" Width="525">
      <Grid>
          <dxpdf:PdfViewerControl/>
      </Grid>
  </Window>
  

  You can overwrite your MainWindow.xaml file with this code without dragging the PdfViewerControl control to the window. In this case, you need to manually add references to the following libraries.

  • DevExpress.Data.v19.2.dll
  • DevExpress.Mvvm.v19.2.dll
  • DevExpress.Pdf.v19.2.Core.dll
  • DevExpress.Pdf.v19.2.Drawing.dll
  • DevExpress.Xpf.Core.v19.2.dll
  • DevExpress.Xpf.Docking.v19.2.dll
  • DevExpress.Xpf.DocumentViewer.v19.2.Core.dll
  • DevExpress.Xpf.Grid.v19.2.dll
  • DevExpress.Xpf.PdfViewer.v19.2.dll

  Right-click References in the Solution Explorer and select Add Reference… in the invoked context menu to add library references. Refer to the Redistribution and Deployment article for a full list or required assemblies.

  

  Note

  Use the Assembly Deployment Tool to collect all assemblies that may be required for your application. If you need to copy references locally, you can find copies at C:\Program Files (x86)\DevExpress 19.2\Components\Bin\Framework\

• Load a document into the PDFViewerControl. You can do this in XAML using the DocumentViewerControl.DocumentSource property. Documents can be loaded from a stream, byte array or from a location specified by the full file path or Uri.

  The following code snippet uses a pack Uri as a document source to load a sample document that was added to the root of current project as a resource file:

  XAML

  <!--Load document from a pack Uri-->
  <dxpdf:PdfViewerControl x:Name="pdfViewer"
                          ShowStartScreen="True"
                          DocumentSource="pack://application:,,,/DxPdfViewer;component/Demo.pdf"/>
  

Now, you have a PDF Viewer added to our application. Continue and customize the command bar style.

Step 2. Change the Command Bar Style

Click the control’s smart tag to invoke the Tasks list and select the Bars command bar style to change the default ribbon style.

You can also change the DocumentViewerControl.CommandBarStyle property value in XAML.

XAML

    <Grid>
        <dxpdf:PdfViewerControl x:Name="pdfViewer"
                                CommandBarStyle="Bars"/>
    </Grid>

You can see that the PDF Viewer control displays command buttons.

Set the DocumentViewerControl.CommandBarStyle property to CommandBarStyle.None to hide the PdfViewerControl’s toolbar and context menu.

Step 3. Provide a Start Screen

Set the PdfViewerControl.ShowStartScreen property true to provide the PDF Viewer with a Start Screen. This screen allows end users to open recently opened files or invoke the Open dialog box.

The PdfViewerControl.NumberOfRecentFiles property limits the number of recently opened files displayed in the Start Screen. The PdfViewerControl.ShowOpenFileOnStartScreen property allows you to hide the Open button.

Result

Run the application. You can navigate, zoom and print the document using the corresponding bar commands.

The PDF Viewer can show bookmarks within its navigation pane for a PDF document that supports them. Check the Bookmarks topic for more information.

You can also see file attachments and thumbnails in the Attachments and Page Thumbnails panels on the navigation pane. Refer to the File Attachment, and Navigation Pane topics for more information.