home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / clipper / atedit.zip / ATEDIT.DOC < prev    next >
Text File  |  1993-06-07  |  4KB  |  110 lines
  1. ATEDIT: Minimal Clipper version of FoxPro's @...EDIT command
  2.  
  3. Written by John C. Burkhard
  4.            Asta Engineering, Inc.
  5.            20251 Century Blvd
  6.            Germantown, MD  20874
  7.  
  8.            CIS: 71044,3263
  9.  
  10. 07-Jun-93
  11.  
  12. ======================================================================
  13.  
  14. Copyright:
  15.  
  16.      (C) 1992, 1993 by Asta Engineering, Inc.  All Rights Reserved.
  17.  
  18.      License (in simple terms):  You didn't write it, you didn't pay
  19. for it, so you can't sell it.  
  20.  
  21.      You can give it away.  
  22.  
  23.      You can include it as part of a program you write, regardless of
  24. whether it is for personnal or business use, but you can't charge for
  25. this code.  You're free to do what you want with your code, though.
  26.  
  27.      Any changes or enhancements you make to the software are bound
  28. by this license.
  29.  
  30.  
  31. ======================================================================
  32.  
  33. Disclaimer:
  34.  
  35.      This software is provided free of charge on an "AS-IS" basis. 
  36. Asta Engineering, Inc. will not be liable for any damages whatsoever
  37. including direct, indirect, consequential or other, resulting from
  38. the use of this software.  This software is provided without warranty
  39. of any kind, including but not limited to WARRANTY AGAINST DEFECTS,
  40. WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE, and WARRANTY OF
  41. MERCHANTABILITY.  So there.
  42.  
  43. ======================================================================
  44.  
  45. How to Use:
  46.  
  47.      ATEDIT is a set of routines and a User Defined Command which
  48. implements a limited form of FoxPro's @...EDIT command.  The command
  49. syntax is:
  50.  
  51.      @ <nTop>, <nLeft> TO <nBottom>, <nRight> EDIT <cVar> 
  52.           [ COLOR <color> ] [ SCROLL ]
  53.  
  54.      <nTop> and <nLeft> specifiy the upper left coordinates of the
  55. edit window, while <nBottom> and <nRight> specify the lower right
  56. coordinates.  <cVar> is the character variable to edit.  
  57.  
  58.      If specified, <color> provides the color attributes for the edit
  59. window.  If ommitted, @...EDIT uses the same color combinations as
  60. used by @...GET.
  61.  
  62.      When included, the SCROLL keyword allows the edit window to
  63. scroll. In scroll mode, the window behaves like a normal editor
  64. window.
  65.  
  66.      In a non-scrolling edit window, the field behaves much like a
  67. normal field.  Pressing the up arrow while on the first line of the
  68. field will take the cursor to the previous field, while pressing the
  69. down arrow key while in the last line of the region will take the
  70. cursor to the next field.  Page Up and Page Down within a
  71. non-scrolling edit window behave as they would in a normal field.
  72.  
  73. In scrollable fields, you may only exit the edit mode by pressing
  74. Ctrl-END (Ctrl-W) or ESCape (Ctrl-Q).
  75.  
  76. ======================================================================
  77.  
  78. Comments:
  79.  
  80.      Because of the whacky way in which Memoedit() works, and because
  81. of the limits in the Get system, you should be aware of a few things:
  82.  
  83.      - LastKey() will always return K_CTRL_END when exiting from the
  84. @...EDIT reader function (except of course when it doesn't).  It's
  85. the only way I could see to get MemoEdit to behave the way I wanted
  86. it to.  Note this only applies to non-scrollable fields.  Scrollable
  87. fields work correctly.
  88.  
  89.      - Because LastKey() returns K_CTRL_END regardless of the actual
  90. key you pressed to exit the field, well...  You can probably see that
  91. LastKey() is pretty useless for figuring out how the user exited the
  92. READ.
  93.  
  94.      If knowing the key used to exit the read is really important to
  95. you, unless you want to modify the get system, you're out of luck.
  96.  
  97.      I personally would love to see a small footprint fast editor
  98. with the same capabilities as memoedit() but with the flexibility of
  99. TBrowse.
  100.  
  101. ======================================================================
  102.  
  103. Finally:
  104.  
  105.      I'd appreciate any comments, thoughts or suggestions about this
  106. code.  It's not too sophisticated because I didn't need it to be for
  107. my application.  If you can suggest any changes (or better yet,
  108. contribute any changes) let me know!
  109.  
  110.