This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

This manual page is associated with the Mac OS X developer tools. The software or headers described may not be present on your Mac OS X installation until you install the developer tools package. This package is available on your Mac OS X installation DVD, and the latest versions can be downloaded from developer.apple.com.

For more information about the manual page format, see the manual page for manpages(5).

Tcl_MacSetEventProc(3)                     Tcl Library Procedures                     Tcl_MacSetEventProc(3)



____________________________________________________________________________________________________________

NAME
       Tcl_MacSetEventProc,     Tcl_MacConvertTextResource,     Tcl_MacEvalResource,    Tcl_MacFindResource,
       Tcl_GetOSTypeFromObj, Tcl_SetOSTypeObj, Tcl_NewOSTypeObj - procedures to handle  Macintosh  resources
       and other Macintosh specifics

SYNOPSIS
       #include <tcl.h>

       int
       Tcl_MacEvalResource(interp, resourceName, resourceNumber, fileName)

       char*
       Tcl_MacConvertTextResource(resource)

       Handle
       Tcl_MacFindResource(interp, resourceType, resourceName, resourceNumber, resFileRef, releaseIt)

       Tcl_Obj*
       Tcl_NewOSTypeObj(newOSType)

       void
       Tcl_SetOSTypeObj(objPtr, newOSType)

       int
       Tcl_GetOSTypeFromObj(interp, objPtr, osTypePtr)

       void
       Tcl_MacSetEventProc(procPtr)

ARGUMENTS
       Tcl_Interp   *interp            (in)      Interpreter to use for error reporting, or NULL if no error
                                                 reporting is desired.

       CONST char   *resourceName      (in)      Name of TEXT resource to source, NULL if number  should  be
                                                 used.

       int          resourceNumber     (in)      Resource id of source.

       CONST char   *fileName          (in)      Name of file to process. NULL if application resource.

       Handle       resource           (in)      Handle to TEXT resource.

       long         resourceType       (in)      Type of resource to load.

       CONST char   *resFileRef        (in)      Registered  resource  file reference, NULL if searching all
                                                 open resource files.

       int          *releaseIt         (out)     Should we release this resource when done.

       int          newOSType          (in)      Int used to initialize the new object or set  the  object's
                                                 value.

       Tcl_Obj      *objPtr            (in)      Object  whose  internal  representation  is  to  be  set or
                                                 retrieved.

       osTypePtr    out                          Place to store the resulting integer.

       Tcl_MacConvertEventPtr          procPtr(in)
                                                 Reference to the new function to handle  all  incoming  Mac
                                                 events.

____________________________________________________________________________________________________________

INTRODUCTION
       The described routines are used to implement the Macintosh specific resource command and the Mac spe-cific specific
       cific notifier.. They manipulate or use Macintosh  resources  and  provide  administration  for  open
       resource file references.


DESCRIPTION
       Tcl_MacEvalResource  extends  the  source command to Macintosh resources.  It sources Tcl code from a
       Text resource.  Currently only sources the resource by name, file IDs may be  supported  at  a  later
       date.

       Tcl_MacConvertTextResource  converts  a  TEXT  resource  into  a  Tcl suitable string. It mallocs the
       returned memory, converts ``\r'' to ``\n'', and appends a null. The caller has the responsibility for
       freeing the memory.

       Tcl_MacFindResource  provides  a higher level interface for loading resources. It is used by resource
       read.

       Tcl_NewOSTypeObj is used to create a new resource name type object. The object type is "ostype".

       Tcl_SetOSTypeObj modifies an object to be a resource type and to have the specified long value.

       Tcl_GetOSTypeFromObj attempts to return an int from the Tcl object "objPtr". If  the  object  is  not
       already an int, an attempt will be made to convert it to one.

       Tcl_MacSetEventProc  sets  the  event  handling  procedure for the application. This function will be
       passed all incoming Mac events.  This function usually controls the console or some other entity like
       Tk.


RESOURCE TYPES
       Resource types are 4-byte values used by the macintosh resource facility to tag parts of the resource
       fork in a file so that the OS knows how to handle them. As all 4 bytes are  restricted  to  printable
       characters such a type can be interpreted as a 4 character string too.


KEYWORDS
       macintosh, mac, resource, notifier



Tcl                                                  8.1                              Tcl_MacSetEventProc(3)