TouchZoom (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

Use in an Image control
Use in a Camera control

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

TouchZoom (Property)

In french: ZoomAuDoigt

Warning
From version 2025, ZoomWithFinger is kept for backward compatibility. This property has been replaced with TouchZoom.

The TouchZoom property allows you to:

determine if an Image or Camera control supports pinch zoom.
enable or disable pinch zoom in an Image or Camera control.

To use this property on a Camera control, the control must have been created with version 27 or have the following option unchecked: Version-26-compatible mode: Use VideoParameter( ) to configure the control ("General" tab of the Camera control).

Example

// In drawing mode, no pinch zoom
IF bDrawing = True THEN
	IMG_Image1.TouchZoom = False
ELSE
	IMG_Image1.TouchZoom = True
END

Syntax

Determining if an Image or Camera control supports pinch zoom Hide the details

<Result> = <Control used>.TouchZoom

<Result>: Boolean

True if pinch zoom is enabled,
False otherwise.

<Control used>: Control name

Name of the control to be used:
Image control,
Camera control.

Enabling or disabling pinch zoom in an Image or Camera control Hide the details

<Control used>.TouchZoom = <Authorization>

<Control used>: Control name

Name of the control to be used:
Image control,
Camera control.

<Authorization>: Boolean

True to enable pinch zoom,
False otherwise.

Remarks

Use in an Image control

This property is mainly used to temporarily interrupt the pinch zoom in order to drawn in an Image control. Similarly, touch scrolling can be interrupted with the TouchScrollable property.
Note: For an Image control, the scroll and zoom features must have been enabled in the description window ("Automatic scrolling and zoom" option in the "Details" tab).
Calling dStartDrawing automatically disables pinch zoom and touch scrolling.

Use in a Camera control

When pinch zoom is enabled, the user can zoom in/out by moving two fingers together or apart in the Camera control.
This property corresponds to the "Enable pinch zoom" option in the "General" tab of the control description window.
When the user zooms in or out, the "Zoom in or out" event is executed. This event gets the value of the new zoom. To use this parameter, it is necessary to declare a procedure directly in the "Zoom in or out" event.
The procedure must be declared with the following syntax:
PROCEDURE <Procedure name>(<Zoom>)
where <Zoom> is the new zoom value expressed as a percentage.