Type | command | |||||||||||||||||||||
Dictionary | LCS | |||||||||||||||||||||
Library | LiveCode Script | |||||||||||||||||||||
Syntax |
| |||||||||||||||||||||
Summary | Prints one or more cards. | |||||||||||||||||||||
Introduced | 1.0 | |||||||||||||||||||||
OS | mac, windows, linux, ios | |||||||||||||||||||||
Platforms | desktop, mobile | |||||||||||||||||||||
Parameters |
| |||||||||||||||||||||
Example |
| |||||||||||||||||||||
Related | Keyword: file, marked, rectangle, card Property: printRectangle, printGutters, printFontTable, printPageNumber, printCommand, printRowsFirst, printDuplex, lockScreen, printTitle, printCollate Message: openCard Command: revPrintReport, answer page setup, mark, cancel printing, revBrowserPrint, open printing, close printing, answer printer, reset printing Object: card, stack Glossary: object, property, Windows, Unix, command, PostScript, Mac OS | |||||||||||||||||||||
Security | printing | |||||||||||||||||||||
Description | Use the print command to print out a card, a set of cards, or all the cards of a stack. The print command prints only the area of a card that is visible in the stack window. To print an area of a card whose objects extend beyond the window boundaries, either set the stack's rectangle so it's large enough to hold all the objects to print, or use the print...from form of the print command. To print multiple cards selected one at a time, start with the openprinting command, issue any print commands you want, then use the close printing command to print all the cards you specified in the print commands as a single batch. If you specify a form that includes more than one card (such as print stack), the cards may be printed more than one to a page, depending on the size of the cards and on whether you specify a pageRect. The print marked cards form prints all the cards in the current stack whose mark property is set to true. The print all cards form is equivalent to The print break form forces a page break.
LiveCode visits each card as it's printed, returning to the original card when the printing is done, but it doesn't send any system messages such as openCard while moving from card to card during printing. If you don't want the user to see these card changes, set the lockScreen property to true before you print. *Cross-platform note:* On Mac OS and Windows systems, the print command uses the current printer. On Unix systems, the print command creates a PostScript file and runs the program specified in the printCommand property, with the file as input. |