Row Index


Row index is a field type that displays the number of the current data row in a Snap list.

To insert a row index into the current carriage position, click Row Index in the General Tools: Insert tab of the main toolbar.


To access the options of a selected Row Index, click Properties in the Field tab of the main toolbar.

Format String – specifies the formatting of the displayed row index.
Group Mode – specifies whether or not the row index numbers continue or restart for each group in a grouped Snap list.



Snap Reports provides several different report elements for displaying graphics using one of the supported graphical data formats. These elements can be divided into two categories:

Static Pictures – store image data in the report file;

Dynamic Pictures – obtain image data from a data-source when the document is generated.


The following image file formats are supported:

Bitmap (*.bmp, *.dib);

JPEG File Interchange Format (*.jpg, *.jpeg);

Portable Network Graphics (*.png);

Graphics Interchange Format (*.gif);

Tagged Image Format (*.tif, *.tiff);

Microsoft Enhanced Metafile (*.emf);

Windows Metafile (*.wmf).


Static Pictures


An Inline Picture is similar to an ordinary text symbol. Inline pictures are not affected by the options in the Picture Tools: Format tab of the main toolbar.

To add an inline picture to a report, do the following.


A Floating Picture can be freely resized and relocated using drag-and-drop. Unlike inline pictures, floating pictures are affected by the options in the Picture Tools: Format tab of the main menu.


A floating picture automatically anchors to the nearest text paragraph.

The paragraph to which the selected picture is anchored is marked with an anchor icon.

You can anchor a picture to another paragraph using drag-and-drop.

Dynamic Pictures


Dynamic pictures in Snap are represented by image document fields, which are replaced with image data obtained from the data source when the document is generated.

Typically, image fields are created automatically when a data field containing image data is added to a report from the Data Explorer.


The properties for the image field are available via the Properties command from the Data Tools: Field tab, which becomes active when an image field is selected.

Update Mode – specifies whether to preserve the image box size or the ratio of the original image;
Sizing – specifies how an image is resized to fit the size of the box.



This document describes how to use the Check Box element in Snap.

Check Box is an element that indicates True/False or Checked/Unchecked/Indeterminate values in a report.

Typically, elements of this type are created automatically for the Boolean data fields added to a document from the Data Explorer via drag-and-drop.


To manually insert a check box into a document, click the Check Box command in the General Tools: Insert tab of the main toolbar.

A check box will be inserted into a carriage position with all properties set to default values.

You can change the properties of a check box via the Properties command, which resides in the Data Tools: Field toolbar.

This toolbar becomes active when a check box is selected.

The Properties command invokes a drop-down menu containing all properties available for the currently selected field.


The following properties are available for a check box.

Content Type – specifies the type of the element used to display data.
Binding – specifies the data field that provides values to the check box.
Checked – specifies the state of the check box. This property may contain one of the following values.


This document provides general information on using charts in Snap applications, and describes the main options for configuring charts using tools provided by the user interface.

A Chart is a sophisticated report element used to embed graphs into a report. It represents a series of points graphically using 2D and 3D chart types.

A Chart can be populated with points both manually (by specifying arguments and values for each point) and dynamically (by connecting it to a data source).

Add Charts


To add a chart to a report, click the Chart command in the General Tools:

Insert tab of the main toolbar.

A chart will be inserted in the carriage position with all properties set to default values.

The newly created chart will display sample data so that you can view the appearance of the chart without connecting it to a data source.


To quickly bind a chart to data, drag-and-drop data items from the Data Explorer to the corresponding blue circles representing values and arguments.

Configure a Chart


The main commands used for managing charts reside in the Chart Tools:

Design tab of the main toolbar.

These commands allow you to change the type and color scheme of the selected chart, or invoke the Chart Wizard for more configuration options.

Select the chart;

Click a command for one of the available chart type categories in the Chart Tools: Design tab.

In the invoked drop-down list, select the chart type that you wish to apply to the chart.


The color schemes for charts are stored in styles, which are grouped into palettes.

To change a chart’s color scheme, do the following.

Select the chart.

Click the Palette command in the Chart Tools: Design tab. In the invoked drop-down list, select the palette that you wish to apply to the chart. After selecting a pallette, the list of styles displays the styles available for this pallet.


Click a style to apply it to the chart.

Chart Wizard


The Chart Wizard is a powerful configuration tool, providing fast access to a full set of options available for charts, including options to manage chart series and their data connections, and to adjust view settings for different parts of a chart (e.g., axes, point labels, and legend).

To invoke the Chart Wizard, click the Run Chart Wizard… command in the Chart Tools: Design tab.

Bar Code

Creating Bar Codes


To add a bar code to a report, click the Bar Code button in the General Tools: Insert toolbar.


This will insert a new bar code into the carriage position.

Transform Existing Field


To transform an existing field to a bar code, do the following.

Select the field that you wish to transform.


Click Properties in the Data Tools: Field toolbar.

In the invoked drop-down menu, expand the Content Type drop-down list and select the Bar Code item.

You can use a bar code to display either static textual data or dynamic data obtained from a data source:


To provide static data to a bar code, specify its Data properties in the Properties menu.


To bind a bar code to dynamic data, specify its Binding property in the Properties menu.

A bar code that does not have a parent Snap list cannot be bound to data, and you can only bind a bar code to the data source of its parent list (i.e., the list in which the bar code resides).

Data-bound bar codes ignore the Data property.

Bar Code Properties


You can customize a bar code’s data binding, symbology and other options via the Properties command from the Field tab of the main toolbar.

Binding – specifies a data field that provides the data to be encoded as a bar code. If this property is specified, the value of the Data property is ignored.

Symbology – determines the bar code type.

Data – specifies textual data to be encoded as a bar code. This property is ignored if a bar code is bound to a data field. If the content does not conform to the rules of a certain symbology (determined by the Symbology property), the control will display a warning, as illustrated in the image below.

Alignment – determines the alignment of the bar code image within the control. To define text alignment, use the Text Alignment property.

Text Alignment – allows you to change the alignment of the control’s text. This option is also available in the Formatting Toolbar. To define the alignment of the bar code image, use the Alignment property.

Orientation – specifies one of four possible orientations (Normal, Upside Down, Rotate to the Left, and Rotate to the Right) for an image within the control.

Show Data – determines whether or not bar code text is shown.

Module – specifies the width of the narrowest bar or space in the bar code. Note that if the Module value is too low, the bar code output may become unreadable by a bar code scanner.

Auto-Module – when the check-box for this property is checked, the bar code image is stretched to fit the entire control’s width, ignoring the value of the Module property.

The bar code quality can degrade when the report is exported to formats other than PDF. To ensure reliable bar code 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.

Print Preview


A Print Preview displays a report document as it will appear on paper.


Main Menu – contains the document management and navigation commands within several menu items (File, View and Background);


Toolbar – provides quick access to document management and navigation commands;


To assemble and preview a tabular report, click Print Preview in the General Tools: File toolbar.

Using the option above to preview a mail merge report will only display the document obtained from the first data source record.

To assemble and preview a mail merge report, click Finish & Merge in the Data Tools: Mail Merge toolbar and select Print Preview in the invoked drop-down menu.


In the invoked Export Range dialog, specify the required range of data records and click OK.

File Formats

Import File Types

A Snap Report can load a document in the following file format.

– DOC (Microsoft® Word® 97 – 2003 document);
– DOCX (Office® Open XML document);
– HTML (HyperText Markup Language);
– MHTML / MHT (Web archive, single file);
– RTF (Rich Text Format);
– TXT (Plain text);
– ODT (OpenDocument text document);
– XML (Microsoft® Word® XML document);

Export File Types

A Snap report can be exported to the following file formats.

– DOC (Microsoft® Word® 97 – 2003 document).
– DOCX (Office® Open XML document);
– HTML (HyperText Markup Language);
– MHTML / MHT (Web archive, single file);
– PDF (Portable Document Format);
– RTF (Rich Text Format);
– TXT (Plain text);
– ODT (OpenDocument text format);
– XML (Microsoft® Word® XML document);
– Image (BMP, EMF, WMF, GIF, JPEG, PNG or TIFF format).

Data Explorer


The Data Explorer is essential for managing data.

It allows you to add new data sources to a document, assess their structure and run the Query Designer to customize a data source.


Using the Data Explorer, you can also manage a report’s parameters, as well as the calculated fields supplied to the data source tables.

You can create a report layout by dropping the data members from the Data Explorer onto a document’s design surface.

The data members correspond to the columns created on the design surface, and the data member names are displayed in the column headers.


When a data field is added to your document, its data type determines what element is created (e.g., text, chart, or bar code).

Report Explorer


Report Explorer reflects the hierarchy of fields in a document, to quickly navigate through its data levels. It displays the order of document lists, and lists their active groups in a tree format.

Clicking a node in the Report Explorer activates the corresponding document element that is closest to the currently displayed page.

Design Surface


The design surface is the primary working area, which contains the document and allows you to modify its layout.

It can display rulers that define the horizontal and vertical alignment of a report’s elements, as well as a scroll bar that allows you to browse different pages of a document.


Right-clicking the design surface invokes the context menu, which displays a specific set of commands based on the element that is clicked.

The WYSIWYG nature allows you to view document content on the design surface in the same way it will appear on paper.

However, the complete document (as it appears in a Print Preview) may differ from the document layout shown in the design surface.

For example, setting the List | Editor Row Limit toolbar option limits the total number of processed data records while the document layout is being designed.

The View toolbar contains the commands that allow you to switch the document presentation mode (Simple View, Draft View, Print Layout), as well as maintain the visibility of rulers and the document zoom factor.