4D Internet Commands v16

FTP_Progress

Accueil

 
4D Internet Commands v16
FTP_Progress

FTP_Progress 


 

FTP_Progress ( gauche ; haut ; titreFenêtre ; texteThermo ; annuler ) -> Résultat 
Paramètre Type   Description
gauche  Entier in Coordonnée gauche de la fenêtre
haut  Entier in Coordonnée supérieure de la fenêtre
titreFenêtre  Chaîne in Titre de la fenêtre du thermomètre
texteThermo  Chaîne in Texte au-dessus du thermomètre
annuler  Chaîne in Libellé du bouton Annuler
Résultat  Entier in Code d'erreur

Cette commande n'est pas prise en charge avec 4D Internet Commands 64 bits pour OS X. Lorsqu'elle est appelée depuis cette plate-forme, elle retourne l'erreur -2201 (fonction non implémentée).

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. 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";"*";"*")
 Case of
    :(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)
    Else
       $OK:=True `Toutes les commandes ont été exécutées sans erreur
 End case

Note : Pour plus d'informations sur cet emploi particulier de la structure Au cas ou, reportez-vous à l'Annexe A, Conseils de programmation.

 
PROPRIÉTÉS 

Produit : 4D Internet Commands
Thème : IC File Transfer
Numéro : 88946

 
HISTORIQUE 

Créé : 4D Internet Commands 6.5
Modifié : 4D Internet Commands v14 R4

 
UTILISATION DE L'ARTICLE

4D Internet Commands ( 4D Internet Commands v16)