printonemultiple statement

printonemultiple

VARIABLE

START

END

BUMP

COPIES

The printonemultiple statement prints a form over and over again without advancing from record to record. Instead of advancing from record to record, a variable is incremented each time the form is printed. This statement is designed for printing calendars or thumbnails.

Parameters

This statement has five parameters:

variable – is the name of the variable you wish to increment each time the form is printed. If the variable does not already exist, it will be created as a fileglobal variable.

start – is the beginning sequence number or date value.

end – is the ending sequence number or date value.

bump – is the increment value for your sequence. bump may be a number, a numeric variable, or a formula which results in a positive numeric integer. The bump value must be a positive integer for a numeric field. For a date field bump may also be one of the following: "M" for month, or "Y" for year. This parameter is optional, if omitted, the default is 1.

copies – the number of times the form is printed for each sequence number. This parameter is optional, if ommitted, the default is 1 copy.

Description

This statement will print a form a predetermined number of times. Each printing of the form may be sequenced with incrementing integer or date values in a specified variable. Note: the printonemultiple statement does not actually print, but must be followed by a printonerecord statement.

This example prints the next 3 months of a monthly calendar. The example assumes that the form Monthly Calendar will display the month specified by the variable CalendarDate.

global CalendarDate
openform "Monthly Calendar"
printonemultiple CalendarDate,today(),today()+90,"m",1
printonerecord dialog
closewindow

This example prints all the picture files in the current folder. The example assumes that the form Picture Matrix will display 20 pictures per page, probably using a Matrix object. The picture in the top left corner of each is controlled by the global variable PicNumber.

global PicNumber,PicMax
PicMax=arraysize( listfiles("","PICT"),cr())
openform "Picture Matrix"
printonemultiple PicNumber,1,PicMax,20,1
printonerecord dialog
closewindow

See Also

Automatic Mailing Label Construction -- creates a mailing label.
Automatic Report Construction -- creates a tabular report with columns of data.
info("pagecount") -- calculates the total number of pages that will be printed.
info("pagenumber") -- returns the current report page number.
info("printer") -- returns the current default printer.
info("printers") -- returns a list of all available printers.
info("printsequence") -- returns the record sequence number of the record being printed.
pagesetup -- displays the page setup dialog.
print -- prints the database.
printonerecord -- prints the the currently active record.
printpdf -- prints the current database to a PDF file.
printpreview -- previews what printing the current window will look like.
printpreviewonerecord -- previews what printing the current record will look like.
printtopdf -- prints the current database to a PDF file.
printusingform -- allows the current database to be printed using a different form than the one currently being displayed.
Report Tile Object -- component for assembling a custom report.
setreportcolumns -- allows a procedure to control the number of columns of a report, and the direction (across or down).

History

Version	Status	Notes
10.0	Updated	Carried over from Panorama 6.0, but the BUMP and COPIES parameters are now optional.