4D Internet Commands v16

FTP_Progress

Inicio

 
4D Internet Commands v16
FTP_Progress

FTP_Progress 


 

FTP_Progress ( izq ; superior ; tituloVentana ; textoTermo ; cancelar ) -> resultado 
Parámetro Tipo   Descripción
izq  Entero in Coordenada izquierda de la ventana
superior  Entero in Coordenada superior de la ventana
tituloVentana  Cadena in Título de la ventana del termómetro
textoTermo  Cadena in Texto sobre el termómetro
cancelar  Cadena in Texto del botón Cancelar
resultado  Entero in Código de error

Este comando no es soportado con la versión 64 bits de 4D Internet Commands para OS X. Cuando se llama a partir de esta plataforma, devuelve el error -2201 (función no implementada).

El comando FTP_Progress define coordenadas de la ventana y el texto de la caja de diálogo del indicador de progreso FTP. El indicador de progreso se muestra al llamar a FTP_Send, FTP_Append o FTP_Receive. El comando FTP_Progress no muestra la ventana de progreso en sí, sólo define las características de visualización. Los comandos FTP_Send, FTP_Append y FTP_Receive permiten mostrar u ocultar la ventana de progreso.

La ventana de progreso se cierra automáticamente al terminar una transferencia de archivos. Si por alguna razón el tamaño del archivo que se envía o recibe no se puede determinar, el termómetro se mostrará como un indicador de progreso sin fin y el tamaño del archivo aparecerá como "desconocido".

izquierda indica la posición del lado izquierdo de la ventana del termómetro. Si izquierda vale -1, la ventana se centra horizontalmente en la pantalla.

El parámetro superior indica la posición del lado superior de la ventana del termómetro de progreso. Si pasa -1 en este parámetro, la ventana se centra verticalmente en la pantalla.

El parámetro tituloVentana es el título de la ventana de progreso del termómetro. En el siguiente ejemplo, el título de la ventana es "Recepción de archivo FTP". Si tituloVentana es una cadena vacía, la ventana no tendrá título.

El parámetro textoTermo contiene el texto que se mostrará arriba del termómetro de progreso. Si textoTermo es "*", el texto del estado de transferencia, enviado por el servidor, se muestra (valor por defecto). Este texto varía en función de las diferentes etapas del proceso de transferencia.

cancelar es el texto del botón Cancelar. Si pasa una cadena vacía, el botón Cancelar se oculta. Si pasa "*", el texto será el texto por defecto, es decir "Cancelar".

Ejemplo  

 $error:=FTP_Progress(-1;-1;"Getting '/pub/CGMiniViewer.hqx'";"*";"*")
 Case of
    :(FTP_Login("ftp.4d.com";"anonymous";"dbody@aol.com";vFTP_ID;vFTP_Msg)#0)
    :(FTP_Receive(vFTP_ID;"/pub/CGMiniViewer.hqx";"HardDrive:Docsƒ:4D";1)#0)
    :(FTP_Logout(vFTP_ID)#0)
    Else
       $OK:=True `Todos los comandos se ejecutan sin error
 End case

Nota: para mayor información sobre este uso particular de la estructura Case of, consulte Anexo A: Consejos de programación.

 
PROPIEDADES 

Producto: 4D Internet Commands
Tema: IC File Transfer
Número 88946

 
HISTORIA 

Creado por: 4D Internet Commands 6.5
Modificado: 4D Internet Commands v14 R4

 
ARTICLE USAGE

4D Internet Commands ( 4D Internet Commands v16)