URISélecteur (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques Mobile / Fonctions URI

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

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

URISélecteur (Fonction)

En anglais : URISelect

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

// 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

// 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

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

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 :
uriAudio Autorise tous les types de fichier audio.
uriImage Autorise tous les types de fichier image.
uriVidéo Autorise 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.
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éation Ouvre 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.

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 :
uriAudio Autorise tous les types de fichier audio.
uriImage Autorise tous les types de fichier image.
uriVidéo Autorise 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.
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

Mode de sélection :
uriCréation Ouvre 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.

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.
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.
Cette fonction est disponible notamment pour obtenir un code multiplateforme.

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.

Pour plus de détails, consultez Android 10 : Comportement des applications en arrière-plan.

Classification Métier / UI : Code UI

Composante : wd300java.dll

Voir Aussi

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