PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Operating mode
  • Specific features for iPhone/iPad
  • Specific features for Android
  • Required application feature
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Retrieves a photo, an image or a video stored in the photo album of the mobile device.
Versions 18 and later
Android Widget This function is now available in Android Widget mode.
Android This function is now available for the Android applications.
New in version 18
Android Widget This function is now available in Android Widget mode.
Android This function is now available for the Android applications.
Android Widget This function is now available in Android Widget mode.
Android This function is now available for the Android applications.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Example
AndroidAndroid Widget iPhone/iPad
AndroidAndroid Widget This syntax is available from version 20.
// Select the image
bRes is boolean
bRes = AlbumPicker(ProcMySelection)
PROCEDURE ProcMySelection(sImagePath = "")
IMG_MyImage = sImagePath
AndroidAndroid Widget
// Select the image
ImagePath is string
ImagePath = AlbumPicker()
IF ImagePath = "" THEN
Error(ErrorInfo())
RETURN
END
IMG_MyImage = ImagePath
// Select the image
bRes is boolean
bRes = AlbumPicker(ProcMySelection)
PROCEDURE ProcMySelection(sImagePath = "")
IMG_MyImage = sImagePath
// Select the image
ImagePath is string
ImagePath = AlbumPicker()
IF ImagePath = "" THEN
Error(ErrorInfo())
RETURN
END
IMG_MyImage = ImagePath
Syntax
AndroidAndroid Widget Universal Windows 10 App

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 find out the error details, use ErrorInfo.
<Type to Retrieve>: Optional Integer constant
Versions 18 and later
Type of element that will be retrieved in the album:
Versions 18 and later
albumImage
(Default value)
New in version 18
albumImage
(Default value)
albumImage
(Default value)
Selecting an image in the album.
Versions 18 and later
albumVideo
New in version 18
albumVideo
albumVideo
A video is selected in the album.
Note: these constants cannot be combined. A single type can be selected during the call to the function.
New in version 18
Type of element that will be retrieved in the album:
Versions 18 and later
albumImage
(Default value)
New in version 18
albumImage
(Default value)
albumImage
(Default value)
Selecting an image in the album.
Versions 18 and later
albumVideo
New in version 18
albumVideo
albumVideo
A video is selected in the album.
Note: these constants cannot be combined. A single type can be selected during the call to the function.
Type of element that will be retrieved in the album:
Versions 18 and later
albumImage
(Default value)
New in version 18
albumImage
(Default value)
albumImage
(Default value)
Selecting an image in the album.
Versions 18 and later
albumVideo
New in version 18
albumVideo
albumVideo
A video is selected in the album.
Note: these constants cannot be combined. A single type can be selected during the call to the function.
Versions 20 and later
AndroidAndroid Widget Universal Windows 10 App

Selecting an element in the album: path retrieved in a procedure Hide the details

<Result> = AlbumPicker([<Type to Retrieve>,] <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)
Selecting an image in the album.
albumVideoA video is selected in the album.
Note: these constants cannot be combined. A single type can be selected during the call to the function.
<Procedure>: Character string (with or without quotes)
Name of WLanguage procedure run during the selection in the album. This procedure has the following format:
PROCEDURE <Procedure Name>(<Path>)
This procedure is used to retrieve the backup path of the selected image or video.
New in version 20
AndroidAndroid Widget Universal Windows 10 App

Selecting an element in the album: path retrieved in a procedure Hide the details

<Result> = AlbumPicker([<Type to Retrieve>,] <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)
Selecting an image in the album.
albumVideoA video is selected in the album.
Note: these constants cannot be combined. A single type can be selected during the call to the function.
<Procedure>: Character string (with or without quotes)
Name of WLanguage procedure run during the selection in the album. This procedure has the following format:
PROCEDURE <Procedure Name>(<Path>)
This procedure is used to retrieve the backup path of the selected image or video.
AndroidAndroid Widget Universal Windows 10 App

Selecting an element in the album: path retrieved in a procedure Hide the details

<Result> = AlbumPicker([<Type to Retrieve>,] <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)
Selecting an image in the album.
albumVideoA video is selected in the album.
Note: these constants cannot be combined. A single type can be selected during the call to the function.
<Procedure>: Character string (with or without quotes)
Name of WLanguage procedure run during the selection in the album. This procedure has the following format:
PROCEDURE <Procedure Name>(<Path>)
This procedure is used to retrieve the backup path of the selected image or video.
Versions 18 and later
iPhone/iPadUniversal Windows 10 App

Selecting an element in the album Hide the details

<Result> = AlbumPicker(<WLanguage Procedure>)
<Result>: Boolean
  • True if the image was selected.
  • False otherwise.
<WLanguage Procedure>: Character string (with or without character string)
Name of WLanguage procedure run during the selection in the album. This procedure has the following format:
PROCEDURE <Procedure Name>(<Path>)
This procedure is used to retrieve the backup path of the selected image or video.
New in version 18
iPhone/iPadUniversal Windows 10 App

Selecting an element in the album Hide the details

<Result> = AlbumPicker(<WLanguage Procedure>)
<Result>: Boolean
  • True if the image was selected.
  • False otherwise.
<WLanguage Procedure>: Character string (with or without character string)
Name of WLanguage procedure run during the selection in the album. This procedure has the following format:
PROCEDURE <Procedure Name>(<Path>)
This procedure is used to retrieve the backup path of the selected image or video.
iPhone/iPadUniversal Windows 10 App

Selecting an element in the album Hide the details

<Result> = AlbumPicker(<WLanguage Procedure>)
<Result>: Boolean
  • True if the image was selected.
  • False otherwise.
<WLanguage Procedure>: Character string (with or without character string)
Name of WLanguage procedure run during the selection in the album. This procedure has the following format:
PROCEDURE <Procedure Name>(<Path>)
This procedure is used to retrieve the backup path of the selected image or video.

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 find out the error details, use ErrorInfo.
<Type to Retrieve>: Optional Integer constant
Type of element that will be retrieved in the album:
albumImage
(Default value)
Selecting an image in the album.
albumVideoA video is selected in the album.
Note: 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 Hide the details

<Result> = AlbumPicker([<Type to Retrieve>,] <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)
Selecting an image in the album.
albumVideoA video is selected in the album.
Note: these constants cannot be combined. A single type can be selected during the call to the function.
<Procedure>: Character string (with or without quotes)
Name of WLanguage procedure run during the selection in the album. This procedure has the following format:
PROCEDURE <Procedure Name>(<Path>)
This procedure is used to retrieve the backup path of the selected image or video.
Remarks

Operating mode

During the call to AlbumPicker, the user selects the requested image among the images displayed in a specific window.
Once the choice is validated, the selected image is saved:
  • AndroidAndroid Widget Universal Windows 10 App AlbumPicker returns the backup path of the photo so that it can be handled (syntax 1).
  • iPhone/iPad the specified WLanguage procedure is used to find out the backup path of the photo so that it can be handled. AndroidAndroid Widget iPhone/iPadUniversal Windows 10 App the specified WLanguage procedure is used to find out the backup path of the photo so that it can be handled (syntax 2 and 3).
Once the choice is validated, the selected image is saved:
  • AlbumPicker returns the backup path of the photo so that it can be handled (syntax 1).
  • the specified WLanguage procedure is used to find out the backup path of the photo so that it can be handled (syntax 2).
Caution: This function is not available in the simulator. Note: This function is available in the simulator.
iPhone/iPad

Specific features for iPhone/iPad

  • The images and photos retrieved by this function are copied into the "temp" directory of the application. Don't forget to delete these copies if necessary.
  • The videos cannot be selected by AlbumPicker.
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.
AndroidAndroid Widget

Specific features for Android

  • Selecting an image: the selected image is copied into the current directory of 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.
Versions 21 and later
Universal Windows 10 App

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
Universal Windows 10 App

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
Universal Windows 10 App

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
Minimum required version
  • Version 17
Comments
Click [Add] to post a comment