version 6.5
FTP_Progress (gauche; haut; titreFenêtre; texteThermo; annuler) Entier
Paramètre | Type | Description | |
gauche | Entier | Coordonnée gauche de la fenêtre | |
haut | Entier | Coordonnée supérieure de la fenêtre | |
titreFenêtre | Alpha | Titre de la fenêtre du thermomètre | |
texteThermo | Alpha | Texte au-dessus du thermomètre | |
annuler | Alpha | Libellé du bouton Annuler | |
Résultat | Entier | Code d'erreur |
Description
La commande FTP_Progress définit les coordonnées de la fenêtre et le texte de la zone de dialogue de l'indicateur de progression FTP (thermomètre). Cet indicateur de progression s'affiche lors des appels à FTP_Send, FTP_Append ou à FTP_Receive. La commande FTP_Progress n'affiche pas la fenêtre de progression elle-même, elle définit seulement ses caractéristiques d'affichage. Les commandes FTP_Send, FTP_Append et FTP_Receive permettent d'afficher ou de masquer cette fenêtre.
La fenêtre de progression se ferme automatiquement à la fin du transfert de fichier. Si pour une raison quelconque la taille du fichier en cours d'envoi ou de réception ne peut être déterminée, le thermomètre est affiché strié et la taille du fichier indique "unknown" (inconnue).
Le paramètre gauche indique la position du côté gauche de la fenêtre du thermomètre. Si vous passez -1 dans ce paramètre, la fenêtre est centrée horizontalement à l'écran.
Le paramètre haut indique la position du côté supérieur de la fenêtre du thermomètre de progression. Si vous passez -1 dans ce paramètre, la fenêtre est centrée verticalement à l'écran.
Le paramètre titreFenêtre vous permet de définir le titre de la fenêtre. Dans l'exemple suivant, le titre de la fenêtre est "Réception de fichier FTP". Si titreFenêtre est une chaîne vide, la fenêtre est créée sans titre.
Le paramètre texteThermo contient le texte à afficher au-dessus du thermomètre de progression. Dans l'exemple ci-après, texteThermo a pour valeur "Fichier : /pub/Documents/WhitePaper.pdf". Si vous passez "*" dans ce paramètre, le texte d'état du transfert, envoyé par le serveur, est affiché (valeur par défaut). Ce texte varie en fonction des différentes étapes du processus de transfert.
Le paramètre annuler permet de définir le libellé du bouton Annuler. Si vous passez une chaîne vide, le bouton Annuler est masqué. Si vous passez "*", le texte est celui par défaut, c'est-à-dire "Cancel".
Exemple
$erreur:=FTP_Progress (-1;-1;"Réception de fichier FTP";"*";"*") Au cas ou : (FTP_Login ("ftp.4d.com";"anonymous";"martin@societe.fr";vFTP_ID;vFTP_TxtAccueil)#0) : (FTP_Receive(vFTP_ID;"/pub/Documents/WhitePaper.pdf";"MonDisque:Docs:4D";1)#0) : (FTP_Logout (vFTP_ID)#0) Sinon $OK:=Vrai `Toutes les commandes ont été exécutées sans erreur Fin de cas
Note : Pour plus d'informations sur cet emploi particulier de la structure Au cas ou, reportez-vous à l'Annexe A, Conseils de programmation.