New to Telerik Reporting? Download free 30-day trial

WinUI 3 Desktop Application Overview

The WinUI report viewer allows developers to deliver reports produced by Telerik Reporting to any application developed using WinUI 3 desktop framework.


The toolbar of the WinUI Report Viewer provides basic functionality for interacting with the currently loaded report:

  • Navigate back in history

  • Navigate forward in history

  • Stop rendering

  • Refresh

  • Go to first page

  • Go to previous page

  • Go to a specific page

  • Total number of pages

  • Go to next page

  • Go to last page

  • Page settings

  • Print Preview: switches between Logical and Physical page renderer. See Rendering and Paging for more info.

  • Print

  • Export: see Export Formats for available export formats.

  • Show/Hide document map (where applicable)

  • Show/Hide parameters area (where applicable)

The bottom panel of the WinUI report viewer contains a slider and drop-down list that control the current zoom level applied on the loaded report contents.

In order to use the WinUI report viewer, you need a WinUI 3 desktop application. In order to create such, you need the following tools installed:

  • Visual Studio 2019 or Visual Studio 2022 with enabled Universal Windows Platform development.

  • Windows 10 SDK 10.0.18362 or later installed.

Visual Studio 2019 and Visual Studio 2019 Preview have known issues when building WinUI applications targeting .NET 5, while having .NET 6 SDK installed on the machine. For a smooth development experience we recommend using Visual Studio 2022 and .NET 6 SDK Preview 6 or later. Otherwise you might need to deinstall .NET 6 SDK in order to build WinUI 3 applications.

How it works

The WinUI ReportViewer control is a composite of Telerik UI for WinUI desktop controls. The viewer's functionality resides in Telerik.ReportViewer.WinUI.dll and the viewer's UI in Telerik.ReportViewer.WinUI.Themes.dll.

The purpose of the WinUI ReportViewer control is to display Telerik Reports and allow the user to interact with them. Reports are processed and rendered on the client machine. The report in the viewer is rendered as standard XAML elements, as Canvas and TextBlock, through Telerik Reporting XAML rendering mechanism, adjusted for WinUI specifics.

Due to the XAML-based nature of WinUI, the WinUI report viewer reuses parts of the source code written for the WPF report viewer, allowing better maintainability and ensuring error-proof development. This is the reason why specific classes used by the WinUI report viewer might have Telerik.ReportViewer.Wpf namespace.

Known Limitations

Currently the WinUI Report Viewer does not provide the following functionalities:

  • Search in report contents.

  • Enabled accessibility features for the report viewer and rendered report.

  • Localization of the report viewer.

  • Modifying the report viewer template through a dedicated.xaml file.

The missing functionalities will be gradually added when possible, given that the current state of the WinUI 3 platform development allows it.

See Also

In this article