]> git.zerfleddert.de Git - micropolis/blob - src/tk/tkint.h
replace call to setpgrp with setpgid, as setpgrp is defined different on OS X Tiger
[micropolis] / src / tk / tkint.h
1 /*
2 * tkInt.h --
3 *
4 * Declarations for things used internally by the Tk
5 * procedures but not exported outside the module.
6 *
7 * Copyright 1990-1992 Regents of the University of California.
8 * Permission to use, copy, modify, and distribute this
9 * software and its documentation for any purpose and without
10 * fee is hereby granted, provided that the above copyright
11 * notice appear in all copies. The University of California
12 * makes no representations about the suitability of this
13 * software for any purpose. It is provided "as is" without
14 * express or implied warranty.
15 *
16 * $Header: /user6/ouster/wish/RCS/tkInt.h,v 1.65 92/08/21 11:42:27 ouster Exp $ SPRITE (Berkeley)
17 */
18
19 #ifndef _TKINT
20 #define _TKINT
21
22 #ifndef _XLIB_H_
23 #include <X11/Xlib.h>
24 #ifdef IS_LINUX
25 #include <X11/Xlibint.h>
26 #endif
27 #endif
28 #ifndef _XUTIL_H
29 #include <X11/Xutil.h>
30 #endif
31 #ifndef _TK
32 #include "tk.h"
33 #endif
34 #ifndef _TCL
35 #include "tcl.h"
36 #endif
37 #ifndef _TCLHASH
38 #include "tclhash.h"
39 #endif
40
41 /*
42 * One of the following structures is maintained for each display
43 * containing a window managed by Tk:
44 */
45
46 typedef struct TkDisplay {
47 Display *display; /* Xlib's info about display. */
48 struct TkDisplay *nextPtr; /* Next in list of all displays. */
49 char *name; /* Name of display (with any screen
50 * identifier removed). Malloc-ed. */
51 Time lastEventTime; /* Time of last event received for this
52 * display. */
53
54 /*
55 * Information used by tkEvent.c only:
56 */
57
58 struct TkWindow *mouseMainPtr;
59 /* Pointer to the main window of this
60 * display that currently contains the
61 * mouse pointer. NULL means the pointer
62 * isn't in a main window managed by
63 * this process. */
64
65 /*
66 * Information used by tkBind.c only:
67 */
68
69 int firstKeycode; /* First keycode supported by
70 * display. */
71 int lastKeycode; /* Last keycode supported by
72 * display. */
73 int symsPerCode; /* Number of KeySyms in "keySyms"
74 * for each keycode. 0 means the
75 * keysym information hasn't been
76 * retrieved from the server yet. */
77 KeySym *keySyms; /* Array of KeySyms, returned by
78 * XGetKeyboardMapping. */
79
80 /*
81 * Information used by tkError.c only:
82 */
83
84 struct TkErrorHandler *errorPtr;
85 /* First in list of error handlers
86 * for this display. NULL means
87 * no handlers exist at present. */
88 int deleteCount; /* Counts # of handlers deleted since
89 * last time inactive handlers were
90 * garbage-collected. When this number
91 * gets big, handlers get cleaned up. */
92
93 /*
94 * Information used by tkSend.c only:
95 */
96
97 Tk_Window commWindow; /* Window used for communication
98 * between interpreters during "send"
99 * commands. NULL means send info hasn't
100 * been initialized yet. */
101 Atom commProperty; /* X's name for comm property. */
102 Atom registryProperty; /* X's name for property containing
103 * registry of interpreter names. */
104
105 /*
106 * Information used by tkSelect.c only:
107 */
108
109 Tk_Window selectionOwner; /* Current owner of selection, or
110 * NULL if selection isn't owned by
111 * a window in this process. */
112 int selectionSerial; /* Serial number of last XSelectionSetOwner
113 * request we made to server (used to
114 * filter out redundant SelectionClear
115 * events. */
116 Time selectionTime; /* Timestamp used to acquire selection. */
117 Atom multipleAtom; /* Atom for MULTIPLE. None means
118 * selection stuff isn't initialized. */
119 Atom incrAtom; /* Atom for INCR. */
120 Atom targetsAtom; /* Atom for TARGETS. */
121 Atom timestampAtom; /* Atom for TIMESTAMP. */
122 Atom textAtom; /* Atom for TEXT. */
123 Atom compoundTextAtom; /* Atom for COMPOUND_TEXT. */
124
125 /*
126 * Information used by tkAtom.c only:
127 */
128
129 int atomInit; /* 0 means stuff below hasn't been
130 * initialized yet. */
131 Tcl_HashTable nameTable; /* Maps from names to Atom's. */
132 Tcl_HashTable atomTable; /* Maps from Atom's back to names. */
133
134 /*
135 * Information used by tkCursor.c only:
136 */
137
138 Font cursorFont; /* Font to use for standard cursors.
139 * None means font not loaded yet. */
140
141 /*
142 * Information used by tkGrab.c only:
143 */
144
145 struct TkWindow *grabWinPtr;
146 /* Window in which the pointer is currently
147 * grabbed, or NULL if none. */
148 struct TkWindow *ungrabWinPtr;
149 /* Window to which pointer should be returned
150 * when the current grab ends (i.e. the
151 * window that the mouse is really on top
152 * of). */
153 struct TkWindow *buttonWinPtr;
154 /* Window in which first mouse button was
155 * pressed while grab was in effect, or NULL
156 * if no such press in effect. */
157 struct TkWindow *pointerWinPtr;
158 /* The window that officially contains the
159 * pointer, as far as this application is
160 * concerned. If a grab is in effect then
161 * this may not be the window that's underneath
162 * the pointer. NULL means the application
163 * doesn't consider the pointer to be in any
164 * window. */
165 struct TkWindow *serverWinPtr;
166 /* The window that contains the pointer, as
167 * far as the X server is concerned. This
168 * field gets set on every Enter or Leave
169 * event even if the grab code eventually
170 * discards the event. NULL means the server
171 * thinks the pointer is outside any window
172 * of any application on this screen. */
173 int grabFlags; /* Miscellaneous flag values. See definitions
174 * in tkGrab.c. */
175 /* XXX: FOCUS */
176 struct TkWindow *focusPtr; /* Identifies window that currently has the
177 * focus (or that will get the focus the next
178 * time the pointer enters any of the top-level
179 * windows associated with this display).
180 * NULL means nobody has the focus.
181 * Managed by tkEvent.c. */
182 } TkDisplay;
183
184 /*
185 * One of the following structures exists for each error handler
186 * created by a call to Tk_CreateErrorHandler. The structure
187 * is managed by tkError.c.
188 */
189
190 typedef struct TkErrorHandler {
191 TkDisplay *dispPtr; /* Display to which handler applies. */
192 unsigned long firstRequest; /* Only errors with serial numbers
193 * >= to this are considered. */
194 unsigned long lastRequest; /* Only errors with serial numbers
195 * <= to this are considered. This
196 * field is filled in when XUnhandle
197 * is called. -1 means XUnhandle
198 * hasn't been called yet. */
199 int error; /* Consider only errors with this
200 * error_code (-1 means consider
201 * all errors). */
202 int request; /* Consider only errors with this
203 * major request code (-1 means
204 * consider all major codes). */
205 int minorCode; /* Consider only errors with this
206 * minor request code (-1 means
207 * consider all minor codes). */
208 Tk_ErrorProc *errorProc; /* Procedure to invoke when a matching
209 * error occurs. NULL means just ignore
210 * errors. */
211 ClientData clientData; /* Arbitrary value to pass to
212 * errorProc. */
213 struct TkErrorHandler *nextPtr;
214 /* Pointer to next older handler for
215 * this display, or NULL for end of
216 * list. */
217 } TkErrorHandler;
218
219 /*
220 * One of the following structures exists for each event handler
221 * created by calling Tk_CreateEventHandler. This information
222 * is used by tkEvent.c only.
223 */
224
225 typedef struct TkEventHandler {
226 unsigned long mask; /* Events for which to invoke
227 * proc. */
228 Tk_EventProc *proc; /* Procedure to invoke when an event
229 * in mask occurs. */
230 ClientData clientData; /* Argument to pass to proc. */
231 struct TkEventHandler *nextPtr;
232 /* Next in list of handlers
233 * associated with window (NULL means
234 * end of list). */
235 } TkEventHandler;
236
237 /*
238 * One of the following structures exists for each selection
239 * handler created by calling Tk_CreateSelHandler. This
240 * information is used by tkSelect.c only.
241 */
242
243 typedef struct TkSelHandler {
244 Atom target; /* Target type for selection
245 * conversion, such as TARGETS or
246 * STRING. */
247 Atom format; /* Format in which selection
248 * info will be returned, such
249 * as STRING or ATOM. */
250 Tk_SelectionProc *proc; /* Procedure to generate selection
251 * in this format. */
252 ClientData clientData; /* Argument to pass to proc. */
253 int size; /* Size of units returned by proc
254 * (8 for STRING, 32 for almost
255 * anything else). */
256 struct TkSelHandler *nextPtr;
257 /* Next selection handler associated
258 * with same window (NULL for end of
259 * list). */
260 } TkSelHandler;
261
262 /*
263 * Tk keeps one of the following data structures for each main
264 * window (created by a call to Tk_CreateMainWindow). It stores
265 * information that is shared by all of the windows associated
266 * with a particular main window.
267 */
268
269 typedef struct TkMainInfo {
270 struct TkWindow *winPtr; /* Pointer to main window. */
271 Tcl_Interp *interp; /* Interpreter associated with application. */
272 Tcl_HashTable nameTable; /* Hash table mapping path names to TkWindow
273 * structs for all windows related to this
274 * main window. Managed by tkWindow.c. */
275 Tk_BindingTable bindingTable;
276 /* Used in conjunction with "bind" command
277 * to bind events to Tcl commands. */
278 /* XXX: FOCUS */
279 /* struct TkWindow *focusPtr; */ /* Identifies window that currently has the
280 * focus (or that will get the focus the next
281 * time the pointer enters any of the top-level
282 * windows associated with this display).
283 * NULL means nobody has the focus.
284 * Managed by tkEvent.c. */
285 struct ElArray *optionRootPtr;
286 /* Top level of option hierarchy for this
287 * main window. NULL means uninitialized.
288 * Managed by tkOption.c. */
289 } TkMainInfo;
290
291 /*
292 * Tk keeps one of the following structures for each window.
293 * Some of the information (like size and location) is a shadow
294 * of information managed by the X server, and some is special
295 * information used here, such as event and geometry management
296 * information. This information is (mostly) managed by tkWindow.c.
297 * WARNING: the declaration below must be kept consistent with the
298 * Tk_ClientWindow structure in tk.h. If you change one, be sure to
299 * change the other!!
300 */
301
302 typedef struct TkWindow {
303
304 /*
305 * Structural information:
306 */
307
308 Display *display; /* Display containing window. */
309 TkDisplay *dispPtr; /* Tk's information about display
310 * for window. */
311 int screenNum; /* Index of screen for window, among all
312 * those for dispPtr. */
313 Window window; /* X's id for window. NULL means window
314 * hasn't actually been created yet, or it's
315 * been deleted. */
316 struct TkWindow *childList; /* First in list of child windows,
317 * or NULL if no children. */
318 struct TkWindow *parentPtr; /* Pointer to parent window (logical
319 * parent, not necessarily X parent), or
320 * NULL if this is a main window. */
321 struct TkWindow *nextPtr; /* Next in list of children with
322 * same parent (NULL if end of
323 * list). */
324 TkMainInfo *mainPtr; /* Information shared by all windows
325 * associated with a particular main
326 * window. NULL means this window is
327 * a rogue that isn't associated with
328 * any application (at present, there
329 * should never be any rogues). */
330
331 /*
332 * Name and type information for the window:
333 */
334
335 char *pathName; /* Path name of window (concatenation
336 * of all names between this window and
337 * its top-level ancestor). This is a
338 * pointer into an entry in
339 * mainPtr->nameTable or NULL if mainPtr
340 * is NULL. */
341 Tk_Uid nameUid; /* Name of the window within its parent
342 * (unique within the parent). */
343 Tk_Uid classUid; /* Class of the window. NULL means window
344 * hasn't been given a class yet. */
345
346 /*
347 * Geometry and other attributes of window. This information
348 * may not be updated on the server immediately; stuff that
349 * hasn't been reflected in the server yet is called "dirty".
350 * At present, information can be dirty only if the window
351 * hasn't yet been created.
352 */
353
354 XWindowChanges changes; /* Geometry and other info about
355 * window. */
356 unsigned int dirtyChanges; /* Bits indicate fields of "changes"
357 * that are dirty. */
358 XSetWindowAttributes atts; /* Current attributes of window. */
359 unsigned long dirtyAtts; /* Bits indicate fields of "atts"
360 * that are dirty. */
361
362 unsigned int flags; /* Various flag values: these are all
363 * defined in tk.h (confusing, but they're
364 * needed there for some query macros). */
365
366 /*
367 * Information kept by the event manager (tkEvent.c):
368 */
369
370 TkEventHandler *handlerList;/* First in list of event handlers
371 * declared for this window, or
372 * NULL if none. */
373 /*
374 * Information related to input focussing (tkEvent.c):
375 */
376
377 Tk_FocusProc *focusProc; /* Procedure to invoke when this window
378 * gets or loses the input focus. NULL
379 * means this window is not prepared to
380 * receive the focus. */
381 ClientData focusData; /* Arbitrary value to pass to focusProc. */
382
383 /*
384 * Information used by tkOption.c to manage options for the
385 * window.
386 */
387
388 int optionLevel; /* -1 means no option information is
389 * currently cached for this window.
390 * Otherwise this gives the level in
391 * the option stack at which info is
392 * cached. */
393 /*
394 * Information used by tkSelect.c to manage the selection.
395 */
396
397 TkSelHandler *selHandlerList;
398 /* First in list of handlers for
399 * returning the selection in various
400 * forms. */
401 Tk_LostSelProc *selClearProc;
402 ClientData selClearData; /* Info to pass to selClearProc. */
403
404 /*
405 * Information used by tkGeometry.c for geometry management.
406 */
407
408 Tk_GeometryProc *geomProc; /* Procedure to handle geometry
409 * requests (NULL means no window is
410 * unmanaged). */
411 ClientData geomData; /* Argument for geomProc. */
412 int reqWidth, reqHeight; /* Arguments from last call to
413 * Tk_GeometryRequest, or 0's if
414 * Tk_GeometryRequest hasn't been
415 * called. */
416 int internalBorderWidth; /* Width of internal border of window
417 * (0 means no internal border). Geom.
418 * mgr. should not place children on top
419 * of the border. */
420
421 /*
422 * Information maintained by tkWm.c for window manager communication.
423 */
424
425 struct TkWmInfo *wmInfoPtr; /* For top-level windows, points to
426 * structure with wm-related info (see
427 * tkWm.c). For other windows, this
428 * is NULL. */
429 } TkWindow;
430
431 /*
432 * The context below is used to map from an X window id to
433 * the TkWindow structure associated with the window.
434 */
435
436 extern XContext tkWindowContext;
437
438 /*
439 * Pointer to first entry in list of all displays currently known.
440 */
441
442 extern TkDisplay *tkDisplayList;
443
444 /*
445 * Flags passed to TkMeasureChars:
446 */
447
448 #define TK_WHOLE_WORDS 1
449 #define TK_AT_LEAST_ONE 2
450 #define TK_PARTIAL_OK 4
451 #define TK_NEWLINES_NOT_SPECIAL 8
452
453 /*
454 * Location of library directory containing Tk scripts. This value
455 * is put in the $tkLibrary variable for each application.
456 */
457
458 #ifndef TK_LIBRARY
459 #ifdef MSDOS
460 #define TK_LIBRARY "res/tk"
461 #else
462 #define TK_LIBRARY "/usr/local/lib/tk"
463 #endif
464 #endif
465
466 /*
467 * See tkShare.c for explanation of following disgusting variable:
468 */
469
470 extern XEvent *tkShareEventPtr;
471
472 /*
473 * Secret way to inhibit event collapsing. -deh
474 */
475
476 extern int tkCollapseMotion;
477
478 /*
479 * Secret way to break out to Tk_MainLoop. -deh
480 */
481
482 extern int tkMustExit;
483
484 /*
485 * Miscellaneous variables shared among Tk modules but not exported
486 * to the outside world:
487 */
488
489 extern Tk_Uid tkActiveUid;
490 extern Tk_Uid tkDisabledUid;
491 extern Tk_Uid tkNormalUid;
492
493 /*
494 * Internal procedures shared among Tk modules but not exported
495 * to the outside world:
496 */
497
498 extern int TkAreaToPolygon _ANSI_ARGS_((double *polyPtr,
499 int numPoints, double *rectPtr));
500 extern void TkBezierPoints _ANSI_ARGS_((double control[],
501 int numSteps, double *coordPtr));
502 extern void TkBindError _ANSI_ARGS_((Tcl_Interp *interp));
503 extern void TkBindEventProc _ANSI_ARGS_((TkWindow *winPtr,
504 XEvent *eventPtr));
505 extern Time TkCurrentTime _ANSI_ARGS_((TkDisplay *dispPtr));
506 extern int TkDeadAppCmd _ANSI_ARGS_((ClientData clientData,
507 Tcl_Interp *interp, int argc, char **argv));
508 extern void TkDisplayChars _ANSI_ARGS_((Display *display,
509 Drawable drawable, GC gc,
510 XFontStruct *fontStructPtr, char *string,
511 int numChars, int x, int y, int flags));
512 extern void TkEventDeadWindow _ANSI_ARGS_((TkWindow *winPtr));
513 extern void TkFocusEventProc _ANSI_ARGS_((TkWindow *winPtr,
514 XEvent *eventPtr));
515 extern void TkGetButtPoints _ANSI_ARGS_((double p1[], double p2[],
516 double width, int project, double m1[],
517 double m2[]));
518 extern int TkGetInterpNames _ANSI_ARGS_((Tcl_Interp *interp,
519 Tk_Window tkwin));
520 extern int TkGetMiterPoints _ANSI_ARGS_((double p1[], double p2[],
521 double p3[], double width, double m1[],
522 double m2[]));
523 extern void TkGrabDeadWindow _ANSI_ARGS_((TkWindow *winPtr));
524 extern int TkLineToArea _ANSI_ARGS_((double end1Ptr[2],
525 double end2Ptr[2], double rectPtr[4]));
526 extern double TkLineToPoint _ANSI_ARGS_((double end1Ptr[2],
527 double end2Ptr[2], double pointPtr[2]));
528 extern int TkMeasureChars _ANSI_ARGS_((XFontStruct *fontStructPtr,
529 char *source, int maxChars, int startX, int maxX,
530 int flags, int *nextXPtr));
531 extern void TkOptionDeadWindow _ANSI_ARGS_((TkWindow *winPtr));
532 extern int TkOvalToArea _ANSI_ARGS_((double *ovalPtr,
533 double *rectPtr));
534 extern double TkOvalToPoint _ANSI_ARGS_((double ovalPtr[4],
535 double width, int filled, double pointPtr[2]));
536 extern int TkPointerEvent _ANSI_ARGS_((XEvent *eventPtr,
537 TkWindow *winPtr));
538 extern int TkPolygonToArea _ANSI_ARGS_((double *polyPtr,
539 int numPoints, double *rectPtr));
540 extern double TkPolygonToPoint _ANSI_ARGS_((double *polyPtr,
541 int numPoints, double *pointPtr));
542 extern void TkSelDeadWindow _ANSI_ARGS_((TkWindow *winPtr));
543 extern void TkSelEventProc _ANSI_ARGS_((Tk_Window tkwin,
544 XEvent *eventPtr));
545 extern void TkSelPropProc _ANSI_ARGS_((XEvent *eventPtr));
546 extern void TkUnderlineChars _ANSI_ARGS_((Display *display,
547 Drawable drawable, GC gc,
548 XFontStruct *fontStructPtr, char *string,
549 int x, int y, int flags, int firstChar,
550 int lastChar));
551 extern void TkWmDeadWindow _ANSI_ARGS_((TkWindow *winPtr));
552 extern int TkWmMapWindow _ANSI_ARGS_((TkWindow *winPtr));
553 extern void TkWmSetClass _ANSI_ARGS_((TkWindow *winPtr));
554 extern void TkWmNewWindow _ANSI_ARGS_((TkWindow *winPtr));
555
556 #endif /* _TKINT */
Impressum, Datenschutz