4D Doc Center : FTP

4D Internet Commands v14

FTP_Progress


FTP_Progress ( gauche ; haut ; titreFenêtre ; texteThermo ; annuler ) -> Résultat

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	Chaîne	Titre de la fenêtre du thermomètre
texteThermo	Chaîne	Texte au-dessus du thermomètre
annuler	Chaîne	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.