Report Builder FastReport .Net User Guide: Introduction to Report Objects

FastReport .Net is a full-featured Windows Forms, ASP.NET and MVC report analysis solution. Using FastReport .NET can create .NET reports independent of applications. At the same time, FastReport .Net supports 14 languages ​​such as Chinese and English. You can make your products truly international.

"CheckBox" object

This object displays checkboxes in reports. It looks like this:

1

The object can display two states: "selected" and "unselected". The state of the object is handled using:

  • Set the state in the "Checked" property;
  • Bind the object to a data column using the "DataColumn" property;
  • Set the expression that returns true or false in the "Expression" property.

The "CheckBox" object has the following properties:

property describe
CheckedSymbol、UncheckedSymbol These properties determine the symbols displayed in the object, depending on the state of the object.
check color This property determines the color of the check symbol.
Check Width Ratio Use this property to set the check width ratio. The width of the check mark depends on the size of the object. You can use values ​​in the range 0.2 - 2.
hide if unchecked If unchecked, this property allows objects to be hidden.
tick This property controls the state of the object.
data column The data column this object is bound to. The type of the column should be bool or int.
Express An expression that returns true or false.
"Table" object

A "Table" object consists of rows, columns, and cells. It is a simplified analog of a Microsoft Excel spreadsheet. It looks like this:

1

You can learn more about this object in the "Creating reports" chapter.

The "Table" object has the following properties:

property describe
Number of columns Use this property to quickly set the number of columns. If the table has few columns they are added, when they are more they are dropped.
Number of lines Use this property to quickly set the number of rows. If the table has few rows, they are added, and when they are more, they are deleted.
fixed column This property determines how many columns in the table are fixed. Fixed columns make up the table header. Printing of headers is controlled by the "RepeatHeaders" property.
fixed line This property determines how many rows in the table are fixed. Fixed rows make up the table header. Printing of headers is controlled by the "RepeatHeaders" property.
repeat title This property allows the table header to be printed on each new page. This property applies only to dynamically formed tables.
"Matrix" object

A "Matrix" object, like a "Table" object, consists of rows, columns, and cells. At the same time, it is not known in advance how many rows and columns are in the matrix - it depends on the data it is connected to.

The object looks like this:

1

You can learn more about this object in the "Creating reports" chapter.

The "Matrix" object has the following properties:

property describe
repeat title If the matrix is ​​divided into several pages, this property allows to print the matrix title on each new page.
cells side by side If the matrix has multiple levels of data cells, this property determines the position of the matrix cells. Possible variants:

- cells are displayed side by side;
- cells are displayed below each other.
style Using this property you can style the entire matrix. You can choose one of the predefined styles.
auto size This property allows automatic calculation of the matrix size. Disable it if you want to manually control object size.
data source This property allows connecting the matrix to a data source. This property is automatically set when you drag a column of data to the matrix. However, if you are using an expression in the cell, check that the property is set correctly.
filter This property contains data filtering expressions applicable to matrix data sources (see the 'DataSource' property).
Advanced Matrix Object

This object, like the "Matrix" object, allows you to build summary reports.

1

"Chart" object

The "MS Chart" object allows the display of charts. There are over 30 different series types available - Bar, Column, Area, Line, Bubble, Pie, Circle, Financial, Pyramid, Range. The object looks like this:

1

You can learn more about this object in the "Creating reports" chapter.

The "Matrix" object has the following properties:

property describe
chart A reference to a Microsoft Chart object.
Align X value This property allows to align X values ​​in different chart series (by inserting null values). Use it if the chart contains two or more series.
AutoSeriesColumn、AutoSeriesColor、AutoSeriesSortOrder These properties allow to set automatically created series. In the "Report Creation" section.
data source This property allows connecting the chart to a data source.
filter This property contains data filtering expressions applicable to the chart's data source (see the 'DataSource' property).
"Zip Code" object

The "Zip Code" object allows printing of zip codes on envelopes. It may display numeric characters (0-9).

The objects are as follows:

1


You can connect objects to data using one of the following methods:

  • Set the zip code data in the "Text" property;
  • Bind the object to a data column using the "DataColumn" property;
  • Set the expression that returns postal code data in the "Expression" property.

The "Zip Code" object has the following properties:

property describe
Number of steps The number of segments in the code. By default, this property is set to 6.
segment width, segment height The size of a single code segment. The default size is 0.5х1cm.
spacing This property determines the distance between the origins of two segments. The default is 0.9 cm.
show grid Determines if the grid needs to be displayed.
show tag Determine if a marker (thick horizontal line above the zip code) is necessary.
data column The data column this object is bound to.
Express An expression that returns postal code data.
text Text containing postal codes.

"Cellular Text" object

This object can display each character of the text in its own cell. It is often used to print some forms in financial applications.

The objects are as follows:

1


In fact, this object is directly inherited from the "Text" object. You can connect it to data in the same way. For example, you can invoke an object's editor and type the following text:

[Employees.FirstName

The "Cellular Text" object has the following properties:

property describe
cell width, cell height These properties determine the size of a single cell. If both properties are 0 (the default), the cell size will be calculated automatically based on the font used.
horizontal spacing, vertical spacing These properties determine the horizontal and vertical gaps between adjacent cells.

"Gauges" object

These objects are designed to display any value visually. The following are the four different gauge types currently supported:

1

  • Wire Gauge
  • simple meter
  • radial view
  • simple schedule

To add a Gauge object to the report, select an option from the submenu that opens when the button is clicked

1

1

You can change some aspects of the gauge's appearance, such as the color of the needle. To edit a meter parameter, double-click it with the left mouse button, or select "Edit..." in the context menu.

The Expression button opens a text editor where you can enter the gauge value yourself, or write an expression for it and connect the gauge to the data.

"Digital Signature" object

"Digital Signature" - A password that guarantees uniqueness and originality, allows authorship to be unambiguously established and prevents document changes. Thanks to a reliable encryption algorithm, such a signature is no worse than a handwritten one, or even better and more reliable.

In the current release, two types of signatures are available:

1) signature field - means that there is a special field in the document, by clicking on it, the user will be able to attach his certificate;

Press this key to add an object that implements this functionality: 

1

It's called a digital signature. When this control is placed on a report page, it looks like this:

1

It is not visible in report view. Its functionality is limited to PDF export. That is, you will see this field when you view the PDF file in Acrobat Reader.

After exporting, the field will look like this:

1

Click in the signature field and view the window for selecting a certificate to sign the document:

2) Stealth signature - then sign with a certificate. It is not visible visually, but information about the signer, signature authenticity, version of the document at the time of signing, and other information is available in the document properties.

To sign an exported PDF file with an invisible signature, you do not need to add a Digital Signature object to the report page. You need to enable the signing option in the export settings, and select a certificate there:

1

Guess you like

Origin blog.csdn.net/m0_67129275/article/details/131717454