ActiveReports 6 User Guide 0 ActiveReports 6 This is the help file for GrapeCity ActiveReports version 6, reporting software for use in Visual Studio 2005, 2008 and 2010. In This Documentation ActiveReports User Guide The User Guide has many getting started topics and how-to topics with code samples to copy and paste. Class Library (on-line documentation) This is the API documentation with topics for all of the public members of each assembly included with ActiveReports. ActiveReports User Guide ActiveReports 6 is a fully integrated Visual Studio component which combines the features of the Visual Studio .NET programming languages with user-friendly controls to provide a powerful report designer. In This Documentation Introducing ActiveReports 6 Find out what's new in ActiveReports 6, learn which features are freed from the evaluation banner with the Standard and Professional Edition licenses, and find copyright and license information. Installation View requirements for installation of ActiveReports 6, learn what files are installed and how to verify your installation, and find installation troubleshooting tips. License Your ActiveReports This topic walks you through how to license your machine and how to add licensing to any projects created during your evaluation. Upgrading Reports Use this section to guide you through the upgrade path from previous ActiveReports versions, and to learn to convert Microsoft Access reports to ActiveReports. Getting Started This section serves as a guide to help you to get started, with topics on adding controls to Visual Studio, adding reports to projects, and understanding the designer interface. You will also find topics on the report viewer and on using ActiveReports on the Web. Concepts This section explains important concepts to help you to understand what to expect from ActiveReports and how it works. How To Here you will find topics that guide you through specific tasks that you may want to perform with ActiveReports. Samples and Walkthroughs Find out how to use various features of ActiveReports using included sample projects and step-by-step guides to create new projects. Troubleshooting Browse frequently asked questions, learn how to resolve some common issues with ActiveReports, and find information on technical support options. Introducing ActiveReports 6 ActiveReports leverages the latest technologies including Silverlight, XML, scripting and CSS along with open ©2013 ComponentOne, a division of GrapeCity. All Rights Reserved. ActiveReports 6 User Guide 1 architecture to provide you with a fully integrated user-friendly report designer. This version now supports Visual Studio 2010, as well as Visual Studio 2005 and 2008. This section contains information about: What's New Learn about the new features in ActiveReports 6. ActiveReports Editions Find out which features are freed from the evaluation banner with the Standard and Professional Edition licenses. GrapeCity Copyright Notice Explains GrapeCity copyright information. ActiveReports License Agreement Understand the terms of the ActiveReports License Agreement and Limited Warranty. What's New ActiveReports 6 contains many new features that enhance the reporting capabilities already praised by developers in previous versions of ActiveReports. You can view the release history notes here. To open the release history notes, click Show Details against the ActiveReports 6 version. What's new in the ActiveReports 6 Service Pack 3? Underscore Support You can use the underscore character in the OutputFormat property to add the white space after the character specified in the Value property. For example, using the underscore character adds the white space for a closing parenthesis in a positive number format while the negative number format includes parentheses. This way both positive and negative values are lined up at the decimal point. Learn More | OutputFormat Property (on-line documentation) TextBox Date Values Export Support in Excel A date value of the TextBox control is exported to Excel as a date if the Value property is set to a supported date type and the OutputFormat property is set to a valid value. Learn More | OutputFormat Property (on-line documentation) New Encoding Property The new Encoding property of QRCode allows you to change the text encoding that QRCode uses. The default value is Encoding.GetEncoding(932). You can set this property at design time or in code. Learn More | Encoding Property (on-line documentation) New LabelDistanceFactor Property The new LabelDistanceFactor property of the DataDynamics.ActiveReports.Chart.Marker class allows you to specify the distance of the Marker label from the chart. The default value is 1, which defines the original distance. If you set the value to 5, the distance is calculated by multiplying 5 times the original value. This property is provided for the Doughnut/Doughnut3D chart type only. Learn More | Chart Types | LabelDistanceFactor Property (on-line documentation) ©2013 ComponentOne, a division of GrapeCity. All Rights Reserved. ActiveReports 6 User Guide 2 New DateTimeUnit Enumeration The new DateTimeUnit enumeration defines a DateTime unit for the DateTime axis. The default value is Auto and it calculates the DateTime unit automatically, based on the data source. The other DateTimeUnit values are Day, Hour, Millisecond, Minute, Month, Second and Year. You can set the DateTime unit under Axis properties of the Chart Designer or in code in the DateTimeUnit property. Learn More | DateTimeUnit Enumeration (on-line documentation) | DateTimeUnit Property (on-line documentation) Shortcuts in Thumbnails You can use shortcuts in the Thumbnails pane of the Windows Form Viewer sidebar, the Flash Viewer sidebar and the Silverlight Viewer sidebar. The shortcuts include Up, Down, Left, Right, Page Up, Page Down, Home and End keyboard shortcuts. Learn More | Flash Viewer Hot Keys and Shortcuts | Silverlight Viewer Hot Keys and Shortcuts ActiveReports Editions ActiveReports 6 is an enhancement of the popular ActiveReports engine and report viewer. It includes the same power and flexibility of ActiveReports and the same integration with the Visual Studio® .NET 2005 Environment, and adds several new features including integration with the Visual Studio .NET 2008, Visual Studio .NET 2010 Environments. Available in two editions, ActiveReports 6 delivers outstanding reporting capabilities. Drop down the sections below to see the features packed with each edition of ActiveReports. Standard Edition Features Designer Full integration with the .NET environment Familiar user interface NEW SnapLines to help you visually align controls C# and VB.NET support The ability to compile reports into the application for speed and security or to keep them separate for ease of updating Designer hosting of .NET and user controls Report Controls ReportInfo Label Line PageBreak OleObject Subreport Shape Picture RichTextBox with HTML tag support ChartControl with separate data source Textbox Barcode with standard styles plus NEW RSS and UPC styles Checkbox ©2013 ComponentOne, a division of GrapeCity. All Rights Reserved. ActiveReports 6 User Guide 3 NEW CrossSectionBox extends from a header section to the related footer section NEW CrossSectionLine extends from a header section to the related footer section Reporting Engine Managed code Binding to ADO.NET, XML, iList, and custom data sources NEW Document DLL as a separate assembly All of the features of previous versions of ActiveReports Report Viewer Managed C# code Very small deployment assembly, suitable for use on the Internet Table of Contents and Bookmarks Thumbnail View HyperLinking Tabbed Viewing Annotations Export Filters ActiveReports includes export filters to generate output into Rich Text Format (RTF) for word-processing, Portable Document Format (PDF) for printing, Microsoft® Excel® worksheets, HTML and DHTML for publishing your reports to the internet, TIFF for optical archiving and faxing, and delimited text for spreadsheets and databases. Professional Edition Features ActiveReports 6 Professional Edition includes all of the features of the Standard Edition and supports the following additional features: End-User Report Designer The control is a run-time designer that may be distributed royalty-free. It allows the ActiveReports designer to be hosted in an application and provides end-user report editing capabilities. The control's methods and properties provide easy access for saving and loading report layouts, monitoring and controlling the design environment, and customizing the look and feel to the needs of end users. ASP.NET Integration The Web server control provides convenience for running and exporting reports in ASP.NET. HTTP Handler extensions allow report files (RPX) or compiled assemblies containing reports to be dropped on the server and hyperlinked. Silverlight Viewer Control The Silverlight viewer control allows you to provide in- or out-of-browser report viewing in your Silverlight applications. Like our other viewers, the Silverlight viewer control offers customization and localization. Web Viewer Control ©2013 ComponentOne, a division of GrapeCity. All Rights Reserved. ActiveReports 6 User Guide 4 The Web Viewer control allows quick viewing of ActiveReports on the web as well as printing capability with the AcrobatReader ViewerType enumeration. NEW Flash ViewerType enumeration supports multiple browsers and offers customization and localization options. The FlashViewer control replaces the ActiveX Viewer control that is no