home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / dev / basic / vs_includes.lha / VS-Includes / TextEntry / TextEntry.DOC < prev    next >
Encoding:
Text File  |  1994-06-28  |  2.0 KB  |  62 lines
  1.  
  2.                                TextEntry Library
  3.                                =================
  4.  
  5.                                      V1.00
  6.  
  7.                               Last Updated 27/6/94
  8.  
  9.    This library is freewaree - copy it modify it whatever - but if you do use
  10. it I would like some form of credit given in the program/documentation.
  11.  
  12. FUNCTIONS
  13. =========
  14.  
  15.    TextEntrySetup{GadgetList,FileName$,Shape}
  16.  
  17.    The TextEntry routine uses two little shapegadgets for the up and down
  18. arrows, and this little function sets up the loading of the Gfx for those.
  19. The Gfx are contained in the file TextEntry.Gfx.  This function can be used
  20. to load those Gfx by specifying the filename (including path) and the shape
  21. number to load the up gadget into - the down gadget will be in Shape+1.
  22. GadgetList is just a spare GadgetList that you have that the TextEntry window
  23. can use.
  24.    If you incorporate the up/down gadgets into your own shape file, then you
  25. should not specify a filename - ie FileName$="", and specify with Shape the
  26. Shape which you have loaded them as.  The two shapes MUST be kept in the same
  27. order and next to each other.
  28.  
  29.    TextEntryPostion{x,y,w,h}
  30.  
  31.    This function will postion the window at the specified screen coordinates
  32. with the specified width and height (actual window size NOT text lines.
  33.    Specifying any of these as -1 will leave their values unchanged, thus leaving
  34. those things as they were last left or as the default.  This does NOT need to
  35. be called.
  36.  
  37.    result$=TextEntry{Window,Title$,EditText$,MaxChars}
  38.  
  39.    This is the actual routine - Window is the Window number that will be used,
  40. opening on the current screen.  Title$ is the title of the window, and
  41. EditText$ is the text to be edited.  MaxChars is the Maximum number of
  42. characters that may be entered.
  43.  
  44. AUTHOR
  45. ======
  46.  
  47.    Contact me (Mark Tiffany) at
  48.  
  49.          37 Norfolk Road
  50.          Littlehampton
  51.          West Sussex
  52.          BN17 5PW
  53.  
  54.    or on PHY93003@bham.ac.uk during University term times.
  55.  
  56. UPDATES
  57. =======
  58.  
  59.    Come On!  This is only the first version!
  60.  
  61.  
  62.