Zoom Property (VSPrinter)

Returns or sets the preview scale: set to a percentage, or zero to fill the control.

Syntax

[form!]VSPrinter.Zoom[ = value As Double ]

Remarks

If you set the Zoom property to 100, then the preview page appears in actual size. If you set it to 50, the page appears in half its actual size, and so on.

If the page image is larger than the control, scroll bars are automatically added. If the control is larger than the page image, the image is centered on the control and the empty area around it is filled with the color specified by the EmptyColor property.

You can add automatic mouse support for panning, zooming, and switching pages by setting the Navigation property.

If you set the Zoom property to zero, the page image is stretched to fill the entire control. This is not a very useful setting, but is provided for compatibility with earlier versions of the control.

The Zoom property works in conjunction with the ZoomMode property. If ZoomMode is set to a value other than zmPercentage, the Zoom property returns the current zoom factor, which changes automatically when the control is resized. If you assign a value to the Zoom property, the ZoomMode property will automatically be set to zmPercentage, and the zoom factor will remain constant when the control is resized.

Data Type

Double