PrintScale

<< Click to Display Table of Contents >>

Navigation:  Printing Functions >

PrintScale

Previous pageReturn to chapter overviewNext page

[Windows platform only, Professional Edition and higher only, not supported by PHP]

This property sets the scale for printing. It does not affect the scale in the preview.

Since the X- and Y- dimensions are scaled simultaneously, this property changes the width and the height of the printout at the same time. The change of the PrintScale implies a change of the positions of all object's contained in the document.

This might lead to problems regarding the positioning of the topmost / leftmost objects:
if for example a text is placed at the position (2, 2) and the PrintScale is set to 0.75 then the position of the text is changed to 0.75 * (2, 2) = (1.5, 1.5). If you have placed objects very near to the unprintable area, or if you have set the PrintScale to a very small value, objects might be moved into the unprintable area and clipped.

This can be corrected by setting the PrintOffsetX- and PrintOffsetY - properties. By using these properties you can align the printout anywhere on the paper, even on the center.

The PrintScale property is not stored in VPE Document files. Therefore VPEView - the Document Viewer - will print all documents unscaled.

property double VPE.PrintScale

read / write; runtime only

Default:

1.0 which means the printout is unscaled (the scaling factor is 1:1)

Remarks:

The setting for the PrintScale is not stored in VPE Document files.

Example:

VPE.PrintScale = 0.5

Sets the print scale to 0.5 : 1, i.e. the printout is half the size than the original size.

 

VPE.PrintScale = 4.0

Sets the print scale to 4 : 1, i.e. the printout is four times bigger than the original size.

 

See also:

"Positioning On the Printer" in the Programmer's Manual