Zoom (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

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

Drawing functions, zoom and automatic scrollbars
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 an Organization Chart control.
in a Table, TreeView Table, Pivot Table, Spreadsheet or List Box control.
in a window.
in a Word Processing control.
in a PDF Reader control.
in a Camera control.
Note: This property can only be used for camera fields that are not in "26 compatible mode"..
in a Diagram Editor control.

Example

// Effectue un zoom à 40% du fichier PDF affiché dans le champ Image
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 field: at zoom percentage.
In an Organization Chart control: zoom percentage.
In a Table, Hierarchical Table, Crosstab or Spreadsheet field: at the zoom percentage..
In a Map control: to a value between 1 (display of the whole earth) and 21.
In a window: at zoom percentage.
In a Word Processing control: to the zoom percentage.
In a PDF Reader control field: zoom percentage.
In a Camera field: to a value between the MinZoom and MaxZoom property values.
In a Diagram Editor control: zoom percentage.

<Element used>: Control name or window name

Name of element to use:
Name of the Image control.
Name of the Organization Chart control.
Name of the Map control.
Name of the Table, TreeView Table, Pivot Table, Spreadsheet or List Box control.
Name of the window.
Name of the Word Processing control.
Name of the PDF Reader control.
Name of the Camera control.
Name of the Diagram Editor control.

Changing the zoom value Hide the details

<Element used>: Control name or window name

Name of element to use:
Name of the Image control.
Name of the Organization Chart control.
Name of the Map control.
Name of the Table, TreeView Table, Pivot Table, Spreadsheet or List Box control.
Name of the window.
Name of the Word Processing control.
Name of the PDF Reader control.
Name of the Camera control.
Name of the Diagram Editor 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.
Note: when a new PDF file is loaded into the field, the zoom value is not retained..
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.
Note: when a new image is loaded into the field, the zoom value is not retained..
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 an Organization Chart control, this value corresponds to a percentage.

For a Table, Hierarchical Table, Crosstab, Spreadsheet or List field: this value corresponds to a percentage..
For a window, this value corresponds to a percentage.
For a Word Processing control, this value corresponds to a percentage.
For a Camera control, this value is between the values of the MinZoom and MaxZoom properties.
For a Diagram Editor control, this value corresponds to the zoom percentage.

Remarks

Drawing functions, zoom and automatic scrollbars

The "Automatic scrollbars and zoom" option, available for Image controls, is not compatible with dStartDrawing. If this option is used on the Image control, dStartDrawing freezes the image in the control. The zoom is also fixed. The standard behavior is restored when dEndDrawing is called.

You can get the same effect with dPixelColor and dRotation.

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.
Organization Chart controls.
Table, TreeView Table, Pivot Table, Spreadsheet or List Box controls.
windows.
Word Processing 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.