Weitere ähnliche Inhalte
Ähnlich wie User manual (20)
Kürzlich hochgeladen (20)
User manual
- 1. Contents I
Table of Contents
Part I Report Internals 12
1 Expressions
................................................................................................................................... 12
Text Expressions
.......................................................................................................................................................... 12
Calculating Values In Expressions
.......................................................................................................................................................... 13
Multi-line Expressions
.......................................................................................................................................................... 13
Using Dictionary Variables
.......................................................................................................................................................... 14
Using Report .......................................................................................................................................................... 15
Code Variables
Using Data Fields
.......................................................................................................................................................... 15
Using Com ponent Properties
.......................................................................................................................................................... 17
Using Functions In Expressions
.......................................................................................................................................................... 18
Conditional Expressions
.......................................................................................................................................................... 19
Using Aliases.......................................................................................................................................................... 19
In Expressions
2 Appearance
................................................................................................................................... 21
Background Brushes
.......................................................................................................................................................... 21
Fonts and Font Brushes
.......................................................................................................................................................... 22
Borders .......................................................................................................................................................... 24
Simple Borders
......................................................................................................................................................... 25
Advanced ......................................................................................................................................................... 28
Borders
Conditional......................................................................................................................................................... 30
Borders
Horizontal alignm ent
.......................................................................................................................................................... 30
Horizontal text alignment
......................................................................................................................................................... 31
Horizontal image alignment
......................................................................................................................................................... 31
Vertical alignm ent
.......................................................................................................................................................... 32
Vertical text alignment
......................................................................................................................................................... 32
Vertical image alignment
......................................................................................................................................................... 32
Styles .......................................................................................................................................................... 33
Alternate Row Styles
.......................................................................................................................................................... 35
UseParentStyles property
.......................................................................................................................................................... 36
3 Conditional formatting
................................................................................................................................... 36
Value condition
.......................................................................................................................................................... 38
Operations .......................................................................................................................................................... 39
Expression condition
.......................................................................................................................................................... 40
Condition w ith m ulti parts
.......................................................................................................................................................... 41
Conditional form atting
.......................................................................................................................................................... 42
Conditional form atting and text com ponents
.......................................................................................................................................................... 43
Conditional form atting and cross-tables
.......................................................................................................................................................... 43
4 Output text parameters
................................................................................................................................... 44
Multiline text .......................................................................................................................................................... 44
Trim m ing in the end of text line
.......................................................................................................................................................... 44
Prevent show.......................................................................................................................................................... 46
ing incom pletely visible lines
Lines of underlining
.......................................................................................................................................................... 46
Maxim al num ber of lines
.......................................................................................................................................................... 47
Text rotation .......................................................................................................................................................... 47
Processing Duplicates
.......................................................................................................................................................... 47
Ignoring null values
.......................................................................................................................................................... 51
ReportTo property
.......................................................................................................................................................... 51
Output text only w ithout taking expressions into consideration
.......................................................................................................................................................... 53
Expression processing in the end of report rendering
.......................................................................................................................................................... 54
© 2003-2010 Stimulsoft
I
- 2. II Stimulsoft Reports
5 Text formatting
................................................................................................................................... 54
Standard form atting
.......................................................................................................................................................... 56
Num erical form atting
.......................................................................................................................................................... 56
Currency form atting
.......................................................................................................................................................... 57
Date form atting
.......................................................................................................................................................... 59
Tim e form atting
.......................................................................................................................................................... 59
Percentage data form atting
.......................................................................................................................................................... 60
Boolean values form atting
.......................................................................................................................................................... 62
Custom form .......................................................................................................................................................... 62
atting
Form atting in .......................................................................................................................................................... 63
a text
6 HTML ................................................................................................................................... 64
tags
<font> HTML tag.......................................................................................................................................................... 65
Color parameter
......................................................................................................................................................... 66
Face parameter
......................................................................................................................................................... 67
Size parameter
......................................................................................................................................................... 68
HTML tags to .......................................................................................................................................................... 68
change font style
<b> HTML tag
......................................................................................................................................................... 69
<i> HTML tag
......................................................................................................................................................... 69
<u> HTML tag
......................................................................................................................................................... 70
<s> HTML tag
......................................................................................................................................................... 70
<sup> HTML tag
......................................................................................................................................................... 70
<sub> HTML tag
......................................................................................................................................................... 71
<background-color> HTML tag
.......................................................................................................................................................... 71
<text-align> HTML tag
.......................................................................................................................................................... 71
<letter-spacing> HTML tag
.......................................................................................................................................................... 72
<w ord-spacing> HTML tag
.......................................................................................................................................................... 72
<line-height> .......................................................................................................................................................... 72
HTML tag
7 RTF text output
................................................................................................................................... 73
RTF text editor
.......................................................................................................................................................... 73
Expressions in the RTF text
.......................................................................................................................................................... 74
Loading the RTF text from the data field
.......................................................................................................................................................... 75
8 Graphic information output
................................................................................................................................... 76
Loading im ages
.......................................................................................................................................................... 78
Im age stretching
.......................................................................................................................................................... 80
Resources of .......................................................................................................................................................... 81
Im ages
9 Autosize
................................................................................................................................... 85
Autom atically.......................................................................................................................................................... 86
resizing text
Autom atically.......................................................................................................................................................... 88
resizing panels
Autom atically.......................................................................................................................................................... 89
resizing bands
Binding the bottom border of a com ponent
.......................................................................................................................................................... 90
Shifting com ponents
.......................................................................................................................................................... 92
10 Bar-codes
................................................................................................................................... 94
Bar-codes size.......................................................................................................................................................... 96
Linear Bar-codes
.......................................................................................................................................................... 97
EAN/UPC based
......................................................................................................................................................... 97
What is the EAN.UCC system?
......................................................................................................................................... 97
UPC-A ......................................................................................................................................... 97
UPC-E ......................................................................................................................................... 98
EAN-13 ......................................................................................................................................... 98
EAN-8 ......................................................................................................................................... 99
Add-On Symbols ......................................................................................................................................... 100
EAN-128 ......................................................................................................................................... 101
© 2003-2010 Stimulsoft
- 3. Contents III
ITF-14 ......................................................................................................................................... 101
JAN-13 ......................................................................................................................................... 102
JAN-8 ......................................................................................................................................... 102
ISBN-10 ......................................................................................................................................... 103
ISBN-13 ......................................................................................................................................... 103
Other barcodes
......................................................................................................................................................... 104
Pharmacode ......................................................................................................................................... 104
Plessey ......................................................................................................................................... 104
Msi ......................................................................................................................................... 105
2of5 ......................................................................................................................................... 106
FIM ......................................................................................................................................... 106
Codabar ......................................................................................................................................... 107
Postnet ......................................................................................................................................... 108
Australia Post 4-state
......................................................................................................................................... 108
Code11 ......................................................................................................................................... 109
Code39 ......................................................................................................................................... 110
Code93 ......................................................................................................................................... 111
Code128 ......................................................................................................................................... 111
2D barcodes parameters
......................................................................................................................................................... 112
2D Barcodes .......................................................................................................................................................... 114
PDF417 ......................................................................................................................................................... 114
Datamatrix
......................................................................................................................................................... 116
11 Bands
................................................................................................................................... 117
Types of bands
.......................................................................................................................................................... 118
Standard ......................................................................................................................................................... 118
bands
Cross-bands
......................................................................................................................................................... 121
Order of bands output
.......................................................................................................................................................... 121
12 Creating lists
................................................................................................................................... 122
Data source .......................................................................................................................................................... 123
of the Data band
Virtual Data band
.......................................................................................................................................................... 125
List output .......................................................................................................................................................... 126
List w ith header
.......................................................................................................................................................... 128
List w ith footer
.......................................................................................................................................................... 129
KeepHeaderTogether property
.......................................................................................................................................................... 130
KeepFooterTogether property
.......................................................................................................................................................... 130
Num bering in lists
.......................................................................................................................................................... 131
Selecting row s one after another
.......................................................................................................................................................... 133
Events and Data band
.......................................................................................................................................................... 135
Data sorting .......................................................................................................................................................... 136
Data filtration
.......................................................................................................................................................... 137
Lists one after another
.......................................................................................................................................................... 141
PrintOn property
.......................................................................................................................................................... 143
PrintOnEvenOddPages property
.......................................................................................................................................................... 143
PrintOnAllPages property
.......................................................................................................................................................... 145
PrintAtBottom property
.......................................................................................................................................................... 146
13 Creating Master-Detail lists
................................................................................................................................... 147
MasterCom ponent property
.......................................................................................................................................................... 149
DataRelation .......................................................................................................................................................... 149
property
Multilevel nesting
.......................................................................................................................................................... 150
Row s num bering in Master-Detail reports
.......................................................................................................................................................... 151
Through lines num bering in Master-Detail reports
.......................................................................................................................................................... 153
14 Groups
................................................................................................................................... 154
Condition of .......................................................................................................................................................... 155
grouping
© 2003-2010 Stimulsoft
III
- 4. IV Stimulsoft Reports
GroupHeader band
.......................................................................................................................................................... 156
GroupFooter.......................................................................................................................................................... 157
band
Data sorting .......................................................................................................................................................... 158
in group
Group Footer .......................................................................................................................................................... 159
Events and GroupHeader band
.......................................................................................................................................................... 160
Group w ithout header
.......................................................................................................................................................... 160
Nested groups.......................................................................................................................................................... 161
Num bering row s in group
.......................................................................................................................................................... 162
15 Report Bands
................................................................................................................................... 162
ReportTitleBand
.......................................................................................................................................................... 162
ReportSum m aryBand
.......................................................................................................................................................... 163
ReportTitleBand property
.......................................................................................................................................................... 164
16 Page................................................................................................................................... 164
bands
PageHeader .......................................................................................................................................................... 164
band
PageFooter band
.......................................................................................................................................................... 166
PrintOnEvenOddPages property
.......................................................................................................................................................... 168
17 Columns
................................................................................................................................... 170
Colum ns on .......................................................................................................................................................... 170
page
Colum ns on .......................................................................................................................................................... 172
the Data band
AcrossThenDow n mode
......................................................................................................................................................... 173
Dow nThenAcross mode
......................................................................................................................................................... 175
Minimal number of lines in a column
......................................................................................................................................................... 178
ColumnHeader band
......................................................................................................................................................... 179
PrintIfEmpty property ......................................................................................................................................... 180
ColumnFooter band
......................................................................................................................................................... 181
PrintIfEmpty property ......................................................................................................................................... 182
Combination of Headers and Footers
......................................................................................................................................................... 182
AcrossThenDow n column mode
......................................................................................................................................... 183
Dow nThenAcross column mode
......................................................................................................................................... 183
18 Page................................................................................................................................... 184
numbering
Page num ber.......................................................................................................................................................... 184
Total Page Count
.......................................................................................................................................................... 185
Page NofM .......................................................................................................................................................... 185
ResetPageNum ber property
.......................................................................................................................................................... 186
19 Empty Band
................................................................................................................................... 188
Em pty band m odes
.......................................................................................................................................................... 190
20 Watermarks
................................................................................................................................... 192
Waterm ark property
.......................................................................................................................................................... 192
Overlay band .......................................................................................................................................................... 193
Vertical alignment
......................................................................................................................................................... 194
Direct allocation on a page
.......................................................................................................................................................... 196
21 Panels
................................................................................................................................... 197
Placing bands on panel
.......................................................................................................................................................... 197
Placing panels.......................................................................................................................................................... 198
Placing on page
......................................................................................................................................................... 198
Placing on band
......................................................................................................................................................... 199
Placing on panel
......................................................................................................................................................... 199
Side-by-Side.......................................................................................................................................................... 199
reports
Multiple tables on one page
.......................................................................................................................................................... 201
Cloning .......................................................................................................................................................... 202
22 Cross Table
................................................................................................................................... 203
© 2003-2010 Stimulsoft
- 5. Contents V
Data Source .......................................................................................................................................................... 203
Cross Table .......................................................................................................................................................... 205
Item s
Columns ......................................................................................................................................................... 205
Row s ......................................................................................................................................................... 207
Summary ......................................................................................................................................................... 210
Cells
Cross Table .......................................................................................................................................................... 213
Editor
Data Sum m ary Types
.......................................................................................................................................................... 214
Sort Direction
.......................................................................................................................................................... 215
Conditions .......................................................................................................................................................... 216
23 Charts
................................................................................................................................... 217
Chart properties.......................................................................................................................................................... 227
Area .......................................................................................................................................................... 257
Doughnut......................................................................................................................................................... 258
Series Labels ......................................................................................................................................... 258
Pie ......................................................................................................................................................... 259
Series Labels ......................................................................................................................................... 260
Cut Pie List property ......................................................................................................................................... 262
Legend .......................................................................................................................................................... 264
Title property
......................................................................................................................................................... 264
Horizontal Alignment property
......................................................................................................................................................... 265
Vertical Alignment property
......................................................................................................................................................... 266
Horizontal and Vertical Spacing properties
......................................................................................................................................................... 268
Marker ......................................................................................................................................................... 269
Direction property ......................................................................................................................................... 269
Columns property ................................................................................................................................... 270
Marker lignment property......................................................................................................................................... 271
Marker Visible property ......................................................................................................................................... 271
Axes area .......................................................................................................................................................... 272
Axes ......................................................................................................................................................... 272
Arrow style ......................................................................................................................................... 273
Labels ......................................................................................................................................... 274
Angle property ................................................................................................................................... 275
Format property ................................................................................................................................... 276
Placement property ................................................................................................................................... 278
Text Alignment ................................................................................................................................... 280
property
Range property ......................................................................................................................................... 281
Visible property......................................................................................................................................... 282
StartFromZero property ......................................................................................................................................... 283
Ticks ......................................................................................................................................... 284
Minor ................................................................................................................................... 285
Step property ................................................................................................................................... 286
Title property ......................................................................................................................................... 287
Alignment property ................................................................................................................................... 288
Reverse Horizontal property
......................................................................................................................................................... 290
Reverse Vertical property
......................................................................................................................................................... 291
Color Each property
......................................................................................................................................................... 292
Series .......................................................................................................................................................... 293
Data Connection
......................................................................................................................................................... 293
Data Column ......................................................................................................................................... 293
Expressions ......................................................................................................................................... 294
List of Values property ......................................................................................................................................... 295
AutoSeries ......................................................................................................................................................... 296
Filters ......................................................................................................................................................... 297
Conditions ......................................................................................................................................................... 299
© 2003-2010 Stimulsoft
V
- 6. VI Stimulsoft Reports
Series Editor
......................................................................................................................................................... 299
Series Labels .......................................................................................................................................................... 300
Series Labels appearance
......................................................................................................................................................... 301
Brush property ......................................................................................................................................... 301
Font property ......................................................................................................................................... 303
Label Color property ......................................................................................................................................... 305
Use Series Color property
......................................................................................................................................... 305
Angle property ......................................................................................................................................... 306
Draw Border property ......................................................................................................................................... 307
Border Color property ......................................................................................................................................... 308
Antialiasing property ......................................................................................................................................... 309
Format property
......................................................................................................................................................... 309
Value Type property
......................................................................................................................................................... 312
Value Type Separator
......................................................................................................................................................... 315
Prevent Intersection property
......................................................................................................................................................... 315
Show on ......................................................................................................................................................... 316
Zero Values property
Step property
......................................................................................................................................................... 318
Text before Text after properties
......................................................................................................................................................... 318
Visible property
......................................................................................................................................................... 319
Marker ......................................................................................................................................................... 320
Marker Visible property......................................................................................................................................... 321
Marker Size property ......................................................................................................................................... 322
Marker Alignment property
......................................................................................................................................... 322
Style ......................................................................................................................................................... 323
Allow ApplyStyle property
......................................................................................................................................... 324
24 Table
................................................................................................................................... 325
Colum ns .......................................................................................................................................................... 325
Row s .......................................................................................................................................................... 325
Data Source .......................................................................................................................................................... 326
MasterCom ponent Property
.......................................................................................................................................................... 327
Relation Property
.......................................................................................................................................................... 329
Tables and Bands in Master-Detail lists
.......................................................................................................................................................... 330
Tables and Grouping
.......................................................................................................................................................... 330
Table Header .......................................................................................................................................................... 331
Table Footer.......................................................................................................................................................... 331
Cells w idth autochange
.......................................................................................................................................................... 332
AutoWidth Property
......................................................................................................................................................... 332
AutoWidthType Property
......................................................................................................................................................... 332
FixedWidth Property
.......................................................................................................................................................... 334
CellType Property
.......................................................................................................................................................... 335
25 Totals
................................................................................................................................... 336
Totals output in any part of a report
.......................................................................................................................................................... 337
Type of result of total function
.......................................................................................................................................................... 337
Expression w ith aggregate functions
.......................................................................................................................................................... 338
Calculating totals by page
.......................................................................................................................................................... 340
Calculating totals by colum n
.......................................................................................................................................................... 340
Calculating totals in code of report events
.......................................................................................................................................................... 342
Invisible bands
.......................................................................................................................................................... 343
Totals and autom atic change of size
.......................................................................................................................................................... 344
Calculating totals in Master-Detail reports
.......................................................................................................................................................... 344
Totals w ith condition
.......................................................................................................................................................... 347
Syntax of aggregated functions
.......................................................................................................................................................... 347
26 Interaction
................................................................................................................................... 348
© 2003-2010 Stimulsoft
- 7. Contents VII
Bookm arks .......................................................................................................................................................... 348
Tree of bookmarks
......................................................................................................................................................... 349
Bookmarking using code
......................................................................................................................................................... 350
Bookmark......................................................................................................................................................... 352
nesting
Hyperlinks .......................................................................................................................................................... 353
Hyperlink ......................................................................................................................................................... 353
to another component in report using Interaction.Bookmark
Hyperlink ......................................................................................................................................................... 353
to another component in report using Interaction.Tag
Hyperlink ......................................................................................................................................................... 353
to external documents
Reports w ith contents
.......................................................................................................................................................... 354
Part II Reports Designer 357
1 Standard UI or Ribbon Ui?
................................................................................................................................... 357
2 Standard UI
................................................................................................................................... 358
Toolbar .......................................................................................................................................................... 358
Standard ......................................................................................................................................................... 358
toolbar
Borders toolbar
......................................................................................................................................................... 359
Designer ......................................................................................................................................................... 360
toolbar
Formatting toolbar
......................................................................................................................................................... 360
Dock style toolbar
......................................................................................................................................................... 361
Styles toolbar
......................................................................................................................................................... 361
Text format toolbar
......................................................................................................................................................... 361
Service toolbar
......................................................................................................................................................... 362
Main m enu .......................................................................................................................................................... 362
File menu ......................................................................................................................................................... 362
Edit menu......................................................................................................................................................... 363
View menu ......................................................................................................................................................... 364
Tools menu......................................................................................................................................................... 365
Help menu ......................................................................................................................................................... 366
3 Ribbon UI mode 2007
................................................................................................................................... 366
Status Bar .......................................................................................................................................................... 366
Application m enu
.......................................................................................................................................................... 367
Ribbon tabs .......................................................................................................................................................... 368
Home tab ......................................................................................................................................................... 368
Clipboard group......................................................................................................................................... 369
Font group ......................................................................................................................................... 369
Alignment group ......................................................................................................................................... 369
Borders group ......................................................................................................................................... 370
Text format group ......................................................................................................................................... 371
Styles group ......................................................................................................................................... 371
Page tab ......................................................................................................................................................... 371
Page settings group ......................................................................................................................................... 371
Watermark group ......................................................................................................................................... 372
Watermark image group ......................................................................................................................................... 372
Layout tab......................................................................................................................................................... 373
Arrange group ......................................................................................................................................... 373
Dock style group ......................................................................................................................................... 375
View tab ......................................................................................................................................................... 375
View options group ......................................................................................................................................... 375
4 Ribbon UI mode 2010
................................................................................................................................... 376
5 Creating reports in the designer
................................................................................................................................... 376
Introduction .......................................................................................................................................................... 376
Report Tem plates
.......................................................................................................................................................... 376
© 2003-2010 Stimulsoft
VII
- 8. VIII Stimulsoft Reports
Report w izards
.......................................................................................................................................................... 376
Standard ......................................................................................................................................................... 379
Report w izard
Master-Detail report w izard
......................................................................................................................................................... 381
Label Report w izard
......................................................................................................................................................... 385
Chart w izard
......................................................................................................................................................... 386
Cross-Tab w izard
......................................................................................................................................................... 387
6 Hotkeys in Designer
................................................................................................................................... 388
Part III Using WinForms Viewer 390
1 How ................................................................................................................................... 390
to show a report?
2 Report viewer structure
................................................................................................................................... 391
3 Basic toolbar of viewer
................................................................................................................................... 392
4 Page................................................................................................................................... 393
navigation
5 Page................................................................................................................................... 393
view modes
6 Search panel
................................................................................................................................... 396
7 Hotkeys in WinForms viewer
................................................................................................................................... 397
Part IV Using Web Viewer 397
1 StiWebViewer - component of viewing reports
................................................................................................................................... 397
WebView er toolbar
.......................................................................................................................................................... 398
Printing reports
.......................................................................................................................................................... 399
Saving reports
.......................................................................................................................................................... 399
View Mode .......................................................................................................................................................... 400
2 Recommendation on placing components on a page
................................................................................................................................... 401
3 Using graphic objects in report
................................................................................................................................... 401
4 Output images placed on the server
................................................................................................................................... 402
5 Caching
................................................................................................................................... 402
The RenderMode property
.......................................................................................................................................................... 402
CacheMode .......................................................................................................................................................... 403
property
ServerTim eOut property
.......................................................................................................................................................... 403
6 Printing reports
................................................................................................................................... 403
7 StiReportRespose class
................................................................................................................................... 403
8 Using dialogs in report
................................................................................................................................... 404
9 Images of StiWebViewer toolbar
................................................................................................................................... 404
10 Localization of StiWebViewer component
................................................................................................................................... 404
Part V Exports 405
1 Available file formats
................................................................................................................................... 405
2 Export reports from code
................................................................................................................................... 406
ExportDocum ent m ethod
.......................................................................................................................................................... 406
Export form ats
.......................................................................................................................................................... 407
Export service
.......................................................................................................................................................... 408
All export services
.......................................................................................................................................................... 409
3 Common export settings
................................................................................................................................... 410
Im age Quality
.......................................................................................................................................................... 410
© 2003-2010 Stimulsoft