home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / TVTOOL.ZIP / READ.ME < prev    next >
Encoding:
Text File  |  1992-10-08  |  9.5 KB  |  190 lines
  1. TV TOOL BOX - Version 1.05                                      09/05/92
  2. ------------------------------------------------------------------------------
  3. OVERVIEW -
  4.  
  5. The TV Tool Box was created to fill a few holes in Turbo Vision for Turbo
  6. Pascal. TV Tool Box includes formatted data entry with input masks, scrolling
  7. data entry dialogs, improved "Windows" like file dialog, versatile control
  8. for data entry including required fields, field locking and post-edit
  9. control, check mark menus, enhancements to TApplication, some handy string
  10. routines, an interactive menu designer and more.
  11.  
  12. TV Tool Box is distributed as Shareware, it is not free. If you use TV Tool
  13. Box you must register it. With your paid registration you will receive the
  14. next version with full source code (all units and the menu designer) and
  15. printed documentation. Registration is $40.00 (North America) and $50.00
  16. (Outside North America). Please make all funds payable in U.S. dollars. Site
  17. licenses and multiple copy discounts are available. Remember a registered
  18. copy is required for each programmer using TV Tool Box.
  19.  
  20. Please contact me with any comments, suggestions, problems, bugs, or
  21. questions.
  22.  
  23. Richard Hansen
  24. PO Box 18571
  25. Saint Paul, MN  55118-0571  USA
  26.  
  27. CompuServe ID 70242,3367
  28.  
  29.  
  30. TV Tool Box is a work in progress, it is by no means complete. I have
  31. uploaded this first version so that other programmers can benefit from it
  32. right now. I hope to include many more routines and objects in future
  33. versions. Some ideas I have are more data entry types such as date, iconized
  34. windows, virtual list boxes, list boxes in windows, and multiple pick list
  35. boxes. What happens in any future version is partly up to you. If you have
  36. any ideas for new TV extensions please let me know and I will try to include
  37. them. FUTURE VERSIONS WILL BE AVAILABLE TO REGISTERED USERS FOR A NOMINAL
  38. FEE OF JUST A FEW DOLLARS.
  39.  
  40.  
  41. ------------------------------------------------------------------------------
  42. THE DEMO -
  43.  
  44. The file DEMO.PAS is the main demo for TV Tool Box.  This demo shows most of
  45. the features of TV Tool Box. Choose the [Test] option off the main menu bar
  46. to test them for yourself. Select [Data Entry] to test some new data entry
  47. features. TV Tool Box supports formatted data entry and data validation
  48. using programmer supplied entry mask strings. You can include literals, such
  49. as '(' or '-' in your masks, that cannot be typed over by your users. The
  50. data entry features also include, field locking, required fields, hidden
  51. password fields, justification, trimming, alternate padding chars, and post
  52. edit routines for data validation or special processing.
  53.  
  54. Check out the Tool Bar and the 3D buttons. These are the first versions and
  55. are not guaranteed to work in all situations (so use at your own risk). But,
  56. they are great if you want a sharper look. The next release of TV Tool Box
  57. will include 3D dialog boxes, and input fields, and maybe other 3D controls.
  58.  
  59. Select [Check Marks] and try out the check mark enhancement for menus. If you
  60. have need of a ASCII/HEX editor, like those used in disk utilities, you've got
  61. one. Select [Ascii/Hex Editor] to check it out.
  62.  
  63. If you've ever wanted a simple way to display some text without creating a
  64. dialog box or window and a specialized Draw method, try the [Text Window]
  65. option. This will display a TTextWindow object. With TTextWindow you just
  66. create it and use the Write method to display string, almost like write to
  67. the screen without Turbo Vision.
  68.  
  69. If you select [Message Dialog], you can check out a replacement for the
  70. MessageBox procedure. A TMessageDialog will automatically size itself for the
  71. number and length of the lines of text you insert into it.
  72.  
  73. On the [Setup] menu, you can setup a neat idea I stole from my favorite
  74. programer's text editor "Multi-Edit" from American Cybernetics. If you check
  75. the option, the mouse cursor will be turned off whenever the keyboard is
  76. used. The mouse cursor is restored whenever the mouse is moved or a mouse
  77. button is pressed.
  78.  
  79. Included in TV Tool Box is a descendant of TDialog called TRunDialog. A
  80. TRunDialog is for creating progress display dialogs for things like printing,
  81. copying files, etc. TRunDialog has easy an method for implementing pause,
  82. continue, and cancel. There are two ready made descendants of TRunDialog,
  83. TPercentDialog and TPrintDialog. TPercentDialog displays the percentage
  84. completion and a progress bar. TPrintDialog is a skeleton for a printing
  85. dialog. Select [Progress Dialog] or [Print Dialog] to try them out.
  86.  
  87. If you ever wanted a little fancier look in your TV apps, then check out the
  88. 3D controls. The 3D controls include a vertical or horizontal tool bar
  89. (almost like windows!).
  90.  
  91. I have added a couple enhancements to TWindows. TNewWindows can be minimized,
  92. using the "" icon in the upper right corner. If you hit Alt-Minus, or press
  93. the right mouse button on the "close" icon, a window control menu will popup.
  94.  
  95. Be sure to check out the *.INT files for a more complete view of what is
  96. included.
  97.  
  98. ------------------------------------------------------------------------------
  99. USING TV TOOL BOX -
  100.  
  101. TV Tool Box is broken into several units. The unit names generally correspond
  102. with their associated Turbo Vision units. The source code has been included
  103. to avoid compilation problems. Don't bother trying to read it though, it has
  104. been pretty well condensed (perhaps squashed describes it better) and is very
  105. hard to read. THE FULL SOURCE CODE IS INCLUDED WITH THE REGISTERED VERSION.
  106.  
  107. To get all the benefits of TV Tool Box you must have the Turbo Pascal Runtime
  108. Library and thus the Turbo Vision source. If you don't have the RTL, you
  109. should get it as soon as possible. The RTL is the best tool you can buy to
  110. aid your Turbo Vision programming efforts. I avoided changes to the original
  111. TV source as much as possible. However, a couple things just could not be
  112. done without changes. There are three (3) changes needed and they are listed
  113. in the file CHANGES.TXT. Two are in STDDLG.PAS (you have this source) and one
  114. is to VIEWS.PAS (this comes with the RTL).
  115.  
  116. Don't worry if you can't make these changes. They only affect the file dialog
  117. and post edit processing for the new data entry objects. You will have all
  118. the rest of TV Tool Box available to you. If you don't have the RTL, I will
  119. be happy to include the compiled Turbo Vision TPU's with your registered
  120. package. Just make a note on the order form and BE SURE TO INCLUDE THE DATE
  121. OF YOUR VERSION OF TURBO PASCAL (I can't send the right version of the TPU's
  122. without the date).
  123.  
  124. IMPORTANT NOTE : If you recompile Demo.pas, the post-edit and file dialog
  125. will not work the same as the DEMO.EXE that was shipped with TV Tool Box.
  126. They will not work until you make the necessary TV source code changes, and
  127. turn on the compiler directives in TVDEFS.INC.
  128.  
  129. When you compile you should use the X+ and V- compiler directives.
  130.  
  131. Good luck and happy programming.
  132.  
  133. ------------------------------------------------------------------------------
  134. FILES THAT SHOULD BE HERE -
  135.  
  136.         READ.ME         This file, why I include it in this list I don't
  137.                         know. Since you are reading this it must be here.
  138.         ORDER.FRM       The most important file of all.
  139.         DEMO.EXE        The main demo.
  140.         DEMO.PAS        Source code for the TV.EXE demo program.
  141.         SCROLL.EXE      Scrolling dialog, and data entry window demo.
  142.         SCROLL.PAS      Source code for the SCROLL.EXE demo program.
  143.         MENU.EXE        Menu designer.
  144.         MENU.DOC        Documentation for the menu designer.
  145.         MTEST.PAS       Shell program for testing menus created with the menu
  146.                         designer.
  147.         DEMO.MNU        Example menu or the menu designer.
  148.         DEMO1.MNU       Another example menu.
  149.         TVDEFS.INC      Some defs that change the compilation.
  150.         TVKEYS.PAS      Keyboard defs for control+key combinations.
  151.         TVCONST.PAS     Global constants.
  152.         TVTYPE.PAS      Global types.
  153.         TVSTRING.PAS    Handy string routines.
  154.         TVINPUT.PAS     Data entry extensions.
  155.         TVVIEWS.PAS     View extensions.
  156.         TVDIALOG.PAS    Dialog extensions.
  157.         TVCOLL.PAS      Collection extensions.
  158.         TVAPP.PAS       Application extensions.
  159.         TVMENUS.PAS     Menu extensions.
  160.         TVSCROLL.PAS    Scroll dialog boxes.
  161.         TVINPUT.INT     Interface for TVINPUT.PAS
  162.         TVVIEWS.INT     Interface for TVVIEWS.PAS
  163.         TVDIALOG.INT    Interface for TVDIALOG.PAS
  164.         TVCOLL.INT      Interface for TVCOLL.PAS
  165.         TVAPP.INT       Interface for TVAPP.PAS
  166.         TVMENUS.INT     Interface for TVMENUS.PAS
  167.         TVSCROLL.INT    Interface for TVSCROLL.PAS
  168.         TVTYPE.INT      Interface for TVTYPE.PAS
  169.  
  170.         CHANGES.TXT     List of changes necessary to TV source code.
  171.  
  172. ------------------------------------------------------------------------------
  173. HISTORY -
  174.  
  175.         09/05/92        Released version 1.0
  176.         09/15/92        First beta of 3D controls
  177.         10/07/92        Released version 1.05
  178.                         Added 3d controls.
  179.                         Added iconizable windows.
  180.                         Eliminated most RTL source changes.
  181.  
  182. ------------------------------------------------------------------------------
  183. KNOWN PROBLEMS (FEATURES) -
  184.  
  185.         Incremental search in the file dialog does not work for drives.
  186.  
  187.         The last required field or field with a post edit routine must have
  188.         at least one unlocked field after it in the dialog.
  189.  
  190.         Load and Store methods have not yet been implemented.