FILE_NAME$(N)
FILE_NAME$(N)
RETOURNE LE NOM DE FICHIER DONNÉ PAR L'OBJET SYSTÈME NUMÉRO N (OPEN_DIALOG OU SAVE_DIALOG)
ACTION
La fonction FILE_NAME$(N) retourne le nom de fichier choisi par l'utilisateur qui manipule un objet du type OPEN_DIALOG, SAVE_DIALOG, OPEN_DIALOG_PIC, SAVE_DIALOG_PIC.
La fonction rend visible l'objet, et le programme est suspendu jusqu'à ce que l'utilisateur choisisse un nom de fichier ou annule l'opération.
N est le numéro d'un objet de type : OPEN_DIALOG, SAVE_DIALOG, OPEN_DIALOG_PIC, SAVE_DIALOG_PIC.
Remarque 1 : si l'utilisateur clique sur le bouton "annuler" de l'objet, la fonction FILE_NAME$ retourne le caractère souligné ("_") comme nom de fichier.
Remarque 2 : le mot-clé FILE_NAME$ se termine par '$' parce que la valeur retournée est du type chaîne de caractères.
SYNTAXE : Resultat$=FILE_NAME$(N)
- N = numéro d'objet système (entier ou réel). Doit être plus grand que 0 et inférieur ou égal au nombre maximum permis d'objets systèmes.
- Resultat$ est une chaîne de caractères (nom de fichier choisi par l'utilisateur ou caractère souligné "_" si aucun fichier n'est choisi)
UTILISATION
- La fonction FILE_NAME$() est utilisée pour ouvrir un fichier avec un OPEN_DIALOG, OPEN_DIALOG_PIC ou sauvegarder un fichier avec un SAVE_DIALOG, SAVE_DIALOG_PIC.
ERREUR
- Si le numéro N n'est pas une expression correcte.
- Si le numéro N excède le nombre maximum permis d'objets systèmes.
- Si le numéro N est inférieur ou égal à 0.
- Si l'objet système numéro N n'existe pas.
- Si l'objet système numéro N n'est pas du type : OPEN_DIALOG, SAVE_DIALOG, OPEN_DIALOG_PIC, SAVE_DIALOG_PIC.
EXEMPLE
' créer un OPEN_DIALOG
open_dialog 1
' créer un LIST
list 2
' le remplir avec le fichier choisi par l'utilisateur (open_dialog)
file_load 2, file_name$(1)EN RAPPORT