Zoom (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls

How zoom works
Limitation

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Zoom (Property)

In french: Zoom

The Zoom property gets or sets the zoom value:

in an Image control. The management of automatic scrollbars and zoom must be enabled in this Image control ("Automatic scrollbars and zoom" in the "Details" tab of the control description window).
in a Map control.
in a PDF Reader control.
in a Camera control.
Remark: This property can only be used on Camera controls that are not in "Version-26-compatible mode".

Example

// 40% zoom on the PDF file displayed in the Image control
IMG_Image_PDF.Zoom = 40

Syntax

Getting the zoom value Hide the details

<Result> = <Element used>.Zoom

<Result>: Integer

Zoom factor in the control. This value corresponds to:
In an Image control: the zoom percentage.
In a Map control: a value between 1 (view of the entire Earth) and 21.
In a PDF Reader control: the zoom percentage.
in a Camera control: to a value between the values of the MinZoom and MaxZoom properties.

<Element used>: Control name or window name

Name of the element to be used:
Name of the Image control.
Name of the Map control.
Name of the PDF Reader control.
Name of the Camera control.

Changing the zoom value Hide the details

<Element used>: Control name or window name

Name of the element to be used:
Name of the Image control.
Name of the Map control.
Name of the PDF Reader control.
Name of the Camera control.

<New zoom>: Integer or Integer constant

New zoom value that will be applied to the element.
For a PDF Reader control, this value can correspond to:
a percentage.
one of the following constants:
zoomAdaptHeight Displays the PDF file at full height in the PDF Reader control.
zoomAdaptSize Displays the entire PDF file in the PDF Reader control.
zoomAdaptWidth Displays the PDF file at full width in the PDF Reader control.
Remark: the zoom value is lost when a new PDF file is loaded in the control.
For an Image control, this value can correspond to:
a percentage.
one of the following constants:
zoomAdaptHeight Displays the image full height in the Image control.
zoomAdaptSize Displays the entire image in the Image control.
zoomAdaptWidth Displays the image full width in the Image control.
Remark: the zoom value is lost when a new image is loaded in the control.
For a Map control:
this value is between 1 (view of the entire Earth) and 21.
this value can correspond to the following constant:
zoomAdaptSize Adapts the zoom of the Map control to show all the markers at the same time.

For a Camera control, this value is between the values of the MinZoom and MaxZoom properties.

Remarks

How zoom works

The Zoom property corresponds to a value between the values of the MinZoom and MaxZoom properties . This value corresponds to the magnification factor. For example, if the Zoom property is set to 2, it means that a '2x' zoom is applied.

If the value of the Zoom property is greater than that of the MaxZoom property, the zoom takes the value of MaxZoom.
If the value of the Zoom property is less than that of the MinZoom property, the zoom takes the value of MinZoom.

Limitation

This property applies only to:

Image controls with the "Automatic scrollbars and zoom" option.
Map controls.
PDF Reader controls.
Camera controls.

Related Examples:

Unit examples (WINDEV): The Image control (display a PDF or a TIFF)

[ + ] Displaying a PDF or TIFF document in the Image control found in a window.

Unit examples (WEBDEV): The Map control

[ + ] This example explains how to use the Map control of WEBDEV.
It can be used to display a map that includes markers as well as an itinerary.

Unit examples (WINDEV): The Map control

[ + ] Using the Map control of WINDEV.
It is used to display a map that includes markers as well as an itinerary.