4D Doc Center : FTP

4D Internet Commands v14

FTP_Progress


FTP_Progress ( izq ; superior ; tituloVentana ; textoTermo ; cancelar ) -> resultado

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

Descripción

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 es el texto que se mostrará arriba del termómetro de progreso. Si textoTermo es "*", el texto será el valor por defecto. En el siguiente ejemplo, textoTermo es "Archivo: /pub/CGMiniViewer.hqx". El texto por defecto para el termómetro es el texto de estado del proceso de transferencia, enviado por el servidor. 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.