version 6.0.5
AP Select document (chemin; tabTypes) Entier long
Paramètre | Type | Description | |
chemin | Texte | Chemin d'accès complet au fichier | |
tabTypes | Tab Texte | Alpha | Liste de types de fichiers | |
Résultat | Entier long | Code d'erreur |
Description
La commande AP Select document affiche la boîte de dialogue standard d'ouverture de fichiers, permettant à l'utilisateur de désigner un fichier. Une fois qu'il a validé son choix, la variable chemin contient le chemin d'accès complet au fichier et la commande retourne 1.
La longueur du chemin stockée dans chemin est limitée à 1024 caractères.
A la différence de la commande Ouvrir document du langage de 4e Dimension, la commande AP Select document n'ouvre pas le document, elle stocke uniquement son chemin d'accès complet.
Il est possible de spécifier un ou plusieurs types de documents (au maximum 16) dans le tableau types. Dans ce cas, seuls les documents des types spécifiés apparaissent dans la boîte de dialogue standard d'ouverture de fichiers.
Si la liste des types est un tableau vide, l'utilisateur peut choisir n'importe quel type de document.
Sous Windows, le type d'un document est désigné par les 3 caractères de son extension.
Sous Mac OS, le type d'un document est désigné par 4 caractères.
Exemples
(1) L'utilisateur peut choisir n'importe quel type de document :
TABLEAU TEXTE($types;0) $ok:=AP Select document($chemin;$types) Si($ok=1) TraiterDoc($chemin) Fin de si
(2) Limitation des types de documents sous Mac OS :
`Choix d'un fichier son système ou d'un fichier AIFF TABLEAU TEXTE($types;2) $types{1}:="sfil" $types{2}:="AIFF" $chemin:="" $ok:=AP Select document($chemin;$types) Si($ok=1) TraiterFichierSon($chemin) Fin de si
(3) Limitation des types de documents sous Windows :
`Choix d'un fichier son .WAV ou .AIF TABLEAU TEXTE($types;2) $types{1}:="WAV" $types{2}:="AIF" $chemin:="" $ok:=AP Select document($chemin;$types) Si($ok=1) TraiterFichierSon($chemin) Fin de si