Contents of FoxPro 2.6a for Macintosh "LCK ReadMe" File

Last reviewed: May 29, 1996
Article ID: Q120592
The information in this article applies to:
  • Microsoft FoxPro Library Construction Kit for Macintosh, version 2.6a

SUMMARY

Below is the complete FoxPro 2.6a for Macintosh "LCK ReadMe" file found in the "Library Construction Kit" folder in the main FoxPro folder (usually "Microsoft FoxPro 2.6").

MORE INFORMATION

**********************************************************

                     Release Notes for

                 Library Construction Kit
Microsoft(R) FoxPro(R) for Macintosh(R) and Power Macintosh(TM)
              Version 2.6a Professional Edition

    (C)1994 Microsoft Corporation. All rights reserved.
**********************************************************

For installation instructions, see the "Readme Before Installation-Pro" file.

Contents

Part 1: Library Construction Kit Information Part 2: Changes to Documentation Since Printing

Part 1: Library Construction Kit Information This section includes information about:

  • Customizing MPW
  • _Alloca() Caution
  • Including PRO_EXT.H
  • Installing .MLB Files
  • Errors While Using _Execute

Customizing MPW

Before you create shared libraries, customize MPW to work with your source files. You can use the provided example files to test your changes.

To customize the example files: 1. Open UserStartup.LCK and change any path references to match your

   volume name.
   **Note** Volume names cannot contain spaces.
2. To enable these changes, exit MPW, then restart MPW. 3. Set your default directory to <your volume>:FoxLCK:Source: 4. In the Source folder, open Makefile. 5. Change the ROOTDIR setting to match your volume name.

Now, MPW is customized to produce a shared library. Verify this by building a sample library.

To create a sample shared library 1. In the MPW Worksheet window, type MAKE and press Command+Return. 2. Highlight the output from MAKE and execute it by pressing

   Command+Return.

A file called TestLib.MLB will be created in your FOXLCK:SOURCE folder.

To test the sample shared library 1. Drag TestLib.MLB to your SYSTEMS:EXTENSIONS folder. 2. Run FoxPro. 3. In the Command Window, type SET LIBRARY TO TestLib.

Event messages from the library will appear in your main FoxPro window. To stop the output, use the command SET LIBRARY TO with no parameter.

_Alloca() Caution

The following caution is part of the description for _Alloca() in Chapter 10 of the Library Construction Kit Developer's Guide. Though the sample code in EXAMPLES.DBF has been modified to illustrate this, the caution still applies to any code you write.

**Caution** Some C compilers, such as MPW C, do not support memory allocation from the stack; calls to _Alloca() will have unpredictable results. Instead, use local variables, or calls to _AllocHand() and _FreeHand(), in your code to reserve memory.

Including PRO_EXT.H

Definitions in PRO_EXT.H might conflict with definitions in other include files you are using. For better results when you compile, put PRO_EXT.H last in your list of include files.

Installing .MLB Files

Built .MLB files must be placed in the EXTENSIONS folder.

**Important** Do not build directly to the EXTENSIONS folder. Send output to a work directory, then move the file to the EXTENSIONS folder afterward.

Errors While Using _Execute

If an error occurs in the program passed to _Execute, the error appears as a normal program error, with Cancel, Suspend, and Ignore buttons. To prevent this display, make sure the program has its own error handler.

Part 2: Changes to Documentation Since Printing

Any changes to example code in the documentation should also be changed in the EXAMPLES.DBF file.

Page 69

In the example code for _ActivateIdle, change:
    void FAR IdleHandler(WHandle wh, EventRec *ev)
to:
    void FAR IdleHandler()

The two parameters are ignored on the Macintosh, and can cause problems on Windows.

Page 99

In the example code for _DeActivateIdle, change:
    void FAR IdleHandler(WHandle wh, EventRec *ev)
to:
    void FAR IdleHandler()

Page 321

Add a note to the end of the Description column for the rMouseDown event:

    N/A for Macintosh.

Microsoft and FoxPro are registered trademarks of Microsoft Corporation.

Apple and Macintosh are registered trademarks and Power Macintosh is a trademark of Apple Computer, Inc.

                                           **End of Readme**


Additional reference words: FoxMac LCK 2.60a
KBCategory: kbreadme
KBSubcategory:


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: May 29, 1996
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.