home *** CD-ROM | disk | FTP | other *** search
/ PC World 2002 May / PCWorld_2002-05_cd.bin / Software / TemaCD / activetcltk / ActiveTcl8.3.4.1-8.win32-ix86.exe / ActiveTcl8.3.4.1-win32-ix86 / include / itk.h < prev    next >
Encoding:
C/C++ Source or Header  |  2001-10-22  |  3.6 KB  |  117 lines
  1. /*
  2.  * ------------------------------------------------------------------------
  3.  *      PACKAGE:  [incr Tk]
  4.  *  DESCRIPTION:  Building mega-widgets with [incr Tcl]
  5.  *
  6.  *  [incr Tk] provides a framework for building composite "mega-widgets"
  7.  *  using [incr Tcl] classes.  It defines a set of base classes that are
  8.  *  specialized to create all other widgets.
  9.  *
  10.  *  ADDING [incr Tk] TO A Tcl-BASED APPLICATION:
  11.  *
  12.  *    To add [incr Tk] facilities to a Tcl application, modify the
  13.  *    Tcl_AppInit() routine as follows:
  14.  *
  15.  *    1) Include the header files for [incr Tcl] and [incr Tk] near
  16.  *       the top of the file containing Tcl_AppInit():
  17.  *
  18.  *         #include "itcl.h"
  19.  *         #include "itk.h"
  20.  *
  21.  *    2) Within the body of Tcl_AppInit(), add the following lines:
  22.  *
  23.  *         if (Itcl_Init(interp) == TCL_ERROR) {
  24.  *             return TCL_ERROR;
  25.  *         }
  26.  *         if (Itk_Init(interp) == TCL_ERROR) {
  27.  *             return TCL_ERROR;
  28.  *         }
  29.  *
  30.  *    3) Link your application with libitcl.a and libitk.a
  31.  *
  32.  *    NOTE:  An example file "tkAppInit.c" containing the changes shown
  33.  *           above is included in this distribution.
  34.  *
  35.  * ========================================================================
  36.  *  AUTHOR:  Michael J. McLennan
  37.  *           Bell Labs Innovations for Lucent Technologies
  38.  *           mmclennan@lucent.com
  39.  *           http://www.tcltk.com/itcl
  40.  *
  41.  *     RCS:  $Id: itk.h,v 1.10 2001/09/16 15:02:25 davygrvy Exp $
  42.  * ========================================================================
  43.  *           Copyright (c) 1993-1998  Lucent Technologies, Inc.
  44.  * ------------------------------------------------------------------------
  45.  * See the file "license.terms" for information on usage and redistribution
  46.  * of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  47.  */
  48. #ifndef ITK_H
  49. #define ITK_H
  50.  
  51. /*
  52.  * A special definition used to allow this header file to be included
  53.  * in resource files so that they can get obtain version information from
  54.  * this file.  Resource compilers don't like all the C stuff, like typedefs
  55.  * and procedure declarations, that occur below.
  56.  */
  57.  
  58. #ifndef RC_INVOKED
  59.  
  60. #include "tk.h"
  61. #include "itclInt.h"
  62.  
  63. #ifdef BUILD_itk
  64. # undef TCL_STORAGE_CLASS
  65. # define TCL_STORAGE_CLASS DLLEXPORT
  66. #endif
  67.  
  68. /*
  69.  *  List of options in alphabetical order:
  70.  */
  71. typedef struct ItkOptList {
  72.     Tcl_HashTable *options;     /* list containing the real options */
  73.     Tcl_HashEntry **list;       /* gives ordering of options */
  74.     int len;                    /* number of entries in order list */
  75.     int max;                    /* maximum size of order list */
  76. } ItkOptList;
  77.  
  78. /*
  79.  *  List of options created in the class definition:
  80.  */
  81. typedef struct ItkClassOptTable {
  82.     Tcl_HashTable options;        /* option storage with fast lookup */
  83.     ItkOptList order;             /* gives ordering of options */
  84. } ItkClassOptTable;
  85.  
  86. /*
  87.  *  Each option created in the class definition:
  88.  */
  89. typedef struct ItkClassOption {
  90.     ItclMember *member;           /* info about this option */
  91.     char *resName;                /* resource name in X11 database */
  92.     char *resClass;               /* resource class name in X11 database */
  93.     char *init;                   /* initial value for option */
  94. } ItkClassOption;
  95.  
  96. #include "itkDecls.h"
  97.  
  98. /*
  99.  *  This function is contained in the itkstub static library
  100.  */
  101.  
  102. #ifdef USE_ITK_STUBS
  103.  
  104. CONST char *        Itk_InitStubs _ANSI_ARGS_((Tcl_Interp *interp,
  105.                 char *version, int exact));
  106. #endif
  107.  
  108. /*
  109.  * Public functions that are not accessible via the stubs table.
  110.  */
  111.  
  112. # undef TCL_STORAGE_CLASS
  113. # define TCL_STORAGE_CLASS DLLIMPORT
  114.  
  115. #endif /* RC_INVOKED */
  116. #endif /* ITK_H */
  117.