]> cvs.zerfleddert.de Git - micropolis/blame - src/tk/tkscrbar.c
only swap bytes in mini map when needed
[micropolis] / src / tk / tkscrbar.c
CommitLineData
6a5fa4e0
MG
1/*
2 * tkScrollbar.c --
3 *
4 * This module implements a scrollbar widgets for the Tk
5 * toolkit. A scrollbar displays a slider and two arrows;
6 * mouse clicks on features within the scrollbar cause
7 * scrolling commands to be invoked.
8 *
9 * Copyright 1990-1992 Regents of the University of California.
10 * Permission to use, copy, modify, and distribute this
11 * software and its documentation for any purpose and without
12 * fee is hereby granted, provided that the above copyright
13 * notice appear in all copies. The University of California
14 * makes no representations about the suitability of this
15 * software for any purpose. It is provided "as is" without
16 * express or implied warranty.
17 */
18
19#ifndef lint
20static char rcsid[] = "$Header: /user6/ouster/wish/RCS/tkScrollbar.c,v 1.35 92/05/22 16:57:27 ouster Exp $ SPRITE (Berkeley)";
21#endif
22
23#include "tkconfig.h"
24#include "default.h"
25#include "tkint.h"
26
27/*
28 * A data structure of the following type is kept for each scrollbar
29 * widget managed by this file:
30 */
31
32typedef struct {
33 Tk_Window tkwin; /* Window that embodies the scrollbar. NULL
34 * means that the window has been destroyed
35 * but the data structures haven't yet been
36 * cleaned up.*/
37 Tcl_Interp *interp; /* Interpreter associated with scrollbar. */
38 Tk_Uid orientUid; /* Orientation for window ("vertical" or
39 * "horizontal"). */
40 int vertical; /* Non-zero means vertical orientation
41 * requested, zero means horizontal. */
42 int width; /* Desired narrow dimension of scrollbar,
43 * in pixels. */
44 char *command; /* Command prefix to use when invoking
45 * scrolling commands. NULL means don't
46 * invoke commands. Malloc'ed. */
47 int commandSize; /* Number of non-NULL bytes in command. */
48 int repeatDelay; /* How long to wait before auto-repeating
49 * on scrolling actions (in ms). */
50 int repeatInterval; /* Interval between autorepeats (in ms). */
51
52 /*
53 * Information used when displaying widget:
54 */
55
56 int borderWidth; /* Width of 3-D borders. */
57 Tk_3DBorder bgBorder; /* Used for drawing background. */
58 Tk_3DBorder fgBorder; /* For drawing foreground shapes. */
59 Tk_3DBorder activeBorder; /* For drawing foreground shapes when
60 * active (i.e. when mouse is positioned
61 * over element). NULL means use fgBorder. */
62 GC copyGC; /* Used for copying from pixmap onto screen. */
63 int relief; /* Indicates whether window as a whole is
64 * raised, sunken, or flat. */
65 int offset; /* Zero if relief is TK_RELIEF_FLAT,
66 * borderWidth otherwise. Indicates how
67 * much interior stuff must be offset from
68 * outside edges to leave room for border. */
69 int arrowLength; /* Length of arrows along long dimension of
70 * scrollbar. Recomputed on window size
71 * changes. */
72 int sliderFirst; /* Pixel coordinate of top or left edge
73 * of slider area, including border. */
74 int sliderLast; /* Coordinate of pixel just after bottom
75 * or right edge of slider area, including
76 * border. */
77 int mouseField; /* Indicates which scrollbar element is
78 * under mouse (e.g. TOP_ARROW; see below
79 * for possible values). */
80 int pressField; /* Field in which button was pressed, or -1
81 * if no button is down. */
82 int pressPos; /* Position of mouse when button was
83 * pressed (y for vertical scrollbar, x
84 * for horizontal). */
85 int pressFirstUnit; /* Value of "firstUnit" when mouse button
86 * was pressed. */
87
88 /*
89 * Information describing the application related to the scrollbar.
90 * This information is provided by the application by invoking the
91 * "set" widget command.
92 */
93
94 int totalUnits; /* Total dimension of application, in
95 * units. */
96 int windowUnits; /* Maximum number of units that can
97 * be displayed in the window at
98 * once. */
99 int firstUnit; /* Number of last unit visible in
100 * application's window. */
101 int lastUnit; /* Index of last unit visible in window. */
102
103 /*
104 * Miscellaneous information:
105 */
106
107 Cursor cursor; /* Current cursor for window, or None. */
108 Tk_TimerToken autoRepeat; /* Token for auto-repeat that's
109 * currently in progress. NULL means no
110 * auto-repeat in progress. */
111 int flags; /* Various flags; see below for
112 * definitions. */
113} Scrollbar;
114
115/*
116 * Legal values for "mouseField" field of Scrollbar structures. These
117 * are also the return values from the ScrollbarPosition procedure.
118 */
119
120#define TOP_ARROW 1
121#define TOP_GAP 2
122#define SLIDER 3
123#define BOTTOM_GAP 4
124#define BOTTOM_ARROW 5
125#define OUTSIDE 6
126
127/*
128 * Flag bits for scrollbars:
129 *
130 * REDRAW_PENDING: Non-zero means a DoWhenIdle handler
131 * has already been queued to redraw
132 * this window.
133 */
134
135#define REDRAW_PENDING 1
136
137/*
138 * Information used for argv parsing.
139 */
140
141
142static Tk_ConfigSpec configSpecs[] = {
143 {TK_CONFIG_BORDER, "-activeforeground", "activeForeground", "Background",
144 DEF_SCROLLBAR_ACTIVE_FG_COLOR, Tk_Offset(Scrollbar, activeBorder),
145 TK_CONFIG_COLOR_ONLY},
146 {TK_CONFIG_BORDER, "-activeforeground", "activeForeground", "Background",
147 DEF_SCROLLBAR_ACTIVE_FG_MONO, Tk_Offset(Scrollbar, activeBorder),
148 TK_CONFIG_MONO_ONLY},
149 {TK_CONFIG_BORDER, "-background", "background", "Background",
150 DEF_SCROLLBAR_BG_COLOR, Tk_Offset(Scrollbar, bgBorder),
151 TK_CONFIG_COLOR_ONLY},
152 {TK_CONFIG_BORDER, "-background", "background", "Background",
153 DEF_SCROLLBAR_BG_MONO, Tk_Offset(Scrollbar, bgBorder),
154 TK_CONFIG_MONO_ONLY},
155 {TK_CONFIG_SYNONYM, "-bd", "borderWidth", (char *) NULL,
156 (char *) NULL, 0, 0},
157 {TK_CONFIG_SYNONYM, "-bg", "background", (char *) NULL,
158 (char *) NULL, 0, 0},
159 {TK_CONFIG_PIXELS, "-borderwidth", "borderWidth", "BorderWidth",
160 DEF_SCROLLBAR_BORDER_WIDTH, Tk_Offset(Scrollbar, borderWidth), 0},
161 {TK_CONFIG_STRING, "-command", "command", "Command",
162 DEF_SCROLLBAR_COMMAND, Tk_Offset(Scrollbar, command), 0},
163 {TK_CONFIG_ACTIVE_CURSOR, "-cursor", "cursor", "Cursor",
164 DEF_SCROLLBAR_CURSOR, Tk_Offset(Scrollbar, cursor), TK_CONFIG_NULL_OK},
165 {TK_CONFIG_SYNONYM, "-fg", "foreground", (char *) NULL,
166 (char *) NULL, 0, 0},
167 {TK_CONFIG_BORDER, "-foreground", "foreground", "Foreground",
168 DEF_SCROLLBAR_FG_COLOR, Tk_Offset(Scrollbar, fgBorder),
169 TK_CONFIG_COLOR_ONLY},
170 {TK_CONFIG_BORDER, "-foreground", "foreground", "Foreground",
171 DEF_SCROLLBAR_FG_MONO, Tk_Offset(Scrollbar, fgBorder),
172 TK_CONFIG_MONO_ONLY},
173 {TK_CONFIG_UID, "-orient", "orient", "Orient",
174 DEF_SCROLLBAR_ORIENT, Tk_Offset(Scrollbar, orientUid), 0},
175 {TK_CONFIG_RELIEF, "-relief", "relief", "Relief",
176 DEF_SCROLLBAR_RELIEF, Tk_Offset(Scrollbar, relief), 0},
177 {TK_CONFIG_INT, "-repeatdelay", "repeatDelay", "RepeatDelay",
178 DEF_SCROLLBAR_REPEAT_DELAY, Tk_Offset(Scrollbar, repeatDelay), 0},
179 {TK_CONFIG_INT, "-repeatinterval", "repeatInterval", "RepeatInterval",
180 DEF_SCROLLBAR_REPEAT_INTERVAL, Tk_Offset(Scrollbar, repeatInterval), 0},
181 {TK_CONFIG_PIXELS, "-width", "width", "Width",
182 DEF_SCROLLBAR_WIDTH, Tk_Offset(Scrollbar, width), 0},
183 {TK_CONFIG_END, (char *) NULL, (char *) NULL, (char *) NULL,
184 (char *) NULL, 0, 0}
185};
186
187/*
188 * Forward declarations for procedures defined later in this file:
189 */
190
191static void ComputeScrollbarGeometry _ANSI_ARGS_((
192 Scrollbar *scrollPtr));
193static int ConfigureScrollbar _ANSI_ARGS_((Tcl_Interp *interp,
194 Scrollbar *scrollPtr, int argc, char **argv,
195 int flags));
196static void DestroyScrollbar _ANSI_ARGS_((ClientData clientData));
197static void DisplayScrollbar _ANSI_ARGS_((ClientData clientData));
198static void EventuallyRedraw _ANSI_ARGS_((Scrollbar *scrollPtr));
199static void ScrollbarEventProc _ANSI_ARGS_((ClientData clientData,
200 XEvent *eventPtr));
201static void ScrollbarMouseProc _ANSI_ARGS_((ClientData clientData,
202 XEvent *eventPtr));
203static void ScrollbarNewField _ANSI_ARGS_((Scrollbar *scrollPtr,
204 int field));
205static int ScrollbarPosition _ANSI_ARGS_((Scrollbar *scrollPtr,
206 int x, int y));
207static void ScrollbarTimerProc _ANSI_ARGS_((
208 ClientData clientData));
209static int ScrollbarWidgetCmd _ANSI_ARGS_((ClientData clientData,
210 Tcl_Interp *, int argc, char **argv));
211static void ScrollCmd _ANSI_ARGS_((Scrollbar *scrollPtr,
212 int unit));
213\f
214/*
215 *--------------------------------------------------------------
216 *
217 * Tk_ScrollbarCmd --
218 *
219 * This procedure is invoked to process the "scrollbar" Tcl
220 * command. See the user documentation for details on what
221 * it does.
222 *
223 * Results:
224 * A standard Tcl result.
225 *
226 * Side effects:
227 * See the user documentation.
228 *
229 *--------------------------------------------------------------
230 */
231
232int
233Tk_ScrollbarCmd(clientData, interp, argc, argv)
234 ClientData clientData; /* Main window associated with
235 * interpreter. */
236 Tcl_Interp *interp; /* Current interpreter. */
237 int argc; /* Number of arguments. */
238 char **argv; /* Argument strings. */
239{
240 Tk_Window tkwin = (Tk_Window) clientData;
241 register Scrollbar *scrollPtr;
242 Tk_Window new;
243
244 if (argc < 2) {
245 Tcl_AppendResult(interp, "wrong # args: should be \"",
246 argv[0], " pathName ?options?\"", (char *) NULL);
247 return TCL_ERROR;
248 }
249
250 new = Tk_CreateWindowFromPath(interp, tkwin, argv[1], (char *) NULL);
251 if (new == NULL) {
252 return TCL_ERROR;
253 }
254
255 /*
256 * Initialize fields that won't be initialized by ConfigureScrollbar,
257 * or which ConfigureScrollbar expects to have reasonable values
258 * (e.g. resource pointers).
259 */
260
261 scrollPtr = (Scrollbar *) ckalloc(sizeof(Scrollbar));
262 scrollPtr->tkwin = new;
263 scrollPtr->interp = interp;
264 scrollPtr->command = NULL;
265 scrollPtr->bgBorder = NULL;
266 scrollPtr->fgBorder = NULL;
267 scrollPtr->activeBorder = NULL;
268 scrollPtr->copyGC = None;
269 scrollPtr->mouseField = OUTSIDE;
270 scrollPtr->pressField = -1;
271 scrollPtr->totalUnits = 0;
272 scrollPtr->windowUnits = 0;
273 scrollPtr->firstUnit = 0;
274 scrollPtr->lastUnit = 0;
275 scrollPtr->cursor = None;
276 scrollPtr->autoRepeat = NULL;
277 scrollPtr->flags = 0;
278
279 Tk_SetClass(scrollPtr->tkwin, "Scrollbar");
280 Tk_CreateEventHandler(scrollPtr->tkwin, ExposureMask|StructureNotifyMask,
281 ScrollbarEventProc, (ClientData) scrollPtr);
282 Tk_CreateEventHandler(scrollPtr->tkwin, EnterWindowMask|LeaveWindowMask
283 |PointerMotionMask|ButtonPressMask|ButtonReleaseMask,
284 ScrollbarMouseProc, (ClientData) scrollPtr);
285 Tcl_CreateCommand(interp, Tk_PathName(scrollPtr->tkwin), ScrollbarWidgetCmd,
286 (ClientData) scrollPtr, (void (*)()) NULL);
287 if (ConfigureScrollbar(interp, scrollPtr, argc-2, argv+2, 0) != TCL_OK) {
288 goto error;
289 }
290
291 interp->result = Tk_PathName(scrollPtr->tkwin);
292 return TCL_OK;
293
294 error:
295 Tk_DestroyWindow(scrollPtr->tkwin);
296 return TCL_ERROR;
297}
298\f
299/*
300 *--------------------------------------------------------------
301 *
302 * ScrollbarWidgetCmd --
303 *
304 * This procedure is invoked to process the Tcl command
305 * that corresponds to a widget managed by this module.
306 * See the user documentation for details on what it does.
307 *
308 * Results:
309 * A standard Tcl result.
310 *
311 * Side effects:
312 * See the user documentation.
313 *
314 *--------------------------------------------------------------
315 */
316
317static int
318ScrollbarWidgetCmd(clientData, interp, argc, argv)
319 ClientData clientData; /* Information about scrollbar
320 * widget. */
321 Tcl_Interp *interp; /* Current interpreter. */
322 int argc; /* Number of arguments. */
323 char **argv; /* Argument strings. */
324{
325 register Scrollbar *scrollPtr = (Scrollbar *) clientData;
326 int result = TCL_OK;
327 int length;
328 char c;
329
330 if (argc < 2) {
331 Tcl_AppendResult(interp, "wrong # args: should be \"",
332 argv[0], " option ?arg arg ...?\"", (char *) NULL);
333 return TCL_ERROR;
334 }
335 Tk_Preserve((ClientData) scrollPtr);
336 c = argv[1][0];
337 length = strlen(argv[1]);
338 if ((c == 'c') && (strncmp(argv[1], "configure", length) == 0)) {
339 if (argc == 2) {
340 result = Tk_ConfigureInfo(interp, scrollPtr->tkwin, configSpecs,
341 (char *) scrollPtr, (char *) NULL, 0);
342 } else if (argc == 3) {
343 result = Tk_ConfigureInfo(interp, scrollPtr->tkwin, configSpecs,
344 (char *) scrollPtr, argv[2], 0);
345 } else {
346 result = ConfigureScrollbar(interp, scrollPtr, argc-2, argv+2,
347 TK_CONFIG_ARGV_ONLY);
348 }
349 } else if ((c == 'g') && (strncmp(argv[1], "get", length) == 0)) {
350 if (argc != 2) {
351 Tcl_AppendResult(interp, "wrong # args: should be \"",
352 argv[0], " get\"", (char *) NULL);
353 goto error;
354 }
355 sprintf(interp->result, "%d %d %d %d", scrollPtr->totalUnits,
356 scrollPtr->windowUnits, scrollPtr->firstUnit,
357 scrollPtr->lastUnit);
358 } else if ((c == 's') && (strncmp(argv[1], "set", length) == 0)) {
359 int totalUnits, windowUnits, firstUnit, lastUnit;
360
361 if (argc != 6) {
362 Tcl_AppendResult(interp, "wrong # args: should be \"",
363 argv[0],
364 " set totalUnits windowUnits firstUnit lastUnit\"",
365 (char *) NULL);
366 goto error;
367 }
368 if (Tcl_GetInt(interp, argv[2], &totalUnits) != TCL_OK) {
369 goto error;
370 }
371 if (totalUnits < 0) {
372 sprintf(interp->result, "illegal totalUnits %d", totalUnits);
373 goto error;
374 }
375 if (Tcl_GetInt(interp, argv[3], &windowUnits) != TCL_OK) {
376 goto error;
377 }
378 if (windowUnits < 0) {
379 sprintf(interp->result, "illegal windowUnits %d", windowUnits);
380 goto error;
381 }
382 if (Tcl_GetInt(interp, argv[4], &firstUnit) != TCL_OK) {
383 goto error;
384 }
385 if (Tcl_GetInt(interp, argv[5], &lastUnit) != TCL_OK) {
386 goto error;
387 }
388 if (totalUnits > 0) {
389 if (lastUnit < firstUnit) {
390 sprintf(interp->result, "illegal lastUnit %d", lastUnit);
391 goto error;
392 }
393 } else {
394 firstUnit = lastUnit = 0;
395 }
396 scrollPtr->totalUnits = totalUnits;
397 scrollPtr->windowUnits = windowUnits;
398 scrollPtr->firstUnit = firstUnit;
399 scrollPtr->lastUnit = lastUnit;
400 ComputeScrollbarGeometry(scrollPtr);
401 EventuallyRedraw(scrollPtr);
402 } else {
403 Tcl_AppendResult(interp, "bad option \"", argv[1],
404 "\": must be configure, get, or set", (char *) NULL);
405 goto error;
406 }
407 Tk_Release((ClientData) scrollPtr);
408 return result;
409
410 error:
411 Tk_Release((ClientData) scrollPtr);
412 return TCL_ERROR;
413}
414\f
415/*
416 *----------------------------------------------------------------------
417 *
418 * DestroyScrollbar --
419 *
420 * This procedure is invoked by Tk_EventuallyFree or Tk_Release
421 * to clean up the internal structure of a scrollbar at a safe time
422 * (when no-one is using it anymore).
423 *
424 * Results:
425 * None.
426 *
427 * Side effects:
428 * Everything associated with the scrollbar is freed up.
429 *
430 *----------------------------------------------------------------------
431 */
432
433static void
434DestroyScrollbar(clientData)
435 ClientData clientData; /* Info about scrollbar widget. */
436{
437 register Scrollbar *scrollPtr = (Scrollbar *) clientData;
438
439 if (scrollPtr->command != NULL) {
440 ckfree(scrollPtr->command);
441 }
442 if (scrollPtr->bgBorder != NULL) {
443 Tk_Free3DBorder(scrollPtr->bgBorder);
444 }
445 if (scrollPtr->fgBorder != NULL) {
446 Tk_Free3DBorder(scrollPtr->fgBorder);
447 }
448 if (scrollPtr->activeBorder != NULL) {
449 Tk_Free3DBorder(scrollPtr->activeBorder);
450 }
451 if (scrollPtr->copyGC != None) {
452 Tk_FreeGC(scrollPtr->copyGC);
453 }
454 if (scrollPtr->cursor != None) {
455 Tk_FreeCursor(scrollPtr->cursor);
456 }
457 ckfree((char *) scrollPtr);
458}
459\f
460/*
461 *----------------------------------------------------------------------
462 *
463 * ConfigureScrollbar --
464 *
465 * This procedure is called to process an argv/argc list, plus
466 * the Tk option database, in order to configure (or
467 * reconfigure) a scrollbar widget.
468 *
469 * Results:
470 * The return value is a standard Tcl result. If TCL_ERROR is
471 * returned, then interp->result contains an error message.
472 *
473 * Side effects:
474 * Configuration information, such as colors, border width,
475 * etc. get set for scrollPtr; old resources get freed,
476 * if there were any.
477 *
478 *----------------------------------------------------------------------
479 */
480
481static int
482ConfigureScrollbar(interp, scrollPtr, argc, argv, flags)
483 Tcl_Interp *interp; /* Used for error reporting. */
484 register Scrollbar *scrollPtr; /* Information about widget; may or
485 * may not already have values for
486 * some fields. */
487 int argc; /* Number of valid entries in argv. */
488 char **argv; /* Arguments. */
489 int flags; /* Flags to pass to
490 * Tk_ConfigureWidget. */
491{
492 int length;
493 XGCValues gcValues;
494
495 if (Tk_ConfigureWidget(interp, scrollPtr->tkwin, configSpecs,
496 argc, argv, (char *) scrollPtr, flags) != TCL_OK) {
497 return TCL_ERROR;
498 }
499
500 /*
501 * A few options need special processing, such as parsing the
502 * orientation or setting the background from a 3-D border.
503 */
504
505 length = strlen(scrollPtr->orientUid);
506 if (strncmp(scrollPtr->orientUid, "vertical", length) == 0) {
507 scrollPtr->vertical = 1;
508 } else if (strncmp(scrollPtr->orientUid, "horizontal", length) == 0) {
509 scrollPtr->vertical = 0;
510 } else {
511 Tcl_AppendResult(interp, "bad orientation \"", scrollPtr->orientUid,
512 "\": must be vertical or horizontal", (char *) NULL);
513 return TCL_ERROR;
514 }
515
516 if (scrollPtr->command != NULL) {
517 scrollPtr->commandSize = strlen(scrollPtr->command);
518 } else {
519 scrollPtr->commandSize = 0;
520 }
521
522 Tk_SetBackgroundFromBorder(scrollPtr->tkwin, scrollPtr->bgBorder);
523
524 if (scrollPtr->copyGC == None) {
525 gcValues.graphics_exposures = False;
526 scrollPtr->copyGC = Tk_GetGC(scrollPtr->tkwin, GCGraphicsExposures,
527 &gcValues);
528 }
529
530 /*
531 * Register the desired geometry for the window (leave enough space
532 * for the two arrows plus a minimum-size slider, plus border around
533 * the whole window, if any). Then arrange for the window to be
534 * redisplayed.
535 */
536
537 ComputeScrollbarGeometry(scrollPtr);
538 EventuallyRedraw(scrollPtr);
539 return TCL_OK;
540}
541\f
542/*
543 *--------------------------------------------------------------
544 *
545 * DisplayScrollbar --
546 *
547 * This procedure redraws the contents of a scrollbar window.
548 * It is invoked as a do-when-idle handler, so it only runs
549 * when there's nothing else for the application to do.
550 *
551 * Results:
552 * None.
553 *
554 * Side effects:
555 * Information appears on the screen.
556 *
557 *--------------------------------------------------------------
558 */
559
560static void
561DisplayScrollbar(clientData)
562 ClientData clientData; /* Information about window. */
563{
564 register Scrollbar *scrollPtr = (Scrollbar *) clientData;
565 register Tk_Window tkwin = scrollPtr->tkwin;
566 XPoint points[7];
567 Tk_3DBorder border;
568 int relief, width, fieldLength;
569 Pixmap pixmap;
570
571 if ((scrollPtr->tkwin == NULL) || !Tk_IsMapped(tkwin)) {
572 goto done;
573 }
574
575 if (scrollPtr->vertical) {
576 width = Tk_Width(tkwin) - 2*scrollPtr->offset;
577 } else {
578 width = Tk_Height(tkwin) - 2*scrollPtr->offset;
579 }
580
581 /*
582 * In order to avoid screen flashes, this procedure redraws
583 * the scrollbar in a pixmap, then copies the pixmap to the
584 * screen in a single operation. This means that there's no
585 * point in time where the on-sreen image has been cleared.
586 */
587
588 pixmap = XCreatePixmap(Tk_Display(tkwin), Tk_WindowId(tkwin),
589 Tk_Width(tkwin), Tk_Height(tkwin),
590 Tk_DefaultDepth(Tk_Screen(tkwin)));
591 Tk_Fill3DRectangle(Tk_Display(tkwin), pixmap, scrollPtr->bgBorder,
592 0, 0, Tk_Width(tkwin), Tk_Height(tkwin),
593 scrollPtr->borderWidth, scrollPtr->relief);
594
595 /*
596 * Draw the top or left arrow. The coordinates of the polygon
597 * points probably seem odd, but they were carefully chosen with
598 * respect to X's rules for filling polygons. These point choices
599 * cause the arrows to just fill the narrow dimension of the
600 * scrollbar and be properly centered.
601 */
602
603 if (scrollPtr->mouseField == TOP_ARROW) {
604 border = scrollPtr->activeBorder;
605 relief = scrollPtr->pressField == TOP_ARROW ? TK_RELIEF_SUNKEN
606 : TK_RELIEF_RAISED;
607 } else {
608 border = scrollPtr->fgBorder;
609 relief = TK_RELIEF_RAISED;
610 }
611 if (scrollPtr->vertical) {
612 points[0].x = scrollPtr->offset - 1;
613 points[0].y = scrollPtr->arrowLength + scrollPtr->offset;
614 points[1].x = width + scrollPtr->offset;
615 points[1].y = points[0].y;
616 points[2].x = width/2 + scrollPtr->offset;
617 points[2].y = scrollPtr->offset - 1;
618 Tk_Fill3DPolygon(Tk_Display(tkwin), pixmap, border,
619 points, 3, scrollPtr->borderWidth, relief);
620 } else {
621 points[0].x = scrollPtr->arrowLength + scrollPtr->offset;
622 points[0].y = scrollPtr->offset - 1;
623 points[1].x = scrollPtr->offset;
624 points[1].y = width/2 + scrollPtr->offset;
625 points[2].x = points[0].x;
626 points[2].y = width + scrollPtr->offset;
627 Tk_Fill3DPolygon(Tk_Display(tkwin), pixmap, border,
628 points, 3, scrollPtr->borderWidth, relief);
629 }
630
631 /*
632 * Display the bottom or right arrow.
633 */
634
635 if (scrollPtr->mouseField == BOTTOM_ARROW) {
636 border = scrollPtr->activeBorder;
637 relief = scrollPtr->pressField == BOTTOM_ARROW ? TK_RELIEF_SUNKEN
638 : TK_RELIEF_RAISED;
639 } else {
640 border = scrollPtr->fgBorder;
641 relief = TK_RELIEF_RAISED;
642 }
643 if (scrollPtr->vertical) {
644 points[0].x = scrollPtr->offset;
645 points[0].y = Tk_Height(tkwin) - scrollPtr->arrowLength
646 - scrollPtr->offset;
647 points[1].x = width/2 + scrollPtr->offset;
648 points[1].y = Tk_Height(tkwin) - scrollPtr->offset;
649 points[2].x = width + scrollPtr->offset;
650 points[2].y = points[0].y;
651 Tk_Fill3DPolygon(Tk_Display(tkwin), pixmap, border,
652 points, 3, scrollPtr->borderWidth, relief);
653 } else {
654 points[0].x = Tk_Width(tkwin) - scrollPtr->arrowLength
655 - scrollPtr->offset;
656 points[0].y = scrollPtr->offset - 1;
657 points[1].x = points[0].x;
658 points[1].y = width + scrollPtr->offset;
659 points[2].x = Tk_Width(tkwin) - scrollPtr->offset;
660 points[2].y = width/2 + scrollPtr->offset;
661 Tk_Fill3DPolygon(Tk_Display(tkwin), pixmap, border,
662 points, 3, scrollPtr->borderWidth, relief);
663 }
664
665 /*
666 * Display the slider.
667 */
668
669 if (scrollPtr->mouseField == SLIDER) {
670 border = scrollPtr->activeBorder;
671 relief = scrollPtr->pressField == SLIDER ? TK_RELIEF_SUNKEN
672 : TK_RELIEF_RAISED;
673 } else {
674 border = scrollPtr->fgBorder;
675 relief = TK_RELIEF_RAISED;
676 }
677 fieldLength = (scrollPtr->vertical ? Tk_Height(tkwin) : Tk_Width(tkwin))
678 - 2*(scrollPtr->arrowLength + scrollPtr->offset);
679 if (fieldLength < 0) {
680 fieldLength = 0;
681 }
682 if (scrollPtr->vertical) {
683 Tk_Fill3DRectangle(Tk_Display(tkwin), pixmap, border,
684 1 + scrollPtr->offset, scrollPtr->sliderFirst,
685 width-2, scrollPtr->sliderLast - scrollPtr->sliderFirst,
686 scrollPtr->borderWidth, relief);
687 } else {
688 Tk_Fill3DRectangle(Tk_Display(tkwin), pixmap, border,
689 scrollPtr->sliderFirst, 1 + scrollPtr->offset,
690 scrollPtr->sliderLast - scrollPtr->sliderFirst, width-2,
691 scrollPtr->borderWidth, relief);
692 }
693
694 /*
695 * Copy the information from the off-screen pixmap onto the screen,
696 * then delete the pixmap.
697 */
698
699 XCopyArea(Tk_Display(tkwin), pixmap, Tk_WindowId(tkwin),
700 scrollPtr->copyGC, 0, 0, Tk_Width(tkwin), Tk_Height(tkwin), 0, 0);
701 XFreePixmap(Tk_Display(tkwin), pixmap);
702
703 done:
704 scrollPtr->flags &= ~REDRAW_PENDING;
705}
706\f
707/*
708 *--------------------------------------------------------------
709 *
710 * ScrollbarEventProc --
711 *
712 * This procedure is invoked by the Tk dispatcher for various
713 * events on scrollbars.
714 *
715 * Results:
716 * None.
717 *
718 * Side effects:
719 * When the window gets deleted, internal structures get
720 * cleaned up. When it gets exposed, it is redisplayed.
721 *
722 *--------------------------------------------------------------
723 */
724
725static void
726ScrollbarEventProc(clientData, eventPtr)
727 ClientData clientData; /* Information about window. */
728 XEvent *eventPtr; /* Information about event. */
729{
730 Scrollbar *scrollPtr = (Scrollbar *) clientData;
731
732 if ((eventPtr->type == Expose) && (eventPtr->xexpose.count == 0)) {
733 EventuallyRedraw(scrollPtr);
734 } else if (eventPtr->type == DestroyNotify) {
735 Tcl_DeleteCommand(scrollPtr->interp, Tk_PathName(scrollPtr->tkwin));
736 scrollPtr->tkwin = NULL;
737 if (scrollPtr->flags & REDRAW_PENDING) {
738 Tk_CancelIdleCall(DisplayScrollbar, (ClientData) scrollPtr);
739 }
740 Tk_EventuallyFree((ClientData) scrollPtr, DestroyScrollbar);
741 } else if (eventPtr->type == ConfigureNotify) {
742 ComputeScrollbarGeometry(scrollPtr);
743 }
744}
745\f
746/*
747 *----------------------------------------------------------------------
748 *
749 * ComputeScrollbarGeometry --
750 *
751 * After changes in a scrollbar's size or configuration, this
752 * procedure recomputes various geometry information used in
753 * displaying the scrollbar.
754 *
755 * Results:
756 * None.
757 *
758 * Side effects:
759 * The scrollbar will be displayed differently.
760 *
761 *----------------------------------------------------------------------
762 */
763
764static void
765ComputeScrollbarGeometry(scrollPtr)
766 register Scrollbar *scrollPtr; /* Scrollbar whose geometry may
767 * have changed. */
768{
769 int width, fieldLength;
770
771 if (scrollPtr->relief == TK_RELIEF_FLAT) {
772 scrollPtr->offset = 0;
773 } else {
774 scrollPtr->offset = scrollPtr->borderWidth;
775 }
776 width = (scrollPtr->vertical) ? Tk_Width(scrollPtr->tkwin)
777 : Tk_Height(scrollPtr->tkwin);
778 scrollPtr->arrowLength =
779 (((width - 2*scrollPtr->offset)*173) + 100) / 200;
780 fieldLength = (scrollPtr->vertical ? Tk_Height(scrollPtr->tkwin)
781 : Tk_Width(scrollPtr->tkwin))
782 - 2*(scrollPtr->arrowLength + scrollPtr->offset);
783 if (fieldLength < 0) {
784 fieldLength = 0;
785 }
786 if (scrollPtr->totalUnits <= 0) {
787 scrollPtr->sliderFirst = 0;
788 scrollPtr->sliderLast = fieldLength;
789 } else {
790 scrollPtr->sliderFirst = (fieldLength*scrollPtr->firstUnit
791 + scrollPtr->totalUnits/2)/scrollPtr->totalUnits;
792 scrollPtr->sliderLast = (fieldLength*(scrollPtr->lastUnit+1)
793 + scrollPtr->totalUnits/2)/scrollPtr->totalUnits;
794
795 /*
796 * Adjust the slider so that some piece of it is always
797 * displayed in the scrollbar and so that it has at least
798 * a minimal width (so it can be grabbed with the mouse).
799 */
800
801 if (scrollPtr->sliderFirst > (fieldLength - 2*scrollPtr->borderWidth)) {
802 scrollPtr->sliderFirst = fieldLength - 2*scrollPtr->borderWidth;
803 }
804 if (scrollPtr->sliderFirst < 0) {
805 scrollPtr->sliderFirst = 0;
806 }
807 if (scrollPtr->sliderLast < (scrollPtr->sliderFirst
808 + 2*scrollPtr->borderWidth)) {
809 scrollPtr->sliderLast = scrollPtr->sliderFirst
810 + 2*scrollPtr->borderWidth;
811 }
812 if (scrollPtr->sliderLast > fieldLength) {
813 scrollPtr->sliderLast = fieldLength;
814 }
815 }
816 scrollPtr->sliderFirst += scrollPtr->arrowLength + scrollPtr->offset;
817 scrollPtr->sliderLast += scrollPtr->arrowLength + scrollPtr->offset;
818
819 /*
820 * Register the desired geometry for the window (leave enough space
821 * for the two arrows plus a minimum-size slider, plus border around
822 * the whole window, if any). Then arrange for the window to be
823 * redisplayed.
824 */
825
826 if (scrollPtr->vertical) {
827 Tk_GeometryRequest(scrollPtr->tkwin,
828 scrollPtr->width + 2*scrollPtr->offset,
829 2*(scrollPtr->arrowLength + scrollPtr->borderWidth
830 + scrollPtr->offset));
831 } else {
832 Tk_GeometryRequest(scrollPtr->tkwin,
833 2*(scrollPtr->arrowLength + scrollPtr->borderWidth
834 + scrollPtr->offset), scrollPtr->width + 2*scrollPtr->offset);
835 }
836 Tk_SetInternalBorder(scrollPtr->tkwin, scrollPtr->borderWidth);
837
838}
839\f
840/*
841 *--------------------------------------------------------------
842 *
843 * ScrollbarPosition --
844 *
845 * Determine the scrollbar element corresponding to a
846 * given position.
847 *
848 * Results:
849 * One of TOP_ARROW, TOP_GAP, etc., indicating which element
850 * of the scrollbar covers the position given by (x, y). If
851 * (x,y) is outside the scrollbar entirely, then OUTSIDE is
852 * returned.
853 *
854 * Side effects:
855 * None.
856 *
857 *--------------------------------------------------------------
858 */
859
860static int
861ScrollbarPosition(scrollPtr, x, y)
862 register Scrollbar *scrollPtr; /* Scrollbar widget record. */
863 int x, y; /* Coordinates within scrollPtr's
864 * window. */
865{
866 int length, width, tmp;
867
868 if (scrollPtr->vertical) {
869 length = Tk_Height(scrollPtr->tkwin);
870 width = Tk_Width(scrollPtr->tkwin);
871 } else {
872 tmp = x;
873 x = y;
874 y = tmp;
875 length = Tk_Width(scrollPtr->tkwin);
876 width = Tk_Height(scrollPtr->tkwin);
877 }
878
879 if ((x < 0) || (x > width) || (y < 0)) {
880 return OUTSIDE;
881 }
882
883 /*
884 * All of the calculations in this procedure mirror those in
885 * DisplayScrollbar. Be sure to keep the two consistent.
886 */
887
888 if (y < (scrollPtr->offset + scrollPtr->arrowLength)) {
889 return TOP_ARROW;
890 }
891 if (y < scrollPtr->sliderFirst) {
892 return TOP_GAP;
893 }
894 if (y < scrollPtr->sliderLast) {
895 return SLIDER;
896 }
897 if (y >= (length - (scrollPtr->arrowLength + scrollPtr->offset))) {
898 return BOTTOM_ARROW;
899 }
900 return BOTTOM_GAP;
901}
902\f
903/*
904 *--------------------------------------------------------------
905 *
906 * ScrollbarMouseProc --
907 *
908 * This procedure is called back by Tk in response to
909 * mouse events such as window entry, window exit, mouse
910 * motion, and button presses.
911 *
912 * Results:
913 * None.
914 *
915 * Side effects:
916 * This procedure implements the "feel" of the scrollbar
917 * by issuing scrolling commands in response to button presses
918 * and mouse motion.
919 *
920 *--------------------------------------------------------------
921 */
922
923static void
924ScrollbarMouseProc(clientData, eventPtr)
925 ClientData clientData; /* Information about window. */
926 register XEvent *eventPtr; /* Information about event. */
927{
928 register Scrollbar *scrollPtr = (Scrollbar *) clientData;
929
930 Tk_Preserve((ClientData) scrollPtr);
931 if (eventPtr->type == EnterNotify) {
932 if (scrollPtr->pressField == -1) {
933 ScrollbarNewField(scrollPtr,
934 ScrollbarPosition(scrollPtr, eventPtr->xcrossing.x,
935 eventPtr->xcrossing.y));
936 }
937 } else if (eventPtr->type == LeaveNotify) {
938 if (scrollPtr->pressField == -1) {
939 ScrollbarNewField(scrollPtr, OUTSIDE);
940 }
941 } else if (eventPtr->type == MotionNotify) {
942 if (scrollPtr->pressField == SLIDER) {
943 int delta, length, newFirst;
944
945 if (scrollPtr->vertical) {
946 delta = eventPtr->xmotion.y - scrollPtr->pressPos;
947 length = Tk_Height(scrollPtr->tkwin)
948 - 2*(scrollPtr->arrowLength + scrollPtr->offset);
949 } else {
950 delta = eventPtr->xmotion.x - scrollPtr->pressPos;
951 length = Tk_Width(scrollPtr->tkwin)
952 - 2*(scrollPtr->arrowLength + scrollPtr->offset);
953 }
954
955 /*
956 * Do the division with positive numbers to avoid
957 * differences in negative-number truncation on different
958 * machines.
959 */
960
961 if (delta >= 0) {
962 newFirst = scrollPtr->pressFirstUnit
963 + ((delta * scrollPtr->totalUnits) + (length/2))
964 / length;
965 } else {
966 newFirst = scrollPtr->pressFirstUnit
967 - (((-delta) * scrollPtr->totalUnits) + (length/2))
968 / length;
969 }
970 ScrollCmd(scrollPtr, newFirst);
971 } else if (scrollPtr->pressField == -1) {
972 ScrollbarNewField(scrollPtr,
973 ScrollbarPosition(scrollPtr, eventPtr->xmotion.x,
974 eventPtr->xmotion.y));
975 }
976 } else if ((eventPtr->type == ButtonPress)
977 && (eventPtr->xbutton.state == 0)) {
978 scrollPtr->pressField = scrollPtr->mouseField;
979 if (scrollPtr->pressField != SLIDER) {
980 scrollPtr->autoRepeat = Tk_CreateTimerHandler(
981 scrollPtr->repeatDelay,
982 ScrollbarTimerProc, (ClientData) scrollPtr);
983 }
984 if (scrollPtr->vertical) {
985 scrollPtr->pressPos = eventPtr->xbutton.y;
986 } else {
987 scrollPtr->pressPos = eventPtr->xbutton.x;
988 }
989 scrollPtr->pressFirstUnit = scrollPtr->firstUnit;
990 if (scrollPtr->pressFirstUnit <= -scrollPtr->windowUnits) {
991 scrollPtr->pressFirstUnit = 1-scrollPtr->windowUnits;
992 }
993 if (scrollPtr->pressFirstUnit >= scrollPtr->totalUnits) {
994 scrollPtr->pressFirstUnit = scrollPtr->totalUnits-1;
995 }
996 EventuallyRedraw(scrollPtr);
997 } else if (eventPtr->type == ButtonRelease) {
998 if (scrollPtr->pressField == scrollPtr->mouseField) {
999 switch (scrollPtr->pressField) {
1000 case TOP_ARROW:
1001 ScrollCmd(scrollPtr, scrollPtr->firstUnit-1);
1002 break;
1003 case TOP_GAP:
1004 if (scrollPtr->windowUnits <= 1) {
1005 ScrollCmd(scrollPtr, scrollPtr->firstUnit - 1);
1006 } else {
1007 ScrollCmd(scrollPtr, scrollPtr->firstUnit
1008 - (scrollPtr->windowUnits-1));
1009 }
1010 break;
1011 case BOTTOM_GAP: {
1012 if (scrollPtr->windowUnits <= 1) {
1013 ScrollCmd(scrollPtr, scrollPtr->firstUnit + 1);
1014 } else {
1015 ScrollCmd(scrollPtr, scrollPtr->firstUnit
1016 + (scrollPtr->windowUnits-1));
1017 }
1018 break;
1019 }
1020 case BOTTOM_ARROW:
1021 ScrollCmd(scrollPtr, scrollPtr->firstUnit+1);
1022 break;
1023 }
1024 }
1025 if (scrollPtr->autoRepeat != NULL) {
1026 Tk_DeleteTimerHandler(scrollPtr->autoRepeat);
1027 scrollPtr->autoRepeat = NULL;
1028 }
1029 EventuallyRedraw(scrollPtr);
1030 scrollPtr->pressField = -1;
1031 ScrollbarNewField(scrollPtr,
1032 ScrollbarPosition(scrollPtr, eventPtr->xbutton.x,
1033 eventPtr->xbutton.y));
1034 }
1035 Tk_Release((ClientData) scrollPtr);
1036}
1037\f
1038/*
1039 *--------------------------------------------------------------
1040 *
1041 * ScrollCmd --
1042 *
1043 * This procedure takes care of invoking a scrolling Tcl
1044 * command and reporting any error that occurs in it.
1045 *
1046 * Results:
1047 * None.
1048 *
1049 * Side effects:
1050 * A Tcl command is invoked, and an additional error-processing
1051 * command may also be invoked.
1052 *
1053 *--------------------------------------------------------------
1054 */
1055
1056static void
1057ScrollCmd(scrollPtr, unit)
1058 register Scrollbar *scrollPtr; /* Scrollbar from which to issue
1059 * command. */
1060 int unit; /* Unit position within thing being
1061 * being displayed that should appear
1062 * at top or right of screen. */
1063{
1064 char string[20];
1065 int result;
1066
1067 if ((unit == scrollPtr->firstUnit) || (scrollPtr->command == NULL)) {
1068 return;
1069 }
1070 sprintf(string, " %d", unit);
1071 result = Tcl_VarEval(scrollPtr->interp, scrollPtr->command, string,
1072 (char *) NULL);
1073 if (result != TCL_OK) {
1074 TkBindError(scrollPtr->interp);
1075 }
1076}
1077\f
1078/*
1079 *--------------------------------------------------------------
1080 *
1081 * EventuallyRedraw --
1082 *
1083 * Arrange for one or more of the fields of a scrollbar
1084 * to be redrawn.
1085 *
1086 * Results:
1087 * None.
1088 *
1089 * Side effects:
1090 * None.
1091 *
1092 *--------------------------------------------------------------
1093 */
1094
1095static void
1096EventuallyRedraw(scrollPtr)
1097 register Scrollbar *scrollPtr; /* Information about widget. */
1098{
1099 if ((scrollPtr->tkwin == NULL) || (!Tk_IsMapped(scrollPtr->tkwin))) {
1100 return;
1101 }
1102 if ((scrollPtr->flags & REDRAW_PENDING) == 0) {
1103 Tk_DoWhenIdle(DisplayScrollbar, (ClientData) scrollPtr);
1104 scrollPtr->flags |= REDRAW_PENDING;
1105 }
1106}
1107\f
1108/*
1109 *--------------------------------------------------------------
1110 *
1111 * ScrollbarNewField --
1112 *
1113 * This procedure is called to declare that the mouse is in
1114 * a particular field of the scrollbar (e.g. top arrow), so
1115 * that the field can be highlighed and the previous field
1116 * can be returned to normal display.
1117 *
1118 * Results:
1119 * None.
1120 *
1121 * Side effects:
1122 * Fields may be redisplayed.
1123 *
1124 *--------------------------------------------------------------
1125 */
1126
1127static void
1128ScrollbarNewField(scrollPtr, field)
1129 register Scrollbar *scrollPtr; /* Information about widget. */
1130 int field; /* Identifies field under mouse,
1131 * e.g. TOP_ARROW. */
1132{
1133 if (field == scrollPtr->mouseField) {
1134 return;
1135 }
1136 EventuallyRedraw(scrollPtr);
1137 scrollPtr->mouseField = field;
1138}
1139\f
1140/*
1141 *--------------------------------------------------------------
1142 *
1143 * ScrollbarTimerProc --
1144 *
1145 * This procedure is invoked as a Tk timer handler for actions
1146 * that auto-repeat (mouse presses in an arrow or gap). It
1147 * performs the auto-repeat action.
1148 *
1149 * Results:
1150 * None.
1151 *
1152 * Side effects:
1153 * Whatever action corresponds to the current mouse button
1154 * is repeated, and this procedure is rescheduled to execute
1155 * again later.
1156 *
1157 *--------------------------------------------------------------
1158 */
1159
1160static void
1161ScrollbarTimerProc(clientData)
1162 ClientData clientData; /* Information about widget. */
1163{
1164 register Scrollbar *scrollPtr = (Scrollbar *) clientData;
1165
1166 Tk_Preserve((ClientData) scrollPtr);
1167 switch(scrollPtr->pressField) {
1168 case TOP_ARROW:
1169 ScrollCmd(scrollPtr, scrollPtr->firstUnit-1);
1170 break;
1171 case TOP_GAP:
1172 ScrollCmd(scrollPtr, scrollPtr->firstUnit
1173 - (scrollPtr->windowUnits-1));
1174 break;
1175 case BOTTOM_GAP: {
1176 ScrollCmd(scrollPtr, scrollPtr->firstUnit
1177 + (scrollPtr->windowUnits-1));
1178 break;
1179 }
1180 case BOTTOM_ARROW:
1181 ScrollCmd(scrollPtr, scrollPtr->firstUnit+1);
1182 break;
1183 }
1184 if (scrollPtr->tkwin != NULL) {
1185 scrollPtr->autoRepeat = Tk_CreateTimerHandler(
1186 scrollPtr->repeatInterval, ScrollbarTimerProc,
1187 (ClientData) scrollPtr);
1188 }
1189 Tk_Release((ClientData) scrollPtr);
1190}
Impressum, Datenschutz