4D Internet Commands v16FTP_Progress |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D Internet Commands v16
FTP_Progress
|
FTP_Progress ( esquerda ; superior ; tituloJanela ; textoTermo ; cancelar ) -> Resultado | ||||||||
Parâmetro | Tipo | Descrição | ||||||
esquerda | Inteiro |
![]() |
Coordenada esquerda da janela | |||||
superior | Inteiro |
![]() |
Coordenada superior da janela | |||||
tituloJanela | String |
![]() |
Título da janela do termômetro | |||||
textoTermo | String |
![]() |
Texto sobre o termômetro | |||||
cancelar | String |
![]() |
Texto do botão Cancelar | |||||
Resultado | Inteiro |
![]() |
Código de erro | |||||
Este comando não é suportado com a versão 64 bits de 4D Internet Commands para OS X. Quando é chamado a partir desta plataforma, devolve o erro -2201 (função não implementada).
O comando FTP_Progress define coordenadas da janela e o texto da caixa de diálogo do indicador de progresso FTP. O indicador de progresso é mostrado ao chamar a FTP_Send, FTP_Append ou FTP_Receive. O comando FTP_Progress não mostra a janela de progresso em si, só define as características de visualização. Os comandos FTP_Send, FTP_Append e FTP_Receive permitem mostrar ou ocultar a janela de progresso.
A janela de progresso é fechada automaticamente ao terminar uma transferência de arquivos. Se por alguma razão o tamanho do arquivo que é enviado ou recebido não pode ser determinado, o termômetro será mostrado como um indicador de progresso sem fim e o tamanho do arquivo aparecerá como "desconhecido".
esquerda indica a posição do lado esquerdo da janela do termômetro. Se esquerda vale -1, a janela se centra horizontalmente na tela.
O parâmetro superior indica a posição do lado superior da janela do termômetro de progresso. Se passado -1 neste parâmetro, a janela se centra verticalmente na tela.
O parâmetro tituloJanela é o título da janela de progresso do termômetro. No seguinte exemplo, o título da janela é "Recepção de arquivo FTP". Se tituloJanela é uma cadeia vazia, janela não terá título.
O parâmetro textoTermo contém o texto que será mostrado acima do termômetro de progresso. Se textoTermo é "*", o texto do estado de transferência, enviado pelo servidor, é mostrado (valor padrão). Este texto varia em função das diferentes etapas do processo de transferência.
cancelar é o texto do botão Cancelar. Se passar uma cadeia vazia, o botão Cancelar se oculta. Se passar "*", o texto será o texto por padrão, ou seja "Cancelar".
$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 os comandos se executam sem erro
End case
Nota: Para maior informação sobre este uso particular da estrutura Case of, consulte Apêndice A, Dicas de programação.
Produto: 4D Internet Commands
Tema: IC File Transfer
Número
88946
Criado por: 4D Internet Commands 6.5
Modificado: 4D Internet Commands v14 R4
4D Internet Commands ( 4D Internet Commands v16)