1996-09-27 06:29:02 -04:00
|
|
|
|
/*
|
|
|
|
|
* 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.
|
1998-04-10 06:59:06 -04:00
|
|
|
|
* Copyright (c) 1994-1997 Sun Microsystems, Inc.
|
1996-09-27 06:29:02 -04:00
|
|
|
|
*
|
|
|
|
|
* See the file "license.terms" for information on usage and redistribution
|
|
|
|
|
* of this file, and for a DISCLAIMER OF ALL WARRANTIES.
|
|
|
|
|
*
|
1998-09-30 07:11:02 -04:00
|
|
|
|
* SCCS: @(#) tk.h 1.211 97/11/20 12:44:45
|
1996-09-27 06:29:02 -04:00
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#ifndef _TK
|
|
|
|
|
#define _TK
|
|
|
|
|
|
1998-04-10 06:59:06 -04:00
|
|
|
|
/*
|
|
|
|
|
* When version numbers change here, you must also go into the following files
|
|
|
|
|
* and update the version numbers:
|
|
|
|
|
*
|
1998-09-30 07:11:02 -04:00
|
|
|
|
* README
|
1998-04-10 06:59:06 -04:00
|
|
|
|
* unix/configure.in
|
1998-09-30 07:11:02 -04:00
|
|
|
|
* win/makefile.bc (Not for patch release updates)
|
|
|
|
|
* win/makefile.vc (Not for patch release updates)
|
1998-04-10 06:59:06 -04:00
|
|
|
|
* library/tk.tcl
|
|
|
|
|
*
|
|
|
|
|
* The release level should be 0 for alpha, 1 for beta, and 2 for
|
|
|
|
|
* final/patch. The release serial value is the number that follows the
|
|
|
|
|
* "a", "b", or "p" in the patch level; for example, if the patch level
|
|
|
|
|
* is 4.3b2, TK_RELEASE_SERIAL is 2. It restarts at 1 whenever the
|
|
|
|
|
* release level is changed, except for the final release, which should
|
|
|
|
|
* be 0.
|
|
|
|
|
*
|
|
|
|
|
* 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 0
|
|
|
|
|
#define TK_RELEASE_LEVEL 2
|
1998-09-30 07:11:02 -04:00
|
|
|
|
#define TK_RELEASE_SERIAL 3
|
1998-04-10 06:59:06 -04:00
|
|
|
|
|
|
|
|
|
#define TK_VERSION "8.0"
|
1998-09-30 07:11:02 -04:00
|
|
|
|
#define TK_PATCH_LEVEL "8.0.3"
|
1998-04-10 06:59:06 -04:00
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* A special definition used to allow this header file to be included
|
|
|
|
|
* in resource files.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#ifndef RESOURCE_INCLUDED
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* The following definitions set up the proper options for Macintosh
|
|
|
|
|
* compilers. We use this method because there is no autoconf equivalent.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#ifdef MAC_TCL
|
|
|
|
|
# ifndef REDO_KEYSYM_LOOKUP
|
|
|
|
|
# define REDO_KEYSYM_LOOKUP
|
|
|
|
|
# endif
|
|
|
|
|
#endif
|
1996-09-27 06:29:02 -04:00
|
|
|
|
|
|
|
|
|
#ifndef _TCL
|
1998-04-10 06:59:06 -04:00
|
|
|
|
# include <tcl.h>
|
1996-09-27 06:29:02 -04:00
|
|
|
|
#endif
|
|
|
|
|
#ifndef _XLIB_H
|
1998-04-10 06:59:06 -04:00
|
|
|
|
# ifdef MAC_TCL
|
|
|
|
|
# include <Xlib.h>
|
|
|
|
|
# include <X.h>
|
|
|
|
|
# else
|
|
|
|
|
# include <X11/Xlib.h>
|
|
|
|
|
# endif
|
1996-09-27 06:29:02 -04:00
|
|
|
|
#endif
|
|
|
|
|
#ifdef __STDC__
|
1998-04-10 06:59:06 -04:00
|
|
|
|
# include <stddef.h>
|
1996-09-27 06:29:02 -04:00
|
|
|
|
#endif
|
|
|
|
|
|
1998-09-30 07:11:02 -04:00
|
|
|
|
#ifdef BUILD_tk
|
|
|
|
|
# undef TCL_STORAGE_CLASS
|
|
|
|
|
# define TCL_STORAGE_CLASS DLLEXPORT
|
|
|
|
|
#endif
|
|
|
|
|
|
1996-09-27 06:29:02 -04:00
|
|
|
|
#ifdef STk_CODE
|
|
|
|
|
/* Don't include the following code when compiling the interpreter */
|
|
|
|
|
# ifndef _STK_H
|
|
|
|
|
# define SCM void * /* Tk code never manipulate SCM object directly */
|
|
|
|
|
# include <tk-glue.h>
|
|
|
|
|
# endif
|
|
|
|
|
#endif
|
1999-09-05 07:16:41 -04:00
|
|
|
|
#ifdef BGLK_CODE
|
|
|
|
|
/* Don't include the following code when compiling the interpreter */
|
|
|
|
|
# ifndef _STK_H
|
|
|
|
|
# define SCM void * /* Tk code never manipulate SCM object directly */
|
|
|
|
|
# include <tclglue.h>
|
|
|
|
|
# endif
|
|
|
|
|
#endif
|
1996-09-27 06:29:02 -04:00
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* 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;
|
1998-04-10 06:59:06 -04:00
|
|
|
|
typedef struct Tk_Font_ *Tk_Font;
|
1996-09-27 06:29:02 -04:00
|
|
|
|
typedef struct Tk_Image__ *Tk_Image;
|
|
|
|
|
typedef struct Tk_ImageMaster_ *Tk_ImageMaster;
|
1998-04-10 06:59:06 -04:00
|
|
|
|
typedef struct Tk_TextLayout_ *Tk_TextLayout;
|
1996-09-27 06:29:02 -04:00
|
|
|
|
typedef struct Tk_Window_ *Tk_Window;
|
|
|
|
|
typedef struct Tk_3DBorder_ *Tk_3DBorder;
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* Additional types exported to clients.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
typedef char *Tk_Uid;
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* 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
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* 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.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
typedef int (Tk_OptionParseProc) _ANSI_ARGS_((ClientData clientData,
|
|
|
|
|
Tcl_Interp *interp, Tk_Window tkwin, 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. */
|
|
|
|
|
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 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.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#define TK_CONFIG_BOOLEAN 1
|
|
|
|
|
#define TK_CONFIG_INT 2
|
|
|
|
|
#define TK_CONFIG_DOUBLE 3
|
|
|
|
|
#define TK_CONFIG_STRING 4
|
|
|
|
|
#define TK_CONFIG_UID 5
|
|
|
|
|
#define TK_CONFIG_COLOR 6
|
|
|
|
|
#define TK_CONFIG_FONT 7
|
|
|
|
|
#define TK_CONFIG_BITMAP 8
|
|
|
|
|
#define TK_CONFIG_BORDER 9
|
|
|
|
|
#define TK_CONFIG_RELIEF 10
|
|
|
|
|
#define TK_CONFIG_CURSOR 11
|
|
|
|
|
#define TK_CONFIG_ACTIVE_CURSOR 12
|
|
|
|
|
#define TK_CONFIG_JUSTIFY 13
|
|
|
|
|
#define TK_CONFIG_ANCHOR 14
|
|
|
|
|
#define TK_CONFIG_SYNONYM 15
|
|
|
|
|
#define TK_CONFIG_CAP_STYLE 16
|
|
|
|
|
#define TK_CONFIG_JOIN_STYLE 17
|
|
|
|
|
#define TK_CONFIG_PIXELS 18
|
|
|
|
|
#define TK_CONFIG_MM 19
|
|
|
|
|
#define TK_CONFIG_WINDOW 20
|
|
|
|
|
#define TK_CONFIG_CUSTOM 21
|
1999-09-05 07:16:41 -04:00
|
|
|
|
#ifdef SCM_CODE
|
1996-09-27 06:29:02 -04:00
|
|
|
|
# define TK_CONFIG_CLOSURE 22
|
|
|
|
|
# define TK_CONFIG_SINT 23 /* value is an int but default is a string */
|
|
|
|
|
# define TK_CONFIG_SBOOLEAN 24 /* value is a boolean but default is a string */
|
|
|
|
|
# define TK_CONFIG_MENU 25 /* only for -menu in a menubutton */
|
|
|
|
|
# define TK_CONFIG_BSTRING 26 /* Value is a string but default is a boolean */
|
1998-04-10 06:59:06 -04:00
|
|
|
|
# define TK_CONFIG_ENV 27 /* Environment */
|
|
|
|
|
# define TK_CONFIG_IMAGE 28 /* Images */
|
1996-09-27 06:29:02 -04:00
|
|
|
|
# define TK_CONFIG_END 30
|
|
|
|
|
#else
|
|
|
|
|
# define TK_CONFIG_END 22
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* Macro to use to fill in "offset" fields of Tk_ConfigInfos.
|
|
|
|
|
* 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
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* Possible values for flags argument to Tk_ConfigureWidget:
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#define TK_CONFIG_ARGV_ONLY 1
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* Possible flag values for Tk_ConfigInfo 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
|
|
|
|
|
* tkConfig.c (internal-use-only flags are defined there).
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#define TK_CONFIG_COLOR_ONLY 1
|
|
|
|
|
#define TK_CONFIG_MONO_ONLY 2
|
|
|
|
|
#define TK_CONFIG_NULL_OK 4
|
|
|
|
|
#define TK_CONFIG_DONT_SET_DEFAULT 8
|
|
|
|
|
#define TK_CONFIG_OPTION_SPECIFIED 0x10
|
|
|
|
|
#define TK_CONFIG_USER_BIT 0x100
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* 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_RAISED 1
|
|
|
|
|
#define TK_RELIEF_FLAT 2
|
|
|
|
|
#define TK_RELIEF_SUNKEN 4
|
|
|
|
|
#define TK_RELIEF_GROOVE 8
|
|
|
|
|
#define TK_RELIEF_RIDGE 16
|
1998-04-10 06:59:06 -04:00
|
|
|
|
#define TK_RELIEF_SOLID 32
|
1996-09-27 06:29:02 -04:00
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* "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;
|
|
|
|
|
|
1998-04-10 06:59:06 -04:00
|
|
|
|
/*
|
|
|
|
|
* 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
|
|
|
|
|
|
1996-09-27 06:29:02 -04:00
|
|
|
|
/*
|
|
|
|
|
* 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
|
|
|
|
|
|
1998-04-10 06:59:06 -04:00
|
|
|
|
/*
|
|
|
|
|
*---------------------------------------------------------------------------
|
1996-09-27 06:29:02 -04:00
|
|
|
|
*
|
|
|
|
|
* Extensions to the X event set
|
|
|
|
|
*
|
|
|
|
|
*---------------------------------------------------------------------------
|
|
|
|
|
*/
|
1998-04-10 06:59:06 -04:00
|
|
|
|
#define VirtualEvent (LASTEvent)
|
|
|
|
|
#define ActivateNotify (LASTEvent + 1)
|
|
|
|
|
#define DeactivateNotify (LASTEvent + 2)
|
|
|
|
|
#define TK_LASTEVENT (LASTEvent + 3)
|
|
|
|
|
|
|
|
|
|
#define VirtualEventMask (1L << 30)
|
|
|
|
|
#define ActivateMask (1L << 29)
|
|
|
|
|
#define TK_LASTEVENT (LASTEvent + 3)
|
|
|
|
|
|
1996-09-27 06:29:02 -04:00
|
|
|
|
|
1998-04-10 06:59:06 -04:00
|
|
|
|
/*
|
|
|
|
|
* 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.
|
|
|
|
|
*/
|
1996-09-27 06:29:02 -04:00
|
|
|
|
|
1998-04-10 06:59:06 -04:00
|
|
|
|
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;
|
1996-09-27 06:29:02 -04:00
|
|
|
|
|
|
|
|
|
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)
|
1998-04-10 06:59:06 -04:00
|
|
|
|
#define Tk_IsEmbedded(tkwin) \
|
|
|
|
|
(((Tk_FakeWin *) (tkwin))->flags & TK_EMBEDDED)
|
|
|
|
|
#define Tk_IsContainer(tkwin) \
|
|
|
|
|
(((Tk_FakeWin *) (tkwin))->flags & TK_CONTAINER)
|
1996-09-27 06:29:02 -04:00
|
|
|
|
#define Tk_IsMapped(tkwin) \
|
|
|
|
|
(((Tk_FakeWin *) (tkwin))->flags & TK_MAPPED)
|
|
|
|
|
#define Tk_IsTopLevel(tkwin) \
|
|
|
|
|
(((Tk_FakeWin *) (tkwin))->flags & TK_TOP_LEVEL)
|
|
|
|
|
#define Tk_ReqWidth(tkwin) (((Tk_FakeWin *) (tkwin))->reqWidth)
|
|
|
|
|
#define Tk_ReqHeight(tkwin) (((Tk_FakeWin *) (tkwin))->reqHeight)
|
|
|
|
|
#define Tk_InternalBorderWidth(tkwin) \
|
|
|
|
|
(((Tk_FakeWin *) (tkwin))->internalBorderWidth)
|
|
|
|
|
#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;
|
|
|
|
|
int screenNum;
|
|
|
|
|
Visual *visual;
|
|
|
|
|
int depth;
|
|
|
|
|
Window window;
|
|
|
|
|
char *dummy2;
|
|
|
|
|
char *dummy3;
|
|
|
|
|
Tk_Window parentPtr;
|
|
|
|
|
char *dummy4;
|
|
|
|
|
char *dummy5;
|
|
|
|
|
char *pathName;
|
|
|
|
|
Tk_Uid nameUid;
|
|
|
|
|
Tk_Uid classUid;
|
|
|
|
|
XWindowChanges changes;
|
|
|
|
|
unsigned int dummy6;
|
|
|
|
|
XSetWindowAttributes atts;
|
|
|
|
|
unsigned long dummy7;
|
|
|
|
|
unsigned int flags;
|
|
|
|
|
char *dummy8;
|
|
|
|
|
#ifdef TK_USE_INPUT_METHODS
|
|
|
|
|
XIC dummy9;
|
|
|
|
|
#endif /* TK_USE_INPUT_METHODS */
|
|
|
|
|
ClientData *dummy10;
|
|
|
|
|
int dummy11;
|
|
|
|
|
int dummy12;
|
|
|
|
|
char *dummy13;
|
|
|
|
|
char *dummy14;
|
|
|
|
|
ClientData dummy15;
|
|
|
|
|
int reqWidth, reqHeight;
|
|
|
|
|
int internalBorderWidth;
|
|
|
|
|
char *dummy16;
|
|
|
|
|
char *dummy17;
|
1998-04-10 06:59:06 -04:00
|
|
|
|
ClientData dummy18;
|
|
|
|
|
char *dummy19;
|
1996-09-27 06:29:02 -04:00
|
|
|
|
} 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 window (it
|
|
|
|
|
* was or will be created as a child of
|
|
|
|
|
* a root window).
|
|
|
|
|
* 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.
|
1998-04-10 06:59:06 -04:00
|
|
|
|
* 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).
|
1996-09-27 06:29:02 -04:00
|
|
|
|
* 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.
|
1998-04-10 06:59:06 -04:00
|
|
|
|
* 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.
|
1996-09-27 06:29:02 -04:00
|
|
|
|
*/
|
|
|
|
|
|
1998-04-10 06:59:06 -04:00
|
|
|
|
|
1996-09-27 06:29:02 -04:00
|
|
|
|
#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
|
1998-04-10 06:59:06 -04:00
|
|
|
|
#define TK_DONT_DESTROY_WINDOW 0x40
|
1996-09-27 06:29:02 -04:00
|
|
|
|
#define TK_WM_COLORMAP_WINDOW 0x80
|
1998-04-10 06:59:06 -04:00
|
|
|
|
#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
|
1996-09-27 06:29:02 -04:00
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
*--------------------------------------------------------------
|
|
|
|
|
*
|
|
|
|
|
* Procedure prototypes and structures used for defining new canvas
|
|
|
|
|
* items:
|
|
|
|
|
*
|
|
|
|
|
*--------------------------------------------------------------
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* 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. */
|
1998-09-30 07:11:02 -04:00
|
|
|
|
int reserved1; /* This padding is for compatibility */
|
|
|
|
|
char *reserved2; /* with Jan Nijtmans dash patch */
|
|
|
|
|
int reserved3;
|
|
|
|
|
char *reserved4;
|
1996-09-27 06:29:02 -04:00
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
*------------------------------------------------------------------
|
|
|
|
|
* 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;
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* 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.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
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));
|
|
|
|
|
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));
|
|
|
|
|
|
|
|
|
|
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. */
|
1998-09-30 07:11:02 -04:00
|
|
|
|
char *reserved1; /* Reserved for future extension. */
|
|
|
|
|
int reserved2; /* Carefully compatible with */
|
|
|
|
|
char *reserved3; /* Jan Nijtmans dash patch */
|
|
|
|
|
char *reserved4;
|
1996-09-27 06:29:02 -04:00
|
|
|
|
} Tk_ItemType;
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* 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; /* Index of first selected character.
|
|
|
|
|
* Writable by items. */
|
|
|
|
|
int selectLast; /* Index of last selected character.
|
|
|
|
|
* Writable by items. */
|
|
|
|
|
Tk_Item *anchorItemPtr; /* Item corresponding to "selectAnchor":
|
|
|
|
|
* not necessarily selItemPtr. Read-only
|
|
|
|
|
* to items. */
|
|
|
|
|
int selectAnchor; /* 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;
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
*--------------------------------------------------------------
|
|
|
|
|
*
|
|
|
|
|
* Procedure prototypes and structures used for managing images:
|
|
|
|
|
*
|
|
|
|
|
*--------------------------------------------------------------
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
typedef struct Tk_ImageType Tk_ImageType;
|
|
|
|
|
typedef int (Tk_ImageCreateProc) _ANSI_ARGS_((Tcl_Interp *interp,
|
|
|
|
|
char *name, int argc, char **argv, Tk_ImageType *typePtr,
|
|
|
|
|
Tk_ImageMaster master, ClientData *masterDataPtr));
|
|
|
|
|
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));
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* 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. */
|
|
|
|
|
struct Tk_ImageType *nextPtr;
|
|
|
|
|
/* Next in list of all image types currently
|
|
|
|
|
* known. Filled in by Tk, not by image
|
|
|
|
|
* manager. */
|
1998-09-30 07:11:02 -04:00
|
|
|
|
char *reserved; /* reserved for future expansion */
|
1996-09-27 06:29:02 -04:00
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
*--------------------------------------------------------------
|
|
|
|
|
*
|
|
|
|
|
* 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[3]; /* Address differences between the red, green
|
|
|
|
|
* and blue components of the pixel and the
|
|
|
|
|
* pixel as a whole. */
|
1998-09-30 07:11:02 -04:00
|
|
|
|
int reserved; /* Reserved for extensions (dash patch) */
|
1996-09-27 06:29:02 -04:00
|
|
|
|
} Tk_PhotoImageBlock;
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* Procedure prototypes and structures used in reading and
|
|
|
|
|
* writing photo images:
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
typedef struct Tk_PhotoImageFormat Tk_PhotoImageFormat;
|
1998-04-10 06:59:06 -04:00
|
|
|
|
typedef int (Tk_ImageFileMatchProc) _ANSI_ARGS_((Tcl_Channel chan,
|
|
|
|
|
char *fileName, char *formatString, int *widthPtr, int *heightPtr));
|
1996-09-27 06:29:02 -04:00
|
|
|
|
typedef int (Tk_ImageStringMatchProc) _ANSI_ARGS_((char *string,
|
|
|
|
|
char *formatString, int *widthPtr, int *heightPtr));
|
|
|
|
|
typedef int (Tk_ImageFileReadProc) _ANSI_ARGS_((Tcl_Interp *interp,
|
1998-04-10 06:59:06 -04:00
|
|
|
|
Tcl_Channel chan, char *fileName, char *formatString,
|
|
|
|
|
Tk_PhotoHandle imageHandle, int destX, int destY,
|
|
|
|
|
int width, int height, int srcX, int srcY));
|
1996-09-27 06:29:02 -04:00
|
|
|
|
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));
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* 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. */
|
|
|
|
|
};
|
1998-04-10 06:59:06 -04:00
|
|
|
|
|
1996-09-27 06:29:02 -04:00
|
|
|
|
/*
|
|
|
|
|
*--------------------------------------------------------------
|
|
|
|
|
*
|
|
|
|
|
* 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 |