03.05.2013 Views

ActionScript 2.0 Language Reference - Adobe Help and Support

ActionScript 2.0 Language Reference - Adobe Help and Support

ActionScript 2.0 Language Reference - Adobe Help and Support

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Methods inherited from class Object<br />

addProperty (Object.addProperty method), hasOwnProperty<br />

(Object.hasOwnProperty method), isPropertyEnumerable<br />

(Object.isPropertyEnumerable method), isPrototypeOf (Object.isPrototypeOf<br />

method), registerClass (Object.registerClass method), toString<br />

(Object.toString method), unwatch (Object.unwatch method), valueOf<br />

(Object.valueOf method), watch (Object.watch method)<br />

addPage (PrintJob.addPage method)<br />

public addPage(target:Object, [printArea:Object], [options:Object],<br />

[frameNum:Number]) : Boolean<br />

Sends the specified level or movie clip as a single page to the print spooler. Before using this<br />

method, you must use PrintJob.start(); after calling PrintJob.addPage() one or more<br />

times for a print job, you must use PrintJob.send() to send the spooled pages to the<br />

printer.<br />

If this method returns false (for example, if you haven't called PrintJob.start() or the<br />

user canceled the print job), any subsequent calls to PrintJob.addPage() will fail. However,<br />

if previous calls to PrintJob.addPage() were successful, the concluding PrintJob.send()<br />

comm<strong>and</strong> sends the successfully spooled pages to the printer.<br />

If you passed a value for printArea, the xMin <strong>and</strong> yMin coordinates map to the upper left<br />

corner (0,0 coordinates) of the printable area on the page. The user's printable area is<br />

described by the read-only pageHeight <strong>and</strong> pageWidth properties set by PrintJob.start().<br />

Because the printout aligns with the upper left corner of the printable area on the page, the<br />

printout is clipped to the right <strong>and</strong>/or bottom if the area defined in printArea is bigger than<br />

the printable area on the page. If you haven't passed a value for printArea <strong>and</strong> the Stage is<br />

larger than the printable area, the same type of clipping takes place.<br />

If you want to scale a movie clip before you print it, set its MovieClip._xscale <strong>and</strong><br />

MovieClip._yscale properties before calling this method, <strong>and</strong> set them back to their<br />

original values afterward. The scale of a movie clip has no relation to printArea. That is, if<br />

you specify that you print an area that is 50 x 50 pixels in size, 2500 pixels are printed. If you<br />

have scaled the movie clip, the same 2500 pixels are printed, but the movie clip is printed at<br />

the scaled size.<br />

The Flash Player printing feature supports PostScript <strong>and</strong> non-PostScript printers. Non-<br />

PostScript printers convert vectors to bitmaps.<br />

Availability: <strong>ActionScript</strong> 1.0; Flash Player 7<br />

PrintJob 1035

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!