Integration with AppBar

Size: px

Start display at page:

Download "Integration with AppBar"

Violet Sherman
5 years ago
Views:

Integration with AppBar Content first principle is highly recommended to be followed when developing an application for Windows 8. You can also allow users of your application to focus on the content.

1 Integration with AppBar Content first principle is highly recommended to be followed when developing an application for Windows 8. You can also allow users of your application to focus on the content. To do that you can place report management panels to the AppBar. WinRT Viewer for Reporting Services provides the following set of tools for management and navigation: ReportNavigationPanel a navigation panel that allows to quickly moving between report pages. ReportSearchPanel a search panel where you can insert text for searching and search the inserted text in a report. ReportParametersMenu provides access to the panels for entering Parameters and Credentials ReportViewModePanel switches between different modes of report display, provides access to ThumbnailsPanel ReportExportPanel provides access to the menu of export filters selection. Below you can find information on how to place the required panels to the AppBar. Step 1 Adding the PerpetuumSoft.ReportingServices.WinRT.Controls namespaces. Open the MainPage.xaml file and add reference to the PerpetuumSoft.ReportingServices.WinRT.Controls namespace to access the controls.:

2 Step 2 Placing elements to the AppBar Place the reports management panels to the TopAppBar and BottomAppBar of your application. We recommend you to follow the rules introduced by Microsoft when placing the panels: TopAppBar is better to use for placing navigation controls (ReportNavigationPanel, ReportSearchPanel); BottomAppBar is better to use for the controls intended directly for management (ReportParametersMenu, ReportViewModePanel, ReportExportPanel).... xmlns:reports="using:perpetuumsoft.reportingservices.viewer.winrt" xmlns:reportcontrols="using:perpetuumsoft.reportingservices.viewer.winrt.controls" mc:ignorable="d"> <Page.TopAppBar> <AppBar> <Grid> <Grid.ColumnDefinitions> <ColumnDefinition Width="*"/> </Grid.ColumnDefinitions> <reportcontrols:reportnavigationpanel x:name="navigationpanel"/> <reportcontrols:reportsearchpanel Grid.Column="2" x:name="searchpanel"/> </Grid> </AppBar> </Page.TopAppBar> <Page.BottomAppBar> <AppBar> <Grid> <Grid.ColumnDefinitions> <ColumnDefinition Width="*"/> </Grid.ColumnDefinitions> <reportcontrols:reportparametersmenu x:name="parametersmenu"/> <reportcontrols:reportviewmodepanel Grid.Column="2" x:name="modepanel" /> <reportcontrols:reportexportpanel Grid.Column="4" x:name="exportpanel" /> </Grid> </AppBar> </Page.BottomAppBar>

3 Step 3 Configuring ReportViewer Every of the provided panels should be bound to the ReportViewer object. Considering the particularities of a WinRT panel, the panels placed to the AppBar cannot be bound to the reportviewer (that is placed outside the AppBar). To solve this problem we suggest the backward binding mechanism based on the use of the AttachedProperty. You need to add the following dependency properties to your project: public static class ReportViewerPanels #region ReportNavigationPanel public static ReportNavigationPanel GetReportNavigationPanel(DependencyObject obj) return (ReportNavigationPanel)obj.GetValue(ReportNavigationPanelProperty); public static void SetReportNavigationPanel(DependencyObject obj, ReportNavigationPanel value) obj.setvalue(reportnavigationpanelproperty, value); public static readonly DependencyProperty ReportNavigationPanelProperty = DependencyProperty.RegisterAttached("ReportNavigationPanel", typeof(reportnavigationpanel), typeof(reportviewerpanels), new PropertyMetadata(null, new PropertyChangedCallback(OnReportNavigationPanelPropertyChanged))); public static void OnReportNavigationPanelPropertyChanged(DependencyObject o, if (e.oldvalue!= null && e.oldvalue is ReportNavigationPanel) (e.oldvalue as ReportNavigationPanel).AttachedReportViewer = null; if (e.newvalue!= null && e.newvalue is ReportNavigationPanel) (e.newvalue as ReportNavigationPanel).AttachedReportViewer = reportviewer; #region ReportParametersMenu public static ReportParametersMenu GetReportParametersMenu(DependencyObject obj) return (ReportParametersMenu)obj.GetValue(ReportParametersMenuProperty); public static void SetReportParametersMenu(DependencyObject obj, ReportParametersMenu value)

4 obj.setvalue(reportparametersmenuproperty, value); public static readonly DependencyProperty ReportParametersMenuProperty = DependencyProperty.RegisterAttached("ReportParametersMenu", typeof(reportparametersmenu), typeof(reportviewerpanels), new PropertyMetadata(null, new PropertyChangedCallback(OnReportParametersMenuPropertyChanged))); public static void OnReportParametersMenuPropertyChanged(DependencyObject o, if (e.oldvalue!= null && e.oldvalue is ReportParametersMenu) (e.oldvalue as ReportParametersMenu).AttachedReportViewer = null; if (e.newvalue!= null && e.newvalue is ReportParametersMenu) (e.newvalue as ReportParametersMenu).AttachedReportViewer = reportviewer; #region ReportViewModePanel public static ReportViewModePanel GetReportViewModePanel(DependencyObject obj) return (ReportViewModePanel)obj.GetValue(ReportViewModePanelProperty); public static void SetReportViewModePanel(DependencyObject obj, ReportViewModePanel value) obj.setvalue(reportviewmodepanelproperty, value); public static readonly DependencyProperty ReportViewModePanelProperty = DependencyProperty.RegisterAttached("ReportViewModePanel", typeof(reportviewmodepanel), typeof(reportviewerpanels), new PropertyMetadata(null, new PropertyChangedCallback(OnReportViewModePanelPropertyChanged))); public static void OnReportViewModePanelPropertyChanged(DependencyObject o, if (e.oldvalue!= null && e.oldvalue is ReportViewModePanel) (e.oldvalue as ReportViewModePanel).AttachedReportViewer = null; if (e.newvalue!= null && e.newvalue is ReportViewModePanel) (e.newvalue as ReportViewModePanel).AttachedReportViewer = reportviewer; #region ReportSearchPanel public static ReportSearchPanel GetReportSearchPanel(DependencyObject obj)

5 return (ReportSearchPanel)obj.GetValue(ReportSearchPanelProperty); public static void SetReportSearchPanel(DependencyObject obj, ReportSearchPanel value) obj.setvalue(reportsearchpanelproperty, value); public static readonly DependencyProperty ReportSearchPanelProperty = DependencyProperty.RegisterAttached("ReportSearchPanel", typeof(reportsearchpanel), typeof(reportviewerpanels), new PropertyMetadata(null, new PropertyChangedCallback(OnReportSearchPanelPropertyChanged))); public static void OnReportSearchPanelPropertyChanged(DependencyObject o, if (e.oldvalue!= null && e.oldvalue is ReportSearchPanel) (e.oldvalue as ReportSearchPanel).AttachedReportViewer = null; if (e.newvalue!= null && e.newvalue is ReportSearchPanel) (e.newvalue as ReportSearchPanel).AttachedReportViewer = reportviewer; #region ReportExportPanel public static ReportExportPanel GetReportExportPanel(DependencyObject obj) return (ReportExportPanel)obj.GetValue(ReportExportPanelProperty); public static void SetReportExportPanel(DependencyObject obj, ReportExportPanel value) obj.setvalue(reportexportpanelproperty, value); public static readonly DependencyProperty ReportExportPanelProperty = DependencyProperty.RegisterAttached("ReportExportPanel", typeof(reportexportpanel), typeof(reportviewerpanels), new PropertyMetadata(null, new PropertyChangedCallback(OnReportExportPanelPropertyChanged))); public static void OnReportExportPanelPropertyChanged(DependencyObject o, if (e.oldvalue!= null && e.oldvalue is ReportExportPanel) (e.oldvalue as ReportExportPanel).AttachedReportViewer = null; if (e.newvalue!= null && e.newvalue is ReportExportPanel) (e.newvalue as ReportExportPanel).AttachedReportViewer = reportviewer;

6 By default, all specified panels are placed in one panel together with a report to simplify getting started with the component. When placing panels to the AppBar it is necessary to hide the default panels. You can do this by setting the HideDefaultToolbars property to (by default the value is set to false). For the correct work of the controls placed to the AppBar it is needed to correctly configure reportviewer. To do this, please make the following modifications to the MainPage.xaml: <reports:reportviewer x:name="reportviewer" ReportName="/Sample" ServiceUrl=" ExportMode="UserSelected" HideDefaultToolbars="True" local:reportviewerpanels.reportnavigationpanel="binding ElementName=navigationPanel" local:reportviewerpanels.reportparametersmenu="binding ElementName=parametersMenu" local:reportviewerpanels.reportviewmodepanel="binding ElementName=modePanel" local:reportviewerpanels.reportsearchpanel="binding ElementName=searchPanel" local:reportviewerpanels.reportexportpanel="binding ElementName=exportPanel" /> Let s hit F5 and see the result:

For your convenience Apress has placed some of the front matter material after the index. Please use the Bookmarks and Contents at a Glance links to

For your convenience Apress has placed some of the front matter material after the index. Please use the Bookmarks and Contents at a Glance links to access them. Contents at a Glance About the Author...