home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 125.lha / MenuText / menutext.doc < prev    next >
Text File  |  1986-11-20  |  4KB  |  84 lines
  1. /*------------------------------------------------------------------------*/
  2.  
  3. Along with this documentation file, you should also find 2 programs, MENUTEXT,
  4. and RESTORE. Together these programs allow you to customize the text of other
  5. people's menus; if you have ADD, you can also modify the keyboard shortcuts
  6. of a running program.
  7.  
  8. /*------------------------------------------------------------------------*/
  9.  
  10. MENUTEXT
  11. --------
  12.     This program has been written to be "friendly" - it makes changes to the
  13. Intuition structures of a window's menu, but also changes the window in a
  14. way that could easily be detected by a program that had certain checks built
  15. in.
  16.     You specify the window, the numbers of the menu, item, and sub-item,
  17. and replacement text. The program extrapolates from this how wide the hitbox
  18. of the menu should be (that's the space that gets reversed or "boxed in" while
  19. you move around in the menu), and adds some extra room so that keyboard
  20. shortcuts don't overlap the displayed text. I've been careful to see that
  21. you can't violate the rules of menu design and seperate a menu item from its
  22. submenu section.
  23.  
  24. Sample usage:
  25.  
  26. menutext Notepad 4 1 Dull   ; change text of first item in fourth menu from
  27.                             ; "Plain" to "Dull"
  28.  
  29. menutext VT100 1 1 Download_Ascii_File  ; change first item of first menu
  30.  
  31. But that is not very aesthetically pleasing, so...
  32.  
  33. menutext VT100 1 1 -ask     ; it will prompt for text, which *can* include
  34.                             ; spaces
  35.  
  36. menutext VT100 2 1 5 Forget_it!     ; note you can use 3 numbers to specify
  37.                                     ; sub-menu position
  38.  
  39. Restrictions: The window name you specify *is* case-sensitive.
  40.               Only the first word of the window name is significant.
  41.               No screen is specified; they are *all* searched.
  42.               Only 44 characters of menu text are significant.
  43.               With the "-ask" option, you may Guru if you enter >100 letters.
  44.               If the window is closed before you run RESTORE, you will end
  45.                   up with little spots of allocated memory that you can never
  46.                   reclaim.
  47.           *** Some windows may not be suitable for this. In technical terms,
  48.                   if the window's UserData is non-null, you may crash. In
  49.                   layman's terms, if you've never tried this on a window,
  50.                   you may get a big red flashing box. The Workbench window
  51.                   in particular seems to set its UserData to some random
  52.                   value.
  53.               No attempt has been made to optimize or shrink this program;
  54.                   it still prints debugging information. Please let me know
  55.                   if you find a program which is incompatible.
  56.  
  57. /*------------------------------------------------------------------------*/
  58.  
  59. RESTORE
  60. -------
  61.     If you have made changes to window "Foo" with MENUTEXT, you can restore
  62. the menu to its original state by saying "restore Foo". You will get some
  63. debugging info which tells you what definitions had been changed.
  64.  
  65. *** If you run this program and specify a window which uses its UserData
  66. for anything else, you may crash. This will probably happen during MENUTEXT,
  67. though.
  68.  
  69.     If the width of a menu has been stretched by the addition of a long text
  70. string, it may stay stretched even after you restore it. Don't worry about
  71. this, it will go away if Intuition reconsiders its menu display - otherwise
  72. it can be ignored.
  73.  
  74. ((c)) 1987, John Russell. Unlimited distribution, but donations to
  75. starving programmers welcome.
  76.  
  77. John Russell
  78. 5 Alderdice Place
  79. St. John's, Newfoundland, Canada
  80. A1B 2P8
  81. (709) 726-7847
  82.  
  83.  
  84.