FTP_Progress

4D - Documentation   Français   English   German   Commandes Internet de 4D, Sommaire   Commandes Internet de 4D, Index   Retour   Précédent   Suivant

version 6.5


FTP_Progress (gauche; haut; titreFenêtre; texteThermo; annuler) Entier

ParamètreTypeDescription
gaucheEntierCoordonnée gauche de la fenêtre
hautEntierCoordonnée supérieure de la fenêtre
titreFenêtreAlphaTitre de la fenêtre du thermomètre
texteThermoAlphaTexte au-dessus du thermomètre
annulerAlphaLibellé du bouton Annuler
RésultatEntierCode 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 

4D - Documentation   Français   English   German   Commandes Internet de 4D, Sommaire   Commandes Internet de 4D, Index   Retour   Précédent   Suivant