ActiveReports 16 .NET Edition
ActiveReports 16 User Guide / Preview Reports / ASP.NET / Using the HTML Viewer
In This Topic
    Using the HTML Viewer
    In This Topic

    HTML Viewer is the default viewer type of the WebViewer control, and provides a scrollable view of the report one page at a time. It includes HTML representations of the toolbar as well as the sidebar that contains ParametersExport and Search panes.

    HTML Viewer Properties




    BookmarkStyle Specify whether to use HTML bookmarks, or none.
    CharacterSet Select from 15 character sets to use for the report.
    IncludePageMargins Specify whether to keep page margins on reports in the generated HTML.
    OutputType Specify whether to use DHTML or HTML for the output.
    RemoveVerticalSpace Specify whether to keep white space, for example at the end of a page not filled with data before a page break.
    Animation > HoverTable > Enabled Sets the rows of data regions appear highlighted in the Viewer on mouse hovering. 
    Animation > HoverTable > BackgroundColor Sets the rows of data regions appear in the specified background color on mouse hovering.
    Animation > HoverTable > TextColor Sets texts in the hovered rows of data regions appear in the specified color on mouse hovering.
    Animation > HoverChart > Enabled Controls highlighting of chart plot data bars/regions on mouse hovering.
    Animation > LoadChart > Enabled Controls the loading effect on chart at report rendering. The default value is False.
    PageView > HorizontalAlignment

    Specifies whether a report appears horizontally aligned to the left, right, or center. The available values are Left, Right, or Center (by default). 

    PageView > ViewMode

    Specifies a page view mode. The available values are NoPaper or Standard (by default). If set to Standard, the default report page view appears in the viewer.

    Note: To have the animation properties work, you must link the files jsViewer.chart.min.js and jsViewer.chart.min.css. These files are included into the npm package.

    Important: The plot rules don't work on charts with animation. If you want the plot rules apply on a chart, you must disable the animation properties.

    The HTML Viewer downloads only HTML and javascript to the client browser.

    HTML Viewer

    HTML Viewer

    HTML Viewer Sidebar

    Sidebar Element Name Description
    Display Sidebar button Display Sidebar Displays the sidebar that includes the Search, Export, and Parameters panes.
    Search button Search Displays the Search pane.
    Export button Export Displays the Export pane where you can select an export format and options for the report you are previewing.
    Parameters button Parameters Displays the Parameters pane. If a report does not have parameters, the Parameters button not displayed.

    HTML Viewer Toolbar

    The HTML viewer toolbar offers various ways to navigate through reports.

    Toolbar Element Name Description
    Go to First page button  Go to Last page button Go to First/Last page Jumps to the first or last page of a report.
    Go to Previous page button Go to Next page button Go to Previous/Next page Navigates through a report page by page.
    Current page button Current page Displays the current page number and page total. Enter the page number to view a specific page.
    Refresh button Refresh Refreshes the report.
    History: Back to Parent button History: Back to Parent Returns to the parent report in a drill-down page report or RDL report.
    History: Go Back button History: Go Back

    Navigates to a previous page in a parent report in a drill-down page report or RDL report.

    History: Go Forward button History: Go Forward

    Navigates to a next page in a parent report in a drill-down page report or RDL report.

     Move Tool button Move Tool A move tool that you can use to navigate the report.
    Zoom Out button Zoom Out Decreases the magnification of your report. 

    Zoom mode buton

    Zoom mode Displays the current zoom percentage which can also be edited. Allows you to select from the available zoom options - 50%, 100%, 150%200%, 300%Fit to Page, and Fit to Width.

    Zoom In button

    Zoom In Increases the magnification of your report.

    Toggle Fullscreen button

    Toggle Fullscreen Switches to a Fullsreen mode.

    Print button

    Print Displays the Print screen to specify printing options.

    Single Page View button

    Single Page View Shows one page at a time in the viewer.

    Continious View button

    Continious View Shows all preview pages one below the other.

    Galley mode button

    Galley mode Provides a viewer mode which removes automatic page breaks from an RDL report and displays data in a single scrollable page. This mode maintains page breaks you create in the report.

    HTML Viewer Parameters

    The HTML viewer allows you to view reports with parameters. The Parameters pane shows up automatically. To show or hide the Parameters pane in the sidebar, click the Toggle Sidebar button in the Toolbar.

    In the Parameters pane, you are asked to enter a value by which to filter the data to display.

    To filter the report data, enter a value or set of values and click Preview.

    Parameters pane

    If a report does not have parameters, the Parameters pane of the sidebar is not displayed.

    Tip: The parameters panel appears by default on the left of the viewer. You can change its position to the top by setting the ParametersPanelLocation property of the viewer to 'Top'.

    HTML Viewer Export

    To display the Export pane, click Export in the sidebar. The Export pane lets you enter parameters for exporting a report that you are previewing. The available format options are Excel 2003, Excel, Word 2003, Word, PDF, CSV, JSON, XML, Tagged Image, and Web Archive.

    Export pane 

    After you set all necessary export properties, click Export.

    HTML Viewer Search

    The Search pane lets you enter a word or phrase for which to search within the report. Under Use these additional criteria, you may optionally select additional criteria. When you click Search, any results appear in the Find results list. Click an item in the list to jump to the item you selected and highlight it.


    See Also