archie/tk3.6/tkBind.c
2024-05-27 16:13:40 +02:00

2394 lines
67 KiB
C
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/*
* tkBind.c --
*
* This file provides procedures that associate Tcl commands
* with X events or sequences of X events.
*
* Copyright (c) 1989-1993 The Regents of the University of California.
* All rights reserved.
*
* Permission is hereby granted, without written agreement and without
* license or royalty fees, to use, copy, modify, and distribute this
* software and its documentation for any purpose, provided that the
* above copyright notice and the following two paragraphs appear in
* all copies of this software.
*
* IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR
* DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT
* OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF
* CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES,
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
* AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS
* ON AN "AS IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATION TO
* PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
*/
#ifndef lint
static char rcsid[] = "$Header: /user6/ouster/wish/RCS/tkBind.c,v 1.67 93/09/30 08:37:31 ouster Exp $ SPRITE (Berkeley)";
#endif /* not lint */
#include "tkConfig.h"
#include "tkInt.h"
/*
* The structure below represents a binding table. A binding table
* represents a domain in which event bindings may occur. It includes
* a space of objects relative to which events occur (usually windows,
* but not always), a history of recent events in the domain, and
* a set of mappings that associate particular Tcl commands with sequences
* of events in the domain. Multiple binding tables may exist at once,
* either because there are multiple applications open, or because there
* are multiple domains within an application with separate event
* bindings for each (for example, each canvas widget has a separate
* binding table for associating events with the items in the canvas).
*/
#define EVENT_BUFFER_SIZE 20
typedef struct BindingTable {
XEvent eventRing[EVENT_BUFFER_SIZE];/* Circular queue of recent events
* (higher indices are for more recent
* events). */
int detailRing[EVENT_BUFFER_SIZE]; /* "Detail" information (keySym or
* button or 0) for each entry in
* eventRing. */
int curEvent; /* Index in eventRing of most recent
* event. Newer events have higher
* indices. */
Tcl_HashTable patternTable; /* Used to map from an event to a list
* of patterns that may match that
* event. Keys are PatternTableKey
* structs, values are (PatSeq *). */
Tcl_HashTable objectTable; /* Used to map from an object to a list
* of patterns associated with that
* object. Keys are ClientData,
* values are (PatSeq *). */
Tcl_Interp *interp; /* Interpreter in which commands are
* executed. */
} BindingTable;
/*
* Structures of the following form are used as keys in the patternTable
* for a binding table:
*/
typedef struct PatternTableKey {
ClientData object; /* Identifies object (or class of objects)
* relative to which event occurred. For
* example, in the widget binding table for
* an application this is the path name of
* a widget, or a widget class, or "all". */
int type; /* Type of event (from X). */
int detail; /* Additional information, such as
* keysym or button, or 0 if nothing
* additional.*/
} PatternTableKey;
/*
* The following structure defines a pattern, which is matched
* against X events as part of the process of converting X events
* into Tcl commands.
*/
typedef struct Pattern {
int eventType; /* Type of X event, e.g. ButtonPress. */
int needMods; /* Mask of modifiers that must be
* present (0 means no modifiers are
* required). */
int hateMods; /* Mask of modifiers that must not be
* present (0 means any modifiers are
* OK). */
int detail; /* Additional information that must
* match event. Normally this is 0,
* meaning no additional information
* must match. For KeyPress and
* KeyRelease events, a keySym may
* be specified to select a
* particular keystroke (0 means any
* keystrokes). For button events,
* specifies a particular button (0
* means any buttons are OK). */
} Pattern;
/*
* The structure below defines a pattern sequence, which consists
* of one or more patterns. In order to trigger, a pattern
* sequence must match the most recent X events (first pattern
* to most recent event, next pattern to next event, and so on).
*/
typedef struct PatSeq {
int numPats; /* Number of patterns in sequence
* (usually 1). */
char *command; /* Command to invoke when this
* pattern sequence matches (malloc-ed). */
int flags; /* Miscellaneous flag values; see
* below for definitions. */
struct PatSeq *nextSeqPtr;
/* Next in list of all pattern
* sequences that have the same
* initial pattern. NULL means
* end of list. */
Tcl_HashEntry *hPtr; /* Pointer to hash table entry for
* the initial pattern. This is the
* head of the list of which nextSeqPtr
* forms a part. */
ClientData object; /* Identifies object with which event is
* associated (e.g. window). */
struct PatSeq *nextObjPtr;
/* Next in list of all pattern
* sequences for the same object
* (NULL for end of list). Needed to
* implement Tk_DeleteAllBindings. */
Pattern pats[1]; /* Array of "numPats" patterns. Only
* one element is declared here but
* in actuality enough space will be
* allocated for "numPats" patterns.
* To match, pats[0] must match event
* n, pats[1] must match event n-1,
* etc. */
} PatSeq;
/*
* Flag values for PatSeq structures:
*
* PAT_NEARBY 1 means that all of the events matching
* this sequence must occur with nearby X
* and Y mouse coordinates and close in time.
* This is typically used to restrict multiple
* button presses.
* PAT_PERCENTS 1 means that the command for this pattern
* requires percent substitution. 0 means there
* are no percents in the command.
*/
#define PAT_NEARBY 1
#define PAT_PERCENTS 2
/*
* Constants that define how close together two events must be
* in milliseconds or pixels to meet the PAT_NEARBY constraint:
*/
#define NEARBY_PIXELS 5
#define NEARBY_MS 500
/*
* The data structure and hash table below are used to map from
* textual keysym names to keysym numbers. This structure is
* present here because the corresponding X procedures are
* ridiculously slow.
*/
typedef struct {
char *name; /* Name of keysym. */
KeySym value; /* Numeric identifier for keysym. */
} KeySymInfo;
KeySymInfo keyArray[] = {
#ifndef lint
#include "ks_names.h"
#endif
{(char *) NULL, 0}
};
static Tcl_HashTable keySymTable; /* Hashed form of above structure. */
static int initialized = 0;
/*
* A hash table is kept to map from the string names of event
* modifiers to information about those modifiers. The structure
* for storing this information, and the hash table built at
* initialization time, are defined below.
*/
typedef struct {
char *name; /* Name of modifier. */
int mask; /* Button/modifier mask value, * such as Button1Mask. */
int flags; /* Various flags; see below for
* definitions. */
} ModInfo;
/*
* Flags for ModInfo structures:
*
* DOUBLE - Non-zero means duplicate this event,
* e.g. for double-clicks.
* TRIPLE - Non-zero means triplicate this event,
* e.g. for triple-clicks.
* ANY - Non-zero means that this event allows
* any unspecified modifiers.
*/
#define DOUBLE 1
#define TRIPLE 2
#define ANY 4
static ModInfo modArray[] = {
{"Control", ControlMask, 0},
{"Shift", ShiftMask, 0},
{"Lock", LockMask, 0},
{"B1", Button1Mask, 0},
{"Button1", Button1Mask, 0},
{"B2", Button2Mask, 0},
{"Button2", Button2Mask, 0},
{"B3", Button3Mask, 0},
{"Button3", Button3Mask, 0},
{"B4", Button4Mask, 0},
{"Button4", Button4Mask, 0},
{"B5", Button5Mask, 0},
{"Button5", Button5Mask, 0},
{"Mod1", Mod1Mask, 0},
{"M1", Mod1Mask, 0},
{"Meta", Mod1Mask, 0},
{"M", Mod1Mask, 0},
{"Mod2", Mod2Mask, 0},
{"M2", Mod2Mask, 0},
{"Alt", Mod2Mask, 0},
{"Mod3", Mod3Mask, 0},
{"M3", Mod3Mask, 0},
{"Mod4", Mod4Mask, 0},
{"M4", Mod4Mask, 0},
{"Mod5", Mod5Mask, 0},
{"M5", Mod5Mask, 0},
{"Double", 0, DOUBLE},
{"Triple", 0, TRIPLE},
{"Any", 0, ANY},
{NULL, 0, 0}
};
static Tcl_HashTable modTable;
/*
* This module also keeps a hash table mapping from event names
* to information about those events. The structure, an array
* to use to initialize the hash table, and the hash table are
* all defined below.
*/
typedef struct {
char *name; /* Name of event. */
int type; /* Event type for X, such as
* ButtonPress. */
int eventMask; /* Mask bits (for XSelectInput)
* for this event type. */
} EventInfo;
/*
* Note: some of the masks below are an OR-ed combination of
* several masks. This is necessary because X doesn't report
* up events unless you also ask for down events. Also, X
* doesn't report button state in motion events unless you've
* asked about button events.
*/
static EventInfo eventArray[] = {
{"Motion", MotionNotify,
ButtonPressMask|PointerMotionMask},
{"Button", ButtonPress, ButtonPressMask},
{"ButtonPress", ButtonPress, ButtonPressMask},
{"ButtonRelease", ButtonRelease,
ButtonPressMask|ButtonReleaseMask},
{"Colormap", ColormapNotify, ColormapChangeMask},
{"Enter", EnterNotify, EnterWindowMask},
{"Leave", LeaveNotify, LeaveWindowMask},
{"Expose", Expose, ExposureMask},
{"FocusIn", FocusIn, FocusChangeMask},
{"FocusOut", FocusOut, FocusChangeMask},
{"Keymap", KeymapNotify, KeymapStateMask},
{"Key", KeyPress, KeyPressMask},
{"KeyPress", KeyPress, KeyPressMask},
{"KeyRelease", KeyRelease,
KeyPressMask|KeyReleaseMask},
{"Property", PropertyNotify, PropertyChangeMask},
{"ResizeRequest", ResizeRequest, ResizeRedirectMask},
{"Circulate", CirculateNotify, StructureNotifyMask},
{"Configure", ConfigureNotify, StructureNotifyMask},
{"Destroy", DestroyNotify, StructureNotifyMask},
{"Gravity", GravityNotify, StructureNotifyMask},
{"Map", MapNotify, StructureNotifyMask},
{"Reparent", ReparentNotify, StructureNotifyMask},
{"Unmap", UnmapNotify, StructureNotifyMask},
{"Visibility", VisibilityNotify, VisibilityChangeMask},
{"CirculateRequest",CirculateRequest, SubstructureRedirectMask},
{"ConfigureRequest",ConfigureRequest, SubstructureRedirectMask},
{"MapRequest", MapRequest, SubstructureRedirectMask},
{(char *) NULL, 0, 0}
};
static Tcl_HashTable eventTable;
/*
* The defines and table below are used to classify events into
* various groups. The reason for this is that logically identical
* fields (e.g. "state") appear at different places in different
* types of events. The classification masks can be used to figure
* out quickly where to extract information from events.
*/
#define KEY_BUTTON_MOTION 0x1
#define CROSSING 0x2
#define FOCUS 0x4
#define EXPOSE 0x8
#define VISIBILITY 0x10
#define CREATE 0x20
#define MAP 0x40
#define REPARENT 0x80
#define CONFIG 0x100
#define CONFIG_REQ 0x200
#define RESIZE_REQ 0x400
#define GRAVITY 0x800
#define PROP 0x1000
#define SEL_CLEAR 0x2000
#define SEL_REQ 0x4000
#define SEL_NOTIFY 0x8000
#define COLORMAP 0x10000
#define MAPPING 0x20000
static int flagArray[LASTEvent] = {
/* Not used */ 0,
/* Not used */ 0,
/* KeyPress */ KEY_BUTTON_MOTION,
/* KeyRelease */ KEY_BUTTON_MOTION,
/* ButtonPress */ KEY_BUTTON_MOTION,
/* ButtonRelease */ KEY_BUTTON_MOTION,
/* MotionNotify */ KEY_BUTTON_MOTION,
/* EnterNotify */ CROSSING,
/* LeaveNotify */ CROSSING,
/* FocusIn */ FOCUS,
/* FocusOut */ FOCUS,
/* KeymapNotify */ 0,
/* Expose */ EXPOSE,
/* GraphicsExpose */ EXPOSE,
/* NoExpose */ 0,
/* VisibilityNotify */ VISIBILITY,
/* CreateNotify */ CREATE,
/* DestroyNotify */ 0,
/* UnmapNotify */ 0,
/* MapNotify */ MAP,
/* MapRequest */ 0,
/* ReparentNotify */ REPARENT,
/* ConfigureNotify */ CONFIG,
/* ConfigureRequest */ CONFIG_REQ,
/* GravityNotify */ 0,
/* ResizeRequest */ RESIZE_REQ,
/* CirculateNotify */ 0,
/* CirculateRequest */ 0,
/* PropertyNotify */ PROP,
/* SelectionClear */ SEL_CLEAR,
/* SelectionRequest */ SEL_REQ,
/* SelectionNotify */ SEL_NOTIFY,
/* ColormapNotify */ COLORMAP,
/* ClientMessage */ 0,
/* MappingNotify */ MAPPING
};
/*
* Forward declarations for procedures defined later in this
* file:
*/
static char * ExpandPercents _ANSI_ARGS_((char *before,
XEvent *eventPtr, KeySym keySym, char *after,
int afterSize));
static PatSeq * FindSequence _ANSI_ARGS_((Tcl_Interp *interp,
BindingTable *bindPtr, ClientData object,
char *eventString, int create,
unsigned long *maskPtr));
static char * GetField _ANSI_ARGS_((char *p, char *copy, int size));
static KeySym GetKeySym _ANSI_ARGS_((TkDisplay *dispPtr,
XEvent *eventPtr));
static void InitKeymapInfo _ANSI_ARGS_((TkDisplay *dispPtr));
static PatSeq * MatchPatterns _ANSI_ARGS_((TkDisplay *dispPtr,
BindingTable *bindPtr, PatSeq *psPtr));
/*
*--------------------------------------------------------------
*
* Tk_CreateBindingTable --
*
* Set up a new domain in which event bindings may be created.
*
* Results:
* The return value is a token for the new table, which must
* be passed to procedures like Tk_CreatBinding.
*
* Side effects:
* Memory is allocated for the new table.
*
*--------------------------------------------------------------
*/
Tk_BindingTable
Tk_CreateBindingTable(interp)
Tcl_Interp *interp; /* Interpreter to associate with the binding
* table: commands are executed in this
* interpreter. */
{
register BindingTable *bindPtr;
int i;
/*
* If this is the first time a binding table has been created,
* initialize the global data structures.
*/
if (!initialized) {
register KeySymInfo *kPtr;
register Tcl_HashEntry *hPtr;
register ModInfo *modPtr;
register EventInfo *eiPtr;
int dummy;
initialized = 1;
Tcl_InitHashTable(&keySymTable, TCL_STRING_KEYS);
for (kPtr = keyArray; kPtr->name != NULL; kPtr++) {
hPtr = Tcl_CreateHashEntry(&keySymTable, kPtr->name, &dummy);
Tcl_SetHashValue(hPtr, kPtr->value);
}
Tcl_InitHashTable(&modTable, TCL_STRING_KEYS);
for (modPtr = modArray; modPtr->name != NULL; modPtr++) {
hPtr = Tcl_CreateHashEntry(&modTable, modPtr->name, &dummy);
Tcl_SetHashValue(hPtr, modPtr);
}
Tcl_InitHashTable(&eventTable, TCL_STRING_KEYS);
for (eiPtr = eventArray; eiPtr->name != NULL; eiPtr++) {
hPtr = Tcl_CreateHashEntry(&eventTable, eiPtr->name, &dummy);
Tcl_SetHashValue(hPtr, eiPtr);
}
}
/*
* Create and initialize a new binding table.
*/
bindPtr = (BindingTable *) ckalloc(sizeof(BindingTable));
for (i = 0; i < EVENT_BUFFER_SIZE; i++) {
bindPtr->eventRing[i].type = -1;
}
bindPtr->curEvent = 0;
Tcl_InitHashTable(&bindPtr->patternTable,
sizeof(PatternTableKey)/sizeof(int));
Tcl_InitHashTable(&bindPtr->objectTable, TCL_ONE_WORD_KEYS);
bindPtr->interp = interp;
return (Tk_BindingTable) bindPtr;
}
/*
*--------------------------------------------------------------
*
* Tk_DeleteBindingTable --
*
* Destroy a binding table and free up all its memory.
* The caller should not use bindingTable again after
* this procedure returns.
*
* Results:
* None.
*
* Side effects:
* Memory is freed.
*
*--------------------------------------------------------------
*/
void
Tk_DeleteBindingTable(bindingTable)
Tk_BindingTable bindingTable; /* Token for the binding table to
* destroy. */
{
BindingTable *bindPtr = (BindingTable *) bindingTable;
PatSeq *psPtr, *nextPtr;
Tcl_HashEntry *hPtr;
Tcl_HashSearch search;
/*
* Find and delete all of the patterns associated with the binding
* table.
*/
for (hPtr = Tcl_FirstHashEntry(&bindPtr->patternTable, &search);
hPtr != NULL; hPtr = Tcl_NextHashEntry(&search)) {
for (psPtr = (PatSeq *) Tcl_GetHashValue(hPtr);
psPtr != NULL; psPtr = nextPtr) {
nextPtr = psPtr->nextSeqPtr;
ckfree((char *) psPtr->command);
ckfree((char *) psPtr);
}
}
/*
* Clean up the rest of the information associated with the
* binding table.
*/
Tcl_DeleteHashTable(&bindPtr->patternTable);
Tcl_DeleteHashTable(&bindPtr->objectTable);
ckfree((char *) bindPtr);
}
/*
*--------------------------------------------------------------
*
* Tk_CreateBinding --
*
* Add a binding to a binding table, so that future calls to
* Tk_BindEvent may execute the command in the binding.
*
* Results:
* The return value is 0 if an error occurred while setting
* up the binding. In this case, an error message will be
* left in interp->result. If all went well then the return
* value is a mask of the event types that must be made
* available to Tk_BindEvent in order to properly detect when
* this binding triggers. This value can be used to determine
* what events to select for in a window, for example.
*
* Side effects:
* The new binding may cause future calls to Tk_BindEvent to
* behave differently than they did previously.
*
*--------------------------------------------------------------
*/
unsigned long
Tk_CreateBinding(interp, bindingTable, object, eventString, command, append)
Tcl_Interp *interp; /* Used for error reporting. */
Tk_BindingTable bindingTable; /* Table in which to create binding. */
ClientData object; /* Token for object with which binding
* is associated. */
char *eventString; /* String describing event sequence
* that triggers binding. */
char *command; /* Contains Tcl command to execute
* when binding triggers. */
int append; /* 0 means replace any existing
* binding for eventString; 1 means
* append to that binding. */
{
BindingTable *bindPtr = (BindingTable *) bindingTable;
register PatSeq *psPtr;
unsigned long eventMask;
psPtr = FindSequence(interp, bindPtr, object, eventString, 1, &eventMask);
if (psPtr == NULL) {
return 0;
}
if (append && (psPtr->command != NULL)) {
int length;
char *new;
length = strlen(psPtr->command) + strlen(command) + 3;
new = (char *) ckalloc((unsigned) length);
sprintf(new, "%s; %s", psPtr->command, command);
ckfree((char *) psPtr->command);
psPtr->command = new;
} else {
if (psPtr->command != NULL) {
ckfree((char *) psPtr->command);
}
psPtr->command = (char *) ckalloc((unsigned) (strlen(command) + 1));
strcpy(psPtr->command, command);
}
/*
* See if the command contains percents and thereby requires
* percent substitution.
*/
if (strchr(psPtr->command, '%') != NULL) {
psPtr->flags |= PAT_PERCENTS;
}
return eventMask;
}
/*
*--------------------------------------------------------------
*
* Tk_DeleteBinding --
*
* Remove an event binding from a binding table.
*
* Results:
* The result is a standard Tcl return value. If an error
* occurs then interp->result will contain an error message.
*
* Side effects:
* The binding given by object and eventString is removed
* from bindingTable.
*
*--------------------------------------------------------------
*/
int
Tk_DeleteBinding(interp, bindingTable, object, eventString)
Tcl_Interp *interp; /* Used for error reporting. */
Tk_BindingTable bindingTable; /* Table in which to delete binding. */
ClientData object; /* Token for object with which binding
* is associated. */
char *eventString; /* String describing event sequence
* that triggers binding. */
{
BindingTable *bindPtr = (BindingTable *) bindingTable;
register PatSeq *psPtr, *prevPtr;
unsigned long eventMask;
Tcl_HashEntry *hPtr;
psPtr = FindSequence(interp, bindPtr, object, eventString, 0, &eventMask);
if (psPtr == NULL) {
Tcl_ResetResult(interp);
return TCL_OK;
}
/*
* Unlink the binding from the list for its object, then from the
* list for its pattern.
*/
hPtr = Tcl_FindHashEntry(&bindPtr->objectTable, (char *) object);
if (hPtr == NULL) {
panic("Tk_DeleteBinding couldn't find object table entry");
}
prevPtr = (PatSeq *) Tcl_GetHashValue(hPtr);
if (prevPtr == psPtr) {
Tcl_SetHashValue(hPtr, psPtr->nextObjPtr);
} else {
for ( ; ; prevPtr = prevPtr->nextObjPtr) {
if (prevPtr == NULL) {
panic("Tk_DeleteBinding couldn't find on object list");
}
if (prevPtr->nextObjPtr == psPtr) {
prevPtr->nextObjPtr = psPtr->nextObjPtr;
break;
}
}
}
prevPtr = (PatSeq *) Tcl_GetHashValue(psPtr->hPtr);
if (prevPtr == psPtr) {
if (psPtr->nextSeqPtr == NULL) {
Tcl_DeleteHashEntry(psPtr->hPtr);
} else {
Tcl_SetHashValue(psPtr->hPtr, psPtr->nextSeqPtr);
}
} else {
for ( ; ; prevPtr = prevPtr->nextSeqPtr) {
if (prevPtr == NULL) {
panic("Tk_DeleteBinding couldn't find on hash chain");
}
if (prevPtr->nextSeqPtr == psPtr) {
prevPtr->nextSeqPtr = psPtr->nextSeqPtr;
break;
}
}
}
ckfree((char *) psPtr->command);
ckfree((char *) psPtr);
return TCL_OK;
}
/*
*--------------------------------------------------------------
*
* Tk_GetBinding --
*
* Return the command associated with a given event string.
*
* Results:
* The return value is a pointer to the command string
* associated with eventString for object in the domain
* given by bindingTable. If there is no binding for
* eventString, or if eventString is improperly formed,
* then NULL is returned and an error message is left in
* interp->result. The return value is semi-static: it
* will persist until the binding is changed or deleted.
*
* Side effects:
* None.
*
*--------------------------------------------------------------
*/
char *
Tk_GetBinding(interp, bindingTable, object, eventString)
Tcl_Interp *interp; /* Interpreter for error reporting. */
Tk_BindingTable bindingTable; /* Table in which to look for
* binding. */
ClientData object; /* Token for object with which binding
* is associated. */
char *eventString; /* String describing event sequence
* that triggers binding. */
{
BindingTable *bindPtr = (BindingTable *) bindingTable;
register PatSeq *psPtr;
unsigned long eventMask;
psPtr = FindSequence(interp, bindPtr, object, eventString, 0, &eventMask);
if (psPtr == NULL) {
return NULL;
}
return psPtr->command;
}
/*
*--------------------------------------------------------------
*
* Tk_GetAllBindings --
*
* Return a list of event strings for all the bindings
* associated with a given object.
*
* Results:
* There is no return value. Interp->result is modified to
* hold a Tcl list with one entry for each binding associated
* with object in bindingTable. Each entry in the list
* contains the event string associated with one binding.
*
* Side effects:
* None.
*
*--------------------------------------------------------------
*/
void
Tk_GetAllBindings(interp, bindingTable, object)
Tcl_Interp *interp; /* Interpreter for error reporting. */
Tk_BindingTable bindingTable; /* Table in which to look for
* bindings. */
ClientData object; /* Token for object. */
{
BindingTable *bindPtr = (BindingTable *) bindingTable;
register PatSeq *psPtr;
register Pattern *patPtr;
Tcl_HashEntry *hPtr;
char string[200*EVENT_BUFFER_SIZE];
register char *p;
int patsLeft, needMods;
register ModInfo *modPtr;
register EventInfo *eiPtr;
hPtr = Tcl_FindHashEntry(&bindPtr->objectTable, (char *) object);
if (hPtr == NULL) {
return;
}
for (psPtr = (PatSeq *) Tcl_GetHashValue(hPtr); psPtr != NULL;
psPtr = psPtr->nextObjPtr) {
p = string;
/*
* For each binding, output information about each of the
* patterns in its sequence. The order of the patterns in
* the sequence is backwards from the order in which they
* must be output.
*/
for (patsLeft = psPtr->numPats,
patPtr = &psPtr->pats[psPtr->numPats - 1];
patsLeft > 0; patsLeft--, patPtr--) {
/*
* Check for simple case of an ASCII character.
*/
if ((patPtr->eventType == KeyPress)
&& (patPtr->needMods == 0)
&& (patPtr->hateMods == ~LockMask)
&& (patPtr->detail < 128)
&& isprint(UCHAR(patPtr->detail))
&& (patPtr->detail != '<')
&& (patPtr->detail != ' ')) {
*p = patPtr->detail;
p++;
continue;
}
/*
* It's a more general event specification. First check
* for "Double" or "Triple", then "Any", then modifiers,
* the event type, then keysym or button detail.
*/
*p = '<';
p++;
if ((patsLeft > 1) && (memcmp((char *) patPtr,
(char *) (patPtr-1), sizeof(Pattern)) == 0)) {
patsLeft--;
patPtr--;
if ((patsLeft > 1) && (memcmp((char *) patPtr,
(char *) (patPtr-1), sizeof(Pattern)) == 0)) {
patsLeft--;
patPtr--;
strcpy(p, "Triple-");
} else {
strcpy(p, "Double-");
}
p += strlen(p);
}
if (patPtr->hateMods == 0) {
strcpy(p, "Any-");
p += strlen(p);
}
for (needMods = patPtr->needMods, modPtr = modArray;
needMods != 0; modPtr++) {
if (modPtr->mask & needMods) {
needMods &= ~modPtr->mask;
strcpy(p, modPtr->name);
p += strlen(p);
*p = '-';
p++;
}
}
for (eiPtr = eventArray; eiPtr->name != NULL; eiPtr++) {
if (eiPtr->type == patPtr->eventType) {
strcpy(p, eiPtr->name);
p += strlen(p);
if (patPtr->detail != 0) {
*p = '-';
p++;
}
break;
}
}
if (patPtr->detail != 0) {
if ((patPtr->eventType == KeyPress)
|| (patPtr->eventType == KeyRelease)) {
register KeySymInfo *kPtr;
for (kPtr = keyArray; kPtr->name != NULL; kPtr++) {
if (patPtr->detail == (int) kPtr->value) {
sprintf(p, "%.100s", kPtr->name);
p += strlen(p);
break;
}
}
} else {
sprintf(p, "%d", patPtr->detail);
p += strlen(p);
}
}
*p = '>';
p++;
}
*p = 0;
if ((p - string) >= sizeof(string)) {
panic("Tk_GetAllBindings overflowed buffer");
}
Tcl_AppendElement(interp, string);
}
}
/*
*--------------------------------------------------------------
*
* Tk_DeleteAllBindings --
*
* Remove all bindings associated with a given object in a
* given binding table.
*
* Results:
* All bindings associated with object are removed from
* bindingTable.
*
* Side effects:
* None.
*
*--------------------------------------------------------------
*/
void
Tk_DeleteAllBindings(bindingTable, object)
Tk_BindingTable bindingTable; /* Table in which to delete
* bindings. */
ClientData object; /* Token for object. */
{
BindingTable *bindPtr = (BindingTable *) bindingTable;
register PatSeq *psPtr, *prevPtr;
PatSeq *nextPtr;
Tcl_HashEntry *hPtr;
hPtr = Tcl_FindHashEntry(&bindPtr->objectTable, (char *) object);
if (hPtr == NULL) {
return;
}
for (psPtr = (PatSeq *) Tcl_GetHashValue(hPtr); psPtr != NULL;
psPtr = nextPtr) {
nextPtr = psPtr->nextObjPtr;
/*
* Be sure to remove each binding from its hash chain in the
* pattern table. If this is the last pattern in the chain,
* then delete the hash entry too.
*/
prevPtr = (PatSeq *) Tcl_GetHashValue(psPtr->hPtr);
if (prevPtr == psPtr) {
if (psPtr->nextSeqPtr == NULL) {
Tcl_DeleteHashEntry(psPtr->hPtr);
} else {
Tcl_SetHashValue(psPtr->hPtr, psPtr->nextSeqPtr);
}
} else {
for ( ; ; prevPtr = prevPtr->nextSeqPtr) {
if (prevPtr == NULL) {
panic("Tk_DeleteAllBindings couldn't find on hash chain");
}
if (prevPtr->nextSeqPtr == psPtr) {
prevPtr->nextSeqPtr = psPtr->nextSeqPtr;
break;
}
}
}
ckfree((char *) psPtr->command);
ckfree((char *) psPtr);
}
Tcl_DeleteHashEntry(hPtr);
}
/*
*--------------------------------------------------------------
*
* Tk_BindEvent --
*
* This procedure is invoked to process an X event. The
* event is added to those recorded for the binding table.
* Then each of the objects at *objectPtr is checked in
* order to see if it has a binding that matches the recent
* events. If so, that binding is invoked and the rest of
* objects are skipped.
*
* Results:
* None.
*
* Side effects:
* Depends on the command associated with the matching
* binding.
*
*--------------------------------------------------------------
*/
void
Tk_BindEvent(bindingTable, eventPtr, tkwin, numObjects, objectPtr)
Tk_BindingTable bindingTable; /* Table in which to look for
* bindings. */
XEvent *eventPtr; /* What actually happened. */
Tk_Window tkwin; /* Window on display where event
* occurred (needed in order to
* locate display information). */
int numObjects; /* Number of objects at *objectPtr. */
ClientData *objectPtr; /* Array of one or more objects
* to check for a matching binding. */
{
BindingTable *bindPtr = (BindingTable *) bindingTable;
TkDisplay *dispPtr = ((TkWindow *) tkwin)->dispPtr;
XEvent *ringPtr;
PatSeq *matchPtr;
PatternTableKey key;
Tcl_HashEntry *hPtr;
int detail;
/*
* Add the new event to the ring of saved events for the
* binding table. Consecutive MotionNotify events get combined:
* if both the new event and the previous event are MotionNotify,
* then put the new event *on top* of the previous event.
*/
if ((eventPtr->type != MotionNotify)
|| (bindPtr->eventRing[bindPtr->curEvent].type != MotionNotify)) {
bindPtr->curEvent++;
if (bindPtr->curEvent >= EVENT_BUFFER_SIZE) {
bindPtr->curEvent = 0;
}
}
ringPtr = &bindPtr->eventRing[bindPtr->curEvent];
memcpy((VOID *) ringPtr, (VOID *) eventPtr, sizeof(XEvent));
detail = 0;
bindPtr->detailRing[bindPtr->curEvent] = 0;
if ((ringPtr->type == KeyPress) || (ringPtr->type == KeyRelease)) {
detail = (int) GetKeySym(dispPtr, ringPtr);
if (detail == NoSymbol) {
detail = 0;
}
} else if ((ringPtr->type == ButtonPress)
|| (ringPtr->type == ButtonRelease)) {
detail = ringPtr->xbutton.button;
}
bindPtr->detailRing[bindPtr->curEvent] = detail;
/*
* Loop over all the objects, matching the new event against
* each in turn.
*/
for ( ; numObjects > 0; numObjects--, objectPtr++) {
/*
* Match the new event against those recorded in the
* pattern table, saving the longest matching pattern.
* For events with details (button and key events) first
* look for a binding for the specific key or button.
* If none is found, then look for a binding for all
* keys or buttons (detail of 0).
*/
matchPtr = NULL;
key.object = *objectPtr;
key.type = ringPtr->type;
key.detail = detail;
hPtr = Tcl_FindHashEntry(&bindPtr->patternTable, (char *) &key);
if (hPtr != NULL) {
matchPtr = MatchPatterns(dispPtr, bindPtr,
(PatSeq *) Tcl_GetHashValue(hPtr));
}
if ((detail != 0) && (matchPtr == NULL)) {
key.detail = 0;
hPtr = Tcl_FindHashEntry(&bindPtr->patternTable, (char *) &key);
if (hPtr != NULL) {
matchPtr = MatchPatterns(dispPtr, bindPtr,
(PatSeq *) Tcl_GetHashValue(hPtr));
}
}
if (matchPtr != NULL) {
/*
* %-substitution can increase the length of the command.
* This code handles three cases: (a) no substitution;
* (b) substitution results in short command (use space
* on stack); and (c) substitution results in long
* command (malloc it).
*/
#define STATIC_SPACE 200
char shortSpace[STATIC_SPACE];
int result;
if (matchPtr->flags & PAT_PERCENTS) {
char *p;
p = ExpandPercents(matchPtr->command, eventPtr,
(KeySym) detail, shortSpace, STATIC_SPACE);
result = Tcl_GlobalEval(bindPtr->interp, p);
if (p != shortSpace) {
ckfree(p);
}
} else {
result = TkCopyAndGlobalEval(bindPtr->interp,
matchPtr->command);
}
if (result != TCL_OK) {
Tcl_AddErrorInfo(bindPtr->interp,
"\n (command bound to event)");
Tk_BackgroundError(bindPtr->interp);
}
return;
}
}
}
/*
*----------------------------------------------------------------------
*
* FindSequence --
*
* Find the entry in a binding table that corresponds to a
* particular pattern string, and return a pointer to that
* entry.
*
* Results:
* The return value is normally a pointer to the PatSeq
* in patternTable that corresponds to eventString. If an error
* was found while parsing eventString, or if "create" is 0 and
* no pattern sequence previously existed, then NULL is returned
* and interp->result contains a message describing the problem.
* If no pattern sequence previously existed for eventString, then
* a new one is created with a NULL command field. In a successful
* return, *maskPtr is filled in with a mask of the event types
* on which the pattern sequence depends.
*
* Side effects:
* A new pattern sequence may be created.
*
*----------------------------------------------------------------------
*/
static PatSeq *
FindSequence(interp, bindPtr, object, eventString, create, maskPtr)
Tcl_Interp *interp; /* Interpreter to use for error
* reporting. */
BindingTable *bindPtr; /* Table to use for lookup. */
ClientData object; /* Token for object(s) with which binding
* is associated. */
char *eventString; /* String description of pattern to
* match on. See user documentation
* for details. */
int create; /* 0 means don't create the entry if
* it doesn't already exist. Non-zero
* means create. */
unsigned long *maskPtr; /* *maskPtr is filled in with the event
* types on which this pattern sequence
* depends. */
{
Pattern pats[EVENT_BUFFER_SIZE];
int numPats;
register char *p;
register Pattern *patPtr;
register PatSeq *psPtr;
register Tcl_HashEntry *hPtr;
#define FIELD_SIZE 20
char field[FIELD_SIZE];
int flags, any, count, new, sequenceSize;
unsigned long eventMask;
PatternTableKey key;
/*
*-------------------------------------------------------------
* Step 1: parse the pattern string to produce an array
* of Patterns. The array is generated backwards, so
* that the lowest-indexed pattern corresponds to the last
* event that must occur.
*-------------------------------------------------------------
*/
p = eventString;
flags = 0;
eventMask = 0;
for (numPats = 0, patPtr = &pats[EVENT_BUFFER_SIZE-1];
numPats < EVENT_BUFFER_SIZE;
numPats++, patPtr--) {
patPtr->eventType = -1;
patPtr->needMods = 0;
/*
* Note: the presence of Caps Lock should not prevent bindings
* from triggering (unless it is explicitly asked for and it
* isn't present); it should only affect the keysym that's
* generated for key events (and that is handled elsewhere.
*/
patPtr->hateMods = ~LockMask;
patPtr->detail = 0;
while (isspace(UCHAR(*p))) {
p++;
}
if (*p == '\0') {
break;
}
/*
* Handle simple ASCII characters.
*/
if (*p != '<') {
char string[2];
patPtr->eventType = KeyPress;
eventMask |= KeyPressMask;
string[0] = *p;
string[1] = 0;
hPtr = Tcl_FindHashEntry(&keySymTable, string);
if (hPtr != NULL) {
patPtr->detail = (int) Tcl_GetHashValue(hPtr);
} else {
if (isprint(UCHAR(*p))) {
patPtr->detail = *p;
} else {
sprintf(interp->result,
"bad ASCII character 0x%x", *p);
return NULL;
}
}
p++;
continue;
}
/*
* A fancier event description. Must consist of
* 1. open angle bracket.
* 2. any number of modifiers, each followed by spaces
* or dashes.
* 3. an optional event name.
* 4. an option button or keysym name. Either this or
* item 3 *must* be present; if both are present
* then they are separated by spaces or dashes.
* 5. a close angle bracket.
*/
any = 0;
count = 1;
p++;
while (1) {
register ModInfo *modPtr;
p = GetField(p, field, FIELD_SIZE);
hPtr = Tcl_FindHashEntry(&modTable, field);
if (hPtr == NULL) {
break;
}
modPtr = (ModInfo *) Tcl_GetHashValue(hPtr);
patPtr->needMods |= modPtr->mask;
if (modPtr->flags & (DOUBLE|TRIPLE)) {
flags |= PAT_NEARBY;
if (modPtr->flags & DOUBLE) {
count = 2;
} else {
count = 3;
}
}
if (modPtr->flags & ANY) {
any = 1;
}
while ((*p == '-') || isspace(UCHAR(*p))) {
p++;
}
}
if (any) {
patPtr->hateMods = 0;
} else {
patPtr->hateMods = ~(patPtr->needMods | LockMask);
}
hPtr = Tcl_FindHashEntry(&eventTable, field);
if (hPtr != NULL) {
register EventInfo *eiPtr;
eiPtr = (EventInfo *) Tcl_GetHashValue(hPtr);
patPtr->eventType = eiPtr->type;
eventMask |= eiPtr->eventMask;
while ((*p == '-') || isspace(UCHAR(*p))) {
p++;
}
p = GetField(p, field, FIELD_SIZE);
}
if (*field != '\0') {
if ((*field >= '1') && (*field <= '5') && (field[1] == '\0')) {
static int masks[] = {~0, ~Button1Mask, ~Button2Mask,
~Button3Mask, ~Button4Mask, ~Button5Mask};
if (patPtr->eventType == -1) {
patPtr->eventType = ButtonPress;
eventMask |= ButtonPressMask;
} else if ((patPtr->eventType == KeyPress)
|| (patPtr->eventType == KeyRelease)) {
goto getKeysym;
} else if ((patPtr->eventType != ButtonPress)
&& (patPtr->eventType != ButtonRelease)) {
Tcl_AppendResult(interp, "specified button \"", field,
"\" for non-button event", (char *) NULL);
return NULL;
}
patPtr->detail = (*field - '0');
/*
* Ignore this button as a modifier: its state is already
* fixed.
*/
patPtr->needMods &= masks[patPtr->detail];
patPtr->hateMods &= masks[patPtr->detail];
} else {
getKeysym:
hPtr = Tcl_FindHashEntry(&keySymTable, (char *) field);
if (hPtr == NULL) {
Tcl_AppendResult(interp, "bad event type or keysym \"",
field, "\"", (char *) NULL);
return NULL;
}
if (patPtr->eventType == -1) {
patPtr->eventType = KeyPress;
eventMask |= KeyPressMask;
} else if ((patPtr->eventType != KeyPress)
&& (patPtr->eventType != KeyRelease)) {
Tcl_AppendResult(interp, "specified keysym \"", field,
"\" for non-key event", (char *) NULL);
return NULL;
}
patPtr->detail = (int) Tcl_GetHashValue(hPtr);
}
} else if (patPtr->eventType == -1) {
interp->result = "no event type or button # or keysym";
return NULL;
}
while ((*p == '-') || isspace(UCHAR(*p))) {
p++;
}
if (*p != '>') {
interp->result = "missing \">\" in binding";
return NULL;
}
p++;
/*
* Replicate events for DOUBLE and TRIPLE.
*/
if ((count > 1) && (numPats < EVENT_BUFFER_SIZE-1)) {
patPtr[-1] = patPtr[0];
patPtr--;
numPats++;
if ((count == 3) && (numPats < EVENT_BUFFER_SIZE-1)) {
patPtr[-1] = patPtr[0];
patPtr--;
numPats++;
}
}
}
/*
*-------------------------------------------------------------
* Step 2: find the sequence in the binding table if it exists,
* and add a new sequence to the table if it doesn't.
*-------------------------------------------------------------
*/
if (numPats == 0) {
interp->result = "no events specified in binding";
return NULL;
}
patPtr = &pats[EVENT_BUFFER_SIZE-numPats];
key.object = object;
key.type = patPtr->eventType;
key.detail = patPtr->detail;
hPtr = Tcl_CreateHashEntry(&bindPtr->patternTable, (char *) &key, &new);
sequenceSize = numPats*sizeof(Pattern);
if (!new) {
for (psPtr = (PatSeq *) Tcl_GetHashValue(hPtr); psPtr != NULL;
psPtr = psPtr->nextSeqPtr) {
if ((numPats == psPtr->numPats)
&& ((flags & PAT_NEARBY) == (psPtr->flags & PAT_NEARBY))
&& (memcmp((char *) patPtr, (char *) psPtr->pats,
sequenceSize) == 0)) {
goto done;
}
}
}
if (!create) {
if (new) {
Tcl_DeleteHashEntry(hPtr);
}
Tcl_AppendResult(interp, "no binding exists for \"",
eventString, "\"", (char *) NULL);
return NULL;
}
psPtr = (PatSeq *) ckalloc((unsigned) (sizeof(PatSeq)
+ (numPats-1)*sizeof(Pattern)));
psPtr->numPats = numPats;
psPtr->command = NULL;
psPtr->flags = flags;
psPtr->nextSeqPtr = (PatSeq *) Tcl_GetHashValue(hPtr);
psPtr->hPtr = hPtr;
Tcl_SetHashValue(hPtr, psPtr);
/*
* Link the pattern into the list associated with the object.
*/
psPtr->object = object;
hPtr = Tcl_CreateHashEntry(&bindPtr->objectTable, (char *) object, &new);
if (new) {
psPtr->nextObjPtr = NULL;
} else {
psPtr->nextObjPtr = (PatSeq *) Tcl_GetHashValue(hPtr);
}
Tcl_SetHashValue(hPtr, psPtr);
memcpy((VOID *) psPtr->pats, (VOID *) patPtr, sequenceSize);
done:
*maskPtr = eventMask;
return psPtr;
}
/*
*----------------------------------------------------------------------
*
* GetField --
*
* Used to parse pattern descriptions. Copies up to
* size characters from p to copy, stopping at end of
* string, space, "-", ">", or whenever size is
* exceeded.
*
* Results:
* The return value is a pointer to the character just
* after the last one copied (usually "-" or space or
* ">", but could be anything if size was exceeded).
* Also places NULL-terminated string (up to size
* character, including NULL), at copy.
*
* Side effects:
* None.
*
*----------------------------------------------------------------------
*/
static char *
GetField(p, copy, size)
register char *p; /* Pointer to part of pattern. */
register char *copy; /* Place to copy field. */
int size; /* Maximum number of characters to
* copy. */
{
while ((*p != '\0') && !isspace(UCHAR(*p)) && (*p != '>')
&& (*p != '-') && (size > 1)) {
*copy = *p;
p++;
copy++;
size--;
}
*copy = '\0';
return p;
}
/*
*----------------------------------------------------------------------
*
* GetKeySym --
*
* Given an X KeyPress or KeyRelease event, map the
* keycode in the event into a KeySym.
*
* Results:
* The return value is the KeySym corresponding to
* eventPtr, or NoSymbol if no matching Keysym could be
* found.
*
* Side effects:
* In the first call for a given display, keycode-to-
* KeySym maps get loaded.
*
*----------------------------------------------------------------------
*/
static KeySym
GetKeySym(dispPtr, eventPtr)
register TkDisplay *dispPtr; /* Display in which to
* map keycode. */
register XEvent *eventPtr; /* Description of X event. */
{
KeySym sym;
int index;
/*
* Refresh the mapping information if it's stale
*/
if (dispPtr->bindInfoStale) {
InitKeymapInfo(dispPtr);
}
/*
* Figure out which of the four slots in the keymap vector to
* use for this key. Refer to Xlib documentation for more info
* on how this computation works.
*/
index = 0;
if (eventPtr->xkey.state & dispPtr->modeModMask) {
index = 2;
}
if ((eventPtr->xkey.state & ShiftMask)
|| ((dispPtr->lockUsage != IGNORE)
&& (eventPtr->xkey.state & LockMask))) {
index += 1;
}
sym = XKeycodeToKeysym(dispPtr->display, eventPtr->xkey.keycode, index);
/*
* Special handling: if the key was shifted because of Lock, but
* lock is only caps lock, not shift lock, and the shifted keysym
* isn't upper-case alphabetic, then switch back to the unshifted
* keysym.
*/
if ((index & 1) && !(eventPtr->xkey.state & ShiftMask)
&& (dispPtr->lockUsage == CAPS)) {
if (!(((sym >= XK_A) && (sym <= XK_Z))
|| ((sym >= XK_Agrave) && (sym <= XK_Odiaeresis))
|| ((sym >= XK_Ooblique) && (sym <= XK_Thorn)))) {
index &= ~1;
sym = XKeycodeToKeysym(dispPtr->display, eventPtr->xkey.keycode,
index);
}
}
/*
* Another bit of special handling: if this is a shifted key and there
* is no keysym defined, then use the keysym for the unshifted key.
*/
if ((index & 1) && (sym == NoSymbol)) {
sym = XKeycodeToKeysym(dispPtr->display, eventPtr->xkey.keycode,
index & ~1);
}
return sym;
}
/*
*----------------------------------------------------------------------
*
* MatchPatterns --
*
* Given a list of pattern sequences and a list of
* recent events, return a pattern sequence that matches
* the event list.
*
* Results:
* The return value is NULL if no pattern matches the
* recent events from bindPtr. If one or more patterns
* matches, then the longest (or most specific) matching
* pattern is returned.
*
* Side effects:
* None.
*
*----------------------------------------------------------------------
*/
static PatSeq *
MatchPatterns(dispPtr, bindPtr, psPtr)
TkDisplay *dispPtr; /* Display from which the event came. */
BindingTable *bindPtr; /* Information about binding table, such
* as ring of recent events. */
register PatSeq *psPtr; /* List of pattern sequences. */
{
register PatSeq *bestPtr = NULL;
/*
* Iterate over all the pattern sequences.
*/
for ( ; psPtr != NULL; psPtr = psPtr->nextSeqPtr) {
register XEvent *eventPtr;
register Pattern *patPtr;
Window window;
int *detailPtr;
int patCount, ringCount, flags, state;
/*
* Iterate over all the patterns in a sequence to be
* sure that they all match.
*/
eventPtr = &bindPtr->eventRing[bindPtr->curEvent];
detailPtr = &bindPtr->detailRing[bindPtr->curEvent];
window = eventPtr->xany.window;
patPtr = psPtr->pats;
patCount = psPtr->numPats;
ringCount = EVENT_BUFFER_SIZE;
while (patCount > 0) {
if (ringCount <= 0) {
goto nextSequence;
}
if (eventPtr->xany.type != patPtr->eventType) {
/*
* Most of the event types are considered superfluous
* in that they are ignored if they occur in the middle
* of a pattern sequence and have mismatching types. The
* only ones that cannot be ignored are ButtonPress and
* ButtonRelease events (unless the next event in the pattern
* is a KeyPress or KeyRelease) and KeyPress and KeyRelease
* events (unless the next pattern event is a KeyPress or
* KeyRelease). Here are some tricky cases to consider:
* 1. Double-Button or Double-Key events.
* 2. Double-ButtonRelease or Double-KeyRelease events.
* 3. The arrival of various events like Enter and Leave
* and FocusIn and GraphicsExpose between two button
* presses or key presses.
*/
if ((patPtr->eventType == KeyPress)
|| (patPtr->eventType == KeyRelease)) {
if ((eventPtr->xany.type == ButtonPress)
|| (eventPtr->xany.type == ButtonRelease)) {
goto nextSequence;
}
} else if ((patPtr->eventType == ButtonPress)
|| (patPtr->eventType == ButtonRelease)) {
if ((eventPtr->xany.type == KeyPress)
|| (eventPtr->xany.type == KeyRelease)) {
goto nextSequence;
}
}
goto nextEvent;
}
if (eventPtr->xany.window != window) {
goto nextSequence;
}
flags = flagArray[eventPtr->type];
if (flags & KEY_BUTTON_MOTION) {
state = eventPtr->xkey.state;
} else if (flags & CROSSING) {
state = eventPtr->xcrossing.state;
} else {
state = 0;
}
if ((state & patPtr->needMods)
!= patPtr->needMods) {
goto nextSequence;
}
if ((state & patPtr->hateMods) != 0) {
/*
* There appear to be unwanted modifiers. However, if this
* is a KeyPress or KeyRelease event then ignore modifiers
* such as shift, lock, and mode_switch, since they are
* already included in the keysym spec.
*/
if (((patPtr->eventType != KeyPress)
&& (patPtr->eventType != KeyRelease))
|| ((state & patPtr->hateMods
& ~dispPtr->ignoreModMask) != 0)) {
goto nextSequence;
}
}
if ((patPtr->detail != 0)
&& (patPtr->detail != *detailPtr)) {
/*
* The detail appears not to match. However, if the event
* is a KeyPress for a modifier key then just ignore the
* event. Otherwise event sequences like "aD" never match
* because the shift key goes down between the "a" and the
* "D".
*/
if (eventPtr->xany.type == KeyPress) {
int i;
for (i = 0; i < dispPtr->numModKeyCodes; i++) {
if (dispPtr->modKeyCodes[i] == eventPtr->xkey.keycode) {
goto nextEvent;
}
}
}
goto nextSequence;
}
if (psPtr->flags & PAT_NEARBY) {
register XEvent *firstPtr;
firstPtr = &bindPtr->eventRing[bindPtr->curEvent];
if ((firstPtr->xkey.x_root
< (eventPtr->xkey.x_root - NEARBY_PIXELS))
|| (firstPtr->xkey.x_root
> (eventPtr->xkey.x_root + NEARBY_PIXELS))
|| (firstPtr->xkey.y_root
< (eventPtr->xkey.y_root - NEARBY_PIXELS))
|| (firstPtr->xkey.y_root
> (eventPtr->xkey.y_root + NEARBY_PIXELS))
|| (firstPtr->xkey.time
> (eventPtr->xkey.time + NEARBY_MS))) {
goto nextSequence;
}
}
patPtr++;
patCount--;
nextEvent:
if (eventPtr == bindPtr->eventRing) {
eventPtr = &bindPtr->eventRing[EVENT_BUFFER_SIZE-1];
detailPtr = &bindPtr->detailRing[EVENT_BUFFER_SIZE-1];
} else {
eventPtr--;
detailPtr--;
}
ringCount--;
}
/*
* This sequence matches. If we've already got another match,
* pick whichever is most specific. Detail is most important,
* then needMods, then hateMods.
*/
if (bestPtr != NULL) {
register Pattern *patPtr2;
int i;
if (psPtr->numPats != bestPtr->numPats) {
if (bestPtr->numPats > psPtr->numPats) {
goto nextSequence;
} else {
goto newBest;
}
}
for (i = 0, patPtr = psPtr->pats, patPtr2 = bestPtr->pats;
i < psPtr->numPats; i++,patPtr++, patPtr2++) {
if (patPtr->detail != patPtr2->detail) {
if (patPtr->detail == 0) {
goto nextSequence;
} else {
goto newBest;
}
}
if (patPtr->needMods != patPtr2->needMods) {
if ((patPtr->needMods & patPtr2->needMods)
== patPtr->needMods) {
goto nextSequence;
} else {
goto newBest;
}
}
if (patPtr->hateMods != patPtr2->hateMods) {
if ((patPtr->hateMods & patPtr2->hateMods)
== patPtr2->hateMods) {
goto newBest;
} else {
goto nextSequence;
}
}
}
goto nextSequence; /* Tie goes to newest pattern. */
}
newBest:
bestPtr = psPtr;
nextSequence: continue;
}
return bestPtr;
}
/*
*--------------------------------------------------------------
*
* ExpandPercents --
*
* Given a command and an event, produce a new command
* by replacing % constructs in the original command
* with information from the X event.
*
* Results:
* The return result is a pointer to the new %-substituted
* command. If the command fits in the space at after, then
* the return value is after. If the command is too large
* to fit at after, then the return value is a pointer to
* a malloc-ed buffer holding the command; in this case it
* is the caller's responsibility to free up the buffer when
* finished with it.
*
* Side effects:
* None.
*
*--------------------------------------------------------------
*/
static char *
ExpandPercents(before, eventPtr, keySym, after, afterSize)
register char *before; /* Command containing percent
* expressions to be replaced. */
register XEvent *eventPtr; /* X event containing information
* to be used in % replacements. */
KeySym keySym; /* KeySym: only relevant for
* KeyPress and KeyRelease events). */
char *after; /* Place to generate new expanded
* command. Must contain at least
* "afterSize" bytes of space. */
int afterSize; /* Number of bytes of space available at
* after. */
{
register char *buffer; /* Pointer to buffer currently being used
* as destination. */
register char *dst; /* Pointer to next place to store character
* in substituted string. */
int spaceLeft; /* Indicates how many more non-null bytes
* may be stored at *dst before space
* runs out. */
int spaceNeeded, cvtFlags; /* Used to substitute string as proper Tcl
* list element. */
int number, flags;
#define NUM_SIZE 40
register char *string;
char numStorage[NUM_SIZE+1];
if (eventPtr->type < LASTEvent) {
flags = flagArray[eventPtr->type];
} else {
flags = 0;
}
dst = buffer = after;
spaceLeft = afterSize - 1;
while (*before != 0) {
if (*before != '%') {
/*
* Expand the destination string if necessary.
*/
if (spaceLeft <= 0) {
char *newSpace;
newSpace = (char *) ckalloc((unsigned) (2*afterSize));
memcpy((VOID *) newSpace, (VOID *) buffer, afterSize);
afterSize *= 2;
dst = newSpace + (dst - buffer);
if (buffer != after) {
ckfree(buffer);
}
buffer = newSpace;
spaceLeft = afterSize - (dst-buffer) - 1;
}
*dst = *before;
dst++;
before++;
spaceLeft--;
continue;
}
number = 0;
string = "??";
switch (before[1]) {
case '#':
number = eventPtr->xany.serial;
goto doNumber;
case 'a':
number = (int) eventPtr->xconfigure.above;
goto doNumber;
case 'b':
number = eventPtr->xbutton.button;
goto doNumber;
case 'c':
if (flags & EXPOSE) {
number = eventPtr->xexpose.count;
} else if (flags & MAPPING) {
number = eventPtr->xmapping.count;
}
goto doNumber;
case 'd':
if (flags & (CROSSING|FOCUS)) {
if (flags & FOCUS) {
number = eventPtr->xfocus.detail;
} else {
number = eventPtr->xcrossing.detail;
}
switch (number) {
case NotifyAncestor:
string = "NotifyAncestor";
break;
case NotifyVirtual:
string = "NotifyVirtual";
break;
case NotifyInferior:
string = "NotifyInferior";
break;
case NotifyNonlinear:
string = "NotifyNonlinear";
break;
case NotifyNonlinearVirtual:
string = "NotifyNonlinearVirtual";
break;
case NotifyPointer:
string = "NotifyPointer";
break;
case NotifyPointerRoot:
string = "NotifyPointerRoot";
break;
case NotifyDetailNone:
string = "NotifyDetailNone";
break;
}
} else if (flags & CONFIG_REQ) {
switch (eventPtr->xconfigurerequest.detail) {
case Above:
string = "Above";
break;
case Below:
string = "Below";
break;
case TopIf:
string = "TopIf";
break;
case BottomIf:
string = "BottomIf";
break;
case Opposite:
string = "Opposite";
break;
}
}
goto doString;
case 'f':
number = eventPtr->xcrossing.focus;
goto doNumber;
case 'h':
if (flags & EXPOSE) {
number = eventPtr->xexpose.height;
} else if (flags & (CONFIG|CONFIG_REQ)) {
number = eventPtr->xconfigure.height;
} else if (flags & RESIZE_REQ) {
number = eventPtr->xresizerequest.height;
}
goto doNumber;
case 'k':
number = eventPtr->xkey.keycode;
goto doNumber;
case 'm':
if (flags & CROSSING) {
number = eventPtr->xcrossing.mode;
} else if (flags & FOCUS) {
number = eventPtr->xfocus.mode;
}
switch (number) {
case NotifyNormal:
string = "NotifyNormal";
break;
case NotifyGrab:
string = "NotifyGrab";
break;
case NotifyUngrab:
string = "NotifyUngrab";
break;
case NotifyWhileGrabbed:
string = "NotifyWhileGrabbed";
break;
}
goto doString;
case 'o':
if (flags & CREATE) {
number = eventPtr->xcreatewindow.override_redirect;
} else if (flags & MAP) {
number = eventPtr->xmap.override_redirect;
} else if (flags & REPARENT) {
number = eventPtr->xreparent.override_redirect;
} else if (flags & CONFIG) {
number = eventPtr->xconfigure.override_redirect;
}
goto doNumber;
case 'p':
switch (eventPtr->xcirculate.place) {
case PlaceOnTop:
string = "PlaceOnTop";
break;
case PlaceOnBottom:
string = "PlaceOnBottom";
break;
}
goto doString;
case 's':
if (flags & KEY_BUTTON_MOTION) {
number = eventPtr->xkey.state;
} else if (flags & CROSSING) {
number = eventPtr->xcrossing.state;
} else if (flags & VISIBILITY) {
switch (eventPtr->xvisibility.state) {
case VisibilityUnobscured:
string = "VisibilityUnobscured";
break;
case VisibilityPartiallyObscured:
string = "VisibilityPartiallyObscured";
break;
case VisibilityFullyObscured:
string = "VisibilityFullyObscured";
break;
}
goto doString;
}
goto doNumber;
case 't':
if (flags & (KEY_BUTTON_MOTION|PROP|SEL_CLEAR)) {
number = (int) eventPtr->xkey.time;
} else if (flags & SEL_REQ) {
number = (int) eventPtr->xselectionrequest.time;
} else if (flags & SEL_NOTIFY) {
number = (int) eventPtr->xselection.time;
}
goto doNumber;
case 'v':
number = eventPtr->xconfigurerequest.value_mask;
goto doNumber;
case 'w':
if (flags & EXPOSE) {
number = eventPtr->xexpose.width;
} else if (flags & (CONFIG|CONFIG_REQ)) {
number = eventPtr->xconfigure.width;
} else if (flags & RESIZE_REQ) {
number = eventPtr->xresizerequest.width;
}
goto doNumber;
case 'x':
if (flags & KEY_BUTTON_MOTION) {
number = eventPtr->xkey.x;
} else if (flags & EXPOSE) {
number = eventPtr->xexpose.x;
} else if (flags & (CREATE|CONFIG|GRAVITY|CONFIG_REQ)) {
number = eventPtr->xcreatewindow.x;
} else if (flags & REPARENT) {
number = eventPtr->xreparent.x;
} else if (flags & CROSSING) {
number = eventPtr->xcrossing.x;
}
goto doNumber;
case 'y':
if (flags & KEY_BUTTON_MOTION) {
number = eventPtr->xkey.y;
} else if (flags & EXPOSE) {
number = eventPtr->xexpose.y;
} else if (flags & (CREATE|CONFIG|GRAVITY|CONFIG_REQ)) {
number = eventPtr->xcreatewindow.y;
} else if (flags & REPARENT) {
number = eventPtr->xreparent.y;
} else if (flags & CROSSING) {
number = eventPtr->xcrossing.y;
}
goto doNumber;
case 'A':
if ((eventPtr->type == KeyPress)
|| (eventPtr->type == KeyRelease)) {
int numChars;
numChars = XLookupString(&eventPtr->xkey, numStorage,
NUM_SIZE, (KeySym *) NULL,
(XComposeStatus *) NULL);
numStorage[numChars] = '\0';
string = numStorage;
}
goto doString;
case 'B':
number = eventPtr->xcreatewindow.border_width;
goto doNumber;
case 'D':
number = (int) eventPtr->xany.display;
goto doNumber;
case 'E':
number = (int) eventPtr->xany.send_event;
goto doNumber;
case 'K':
if ((eventPtr->type == KeyPress)
|| (eventPtr->type == KeyRelease)) {
register KeySymInfo *kPtr;
for (kPtr = keyArray; kPtr->name != NULL; kPtr++) {
if (kPtr->value == keySym) {
string = kPtr->name;
break;
}
}
}
goto doString;
case 'N':
number = (int) keySym;
goto doNumber;
case 'R':
number = (int) eventPtr->xkey.root;
goto doNumber;
case 'S':
number = (int) eventPtr->xkey.subwindow;
goto doNumber;
case 'T':
number = eventPtr->type;
goto doNumber;
case 'W': {
TkWindow *winPtr;
if (XFindContext(eventPtr->xany.display, eventPtr->xany.window,
tkWindowContext, (caddr_t *) &winPtr) == 0) {
string = winPtr->pathName;
} else {
string = "??";
}
goto doString;
}
case 'X': {
Tk_Window tkwin;
int x, y;
unsigned int width, height;
number = eventPtr->xkey.x_root;
if (XFindContext(eventPtr->xany.display, eventPtr->xany.window,
tkWindowContext, (caddr_t *) &tkwin) == 0) {
Tk_GetVRootGeometry(tkwin, &x, &y, &width, &height);
number -= x;
}
goto doNumber;
}
case 'Y': {
Tk_Window tkwin;
int x, y;
unsigned int width, height;
number = eventPtr->xkey.y_root;
if (XFindContext(eventPtr->xany.display, eventPtr->xany.window,
tkWindowContext, (caddr_t *) &tkwin) == 0) {
Tk_GetVRootGeometry(tkwin, &x, &y, &width, &height);
number -= y;
}
goto doNumber;
}
default:
numStorage[0] = before[1];
numStorage[1] = '\0';
string = numStorage;
goto doString;
}
doNumber:
sprintf(numStorage, "%d", number);
string = numStorage;
doString:
spaceNeeded = Tcl_ScanElement(string, &cvtFlags);
if (spaceNeeded >= spaceLeft) {
char *newSpace;
newSpace = (char *) ckalloc((unsigned)
(afterSize + spaceNeeded + 50));
memcpy((VOID *) newSpace, (VOID *) buffer, afterSize);
afterSize += spaceNeeded + 50;
dst = newSpace + (dst - buffer);
if (buffer != after) {
ckfree(buffer);
}
buffer = newSpace;
spaceLeft = afterSize - (dst-buffer) - 1;
}
spaceNeeded = Tcl_ConvertElement(string, dst,
cvtFlags | TCL_DONT_USE_BRACES);
dst += spaceNeeded;
spaceLeft -= spaceNeeded;
before += 2;
}
*dst = '\0';
return buffer;
}
/*
*----------------------------------------------------------------------
*
* Tk_BackgroundError --
*
* This procedure is invoked to handle errors that occur in Tcl
* commands that are invoked in "background" (e.g. from event or
* timer bindings).
*
* Results:
* None.
*
* Side effects:
* The command "tkerror" is invoked to process the error, passing
* it the error message. If that fails, then an error message
* is output on stderr.
*
*----------------------------------------------------------------------
*/
void
Tk_BackgroundError(interp)
Tcl_Interp *interp; /* Interpreter in which an error has
* occurred. */
{
char *argv[2];
char *command;
char *error;
char *errorInfo, *tmp;
int result;
/*
* The Tcl_AddErrorInfo call below (with an empty string) ensures that
* errorInfo gets properly set. It's needed in cases where the error
* came from a utility procedure like Tcl_GetVar instead of Tcl_Eval;
* in these cases errorInfo still won't have been set when this
* procedure is called.
*/
Tcl_AddErrorInfo(interp, "");
error = (char *) ckalloc((unsigned) (strlen(interp->result) + 1));
strcpy(error, interp->result);
tmp = Tcl_GetVar(interp, "errorInfo", TCL_GLOBAL_ONLY);
if (tmp == NULL) {
errorInfo = error;
} else {
errorInfo = (char *) ckalloc((unsigned) (strlen(tmp) + 1));
strcpy(errorInfo, tmp);
}
argv[0] = "tkerror";
argv[1] = error;
command = Tcl_Merge(2, argv);
result = Tcl_GlobalEval(interp, command);
if (result != TCL_OK) {
if (strcmp(interp->result, "\"tkerror\" is an invalid command name or ambiguous abbreviation") == 0) {
fprintf(stderr, "%s\n", errorInfo);
} else {
fprintf(stderr, "tkerror failed to handle background error.\n");
fprintf(stderr, " Original error: %s\n", error);
fprintf(stderr, " Error in tkerror: %s\n", interp->result);
}
}
Tcl_ResetResult(interp);
ckfree(command);
ckfree(error);
if (errorInfo != error) {
ckfree(errorInfo);
}
}
/*
*----------------------------------------------------------------------
*
* TkCopyAndGlobalEval --
*
* This procedure makes a copy of a script then calls Tcl_GlobalEval
* to evaluate it. It's used in situations where the execution of
* a command may cause the original command string to be reallocated.
*
* Results:
* Returns the result of evaluating script, including both a standard
* Tcl completion code and a string in interp->result.
*
* Side effects:
* None.
*
*----------------------------------------------------------------------
*/
int
TkCopyAndGlobalEval(interp, script)
Tcl_Interp *interp; /* Interpreter in which to evaluate
* script. */
char *script; /* Script to evaluate. */
{
Tcl_DString buffer;
int code;
Tcl_DStringInit(&buffer);
Tcl_DStringAppend(&buffer, script, -1);
code = Tcl_GlobalEval(interp, Tcl_DStringValue(&buffer));
Tcl_DStringFree(&buffer);
return code;
}
/*
*--------------------------------------------------------------
*
* InitKeymapInfo --
*
* This procedure is invoked to scan keymap information
* to recompute stuff that's important for binding, such
* as the modifier key (if any) that corresponds to "mode
* switch".
*
* Results:
* None.
*
* Side effects:
* Keymap-related information in dispPtr is updated.
*
*--------------------------------------------------------------
*/
static void
InitKeymapInfo(dispPtr)
TkDisplay *dispPtr; /* Display for which to recompute keymap
* information. */
{
XModifierKeymap *modMapPtr;
register KeyCode *codePtr;
KeySym keysym;
int count, i, j, max, arraySize;
#define KEYCODE_ARRAY_SIZE 20
dispPtr->bindInfoStale = 0;
modMapPtr = XGetModifierMapping(dispPtr->display);
/*
* Check the keycodes associated with the Lock modifier. If
* any of them is associated with the XK_Shift_Lock modifier,
* then Lock has to be interpreted as Shift Lock, not Caps Lock.
*/
dispPtr->lockUsage = IGNORE;
codePtr = modMapPtr->modifiermap + modMapPtr->max_keypermod*LockMapIndex;
for (count = modMapPtr->max_keypermod; count > 0; count--, codePtr++) {
if (*codePtr == 0) {
continue;
}
keysym = XKeycodeToKeysym(dispPtr->display, *codePtr, 0);
if (keysym == XK_Shift_Lock) {
dispPtr->lockUsage = SHIFT;
break;
}
if (keysym == XK_Caps_Lock) {
dispPtr->lockUsage = CAPS;
break;
}
}
/*
* See if the "mode switch" keysym is associated with any keycode
* associated with any modifier. If so, store a mask for all such
* modifiers in dispPtr->modeModMask. At the same time, see if
* there is a Num_Lock key that generates a modifier, and if so
* save its modifier mask too.
*/
dispPtr->modeModMask = 0;
dispPtr->ignoreModMask = 0;
codePtr = modMapPtr->modifiermap;
max = 8*modMapPtr->max_keypermod;
for (i = 0; i < max; i++, codePtr++) {
if (*codePtr == 0) {
continue;
}
if (XKeycodeToKeysym(dispPtr->display, *codePtr, 0)
== XK_Mode_switch) {
dispPtr->modeModMask |= ShiftMask << (i/modMapPtr->max_keypermod);
}
if (XKeycodeToKeysym(dispPtr->display, *codePtr, 0)
== XK_Num_Lock) {
dispPtr->ignoreModMask |= ShiftMask << (i/modMapPtr->max_keypermod);
}
}
dispPtr->ignoreModMask |= ShiftMask|LockMask|dispPtr->modeModMask;
/*
* Create an array of the keycodes for all modifier keys.
*/
if (dispPtr->modKeyCodes != NULL) {
ckfree((char *) dispPtr->modKeyCodes);
}
dispPtr->numModKeyCodes = 0;
arraySize = KEYCODE_ARRAY_SIZE;
dispPtr->modKeyCodes = (KeyCode *) ckalloc((unsigned)
(KEYCODE_ARRAY_SIZE * sizeof(KeyCode)));
for (i = 0, codePtr = modMapPtr->modifiermap; i < max; i++, codePtr++) {
if (*codePtr == 0) {
continue;
}
/*
* Make sure that the keycode isn't already in the array.
*/
for (j = 0; ; j++) {
if (dispPtr->modKeyCodes[j] == *codePtr) {
break;
}
if (j < dispPtr->numModKeyCodes) {
continue;
}
if (dispPtr->numModKeyCodes >= arraySize) {
KeyCode *new;
/*
* Ran out of space in the array; grow it.
*/
arraySize *= 2;
new = (KeyCode *) ckalloc((unsigned)
(arraySize * sizeof(KeyCode)));
memcpy((VOID *) new, (VOID *) dispPtr->modKeyCodes,
(dispPtr->numModKeyCodes * sizeof(KeyCode)));
ckfree((char *) dispPtr->modKeyCodes);
dispPtr->modKeyCodes = new;
}
dispPtr->modKeyCodes[dispPtr->numModKeyCodes] = *codePtr;
dispPtr->numModKeyCodes++;
break;
}
}
XFreeModifiermap(modMapPtr);
}