Zoom (Property)

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.
Versions 20 and later
in a Table, TreeView Table, Pivot Table, Spreadsheet or List Box control.
New in version 20
in a Table, TreeView Table, Pivot Table, Spreadsheet or List Box control.
in a Table, TreeView Table, Pivot Table, Spreadsheet or List Box control.
Versions 21 and later
in a window.
New in version 21
in a window.
in a window.
Versions 22 and later
in a Word Processing control.
New in version 22
in a Word Processing control.
in a Word Processing control.
in a PDF Reader control.
Versions 27 and later
in a Camera control.
Remark: This property can only be used on Camera controls that are not in "Version-26-compatible mode".
New in version 27
in a Camera control.
Remark: This property can only be used on Camera controls that are not in "Version-26-compatible mode".
in a Camera control.
Remark: This property can only be used on Camera controls that are not in "Version-26-compatible mode".
Versions 27 and later
in a Diagram Editor control.
New in version 27
in a Diagram Editor control.
in a Diagram Editor control.

Versions 18 and later

This property is now available for Map controls in iPhone/iPad applications.

New in version 18

This property is now available for Map controls in iPhone/iPad applications.

Versions 20 and later

This property is now available for Map controls in WINDEV applications for Windows.

This property is now available for Map controls in WEBDEV sites in Windows and Linux.

This property is now available for Map controls in Browser mode.

This property is now available for Map controls for PHP sites.

New in version 20

This property is now available for Map controls in WINDEV applications for Windows.

This property is now available for Map controls in WEBDEV sites in Windows and Linux.

This property is now available for Map controls in Browser mode.

This property is now available for Map controls for PHP sites.

This property is now available for Map controls in WINDEV applications for Windows.

This property is now available for Map controls in WEBDEV sites in Windows and Linux.

This property is now available for Map controls in Browser mode.

This property is now available for Map controls for PHP sites.

Versions 21 and later

This property is now available in Universal Windows 10 App mode for Map controls.

New in version 21

This property is now available in Universal Windows 10 App mode for Map controls.

Versions 25 and later

This property is now available for PDF Reader controls in Android applications.

This property is now available for PDF Reader controls in iPhone/iPad applications.

New in version 25

This property is now available for PDF Reader controls in Android applications.

This property is now available for PDF Reader controls in iPhone/iPad applications.

This property is now available for PDF Reader controls in Android applications.

This property is now available for PDF Reader controls in iPhone/iPad applications.

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 an Organization Chart control: the zoom percentage.
Versions 20 and later
In a Table, TreeView Table, Pivot Table or Spreadsheet control: the zoom percentage.
New in version 20
In a Table, TreeView Table, Pivot Table or Spreadsheet control: the zoom percentage.
In a Table, TreeView Table, Pivot Table or Spreadsheet control: the zoom percentage.
In a Map control: a value between 1 (view of the entire Earth) and 21.
Versions 21 and later
In a window: the zoom percentage.
New in version 21
In a window: the zoom percentage.
In a window: the zoom percentage.
Versions 22 and later
In a Word Processing control: the zoom percentage.
New in version 22
In a Word Processing control: the zoom percentage.
In a Word Processing control: the zoom percentage.
In a PDF Reader control: the zoom percentage.
Versions 27 and later
in a Camera control: to a value between the values of the MinZoom and MaxZoom properties.
New in version 27
in a Camera control: to a value between the values of the MinZoom and MaxZoom properties.
in a Camera control: to a value between the values of the MinZoom and MaxZoom properties.
Versions 27 and later
In a Diagram Editor control: the zoom percentage.
New in version 27
In a Diagram Editor control: the zoom percentage.
In a Diagram Editor control: the zoom percentage.

<Element used>: Control name or window name

Name of the element to be used:
Name of the Image control.
Name of the Organization Chart control.
Name of the Map control.
Versions 20 and later
Name of the Table, TreeView Table, Pivot Table, Spreadsheet or List Box control.
New in version 20
Name of the Table, TreeView Table, Pivot Table, Spreadsheet or List Box control.
Name of the Table, TreeView Table, Pivot Table, Spreadsheet or List Box control.
Versions 21 and later
Name of the window.
New in version 21
Name of the window.
Name of the window.
Versions 22 and later
Name of the Word Processing control.
New in version 22
Name of the Word Processing control.
Name of the Word Processing control.
Name of the PDF Reader control.
Versions 27 and later
Name of the Camera control.
New in version 27
Name of the Camera control.
Name of the Camera control.
Versions 27 and later
Name of the Diagram Editor control.
New in version 27
Name of the Diagram Editor control.
Name of the Diagram Editor 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 Organization Chart control.
Name of the Map control.
Versions 20 and later
Name of the Table, TreeView Table, Pivot Table, Spreadsheet or List Box control.
New in version 20
Name of the Table, TreeView Table, Pivot Table, Spreadsheet or List Box control.
Name of the Table, TreeView Table, Pivot Table, Spreadsheet or List Box control.
Versions 21 and later
Name of the window.
New in version 21
Name of the window.
Name of the window.
Versions 22 and later
Name of the Word Processing control.
New in version 22
Name of the Word Processing control.
Name of the Word Processing control.
Name of the PDF Reader control.
Versions 27 and later
Name of the Camera control.
New in version 27
Name of the Camera control.
Name of the Camera control.
Versions 27 and later
Name of the Diagram Editor control.
New in version 27
Name of the Diagram Editor control.
Name of the Diagram Editor control.

<New zoom>: Integer or Integer constant

New zoom value that will be applied to the element.
Versions 24 and later
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.
New in version 24
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 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.
Versions 20 and later
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.
New in version 20
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.
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.

Versions 20 and later
For a Table, TreeView Table, Pivot Table, Spreadsheet or List Box control: this value corresponds to a percentage.
New in version 20
For a Table, TreeView Table, Pivot Table, Spreadsheet or List Box control: this value corresponds to a percentage.
For a Table, TreeView Table, Pivot Table, Spreadsheet or List Box control: this value corresponds to a percentage.
Versions 21 and later
For a window, this value corresponds to a percentage.
New in version 21
For a window, this value corresponds to a percentage.
For a window, this value corresponds to a percentage.
Versions 22 and later
For a Word Processing control, this value corresponds to a percentage.
New in version 22
For a Word Processing control, this value corresponds to a percentage.
For a Word Processing control, this value corresponds to a percentage.
Versions 27 and later
For a Camera control, this value is between the values of the MinZoom and MaxZoom properties.
New in version 27
For a Camera control, this value is between the values of the MinZoom and MaxZoom properties.
For a Camera control, this value is between the values of the MinZoom and MaxZoom properties.
Versions 27 and later
For a Diagram Editor control, this value corresponds to the zoom percentage.
New in version 27
For a Diagram Editor control, this value corresponds to the zoom percentage.
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.
Versions 20 and later
Table, TreeView Table, Pivot Table, Spreadsheet or List Box controls.
New in version 20
Table, TreeView Table, Pivot Table, Spreadsheet or List Box controls.
Table, TreeView Table, Pivot Table, Spreadsheet or List Box controls.
Versions 21 and later
windows
New in version 21
windows
windows
Versions 22 and later
Word Processing controls.
New in version 22
Word Processing controls.
Word Processing controls.
PDF Reader controls.
Versions 27 and later
Camera controls.
New in version 27
Camera 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.