AlbumPicker (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Mobile specific functions

Album functions

AlbumPicker

Presentation

Example

Operating mode

Specific features for iPhone/iPad

Specific features for Android

Application in the background: Specific case from Android 10

Required application feature

See also

AlbumPicker (Function)

In french: AlbumSélecteur

Retrieves a photo, an image or a video stored in the photo album of the mobile device.

Example

// Select the image
// recommended syntax on iOS and Android
// Caution: On Android 10 and higher, applications must not run in the background.
bRes is boolean
bRes = AlbumPicker(AlbumPicker_Callback)

INTERNAL PROCEDURE AlbumPicker_Callback(sImagePath = "")
IMG_MyImage = sImagePath
END

// Select the image
// iOS and Android: Use the syntax with procedure
ImagePath is string
ImagePath = AlbumPicker()
IF ImagePath = "" THEN
Error(ErrorInfo())
RETURN
END
IMG_MyImage = ImagePath

Syntax

Not available in iOS widget mode

Selecting an element in the album: path returned directly Hide the details

<Result> = AlbumPicker([<Type to retrieve>])

<Result>: Character string

Full path of the file where the photo or the image was saved,
Empty string ("") if an error occurred. To get more details on the error, use ErrorInfo.

<Type to retrieve>: Optional Integer constant

Type of element that will be retrieved in the album:
albumImage
(Default value) Select an image in the album.
albumVideo Select a video in the album.

Remark: these constants cannot be combined. A single type can be selected during the call to the function.

Selecting an element in the album: path retrieved in a procedure (Recommended syntax) Hide the details

<Result> = AlbumPicker([<Type to retrieve>, ] <WLanguage procedure>)

<Result>: Boolean

True if the image or the video was selected,
False otherwise.

<Type to retrieve>: Integer constant

Type of element that will be retrieved in the album:
albumImage
(Default value) Select an image in the album.
albumVideo Select a video in the album.

Remark: these constants cannot be combined. A single type can be selected during the call to the function.

<WLanguage procedure>: Procedure name

Name of WLanguage procedure run during the selection in the album. For more details on this procedure, see Parameters of the procedure used by AlbumPicker.

Remarks

Operating mode

When AlbumPicker is called, the user selects the desired image from the images displayed in a specific window.

Once the choice is validated, the selected image is saved:

AlbumPicker returns the photo save path so that it can be handled (syntax 1).
the specified WLanguage procedure is used to find out the photo save path so that it can be handled (syntax 2).

Specific features for iPhone/iPad

The images, photos and videos retrieved by this function are copied into the "temp" directory of the application. Don't forget to delete these copies if necessary.

Specific features for Android

Selecting an image: the selected image is copied to the current directory of the application, returned by fCurrentDir. The returned path corresponds to the path of this copy. Don't forget to delete this copy if necessary.
Selecting a video: the video is not copied into the directory of the application. The returned path corresponds to the initial location of the video.

Application in the background: Specific case from Android 10

From Android 10, it is no longer possible to open a window when the application is in the background.

AlbumPicker can open a window. If this function is used while the application is in the background, a fatal error will occur.

Tips:

It is possible to determine if the application is in the background using InBackgroundMode.
If an application needs to interact with the user while it is in the background, the solution is to display a notification (via the Notification type). The application will be brought back to the foreground when the notification is clicked, if the ActivateApplication property is set to True. You can also open a window from the procedure passed to the ActionClick property.

For more details, see Android 10: Behavior of applications in the background.

Required application feature

When this function is used, an application feature is declared in the application generation wizard.

Required features:

Video library.
Image library.

Component: wd270android.aar