Sei sulla pagina 1di 411

.NET ModelKit Suite Documentation

Last modified on: February 8, 2011

PERPETUUM software www.perpetuumsoft.com Table of Content Table of Content 2 About the .NET ModelKit Suite

PERPETUUM

software

www.perpetuumsoft.com

Table of Content

PERPETUUM software www.perpetuumsoft.com Table of Content Table of Content 2 About the .NET ModelKit Suite 8

Table of Content

2

About the .NET ModelKit Suite

8

Technical Support

8

System Requirements

8

Installation

8

Components licensing

9

Product Localization

12

Report Sharp-Shooter

14

Report Sharp-Shooter Getting Started

14

Main Features

14

System Requirements

14

 

Installation

15

Editions

17

Deploy

17

Getting Started

18

Basic Information

28

 

Basic Terms

28

Main Components Used to Create a Report

29

Using Data Sources

29

Using

Scripts

30

Binding Elements to Data

30

Document Generation

30

Visualization and Editing Final Documents

31

Export, Print and Saving

31

Report Designer Interface

32

Tabs

32

Contextual Tabs

40

Application Menu

50

and Saving 31 Report Designer Interface 32 Tabs 32 Contextual Tabs 40 Application Menu 50 2

2

PERPETUUM software www.perpetuumsoft.com Binding Bar 51 Quick Access Toolbar 52 Context Menu 54

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Binding Bar 51 Quick Access Toolbar 52 Context Menu 54

Binding Bar

51

Quick Access Toolbar

52

Context Menu

54

Docking

59

Editors

62

Wizards

73

Status Bar

80

Hotkeys

81

Template Objects

83

Classification

83

Bands

83

Visual Elements

85

User Guide

87

Template

87

Page

90

Objects‟ Controls

95

Objects‟ Properties

96

Text Output

117

List

123

Grouping

132

Horizontal List and Table

136

SideBySide Bands

138

Pivot Table

139

Image

146

Using Shapes

150

Barcodes

152

Parameters

154

Hyperlinks and Report Navigation

155

Using subreports

159

Zip code

165

152 Parameters 154 Hyperlinks and Report Navigation 155 Using subreports 159 Zip code 165 3

3

PERPETUUM software www.perpetuumsoft.com Master-Report   166 Creation of Reports Using Wizard 167 Using

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Master-Report   166 Creation of Reports Using Wizard 167 Using

Master-Report

 

166

Creation of Reports Using Wizard

167

Using Product Features

 

178

Scripts

178

Data Sources

 

188

Export

199

Projects

205

Using Advanced Product Features

209

Custom

Report

Designer

209

Custom

Report

Viewer

210

Custom

Wizard

211

Custom

Report

Element

211

Custom

Export

Filter

212

Custom

Template Storage

212

Live Report

 

212

Managing Report Generation

213

Appendix 1 Document Object Model

215

Report Sharp-Shooter for Silverlight

218

Getting Started

 

218

Introduction

218

Product Prerequisite

218

Creating Sample Application

218

Conclusion

 

237

Instrumentation ModelKit

239

Destination and Basic Features

239

Instrumentation ModelKit Concepts

239

Getting Started

 

240

Elements Description

244

The General Instrument Model

244

Elements Hierarchy

 

245

  240 Elements Description 244 The General Instrument Model 244 Elements Hierarchy   245 4

4

PERPETUUM software www.perpetuumsoft.com Description of General Properties 251 The Description All Elements and

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Description of General Properties 251 The Description All Elements and

Description of General Properties

251

The Description All Elements and Their Properties

252

Expressions

267

Destination and General Principles of the Expressions Use

267

Description of Expression Language Syntax and Semantics

268

Use and Capabilities of the Instrument Designer

273

Work in Windows Forms Applications

280

Components Used in Windows Forms

280

The Widget Component Use and

280

The IndicatorWidget Component Use and Capabilities

282

Work in Web Forms Applications

286

Components Used in Web Applications

286

The WidgetProducer and WidgetHolder Components Use and Capabilities

286

The Technology of the Instrument Design.

290

Designing the Simple Instrument with a Slider

290

Creation of Instruments Using Complex Expressions

293

Working With the OPCChannel Component

298

General Information

298

OPCConnection

298

OPCChannel

298

Step-by-step Example of Application Creation

299

Advanced DataChannel Design

300

Capabilities

300

Design

300

OLAP ModelKit

301

Destination and Basic Features

301

Getting Started

301

Basic Information

307

Concept

307

Data Sources

307

Basic Features 301 Getting Started 301 Basic Information 307 Concept 307 Data Sources 307 5

5

PERPETUUM software www.perpetuumsoft.com Working with the DataCubeGrid Component (Pivot Table Presentation, Manipulation)

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Working with the DataCubeGrid Component (Pivot Table Presentation, Manipulation)

Working with the DataCubeGrid Component (Pivot Table Presentation, Manipulation)

309

Expressions

317

Destination and General Principles of Expression Use

317

Description of the Expression Language Syntax

317

Work in Windows Forms Applications

323

Components Used in Windows Forms Applications

323

The Use and Capabilities of the DataCube

323

The Use and Capabilities of the DataCubeGrid

325

Working with Groups

331

The Work with Large Body of Data

339

Custom

Cell Styles

340

Custom

Drawing

341

The Use and Capabilities of DataCubePrintDocument

342

The Interaction of the OLAP ModelKit with Third Party Components

343

The Interaction with OLAP ModelKit by Means of the DataCubeView Component

345

Chart ModelKit

347

Destination and Basic Features

347

General Principles of the Chart ModelKit

347

Creation of a Simple Chart with the Use of Wizard

347

Creation of a Simple Chart without Using Wizard

357

Chart Model

367

Description of Common Properties

367

ChartArea

368

Chart Series

368

Series and Assignment of a Data Source

378

Data Binding

378

Axis and Axis Elements

379

Additional

Chart Elements

383

Additional

Features

388

The Chart Viewer

390

Elements 379 Additional Chart Elements 383 Additional Features 388 The Chart Viewer 390 6

6

PERPETUUM software www.perpetuumsoft.com The Designer 392 Using DashboardViewer 398 Joint use of Chart

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com The Designer 392 Using DashboardViewer 398 Joint use of Chart

The Designer

392

Using DashboardViewer

398

Joint use of Chart ModelKit and OLAP ModelKit in version 3.6

400

Work in Web Forms Applications

405

Using charts in Web forms applications

405

Example of using charts

405

Using dashboard in Web forms application

407

Appendix 1 Working with the Expression Editor

410

405 Using dashboard in Web forms application 407 Appendix 1 Working with the Expression Editor 410

7

PERPETUUM software www.perpetuumsoft.com About the .NET ModelKit Suite The .NET Mode lKit Suite™ contains high

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com About the .NET ModelKit Suite The .NET Mode lKit Suite™ contains high -quality

About the .NET ModelKit Suite

The .NET ModelKit Suite™ contains high-quality data analysis, processing, and visualization components designed for .NET Framework. The package includes the OLAP ModelKit™ and Report Sharp-Shooter™ – the use-proven BI components intended for intelligent data handling and presentation, the Instrumentation ModelKit™ that is a perfect tool for creating digital dashboards and KPI, and the Chart ModelKit™ designed for creating effective charts and graphs. The components included into the suite minimize the coding required and provide full design-time customization.

Technical Support

Perpetuum Software official policy is to employ a very strong support team. This guarantees that all your questions and inquiries will be answered in a quick and professional manner. We would be very thankful for any suggestions and recommendations you might have regarding our products. We do take in account the opinion of every single person who has shown interest in our products.

Of course, Perpetuum Software support team is for all to help you with products troubleshooting if any. They can be reached via e-mail: support@perpetuumsoft.com or submitting a ticket.

You can get additional information or exchange your opinion on technical issues with Perpetuum Software representatives and other users at our technical support forum:

http://www.perpetuumsoft.com/Forums.aspx

If you are interested in our products, have suggestions on broadening products functionality; if you have questions on licensing or would like to make a cooperation proposal, please contact our sales department at: sales@perpetuumsoft.com.

System Requirements

To create applications with the .Net ModelKit Suite components, we recommend that you use such high-level development environments as Microsoft Visual Studio 2005, Borland Delphi 8, Borland C# Builder or others.

To run applications that use .NET ModelKit Suite components, Microsoft .NET Framework 2.0 is required. Minimal hardware requirements match those for Microsoft .NET Framework 2.0.

Installation

.Net ModelKit Suite is distributed as a Microsoft Installer package. The name of the installation package file is NETModelKitSuite.msi. To install the software, run this file and follow instructions of the wizard.

If during setting installation you chose the Add components to Visual Studio Toolboxoption, the .Net ModelKit Suite components will be automatically added to the Microsoft Visual Studio .Net Toolbox. This option works for Visual Studio 2005, Visual Studio 2008, Visual Studio 2010. To use the .Net ModelKit Suite components in other IDE‟s you should add the .Net ModelKit Suite components onto the ToolBox manually. For your convenience we recommend to create a separate tab for every product. To do it, start Visual Studio, right-click on the ToolBox, select the Add Tab item from the context menu, enter the name of the tab (for example, Report Sharp-Shooter) and press Enter.

After that you should add components to the created tab. Open it by clicking on it with the left mouse button, use the right mouse button to open its contextual menu and select the Choose Items item. After that you will see the dialog box shown below.

button to open its contextual menu and select the Choose Items item. After that you will

8

PERPETUUM software www.perpetuumsoft.com To sort the list by namespaces (the namespaces of all components begin

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com To sort the list by namespaces (the namespaces of all components begin from
PERPETUUM software www.perpetuumsoft.com To sort the list by namespaces (the namespaces of all components begin from

To sort the list by namespaces (the namespaces of all components begin from PerpetuumSoft), click on the Namespace column header.

Then select the following components: ReportManager, DesignerDataSourceTree, DesignerDocumentTree, DesignerErrorList, DesignerPropertyGrid, DesignerStatusBar, DesignerToolBar, DesignerToolBox, ReportDesigner, CSVExportFilter, ExcelExportFilter, ExcelXMLExportFilter, BitmapExportFilter, EmfExportFilter, GifExportFilter, JpgExportFilter, TiffExportFilter, HtmlExportFilter, PdfExportFilter, RTFExportFilter, ReportViewer, SharpShooterWebViewer and click OK.

To use Instrumentation ModelKit in Visual Studio 2005 you should add the following components onto the ToolBox: IndicatorWidget, Widget, WidgetHolder, WidgetProducer, OPCChannel, and OPCConnection. To use OLAP ModelKit, add these components: DataCube, DataCubePrintDocument, DataCubeGrid, DataCubeView. Chart ModelKit use requires the ChartViewer component added to Visual Studio ToolBox.

Components licensing

To license Perpetuum Software components, the mechanism based on the standard licensing scheme, realized in the System.ComponetModel is used.

After you purchased a license for the product the following steps are required to install your license:

If you already have your personal account on the Perpetuum Software LLC web site, log in to it under your current user name and password.

If you don‟t have your personal on the Perpetuum Software LLC web site, company representative will create it for you. Corresponding information on your account will be sent to the e-mail, specified in the order form.

create it for you. Corresponding information on your account will be sent to the e-mail, specified

9

PERPETUUM software www.perpetuumsoft.com Then, proceed to the „Downloads‟ section. Download and install evaluation

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Then, proceed to the „Downloads‟ section. Download and install evaluation

Then, proceed to the „Downloads‟ section. Download and install evaluation version of the product.

Note: If the current product version trial is already installed on your computer, there is no need to reinstall the software.

Look up for a license link for the product and click it. You will be prompted to download the zip-packed license key file. This file should contain the *.elic license file. If you purchased several licenses, license key file should include several different *.elic files, one for each purchased license.

Download and unpack the license key file. Open the file and launch the product LicenseManager from the 'Start' menu. In the License Manager, click the “Add License” button and copy-paste the registration key file content into the „Register Form‟ window. Then, click the “Registerbutton.

If you purchased several licenses for the product, you should install different licenses on the machines.

If the license has not been installed, you will get a warning that the trial version of the product is used.

When you add components or compile your project, the data on the installed license are added to the resources of your application. For that purpose, the license.licx file is created and included in the resources of your project. This license.licx file contains a list of the licensed components.

The license is being embedded in the project during the application compiling. And when you run your application on a machine where the license is not installed, the license will be taken from the resources of your application. It allows you to use your final application without installing the license on your end users machines.

We strongly recommend that you make sure that the data on the license have been included into your project before your final application is distributed. To do that, please make sure that the license.licx file is created and included into the root folder of your application and that this file contains description of all types of the used components. In addition, run your application on a machine where the license for the product is not installed.

Sometimes recompilation of the application does not cause recompilation of its resources. And it is possible that the license.licx file will not be created in some Integrated Development Environments (IDE). In this case, please do the following: make any minor changes on a form where the used components are located and recompile the application. These changes will force an IDE to recompile resources and refresh the license.licx file.

Each license has an expiration date. But it doesn‟t mean that your product will not work after this date. The expiration date indicates the date after which you will not be entitled to use your current license with the product versions released after this date. If you don‟t want to renew your license you are able to work with the previous product versions without any time limits.

If the project is created by a group of developers with use of several computers, it is required to install a unique license on each machine. Otherwise, if you use only one license and move your project to another machine, you will get a warning that the license is illegally used.

You will get this warning if the project has been developed on one machine but transported to another machine for some reason or another. It is not a violation, but you will get a warning while compilation. After that the license will be assigned to this machine and you will not get the warning.

a warning while compilation. After that the license will be assigned to this machine and you

10

PERPETUUM software www.perpetuumsoft.com If you do not use forms in your application or do not

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com If you do not use forms in your application or do not place

If you do not use forms in your application or do not place components on these forms but dynamically create them from the code, you can create the license.licx file manually. For example, your application uses report generator that runs the report designer, ReportViewer component and uses the ReportManager component. Then, the license.licx file should include the following:

PerpetuumSoft.Reporting.Components.ReportManager, PerpetuumSoft.Reporting, Version=<Version>, Culture=neutral, PublicKeyToken=<keytoken>

PerpetuumSoft.Reporting.View.ReportViewer, PerpetuumSoft.Reporting, Version=<Version>, Culture=neutral, PublicKeyToken=<keytoken>

PerpetuumSoft.Reporting.Designer.ReportDesigner, PerpetuumSoft.Reporting, Version=<Version>, Culture=neutral, PublicKeyToken=<keytoken>

If manual creation of this file causes difficulties, you may do the following. Create a temporary form (or a web page) in your application, place there all types of components you use and recompile the application. The license.licx file will be created and you may delete the temporary form. And the license.licx file will remain in your application resources.

If you create your application without using any visual tools and compile it from the command line, you should use the lc utility that is included into the .NET Framework SDK. For example, you create an application with the MyApplication.exe name and it uses the licensed components. Then, you should create the license.licx file with the list of components you use (how to create this file is described above) and write the following in the command line:

lc.exe /target:MyApplication.exe /complist:licenses.licx /i:PerpetuumSoft.Framework.dll /i:PerpetuumSoft.Reporting.dll

This utility creates resource file with licenses (we get the MyApplication.exe.licenses file in our example)

After that you should add this file to the resources of your application. For example:

csc /res:MyApplication.exe.licenses /reference:….

add this file to the resources of your application. For example: csc /res:MyApplication.exe.licenses /referen ce:…. 11

11

PERPETUUM software www.perpetuumsoft.com Product Localization The Perpetuum Software‟s products can be easily localized.

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Product Localization The Perpetuum Software‟s products can be easily localized.

Product Localization

The Perpetuum Software‟s products can be easily localized. All string resources used by the products are taken from the ad hoc localization XML-file.

There are several ways to set localization language:

1) One can set language by means of the SelectLanguage application included in the delivery package. This application changes the register record responsible for the language of Perpetuum Software‟s products.

for the language of Perpetuum Software‟s products. Here you can select one of the preinstalled languages

Here you can select one of the preinstalled languages (Select from list); set custom language using a custom localization file (Load from file); set default language (Default) or change the folder from which the list of languages is selected.

2) Another way is to set language from your application. To do it, use the types from the PerpetuumSoft.Framework.Localization namespace.

PerpetuumSoft.Framework.Localization.Language.CurrentLanguage is the current language.

You can change it by means of:

1. Loading a localization string from a special format file

PerpetuumSoft.Framework.Localization.LocalizationFile localizationFile = new PerpetuumSoft.Framework.Localization.LocalizationFile(); localizationFile.Read(<filePath>);

= new PerpetuumSoft.Framework.Localization. LocalizationFile (); localizationFile.Read(<filePath>); 12

12

PERPETUUM software www.perpetuumsoft.com PerpetuumSoft.Framework.Localization. Language language =

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com PerpetuumSoft.Framework.Localization. Language language =

PerpetuumSoft.Framework.Localization.Language language = PerpetuumSoft.Framework.Localization.Language(); language. AddLocalizationFile(localizationFile); PerpetuumSoft.Framework.Localization.Language.CurrentLanguage = language;

2. Setting default language

PerpetuumSoft.Framework.Localization.Language.CurrentLanguage = PerpetuumSoft.Framework.Localization.Language.DefaultLanguage;

3. Specifying localization language as a current language in the registry.

PerpetuumSoft.Framework.Localization.Language.CurrentLanguage = PerpetuumSoft.Framework.Localization.Language.CreateLanguageFromRegistrySettings();

If a language you need is not included in the package, you can create a localization file for a desired language on your own. You will need to translate all strings.

Upon your request, we can provide an XML-file containing the strings to be translated. After we receive translation of string resources, a localization file will be produced and provided to you.

Please feel free to contact us at support@perpetuumsoft.com in regard to localization issues.

and provided to you. Please feel free to contact us at support@perpetuumsoft.com in regard to localization

13

PERPETUUM software www.perpetuumsoft.com Report Sharp-Shooter Report Sharp-Shooter Getting Started Report Sharp-Shooter is

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Report Sharp-Shooter Report Sharp-Shooter Getting Started Report Sharp-Shooter is

Report Sharp-Shooter

Report Sharp-Shooter Getting Started

Report Sharp-Shooter is a flexible .Net report generator that allows user to create reports of any complexity based on unlimited number of sources of different types and to export ready documents to different file formats. Product components can be used in Windows forms, ASP.NET pages and Silverlight apps. The package includes Designer that allows editing ready report templates and documents. The report can contain different elements. Using a built-in component one can dynamically analyze data with the help of Pivot tables. Data used in the report can be presented as charts and diagrams.

Main Features

.Net 4.0 compatibility.

Completely controlled code.

Compatibility with the popular integrated .NET development environments.

WinForms, ASP.NET WebForms and Silverlight support.

ADO.NET compatibility.

Support any .NET objects as data source.

Report generation wizard.

Using any .NET language for expression and script creation.

Data binding model.

Easy processing of report transfer via Internet due to XML-based report files.

Report viewer components for WinForms, ASP.NET WebForms and Silverlight.

End user report designer.

Unlimited data sources for a single report.

Unlimited number of embedded and\or serial bands in the report.

Built-in component for Pivot table building.

Parameterized report creation and usage.

Parameterized sub-reports creation and usage.

SideBySide is advanced concept of a parallel report generation.

Unified reports can be generated in a short period of time.

Generated reports are stored as an object graph.

Complete document object model is easy to use and can be used both with report templates and ready documents.

Bound and unbound reports.

Export to the most widespread file formats is supported.

Manual section output control (optional).

Crystal Report import option.

Zip- and barcodes generation supported.

Built-in wide range of visual elements.

Opportunity to use GDI+ advances.

Unlimited number of pages with different size and layout can be included in a report.

Usage of headers and footers increases usability.

Water marks can be laid on the background.

Styles available.

Several measuring systems supported.

Detailed documentation and extensive base of examples available.

Easy deployment into your applications.

Distribution of Report Sharp-Shooter inside your application is free and does not require additional royalties.

Competent and up-to-date technical support in Russian and English is provided.

System Requirements

In order to create applications with .Net Model Kit Suite components it is recommended to use high-level integrated development environment as Microsoft Visual Studio 2005,

components it is recommended to use high-level integrated development environment as Microsoft Visual Studio 2005, 14

14

PERPETUUM software www.perpetuumsoft.com Microsoft Visual Studio 2008, Microsoft Visual Studio 2010, Borland Delphi 8,

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Microsoft Visual Studio 2008, Microsoft Visual Studio 2010, Borland Delphi 8,

Microsoft Visual Studio 2008, Microsoft Visual Studio 2010, Borland Delphi 8, Borland C# Builder, etc.

Microsoft .Net Framework 2.0 or higher is required for a successful installation. Microsoft .Net Framework 2.0 or higher is necessary for Report Sharp-Shooter for Silverlight usage. Minimal system requirements match Microsoft .Net Framework 2.0 requirements.

Installation

.Net Model Kit Suite is supplied as a Microsoft Installer package. Package file name is .NetModelKitSuite.msi. Run installation file and follow wizard instructions.

During the installation process one can add necessary components included into the product, add components to Visual Studio Toolbox (“Add components to Visual Studio Toolbox” button). This option is available in Microsoft Visual Studio 2005, Microsoft Visual Studio 2008 and Microsoft Visual Studio 2010. Otherwise (e.g. when using Microsoft Visual Studio Express Edition), one should add components manually. Let us examine the procedure of adding components in Microsoft Visual Studio.

1) Add a new tab to a toolbox using “Add tab” item of a contextual menu.

2) Select the added tab and click “Choose Items” menu of a toolbox.

3) Apply filter “Perpetuum” in order to find elements included into the product. All the components included into the .Net Model Kit Suite have “Perpetuum” word in the beginning of the name.

4) Check the components that are necessary for the complete functionality of Report Sharp- Shooter. If you need to use the product with WinForms you‟ll need the following components: ReportManager, DesignerDataSourcesTree, DesignerDocumentTree, DesignerErrorList, DesignerPropertyGrid, DesignerStatusBar, DesignerToolBar, DesignerToolBox, ReportDesigner, CsvExportFilter, ExcelExportFilter, ExcelXmlExportFilter, BitmapExportFilter, EmfExportFilter, GifExportFilter, JpgExportFilter, PngExportFilter, TiffExportFilter, HtmlExportFilter, PdfExportFilter, RtfExportFilter, XpsExportFilter, ReportViewer. SharpShooterWebViewer is used to display reports as Web pages. ReportViewer component included into PerpetuumSoft.Reporting.Silverlight.Client is used for making and displaying reports using Silverlight.

included into PerpetuumSoft.Reporting.Silverlight.Client is used for making and displaying reports using Silverlight. 15

15

PERPETUUM software www.perpetuumsoft.com 5) Press “Ok” and checked elements will be added to the current

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com 5) Press “Ok” and checked elements will be added to the current tab.
PERPETUUM software www.perpetuumsoft.com 5) Press “Ok” and checked elements will be added to the current tab.

5) Press “Ok” and checked elements will be added to the current tab.

If you use Windows Vista or Windows 7 with UAC enabled, run setup file as administrator. In order to do this, run CMD as administrator and then run setup file from it.

run setup file as administrator. In order to do this, run CMD as administrator and then

16

PERPETUUM software www.perpetuumsoft.com Editions Report Sharp-Shooter is available in the following editions: Express

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Editions Report Sharp-Shooter is available in the following editions: Express

Editions

Report Sharp-Shooter is available in the following editions:

Express Edition provides basic functionality of the product report design, preview and print. There are limitations connected to export options and the usage of several elements in the report, such as graphics, charts, diagrams and pivot tables. ReportViewer Windows Forms viewer component is included.

Lite Edition basic functionality is provided. One can display reports in WinForms, but there is no end-user ReportDesigner. ReportViewer is included.

Windows Forms Edition functionality allows building and displaying reports in Windows Forms. Contains ReportViewer and ReportDesigner end-user report designer that allows editing report templates and final documents.

Web Forms Edition functionality allows building and displaying reports as Web pages. SharpShooterWebViewer element that allows displaying reports as Web pages.

Win + Web Edition allows building and displaying reports as Windows Forms and Web pages. The package includes all the necessary components: ReportViewer, SharpShooterWebViewer, and ReportDesigner.

Professional Edition edition allows building and displaying reports as Windows Forms, Web pages and in Silverlight apps and contains complete source code.

Report Sharp Shooter for Silverlight offers developer functionality for building and displaying reports in Silverlight applications. The edition contains ReportViewer the component for report viewing in Silverlight applications.

Deploy

You don‟t have to do anything special to deploy a project using our product components. All you got to do is to copy compiled files into a folder in a computer file system or a web site. There is no need to install a product or license on a client computer. It is enough to have a licensed product on the developer‟s computer. License integrates into the product during compilation.

to have a licensed product on the developer‟s computer. License integrates i nto the product during

17

PERPETUUM software www.perpetuumsoft.com Getting Started Template of a report displaying current date, a logo and

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Getting Started Template of a report displaying current date, a logo and a

Getting Started

Template of a report displaying current date, a logo and a note.

1. Create a new project in Microsoft Visual Studio. Select “New\Project” main menu item.

Visual Studio. Select “New \ Project” main menu item. Select Windows Forms Application project template and

Select Windows Forms Application project template and set the name of a project – “SimpleReport”, specify a folder for the project to be saved.

project template and set the name of a project – “SimpleReport”, specify a folder for the
project template and set the name of a project – “SimpleReport”, specify a folder for the

18

PERPETUUM software www.perpetuumsoft.com 2. Open the main form of the application in the editor window

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com 2. Open the main form of the application in the editor window with

2. Open the main form of the application in the editor window with a double click on

“Form1.cs” in Solution Explorer.

with a double click on “Form1.cs” in Solution Explorer. Drag and drop “ReportManager” eleme nt from

Drag and drop “ReportManager” element from the Toolbox. This element stores collections of report templates and data sources.

stores collections of report templates and data sources. The component will be displayed in the lower

The component will be displayed in the lower part of a window.

component will be displayed in the lower part of a window. 3. On the property grid,

3. On the property grid, initialize the property OwnerForm of the ReportManager component

by selecting the form it is located on.

property grid, initialize the property OwnerForm of the ReportManager component by selecting the form it is

19

PERPETUUM software www.perpetuumsoft.com 4. Double- click “ReportManager” component to open ReportManager editor.

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com 4. Double- click “ReportManager” component to open ReportManager editor.

4. Double-click “ReportManager” component to open ReportManager editor.

“ReportManager” component to open ReportManager editor. Press “Add” button on the “Reports” tab and select

Press “Add” button on the “Reports” tab and select “InlineReportSlot”.

to open ReportManager editor. Press “Add” button on the “Reports” tab and select “InlineReportSlot”. 20

20

PERPETUUM software www.perpetuumsoft.com 5. Set report name in a ReportName property – “Simple Report”. Press

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com 5. Set report name in a ReportName property – “Simple Report”. Press

5. Set report name in a ReportName property – “Simple Report”.

Press “Run Designer” button to open Report Designer template editor.

Designer” button to open Report Designer template editor. 6. Create a new empty template – select

6. Create a new empty template select “New” item in the Application menu.

– select “New” item in the Application menu. Select “Blank Report” item in the Wizards gallery

Select “Blank Report” item in the Wizards gallery and press “OK”

“New” item in the Application menu. Select “Blank Report” item in the Wizards gallery and press

21

PERPETUUM software www.perpetuumsoft.com 7. Select “document” in the Document Tree. You w ill see properties

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com 7. Select “document” in the Document Tree. You w ill see properties of
PERPETUUM software www.perpetuumsoft.com 7. Select “document” in the Document Tree. You w ill see properties of

7. Select “document” in the Document Tree.

7. Select “document” in the Document Tree. You w ill see properties of the edited template

You will see properties of the edited template on the “Properties” window.

.
.

22

PERPETUUM software www.perpetuumsoft.com Set ScriptLanguage property to “CSharp”. 8. Go to the “Insert” tab.

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Set ScriptLanguage property to “CSharp”. 8. Go to the “Insert” tab.

Set ScriptLanguage property to “CSharp”.

Set ScriptLanguage property to “CSharp”. 8. Go to the “Insert” tab. Click “TextBox” button.

8. Go to the “Insert” tab. Click “TextBox” button.

8. Go to the “Insert” tab. Click “TextBox” button. Left-click to add TextBox to the template.

Left-click to add TextBox to the template.

Set Value property to “Now”.

TextBox to the template. Set Value proper ty to “Now”. Go to “Format” tab of TextBox

Go to “Format” tab of TextBox tab set. Select “Date” value in the TextFormat list.

proper ty to “Now”. Go to “Format” tab of TextBox tab set. Select “Date” value in

23

PERPETUUM software www.perpetuumsoft.com 9. Add one more TextBox element to the template. Open Text Editor

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com 9. Add one more TextBox element to the template. Open Text Editor (by

9. Add one more TextBox element to the template. Open Text Editor (by double click on the TextBox or by pressing Enter key). Type “My first report”.

or by pressing Enter key). Type “My first report”. 10. Go to the “Insert” tab. Cl

10. Go to the “Insert” tab. Click “Picture” button.

Go to the “Insert” tab. Cl ick “ Picture ” button . Left-click on the template

Left-click on the template to add Picture element

Double-click Picture element area to open dialog window setting path to the image. Choose a logo image and press “Open” button.

Go to “Format” tab of Picture tab set. Click “Size Mode” button and choose “Uniform” property value.

Mode” button and choose “Uniform” property value. Report Template: 11. Save the template and close Report

Report Template:

button and choose “Uniform” property value. Report Template: 11. Save the template and close Report Designer.

11. Save the template and close Report Designer.

button and choose “Uniform” property value. Report Template: 11. Save the template and close Report Designer.

24

PERPETUUM software www.perpetuumsoft.com 12. Right- click on the form and select “View code” item of

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com 12. Right- click on the form and select “View code” item of a

12. Right-click on the form and select “View code” item of a context menu in order to switch to the code.

item of a context menu in order to switch to the code. Add report displaying code

Add report displaying code to the class constructor. Create RenderComplited event handler of the InlineReportSlot object.

public partial class Form1 : Form

{

public Form1()

{

InitializeComponent(); inlineReportSlot.RenderCompleted += new EventHandler(reportSlot_RenderCompleted); inlineReportSlot.Prepare();

}

private void reportSlot_RenderCompleted(object sender, EventArgs e)

{

using (PerpetuumSoft.Reporting.View.PreviewForm previewForm = new PerpetuumSoft.Reporting.View.PreviewForm(inlineReportSlot))

{

previewForm.WindowState = FormWindowState.Maximized; previewForm.ShowDialog(this);

}

}

}

(inlineReportSlot)) { previewForm.WindowState = FormWindowState .Maximized; previewForm.ShowDialog( this ); } } } 25

25

PERPETUUM software www.perpetuumsoft.com 12. Switch back to the application form – click Form1.cs[Design] tab. Add

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com 12. Switch back to the application form – click Form1.cs[Design] tab. Add two

12. Switch back to the application form click Form1.cs[Design] tab.

Add two buttons onto the form (drag and drop “Button” element from the Toolbox to the form).

drop “Button” element from the Toolbox to the form). Select “Button” element on the form, change

Select “Button” element on the form, change Text property. Set Text = Template for the first button and Text = Report for the second one.

for the first button and Text = Report for the second one. Create Click event handlers

Create Click event handlers for the buttons double-click Button element on the form. Add code that starts report generation to the handler. E.g., the following code:

private void button1_Click(object sender, EventArgs e)

{

inlineReportSlot.DesignTemplate();

}

private void button2_Click(object sender, EventArgs e)

{

inlineReportSlot.Prepare();

}

13. Press “Start Debugging” button on the Visual Studio Toolbar to run the application.

Generated report in Report Viewer.

“Start Debugging” button on the Visual Studio Toolbar to run the application. Generated report in Report

26

PERPETUUM software www.perpetuumsoft.com The “Template” button opens template with Report Editor for editing. The

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com The “Template” button opens template with Report Editor for editing. The
PERPETUUM software www.perpetuumsoft.com The “Template” button opens template with Report Editor for editing. The

The “Template” button opens template with Report Editor for editing. The “Report” button generates report and opens it with Report Designer.

template with Report Editor for editing. The “Report” button generates report and opens it with Report

27

PERPETUUM software www.perpetuumsoft.com Basic Information Basic Terms Let‟s consider basic terms u sed to work

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Basic Information Basic Terms Let‟s consider basic terms u sed to work with

Basic Information

Basic Terms

Let‟s consider basic terms used to work with Report Sharp-Shooter.

Report Template

Report Template is an object of the PerpetuumSoft.Reporting.DOM.Document class with the IsTemplate property set to “True”, containing one or multiple pages containing some elements. Appearance of the final report is set by layout of these elements in a respective way and initialization of their properties. For example, you set report data sources to get data for reports and the way this data is displayed. Template contains scripts that are executed during report generation. Template file are of xml format and .rst extension; you can get it by saving template from the Report Designer. Objects of the PerpetuumSoft.Reporting.Components.ReportSlotclass are used to store report template. LoadReport and SaveReport methods of the ReportSlot objects are used to get and save report template.

(More information about report template)

Report Designer

Report Designer is a component used to create and edit templates. It provides the ability to set template properties and template page properties, add objects, set their layout and properties, set report data sources and to define report appearance and content of the report. With Report Designer it is possible to save template or open saved templates for editing and forming reports. It is possible to call Report Viewer from the Report Designer to view formed reports.

(More information about Report Designer)

ReportManager

ReportManager is a component to store report and data source collections. It is possible to access objects collection storing report templates via the Reports property; data sources collection is available via the DataSource property.

Final Document

Final Document is an object of the PerpetuumSoft.Reporting.DOM.Document class with the IsTemplate property set to False. It contains only those elements that contain visible information such as text, charts, gauge or pictures. Final document file is of xml format and .rsd extension.

Report Viewer

Report Viewer is a component used to view final document. The following manipulations over the document are available: zoom, search, bookmark tree, various view parameters. It is possible to export, print and save reports to a file. To edit final document it is necessary to run Report Designer.

(More information about Report Viewer)

Export Filter

Report Sharp-Shooter provides the ability to export final document to many popular formats as GIF, PNG, JPG, BMP, EMF, PDF, HTML, CSV, TXT, Excel, XML, XML for Excel, RTF.

(More information about export filters)

GIF, PNG, JPG, BMP, EMF, PDF, HTML, CSV, TXT, Excel, XML, XML for Excel, RTF. (More

28

PERPETUUM software www.perpetuumsoft.com Interaction Schema Below is a schema of the report life cycle. Main

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Interaction Schema Below is a schema of the report life cycle. Main Components

Interaction Schema

Below is a schema of the report life cycle.

Schema Below is a schema of the report life cycle. Main Components Used to Create a

Main Components Used to Create a Report

Appearance of the final document is defined by the objects contained in the report template. Every object has a set of properties; when you set them you define report appearance. These properties can be set by a constant value or expression that will be calculated during report rendering. These are binding scripts.

All objects used to create a report can be divided into two classes: bands and visual elements.

Bands are not displayed in the final document; they are containers for other elements and are designed to set the way of displaying elements they contain: form lists, tables, set data sources, set grouping and sorting conditions. Some bands can be containers for other bands.

(More information about bands)

Visual elements of the report are used to display data of various types: text, pictures, zip and bar codes, shapes, image of the Windows Forms controls. Properties of the visual elements set format and style of data.

(More information about visual elements)

Using Data Sources

ADO.NET objects, custom classes implementing System.ComponentModel.IListSource of System.Collection.IEnumerable interface and other data sources. In the last case, properties of the passed object will be used report data.

It is possible to set data sources using ReportManager; such data sources will be available for all report templates stored in this ReportManager. Besides, data sources can be built in the certain template. Built-in data sources can be of three types: SqlDataSource, XmlDataSource and OdbcDataSource. (More information about data sources)

sources can be of three types: SqlDataSource, XmlDataSource and OdbcDataSource. (More information about data sources )

29

PERPETUUM software www.perpetuumsoft.com Using Scripts Scripts are used to set expressions that are calculated during

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Using Scripts Scripts are used to set expressions that are calculated during

Using Scripts

Scripts are used to set expressions that are calculated during report generation Result of expressions calculation can be used as property values. Scripts can be used to generate element in the final report and manual layout of report elements.

Scripts are expressions on some programming language. It is possible to use any .Net programming language.

It is possible to create and use instances of any classes available for the application using Report Sharp-Shooter during report generation.

(More information about scripts)

Binding Elements to Data

Data binding is used in reports displaying data from the data source and it is executed in two passes. At first, object that will be used as a data source is set. Then field for the certain element is set. If report data source is a collection element, collection element field is set; and an element nested inside DataBand is used to display list. If the object is not a collection, report can display its properties. Binding final elements to data sources is executed by the binding expressions.

(More information about data binding)

Document Generation

To start report generation process the following methods of the ReportSlot objects are used:

Prepare and RenderDocument. The difference between these two methods is that Prepare method executes report generation process in a separate thread. ReportManager has OwnerForm property used to set thread of the form report generation events will be executed in. Initialization of this property may be required if event handlers refer to elements located on the form. Execution of such handlers in a separate thread may result in System.InvalidOperationException.

In order to control and have the ability to declare about report rendering process, it is possible to use overloads of the Prepare and RenderDocument methods; these overloads get object as a parameter and implement IRenderSite interface. Object implementing this interface can be used to get information on report generation process. It is just necessary to set object methods described in the interface.

If the template uses elements that get data from the data source, data source with the set in the element name is searched during report generation. Search is executed among sources added to ReportManager that is included in the current ReportSlot and among built- in data source. Besides, when you get data source, event is called; you can handle it to dynamically connect to a data source.

Report parameters may be required during report generation. GetReportParameter event is used to get parameters. It is necessary to initialize collection of named parameters in its handler: this collection can be got via Parameters property of the PerpetuumSoft.Reporting.Components.GetReportParameterEventArgs object. Instance of this class is delegated to the handler as a parameter. Please pay attention to the fact that if parameter values are got from the controls properties, it is necessary to initialize OwnerForm property of the corresponding ReportManager. If SubReport is used in the report, the corresponding ReportManager should contain ReportSlot with the ReportName property matching SubReport.TemplateName property. If the nested template is created dynamically, it is possible to use ResolveSubReport event of the ReportManager to initialize it. PerpetuumSoft.Reporting.Components.ResolveSubReportEventArgs object is passed to this handler as a parameter. This object has a TemplateName property; this property defines what nested report is necessary and passes it via the Template property. (More information about managing report generation)

nested report is necessary and passes it via the Template property. (More information about managing report

30

PERPETUUM software www.perpetuumsoft.com Visualization and Editing Final Documents In order to view final document it

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Visualization and Editing Final Documents In order to view final document it is

Visualization and Editing Final Documents

In order to view final document it is possible to use Windows Forms component ReportViewer; to view reports from ASP.NET applications use SharpShooterWebViewer.

Final document consists of only visual elements generated and located in the report in accordance with report template. Final document can be opened in the Report Designer to edit all static properties of the elements: size, layout, style. It is also possible to add new visual elements to the document. When you add bands, they will be displayed in the final document in the way they are displayed in the Report Designer.

Export, Print and Saving

After the creation final document can be delivered to the customer in various forms. Report Sharp-Shooter offers report export to various formats: PDF, GIF, HTML, XML for Excel, RTF, etc. There are some options to set export parameters, for example, picture quality settings, selecting certain page of the document, etc.

Final document can be saved to hard disk. Document is saved in the xml format with .rsd

extension.

.rsd files are associated with the Report Viewer.

It is possible to print document from the Report Viewer. Print settings specify numbers of the printed pages and the amount of document copies.

document from the Report Viewer. Print settings specify numbers of the printed pages and the amount

31

PERPETUUM software www.perpetuumsoft.com Report Designer Interface Report designer is designated to create and edit report

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Report Designer Interface Report designer is designated to create and edit report

Report Designer Interface

Report designer is designated to create and edit report templates. In the designer, you can add pages, and objects to the template, set their static and dynamic properties, and connect to data sources.

Tabs

Home Tab

This tab contains the most frequently used commands.

Tab This tab contains the most frequently used commands. Clipboard Group This group contains buttons for

Clipboard Group

This group contains buttons for working with the clipboard.

This group contains buttons for working with the clipboard. The “Paste Objects” button pastes the contents

The “Paste Objects” button pastes the contents of the Clipboard into the selected area.

The “Cut Objects” button cuts the selected objects and put it on the Clipboard.

The “Copy Objects” button copies the selected objects and put it on the Clipboard.

The “Delete Objects” button deletes the selected objects.

Font Group

This group contains controls for working with Font property.

This group contains controls for working with Font property. The “Font Name” list contains available styles

The “Font Name” list contains available styles (sets the Font.FamilyName property).

The “Font Size” list contains size values and allows the setting of arbitrary size (sets the Font.Size property).

The “Bold” button sets bold font for the text (sets the Font.Bold property).

The “Italic” button sets italic font for the text (sets the Font.Italic property).

The “Underline” button sets underlined font for the text (sets the Font.Underline property).

The “Increase Font Size” button increase font size (sets the Font.Size property).

The “Decrease Font Size” button decrease font size (sets the Font.Size property).

(sets the Font.Size property). The “Decrease Font Size” button decrease font size (sets the Font.Size property).

32

PERPETUUM software www.perpetuumsoft.com The “Text Fill” button sets color and fill for text (sets the

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com The “Text Fill” button sets color and fill for text (sets the TextFill

The “Text Fill” button sets color and fill for text (sets the TextFill property of the selected object).

text (sets the TextFill property of the selected object). The “Theme Fills” and “Standard Fills” sections

The “Theme Fills” and “Standard Fills” sections contain color pallete.

The “Recent Fills” section contains fills, which were recently used.

The “No Fill” menu item cancels all fill settings and sets TextFill property to “[None]”.

The “More Fills…” menu item opens “Fill Editor” for creating custom fill.

The “Use Style Only” button sets the style settings. These settings correspond to the selected style and remove all changes.

Alignment group

The “Alignment” table allows setting TextAlign and ImageAlign properties.

table allows setting TextAlign and ImageAlign properties. The “Angle” button sets Angle property, opens the list

The “Angle” button sets Angle property, opens the list of allowed property values.

and ImageAlign properties. The “Angle” button sets Angle property, opens the list of allowed property values.

33

PERPETUUM software www.perpetuumsoft.com Border & Fill Group The “Fill” button sets color and fill f

PERPETUUM

software

www.perpetuumsoft.com

Border & Fill Group

software www.perpetuumsoft.com Border & Fill Group The “Fill” button sets color and fill f or background
software www.perpetuumsoft.com Border & Fill Group The “Fill” button sets color and fill f or background

The “Fill” button sets color and fill for background (sets the Fill property).

color and fill f or background (sets the Fill property). The “Theme Fills” and “Standard Fills”

The “Theme Fills” and “Standard Fills” sections contain color pallete.

The “Recent Fills” section contains fills, which were recently used.

The “No Fill” menu item cancels all fill settings and sets Fill property to “[None]”.

The “More Fills…” menu item opens “Fill Editor” for creating custom fill.

The “Border” button sets border (sets the Border property).

“Border” button sets border (sets the Border property). 1 – This menu items set borders lines

1 This menu items set borders lines location.

2 This submenu items set border lines style and color: the “Line

Color” submenu contains color palette; the “Line Style” submenu contains line types.

3 – The “More Borders…” menu item opens “Border Editor”.

The “Margins” button opens “Margins Editor” for setting Margins property.

menu item opens “Border Editor”. The “Margins” button opens “Margins Editor” for setting Margins property. 34

34

PERPETUUM software Styles Group www.perpetuumsoft.com The “Styles Gallery” includes preview of the template‟s

PERPETUUM

software

Styles Group

www.perpetuumsoft.com

PERPETUUM software Styles Group www.perpetuumsoft.com The “Styles Gallery” includes preview of the template‟s
PERPETUUM software Styles Group www.perpetuumsoft.com The “Styles Gallery” includes preview of the template‟s

The “Styles Gallery” includes preview of the template‟s styles. Click on style‟s preview applies this style to the selected object (sets StyleName property).

this style to the selected object (sets StyleName property). The “Save Selection as a New Style”

The “Save Selection as a New Style” menu Item opens “Create New Style from Formatting” dialog for setting name of new style and saves the style of selected object.

The “Select Controls with Similar Style” menu item selects all objects on the current page, which StyleName property is set to the style of selected object.

The “Edit Style” button opens “Style Sheet Editor”.

Select Group

The “Select” button switches the Select Mode on.

Style” button opens “Style Sheet Editor”. Select Group The “Select” button switches the Select Mode on.

35

PERPETUUM software www.perpetuumsoft.com Insert Tab This tab allows adding objects to a template. Buttons are

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Insert Tab This tab allows adding objects to a template. Buttons are divided

Insert Tab

This tab allows adding objects to a template. Buttons are divided into groups.

objects to a template. Buttons are divided into groups. 1 – The “Page” group contains buttons,

1 – The “Page” group contains buttons, which allow adding new pages, PageHeader, Page Overlay and PageFooter bands.

2 – The “Text” group contains buttons, which allow adding text output elements: TextBox,

AdvancedText and RichText.

3 – The “Illustration” group contains buttons, which allow adding various visual elements:

Picture, Shape, ZipCode, BarCode, ChartControl, Widget and WinFormsControl.

4 – The “Container” group contains buttons, which allow adding various bands: DataBand,

GroupBand, BandContainer, SideBySide, CrossBand, Header, Detail, Footer, SubReport, Content and PivotTable bands.

5 – The “Obsolete” group contains buttons, which allow adding GroupHeader and

GroupFooter bands, which are obsolete and needed for backward versions compatibility. But it is not recommended to use these components to create new reports. GroupBand together with Header and Footers should be used.

(Read more about Template Objects)

to create new reports. GroupBand together with Header and Footers should be used. (Read more about

36

PERPETUUM software www.perpetuumsoft.com Layout Tab This tab contains controls that affect the page layout, spacing

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Layout Tab This tab contains controls that affect the page layout, spacing and

Layout Tab

This tab contains controls that affect the page layout, spacing and positioning objects.

affect the page layout, spacing and positioning objects. 1 – The “Page Layout” group contains buttons,

1 – The “Page Layout” group contains buttons, which allow setting page properties:

The “Orientation” button sets Page.Orientation property. It opens the list of property‟s values.

property. It opens the list of property‟s values. The “Size” button sets Page.PaperKind property. It opens

The “Size” button sets Page.PaperKind property. It opens the list of property‟s values. The “Custom” menu item opens “Paper Size Editor” to set custom page size.

item opens “Paper Size Editor” to set custom page size. 2 – The “Arrangement” group allows

2 – The “Arrangement” group allows management of object size and position:

The “Size to Grid” button changes size of selected object to snap it to grid.

The “Align” button opens the “Align” Editor for objects alignment setting.

selected object to snap it to grid. The “Align” button opens the “Align” Editor for objects

37

PERPETUUM software www.perpetuumsoft.com The “Move Forward” menu item brings the selected object forward so that

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com The “Move Forward” menu item brings the selected object forward so that it
PERPETUUM software www.perpetuumsoft.com The “Move Forward” menu item brings the selected object forward so that it

The “Move Forward” menu item brings the selected object forward so that it is hidden by fewer objects that are in front of it in the current container.

The “Bring to Front” menu item brings the selected objects in front of all other objects so that no part of it is hidden behind another object in the current container.

it is hidden behind another object in the current container. The “Move Back” menu item sends

The “Move Back” menu item sends the selected objects backward so that it is hidden by the objects that are in front of it in the current container.

The “Send to Back” menu item sends the selected objects behind all other objects in the current container.

The “Size” button changes sizes of the selected objects. Menu items set the parameter as main selected object.

The “Size” button changes sizes of the selected objects. Menu items set the parameter as main

38

PERPETUUM software View Tab www.perpetuumsoft.com This tab contains controls that affect the template view, including

PERPETUUM

software

View Tab

www.perpetuumsoft.com

PERPETUUM software View Tab www.perpetuumsoft.com This tab contains controls that affect the template view, including view

This tab contains controls that affect the template view, including view mode, show/hide options, zooming and window management.

view mode, show/hide options, zooming and window management. 1 – The “Show/Hide” group allows setting designer

1 – The “Show/Hide” group allows setting designer view:

The “Show Grid” checkbox switches on/off the display of a grid (sets the Document.ShowGrid property).

The “Snap to Grid” checkbox switches on/off the option of binding to a grid (sets the Document.SnapToGrid property).

The “Show Rulers” checkbox switches on/off the display of a rule.

The “Show Object Bounds” checkbox switches on/off the display of objects bounds (sets the Document.ShowObjectBounds property).

The “Layout Bands” checkbox switches on/off the option of automatic layout of the bands.

2 – The “Zoom & Pan” group allows setting zoom and Pan Mode.

3 – The “Windows” group contains buttons allows open Properties, Document Tree, Data

Sources and Error List windows.

The “Windows” group contains buttons allows open Properties, Document Tree, Data Sources and Error List windows.

39

PERPETUUM software www.perpetuumsoft.com Contextual Tabs Contextual tabs are used to display a collection of commands

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Contextual Tabs Contextual tabs are used to display a collection of commands that

Contextual Tabs

Contextual tabs are used to display a collection of commands that are relevant only when particular object is selected.

TextBox Tab Set

The TextBox tab set includes “Format” tab.

Tab Set The TextBox tab set includes “Format” tab. The “Format” tab for TextBox includes f

The “Format” tab for TextBox includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: CanGrow, CanShrink, GrowToBottom and Visible.

2 – The “TextFormat” group sets TextFormat property. The list contains available property‟s

values. The buttons allow set Currency, Percentage and Number format quickly.

3 – The “Font” group allows setting Font property.

4 – The “Alignment” group allows setting TextAlign property.

5 – The “Appearance” group contains buttons for setting Appearance properties: Angle,

Border, Fill and Margins.

6 – The “Styles” group allows setting StyleName property.

AdvancedText Tab Set

The AdvancedText tab set includes “Format” tab.

Tab Set The AdvancedText tab set includes “Format” tab. The “Format” tab for AdvancedText includes following

The “Format” tab for AdvancedText includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: CanBreak, CanGrow, CanShrink, GrowToBottom and Visible.

2 – The “TextFormat” group sets TextFormat property. The list contains available property‟s

values. The buttons allow set Currency, Percentage and Number format quickly.

3 – The “Font” group allows setting Font property.

4 – The “Alignment” group allows setting TextAlign property.

5 – The “Appearance” group contains buttons for setting Appearance properties: Angle,

Border, Fill and Margins.

6 – The “Styles” group allows setting StyleName property.

properties: Angle, Border, Fill and Margins. 6 – The “Styles” group allows setti ng StyleName property.

40

PERPETUUM software www.perpetuumsoft.com RichText Tab Set The RichText tab set includes “Format” tab. The

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com RichText Tab Set The RichText tab set includes “Format” tab. The

RichText Tab Set

The RichText tab set includes “Format” tab.

Tab Set The RichText tab set includes “Format” tab. The “Format” tab for RichText includes following

The “Format” tab for RichText includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: CanGrow, CanShrink, GrowToBottom and Visible.

2 – The “Appearance” group contains buttons for setting Appearance properties: Angle,

Border, Fill and Margins.

3 – The “Styles” group allows setting StyleName property.

Picture Tab Set

The Picture tab set includes “Format” tab.

Tab Set The Picture tab set includes “Format” tab. The “Format” tab for Picture includes following

The “Format” tab for Picture includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: GrowToBottom and Visible.

2 – The “Alignment” group sets ImageAlign property.

3 – The “Settings” group contains the “Size Mode” button, which sets SizeMode property,

opens the list of allowed property values.

property, opens the list of allowed property values. 4 – The “Appearance” group contains buttons for

4 – The “Appearance” group contains buttons for setting Appearance properties: Angle,

Border, Fill and Margins.

5 – The “Styles” group allows setting StyleName property.

properties: Angle, Border, Fill and Margins. 5 – The “Styles” group allows setting StyleName property. 41

41

PERPETUUM software www.perpetuumsoft.com Shape Tab Set The Shape tab set includes “Format” tab. The “Format”

PERPETUUM

software

www.perpetuumsoft.com

Shape Tab Set

The Shape tab set includes “Format” tab.

Shape Tab Set The Shape tab set includes “Format” tab. The “Format” tab for Shape includes
Shape Tab Set The Shape tab set includes “Format” tab. The “Format” tab for Shape includes

The “Format” tab for Shape includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: GrowToBottom and Visible.

2 – The “Appearance” group contains buttons for setting Appearance properties: Fill, Line

and Shadow.

The “Line” button allows setting the line of shape: Line Color, Width and Style.

setting the line of shape: Line Color, Width and Style. The “Line Color” menu item contains

The “Line Color” menu item contains color palette; the “Line Style” submenu contains line types.

The “Shadow” button sets the shadow of shape.

types. The “Shadow” button sets the shado w of shape. 2.1 – The area for setting

2.1 The area for setting shadow location.

2.2 – The “Fill” menu item opens color palette for setting shadow fill.

2.3 – The “Custom Shadow” menu item opens Shadow Editor for setting shadow properties.

for setting shadow fill. 2.3 – The “Custom Shadow” menu item opens Shadow Editor for setting

42

PERPETUUM software www.perpetuumsoft.com 3 – The “Styles” group allows se tting StyleName property. ZipCode Tab

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com 3 – The “Styles” group allows se tting StyleName property. ZipCode Tab Set

3 – The “Styles” group allows setting StyleName property.

ZipCode Tab Set

The ZipCode tab set includes “Format” tab.

Tab Set The ZipCode tab set includes “Format” tab. The “Format” tab for ZipCode includes following

The “Format” tab for ZipCode includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: GrowToBottom and Visible.

2 – The “Appearance” group contains buttons for setting Appearance properties: Angle,

Border, Fill, Margins and Color, which sets ZipCode.Color property.

3 – The “Styles” group allows setting StyleName property.

BarCode Tab Set

The BarCode tab set includes “Format” tab.

Tab Set The BarCode tab set includes “Format” tab . The “Format” tab for BarCode includes

The “Format” tab for BarCode includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: GrowToBottom and Visible.

2 – The “Font” group allows setting Font property.

3 – The “BarCode Settings” group contains is for setting special BarCode‟s properties:

The “Label” list contains LabelPosition property values and “None” value for setting ShowLabel property to “False”.

value for setting ShowLabel property to “False”. The “Back Color”, “Bar Color” and “Text Color”

The “Back Color”, “Bar Color” and “Text Color” buttons set BackColor, BarColor and TextColor properties.

The “Back Color”, “Bar Color” and “Text Color” buttons set BackColor, BarColor and TextColor properties. 43

43

PERPETUUM software www.perpetuumsoft.com 4 – The “Appearance” group contains buttons for setting Appearance

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com 4 – The “Appearance” group contains buttons for setting Appearance
PERPETUUM software www.perpetuumsoft.com 4 – The “Appearance” group contains buttons for setting Appearance

4 – The “Appearance” group contains buttons for setting Appearance properties: Angle,

Border, Fill and Margins.

5 – The “Styles” group allows setting StyleName property.

ChartControl Tab Set

The ChartControl tab set includes “Format” tab.

Tab Set The ChartControl tab set includes “Format” tab. The “Format” tab for ChartControl includes following

The “Format” tab for ChartControl includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: GrowToBottom and Visible.

2 – The “Data Settings” group contains control for setting DataSource property.

3 – The “Appearance” group contains buttons for setting Appearance properties: Angle,

Border, Fill and Margins.

5 – The “Styles” group allows setting StyleName property.

Widget Tab Set

The Widget tab set includes “Format” tab.

Widget Tab Set The Widget tab set includes “Format” tab. The “Format” tab for Widget includes

The “Format” tab for Widget includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: GrowToBottom and Visible.

2 – The “Appearance” group contains buttons for setting Appearance properties: Angle,

Border, Fill and Margins.

2 – The “Appearance” group contains buttons for setting Appearance properties: Angle, Border, Fill and Margins.

44

PERPETUUM software www.perpetuumsoft.com 3 – The “Styles” group allows setti ng StyleName property. WinFormsControl

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com 3 – The “Styles” group allows setti ng StyleName property. WinFormsControl

3 – The “Styles” group allows setting StyleName property.

WinFormsControl Tab Set The WinFormsControl tab set includes “Format” tab.

Set The WinFormsControl tab set includes “Format” tab. The “Format” tab for WinFormsControl includes following

The “Format” tab for WinFormsControl includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: GrowToBottom and Visible.

2 – The “Appearance” group contains buttons for setting Appearance properties: Angle,

Border, Fill and Margins.

3 – The “Styles” group allows setting StyleName property.

DataBand Tab Set

The DataBand tab set includes “Format” tab.

Tab Set The DataBand tab set includes “Format” tab. The “Format” ta b for DataBand includes

The “Format” tab for DataBand includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: CanGrow,

CanShrink, NewColumnAfter, NewColumnBefore, NewPageAfter, NewPageBefore and Visible.

2 – The “Data Settings” group contains controls for setting following properties:

DataSource, InstanceCount, Sort, Totals and FilterExpression.

3 – The “Columns” group contains controls for setting following properties: ColumnsCount

and ColumnsGap.

4 – The “Styles” group allows setting StyleName property.

GroupBand Tab Set

The GroupBand tab set includes “Format” tab.

Tab Set The GroupBand tab set includes “Format” tab. The “Format” tab for GroupBand includes following

The “Format” tab for GroupBand includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: CanGrow,

CanShrink, NewColumnAfter, NewColumnBefore, NewPageAfter, NewPageBefore and Visible.

2 – The “Data Settings” group contains controls for setting following properties:

GroupExpression, SortExpression and Order.

Settings” group contains controls for setting following properties: GroupExpression, SortExpression and Order. 45

45

PERPETUUM software www.perpetuumsoft.com 3 – The “Columns” group contains controls for setting following

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com 3 – The “Columns” group contains controls for setting following

3 – The “Columns” group contains controls for setting following properties: ColumnsCount

and ColumnsGap.

4 – The “Styles” group allows setting StyleName property.

BandContainer Tab Set

The BandContainer tab set includes “Format” tab.

Set The BandContainer tab set includes “Format” tab. The “Format” tab for BandContainer includes following

The “Format” tab for BandContainer includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: CanGrow,

CanShrink, NewColumnAfter, NewColumnBefore, NewPageAfter, NewPageBefore and Visible.

2 – The “Styles” group allows setting StyleName property.

SideBySide Tab Set

The SideBySide tab set includes “Format” tab.

Tab Set The SideBySide tab set includes “Format” tab. The “Format” tab for SideBySide includes following

The “Format” tab for SideBySide includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: CanGrow,

CanShrink, NewColumnAfter, NewColumnBefore, NewPageAfter, NewPageBefore and Visible.

2 – The “Styles” group allows setting StyleName property.

CrossBand Tab Set

The CrossBand tab set includes “Format” tab.

Tab Set The CrossBand tab set includes “Format” tab. The “Format” tab for CrossBand includes following

The “Format” tab for CrossBand includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: CanGrow, CanShrink and Visible.

2 – The “Data Settings” group contains controls for setting following properties: DataSource

and InstanceCount.

2 – The “Data Settings” group contains controls for setting following properties: DataSource and InstanceCount. 46

46

PERPETUUM software www.perpetuumsoft.com 3 – The “Styles” group allows setting StyleName property. Header Tab Set

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com 3 – The “Styles” group allows setting StyleName property. Header Tab Set

3 – The “Styles” group allows setting StyleName property.

Header Tab Set

The Header tab set includes “Format” tab.

Tab Set The Header tab set includes “Format” tab. The “Format” tab for Header includes following

The “Format” tab for Header includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: CanBreak, CanGrow, CanShrink, NewColumnAfter, NewColumnBefore, NewPageAfter, NewPageBefore, RepeatEveryColumn, RepeatEveryPage and Visible; counter MinSpaceAfter sets MinSpaceAfter property.

2 – The “Styles” group allows setting StyleName property.

Footer Tab Set

The Footer tab set includes “Format” tab.

Tab Set The Footer tab set includes “Format” tab. The “Format” tab for Footer includes following

The “Format” tab for Footer includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: CanBreak,

CanGrow, CanShrink, NewColumnAfter, NewColumnBefore, NewPageAfter, NewPageBefore,

PlaceInBottom and Visible; counter MinSpaceAfter sets MinSpaceAfter property.

2 – The “Styles” group allows setting StyleName property.

Detail Tab Set

The Detail tab set includes “Format” tab.

Tab Set The Detail tab set includes “Format” tab. The “Format” tab for Detail includes following

The “Format” tab for Detail includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: CanBreak, CanGrow, CanShrink, NewColumnAfter, NewColumnBefore, NewPageAfter, NewPageBefore and Visible; counter MinSpaceAfter sets MinSpaceAfter property.

2 – The “Styles” group allows setting StyleName property.

SubReport Tab Set

The SubReport tab set includes “Format” tab.

group allows setting StyleName property. SubReport Tab Set The SubReport tab set includes “Format” tab. 47

47

PERPETUUM software www.perpetuumsoft.com

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com
PERPETUUM software www.perpetuumsoft.com

The “Format” tab for SubReport includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: CanGrow,

CanShrink, NewColumnAfter, NewColumnBefore, NewPageAfter, NewPageBefore and Visible.

2 – The “SubReport Settings” group contains controls for setting following properties:

Parameters, TemplateName and Shift.

3 – The “Styles” group allows setting StyleName property.

Content Tab Set

The Content tab set includes “Format” tab.

Tab Set The Content tab set includes “Format” tab. The “Format” tab for Content includes following

The “Format” tab for Content includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: CanGrow,

CanShrink, NewColumnAfter, NewColumnBefore, NewPageAfter, NewPageBefore and Visible.

2 – The “Content Settings” group contains control for setting Shift property.

3 – The “Styles” group allows setting StyleName property.

PivotTable Tab Set

The PivotTable tab set includes “Format” tab.

Tab Set The PivotTable tab set includes “Format” tab. The “Format” tab for PivotTable includes following

The “Format” tab for PivotTable includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: CanGrow,

CanShrink, NewColumnAfter, NewColumnBefore, NewPageAfter, NewPageBefore and Visible.

2 – The “Data Settings” group contains controls for setting following properties:

DataSource, FilterExpression and Layout.

3 – The “Styles” group allows setting StyleName property.

properties: DataSource, FilterExpression and Layout. 3 – The “Styles” group allows setting StyleName property. 48

48

PERPETUUM software www.perpetuumsoft.com PageHeader Tab Set The PageHeader tab set includes “Format” tab. The

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com PageHeader Tab Set The PageHeader tab set includes “Format” tab. The

PageHeader Tab Set

The PageHeader tab set includes “Format” tab.

Tab Set The PageHeader tab set includes “Format” tab. The “Format” tab for PageHeader includes following

The “Format” tab for PageHeader includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: CanGrow, CanShrink, Visible and list Mode, which contains Mode property value.

2 – The “Styles” group allows setting StyleName property.

PageFooter Tab Set

The PageFooter tab set includes “Format” tab.

Tab Set The PageFooter tab set includes “Format” tab. The “Format” tab for PageFooter includes following

The “Format” tab for PageFooter includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: CanGrow, CanShrink, Visible and list Mode, which contains Mode property value.

2 – The “Styles” group allows setting StyleName property.

PageOverlay Tab Set

The PageOverlay tab set includes “Format” tab.

Tab Set The PageOverlay tab set includes “Format” tab. The “Format” tab for PageOverlay includes following

The “Format” tab for PageOverlay includes following groups:

1 – The “Render” group contains Checkboxes for setting Render properties: CanGrow, CanShrink, Visible and list Mode, which contains Mode property value.

2 – The “Styles” group allows setting StyleName property.

and list Mode, which contains Mode property value. 2 – The “Styles” group allows setting StyleName

49

PERPETUUM software www.perpetuumsoft.com Application Menu The “New” menu item open s Wizards Gallery dialog for

PERPETUUM

software

www.perpetuumsoft.com

Application Menu

PERPETUUM software www.perpetuumsoft.com Application Menu The “New” menu item open s Wizards Gallery dialog for the
PERPETUUM software www.perpetuumsoft.com Application Menu The “New” menu item open s Wizards Gallery dialog for the

The “New” menu item opens Wizards Gallery dialog for the creation of a new template.

The “Open” menu item opens “Open Template” window for opening template or document.

The “Save” menu item saves changes in the edited template or document. If the template or document is not saved, opens the “Save Template” window for selection of folder for saving and file name.

The “Save As…” menu item opens the “Save Template” window for selection of folder and file name to save a report or document.

The “Select Language” menu item opens the “Select Language” window for the selection of localization language.

The “Settings” button opens “Palette Settings” window for selection of Theme and Color scheme of the Designer.

The “Exit Designer” button closes Report Designer.

window for selection of Theme and Color scheme of the Designer. The “Exit Designer” button closes

50

PERPETUUM software www.perpetuumsoft.com Binding Bar Binding Bar all ows to set binding objects‟ properties quickly.

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Binding Bar Binding Bar all ows to set binding objects‟ properties quickly. 1

Binding Bar

Binding Bar allows to set binding objects‟ properties quickly.

Bar all ows to set binding objects‟ properties quickly. 1 – Name – This field sets
1 – Name – This field sets the name of the selected object.

1 Name This field sets the name of the selected object.

2 – Binding – This is a list of dynamic properties of the selected object.

2 Binding This is a list of dynamic properties of the selected object. It allows the

selection of the property for a value setting.

It allows the selection of the property for a value setting. 3 – Script Editor –

3 Script Editor This button opens the Script Editor for setting the expression of the

selected object.

Editor for setting the expression of the selected object. 4 – F(x) – This field sets

4 F(x) This field sets the expression to set dynamic property for selected object.

(Read more about Using Scripts)

F(x) – This field sets the expression to set dynamic property for selected object. (Read more

51

PERPETUUM software www.perpetuumsoft.com Quick Access Toolbar The Quick Access Toolbar is used to provide access

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Quick Access Toolbar The Quick Access Toolbar is used to provide access to

Quick Access Toolbar

The Quick Access Toolbar is used to provide access to frequently used commands.

is used to provide access to frequently used commands. Customization allows adding necessary commands. The next

Customization allows adding necessary commands.

commands. Customization allows adding necessary commands. The next command can be added to Quick Access Toolbar:

The next command can be added to Quick Access Toolbar:

Button

Action

New Document

Create a new template

Save

Save changes in a template

Open

Load a template or document from file

Select Language

Open “Select Language” dialog

Font

Open “Font” dialog

Use Style Only

Set the style settings

Fill

Open “Fill Editor” to set Fill property

Text Fill

Open “Fill Editor” to set TextFill property

Border

Open “Border Editor”

Margins

Open “Margins Editor”

Text Format

Open “Format Editor”

Style Sheet Editor

Open “Style Sheet Editor”

Align

Open “Align” dialog

Actual Size

Set zoom to 100%

Page Width

Fit to page width

Whole Page

Fit to whole page

Properties

Open “Properties” window

Document Tree

Open “Document Tree” window

Data Source

Open “Data Source” window

Error List

Open “Error List” window

Show Grid

Switch on/off the display of a grid

Source” window Error List Open “Error List” window Show Grid Switch on/off the display of a

52

PERPETUUM software www.perpetuumsoft.com Snap to Grid Switch on/off the option of binding to a grid

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Snap to Grid Switch on/off the option of binding to a grid Show

Snap to Grid

Switch on/off the option of binding to a grid

Show Rulers

Switch on/off the display of a rule

Show Objects Bounds

Switch on/off the display of objects bounds

Layout Bands

Switch on/off the option of automatic layout of the bands

Template Properties

Open template properties

Bands Switch on/off the option of automatic layout of the bands Template Properties Open template properties

53

PERPETUUM software www.perpetuumsoft.com Context Menu Context menu contains most frequently used items. List of menu

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Context Menu Context menu contains most frequently used items. List of menu items

Context Menu

Context menu contains most frequently used items. List of menu items depends on currently selected report objects.

Common Actions

depends on currently selected report objects. Common Actions selected objects. Editing and Positioning 1 Edit –

selected objects.

Editing and Positioning

Common Actions selected objects. Editing and Positioning 1 Edit – This menu item opens an editor:

1 Edit This menu item opens an editor:

1 Cut Objects This menu item cuts the selected objects and put it on the Clipboard.

2 Copy Objects This menu item copies the

selected objects and put it on the Clipboard.

3 Paste This menu item pastes the contents of

the Clipboard into the selected area.

4 Delete Objects - This menu item deletes the

Text Editor for TextBox element to set TextBox.Text property;

Formatted Text Editor for AdvancedText element to set AdvancedText.Text property;

RichText Editor for RichText element to set RichText.RTFtext property;

Open file dialog to choose image and to set Picture.Image property;

Text Editor for BarCode element to set BarCode.Code property;

Chart ModelKit designer for ChartControl element to set ChartControl.Chart property;

Instrument Designer for Widget element to set Widget.Instrument property;

Source Fields for PivotTable section to set PivotTable.Layout property.

2 Clean This menu item cleans the content:

TextBox.Text property for TextBox element;

AdvancedText.Text property for AdvancedText element;

RichText.RTFtext property for RichText element;

Picture.Image property for Picture element;

BarCode.Code property for BarCode element;

ChartControl.Chart property for ChartControl;

Widget.Instrument property for Widget element.

BarCode element;  ChartControl.Chart property for ChartControl;  Widget.Instrument property for Widget element. 54

54

PERPETUUM software www.perpetuumsoft.com 3 Arrange – This submenu contains items for managing objects order, position

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com 3 Arrange – This submenu contains items for managing objects order, position

3 Arrange This submenu contains items for managing objects order, position and size.

items for managing objects order, position and size. most right object. 3.1 Bring to Front -

most right object.

3.1 Bring to Front - This menu item brings the

selected objects in front of all other objects so that no part of it is hidden behind another object in the current container.

3.2 Move Forward - This menu item brings the

selected object forward so that it is hidden by fewer objects that are in front of it in the current container.

3.3 Move Back - This menu item sends the

selected objects backward so that it is hidden by the objects that are in front of it in the current container.

3.4 Send to Back - This menu item sends the

selected objects behind all other objects in the

current container.

The following items are available only if multiple objects are selected:

3.5 Align Left This menu item aligns lefts of the

selected objects by the left border of the most left

object.

3.6 Align Center - This menu item aligns centers of

the selected objects by the center between the

most left and the most right objects.

3.7 Align Right - This menu item aligns rights of

the selected objects by the right border of the

3.8 Align Top - This menu item aligns tops of the selected objects by the top border of the

most top object.

3.9 Align Middle - This menu item aligns middles of the selected objects by the middle

between the most top and the most bottom objects.

3.10 Align Bottom - This menu item aligns bottoms of the selected objects by the bottom

border of the most bottom object.

3.11 Distribute Horizontally This menu item distributes selected objects horizontally

making horizontal spaces between them equal to each other.

3.12 Distribute Vertically This menu item distributes selected objects vertically making

vertical spaces between them equal to each other.

3.13 Same Height as <main selected object*> - This menu item sets height of every

selected object as the main selected object‟s height.

3.14 Same Width as <main selected object> - This menu item sets width of every selected

object as the main selected object‟s width.

3.15 Same Size as <main selected object> - This menu item sets size of every selected

object as the main selected object‟s size.

* Main selected object object, which was last selected at current selected objects. This object is marked in a darker blue.

object – object, which was last selected at current selected objects. This object is marked in

55

PERPETUUM software www.perpetuumsoft.com Element-dependent Menu Items Here are menu items used for setting unique

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Element-dependent Menu Items Here are menu items used for setting unique

Element-dependent Menu Items

Here are menu items used for setting unique objects‟ properties.

SizeMode This is for setting Picture.SizeMode property; the submenu under it contains the list of SizeMode property values.

under it contains the list of SizeMode property values. ShapeStyle – This menu item is for

ShapeStyle This menu item is for setting Shape.ShapeStyle property; the submenu under it contains the list of ShapeStyle property values.

under it contains the list of ShapeStyle property values. CodeType – This menu item is for

CodeType This menu item is for setting BarCode.CodeType property; the submenu under it contains the list of CodeType property values.

under it contains the list of CodeType property values. DataSource – This menu item is for

DataSource This menu item is for setting DataSource property of DataBand, PivotTable and CrossBand sections; the submenu under it contains the list of data sources of the template.

under it contains the list of data sources of the template. GroupExpression – This menu item

GroupExpression This menu item opens Script Editor for setting GroupBand.GroupExpression property.

the template. GroupExpression – This menu item opens Script Editor for setting GroupBand.GroupExpression property. 56

56

PERPETUUM software www.perpetuumsoft.com SubReport – This menu item is for setting SubReport.TemplateName property;

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com SubReport – This menu item is for setting SubReport.TemplateName property;
PERPETUUM software www.perpetuumsoft.com SubReport – This menu item is for setting SubReport.TemplateName property;

SubReport This menu item is for setting SubReport.TemplateName property; the submenu under it contains the list of Report Names contained in the current ReportManager.

list of Report Names contained in the current ReportManager. Editing Elements Styles 1 StyleName – This

Editing Elements Styles

in the current ReportManager. Editing Elements Styles 1 StyleName – This submenu is for setting StyleName

1 StyleName This submenu is for setting StyleName property of the objects; contains the list of styles defined in the template.

2 Style This submenu contains the following items:

2 Style – This submenu contains the following items: 2.1 Use Style Only – This menu

2.1 Use Style Only This menu item clears all formatting

settings (e.g. font, border, etc.) of the element; appearance of the element is defined by style currently applied to.

2.2 Font This menu item opens Font dialog for setting Font

property;

2.3 TextFormat This menu item opens Format dialog for

setting TextFormat property;

2.4 Border This menu item opens Border Editor for setting

Border property;

2.5 Fill - This menu item opens Fill Editor for setting Fill

property;

2.6 TextFill - This menu item opens Fill Editor for setting

TextFill property;

2.7 Align This menu item is for setting TextAlign or

ImageAlign properties; submenu under it contains align options;

2.8 Margins - This menu item opens Margins Editor for setting Margins property;

2.9 Angle This menu item is for setting Angle property; contains the list of allowed property values;

Render Submenu

This submenu provides ability to set elements‟ properties that affect their rendering.

to set elements‟ prop erties that affect their rendering. 1 CanGrow – This menu item sets

1 CanGrow This menu item sets CanGrow property to True or False.

2 CanShrink This menu item sets CanShrink property to True or False.

sets CanGrow property to True or False. 2 CanShrink – This menu item sets CanShrink property

57

PERPETUUM software www.perpetuumsoft.com 3 CanBreak – This menu item sets CanBreak property to True or

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com 3 CanBreak – This menu item sets CanBreak property to True or False.

3 CanBreak This menu item sets CanBreak property to True or False.

4 GrowToBottom This menu item sets GrowToBottom property to True or False.

5 Visible This menu item sets Visible property to True or False.

6 Mode This menu item sets Mode property; submenu under it contains the list of allowed

property values.

Misc Items

it contains the list of allowed property values. Misc Items Show Properties – The menu item

Show Properties – The menu item shows Property Grid with the selected objects‟ properties.

Group selection

When multiple objects are selected, context menu contains items which are common for all selected objects. Commands are applied to each selected object.

AdvancedText element is selected objects main at the following picture:

Commands are applied to each selected object. AdvancedText element is selected objects main at the following

58

PERPETUUM software www.perpetuumsoft.com Docking The new Report Designer with ribbon interface supports dockable windows.

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Docking The new Report Designer with ribbon interface supports dockable windows.

Docking

The new Report Designer with ribbon interface supports dockable windows. Properties, DataSource, Document Tree and Error List windows are dockable. It means that windows can be attached, or docked, to any side of the designer window, or it can be detached, or floated, in its own mini-frame window.

Properties

Property Grid is intended to display and edit properties of the selected element.

to display and edit properties of the selected element. 1 – Object List – This is

1 Object List This is a list of template objects which displays all template objects. Property Grid displays the object properties selected in Object List. The first word is an object name, the second an object type.

2 Categorized This button switches on

the mode of properties display by categories.

3 Alphabetical This button switches

on the mode of properties display in alphabetic order.

4 Properties This button switches on

the mode of static properties display.

5 Bindings This button switches on

the mode of dynamic properties display.

6 Property Pages. This button is not

used.

7 Property Grid Object property grid.

8 Group of properties.

9 Properties: name and value.

10 Description Description of the selected property.

Different methods are used for properties setting:

property. Different methods are used for properties setting: 1 – Field for input of text and

1 Field for input of text and numeric values.

2 This button opens the property editor.

3 List of values.

– Field for input of text and numeric values. 2 – This button opens the property

59

PERPETUUM software Data Sources www.perpetuumsoft.com 1 – Switching between Bands and Data Sources parts. Data

PERPETUUM

software

Data Sources

www.perpetuumsoft.com

PERPETUUM software Data Sources www.perpetuumsoft.com 1 – Switching between Bands and Data Sources parts. Data from
PERPETUUM software Data Sources www.perpetuumsoft.com 1 – Switching between Bands and Data Sources parts. Data from

1 Switching between Bands and Data Sources parts. Data from report bands and special fields are displayed in Band part. Data from report data sources are displayed in Data Sources part.

2 The tree of fields from data source allows the creation of TextBox objects for information output from data source by dragging the fields.

from data source allows the creation of TextBox objects for information output from data source by

60

PERPETUUM software www.perpetuumsoft.com Document Tree The document tree represents a set of objects ordered according

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Document Tree The document tree represents a set of objects ordered according to

Document Tree

The document tree represents a set of objects ordered according to the report structure. It allows the selection of the object for properties editing, the deletion of objects, changing the template structure.

the deletion of objects, changing the template structure. Error List The list of scripts errors includes

Error List

The list of scripts errors includes band name where the error was made and also a description of an error. It is possible to open the Script Editor for expression or script editing by double click with a left mouse button.

for expression or script editing by double click with a left mouse button. (More information about

(More information about errors in scripts)

for expression or script editing by double click with a left mouse button. (More information about

61

PERPETUUM software Editors Text Editor www.perpetuumsoft.com This editor is for input of text values. It

PERPETUUM

software

Editors

Text Editor

www.perpetuumsoft.com

PERPETUUM software Editors Text Editor www.perpetuumsoft.com This editor is for input of text values. It allows

This editor is for input of text values. It allows the input of simple text.

The editor is opened by double click on the TextBox element area, hotkeys Enter or Ctrl + Enter, when TextBox element is selected, or by button, which is located near the property on Property Grid.

button, which is located near the property on Property Grid. 1 – Area for text input.

1 Area for text input.

2 OK This button applies changes, closes the editor.

3 Cancel This button cancels changes, closes the editor.

Script Editor

This editor is for input of scripts and expression of various destinations.

The editor is opened by the button, which is located near the property on the Property Grid or by the “Script Editor” button on the Binding bar.

or by the “Script Editor” button on the Binding bar. 1 – Area for script input.

1 Area for script input.

Script Editor provides syntax highlighting, changes selection and code auto-completing.

1 – Area for script input. Script Editor provides syntax highlighting, changes selection and code auto-completing.

62

PERPETUUM software www.perpetuumsoft.com 2 – Fields‟ tree displays the fields from the data source (the

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com 2 – Fields‟ tree displays the fields from the data source (the Data
PERPETUUM software www.perpetuumsoft.com 2 – Fields‟ tree displays the fields from the data source (the Data

2 – Fields‟ tree displays the fields from the data source (the Data Sources part), from the

bands and displays special fields (the Bands part). The quick input of expressions can be executed by dragging the fields from the fields‟ tree to the area for script input or by double click on the field in the tree.

3 Switching between Bands and Data Sources parts.

4 Code Snippets This button opens a list for templates selection to insert the code

fragment.

a list for templates selection to insert the code fragment. 5 – OK – This button

5 OK This button applies changes, closes the editor.

6 Cancel This button cancels the made changes, closes the editor.

applies changes, closes the editor. 6 – Cancel – This button cancels the made changes, closes

63

PERPETUUM software www.perpetuumsoft.com Formatted Text Editor This editor is for input of formatted text in

PERPETUUM

software

www.perpetuumsoft.com

PERPETUUM software www.perpetuumsoft.com Formatted Text Editor This editor is for input of formatted text in the

Formatted Text Editor

This editor is for input of formatted text in the form of HTML, similar markup language and for RTF-text loading.

The editor is opened by double click on the AdvancedText element area, by hotkeys Enter or Ctrl + Enter, when AdvancedText element is selected, or by the button, which is located near the Text property on Property Grid for AdvancedText element.

the Text property on Property Grid for AdvancedText element. 1 – Area for text input. 2

1 Area for text input.

2 – The fields‟ tree displays fields from the data sources (the Data Sources part), from

bands and displays special fields (the Bands part). The quick input of expressions can be executed by dragging the fields from the fields‟ tree to the area for script input or by double

click on the field in the tree.

3 Switching between Bands and Data Sources parts.

4 Open RTF Document This button opens the Open dialog for the selection of RTF file.

5 Bold This button inserts <b></b> tags into the text for setting the bold font of the

selected text.

6 Italic This button inserts <i></i> tags into the text for setting the italic font of the

selected text.

7 Underline This button inserts <u></u> tags into the text for setting the underline

font of the selected text.

8 Font This button opens the Font editor for setting the style and font of the selected

text, inserts <font=></font> tags into text.

9 Color This button opens the Color editor for setting the color of the selected text,

inserts <font color=></font> tags into text.

10 Left Align This button inserts <p></p> tags into text for setting the left alignment of selected text.