AlbumSave (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Backup in the photo album
Photos found on an external memory
Required Android version
Required application feature

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

AlbumSave (Function)

In french: AlbumSauve

Saves an image, a photo or a video in the photo album of the mobile device. This image can be re-used by AlbumPicker.

Versions 18 and later

This function is now available in Android Widget mode.

This function is now available for the Android applications.

New in version 18

This function is now available in Android Widget mode.

This function is now available for the Android applications.

This function is now available in Android Widget mode.

This function is now available for the Android applications.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

// Save an image found in an image variable
MyImage is Image = "Test.png"
AlbumSave(MyImage)

// Save a photo
IF AlbumSave(VideoStartApp(viPictureCapture)) = False THEN
Info("Image not saved")
END

Versions 18 and later

// Save a video
IF AlbumSave(VideoStartApp(viVideoCapture)) = False THEN
Info("Video not saved")
END

New in version 18

// Save a video
IF AlbumSave(VideoStartApp(viVideoCapture)) = False THEN
Info("Video not saved")
END

Syntax

Saving an image found in an Image variable Hide the details

<Result> = AlbumSave(<Image>)

<Result>: Boolean

True if the backup was successful,
False otherwise.

<Image>: Image variable

Name of the Image variable corresponding to the image that will be added into the album.

Saving an image found in a control (Image or Chart) Hide the details

<Result> = AlbumSave(<Control Name>)

<Result>: Boolean

True if the backup was successful,
False otherwise.

<Control Name>: Character string (with or without quotes)

Name of the Image control or name of the Chart control containing the image to add into the album.

Saving an image found in a file Hide the details

<Result> = AlbumSave(<Name of Image File>)

<Result>: Boolean

True if the backup was successful,
False otherwise.

<Name of Image File>: Character string (with quotes)

Full name or relative name of the image or video file that will be added into the album (name of the file returned by VideoStartApp for example).
Versions 18 and later
The videos that can be saved in the photo album correspond to the files whose extension is: ".mp4", ".mov", ".avi" and ".mpg".
New in version 18
The videos that can be saved in the photo album correspond to the files whose extension is: ".mp4", ".mov", ".avi" and ".mpg".
The videos that can be saved in the photo album correspond to the files whose extension is: ".mp4", ".mov", ".avi" and ".mpg".

Remarks

Backup in the photo album

When saving an image in the photo album, the image is saved in the public directory for storing images or videos then it is referenced in the albums of the device.

The public directory for storing images corresponds to an external memory (SD Card for example). The function will fail if this directory is not available.

Photos found on an external memory

In Android, the images and the videos found on the external memory (SDCard for example) of the device are automatically scanned by the system in order to be added to the albums.

When saving an image found in a file (syntax 3):

if the specified file is found on the external memory, the function will have no effect.
if the file is found in another directory, the file will be copied into the public directory for storing images or videos and referenced in the albums of the device.

Required Android version

This function is available on the devices running Android version 2.2 or later (api level 8).

A fatal error will occur if the function is used with an earlier system version.

To find out the version of Android system on which the application is run, use SysAndroidVersion.

iPhone/iPad
Only the photos and images can be saved in the photo album. The videos cannot be saved in the photo album.

Versions 21 and later

Required application feature

The use of this function triggers the declaration of an application feature in the wizard for generating the application.

Required features:

Video library
Image library

New in version 21

Required application feature

The use of this function triggers the declaration of an application feature in the wizard for generating the application.

Required features:

Video library
Image library

Required application feature

The use of this function triggers the declaration of an application feature in the wizard for generating the application.

Required features:

Video library
Image library