AlbumSave (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Specific Mobile functions

Adding an image to the photo album

Photos found on an external memory

Required application feature

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 Android applications.

New in version 18

This function is now available in Android Widget mode.

This function is now available for Android applications.

This function is now available in Android Widget mode.

This function is now available for 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

Saves an image found in an Image variable Hide the details

<Result> = AlbumSave(<Image>)

<Result>: Boolean

True if the image was successfully saved,
False otherwise.

<Image>: Image variable

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

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

<Result> = AlbumSave(<Control name>)

<Result>: Boolean

True if the image was successfully saved,
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.

Saves an image found in a file Hide the details

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

<Result>: Boolean

True if the image was successfully saved,
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 added to the photo album correspond to files with the following extension: ".mp4", ".mov", ".avi" and ".mpg".
New in version 18
The videos that can be added to the photo album correspond to files with the following extension: ".mp4", ".mov", ".avi" and ".mpg".
The videos that can be added to the photo album correspond to files with the following extension: ".mp4", ".mov", ".avi" and ".mpg".

Remarks

Adding an image to the photo album

When adding an image to the photo album, the image is saved in the public image or video directory, then it is referenced in the albums of the device.

The public image directory 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 adding 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.

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

Component : wd250android.jar