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