Printing Functions > VpeSetPrintScale

[Windows platform only; Professional Edition and higher only]

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.

void VpeSetPrintScale(

VpeHandle hDoc,

double scale

)

VpeHandle hDoc

Document Handle

double scale

the scaling factor, must be between 0.01 and 6.0

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:

VpeSetPrintScale(hDoc, 0.5);

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

VpeSetPrintScale(hDoc, 4.0);

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