Description ----------- This component is an easy FTP client. This means that it supports the FTP Internet Protocol ( File Transfer Protocol ), and lets you FTP any site. It uses non-blocking sockets, so your application won't be blocked during the operation. It is very easy to use: just connect to a server and use the system functions that you need. That's all. (c) Xavier Cirac. All rights reserved mail: Register -------- Why should I register this component? First of all, this component is shareware, so if after you have tried it, you like it or you are going to use it, you have to register it. Otherwise you will be violating the copyright laws. Once you have registered it, you will be (legally) able to use it (even in commercial programs). Besides, you should think that this component has been developed by a Delphi programmer like you, and nobody likes to work without any result (in this case, your little fee), so if you register it you will make me a happier person (and you will be as well, because you will do the correct thing). The fee for this component is only 35 US $. There are two ways to register TFTPClient VCL component: 1.- Via online registration : You can register this component from Qwerks Shareware Registration Services. Transactions are via Credit Card with the option of making the purchase over a secure server, via an U.S. tool free phone or fax. To do it this way please visit TFTPClient web page : http://www.waveflow.com/vcl.htm 2.-Filling the Registration Form and sending me the money (35 $US) to the next postal address: Xavier Cirac Vidal Batlles , 4 Premia de Mar , 08330 Barcelona SPAIN Once I get your registration mail I will e-mail you with the source code and a sample demo (also with source code). Registration Form ----------------- Please Print the next form and fill in the information (if applicable) when you send me the registration letter: Company: _________________________________________ Name: _________________________________________ E-Mail: _________________________________________ Address: _________________________________________ City: _________________________________________ State/Province: ______________________________________ Country: _________________________________________ Optional Where did you find TFTPClient? _____________________________________________________ What are you using TFTPClient for? _____________________________________________________ Properties ---------- Information: This is the last information line (for exemple: server responses) WorkingDirectory: Current server working directory LastList: The contents of the last call to the LIST function (like MSDOS dir or UNIX ls). Waiting: Indicates if the client is waiting for the server response. SoundFile: File to use as sound for an error/connection notification. User: Login of the user. Password: Password of the user Host: Address of the host (FTP server) to connect. Port: FTP Port (standard:21) DataType: Type of the data to be transferred (ASCII, Binary or Auto) Name: Name of the component Methods ------- Create: Creates the component (Constructor) MKD: Make Directory (creates a directory in the server). PWD: Print Working Directory RMD: Remove Directory (deletes a server directory). CWD: Change working directory (like MSDOS/Unix cd) CDUP: Change the working directory to the parent of the current one. FTPConnect: Connects to the host specified in the Host property with the user and password specified in the User and Password properties. Open: Like FTPConnect but using parameters. LIST: Lists the contents of the current directory. It is like the MSDOS 'dir' or the Unix 'ls'. DeleteFile: Deletes a server file Quit: Closes the current session RenameFile: Changes the name of a server file Abort: Aborts the current transaction Cancel: Cancels the current operation even if the client is waiting for a server response. Put: Uploads a file to the server Get: Downloads a file from the server System: Retrieves server system properties NOOP: No Operation CustomCommand: Lets you define extra FTP functions. A simple Example: procedure TForm1. ButtonFTPConnectClick(Sender: TObject); begin tftpclient1.host:='127.0.0.1'; tftpclient1.user:='UserName'; tftpclient1.password:='UserPass'; tftpclient1.FTPConnect; //That's all !! end; procedure TForm1. ButtonLISTClick(Sender: TObject); begin showmessage(ftpclient1.list('')); end; Events ------ OnError :Happens if an error occurs OnInformation: Happens every time that the client needs to show an information (for example: server responses, errors...) OnConnected: Happens when a session is established successfully OnConnectionClosed : Happens if the connection is closed OnFileGet: Happens when a file download is completed OnFilePut: Happens when a file upload is completted Installation ------------ To Install TFTPClient you have to do the next steps: If you have Delphi 5.0 you only have to install the TFTPClient package doing EXACTLY: -Component Install Packages Add ...and Browse for the TFTPClientpkg5.bpl file Check the option "Build with runtime packages" (Must be enabled) ...and Browse for the TFTPClientpkg5.dcp file Check the option "default" (Must be enabled) OK -Copy the file TFTPClientpkg5.bpl to your Windows\System If you have Delphi 4.0 you only have to install the TFTPClient package doing EXACTLY: -Component Install Packages Add ...and Browse for the TFTPClientpkg4.bpl file Check the option "Build with runtime packages" (Must be enabled) ...and Browse for the TFTPClientpkg4.dcp file Check the option "default" (Must be enabled) OK -Copy the file TFTPClientpkg4.bpl to your Windows\System If you have Delphi 3.0 you only have to install the TFTPClient package doing EXACTLY: -Component Install Packages Add ...and Browse for the TFTPClientpkg3.dpl file Check the option "Build with runtime packages" (Must be enabled) ...and Browse for the TFTPClientpkg3.dcp file Check the option "default" (Must be enabled) OK -Copy the file TFTPClientpkg3.dpl to your Windows\System If you have Delphi 2.0 you will have to do: -Component -Install -Add (and Browse for the TFTPClient.dcu file) Note: Remember that you have to install TFTPClient to a directory accessible by Delphi (check the Delphi menu option Tools/Environment Options/Library/Library Path). If the directory where you have installed TFTPClient is not listed there try to add it or to copy TFTPClient files to any of the listed directories. ...and that's all. If setup succeed you will see a new palette called UsefulTools (if you are looking for more useful tools please visit http://www.waveflow.com/vcl.htm).