DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques Mobile / Fonctions URI
  • Divers
  • Application en arrière-plan : Spécificité à partir de Android 10
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
Ouvre une fenêtre du système pour sélectionner ou créer une ressource provenant :
  • du système de fichiers de l'appareil,
  • du Cloud (Google Drive, Microsoft OneDrive, etc.)
  • d'un des gestionnaires de contenu installés sur l'appareil.
Exemple
AndroidWidget Android
// Ouvre la fenêtre système pour la sélection d'une image ou d'un pdf
UriRessource est une URI = URISélecteur(uriImage + TAB + "application/pdf")
SI PAS ErreurDétectée ALORS
// Affiche le nom de la ressource sélectionnée
Info(URIRécupèreInfo(UriRessource, uriInfoNom))
FIN
iPhone/iPad
// Ouvre la fenêtre système pour la sélection d'une image ou d'un pdf
URISélecteur(MaProcURISélecteur, uriImage + TAB + "application/pdf")
 
PROCÉDURE INTERNE MaProcURISélecteur(Succès est un booléen, Résultat1 est une URI)
SI Succès = Vrai ALORS
// Affiche le nom de la ressource sélectionnée
ToastAffiche(URIRécupèreInfo(Résultat1, uriInfoNom))
FIN
FIN
WINDEV
URISélecteur(MaProcURISélecteur, uriAudio + TAB + uriImage + TAB + uriVidéo)
 
PROCÉDURE INTERNE MaProcURISélecteur(Succès est un booléen, Résultat1 est une URI)
SI Succès = Vrai ALORS
// Affiche le nom de la ressource sélectionnée
ToastAffiche(Résultat1..Valeur)
FIN
FIN
Syntaxe
WINDEVAndroidWidget Android

Sélectionner ou créer une ressource (code synchrone) Masquer les détails

<Résultat> = URISélecteur([<Types MIME> [, <Mode> [, <Nom du document>]]])
<Résultat> : Variable de type URI
  • Variable de type URI correspondant à la ressource sélectionnée.
  • En cas d'erreur, la variable ErreurDétectée est à Vrai. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Types MIME> : Chaîne de caractères ou constante optionnelle
  • Liste des types MIME des fichiers pouvant être sélectionnés, séparés par TAB.
  • Une des constantes spécifiques suivantes :
    uriAudioAutorise tous les types de fichier audio.
    uriImageAutorise tous les types de fichier image.
    uriVidéoAutorise tous les types de fichier vidéo.

    Remarque : Il est possible de concaténer les constantes en les séparant par TAB.
Si un type MIME spécifié n'est pas connu par le système, il sera ignoré.
Si ce paramètre n'est pas spécifié, tous les fichiers seront sélectionnables.
AndroidWidget Android Sous Android, les fichiers qui ne correspondent pas aux types MIME spécifiés seront visibles mais non sélectionnables par l'utilisateur.
<Mode> : Constante optionnelle de type Entier
Mode de sélection :
uriCréationOuvre le sélecteur en mode "Création" pour créer un nouveau document. Le nom par défaut de ce document peut être spécifié dans le paramètre <Nom du document>.
uriOuverture
(Valeur par défaut)
Ouvre le sélecteur en mode "Ouverture" pour ouvrir un document existant.
<Nom du document> : Chaîne de caractères optionnelle
Nom par défaut du document à créer lorsque le sélecteur est ouvert en mode création. Ce paramètre est pris en compte uniquement si le paramètre <Mode> correspond à la constante uriCréation.
WINDEVAndroidWidget AndroidiPhone/iPadWidget IOSMac Catalyst

Sélectionner ou créer une ressource (code asynchrone) Masquer les détails

URISélecteur(<Procédure WLangage> [, <Types MIME> [, <Mode> [, <Nom du document>]]])
<Procédure WLangage> : Nom de procédure
Nom de la procédure WLangage (également nommée "callback") appelée pour le fichier sélectionné. Cette procédure est appelée lorsque l'utilisateur ferme la fenêtre de sélection d'URI. Pour plus de détails sur cette procédure, consultez Paramètres de la procédure utilisée par la fonction URISélecteur.
<Types MIME> : Chaîne de caractères ou constante optionnelle
  • Liste des types MIME des fichiers pouvant être sélectionnés, séparés par TAB.
  • Constantes spécifiques suivantes :
    uriAudioAutorise tous les types de fichier audio.
    uriImageAutorise tous les types de fichier image.
    uriVidéoAutorise tous les types de fichier vidéo.

    Remarque : Il est possible de concaténer les constantes en les séparant par TAB.
Si un type MIME spécifié n'est pas connu par le système, il sera ignoré.
Si ce paramètre n'est pas spécifié, tous les fichiers seront sélectionnables.
AndroidWidget Android Sous Android, les fichiers qui ne correspondent pas aux types MIME spécifiés seront quand même visibles mais ne seront pas sélectionnables par l'utilisateur.
<Mode> : Constante optionnelle de type Entier
WINDEVAndroidWidget Android Mode de sélection :
uriCréationOuvre le sélecteur en mode "Création" pour créer un nouveau document. Le nom par défaut de ce document peut être spécifié dans le paramètre <Nom du document>.
uriOuverture
(Valeur par défaut)
Ouvre le sélecteur en mode "Ouverture" pour ouvrir un document existant.
<Nom du document> : Chaîne de caractères optionnelle
WINDEVAndroidWidget Android Nom par défaut du document à créer lorsque le sélecteur est ouvert en mode création. Ce paramètre est pris en compte uniquement si le paramètre <Mode> correspond à la constante uriCréation.
Remarques

Divers

  • Pour manipuler l'URI renvoyée par la fonction URISélecteur, utilisez les fonctions de la famille URIxxx.
  • Pour récupérer des informations supplémentaires (nom, taille, type MIME) sur la ressource sélectionnée, utilisez la fonction URIRécupèreInfo.
  • AndroidWidget Android La fonction URISélecteur est disponible uniquement sur les appareils disposant d'une version d'Android supérieure ou égale à la version 4.4 (api level 19).
    Si la fonction est utilisée avec une version antérieure du système, une erreur fatale sera déclenchée.
    Pour connaître la version du système Android sur laquelle s'exécute l'application, utilisez la fonction SysVersionAndroid.
  • WINDEV Cette fonction est disponible notamment pour obtenir un code multiplateforme.
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 URISé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.
Classification Métier / UI : Code UI
Composante : wd300java.dll
Version minimum requise
  • Version 24
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