home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 5 / 05.iso / a / a108 / 5.ddi / README.TXT < prev    next >
Encoding:
Text File  |  1994-03-08  |  11.0 KB  |  335 lines
  1.                        README.TXT
  2. **********************************************************
  3.   Microsoft(R) FoxPro(R) Version 2.6 Professional Edition
  4.   Library Construction Kit for Windows(TM) and MS-DOS(R)
  5.  
  6.     (C)1994 Microsoft Corporation. All Rights Reserved.
  7.  
  8.   This file contains additions and corrections to the
  9.   FoxPro Library Construction Kit Developer's Guide.
  10. **********************************************************
  11.  
  12. =========
  13. CONTENTS
  14. =========
  15.  
  16. Part   Description
  17. ----   -----------
  18.  1     Installation
  19.  2     Additions to LCK Developer's Guide Since Printing
  20.  3     Corrections to LCK Developer's Guide Since Printing
  21. ----------------------------------------------------------
  22.  
  23.  
  24. =====================
  25. Part 1: Installation
  26. =====================
  27.  
  28. Installing the Professional Edition of FoxPro 2.6
  29. -------------------------------------------------
  30. The Professional Edition of FoxPro 2.6 includes the
  31. following kits:
  32.  
  33. Distribution Kit
  34. Connectivity Kit
  35. Library Construction Kit
  36. WorkGroup Extensions (FoxPro for Windows only) 
  37.  
  38. To install the Professional Edition of FoxPro, first install
  39. the main FoxPro product, then follow the installation 
  40. instructions included with each individual kit.  The order 
  41. in which the kits are installed does not matter.
  42. ----------------------------------------------------------
  43.  
  44.  
  45. ==========================================================
  46. Part 2: Additions to LCK Developer's Guide Since Printing
  47. ==========================================================
  48. In the LCK Developer's Guide, references to FoxPro 2.5 
  49. should be read as references to FoxPro 2.6.
  50. ----------------------------------------------------------
  51.  
  52. The EXAMPLES directory contains a FoxPro database with all
  53. the example code that is used in the manual.  Simply
  54. search for the function with example code you wish to
  55. copy and then extract the code from the memo field. You
  56. are free to use this code in your own applications.
  57. -----------------------------------------------------------
  58.  
  59. The following function has been added:
  60.  
  61. WHANDLE _WMainWindow( )
  62.  
  63. Description:
  64. _WMainWindow( ) returns the WHANDLE of the main FoxPro
  65. window in FoxPro for Windows or of the FoxPro desktop
  66. in FoxPro for MS-DOS.
  67.  
  68. Example:
  69. The following example writes a message to the main FoxPro
  70. window in FoxPro for Windows or to the FoxPro desktop in
  71. FoxPro for MS-DOS.
  72.  
  73. FoxPro Code:
  74.  
  75.    SET LIBRARY TO WMAIN
  76.    = EXWMAIN()
  77.  
  78. C Code:
  79.  
  80.    #include <pro_ext.h>
  81.  
  82.    void FAR example(ParamBlk FAR *parm)
  83.    {
  84.         WHANDLE wh = _WMainWindow();
  85.         _WPutStr(wh, "\nThis is the main FoxPro window or desktop.");
  86.    }
  87.  
  88.    FoxInfo myFoxInfo[] = {
  89.         {"EXWMAIN", example, 0, ""},
  90.    };
  91.  
  92.    FoxTable _FoxTable = {
  93.         (FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
  94.    };
  95. ----------------------------------------------------------
  96.  
  97.  
  98. ===================================================
  99. Part 3: Corrections to LCK Developer's Guide Since 
  100.         Printing
  101. ===================================================
  102.  
  103. Page 2: In the Reverse.C example:
  104.  
  105. The comment "/* Check to see if we can allocate the memory
  106. needed. */" is missing the end comment marker */.
  107.  
  108. The three-line comment "Since this routine doesn't call
  109. any functions that cause memory reorganization . . . 
  110. prior to de-referencing them (_HandToPtr)" is missing the
  111. single line comment marker // in the second and third
  112. lines.
  113.  
  114. This statement:
  115.  
  116.    for (i = 0; i << parm->p[0].val.ev_length; i++)
  117.             *(out_string--) = *(in_string++);
  118.  
  119. should be:
  120.  
  121.    for (i = 0; i < parm->p[0].val.ev_length; i++)
  122.             *(out_string--) = *(in_string++);
  123.  
  124. Change the "<<" in the original example to "<".
  125. ----------------------------------------------------------
  126.  
  127. Page 5: The Value Structure Fields table should include
  128. the General FoxPro data type.  The applicable fields and
  129. their values are listed below:
  130.  
  131. val.ev_type = 'G'
  132. val.ev_width = FCHAN
  133. val.ev_long = length of general field
  134. val.ev_real = offset of general field
  135. ----------------------------------------------------------
  136.  
  137. Page 6: The data type FPFI, a FAR pointer to a function
  138. returning Int, is mistakenly listed as "FPDI".
  139. ----------------------------------------------------------
  140.  
  141. Page 7: In addition to the Point, Rect and EventRec data
  142. structures, PointP and RectP should be included. PointP
  143. and RectP are identical to Point and Rect except that
  144. Point and Rect coordinates are in rows and columns while
  145. PointP and RectP coordinates are in pixels.
  146. ----------------------------------------------------------
  147.  
  148. Page 12: The example
  149.  
  150.     if (parm->p[0].val.ev_type='C'
  151.                 x=parm->p[0].val.ev_length
  152.  
  153. should be:
  154.  
  155.    if (parm->p[0].val.ev_type=='C')
  156.                 x=parm->p[0].val.ev_length;
  157.  
  158. Use an expression ==, a closed parenthesis at the end of
  159. the first line, and a semicolon at the end of the second
  160. line.
  161. ----------------------------------------------------------
  162.  
  163. Page 22: When compiling a .PLB library in Microsoft C7 or
  164. Visual C/C++, you need to use the following command line:
  165.  
  166. CL /O /ALw /Zp /GW
  167.  
  168. When linking a .PLB library in Microsoft C7 or C8, you 
  169. need to use the /NOE and /NONULLS switches.
  170.  
  171. Leaving out /NOE can cause redefinition errors. Leaving
  172. out /NONULLS will cause FoxPro not to recognize the .PLB
  173. as a valid library.
  174. ----------------------------------------------------------
  175.  
  176. Page 25: The section heading for the makefile on this page
  177. is incorrect. It should say "Microsoft C/C++ Makefile for
  178. MS-DOS" instead of "WATCOM C Makefile for MS-DOS." 
  179. ----------------------------------------------------------
  180.  
  181. Page 26: The  makefile on this page should have the
  182. following section heading: "WATCOM C Makefile for MS-DOS."
  183. ----------------------------------------------------------
  184.  
  185. Page 39: The example doesn't work as intended in all
  186. cases. To have it work, you need to change the following
  187. line:
  188.  
  189.    (( char FAR *) _HandToPtr(p1.ev_handle))[p1.ev_length] = '\0';
  190.  
  191. to:
  192.  
  193.    (( char FAR *) _HandToPtr(p0.ev_handle))[p0.ev_length - 1] = '\0';
  194.    (( char FAR *) _HandToPtr(p1.ev_handle))[p1.ev_length - 1] = '\0';
  195. ----------------------------------------------------------
  196.  
  197. Page 85: The following information applies to the 
  198. _DBSeek( ) function: The struct Value passed to _DBSeek( )
  199. (via a pointer) must be of ev_type == 'N' when seeking a
  200. numeric field even if that field has 0 decimal digits.
  201. If the struct Value has an ev_type of 'I', _DBSeek( )will
  202. return the internal error number -302, "Data type
  203. mismatch."
  204. ----------------------------------------------------------
  205.  
  206. Page 109: The struct EDENV documented with _EdGetEnv( ) isn't
  207. correct. The actual structure from PRO_EXT.H appears
  208. as follows:
  209.  
  210. NOTE:  (R) indicates that this member is read-only and
  211.        can't be set using _EdSetEnv( ).
  212.  
  213.        (B) indicates that these members takes on one of
  214.        two Boolean values: 1 = true or 0 = false.
  215.  
  216.  
  217. typedef struct
  218. {
  219.    char            filename[MAXFILENAME]; // (R)
  220.    EDPOS           length;       // # of bytes in text. (R)
  221.    unsigned short  lenLimit;     // Max allowable length. 0 = infinite.
  222.  
  223.    unsigned short  dirty,        // Has the file been changed? (R, B)
  224.                    autoIndent,   // Auto indent? (B)
  225.                    backup,       // Make backup files? (B)
  226.                    addLineFeeds, // Add line feeds when saving? (B)
  227.                    autoCompile,  // Shall we auto compile this thing? (B)
  228.                    addCtrlZ,     // Add end of file ctrl-z? (B)
  229.                    savePrefs,    // Save edit preferences? (B)
  230.                    dragAndDrop,  // Allow drag-and-drop. (B)
  231.                    readOnly,     // 0 = not r/o, 1 = file is r/o,
  232.                                  // 2 = file is r/w, opened r/o,
  233.                                  // 3 = file is r/o, opened r/o. (R)
  234.                    status,       // Display status bar? (B)
  235.                    lockPrefs,    // Can update the preferences ? (B)
  236.                    insertMode;   // (B)
  237.  
  238.    short   wrap;       // If < 0, new line at Return only.
  239.    EDPOS   selStart;   // Selection start. (R)
  240.    EDPOS   selEnd;     // Selection end. (R)
  241.    EDPOS   selAnchor;  // Selection anchor point. (R)
  242.    short   justMode;   // Justification (0 = left, 1 = right, 2 = center).
  243.    short   tabWidth;   // TAB size in spaces.
  244.  
  245.    char    fontName[MAXFONTNAME];
  246.    short   fontSize;
  247.    short   fontStyle;  // 0 = plain, 1 = bold, 2 = italic, 3 = bold italic.
  248.    short   kind;       // Kind of editor session; EDCOMMAND, EDPROGRAM, etc.
  249.                        // defined in pro_ext.h. (R)
  250. } EDENV;
  251. ----------------------------------------------------------
  252.  
  253. Page 122: The syntax for _EdOpenFile() is missing the
  254. "mode" argument.  It should read:
  255.  
  256.    _EdOpenFile(TEXT *filename, int mode)
  257.  
  258.    TEXT *filename;      /* File to open. */
  259.    int mode;            /* Mode option. */
  260.     
  261. The following Mode options are available:
  262. FO_READONLY, FO_WRITEONLY, FO_READWRITE.
  263. ----------------------------------------------------------
  264.  
  265. Page 315: zoomEvent is a FoxPro for MS-DOS event.  You
  266. can't trap for this event in FoxPro for Windows.
  267. ----------------------------------------------------------
  268.  
  269. In an EventHandler in the FoxPro for Windows Library
  270. Construction Kit, if you make a call to FoxPro which
  271. generates another event, the original event record may be
  272. changed.  This won't happen in the FoxPro for MS-DOS
  273. Library Construction Kit. The following example
  274. illustrates this:
  275.  
  276. #include <pro_ext.h>
  277.  
  278. int         g_eventid = 0;         // Our event handler.
  279.  
  280. FAR EventHandler(WHandle theWindow, EventRec FAR *ev)
  281. {
  282.         Point     pt;
  283.     switch (ev->what)              // Determine the event type.
  284.     {
  285.         case keyDownEvent:
  286.                         if (theWindow == _WMainWindow())
  287.                                 return NO;
  288.                         else
  289.                         {
  290.                                 pt.h = 35;
  291.                                 pt.v = 10;
  292.  
  293.                         // This causes the event handler to be re-entered.
  294.                                 _WSize(theWindow, pt);    
  295.                         }
  296.                         _PutStr("\nDone with the keyDownEvent");
  297.                         break;
  298.  
  299.                 case sizeEvent:
  300.                         _PutStr("\nSize Event received.");
  301.                         break;
  302.  
  303.                         default:
  304.                         return NO;
  305.         }
  306.         return NO;
  307. }
  308.  
  309. FAR EventExit()
  310. {
  311.     _DeActivateHandler(g_eventid);     // Get rid of our event handler.
  312. }
  313.  
  314.  
  315. FAR Quotes(ParamBlk FAR *parm)
  316. {
  317.     //  Set up our event handler.
  318.     g_eventid = _ActivateHandler(EventHandler);
  319. }
  320.  
  321.  
  322. FoxInfo myFoxInfo[] = {
  323.     {"QUOTES", Quotes, 0, ""},
  324.     {"EVENTEXIT", EventExit, CALLONUNLOAD, ""}
  325. };
  326.  
  327. FoxTable _FoxTable = {
  328.     (FoxTable FAR *)0, sizeof(myFoxInfo) / sizeof(FoxInfo), myFoxInfo
  329. };
  330. ----------------------------------------------------------
  331.  
  332.                       =================
  333.                       End of README.TXT
  334.                       =================
  335.