Navigation: Templates > Guide to all Templates > Wizard Themes >====== Report Customization ====== | |
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