The Report Image

Available only for graphical reports, the report image corresponds to the ACUCOBOL-GT standard bitmap control. You use the Open dialog box to position a report image in the Report Composer window.

Note that in addition to placing one or more image controls on a report, you can also specify a Watermark property for the report (discussed in Configuring Report and Section Properties) or display images in a report table control.

The report image Property window contains the following control-specific properties in addition to the properties described in Common Report Control Properties.

Bitmap

The Value cell for this property has an ellipsis push button that displays the Open dialog box, from which you can navigate to *.bmp files. The Bitmap property records the name of the selected bitmap file. If the selected bitmap is not in a directory contained in the COPYPATH environment setting, the full path to the bitmap is recorded here.

Bitmap Path

A drop-down box allows the selection of Full Path, Dynamic Full Path, and User Defined. These property selections affect how the bitmap file is located:

With the Full Path setting (the default), the browser uses the full path of the bitmap (as recorded when it was selected in the Report Composer) to locate the bitmap file.

When you set this property to Dynamic Full Path a call to the C$FULLNAME library routine is used to derive the full path of the bitmap file. The bitmap can be stored in any of the FILE-PREFIX directories named. The browser uses the full path of the bitmap to locate the bitmap file.

With the User Defined setting, the browser searches for the bitmap in the same directory as the HTML file.

Bitmap Position

A drop-down box allows the selection of Center, Left Top, Left Bottom, Right Top, and Right Bottom. Use these settings to position your bitmap in the report image control (when the Bitmap Style property is set to Ratio).

Bitmap Style

A drop-down box allows the selection of Stretch and Ratio. This property has no default value.

When Bitmap Style is set to Ratio, the bitmap’s height-to-width ratio is preserved inside the space allocated for the bitmap. If the bitmap display is smaller than the space allocated for it, the positioning function is similar to the justification of a text field, orienting to left, right, top, bottom, and center.

When Bitmap Style is set to Stretch, the bitmap height-to-width ratio is altered if necessary to fit the bitmap into the space allocated for it. Note that when Bitmap Style is set to Stretch, the Bitmap Position property setting is ignored.

Print If Repeat

A drop-down box allows the selection of TRUE or FALSE. This condition is applied when consecutive records contain the same data values. When this property is set to TRUE (the default), both data values print. When it is set to FALSE, the second (and subsequent) same data values do not print.

Value Variable

The Value cell for this property has an ellipsis push button that opens the Select Variable interface. The Value Variable is not directly referenced by the generated code, but may be used by the user.