FILE_NAME$()

FILE_NAME$(N)

RETOURNE LE NOM DE FICHIER DONNÉ PAR L'OBJET SYSTÈME NUMÉRO N (OPEN_DIALOG OU SAVE_DIALOG)

  • Type: Fonction
  • Paramètre: 1
  • Groupe: Objets Système

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

rem créer un OPEN_DIALOG

open_dialog 1

rem créer un LIST

list 2

rem le remplir avec le fichier choisi par l'utilisateur (open_dialog)

file_load 2, file_name$(1)

EN RAPPORT

OPEN_DIALOG

SAVE_DIALOG

OPEN_DIALOG_PIC

SAVE_DIALOG_PIC

FILE_DIALOG

FILTER

DIR_DIALOG