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

' 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

OPEN_DIALOG

SAVE_DIALOG

OPEN_DIALOG_PIC

SAVE_DIALOG_PIC

FILE_DIALOG

FILTER

DIR_DIALOG

Content created by Jack. Updated March 07, 2025