TMULTLANG COMPONENT FOR DELPHI v1.10 (C) 1995 Patrik Wang 3 October 1995 DESCRIPTION Forget the Windows resource files (.RES, .RC ...) this component will make you internationalized without writing any additional code. Just drop it on your form and compile, finished. This component will change the properties of controls on forms in Delphi, at both design and runtime. Targeting multi language support, but it can be used for many other things. This component will alter almost all properties that the object inspector can edit. You can choose if you want your languages to be saved in the form or a file. You can use the same file for all your form configurations within the same application. It works in a multiuser environment and it is aware of other forms. You can share languages between different forms and manipulate those even in the runtime mode. INSTALLATION If you already have installed a previous version you will only need to replace all files with the new ones and then rebuild the component palette library. First time installation: 1. First unpack MULTLANG.ZIP in an own directory (you have probably already done that by reading this) or if you have the diskette, run the setup program and do as directed. 2. Move MULTLANG.HLP to any directory in your search path, preferable the DELPHI\BIN directory where other Delphi helpfiles resides. 3. Then install the MULTLANG.DCU file via the 'Install Component' menu option in Delphi. If any problems occurs, you can get your old library back from the backup file *.BAK that Delphi automatically makes. (for more instructions see page 69 in the Users Guide). 4. Install the MULTLANG.KWF file with the Helpfile installer program (HELPINST.EXE) supplied by Delphi. This enables you to press F1 in the Object Inspector to invoke help on that property. (Not necessary if you just want to have a quick look at the component). Thats it !!!! Look at the Utilities component palette in Delphi. Why not start with the Step-By-Step right away, the quick one takes only 5 min. Check the helpfile for more details. FILES These files is included in the TMultLang package. ADDPROP.DCU Compiled unit of the Add properties dialog. ADDPROP.DFM Add properties dialog. COPYFROM.DCU Compiled unit of the Copy From dialog. COPYFROM.DFM Copy From dialog. LANGEDIT.DCU Compiled unit of the Language Property Editor dialog. LANGEDIT.DFM Language Property Editor dialog. LANGUTIL.DCU Compiled unit for language utilities functions. MULABOUT.DCU Compiled unit for the About dialog. MULABOUT.DFM About dialog. MULTLANG.DCU Compiled unit for the TMultLang component (TMultLang component). MULTLANG.HLP TMultLang helpfile. MULTLANG.KWF TMultlang keyword index for Delphi Help system. ORDER.EXE Entry Form for order to print or to send as E-Mail. README.TXT Instructions/registrations text file (This file). REGFORM.DCU Compiled unit of the key registration form. REGFORM.DFM Key registration form. TMULTLANG DEPENDENCIES The units below must be available in the library search path when rebuilding the library. All used units are standard and is included in the Delphi package. I have tried to keep the dependent units to a minimum so that the overall size of your EXE will not be too big. You will probably need almost all units in your own project so it does not matter that it is used by this component. SysUtils, WinTypes, WinProcs, Messages, Classes, Graphics, Controls, Forms, Dialogs, StdCtrls, Menus, FileCtrl, DsgnIntf, TypInfo, OutLine, Tabs, ShellAPI, LibConst, LibHelp, ClipBrd, ExtCtrls, Buttons, Grids, TabNotBk, Mask; The units not included in the Delphi package is: AddProp, CopyFrom, LangEdit, LangUtil, MulAbout, RegForm; You dont need to include any of these in the USES clause, the component is already compiled. If you start with an empty project this component will add about 180K because of the dependencies, however the larger your project grows the less the component adds. If you have an EXE file for about 400K, by adding this component it may only grow to 415K because of the reuse of classes in Object pascal. UN-INSTALL 1. First remove the component from the component palette in Delphi via the 'Install Component' menu options. 2. Regenerate the keyword index for helpfiles in the Helpfile installer program (HELPINST.EXE) without the MULTLANG.KWF file. 3. Just delete all files in the TMultLang package in the directory you choosed when it was installed. Dont forget to delete the helpfile (MULTLANG.HLP) also, which is in the DELPHI\BIN directory if you installed it according to the installation instructions. FEATURES * Specialized for multi languages support in Delphi. * Dubbel byte language support * Edit almost all Component and Control properties * TStrings items or TFont objects editable. * Multi-user shared resource file(s). * Display the languages on other controls * Save resources in forms (design time) or files. * Aware of other forms within the same application. * Properties browsable, just point and click. * Share languages/properties/values between several forms. * One run- and design-time editable resource file for one or more forms. * An extensive help integrated with Delphi. * Safe synconisation when changing names, removing or inserting components. * Associate icons (stretchable) to each configuration. * An easy property editor which is integrated in the Delphi environment. * Filter to restrict special configurations (usable in multi user environm.) SHAREWARE This version of TMultLang is released as shareware and means in this case that you are allowed a trial period for testing. The testing period expires when you start using it in projects to develop programs or after 20 days from the installation time. After that period you have to remove it and must not use it anymore, or you can register it for continuing use. You are not allowed to make a new trial period by reinstalling the component again, unless it is a later version. I do not take any responsibility of misuse or any corrupt files caused by this component and especially not your form files (*.DFM). It is your responsibility to always keep a backup copy of necessary files. For more info see page 139 'Creating a backup of an entire project' in the Delphi User's Guide. You are not allowed to modify any files associated with this component. In the Shareware version, you are allowed to distribute this component with all its files anytime. There is no limited functions in the Shareware version. NOTE This component is protected by a date checking mechanism and checksum codes for messages. After the trial period you can loose all languages if you save anything after the warning messages, and I recommend you to register before this expiry date. You can check how many days left in the 'About' dialog. The checking mechanism is done in both design and run time. This version is released based on trust, so I expect you to follow the rules. By using this component you accept the terms stated in this text file and the text shown in the 'About' dialog. DISCLAIMER Users of TMultLang component must accept this disclaimer of warranty: "The TMultLang component is supplied as is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or conse- quential, which may result from the use of the TMultLang component." Any reproduction of material in this package is copyrighted by law. The author reserves the right to change any text in this file, the helpfile and in the about dialog at anytime. REGISTER All registered users will the first 3 month get free support. Support will be given on the address below. After the first 3 month the registered users will still get free support but in a reasonable amount. However, support will also be given to unregistered users with the trial period of the Shareware version. If you have access to Internet, please take a look at URL site 'http://mailhost.net/~delphi' for late braking news and updates. Do you use MAPI, MSN or Netscape I suggest you to take a look in the about dialog, that can be accessed from the Object Inspector. You will be able to upgrade to later versions and get free patches when available. You will also get rid of all the annoying messages and the date checking mechanism for form and file writing. Support will be given via E-Mail or Fax on the address given below. The registration methods below entitles you to develop and distribute royalty free programs which contains this component but NOT THE HELPFILE. If it is used by more than one person at a time, you must register sufficient licenses. Each registration allows one person to use the component at a time. Site registrations with more than 3 users are available with discounts. Please send me an E-mail requesting Aplication forms for site licensing. To register, select one method: * Send a check that can be drawn from an Australian bank, to the author with the name and amount shown below minus 15%. * Register via Compuserve, go to the SWREG forum and select Register Shareware. Search for TMultLang component and select the version you would like to order. * By downloading the latest registered version from MSN (Microsoft Network). The name of the Forum is not yet set, send me an E-Mail for more instructions. By registering with this method you will get the registered version right away and you dont need to wait for the registration key. * Send the author credit card details according to the ORDER.EXE form by mail or E-Mail. Credit card payments will be approved and drawn by P&F Associates in Australia. If you order the source code it will be sent by mail or E-Mail and includes the postage and handling charges in the amount shown below. You will NOT be entitled to distribute the source code at anytime and can only be used as an information source to understand the structure or to correct/adjust code for specific purposes in your application. When registration is approved you will receive a key to register the TMultLang component in the Order tab in the About dialog from the Object Inspector. This key is a one time key and you have to register the component ASAP upon receipt. All registrations will be approved when payment is done, the key will then be sent as soon as possible, please allow up to 48 working hours for key delivery on an e-mail address. The table below shows current prices valid to 1996-01-01: NAME PRICE DESCRIPTION Regular 175 US$ TMultLang Component Source 500 US$ TMultLang Component and full source code. I reserve the rights for price changes. The price may vary on different services because of surcharge from the service provider. HISTORY 1.00 Initial release. 1.01 Updated instructions, was never really released to the public. 1.10 Added new features and corrected two bugs. * A new property AdoptOn * The help system is totaly revised * Two step by step tutorials * Added Key words for Delphi * Grid style of values in the Property Editor * Copy property values from other forms. * File system totally revised (Also fixed the bug with NTFS partitions) * Less resource intence by reuse of string values * Look up table for soundex search of other forms values * Fixed a bug when editing Font names in the Property Editor * New Installation and un-install instructions in Help file * Many new topics added to help file * Expand All buttons added * Added a new property (FLookupText) for remembering the last state * Added a new property (FLastValue) for remembering the last sel. language * Removed the MASTAPP example which did not really show how it works * Removed the Simple and Advanced feature in the Property editor * Changed the display from date to Nr of days left in About (Shareware) * New registration rules and guidelines * It is now possible to have many TMultLang components on the same form CANDY If you are in need of a date and currency component that translates Windows international settings on the fly(without changing in the control panel), which is integrated with TMultLang, please contact me. If you find any bug, contact me and I will try to resolve it ASAP. If you have any suggestions or if you think I've missed something, I will happily implement that as an additional feature in future versions. The component has been successfully tested with all the larger project demos included in the Delphi package. It has been tested on three different computers, one running Windows 95 build 490 with Delphi 16Bit, and two other computers running Delphi under Windows 3.1. Theese testings were made on Swedish and an English version of Windows. It has also been successfully tested in a medium scale project with 16 forms that all contained this component. There was one external file which contained four different languages, that was shared between those forms with an Novell Netware 3.12 Server. I hope you will find my component useful and easy to use. I am releasing it based on trust (Shareware) and even though you dont find it useful I would like to have your comments, bad or good. It is difficult developing components without any suggestions, directions and the most important, knowing what people really need. Author: Patrik Wang 1/8 Tusculum St. Potts Point, N.S.W. 2011, Sydney Australia E-Mail: 100754.231@COMPUSERVE.COM or PWang@MSN.COM Fax: +61 2 3269032