Clarion Community Help

custreportadditionscustreportreportcustreportprogresswindowcustreportprocedure

The settings here control the appearance of the Report procedure generated by the Report Wizard. These settings can be saved for use in other future applications.

Procedure:

Procedure Name

Enter a name that the Report Wizard will use to generate procedure names in your application. The template macro symbol, %FileName, is required, and extracts the Dictionary file name for each file selected by the wizard. You can modify this line with other template macros and text if you wish. No spaces are allowed in procedure names. This name is used for files that have no keys defined

Procedure “With Key”

This prompt is similar to Procedure Name, but is used for designated files that have a key (or keys) defined in the Dictionary Editor.

Progress Window

Caption

Text that is entered on this line will be used as the description of the report's progress window, and appear in the progress window's title bar.

Background

Enter a default image here to use as a graphic or watermark for your report's progress window.

Mode

If you have designated a background image to use for your report's progress window, this option becomes available to control if the image is tiled, stretched, or centered.

Icon

Enter a default icon, or press the ellipsis button to select an icon file for use in your report's progress window. This will allow your window to be minimized if needed.

Font

Press the Font button to select a default font to use for the report's progress window. Sample text shown below the button is provided to allow you to review your selection.

Width

Enter the default width in dialog units for the report's progress window.

Height

Enter the default height in dialog units for the report's progress window.

Position

Select from the drop list to designate the initial position of your Progress window. You can center the window, or use the default position that is set by the template wizard.

Controls

There are four default controls in the Progress Window that you can customize:

ProgressTPLWizardControlCustomization

Pct TextTPLWizardControlCustomization

User StringTPLWizardControlCustomization

Cancel ButtonButton_Customization

Report Layout

reportformreportfooterreportdetailreportheaderreportgeneral

General

The settings in this tab control refer to the settings of the current active report layout, whose name is displayed at the top.

Job Name

Enter the print job name to use for the Windows Print Manager. If omitted, the REPORT's label is used. The default setting is “Report %FileName”.

Paper Type

Select the paper size for the report output from the drop list provided.

Paper Width

If you select “Other” as the Paper Type, you must enter a custom paper width.

Paper Height

If you select “Other” as the Paper Type, you must enter a custom paper height.

Margins

Margin setting control the printable area of your reports. Specify the Top, Bottom, Left and Right margin settings in thousandths of an inch

Check the Automatic Adjust Top and Bottom box to allow auto resizing of the margins when the report header or footer heights are resized.

Press the Adjust Using Header and Footer Size button to manually update the margin settings to conform to any changes made to the header and footer height positions. This button is only enabled if the Automatic Adjust Top and Bottom box is unchecked, to avoid sizing conflicts.

Orientation

Specify here what paper orientation the report layout will use (Portrait or Landscape).

Font

Press the Font Button to specify a default font to use for reports that the wizard will generate. There are several other places where you can override this setting.

Show Preview

Check this box to designate that all reports generated by the wizard will have a Print Preview window associated with it.

Preview Maximized

If the Show Preview box is checked, you can designate here that the Print Preview window will open in maximized mode (full screen).

Initial Zoom Setting

If the Show Preview box is checked, you can designate an initial zoom setting from this setting.

Header

The HEADER structure declares the output that prints at the beginning of each page or group.

Add Header

Check this box to allow your reports that are generated by the wizards to declare a HEADER section.

Background Color

If your user has support for color printing, you can designate a color to use as a background for the report's header.

Report Title

Enter a string or expression that will be used as the report title for each report generated by the report wizard. Since you can generate many report from different tables specified, it is a good idea to use a template macro here. The default is “Report %FileName file”

Position Y

Specify the starting position of the report title, relative to the start of the printable header area. Value is expressed in thousandths of an inch.

Justification

Specify how the contents of header text will be justified. The default is Center, but you can also specify Left or Right justified.

Title Font

The report title's font can be controlled with this setting. Press the Title Font button to designate the appearance of the title text.

Position

Enter the starting X and Y coordinates for the upper left corner of the header area, which is measured in thousandths of an inch, and relative to the upper left corner of the report's printable area. Enter the header area's width and height, also measured in thousandths of an inch

Font

Press the Font button to select the font (typeface), size, style (such as bold or italic), color, and font effects (underline and strikeout) for all controls in the header section. A sample of the selected font is displayed on the tab control.

Header Box

Check the Add Header box to add a box control to the report header. You will then be able to specify a color, Top (or width), and Height settings.

Detail

The detail area is the “body” of the report. Usually, your most important and relevant data will be printed here.

Background Color

If your user has support for color printing, press the ellipsis button to designate a color here to use as a background for the report's detail area.

Position

Enter the starting X and Y coordinates for the upper left corner of the detail area, which is measured in thousandths of an inch, and relative to the upper left corner of the report's printable area, or to the last item printed in the detail print area. Enter the detail area's width and height, also measured in thousandths of an inch.

Think of this setting as the “record” or “row” area of your report.

Font

Press the Font button to select the font (typeface), size, style (such as bold or italic), color, and font effects (underline and strikeout) for all controls in the Detail section. A sample of the selected font is displayed on the tab control.

Add Detail Lines

Check this box to instruct the template to generate a horizontal line between each detail section printed.

Automatic adjust Band Height with Row Number

Check this box to instruct the template to generate the total detail area's height based on the number of rows that are calculated at design time. The number of rows calculated is based on the data elements selected to print and number of report columns designated for each row.

This prevents extra white space from being generated between the last detail on the page and the page footer.

Footer

The report FOOTER area is normally used to print text and data at the end of each page.

Add Footer

Check this box to allow your reports that are generated by the wizards to declare a FOOTER section.

Background Color

If your user has support for color printing, press the ellipsis button to designate a color here to use as a background for the report's footer area.

Position

Enter the starting X and Y coordinates for the upper left corner of the footer area, which is measured in thousandths of an inch, and relative to the lower left corner of the report's detail area, or to the last item printed in the detail print area. Enter the detail area's width and height, also measured in thousandths of an inch.

Font

Press the Font button to select the font (typeface), size, style (such as bold or italic), color, and font effects (underline and strikeout) for all controls in the report's footer section. A sample of the selected font is displayed on the tab control.

Form

The Form Band is normally used to specify constant text or graphics which print on every page (for example, a watermark or a tax form)

Add Form

Check this box to allow your reports generated by the wizards to specify a Form section.

Background Color

If your user has support for color printing, press the ellipsis button to designate a color here to use as a background for the report's form band area.

Margins

Margin settings control the printable area of your form band. Specify the Top, Bottom, Left and Right margin settings in thousandths of an inch

Font

Press the Font button to select the font (typeface), size, style (such as bold or italic), color, and font effects (underline and strikeout) for all controls in the report's Form Band section. A sample of the selected font is displayed on the tab control.

Image

Add Image

Check this box to allow an image control to be populated on the Form band. This check box also enables the remaining options.

Image File

Press the ellipsis button to select the name of the image file to be used in the populated image control. Any image format supported by the Windows print engine may be selected.

Mode

Select from the drop list how the image file will be rendered on the report. Select from tiled, stretched, and centered.

Image Position

If width and height are zero(0), the image will use the settings specified by the form band. Set the X and Y position to designate the anchor position of the top left corner.

Additions

Page Number ControlReport_Additions_Customization

Date and Time ControlReport_Additions_Customization