tk.h
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:55k
- /*
- * tk.h --
- *
- * Declarations for Tk-related things that are visible
- * outside of the Tk module itself.
- *
- * Copyright (c) 1989-1994 The Regents of the University of California.
- * Copyright (c) 1994 The Australian National University.
- * Copyright (c) 1994-1998 Sun Microsystems, Inc.
- * Copyright (c) 1998-2000 Ajuba Solutions.
- *
- * See the file "license.terms" for information on usage and redistribution
- * of this file, and for a DISCLAIMER OF ALL WARRANTIES.
- *
- * RCS: @(#) $Id: tk.h,v 1.74.2.21 2008/02/06 15:31:40 dgp Exp $
- */
- #ifndef _TK
- #define _TK
- #include <tcl.h>
- #if (TCL_MAJOR_VERSION != 8) || (TCL_MINOR_VERSION != 4)
- # error Tk 8.4 must be compiled with tcl.h from Tcl 8.4
- #endif
- /*
- * For C++ compilers, use extern "C"
- */
- #ifdef __cplusplus
- extern "C" {
- #endif
- /*
- * When version numbers change here, you must also go into the following files
- * and update the version numbers:
- *
- * library/tk.tcl (only if Major.minor changes, not patchlevel)
- * unix/configure.in (2 LOC Major, 2 LOC minor, 1 LOC patch)
- * win/configure.in (as above)
- * win/makefile.vc (not patchlevel)
- * README (sections 0 and 1)
- * mac/README (not patchlevel)
- * win/README (not patchlevel)
- * unix/README (not patchlevel)
- * unix/tk.spec (3 LOC Major/Minor, 2 LOC patch)
- * win/tcl.m4 (not patchlevel)
- *
- * You may also need to update some of these files when the numbers change
- * for the version of Tcl that this release of Tk is compiled against.
- */
- #define TK_MAJOR_VERSION 8
- #define TK_MINOR_VERSION 4
- #define TK_RELEASE_LEVEL TCL_FINAL_RELEASE
- #define TK_RELEASE_SERIAL 18
- #define TK_VERSION "8.4"
- #define TK_PATCH_LEVEL "8.4.18"
- /*
- * A special definition used to allow this header file to be included
- * from windows or mac resource files so that they can obtain version
- * information. RC_INVOKED is defined by default by the windows RC tool
- * and manually set for macintosh.
- *
- * Resource compilers don't like all the C stuff, like typedefs and
- * procedure declarations, that occur below, so block them out.
- */
-
- #ifndef RC_INVOKED
-
- #ifndef _XLIB_H
- # if defined (MAC_TCL)
- # include <Xlib.h>
- # include <X.h>
- # elif defined(MAC_OSX_TK)
- # include <X11/Xlib.h>
- # include <X11/X.h>
- # else
- # include <X11/Xlib.h>
- # endif
- #endif
- #ifdef __STDC__
- # include <stddef.h>
- #endif
- #ifdef BUILD_tk
- # undef TCL_STORAGE_CLASS
- # define TCL_STORAGE_CLASS DLLEXPORT
- #endif
- /*
- * Decide whether or not to use input methods.
- */
- #ifdef XNQueryInputStyle
- #define TK_USE_INPUT_METHODS
- #endif
- /*
- * Dummy types that are used by clients:
- */
- typedef struct Tk_BindingTable_ *Tk_BindingTable;
- typedef struct Tk_Canvas_ *Tk_Canvas;
- typedef struct Tk_Cursor_ *Tk_Cursor;
- typedef struct Tk_ErrorHandler_ *Tk_ErrorHandler;
- typedef struct Tk_Font_ *Tk_Font;
- typedef struct Tk_Image__ *Tk_Image;
- typedef struct Tk_ImageMaster_ *Tk_ImageMaster;
- typedef struct Tk_OptionTable_ *Tk_OptionTable;
- typedef struct Tk_PostscriptInfo_ *Tk_PostscriptInfo;
- typedef struct Tk_TextLayout_ *Tk_TextLayout;
- typedef struct Tk_Window_ *Tk_Window;
- typedef struct Tk_3DBorder_ *Tk_3DBorder;
- typedef struct Tk_Style_ *Tk_Style;
- typedef struct Tk_StyleEngine_ *Tk_StyleEngine;
- typedef struct Tk_StyledElement_ *Tk_StyledElement;
- /*
- * Additional types exported to clients.
- */
- typedef CONST char *Tk_Uid;
- /*
- * The enum below defines the valid types for Tk configuration options
- * as implemented by Tk_InitOptions, Tk_SetOptions, etc.
- */
- typedef enum {
- TK_OPTION_BOOLEAN,
- TK_OPTION_INT,
- TK_OPTION_DOUBLE,
- TK_OPTION_STRING,
- TK_OPTION_STRING_TABLE,
- TK_OPTION_COLOR,
- TK_OPTION_FONT,
- TK_OPTION_BITMAP,
- TK_OPTION_BORDER,
- TK_OPTION_RELIEF,
- TK_OPTION_CURSOR,
- TK_OPTION_JUSTIFY,
- TK_OPTION_ANCHOR,
- TK_OPTION_SYNONYM,
- TK_OPTION_PIXELS,
- TK_OPTION_WINDOW,
- TK_OPTION_END,
- TK_OPTION_CUSTOM,
- TK_OPTION_STYLE
- } Tk_OptionType;
- /*
- * Structures of the following type are used by widgets to specify
- * their configuration options. Typically each widget has a static
- * array of these structures, where each element of the array describes
- * a single configuration option. The array is passed to
- * Tk_CreateOptionTable.
- */
- typedef struct Tk_OptionSpec {
- Tk_OptionType type; /* Type of option, such as TK_OPTION_COLOR;
- * see definitions above. Last option in
- * table must have type TK_OPTION_END. */
- char *optionName; /* Name used to specify option in Tcl
- * commands. */
- char *dbName; /* Name for option in option database. */
- char *dbClass; /* Class for option in database. */
- char *defValue; /* Default value for option if not specified
- * in command line, the option database,
- * or the system. */
- int objOffset; /* Where in record to store a Tcl_Obj * that
- * holds the value of this option, specified
- * as an offset in bytes from the start of
- * the record. Use the Tk_Offset macro to
- * generate values for this. -1 means don't
- * store the Tcl_Obj in the record. */
- int internalOffset; /* Where in record to store the internal
- * representation of the value of this option,
- * such as an int or XColor *. This field
- * is specified as an offset in bytes
- * from the start of the record. Use the
- * Tk_Offset macro to generate values for it.
- * -1 means don't store the internal
- * representation in the record. */
- int flags; /* Any combination of the values defined
- * below. */
- ClientData clientData; /* An alternate place to put option-specific
- * data. Used for the monochrome default value
- * for colors, etc. */
- int typeMask; /* An arbitrary bit mask defined by the
- * class manager; typically bits correspond
- * to certain kinds of options such as all
- * those that require a redisplay when they
- * change. Tk_SetOptions returns the bit-wise
- * OR of the typeMasks of all options that
- * were changed. */
- } Tk_OptionSpec;
- /*
- * Flag values for Tk_OptionSpec structures. These flags are shared by
- * Tk_ConfigSpec structures, so be sure to coordinate any changes
- * carefully.
- */
- #define TK_OPTION_NULL_OK (1 << 0)
- #define TK_OPTION_DONT_SET_DEFAULT (1 << 3)
- /*
- * The following structure and function types are used by TK_OPTION_CUSTOM
- * options; the structure holds pointers to the functions needed by the Tk
- * option config code to handle a custom option.
- */
- typedef int (Tk_CustomOptionSetProc) _ANSI_ARGS_((ClientData clientData,
- Tcl_Interp *interp, Tk_Window tkwin, Tcl_Obj **value, char *widgRec,
- int offset, char *saveInternalPtr, int flags));
- typedef Tcl_Obj *(Tk_CustomOptionGetProc) _ANSI_ARGS_((ClientData clientData,
- Tk_Window tkwin, char *widgRec, int offset));
- typedef void (Tk_CustomOptionRestoreProc) _ANSI_ARGS_((ClientData clientData,
- Tk_Window tkwin, char *internalPtr, char *saveInternalPtr));
- typedef void (Tk_CustomOptionFreeProc) _ANSI_ARGS_((ClientData clientData,
- Tk_Window tkwin, char *internalPtr));
-
- typedef struct Tk_ObjCustomOption {
- char *name; /* Name of the custom option. */
- Tk_CustomOptionSetProc *setProc; /* Function to use to set a record's
- * option value from a Tcl_Obj */
- Tk_CustomOptionGetProc *getProc; /* Function to use to get a Tcl_Obj
- * representation from an internal
- * representation of an option. */
- Tk_CustomOptionRestoreProc *restoreProc; /* Function to use to restore a
- * saved value for the internal
- * representation. */
- Tk_CustomOptionFreeProc *freeProc; /* Function to use to free the internal
- * representation of an option. */
- ClientData clientData; /* Arbitrary one-word value passed to
- * the handling procs. */
- } Tk_ObjCustomOption;
- /*
- * Macro to use to fill in "offset" fields of the Tk_OptionSpec.
- * struct. Computes number of bytes from beginning of structure
- * to a given field.
- */
- #ifdef offsetof
- #define Tk_Offset(type, field) ((int) offsetof(type, field))
- #else
- #define Tk_Offset(type, field) ((int) ((char *) &((type *) 0)->field))
- #endif
- /*
- * The following two structures are used for error handling. When
- * configuration options are being modified, the old values are
- * saved in a Tk_SavedOptions structure. If an error occurs, then the
- * contents of the structure can be used to restore all of the old
- * values. The contents of this structure are for the private use
- * Tk. No-one outside Tk should ever read or write any of the fields
- * of these structures.
- */
- typedef struct Tk_SavedOption {
- struct TkOption *optionPtr; /* Points to information that describes
- * the option. */
- Tcl_Obj *valuePtr; /* The old value of the option, in
- * the form of a Tcl object; may be
- * NULL if the value wasn't saved as
- * an object. */
- double internalForm; /* The old value of the option, in
- * some internal representation such
- * as an int or (XColor *). Valid
- * only if optionPtr->specPtr->objOffset
- * is < 0. The space must be large
- * enough to accommodate a double, a
- * long, or a pointer; right now it
- * looks like a double is big
- * enough. Also, using a double
- * guarantees that the field is
- * properly aligned for storing large
- * values. */
- } Tk_SavedOption;
- #ifdef TCL_MEM_DEBUG
- # define TK_NUM_SAVED_OPTIONS 2
- #else
- # define TK_NUM_SAVED_OPTIONS 20
- #endif
- typedef struct Tk_SavedOptions {
- char *recordPtr; /* The data structure in which to
- * restore configuration options. */
- Tk_Window tkwin; /* Window associated with recordPtr;
- * needed to restore certain options. */
- int numItems; /* The number of valid items in
- * items field. */
- Tk_SavedOption items[TK_NUM_SAVED_OPTIONS];
- /* Items used to hold old values. */
- struct Tk_SavedOptions *nextPtr; /* Points to next structure in list;
- * needed if too many options changed
- * to hold all the old values in a
- * single structure. NULL means no
- * more structures. */
- } Tk_SavedOptions;
- /*
- * Structure used to describe application-specific configuration
- * options: indicates procedures to call to parse an option and
- * to return a text string describing an option. THESE ARE
- * DEPRECATED; PLEASE USE THE NEW STRUCTURES LISTED ABOVE.
- */
- /*
- * This is a temporary flag used while tkObjConfig and new widgets
- * are in development.
- */
- #ifndef __NO_OLD_CONFIG
- typedef int (Tk_OptionParseProc) _ANSI_ARGS_((ClientData clientData,
- Tcl_Interp *interp, Tk_Window tkwin, CONST84 char *value, char *widgRec,
- int offset));
- typedef char *(Tk_OptionPrintProc) _ANSI_ARGS_((ClientData clientData,
- Tk_Window tkwin, char *widgRec, int offset,
- Tcl_FreeProc **freeProcPtr));
- typedef struct Tk_CustomOption {
- Tk_OptionParseProc *parseProc; /* Procedure to call to parse an
- * option and store it in converted
- * form. */
- Tk_OptionPrintProc *printProc; /* Procedure to return a printable
- * string describing an existing
- * option. */
- ClientData clientData; /* Arbitrary one-word value used by
- * option parser: passed to
- * parseProc and printProc. */
- } Tk_CustomOption;
- /*
- * Structure used to specify information for Tk_ConfigureWidget. Each
- * structure gives complete information for one option, including
- * how the option is specified on the command line, where it appears
- * in the option database, etc.
- */
- typedef struct Tk_ConfigSpec {
- int type; /* Type of option, such as TK_CONFIG_COLOR;
- * see definitions below. Last option in
- * table must have type TK_CONFIG_END. */
- char *argvName; /* Switch used to specify option in argv.
- * NULL means this spec is part of a group. */
- Tk_Uid dbName; /* Name for option in option database. */
- Tk_Uid dbClass; /* Class for option in database. */
- Tk_Uid defValue; /* Default value for option if not
- * specified in command line or database. */
- int offset; /* Where in widget record to store value;
- * use Tk_Offset macro to generate values
- * for this. */
- int specFlags; /* Any combination of the values defined
- * below; other bits are used internally
- * by tkConfig.c. */
- Tk_CustomOption *customPtr; /* If type is TK_CONFIG_CUSTOM then this is
- * a pointer to info about how to parse and
- * print the option. Otherwise it is
- * irrelevant. */
- } Tk_ConfigSpec;
- /*
- * Type values for Tk_ConfigSpec structures. See the user
- * documentation for details.
- */
- typedef enum {
- TK_CONFIG_BOOLEAN, TK_CONFIG_INT, TK_CONFIG_DOUBLE, TK_CONFIG_STRING,
- TK_CONFIG_UID, TK_CONFIG_COLOR, TK_CONFIG_FONT, TK_CONFIG_BITMAP,
- TK_CONFIG_BORDER, TK_CONFIG_RELIEF, TK_CONFIG_CURSOR,
- TK_CONFIG_ACTIVE_CURSOR, TK_CONFIG_JUSTIFY, TK_CONFIG_ANCHOR,
- TK_CONFIG_SYNONYM, TK_CONFIG_CAP_STYLE, TK_CONFIG_JOIN_STYLE,
- TK_CONFIG_PIXELS, TK_CONFIG_MM, TK_CONFIG_WINDOW, TK_CONFIG_CUSTOM,
- TK_CONFIG_END
- } Tk_ConfigTypes;
- /*
- * Possible values for flags argument to Tk_ConfigureWidget:
- */
- #define TK_CONFIG_ARGV_ONLY 1
- #define TK_CONFIG_OBJS 0x80
- /*
- * Possible flag values for Tk_ConfigSpec structures. Any bits at
- * or above TK_CONFIG_USER_BIT may be used by clients for selecting
- * certain entries. Before changing any values here, coordinate with
- * tkOldConfig.c (internal-use-only flags are defined there).
- */
- #define TK_CONFIG_NULL_OK (1 << 0)
- #define TK_CONFIG_COLOR_ONLY (1 << 1)
- #define TK_CONFIG_MONO_ONLY (1 << 2)
- #define TK_CONFIG_DONT_SET_DEFAULT (1 << 3)
- #define TK_CONFIG_OPTION_SPECIFIED (1 << 4)
- #define TK_CONFIG_USER_BIT 0x100
- #endif /* __NO_OLD_CONFIG */
- /*
- * Structure used to specify how to handle argv options.
- */
- typedef struct {
- char *key; /* The key string that flags the option in the
- * argv array. */
- int type; /* Indicates option type; see below. */
- char *src; /* Value to be used in setting dst; usage
- * depends on type. */
- char *dst; /* Address of value to be modified; usage
- * depends on type. */
- char *help; /* Documentation message describing this option. */
- } Tk_ArgvInfo;
- /*
- * Legal values for the type field of a Tk_ArgvInfo: see the user
- * documentation for details.
- */
- #define TK_ARGV_CONSTANT 15
- #define TK_ARGV_INT 16
- #define TK_ARGV_STRING 17
- #define TK_ARGV_UID 18
- #define TK_ARGV_REST 19
- #define TK_ARGV_FLOAT 20
- #define TK_ARGV_FUNC 21
- #define TK_ARGV_GENFUNC 22
- #define TK_ARGV_HELP 23
- #define TK_ARGV_CONST_OPTION 24
- #define TK_ARGV_OPTION_VALUE 25
- #define TK_ARGV_OPTION_NAME_VALUE 26
- #define TK_ARGV_END 27
- /*
- * Flag bits for passing to Tk_ParseArgv:
- */
- #define TK_ARGV_NO_DEFAULTS 0x1
- #define TK_ARGV_NO_LEFTOVERS 0x2
- #define TK_ARGV_NO_ABBREV 0x4
- #define TK_ARGV_DONT_SKIP_FIRST_ARG 0x8
- /*
- * Enumerated type for describing actions to be taken in response
- * to a restrictProc established by Tk_RestrictEvents.
- */
- typedef enum {
- TK_DEFER_EVENT, TK_PROCESS_EVENT, TK_DISCARD_EVENT
- } Tk_RestrictAction;
- /*
- * Priority levels to pass to Tk_AddOption:
- */
- #define TK_WIDGET_DEFAULT_PRIO 20
- #define TK_STARTUP_FILE_PRIO 40
- #define TK_USER_DEFAULT_PRIO 60
- #define TK_INTERACTIVE_PRIO 80
- #define TK_MAX_PRIO 100
- /*
- * Relief values returned by Tk_GetRelief:
- */
- #define TK_RELIEF_NULL -1
- #define TK_RELIEF_FLAT 0
- #define TK_RELIEF_GROOVE 1
- #define TK_RELIEF_RAISED 2
- #define TK_RELIEF_RIDGE 3
- #define TK_RELIEF_SOLID 4
- #define TK_RELIEF_SUNKEN 5
- /*
- * "Which" argument values for Tk_3DBorderGC:
- */
- #define TK_3D_FLAT_GC 1
- #define TK_3D_LIGHT_GC 2
- #define TK_3D_DARK_GC 3
- /*
- * Special EnterNotify/LeaveNotify "mode" for use in events
- * generated by tkShare.c. Pick a high enough value that it's
- * unlikely to conflict with existing values (like NotifyNormal)
- * or any new values defined in the future.
- */
- #define TK_NOTIFY_SHARE 20
- /*
- * Enumerated type for describing a point by which to anchor something:
- */
- typedef enum {
- TK_ANCHOR_N, TK_ANCHOR_NE, TK_ANCHOR_E, TK_ANCHOR_SE,
- TK_ANCHOR_S, TK_ANCHOR_SW, TK_ANCHOR_W, TK_ANCHOR_NW,
- TK_ANCHOR_CENTER
- } Tk_Anchor;
- /*
- * Enumerated type for describing a style of justification:
- */
- typedef enum {
- TK_JUSTIFY_LEFT, TK_JUSTIFY_RIGHT, TK_JUSTIFY_CENTER
- } Tk_Justify;
- /*
- * The following structure is used by Tk_GetFontMetrics() to return
- * information about the properties of a Tk_Font.
- */
- typedef struct Tk_FontMetrics {
- int ascent; /* The amount in pixels that the tallest
- * letter sticks up above the baseline, plus
- * any extra blank space added by the designer
- * of the font. */
- int descent; /* The largest amount in pixels that any
- * letter sticks below the baseline, plus any
- * extra blank space added by the designer of
- * the font. */
- int linespace; /* The sum of the ascent and descent. How
- * far apart two lines of text in the same
- * font should be placed so that none of the
- * characters in one line overlap any of the
- * characters in the other line. */
- } Tk_FontMetrics;
- /*
- * Flags passed to Tk_MeasureChars:
- */
- #define TK_WHOLE_WORDS 1
- #define TK_AT_LEAST_ONE 2
- #define TK_PARTIAL_OK 4
- /*
- * Flags passed to Tk_ComputeTextLayout:
- */
- #define TK_IGNORE_TABS 8
- #define TK_IGNORE_NEWLINES 16
- /*
- * Widget class procedures used to implement platform specific widget
- * behavior.
- */
- typedef Window (Tk_ClassCreateProc) _ANSI_ARGS_((Tk_Window tkwin,
- Window parent, ClientData instanceData));
- typedef void (Tk_ClassWorldChangedProc) _ANSI_ARGS_((ClientData instanceData));
- typedef void (Tk_ClassModalProc) _ANSI_ARGS_((Tk_Window tkwin,
- XEvent *eventPtr));
- typedef struct Tk_ClassProcs {
- unsigned int size;
- Tk_ClassWorldChangedProc *worldChangedProc;
- /* Procedure to invoke when the widget needs to
- * respond in some way to a change in the
- * world (font changes, etc.) */
- Tk_ClassCreateProc *createProc;
- /* Procedure to invoke when the
- * platform-dependent window needs to be
- * created. */
- Tk_ClassModalProc *modalProc;
- /* Procedure to invoke after all bindings on a
- * widget have been triggered in order to
- * handle a modal loop. */
- } Tk_ClassProcs;
- /*
- * Simple accessor for Tk_ClassProcs structure. Checks that the structure
- * is not NULL, then checks the size field and returns either the requested
- * field, if present, or NULL if the structure is too small to have the field
- * (or NULL if the structure is NULL).
- *
- * A more general version of this function may be useful if other
- * size-versioned structure pop up in the future:
- *
- * #define Tk_GetField(name, who, which)
- * (((who) == NULL) ? NULL :
- * (((who)->size <= Tk_Offset(name, which)) ? NULL :(name)->which))
- */
- #define Tk_GetClassProc(procs, which)
- (((procs) == NULL) ? NULL :
- (((procs)->size <= Tk_Offset(Tk_ClassProcs, which)) ? NULL:(procs)->which))
- /*
- * Each geometry manager (the packer, the placer, etc.) is represented
- * by a structure of the following form, which indicates procedures
- * to invoke in the geometry manager to carry out certain functions.
- */
- typedef void (Tk_GeomRequestProc) _ANSI_ARGS_((ClientData clientData,
- Tk_Window tkwin));
- typedef void (Tk_GeomLostSlaveProc) _ANSI_ARGS_((ClientData clientData,
- Tk_Window tkwin));
- typedef struct Tk_GeomMgr {
- char *name; /* Name of the geometry manager (command
- * used to invoke it, or name of widget
- * class that allows embedded widgets). */
- Tk_GeomRequestProc *requestProc;
- /* Procedure to invoke when a slave's
- * requested geometry changes. */
- Tk_GeomLostSlaveProc *lostSlaveProc;
- /* Procedure to invoke when a slave is
- * taken away from one geometry manager
- * by another. NULL means geometry manager
- * doesn't care when slaves are lost. */
- } Tk_GeomMgr;
- /*
- * Result values returned by Tk_GetScrollInfo:
- */
- #define TK_SCROLL_MOVETO 1
- #define TK_SCROLL_PAGES 2
- #define TK_SCROLL_UNITS 3
- #define TK_SCROLL_ERROR 4
- /*
- *---------------------------------------------------------------------------
- *
- * Extensions to the X event set
- *
- *---------------------------------------------------------------------------
- */
- #define VirtualEvent (LASTEvent)
- #define ActivateNotify (LASTEvent + 1)
- #define DeactivateNotify (LASTEvent + 2)
- #define MouseWheelEvent (LASTEvent + 3)
- #define TK_LASTEVENT (LASTEvent + 4)
- #define MouseWheelMask (1L << 28)
- #define ActivateMask (1L << 29)
- #define VirtualEventMask (1L << 30)
- #define TK_LASTEVENT (LASTEvent + 4)
- /*
- * A virtual event shares most of its fields with the XKeyEvent and
- * XButtonEvent structures. 99% of the time a virtual event will be
- * an abstraction of a key or button event, so this structure provides
- * the most information to the user. The only difference is the changing
- * of the detail field for a virtual event so that it holds the name of the
- * virtual event being triggered.
- */
- typedef struct {
- int type;
- unsigned long serial; /* # of last request processed by server */
- Bool send_event; /* True if this came from a SendEvent request */
- Display *display; /* Display the event was read from */
- Window event; /* Window on which event was requested. */
- Window root; /* root window that the event occured on */
- Window subwindow; /* child window */
- Time time; /* milliseconds */
- int x, y; /* pointer x, y coordinates in event window */
- int x_root, y_root; /* coordinates relative to root */
- unsigned int state; /* key or button mask */
- Tk_Uid name; /* Name of virtual event. */
- Bool same_screen; /* same screen flag */
- } XVirtualEvent;
- typedef struct {
- int type;
- unsigned long serial; /* # of last request processed by server */
- Bool send_event; /* True if this came from a SendEvent request */
- Display *display; /* Display the event was read from */
- Window window; /* Window in which event occurred. */
- } XActivateDeactivateEvent;
- typedef XActivateDeactivateEvent XActivateEvent;
- typedef XActivateDeactivateEvent XDeactivateEvent;
- /*
- *--------------------------------------------------------------
- *
- * Macros for querying Tk_Window structures. See the
- * manual entries for documentation.
- *
- *--------------------------------------------------------------
- */
- #define Tk_Display(tkwin) (((Tk_FakeWin *) (tkwin))->display)
- #define Tk_ScreenNumber(tkwin) (((Tk_FakeWin *) (tkwin))->screenNum)
- #define Tk_Screen(tkwin) (ScreenOfDisplay(Tk_Display(tkwin),
- Tk_ScreenNumber(tkwin)))
- #define Tk_Depth(tkwin) (((Tk_FakeWin *) (tkwin))->depth)
- #define Tk_Visual(tkwin) (((Tk_FakeWin *) (tkwin))->visual)
- #define Tk_WindowId(tkwin) (((Tk_FakeWin *) (tkwin))->window)
- #define Tk_PathName(tkwin) (((Tk_FakeWin *) (tkwin))->pathName)
- #define Tk_Name(tkwin) (((Tk_FakeWin *) (tkwin))->nameUid)
- #define Tk_Class(tkwin) (((Tk_FakeWin *) (tkwin))->classUid)
- #define Tk_X(tkwin) (((Tk_FakeWin *) (tkwin))->changes.x)
- #define Tk_Y(tkwin) (((Tk_FakeWin *) (tkwin))->changes.y)
- #define Tk_Width(tkwin) (((Tk_FakeWin *) (tkwin))->changes.width)
- #define Tk_Height(tkwin)
- (((Tk_FakeWin *) (tkwin))->changes.height)
- #define Tk_Changes(tkwin) (&((Tk_FakeWin *) (tkwin))->changes)
- #define Tk_Attributes(tkwin) (&((Tk_FakeWin *) (tkwin))->atts)
- #define Tk_IsEmbedded(tkwin)
- (((Tk_FakeWin *) (tkwin))->flags & TK_EMBEDDED)
- #define Tk_IsContainer(tkwin)
- (((Tk_FakeWin *) (tkwin))->flags & TK_CONTAINER)
- #define Tk_IsMapped(tkwin)
- (((Tk_FakeWin *) (tkwin))->flags & TK_MAPPED)
- #define Tk_IsTopLevel(tkwin)
- (((Tk_FakeWin *) (tkwin))->flags & TK_TOP_LEVEL)
- #define Tk_HasWrapper(tkwin)
- (((Tk_FakeWin *) (tkwin))->flags & TK_HAS_WRAPPER)
- #define Tk_WinManaged(tkwin)
- (((Tk_FakeWin *) (tkwin))->flags & TK_WIN_MANAGED)
- #define Tk_TopWinHierarchy(tkwin)
- (((Tk_FakeWin *) (tkwin))->flags & TK_TOP_HIERARCHY)
- #define Tk_ReqWidth(tkwin) (((Tk_FakeWin *) (tkwin))->reqWidth)
- #define Tk_ReqHeight(tkwin) (((Tk_FakeWin *) (tkwin))->reqHeight)
- /* Tk_InternalBorderWidth is deprecated */
- #define Tk_InternalBorderWidth(tkwin)
- (((Tk_FakeWin *) (tkwin))->internalBorderLeft)
- #define Tk_InternalBorderLeft(tkwin)
- (((Tk_FakeWin *) (tkwin))->internalBorderLeft)
- #define Tk_InternalBorderRight(tkwin)
- (((Tk_FakeWin *) (tkwin))->internalBorderRight)
- #define Tk_InternalBorderTop(tkwin)
- (((Tk_FakeWin *) (tkwin))->internalBorderTop)
- #define Tk_InternalBorderBottom(tkwin)
- (((Tk_FakeWin *) (tkwin))->internalBorderBottom)
- #define Tk_MinReqWidth(tkwin) (((Tk_FakeWin *) (tkwin))->minReqWidth)
- #define Tk_MinReqHeight(tkwin) (((Tk_FakeWin *) (tkwin))->minReqHeight)
- #define Tk_Parent(tkwin) (((Tk_FakeWin *) (tkwin))->parentPtr)
- #define Tk_Colormap(tkwin) (((Tk_FakeWin *) (tkwin))->atts.colormap)
- /*
- * The structure below is needed by the macros above so that they can
- * access the fields of a Tk_Window. The fields not needed by the macros
- * are declared as "dummyX". The structure has its own type in order to
- * prevent applications from accessing Tk_Window fields except using
- * official macros. WARNING!! The structure definition must be kept
- * consistent with the TkWindow structure in tkInt.h. If you change one,
- * then change the other. See the declaration in tkInt.h for
- * documentation on what the fields are used for internally.
- */
- typedef struct Tk_FakeWin {
- Display *display;
- char *dummy1; /* dispPtr */
- int screenNum;
- Visual *visual;
- int depth;
- Window window;
- char *dummy2; /* childList */
- char *dummy3; /* lastChildPtr */
- Tk_Window parentPtr; /* parentPtr */
- char *dummy4; /* nextPtr */
- char *dummy5; /* mainPtr */
- char *pathName;
- Tk_Uid nameUid;
- Tk_Uid classUid;
- XWindowChanges changes;
- unsigned int dummy6; /* dirtyChanges */
- XSetWindowAttributes atts;
- unsigned long dummy7; /* dirtyAtts */
- unsigned int flags;
- char *dummy8; /* handlerList */
- #ifdef TK_USE_INPUT_METHODS
- XIC dummy9; /* inputContext */
- #endif /* TK_USE_INPUT_METHODS */
- ClientData *dummy10; /* tagPtr */
- int dummy11; /* numTags */
- int dummy12; /* optionLevel */
- char *dummy13; /* selHandlerList */
- char *dummy14; /* geomMgrPtr */
- ClientData dummy15; /* geomData */
- int reqWidth, reqHeight;
- int internalBorderLeft;
- char *dummy16; /* wmInfoPtr */
- char *dummy17; /* classProcPtr */
- ClientData dummy18; /* instanceData */
- char *dummy19; /* privatePtr */
- int internalBorderRight;
- int internalBorderTop;
- int internalBorderBottom;
- int minReqWidth;
- int minReqHeight;
- } Tk_FakeWin;
- /*
- * Flag values for TkWindow (and Tk_FakeWin) structures are:
- *
- * TK_MAPPED: 1 means window is currently mapped,
- * 0 means unmapped.
- * TK_TOP_LEVEL: 1 means this is a top-level widget.
- * TK_ALREADY_DEAD: 1 means the window is in the process of
- * being destroyed already.
- * TK_NEED_CONFIG_NOTIFY: 1 means that the window has been reconfigured
- * before it was made to exist. At the time of
- * making it exist a ConfigureNotify event needs
- * to be generated.
- * TK_GRAB_FLAG: Used to manage grabs. See tkGrab.c for
- * details.
- * TK_CHECKED_IC: 1 means we've already tried to get an input
- * context for this window; if the ic field
- * is NULL it means that there isn't a context
- * for the field.
- * TK_DONT_DESTROY_WINDOW: 1 means that Tk_DestroyWindow should not
- * invoke XDestroyWindow to destroy this widget's
- * X window. The flag is set when the window
- * has already been destroyed elsewhere (e.g.
- * by another application) or when it will be
- * destroyed later (e.g. by destroying its
- * parent).
- * TK_WM_COLORMAP_WINDOW: 1 means that this window has at some time
- * appeared in the WM_COLORMAP_WINDOWS property
- * for its toplevel, so we have to remove it
- * from that property if the window is
- * deleted and the toplevel isn't.
- * TK_EMBEDDED: 1 means that this window (which must be a
- * toplevel) is not a free-standing window but
- * rather is embedded in some other application.
- * TK_CONTAINER: 1 means that this window is a container, and
- * that some other application (either in
- * this process or elsewhere) may be
- * embedding itself inside the window.
- * TK_BOTH_HALVES: 1 means that this window is used for
- * application embedding (either as
- * container or embedded application), and
- * both the containing and embedded halves
- * are associated with windows in this
- * particular process.
- * TK_DEFER_MODAL: 1 means that this window has deferred a modal
- * loop until all of the bindings for the current
- * event have been invoked.
- * TK_WRAPPER: 1 means that this window is the extra
- * wrapper window created around a toplevel
- * to hold the menubar under Unix. See
- * tkUnixWm.c for more information.
- * TK_REPARENTED: 1 means that this window has been reparented
- * so that as far as the window system is
- * concerned it isn't a child of its Tk
- * parent. Initially this is used only for
- * special Unix menubar windows.
- * TK_ANONYMOUS_WINDOW: 1 means that this window has no name, and is
- * thus not accessible from Tk.
- * TK_HAS_WRAPPER 1 means that this window has a wrapper window
- * TK_WIN_MANAGED 1 means that this window is a child of the
- * root window, and is managed by the window
- * manager.
- * TK_TOP_HIERARCHY 1 means this window is at the top of a
- * physical window hierarchy within this
- * process, i.e. the window's parent
- * either doesn't exist or is not owned by
- * this Tk application.
- * TK_PROP_PROPCHANGE 1 means that PropertyNotify events in
- * this window's children should propagate
- * up to this window.
- */
- #define TK_MAPPED 1
- #define TK_TOP_LEVEL 2
- #define TK_ALREADY_DEAD 4
- #define TK_NEED_CONFIG_NOTIFY 8
- #define TK_GRAB_FLAG 0x10
- #define TK_CHECKED_IC 0x20
- #define TK_DONT_DESTROY_WINDOW 0x40
- #define TK_WM_COLORMAP_WINDOW 0x80
- #define TK_EMBEDDED 0x100
- #define TK_CONTAINER 0x200
- #define TK_BOTH_HALVES 0x400
- #define TK_DEFER_MODAL 0x800
- #define TK_WRAPPER 0x1000
- #define TK_REPARENTED 0x2000
- #define TK_ANONYMOUS_WINDOW 0x4000
- #define TK_HAS_WRAPPER 0x8000
- #define TK_WIN_MANAGED 0x10000
- #define TK_TOP_HIERARCHY 0x20000
- #define TK_PROP_PROPCHANGE 0x40000
- /*
- *--------------------------------------------------------------
- *
- * Procedure prototypes and structures used for defining new canvas
- * items:
- *
- *--------------------------------------------------------------
- */
- typedef enum {
- TK_STATE_NULL = -1, TK_STATE_ACTIVE, TK_STATE_DISABLED,
- TK_STATE_NORMAL, TK_STATE_HIDDEN
- } Tk_State;
- typedef struct Tk_SmoothMethod {
- char *name;
- int (*coordProc) _ANSI_ARGS_((Tk_Canvas canvas,
- double *pointPtr, int numPoints, int numSteps,
- XPoint xPoints[], double dblPoints[]));
- void (*postscriptProc) _ANSI_ARGS_((Tcl_Interp *interp,
- Tk_Canvas canvas, double *coordPtr,
- int numPoints, int numSteps));
- } Tk_SmoothMethod;
- /*
- * For each item in a canvas widget there exists one record with
- * the following structure. Each actual item is represented by
- * a record with the following stuff at its beginning, plus additional
- * type-specific stuff after that.
- */
- #define TK_TAG_SPACE 3
- typedef struct Tk_Item {
- int id; /* Unique identifier for this item
- * (also serves as first tag for
- * item). */
- struct Tk_Item *nextPtr; /* Next in display list of all
- * items in this canvas. Later items
- * in list are drawn on top of earlier
- * ones. */
- Tk_Uid staticTagSpace[TK_TAG_SPACE];/* Built-in space for limited # of
- * tags. */
- Tk_Uid *tagPtr; /* Pointer to array of tags. Usually
- * points to staticTagSpace, but
- * may point to malloc-ed space if
- * there are lots of tags. */
- int tagSpace; /* Total amount of tag space available
- * at tagPtr. */
- int numTags; /* Number of tag slots actually used
- * at *tagPtr. */
- struct Tk_ItemType *typePtr; /* Table of procedures that implement
- * this type of item. */
- int x1, y1, x2, y2; /* Bounding box for item, in integer
- * canvas units. Set by item-specific
- * code and guaranteed to contain every
- * pixel drawn in item. Item area
- * includes x1 and y1 but not x2
- * and y2. */
- struct Tk_Item *prevPtr; /* Previous in display list of all
- * items in this canvas. Later items
- * in list are drawn just below earlier
- * ones. */
- Tk_State state; /* state of item */
- char *reserved1; /* reserved for future use */
- int redraw_flags; /* some flags used in the canvas */
- /*
- *------------------------------------------------------------------
- * Starting here is additional type-specific stuff; see the
- * declarations for individual types to see what is part of
- * each type. The actual space below is determined by the
- * "itemInfoSize" of the type's Tk_ItemType record.
- *------------------------------------------------------------------
- */
- } Tk_Item;
- /*
- * Flag bits for canvases (redraw_flags):
- *
- * TK_ITEM_STATE_DEPENDANT - 1 means that object needs to be
- * redrawn if the canvas state changes.
- * TK_ITEM_DONT_REDRAW - 1 means that the object redraw is already
- * been prepared, so the general canvas code
- * doesn't need to do that any more.
- */
- #define TK_ITEM_STATE_DEPENDANT 1
- #define TK_ITEM_DONT_REDRAW 2
- /*
- * Records of the following type are used to describe a type of
- * item (e.g. lines, circles, etc.) that can form part of a
- * canvas widget.
- */
- #ifdef USE_OLD_CANVAS
- typedef int Tk_ItemCreateProc _ANSI_ARGS_((Tcl_Interp *interp,
- Tk_Canvas canvas, Tk_Item *itemPtr, int argc,
- char **argv));
- typedef int Tk_ItemConfigureProc _ANSI_ARGS_((Tcl_Interp *interp,
- Tk_Canvas canvas, Tk_Item *itemPtr, int argc,
- char **argv, int flags));
- typedef int Tk_ItemCoordProc _ANSI_ARGS_((Tcl_Interp *interp,
- Tk_Canvas canvas, Tk_Item *itemPtr, int argc,
- char **argv));
- #else
- typedef int Tk_ItemCreateProc _ANSI_ARGS_((Tcl_Interp *interp,
- Tk_Canvas canvas, Tk_Item *itemPtr, int argc,
- Tcl_Obj *CONST objv[]));
- typedef int Tk_ItemConfigureProc _ANSI_ARGS_((Tcl_Interp *interp,
- Tk_Canvas canvas, Tk_Item *itemPtr, int argc,
- Tcl_Obj *CONST objv[], int flags));
- typedef int Tk_ItemCoordProc _ANSI_ARGS_((Tcl_Interp *interp,
- Tk_Canvas canvas, Tk_Item *itemPtr, int argc,
- Tcl_Obj *CONST argv[]));
- #endif
- typedef void Tk_ItemDeleteProc _ANSI_ARGS_((Tk_Canvas canvas,
- Tk_Item *itemPtr, Display *display));
- typedef void Tk_ItemDisplayProc _ANSI_ARGS_((Tk_Canvas canvas,
- Tk_Item *itemPtr, Display *display, Drawable dst,
- int x, int y, int width, int height));
- typedef double Tk_ItemPointProc _ANSI_ARGS_((Tk_Canvas canvas,
- Tk_Item *itemPtr, double *pointPtr));
- typedef int Tk_ItemAreaProc _ANSI_ARGS_((Tk_Canvas canvas,
- Tk_Item *itemPtr, double *rectPtr));
- typedef int Tk_ItemPostscriptProc _ANSI_ARGS_((Tcl_Interp *interp,
- Tk_Canvas canvas, Tk_Item *itemPtr, int prepass));
- typedef void Tk_ItemScaleProc _ANSI_ARGS_((Tk_Canvas canvas,
- Tk_Item *itemPtr, double originX, double originY,
- double scaleX, double scaleY));
- typedef void Tk_ItemTranslateProc _ANSI_ARGS_((Tk_Canvas canvas,
- Tk_Item *itemPtr, double deltaX, double deltaY));
- typedef int Tk_ItemIndexProc _ANSI_ARGS_((Tcl_Interp *interp,
- Tk_Canvas canvas, Tk_Item *itemPtr, char *indexString,
- int *indexPtr));
- typedef void Tk_ItemCursorProc _ANSI_ARGS_((Tk_Canvas canvas,
- Tk_Item *itemPtr, int index));
- typedef int Tk_ItemSelectionProc _ANSI_ARGS_((Tk_Canvas canvas,
- Tk_Item *itemPtr, int offset, char *buffer,
- int maxBytes));
- typedef void Tk_ItemInsertProc _ANSI_ARGS_((Tk_Canvas canvas,
- Tk_Item *itemPtr, int beforeThis, char *string));
- typedef void Tk_ItemDCharsProc _ANSI_ARGS_((Tk_Canvas canvas,
- Tk_Item *itemPtr, int first, int last));
- #ifndef __NO_OLD_CONFIG
- typedef struct Tk_ItemType {
- char *name; /* The name of this type of item, such
- * as "line". */
- int itemSize; /* Total amount of space needed for
- * item's record. */
- Tk_ItemCreateProc *createProc; /* Procedure to create a new item of
- * this type. */
- Tk_ConfigSpec *configSpecs; /* Pointer to array of configuration
- * specs for this type. Used for
- * returning configuration info. */
- Tk_ItemConfigureProc *configProc; /* Procedure to call to change
- * configuration options. */
- Tk_ItemCoordProc *coordProc; /* Procedure to call to get and set
- * the item's coordinates. */
- Tk_ItemDeleteProc *deleteProc; /* Procedure to delete existing item of
- * this type. */
- Tk_ItemDisplayProc *displayProc; /* Procedure to display items of
- * this type. */
- int alwaysRedraw; /* Non-zero means displayProc should
- * be called even when the item has
- * been moved off-screen. */
- Tk_ItemPointProc *pointProc; /* Computes distance from item to
- * a given point. */
- Tk_ItemAreaProc *areaProc; /* Computes whether item is inside,
- * outside, or overlapping an area. */
- Tk_ItemPostscriptProc *postscriptProc;
- /* Procedure to write a Postscript
- * description for items of this
- * type. */
- Tk_ItemScaleProc *scaleProc; /* Procedure to rescale items of
- * this type. */
- Tk_ItemTranslateProc *translateProc;/* Procedure to translate items of
- * this type. */
- Tk_ItemIndexProc *indexProc; /* Procedure to determine index of
- * indicated character. NULL if
- * item doesn't support indexing. */
- Tk_ItemCursorProc *icursorProc; /* Procedure to set insert cursor pos.
- * to just before a given position. */
- Tk_ItemSelectionProc *selectionProc;/* Procedure to return selection (in
- * STRING format) when it is in this
- * item. */
- Tk_ItemInsertProc *insertProc; /* Procedure to insert something into
- * an item. */
- Tk_ItemDCharsProc *dCharsProc; /* Procedure to delete characters
- * from an item. */
- struct Tk_ItemType *nextPtr; /* Used to link types together into
- * a list. */
- char *reserved1; /* Reserved for future extension. */
- int reserved2; /* Carefully compatible with */
- char *reserved3; /* Jan Nijtmans dash patch */
- char *reserved4;
- } Tk_ItemType;
- #endif
- /*
- * The following structure provides information about the selection and
- * the insertion cursor. It is needed by only a few items, such as
- * those that display text. It is shared by the generic canvas code
- * and the item-specific code, but most of the fields should be written
- * only by the canvas generic code.
- */
- typedef struct Tk_CanvasTextInfo {
- Tk_3DBorder selBorder; /* Border and background for selected
- * characters. Read-only to items.*/
- int selBorderWidth; /* Width of border around selection.
- * Read-only to items. */
- XColor *selFgColorPtr; /* Foreground color for selected text.
- * Read-only to items. */
- Tk_Item *selItemPtr; /* Pointer to selected item. NULL means
- * selection isn't in this canvas.
- * Writable by items. */
- int selectFirst; /* Character index of first selected
- * character. Writable by items. */
- int selectLast; /* Character index of last selected
- * character. Writable by items. */
- Tk_Item *anchorItemPtr; /* Item corresponding to "selectAnchor":
- * not necessarily selItemPtr. Read-only
- * to items. */
- int selectAnchor; /* Character index of fixed end of
- * selection (i.e. "select to" operation will
- * use this as one end of the selection).
- * Writable by items. */
- Tk_3DBorder insertBorder; /* Used to draw vertical bar for insertion
- * cursor. Read-only to items. */
- int insertWidth; /* Total width of insertion cursor. Read-only
- * to items. */
- int insertBorderWidth; /* Width of 3-D border around insert cursor.
- * Read-only to items. */
- Tk_Item *focusItemPtr; /* Item that currently has the input focus,
- * or NULL if no such item. Read-only to
- * items. */
- int gotFocus; /* Non-zero means that the canvas widget has
- * the input focus. Read-only to items.*/
- int cursorOn; /* Non-zero means that an insertion cursor
- * should be displayed in focusItemPtr.
- * Read-only to items.*/
- } Tk_CanvasTextInfo;
- /*
- * Structures used for Dashing and Outline.
- */
- typedef struct Tk_Dash {
- int number;
- union {
- char *pt;
- char array[sizeof(char *)];
- } pattern;
- } Tk_Dash;
- typedef struct Tk_TSOffset {
- int flags; /* flags; see below for possible values */
- int xoffset; /* x offset */
- int yoffset; /* y offset */
- } Tk_TSOffset;
- /*
- * Bit fields in Tk_Offset->flags:
- */
- #define TK_OFFSET_INDEX 1
- #define TK_OFFSET_RELATIVE 2
- #define TK_OFFSET_LEFT 4
- #define TK_OFFSET_CENTER 8
- #define TK_OFFSET_RIGHT 16
- #define TK_OFFSET_TOP 32
- #define TK_OFFSET_MIDDLE 64
- #define TK_OFFSET_BOTTOM 128
- typedef struct Tk_Outline {
- GC gc; /* Graphics context. */
- double width; /* Width of outline. */
- double activeWidth; /* Width of outline. */
- double disabledWidth; /* Width of outline. */
- int offset; /* Dash offset */
- Tk_Dash dash; /* Dash pattern */
- Tk_Dash activeDash; /* Dash pattern if state is active*/
- Tk_Dash disabledDash; /* Dash pattern if state is disabled*/
- VOID *reserved1; /* reserved for future expansion */
- VOID *reserved2;
- VOID *reserved3;
- Tk_TSOffset tsoffset; /* stipple offset for outline*/
- XColor *color; /* Outline color. */
- XColor *activeColor; /* Outline color if state is active. */
- XColor *disabledColor; /* Outline color if state is disabled. */
- Pixmap stipple; /* Outline Stipple pattern. */
- Pixmap activeStipple; /* Outline Stipple pattern if state is active. */
- Pixmap disabledStipple; /* Outline Stipple pattern if state is disabled. */
- } Tk_Outline;
- /*
- *--------------------------------------------------------------
- *
- * Procedure prototypes and structures used for managing images:
- *
- *--------------------------------------------------------------
- */
- typedef struct Tk_ImageType Tk_ImageType;
- #ifdef USE_OLD_IMAGE
- typedef int (Tk_ImageCreateProc) _ANSI_ARGS_((Tcl_Interp *interp,
- char *name, int argc, char **argv, Tk_ImageType *typePtr,
- Tk_ImageMaster master, ClientData *masterDataPtr));
- #else
- typedef int (Tk_ImageCreateProc) _ANSI_ARGS_((Tcl_Interp *interp,
- char *name, int objc, Tcl_Obj *CONST objv[], Tk_ImageType *typePtr,
- Tk_ImageMaster master, ClientData *masterDataPtr));
- #endif
- typedef ClientData (Tk_ImageGetProc) _ANSI_ARGS_((Tk_Window tkwin,
- ClientData masterData));
- typedef void (Tk_ImageDisplayProc) _ANSI_ARGS_((ClientData instanceData,
- Display *display, Drawable drawable, int imageX, int imageY,
- int width, int height, int drawableX, int drawableY));
- typedef void (Tk_ImageFreeProc) _ANSI_ARGS_((ClientData instanceData,
- Display *display));
- typedef void (Tk_ImageDeleteProc) _ANSI_ARGS_((ClientData masterData));
- typedef void (Tk_ImageChangedProc) _ANSI_ARGS_((ClientData clientData,
- int x, int y, int width, int height, int imageWidth,
- int imageHeight));
- typedef int (Tk_ImagePostscriptProc) _ANSI_ARGS_((ClientData clientData,
- Tcl_Interp *interp, Tk_Window tkwin, Tk_PostscriptInfo psinfo,
- int x, int y, int width, int height, int prepass));
- /*
- * The following structure represents a particular type of image
- * (bitmap, xpm image, etc.). It provides information common to
- * all images of that type, such as the type name and a collection
- * of procedures in the image manager that respond to various
- * events. Each image manager is represented by one of these
- * structures.
- */
- struct Tk_ImageType {
- char *name; /* Name of image type. */
- Tk_ImageCreateProc *createProc;
- /* Procedure to call to create a new image
- * of this type. */
- Tk_ImageGetProc *getProc; /* Procedure to call the first time
- * Tk_GetImage is called in a new way
- * (new visual or screen). */
- Tk_ImageDisplayProc *displayProc;
- /* Call to draw image, in response to
- * Tk_RedrawImage calls. */
- Tk_ImageFreeProc *freeProc; /* Procedure to call whenever Tk_FreeImage
- * is called to release an instance of an
- * image. */
- Tk_ImageDeleteProc *deleteProc;
- /* Procedure to call to delete image. It
- * will not be called until after freeProc
- * has been called for each instance of the
- * image. */
- Tk_ImagePostscriptProc *postscriptProc;
- /* Procedure to call to produce postscript
- * output for the image. */
- struct Tk_ImageType *nextPtr;
- /* Next in list of all image types currently
- * known. Filled in by Tk, not by image
- * manager. */
- char *reserved; /* reserved for future expansion */
- };
- /*
- *--------------------------------------------------------------
- *
- * Additional definitions used to manage images of type "photo".
- *
- *--------------------------------------------------------------
- */
- /*
- * The following type is used to identify a particular photo image
- * to be manipulated:
- */
- typedef void *Tk_PhotoHandle;
- /*
- * The following structure describes a block of pixels in memory:
- */
- typedef struct Tk_PhotoImageBlock {
- unsigned char *pixelPtr; /* Pointer to the first pixel. */
- int width; /* Width of block, in pixels. */
- int height; /* Height of block, in pixels. */
- int pitch; /* Address difference between corresponding
- * pixels in successive lines. */
- int pixelSize; /* Address difference between successive
- * pixels in the same line. */
- int offset[4]; /* Address differences between the red, green,
- * blue and alpha components of the pixel and
- * the pixel as a whole. */
- } Tk_PhotoImageBlock;
- /*
- * The following values control how blocks are combined into photo
- * images when the alpha component of a pixel is not 255, a.k.a. the
- * compositing rule.
- */
- #define TK_PHOTO_COMPOSITE_OVERLAY 0
- #define TK_PHOTO_COMPOSITE_SET 1
- /*
- * Procedure prototypes and structures used in reading and
- * writing photo images:
- */
- typedef struct Tk_PhotoImageFormat Tk_PhotoImageFormat;
- #ifdef USE_OLD_IMAGE
- typedef int (Tk_ImageFileMatchProc) _ANSI_ARGS_((Tcl_Channel chan,
- char *fileName, char *formatString, int *widthPtr, int *heightPtr));
- typedef int (Tk_ImageStringMatchProc) _ANSI_ARGS_((char *string,
- char *formatString, int *widthPtr, int *heightPtr));
- typedef int (Tk_ImageFileReadProc) _ANSI_ARGS_((Tcl_Interp *interp,
- Tcl_Channel chan, char *fileName, char *formatString,
- Tk_PhotoHandle imageHandle, int destX, int destY,
- int width, int height, int srcX, int srcY));
- typedef int (Tk_ImageStringReadProc) _ANSI_ARGS_((Tcl_Interp *interp,
- char *string, char *formatString, Tk_PhotoHandle imageHandle,
- int destX, int destY, int width, int height, int srcX, int srcY));
- typedef int (Tk_ImageFileWriteProc) _ANSI_ARGS_((Tcl_Interp *interp,
- char *fileName, char *formatString, Tk_PhotoImageBlock *blockPtr));
- typedef int (Tk_ImageStringWriteProc) _ANSI_ARGS_((Tcl_Interp *interp,
- Tcl_DString *dataPtr, char *formatString,
- Tk_PhotoImageBlock *blockPtr));
- #else
- typedef int (Tk_ImageFileMatchProc) _ANSI_ARGS_((Tcl_Channel chan,
- CONST char *fileName, Tcl_Obj *format, int *widthPtr,
- int *heightPtr, Tcl_Interp *interp));
- typedef int (Tk_ImageStringMatchProc) _ANSI_ARGS_((Tcl_Obj *dataObj,
- Tcl_Obj *format, int *widthPtr, int *heightPtr,
- Tcl_Interp *interp));
- typedef int (Tk_ImageFileReadProc) _ANSI_ARGS_((Tcl_Interp *interp,
- Tcl_Channel chan, CONST char *fileName, Tcl_Obj *format,
- Tk_PhotoHandle imageHandle, int destX, int destY,
- int width, int height, int srcX, int srcY));
- typedef int (Tk_ImageStringReadProc) _ANSI_ARGS_((Tcl_Interp *interp,
- Tcl_Obj *dataObj, Tcl_Obj *format, Tk_PhotoHandle imageHandle,
- int destX, int destY, int width, int height, int srcX, int srcY));
- typedef int (Tk_ImageFileWriteProc) _ANSI_ARGS_((Tcl_Interp *interp,
- CONST char *fileName, Tcl_Obj *format, Tk_PhotoImageBlock *blockPtr));
- typedef int (Tk_ImageStringWriteProc) _ANSI_ARGS_((Tcl_Interp *interp,
- Tcl_Obj *format, Tk_PhotoImageBlock *blockPtr));
- #endif
- /*
- * The following structure represents a particular file format for
- * storing images (e.g., PPM, GIF, JPEG, etc.). It provides information
- * to allow image files of that format to be recognized and read into
- * a photo image.
- */
- struct Tk_PhotoImageFormat {
- char *name; /* Name of image file format */
- Tk_ImageFileMatchProc *fileMatchProc;
- /* Procedure to call to determine whether
- * an image file matches this format. */
- Tk_ImageStringMatchProc *stringMatchProc;
- /* Procedure to call to determine whether
- * the data in a string matches this format. */
- Tk_ImageFileReadProc *fileReadProc;
- /* Procedure to call to read data from
- * an image file into a photo image. */
- Tk_ImageStringReadProc *stringReadProc;
- /* Procedure to call to read data from
- * a string into a photo image. */
- Tk_ImageFileWriteProc *fileWriteProc;
- /* Procedure to call to write data from
- * a photo image to a file. */
- Tk_ImageStringWriteProc *stringWriteProc;
- /* Procedure to call to obtain a string
- * representation of the data in a photo
- * image.*/
- struct Tk_PhotoImageFormat *nextPtr;
- /* Next in list of all photo image formats
- * currently known. Filled in by Tk, not
- * by image format handler. */
- };
- EXTERN void Tk_CreateOldImageType _ANSI_ARGS_((
- Tk_ImageType *typePtr));
- EXTERN void Tk_CreateOldPhotoImageFormat _ANSI_ARGS_((
- Tk_PhotoImageFormat *formatPtr));
- #if !defined(USE_TK_STUBS) && defined(USE_OLD_IMAGE)
- #define Tk_CreateImageType Tk_CreateOldImageType
- #define Tk_CreatePhotoImageFormat Tk_CreateOldPhotoImageFormat
- #endif
- /*
- *--------------------------------------------------------------
- *
- * Procedure prototypes and structures used for managing styles:
- *
- *--------------------------------------------------------------
- */
- /*
- * Style support version tag.
- */
- #define TK_STYLE_VERSION_1 0x1
- #define TK_STYLE_VERSION TK_STYLE_VERSION_1
- /*
- * The following structures and prototypes are used as static templates to
- * declare widget elements.
- */
- typedef void (Tk_GetElementSizeProc) _ANSI_ARGS_((ClientData clientData,
- char *recordPtr, CONST Tk_OptionSpec **optionsPtr, Tk_Window tkwin,
- int width, int height, int inner, int *widthPtr, int *heightPtr));
- typedef void (Tk_GetElementBoxProc) _ANSI_ARGS_((ClientData clientData,
- char *recordPtr, CONST Tk_OptionSpec **optionsPtr, Tk_Window tkwin,
- int x, int y, int width, int height, int inner, int *xPtr, int *yPtr,
- int *widthPtr, int *heightPtr));
- typedef int (Tk_GetElementBorderWidthProc) _ANSI_ARGS_((ClientData clientData,
- char *recordPtr, CONST Tk_OptionSpec **optionsPtr, Tk_Window tkwin));
- typedef void (Tk_DrawElementProc) _ANSI_ARGS_((ClientData clientData,
- char *recordPtr, CONST Tk_OptionSpec **optionsPtr, Tk_Window tkwin,
- Drawable d, int x, int y, int width, int height, int state));
- typedef struct Tk_ElementOptionSpec {
- char *name; /* Name of the required option. */
- Tk_OptionType type; /* Accepted option type. TK_OPTION_END means
- * any. */
- } Tk_ElementOptionSpec;
- typedef struct Tk_ElementSpec {
- int version; /* Version of the style support. */
- char *name; /* Name of element. */
- Tk_ElementOptionSpec *options;
- /* List of required options. Last one's name
- * must be NULL. */
- /*
- * Hooks
- */
- Tk_GetElementSizeProc *getSize;
- /* Compute the external (resp. internal) size of
- * the element from its desired internal (resp.
- * external) size. */
- Tk_GetElementBoxProc *getBox;
- /* Compute the inscribed or bounding boxes
- * within a given area. */
- Tk_GetElementBorderWidthProc *getBorderWidth;
- /* Return the element's internal border width.
- * Mostly useful for widgets. */
- Tk_DrawElementProc *draw; /* Draw the element in the given bounding box.*/
- } Tk_ElementSpec;
- /*
- * Element state flags. Can be OR'ed.
- */
- #define TK_ELEMENT_STATE_ACTIVE 1<<0
- #define TK_ELEMENT_STATE_DISABLED 1<<1
- #define TK_ELEMENT_STATE_FOCUS 1<<2
- #define TK_ELEMENT_STATE_PRESSED 1<<3
- /*
- *--------------------------------------------------------------
- *
- * The definitions below provide backward compatibility for
- * functions and types related to event handling that used to
- * be in Tk but have moved to Tcl.
- *
- *--------------------------------------------------------------
- */
- #define TK_READABLE TCL_READABLE
- #define TK_WRITABLE TCL_WRITABLE
- #define TK_EXCEPTION TCL_EXCEPTION
- #define TK_DONT_WAIT TCL_DONT_WAIT
- #define TK_X_EVENTS TCL_WINDOW_EVENTS
- #define TK_WINDOW_EVENTS TCL_WINDOW_EVENTS
- #define TK_FILE_EVENTS TCL_FILE_EVENTS
- #define TK_TIMER_EVENTS TCL_TIMER_EVENTS
- #define TK_IDLE_EVENTS TCL_IDLE_EVENTS
- #define TK_ALL_EVENTS TCL_ALL_EVENTS
- #define Tk_IdleProc Tcl_IdleProc
- #define Tk_FileProc Tcl_FileProc
- #define Tk_TimerProc Tcl_TimerProc
- #define Tk_TimerToken Tcl_TimerToken
- #define Tk_BackgroundError Tcl_BackgroundError
- #define Tk_CancelIdleCall Tcl_CancelIdleCall
- #define Tk_CreateFileHandler Tcl_CreateFileHandler
- #define Tk_CreateTimerHandler Tcl_CreateTimerHandler
- #define Tk_DeleteFileHandler Tcl_DeleteFileHandler
- #define Tk_DeleteTimerHandler Tcl_DeleteTimerHandler
- #define Tk_DoOneEvent Tcl_DoOneEvent
- #define Tk_DoWhenIdle Tcl_DoWhenIdle
- #define Tk_Sleep Tcl_Sleep
- /* Additional stuff that has moved to Tcl: */
- #define Tk_EventuallyFree Tcl_EventuallyFree
- #define Tk_FreeProc Tcl_FreeProc
- #define Tk_Preserve Tcl_Preserve
- #define Tk_Release Tcl_Release
- /* Removed Tk_Main, use macro instead */
- #define Tk_Main(argc, argv, proc)
- Tk_MainEx(argc, argv, proc, Tcl_CreateInterp())
- CONST char *Tk_InitStubs _ANSI_ARGS_((Tcl_Interp *interp, char *version, int exact));
- #ifndef USE_TK_STUBS
- #define Tk_InitStubs(interp, version, exact)
- Tcl_PkgRequire(interp, "Tk", version, exact)
- #endif
- void Tk_InitImageArgs _ANSI_ARGS_((Tcl_Interp *interp, int argc, char ***argv));
- #if !defined(USE_TK_STUBS) || !defined(USE_OLD_IMAGE)
- #define Tk_InitImageArgs(interp, argc, argv) /**/
- #endif
- /*
- *--------------------------------------------------------------
- *
- * Additional procedure types defined by Tk.
- *
- *--------------------------------------------------------------
- */
- typedef int (Tk_ErrorProc) _ANSI_ARGS_((ClientData clientData,
- XErrorEvent *errEventPtr));
- typedef void (Tk_EventProc) _ANSI_ARGS_((ClientData clientData,
- XEvent *eventPtr));
- typedef int (Tk_GenericProc) _ANSI_ARGS_((ClientData clientData,
- XEvent *eventPtr));
- typedef int (Tk_ClientMessageProc) _ANSI_ARGS_((Tk_Window tkwin,
- XEvent *eventPtr));
- typedef int (Tk_GetSelProc) _ANSI_ARGS_((ClientData clientData,
- Tcl_Interp *interp, char *portion));
- typedef void (Tk_LostSelProc) _ANSI_ARGS_((ClientData clientData));
- typedef Tk_RestrictAction (Tk_RestrictProc) _ANSI_ARGS_((
- ClientData clientData, XEvent *eventPtr));
- typedef int (Tk_SelectionProc) _ANSI_ARGS_((ClientData clientData,
- int offset, char *buffer, int maxBytes));
- /*
- *--------------------------------------------------------------
- *
- * Platform independant exported procedures and variables.
- *
- *--------------------------------------------------------------
- */
- #include "tkDecls.h"
- /*
- * Allow users to say that they don't want to alter their source to
- * add the extra argument to Tk_PhotoPutBlock(); DO NOT DEFINE THIS
- * WHEN BUILDING TK.
- *
- * This goes after the inclusion of the stubbed-decls so that the
- * declarations of what is actually there can be correct.
- */
- #ifdef USE_COMPOSITELESS_PHOTO_PUT_BLOCK
- # ifdef Tk_PhotoPutBlock
- # undef Tk_PhotoPutBlock
- # endif
- # define Tk_PhotoPutBlock Tk_PhotoPutBlock_NoComposite
- # ifdef Tk_PhotoPutZoomedBlock
- # undef Tk_PhotoPutZoomedBlock
- # endif
- # define Tk_PhotoPutZoomedBlock Tk_PhotoPutZoomedBlock_NoComposite
- #endif /* USE_COMPOSITELESS_PHOTO_PUT_BLOCK */
- /*
- * Tcl commands exported by Tk:
- */
- #undef TCL_STORAGE_CLASS
- #define TCL_STORAGE_CLASS DLLIMPORT
- #endif /* RC_INVOKED */
- /*
- * end block for C++
- */
-
- #ifdef __cplusplus
- }
- #endif
-
- #endif /* _TK */