ActiveReports 14 .NET Edition
ActiveReports 14 User Guide / Preview Reports / WPF / View Reports in WPF Viewer
In This Topic
    View Reports in WPF Viewer
    In This Topic

    The ActiveReports WPF Viewer is a custom control that allows to easily view section, RDL and page report layouts.

    This walkthrough is split up into the following activities.

    When you have completed these steps, you will have the ActiveReports WPF Viewer displaying a report that looks similar to the following.

    WPF Viewer

    WPF Viewer

    To create a WPF application in Visual Studio

    1. On the Visual Studio File menu, click New > Project.
    2. In the New Project dialog that appears, select WPF Application in the list of templates.
    3. Specify the name and location of the project and then сlick the OK button.
    4. In the Visual Studio Solution Explorer, right-click YourProject and select Add, then New Item.
    5. In the Add New Item dialog that appears, select the ActiveReports 14 Page Report and create the rptSingleLayout report as described in the Single Layout Reports walkthrough.

    To add the WPF Viewer control

    1. In Solution Explorer, open MainWindow.xaml.
    2. From the Toolbox ActiveReports 14 tab, drag the Viewer control and drop it on the design view of MainWindow.xaml.
      Note: Dragging the Viewer control to the design view of MainWindow.xaml automatically adds the corresponding reference to the licenses.licx file.
    3. In the Properties window, set the properties of the Viewer control as follows.
      Property Name Property Value
      HorizontalAlignment Stretch
      VerticalAlignment Stretch
      Margin 0
       
    4. In the Properties window, rename the Viewer control to viewer1.

      Renaming the name in Properties window

    To load a report to the WPF Viewer

    1. In the Solution Explorer, select the rptSingleLayout report you have created.
    2. In the Properties window, set Copy to Output Directory to Copy Always.

      Note: If Page/RDL report is selected from dropdown of Source property (containing relative path), 'Copy to Output Directory' for selected report should be set as 'Copy always/Copy if newer' otherwise error "Could not find file ... " appears on loading WPF Viewer.


                 

      Caution: In WPF Viewer control, previewing code-based Section reports using Source and SourceFormat properties is not supported.

    3. On MainWindow.xaml, with the viewer selected, go to the Properties window and double click the Loaded event.
    4. In the MainWindow code view that appears, add code like the following to the viewer1_loaded event to bind the report to the viewer. This code shows an .rdlx report being loaded, but you can use an .rpx report as well.
      Visual Basic.NET code. Paste INSIDE the viewer1_Loaded event in MainWindow.xaml.vb.
      Copy Code
      Viewer1.LoadDocument("rptSingleLayout.rdlx")
      
      C# code. Paste INSIDE the viewer1_Loaded event in MainWindow.xaml.cs.
      Copy Code
      viewer1.LoadDocument("rptSingleLayout.rdlx");
      

    Note:

    • Refer to the LoadDocument method to see other ways to load a report in WPF Viewer.
    • We can set report for WPFViewer directly on XAML file and load the report in WPF Viewer using Source and SourceFormat properties.
    • To avoid evaluation banners appearing at run time, license your ActiveReports WPF Application project. You can find information on licensing in License Your ActiveReports.

     

    To view the report

    Press F5 to run the project. The WPF Viewer displaying a report appears.

    To customize the WPF Viewer

    The ActiveReports WPF Viewer is a customizable control. You can easily change the look of the WPF Viewer and its elements, such as the error panel, search panel, sidebar and toolbar by modifying properties in the default WPF Viewer template (DefaultWPFiewerTemplates.xaml).

    Customized ActiveReports WPF Viewer

    Customized ActiveReports WPF Viewer

    To add the customization template to the WPF project

    1. Open your WPF project.
    2. In Solution Explorer, select the YourProjectName node.
    3. On the Visual Studio Project menu, click Add Existing Item.
    4. In the dialog that appears, locate and select DefaultWPFViewerTemplates.xaml and click OK. You can find DefaultWPFViewerTemplates.xaml at [systemdrive]\Program Files\GrapeCity\ActiveReports 14\Deployment\WPF\Templates folder (on a 64-bit Windows operating system, this file is located in [systemdrive]\Program Files (x86)\GrapeCity\ActiveReports 14\Deployment\WPF\Templates).
    5. On MainWindow.xaml before the opening <Grid> tag, add the following code.
      Paste to the XAML view of MainWindow.xaml before the opening <Grid> tag
      Copy Code
      <Window.Resources>                                
      <ResourceDictionary Source="DefaultWPFViewerTemplates.xaml" />
      </Window.Resources>
      

    To customize the WPF Viewer sidebar

    1. In Solution Explorer, double-click DefaultWPFViewerTemplates.xaml.
    2. In the file that opens, search for "thumbnails tab".
    3. In the GroupBox Header property of <!-- thumbnails tab -->, remove "{Binding Source.ThumbnailsPane.Text}" and type "THUMBNAILS".
    4. Search for "TabControl x:Name="Sidebar".
    5. Add Background="Yellow" after TabControl x:Name="Sidebar".
    6. Press F5 to see the customized viewer sidebar.

    To add a customized button to the WPF Viewer toolbar

    1. In Solution Explorer, select the YourProjectName node.
    2. On the Visual Studio Project menu, select Add New Item.
    3. In the Add New Item dialog that appears, select Class, rename it to MyCommand and click Add.
    4. In the MyCommand.cs/vb that opens, add the following code to implement a command.

      To write the code in Visual Basic.NET

      Visual Basic.NET code. Add to MyCommand.vb
      Copy Code
      Implements ICommand 
      Public Function CanExecute(ByVal parameter As Object) As Boolean Implements System.Windows.Input.ICommand.CanExecute 
          Return True 
      End Function
      
      Public Event CanExecuteChanged(ByVal sender As Object, ByVal e As System.EventArgs) Implements System.Windows.Input.ICommand.CanExecuteChanged 
      
      
      Public Sub Execute(ByVal parameter As Object) Implements System.Windows.Input.ICommand.Execute 
          MessageBox.Show("GrapeCity is the world's largest component vendor.", "About Us", MessageBoxButton.OK) 
      End Sub                    
      

      To write the code in C#

      C# code. Add after the statement using System.Text;
      Copy Code
      using System.Windows.Input;
      using System.Windows;
      
      C# code. Add to MyCommand.cs
      Copy Code
      public class MyCommand : ICommand
          {
              public bool CanExecute(object parameter)
              {
                  return true;
              }
      
              public void Execute(object parameter)
              {
                  MessageBox.Show("GrapeCity is the world's largest component vendor.", "About Us", MessageBoxButton.OK);
              }
      
              public event EventHandler CanExecuteChanged;
          }
                              
      
    5. In Solution Explorer, double-click DefaultWpfViewerTemplates.xaml.
    6. In the file that opens, add the following code.
      XML code. Add to DefaultWpfViewerTemplates.xaml
      Copy Code
      <ResourceDictionary>
       ...                      
      xmlns:YourProjectName="clr-namespace:YourProjectName"> 
      <YourProjectName:MyCommand x:Key="MyCommand" />
      ...                       
      </ResourceDictionary>
                                                      
      

      Adding code to DefaultWpfViewerTemplates.xaml file

    7. In the same file, add the following code to add a button.
      XML code. Add to DefaultWpfViewerTemplates.xaml before the closing Toolbar tag
      Copy Code
      <Button Command="{StaticResource MyCommand}" Content="About Us" />                       
      
      Adding code to DefaultWpfViewerTemplates.xaml file
    8. Press F5 to see the new customized button About Us in the Viewer toolbar.

    To remove the Refresh button from the WPF Viewer toolbar 

    1. In Solution Explorer, double-click DefaultWpfViewerTemplates.xaml.
    2. In the file that opens, search for "<!--Refresh btn-->".
    3. Replace the existing content in Visiblity="..." with the following.
      XML code. Add to DefaultWpfViewerTemplates.xaml
      Copy Code
      <Button Command=... Visibility="Collapsed">