Reporting
User Guide
Reference : Report Controls : Bar Code
The Bar Code control is used to add bar code into a report.
|
Note:
|
The barcode quality can degrade when the report is exported to formats other than PDF. To ensure reliable barcode recognition, print the report directly from an application using the native printing methods.
The Module and Auto-Module properties of a control should be used with care. |
Determines the alignment of the barcode image within the control. To define the text alignment, use the Text Alignment property.
Specifies the background colour for the control. This option is also available on the Formatting Toolbar (
).
).|
•
|
Specifies the font settings for the control. Some of these settings are available on the Formatting Toolbar.
Specifies the text and image colour for the bar code. This option is also available in the Formatting Toolbar (
).
).Displays the Formatting Rules Editor, used to choose which rules should be applied to the control during report generation, and define the precedence of the applied rules. Refer to Conditionally Change a Control's Appearance for further information.
|
•
|
Used to define the priority of various style elements (such as background colour, border colour, etc.). Refer to Styles Concepts for further information on style inheritance.
|
•
|
This property is used to define odd and even styles for the control, as well as to assign an existing style to the control (or a newly created one). Refer to Styles Concepts for further information on style inheritance.
Used to change the alignment of the control's text. This option is also available on the Formatting Toolbar. To define the alignment of the barcode image, use the Alignment property.
When this property is set to Yes, the Barcode image is stretched to fit the entire control's width. When this option is set to No, this behaviour is determined by the Module property.
Specifies whether the contents of the control can be horizontally split across pages. In other words, if the control occupies more space than remains on the page, this property specifies whether this Bar Code should be split between the current page and the next, or whether it will be printed entirely on the next page. If a control does not fit on the next page either, then the Bar Code will be split despite this property's setting.
|
•
|
|
Note:
|
If the Module property is set too low, the barcode output may be unreadable by a barcode scanner.
|
If the Auto-Module property is set to No, the barcode image could be generated with the setting of Module property is larger than the control itself. In this case, the control displays a warning, as illustrated below:
The barcode image within the control can be rotated using the Orientation property to specify one of four possible orientations (Normal, Upside Down, Rotate to the Left and Rotate to the Right).
|
•
|
This property contains events, which can be handled with the scripts. Refer to Handle Events via Scripts for further information on scripting.
Determines whether to display the numerical value, or only the Barcode within the control.
The Symbology property defines the mapping between Barcode text and an image. The Bar Code control supports only linear 1D symbologies. They are listed in the following table:
|
•
|
If the current report is bound to data, this property enables users to bind some of the control's properties (Bookmark, Navigation URL and Tag) to a data field obtained from the report's data source, and to apply a format string to it. Refer to Display Values from a Database (Bind Report Elements to Data) for further information.
|
•
|
If the current report has a data source, the Tag property can be bound to a data field obtained from the data source. To do this, expand the (Data Bindings) property and from the Tag.Binding dropdown list, select the required data field.
|
•
|
Used to define a string to be encoded as a barcode. Whether or nor this value is displayed within the control is specified using the Show Text property.
If the content does not conform to the rules of the specified symbology (determined by the Symbology property), the control may display a warning, as in the picture below, or automatically correct the input string by padding it with zeroes or only accepting an acceptable number of characters for display.
If the current report has a data source, the Text property can be bound to a data field obtained from the data source. To do this, expand the (Data Bindings) property, and in the Text.Binding dropdown menu, select the required data field. Refer to Display Values from a Database (Bind Report Elements to Data) for further information.
|
•
|
Determines a control's name, by which it can be accessed in the Property Grid and by scripts.
|
•
|
|
•
|
These properties are used to create a hierarchical structure within a report called a document map. Refer to Add Bookmarks for an explanation and help.
If the current report has a data source, the Bookmark property can be bound to a data field obtained from the data source. To do this, expand the (Data Bindings) property and from the Bookmark.Binding dropdown list, select the required data field.
Use the Navigation URL property to specify a URL for web browser navigation when a user clicks the control. The web browser displays a page in a window or a frame as specified by the Navigation Target property.
Cross references can be created within the report by assigning the name of the target control to the Navigation URL property, and setting the Navigation Target property to _self. Refer to Create Hyperlinks for further information.
If the current report has a data source, the Navigation URL property can be bound to a data field obtained from the data source. To do this, expand the (Data Bindings) property and from the Navigation URL.Binding dropdown menu, select the required data field.
