home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / database / ronheb.zip / RONHEB.DOC < prev    next >
Text File  |  1988-05-04  |  4KB  |  130 lines
  1. --------------------------------------------------------------------------------
  2. ; Filename: RONHEB.LIB
  3. ; Program.: Ron's hebrew support V1.1 for clipper summer 1987
  4. ; Authors.: Ron Bar-lev
  5. ; Date....: MAY 4,1988
  6. ; Notice..: Clipper is a trademark of Nantucket.
  7. ; 
  8. ;
  9. Ron Bar-lev hebrew support for Clipper summer 1987
  10. ---------------------------------------------------
  11. The folowing functions are included in the run time library RONHEB.LIB,
  12. the library is to be linked with the .OBJ file with clipper's own libraries
  13. EXTEND.LIB and CLIPPER.LIB (obligatory).
  14.  
  15. Before using any of the hebrew support functions and procedures include
  16. the following satment in your program (.PRG):
  17.  
  18. INITHEB(expN)
  19.  
  20. Where expN denotes the max number of hebrew "GET"-s per readh() statement
  21.  
  22. This function initializes the hebrew support public variables and arrays.
  23.  
  24. To invoke hebrew support for clipper version aut' 86 , the above function ;
  25. should be rewritten, moving all public array definitions (not available until
  26. summer 87) to the head of the main module.
  27.  
  28. The hebrew functions allow input into memory variable only. no direct input
  29. into database fields is allowed.It is the programmers responsibility to
  30. initiallize the fields.
  31.  
  32. In the special case when attempting to get hebrew fields defined as array-
  33. elements, indexes should be passed via macro substitution.
  34.  
  35. Following functions are included in GETHEB.PRG
  36. ------------------------------------------------
  37. 1. GETHEB - procedure
  38.  
  39. usage:
  40.  
  41. DO GETHEB with Rownumber,Colnumber,"field-name" [,"Valid-Functions"]
  42.  
  43. The procedure replaces the clipper GET statment.
  44.  
  45. Following functions are included in RONHEB.PRG
  46. ------------------------------------------------
  47. 1. INITHEB - function
  48.  
  49.  
  50. INITHEB([expN])
  51.  
  52. Initilizes the hebrew support system , the optional parameter sets the maximal
  53. number of input fileds for a READH() statement. default value is 50.
  54.  
  55. 2.RHEBVLD()
  56.  
  57. Internally used by the hebrew support system.
  58.  
  59. 3.READH()
  60.  
  61. To be used instead of clipper READ statment.
  62.  
  63.  
  64.  
  65.  
  66. 4.HTRANS(expN)
  67.  
  68. Internally used by the hebrew support system.
  69. Translates lower case english characters to hebrew.
  70.  
  71. 5.HKBOARD(expC)
  72.  
  73. Internally used by the hebrew support system.
  74. Adds an inkey in front of the keyboard buffer string.
  75.  
  76. 6.READHVAR()
  77.  
  78. Returns the currently read hebrew field name,replaces clipper READVAR() func.
  79.   may be used throughout the program.
  80.  
  81. 7.HUPDATED()
  82.  
  83. Returns true if a field was updated during last read
  84.  may be used throughout the program.
  85.  
  86. 8.RHSETK(expN,"Progname")
  87.  
  88. Assigns function keys to be called from within a hebrew field,e.g. for help.
  89.  
  90. Example: 
  91.  
  92. rhsetk(-1,"PROGNAME") - sets the F2 key (-1) to PROGNAME.
  93.  
  94. 9.RHCOLOR()
  95.  
  96. Internally used by the hebrew support system.
  97.  
  98. 10.HEBFIELD()
  99.  
  100. returns .T. if current "get" (from within a "HELP" or "VALID" routine) is
  101. a (Character) Hebrew field.otherwise returns .F..
  102.  
  103. Following functions are included in RONMEMO.PRG
  104. ------------------------------------------------
  105.  
  106. 1.HEBEDIT("Edit_var",uprtrow,uprtcol,loltrow,loltcol,isupdated)
  107.  
  108. This function enables hebrew memofield edit of up to 66 lines,opens an edit
  109. window, replaces MEMOEDIT() .The function returns the edited field.
  110. The last parameter decides if update is alowed.
  111.  
  112. 2.HEBPRN("field_name",left_margin,rt_margin)
  113.  
  114. This function enables printing of long hebrew fileds.left_margin & right_margin
  115. min's are 3 & 2 respectively giving a maximal printed line width of 75 chars.
  116.  
  117. 3.HEBMAC(expS)
  118.  
  119. This function opens macro in hebrew memo field,the macro apears between '{'
  120.  and '}'.
  121.  
  122. Following functions are included in INVERT.PRG
  123. ------------------------------------------------
  124.  
  125. 1.INV(expC)
  126.  
  127. This function reverses long strings by calling an assembly language routine
  128.  CLREV87.ASM (writen by Oded s. Resnik).For any practical purpose there is
  129.  no limit to string length aside from memory avalability.
  130.