ComponentOne Reports for WPF Copyright ã 1987-2009 ComponentOne LLC. All rights reserved. Corporate Headquarters ComponentOne LLC 201 South Highland Avenue 3rd Floor Pittsburgh, PA 15206 ∙ USA Internet: [email protected] Web site: 1Hhttp://www.componentone.com Sales E-mail: [email protected] Telephone: 1.800.858.2739 or 1.412.681.4343 (Pittsburgh, PA USA Office) Trademarks ComponentOne Reports for WPF and the ComponentOne Reports for WPF logo are trademarks, and ComponentOne is a registered trademark of ComponentOne LLC. All other trademarks used herein are the properties of their respective owners. Warranty ComponentOne warrants that the original CD (or diskettes) are free from defects in material and workmanship, assuming normal use, for a period of 90 days from the date of purchase. If a defect occurs during this time, you may return the defective CD (or disk) to ComponentOne, along with a dated proof of purchase, and ComponentOne will replace it at no charge. After 90 days, you can obtain a replacement for a defective CD (or disk) by sending it and a check for $25 (to cover postage and handling) to ComponentOne. Except for the express warranty of the original CD (or disks) set forth here, ComponentOne makes no other warranties, express or implied. Every attempt has been made to ensure that the information contained in this manual is correct as of the time it was written. We are not responsible for any errors or omissions. ComponentOne’s liability is limited to the amount you paid for the product. ComponentOne is not liable for any special, consequential, or other damages for any reason. Copying and Distribution While you are welcome to make backup copies of the software for your own use and protection, you are not permitted to make copies for the use of anyone else. We put a lot of time and effort into creating this product, and we appreciate your support in seeing that it is used by licensed users only. · iii Table of Contents ComponentOne Reports for WPF Overview ............................................................................... 1 C1DocumentViewer Overview ............................................................................................................1 C1Report and C1PrintDocument Overview..........................................................................................2 Differences between WPF and .NET 2.0 Versions.................................................................................2 Key Features........................................................................................................................ 2 Getting Started with Reports for WPF....................................................................................... 4 Reports for WPF Quick Starts..............................................................................................................5 C1DocumentViewer Quick Start..........................................................................................................5 C1Report Quick Start..........................................................................................................................7 C1PrintDocument Quick Start.............................................................................................................9 Generating Reports (C1Report vs. C1PrintDocument).........................................................................10 Deciding on Report Generation Method.............................................................................................12 Using the FixedDocumentSequence Property .....................................................................................12 Exporting to XML Paper Specification (XPS) .....................................................................................12 Using the C1DX (C1D Open XML) File Format ................................................................................13 Exporting to XPS..............................................................................................................................14 Design-Time Support............................................................................................................14 C1DocumentViewer Context Menu ...................................................................................................14 C1DocumentViewer Properties Window............................................................................................15 C1ReportDesigner Application ..........................................................................................................16 Working with C1ReportDesigner ............................................................................................16 About C1ReportDesigner.................................................................................................................16 Application Button............................................................................................................................18 Design Tab.......................................................................................................................................19 Arrange Tab .....................................................................................................................................24 Page Setup Tab.................................................................................................................................27 Preview Tab .....................................................................................................................................28 Accessing C1ReportDesigner from Visual Studio ................................................................................31 Setting C1ReportDesigner Options.....................................................................................................32 Creating a Basic Report Definition.....................................................................................................33 Modifying the Report Layout ............................................................................................................41 Enhancing the Report with Fields ......................................................................................................43 Adding Chart Fields..........................................................................................................................43 Adding Gradient Fields.....................................................................................................................48 Selecting, Moving, and Copying Fields...............................................................................................49 Changing Field, Section, and Report Properties..........................................................................................51 Changing the Data Source.................................................................................................................51 Creating a Master-Detail Report Using Subreports ..............................................................................51 Previewing and Printing a Report.......................................................................................................55 Exporting and Publishing a Report.....................................................................................................57 Managing Report Definition Files......................................................................................................57 Importing Microsoft Access Reports...................................................................................................57 Importing Crystal Reports .................................................................................................................62 Reports for WPF Samples......................................................................................................63 Reports for WPF Task-Based Help...........................................................................................64 Adding Images to the Report .............................................................................................................64 Creating Unbound Images.................................................................................................................64 iv · Creating Bound Images .....................................................................................................................65 Creating a Watermark.......................................................................................................................66 Creating Report Fields ......................................................................................................................66 Creating Charts.................................................................................................................................67 Customizing the Page Headers...........................................................................................................67 Adding a Continued Label to Headers on Page Breaks ........................................................................68 Changing Page Headers Dynamically.................................................................................................68 Customizing the Page Layout ............................................................................................................69 Controlling Page Breaks ....................................................................................................................69