DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques Mobile / Fonctions Album
  • Fonctionnement
  • Spécificités iPhone/iPad
  • Spécificités Android
  • Application en arrière-plan : Spécificité à partir de Android 10
  • Fonctionnalité d'application requise
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Récupère une photo, une image ou une vidéo stockée dans l'album de photos de l'appareil mobile.
Exemple
// Sélection de l'image
// syntaxe conseillée sous iOS et Android
// Attention : Sous Android 10 et supérieure, l'application ne doit pas être en arrière-plan. 
bRes est un booléen
bRes = AlbumSélecteur(AlbumSélecteur_Callback)

PROCÉDURE INTERNE AlbumSélecteur_Callback(sCheminImage = "")
	IMG_MonImage = sCheminImage
FIN
Universal Windows 10 AppAndroidWidget AndroidiPhone/iPad
// Sélection de l'image
// iOS et Android : Utilisez plutôt la syntaxe avec procédure
CheminImage est une chaîne 
CheminImage = AlbumSélecteur()
SI CheminImage = "" ALORS
Erreur(ErreurInfo())
RETOUR
FIN
IMG_MonImage = CheminImage
Syntaxe
Widget IOS Non disponible en mode Widget iOS

Sélectionner un élément dans l'album : chemin renvoyé directement Masquer les détails

<Résultat> = AlbumSélecteur([<Type à récupérer>])
<Résultat> : Chaîne de caractères
  • Chemin complet du fichier dans lequel la photo ou l'image a été enregistrée,
  • Chaîne vide ("") en cas d'erreur. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Type à récupérer> : Constante optionnelle de type Entier
Type de l'élément à récupérer dans l'album :
albumImage
(Valeur par défaut)
Sélection d'une image dans l'album.
albumVidéoSélection d'une vidéo dans l'album.

Remarque : ces constantes ne peuvent pas être combinées. Un seul type peut être sélectionné lors de l'appel de la fonction.

Sélectionner un élément dans l'album : chemin récupéré dans une procédure (Syntaxe conseillée) Masquer les détails

<Résultat> = AlbumSélecteur([<Type à récupérer>, ] <Procédure WLangage>)
<Résultat> : Booléen
  • Vrai si l'image ou la vidéo a été sélectionnée,
  • Faux dans le cas contraire.
<Type à récupérer> : Constante de type Entier
Type de l'élément à récupérer dans l'album :
albumImage
(Valeur par défaut)
Sélection d'une image dans l'album.
albumVidéoSélection d'une vidéo dans l'album.

Remarque : ces constantes ne peuvent pas être combinées. Un seul type peut être sélectionné lors de l'appel de la fonction.
<Procédure WLangage> : Nom de procédure
Nom de la procédure WLangage exécutée lors de la sélection dans l'album. Pour plus de détails sur cette procédure, consultez Paramètres de la procédure utilisée par la fonction AlbumSélecteur.
Remarques

Fonctionnement

Lors de l'appel de la fonction AlbumSélecteur, l'utilisateur sélectionne l'image voulue parmi les images affichées dans une fenêtre spécifique.
Une fois le choix validé, l'image sélectionnée est sauvegardée :
  • la fonction AlbumSélecteur renvoie le chemin de sauvegarde de la photo afin qu'elle puisse être manipulée (syntaxe 1).
  • la procédure WLangage spécifiée permet de connaître le chemin de sauvegarde de la photo afin qu'elle puisse être manipulée (syntaxe 2).
iPhone/iPadWidget IOS

Spécificités iPhone/iPad

Les images, photos et vidéos récupérées par cette fonction sont copiées dans le répertoire "temp" de l'application. Pensez à supprimer ces copies si nécessaire.
AndroidWidget Android

Spécificités Android

  • Sélection d'une image : l'image sélectionnée est copiée dans le répertoire courant de l'application, connu avec la fonction fRepEnCours. Le chemin retourné correspond au chemin de cette copie. Pensez à supprimer cette copie si nécessaire.
  • Sélection d'une vidéo : la vidéo n'est pas copiée dans le répertoire de l'application. Le chemin retourné correspond à l'emplacement d'origine de la vidéo.
AndroidWidget Android

Application en arrière-plan : Spécificité à partir de Android 10

A partir de Android 10, il n'est plus possible d'ouvrir une fenêtre lorsque l'application est en arrière-plan.
La fonction AlbumSélecteur peut provoquer l'ouverture d'une fenêtre. Si cette fonction est utilisée alors que l'application est en arrière-plan, une erreur fatale sera générée.
Conseils :
  • Il est possible de savoir si l'application est en arrière-plan grâce à la fonction EnModeArrièrePlan.
  • Si une application a besoin d'interagir avec l'utilisateur alors qu'elle se trouve en arrière-plan, la solution consiste à afficher une notification (via le type Notification). Lors du clic sur la notification, l'application sera remise au premier plan si la propriété ActiveApplication est à Vrai. Il est également possible d'ouvrir une fenêtre depuis la procédure passée à la propriété ActionClic.
Universal Windows 10 App

Fonctionnalité d'application requise

L'utilisation de cette fonction entraîne la déclaration d'une fonctionnalité d'application dans l'assistant de génération de l'application.
Fonctionnalités requises :
  • Vidéothèque.
  • Bibliothèque d'images.
Composante : wd300android.aar
Version minimum requise
  • Version 17
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale