Added 'description' class attribute to every command class (to help the
[python/dscho.git] / Mac / Lib / FrameWork.py
blobe56679dea180043315c4a20c0a50376e3fcc5200
1 "A sort of application framework for the Mac"
3 DEBUG=0
5 import MacOS
6 import traceback
8 from AE import *
9 from AppleEvents import *
10 from Ctl import *
11 from Controls import *
12 from Dlg import *
13 from Dialogs import *
14 from Evt import *
15 from Events import *
16 from Menu import *
17 from Menus import *
18 from Qd import *
19 from QuickDraw import *
20 #from Res import *
21 #from Resources import *
22 #from Snd import *
23 #from Sound import *
24 from Win import *
25 from Windows import *
26 import types
28 import EasyDialogs
30 kHighLevelEvent = 23 # Don't know what header file this should come from
31 SCROLLBARWIDTH = 16 # Again, not a clue...
34 # Map event 'what' field to strings
35 eventname = {}
36 eventname[1] = 'mouseDown'
37 eventname[2] = 'mouseUp'
38 eventname[3] = 'keyDown'
39 eventname[4] = 'keyUp'
40 eventname[5] = 'autoKey'
41 eventname[6] = 'updateEvt'
42 eventname[7] = 'diskEvt'
43 eventname[8] = 'activateEvt'
44 eventname[15] = 'osEvt'
45 eventname[23] = 'kHighLevelEvent'
47 # Map part codes returned by WhichWindow() to strings
48 partname = {}
49 partname[0] = 'inDesk'
50 partname[1] = 'inMenuBar'
51 partname[2] = 'inSysWindow'
52 partname[3] = 'inContent'
53 partname[4] = 'inDrag'
54 partname[5] = 'inGrow'
55 partname[6] = 'inGoAway'
56 partname[7] = 'inZoomIn'
57 partname[8] = 'inZoomOut'
60 # The useable portion of the screen
61 # ## but what happens with multiple screens? jvr
62 screenbounds = qd.screenBits.bounds
63 screenbounds = screenbounds[0]+4, screenbounds[1]+4, \
64 screenbounds[2]-4, screenbounds[3]-4
66 next_window_x = 16 # jvr
67 next_window_y = 44 # jvr
69 def windowbounds(width, height):
70 "Return sensible window bounds"
71 global next_window_x, next_window_y
72 r, b = next_window_x+width, next_window_y+height
73 if r > screenbounds[2]:
74 next_window_x = 16
75 if b > screenbounds[3]:
76 next_window_y = 44
77 l, t = next_window_x, next_window_y
78 r, b = next_window_x+width, next_window_y+height
79 next_window_x, next_window_y = next_window_x + 8, next_window_y + 20 # jvr
80 return l, t, r, b
82 _watch = None
83 def setwatchcursor():
84 global _watch
86 if _watch == None:
87 _watch = GetCursor(4).data
88 SetCursor(_watch)
90 def setarrowcursor():
91 SetCursor(qd.arrow)
93 class Application:
95 "Application framework -- your application should be a derived class"
97 def __init__(self, nomenubar=0):
98 self._doing_asyncevents = 0
99 self.quitting = 0
100 self.needmenubarredraw = 0
101 self._windows = {}
102 if nomenubar:
103 self.menubar = None
104 else:
105 self.makemenubar()
107 def __del__(self):
108 if self._doing_asyncevents:
109 self._doing_asyncevents = 0
110 MacOS.SetEventHandler()
112 def makemenubar(self):
113 self.menubar = MenuBar(self)
114 AppleMenu(self.menubar, self.getabouttext(), self.do_about)
115 self.makeusermenus()
117 def makeusermenus(self):
118 self.filemenu = m = Menu(self.menubar, "File")
119 self._quititem = MenuItem(m, "Quit", "Q", self._quit)
121 def _quit(self, *args):
122 self.quitting = 1
124 def cleanup(self):
125 for w in self._windows.values():
126 w.do_close()
127 return self._windows == {}
129 def appendwindow(self, wid, window):
130 self._windows[wid] = window
132 def removewindow(self, wid):
133 del self._windows[wid]
135 def getabouttext(self):
136 return "About %s..." % self.__class__.__name__
138 def do_about(self, id, item, window, event):
139 EasyDialogs.Message("Hello, world!" + "\015(%s)" % self.__class__.__name__)
141 # The main event loop is broken up in several simple steps.
142 # This is done so you can override each individual part,
143 # if you have a need to do extra processing independent of the
144 # event type.
145 # Normally, however, you'd just define handlers for individual
146 # events.
147 # (XXX I'm not sure if using default parameter values is the right
148 # way to define the mask and wait time passed to WaitNextEvent.)
150 def mainloop(self, mask = everyEvent, wait = 0):
151 self.quitting = 0
152 saveparams = apply(MacOS.SchedParams, self.schedparams)
153 try:
154 while not self.quitting:
155 try:
156 self.do1event(mask, wait)
157 except (Application, SystemExit):
158 # Note: the raising of "self" is old-fashioned idiom to
159 # exit the mainloop. Calling _quit() is better for new
160 # applications.
161 break
162 finally:
163 apply(MacOS.SchedParams, saveparams)
165 schedparams = (0, 0) # By default disable Python's event handling
167 def dopendingevents(self, mask = everyEvent):
168 """dopendingevents - Handle all pending events"""
169 while self.do1event(mask, wait=0):
170 pass
172 def do1event(self, mask = everyEvent, wait = 0):
173 ok, event = self.getevent(mask, wait)
174 if IsDialogEvent(event):
175 if self.do_dialogevent(event):
176 return
177 if ok:
178 self.dispatch(event)
179 else:
180 self.idle(event)
182 def idle(self, event):
183 pass
185 def getevent(self, mask = everyEvent, wait = 0):
186 if self.needmenubarredraw:
187 DrawMenuBar()
188 self.needmenubarredraw = 0
189 ok, event = WaitNextEvent(mask, wait)
190 return ok, event
192 def dispatch(self, event):
193 # The following appears to be double work (already done in do1event)
194 # but we need it for asynchronous event handling
195 if IsDialogEvent(event):
196 if self.do_dialogevent(event):
197 return
198 (what, message, when, where, modifiers) = event
199 if eventname.has_key(what):
200 name = "do_" + eventname[what]
201 else:
202 name = "do_%d" % what
203 try:
204 handler = getattr(self, name)
205 except AttributeError:
206 handler = self.do_unknownevent
207 handler(event)
209 def asyncevents(self, onoff):
210 """asyncevents - Set asynchronous event handling on or off"""
211 old = self._doing_asyncevents
212 if old:
213 MacOS.SetEventHandler()
214 apply(MacOS.SchedParams, self.schedparams)
215 if onoff:
216 MacOS.SetEventHandler(self.dispatch)
217 doint, dummymask, benice, howoften, bgyield = \
218 self.schedparams
219 MacOS.SchedParams(doint, everyEvent, benice,
220 howoften, bgyield)
221 self._doing_asyncevents = onoff
222 return old
224 def do_dialogevent(self, event):
225 gotone, window, item = DialogSelect(event)
226 if gotone:
227 if self._windows.has_key(window):
228 self._windows[window].do_itemhit(item, event)
229 else:
230 print 'Dialog event for unknown dialog'
231 return 1
232 return 0
234 def do_mouseDown(self, event):
235 (what, message, when, where, modifiers) = event
236 partcode, wid = FindWindow(where)
239 # Find the correct name.
241 if partname.has_key(partcode):
242 name = "do_" + partname[partcode]
243 else:
244 name = "do_%d" % partcode
246 if wid == None:
247 # No window, or a non-python window
248 try:
249 handler = getattr(self, name)
250 except AttributeError:
251 # Not menubar or something, so assume someone
252 # else's window
253 MacOS.HandleEvent(event)
254 return
255 elif self._windows.has_key(wid):
256 # It is a window. Hand off to correct window.
257 window = self._windows[wid]
258 try:
259 handler = getattr(window, name)
260 except AttributeError:
261 handler = self.do_unknownpartcode
262 else:
263 # It is a python-toolbox window, but not ours.
264 handler = self.do_unknownwindow
265 handler(partcode, wid, event)
267 def do_inSysWindow(self, partcode, window, event):
268 MacOS.HandleEvent(event)
270 def do_inDesk(self, partcode, window, event):
271 MacOS.HandleEvent(event)
273 def do_inMenuBar(self, partcode, window, event):
274 if not self.menubar:
275 MacOS.HandleEvent(event)
276 return
277 (what, message, when, where, modifiers) = event
278 result = MenuSelect(where)
279 id = (result>>16) & 0xffff # Hi word
280 item = result & 0xffff # Lo word
281 self.do_rawmenu(id, item, window, event)
283 def do_rawmenu(self, id, item, window, event):
284 try:
285 self.do_menu(id, item, window, event)
286 finally:
287 HiliteMenu(0)
289 def do_menu(self, id, item, window, event):
290 self.menubar.dispatch(id, item, window, event)
293 def do_unknownpartcode(self, partcode, window, event):
294 (what, message, when, where, modifiers) = event
295 if DEBUG: print "Mouse down at global:", where
296 if DEBUG: print "\tUnknown part code:", partcode
297 if DEBUG: print "\tEvent:", self.printevent(event)
298 MacOS.HandleEvent(event)
300 def do_unknownwindow(self, partcode, window, event):
301 if DEBUG: print 'Unknown window:', window
302 MacOS.HandleEvent(event)
304 def do_keyDown(self, event):
305 self.do_key(event)
307 def do_autoKey(self, event):
308 if not event[-1] & cmdKey:
309 self.do_key(event)
311 def do_key(self, event):
312 (what, message, when, where, modifiers) = event
313 c = chr(message & charCodeMask)
314 if self.menubar:
315 result = MenuEvent(event)
316 id = (result>>16) & 0xffff # Hi word
317 item = result & 0xffff # Lo word
318 if id:
319 self.do_rawmenu(id, item, None, event)
320 return
321 # Otherwise we fall-through
322 if modifiers & cmdKey:
323 if c == '.':
324 raise self
325 else:
326 if not self.menubar:
327 MacOS.HandleEvent(event)
328 return
329 else:
330 # See whether the front window wants it
331 w = FrontWindow()
332 if w and self._windows.has_key(w):
333 window = self._windows[w]
334 try:
335 do_char = window.do_char
336 except AttributeError:
337 do_char = self.do_char
338 do_char(c, event)
339 # else it wasn't for us, sigh...
341 def do_char(self, c, event):
342 if DEBUG: print "Character", `c`
344 def do_updateEvt(self, event):
345 (what, message, when, where, modifiers) = event
346 wid = WhichWindow(message)
347 if wid and self._windows.has_key(wid):
348 window = self._windows[wid]
349 window.do_rawupdate(wid, event)
350 else:
351 MacOS.HandleEvent(event)
353 def do_activateEvt(self, event):
354 (what, message, when, where, modifiers) = event
355 wid = WhichWindow(message)
356 if wid and self._windows.has_key(wid):
357 window = self._windows[wid]
358 window.do_activate(modifiers & 1, event)
359 else:
360 MacOS.HandleEvent(event)
362 def do_osEvt(self, event):
363 (what, message, when, where, modifiers) = event
364 which = (message >> 24) & 0xff
365 if which == 1: # suspend/resume
366 self.do_suspendresume(event)
367 else:
368 if DEBUG:
369 print 'unknown osEvt:',
370 self.printevent(event)
372 def do_suspendresume(self, event):
373 (what, message, when, where, modifiers) = event
374 wid = FrontWindow()
375 if wid and self._windows.has_key(wid):
376 window = self._windows[wid]
377 window.do_activate(message & 1, event)
379 def do_kHighLevelEvent(self, event):
380 (what, message, when, where, modifiers) = event
381 if DEBUG:
382 print "High Level Event:",
383 self.printevent(event)
384 try:
385 AEProcessAppleEvent(event)
386 except:
387 print "AEProcessAppleEvent error:"
388 traceback.print_exc()
390 def do_unknownevent(self, event):
391 if DEBUG:
392 print "Unhandled event:",
393 self.printevent(event)
395 def printevent(self, event):
396 (what, message, when, where, modifiers) = event
397 nicewhat = `what`
398 if eventname.has_key(what):
399 nicewhat = eventname[what]
400 print nicewhat,
401 if what == kHighLevelEvent:
402 h, v = where
403 print `ostypecode(message)`, hex(when), `ostypecode(h | (v<<16))`,
404 else:
405 print hex(message), hex(when), where,
406 print hex(modifiers)
409 class MenuBar:
410 """Represent a set of menus in a menu bar.
412 Interface:
414 - (constructor)
415 - (destructor)
416 - addmenu
417 - addpopup (normally used internally)
418 - dispatch (called from Application)
421 nextid = 1 # Necessarily a class variable
423 def getnextid(self):
424 id = MenuBar.nextid
425 MenuBar.nextid = id+1
426 return id
428 def __init__(self, parent=None):
429 self.parent = parent
430 ClearMenuBar()
431 self.bar = GetMenuBar()
432 self.menus = {}
434 # XXX necessary?
435 def close(self):
436 self.parent = None
437 self.bar = None
438 self.menus = None
440 def addmenu(self, title, after = 0):
441 id = self.getnextid()
442 if DEBUG: print 'Newmenu', title, id # XXXX
443 m = NewMenu(id, title)
444 m.InsertMenu(after)
445 if after >= 0:
446 if self.parent:
447 self.parent.needmenubarredraw = 1
448 else:
449 DrawMenuBar()
450 return id, m
452 def delmenu(self, id):
453 if DEBUG: print 'Delmenu', id # XXXX
454 DeleteMenu(id)
456 def addpopup(self, title = ''):
457 return self.addmenu(title, -1)
459 # Useless:
460 # def install(self):
461 # if not self.bar: return
462 # SetMenuBar(self.bar)
463 # if self.parent:
464 # self.parent.needmenubarredraw = 1
465 # else:
466 # DrawMenuBar()
468 def fixmenudimstate(self):
469 for m in self.menus.keys():
470 menu = self.menus[m]
471 if menu.__class__ == FrameWork.AppleMenu:
472 continue
473 for i in range(len(menu.items)):
474 label, shortcut, callback, kind = menu.items[i]
475 if type(callback) == types.StringType:
476 wid = Win.FrontWindow()
477 if wid and self.parent._windows.has_key(wid):
478 window = self.parent._windows[wid]
479 if hasattr(window, "domenu_" + callback):
480 menu.menu.EnableItem(i + 1)
481 elif hasattr(self.parent, "domenu_" + callback):
482 menu.menu.EnableItem(i + 1)
483 else:
484 menu.menu.DisableItem(i + 1)
485 elif hasattr(self.parent, "domenu_" + callback):
486 menu.menu.EnableItem(i + 1)
487 else:
488 menu.menu.DisableItem(i + 1)
489 elif callback:
490 pass
492 def dispatch(self, id, item, window, event):
493 if self.menus.has_key(id):
494 self.menus[id].dispatch(id, item, window, event)
495 else:
496 if DEBUG: print "MenuBar.dispatch(%d, %d, %s, %s)" % \
497 (id, item, window, event)
500 # XXX Need a way to get menus as resources and bind them to callbacks
502 class Menu:
503 "One menu."
505 def __init__(self, bar, title, after=0):
506 self.bar = bar
507 self.id, self.menu = self.bar.addmenu(title, after)
508 bar.menus[self.id] = self
509 self.items = []
510 self._parent = None
512 def delete(self):
513 self.bar.delmenu(self.id)
514 del self.bar.menus[self.id]
515 del self.bar
516 del self.items
517 del self.menu
518 del self.id
519 del self._parent
521 def additem(self, label, shortcut=None, callback=None, kind=None):
522 self.menu.AppendMenu('x') # add a dummy string
523 self.items.append(label, shortcut, callback, kind)
524 item = len(self.items)
525 self.menu.SetMenuItemText(item, label) # set the actual text
526 if shortcut and type(shortcut) == type(()):
527 modifiers, char = shortcut[:2]
528 self.menu.SetItemCmd(item, ord(char))
529 self.menu.SetMenuItemModifiers(item, modifiers)
530 if len(shortcut) > 2:
531 self.menu.SetMenuItemKeyGlyph(item, shortcut[2])
532 elif shortcut:
533 self.menu.SetItemCmd(item, ord(shortcut))
534 return item
536 def delitem(self, item):
537 if item != len(self.items):
538 raise 'Can only delete last item of a menu'
539 self.menu.DeleteMenuItem(item)
540 del self.items[item-1]
542 def addcheck(self, label, shortcut=None, callback=None):
543 return self.additem(label, shortcut, callback, 'check')
545 def addradio(self, label, shortcut=None, callback=None):
546 return self.additem(label, shortcut, callback, 'radio')
548 def addseparator(self):
549 self.menu.AppendMenu('(-')
550 self.items.append('', None, None, 'separator')
552 def addsubmenu(self, label, title=''):
553 sub = Menu(self.bar, title, -1)
554 item = self.additem(label, '\x1B', None, 'submenu')
555 self.menu.SetItemMark(item, sub.id)
556 sub._parent = self
557 sub._parent_item = item
558 return sub
560 def dispatch(self, id, item, window, event):
561 title, shortcut, callback, mtype = self.items[item-1]
562 if callback:
563 if not self.bar.parent or type(callback) <> types.StringType:
564 menuhandler = callback
565 else:
566 # callback is string
567 wid = Win.FrontWindow()
568 if wid and self.bar.parent._windows.has_key(wid):
569 window = self.bar.parent._windows[wid]
570 if hasattr(window, "domenu_" + callback):
571 menuhandler = getattr(window, "domenu_" + callback)
572 elif hasattr(self.bar.parent, "domenu_" + callback):
573 menuhandler = getattr(self.bar.parent, "domenu_" + callback)
574 else:
575 # nothing we can do. we shouldn't have come this far
576 # since the menu item should have been disabled...
577 return
578 elif hasattr(self.bar.parent, "domenu_" + callback):
579 menuhandler = getattr(self.bar.parent, "domenu_" + callback)
580 else:
581 # nothing we can do. we shouldn't have come this far
582 # since the menu item should have been disabled...
583 return
584 menuhandler(id, item, window, event)
586 def enable(self, onoff):
587 if onoff:
588 self.menu.EnableItem(0)
589 if self._parent:
590 self._parent.menu.EnableItem(self._parent_item)
591 else:
592 self.menu.DisableItem(0)
593 if self._parent:
594 self._parent.menu.DisableItem(self._parent_item)
595 if self.bar and self.bar.parent:
596 self.bar.parent.needmenubarredraw = 1
598 class PopupMenu(Menu):
599 def __init__(self, bar):
600 Menu.__init__(self, bar, '(popup)', -1)
602 def popup(self, x, y, event, default=1, window=None):
603 # NOTE that x and y are global coordinates, and they should probably
604 # be topleft of the button the user clicked (not mouse-coordinates),
605 # so the popup nicely overlaps.
606 reply = self.menu.PopUpMenuSelect(x, y, default)
607 if not reply:
608 return
609 id = (reply & 0xffff0000) >> 16
610 item = reply & 0xffff
611 if not window:
612 wid = Win.FrontWindow()
613 try:
614 window = self.bar.parent._windows[wid]
615 except:
616 pass # If we can't find the window we pass None
617 self.dispatch(id, item, window, event)
619 class MenuItem:
620 def __init__(self, menu, title, shortcut=None, callback=None, kind=None):
621 self.item = menu.additem(title, shortcut, callback)
622 self.menu = menu
624 def delete(self):
625 self.menu.delitem(self.item)
626 del self.menu
627 del self.item
629 def check(self, onoff):
630 self.menu.menu.CheckItem(self.item, onoff)
632 def enable(self, onoff):
633 if onoff:
634 self.menu.menu.EnableItem(self.item)
635 else:
636 self.menu.menu.DisableItem(self.item)
638 def settext(self, text):
639 self.menu.menu.SetMenuItemText(self.item, text)
641 def setstyle(self, style):
642 self.menu.menu.SetItemStyle(self.item, style)
644 def seticon(self, icon):
645 self.menu.menu.SetItemIcon(self.item, icon)
647 def setcmd(self, cmd):
648 self.menu.menu.SetItemCmd(self.item, cmd)
650 def setmark(self, cmd):
651 self.menu.menu.SetItemMark(self.item, cmd)
654 class RadioItem(MenuItem):
655 def __init__(self, menu, title, shortcut=None, callback=None):
656 MenuItem.__init__(self, menu, title, shortcut, callback, 'radio')
658 class CheckItem(MenuItem):
659 def __init__(self, menu, title, shortcut=None, callback=None):
660 MenuItem.__init__(self, menu, title, shortcut, callback, 'check')
662 def Separator(menu):
663 menu.addseparator()
665 def SubMenu(menu, label, title=''):
666 return menu.addsubmenu(label, title)
669 class AppleMenu(Menu):
671 def __init__(self, bar, abouttext="About me...", aboutcallback=None):
672 Menu.__init__(self, bar, "\024")
673 self.additem(abouttext, None, aboutcallback)
674 self.addseparator()
675 self.menu.AppendResMenu('DRVR')
677 def dispatch(self, id, item, window, event):
678 if item == 1:
679 Menu.dispatch(self, id, item, window, event)
680 else:
681 name = self.menu.GetMenuItemText(item)
682 OpenDeskAcc(name)
684 class Window:
685 """A single window belonging to an application"""
687 def __init__(self, parent):
688 self.wid = None
689 self.parent = parent
691 def open(self, bounds=(40, 40, 400, 400), resid=None):
692 if resid <> None:
693 self.wid = GetNewWindow(resid, -1)
694 else:
695 self.wid = NewWindow(bounds, self.__class__.__name__, 1,
696 8, -1, 1, 0) # changed to proc id 8 to include zoom box. jvr
697 self.do_postopen()
699 def do_postopen(self):
700 """Tell our parent we exist"""
701 self.parent.appendwindow(self.wid, self)
703 def close(self):
704 self.do_postclose()
706 def do_postclose(self):
707 self.parent.removewindow(self.wid)
708 self.parent = None
709 self.wid = None
711 def SetPort(self):
712 # Convinience method
713 SetPort(self.wid)
715 def do_inDrag(self, partcode, window, event):
716 where = event[3]
717 window.DragWindow(where, self.draglimit)
719 draglimit = screenbounds
721 def do_inGoAway(self, partcode, window, event):
722 where = event[3]
723 if window.TrackGoAway(where):
724 self.close()
726 def do_inZoom(self, partcode, window, event):
727 (what, message, when, where, modifiers) = event
728 if window.TrackBox(where, partcode):
729 window.ZoomWindow(partcode, 1)
730 rect = window.GetWindowUserState() # so that zoom really works... jvr
731 self.do_postresize(rect[2] - rect[0], rect[3] - rect[1], window) # jvr
733 def do_inZoomIn(self, partcode, window, event):
734 SetPort(window) # !!!
735 self.do_inZoom(partcode, window, event)
737 def do_inZoomOut(self, partcode, window, event):
738 SetPort(window) # !!!
739 self.do_inZoom(partcode, window, event)
741 def do_inGrow(self, partcode, window, event):
742 (what, message, when, where, modifiers) = event
743 result = window.GrowWindow(where, self.growlimit)
744 if result:
745 height = (result>>16) & 0xffff # Hi word
746 width = result & 0xffff # Lo word
747 self.do_resize(width, height, window)
749 growlimit = (50, 50, screenbounds[2] - screenbounds[0], screenbounds[3] - screenbounds[1]) # jvr
751 def do_resize(self, width, height, window):
752 l, t, r, b = self.wid.GetWindowPort().portRect # jvr, forGrowIcon
753 self.SetPort() # jvr
754 InvalRect((r - SCROLLBARWIDTH + 1, b - SCROLLBARWIDTH + 1, r, b)) # jvr
755 window.SizeWindow(width, height, 1) # changed updateFlag to true jvr
756 self.do_postresize(width, height, window)
758 def do_postresize(self, width, height, window):
759 SetPort(window)
760 InvalRect(window.GetWindowPort().portRect)
762 def do_inContent(self, partcode, window, event):
764 # If we're not frontmost, select ourselves and wait for
765 # the activate event.
767 if FrontWindow() <> window:
768 window.SelectWindow()
769 return
770 # We are. Handle the event.
771 (what, message, when, where, modifiers) = event
772 SetPort(window)
773 local = GlobalToLocal(where)
774 self.do_contentclick(local, modifiers, event)
776 def do_contentclick(self, local, modifiers, event):
777 if DEBUG:
778 print 'Click in contents at %s, modifiers %s'%(local, modifiers)
780 def do_rawupdate(self, window, event):
781 if DEBUG: print "raw update for", window
782 SetPort(window)
783 window.BeginUpdate()
784 self.do_update(window, event)
785 window.EndUpdate()
787 def do_update(self, window, event):
788 if DEBUG:
789 import time
790 for i in range(8):
791 time.sleep(0.1)
792 InvertRgn(window.GetWindowPort().visRgn)
793 FillRgn(window.GetWindowPort().visRgn, qd.gray)
794 else:
795 EraseRgn(window.GetWindowPort().visRgn)
797 def do_activate(self, activate, event):
798 if DEBUG: print 'Activate %d for %s'%(activate, self.wid)
800 class ControlsWindow(Window):
802 def do_rawupdate(self, window, event):
803 if DEBUG: print "raw update for", window
804 SetPort(window)
805 window.BeginUpdate()
806 self.do_update(window, event)
807 #DrawControls(window) # jvr
808 UpdateControls(window, window.GetWindowPort().visRgn) # jvr
809 window.DrawGrowIcon()
810 window.EndUpdate()
812 def do_controlhit(self, window, control, pcode, event):
813 if DEBUG: print "control hit in", window, "on", control, "; pcode =", pcode
815 def do_inContent(self, partcode, window, event):
816 if FrontWindow() <> window:
817 window.SelectWindow()
818 return
819 (what, message, when, where, modifiers) = event
820 SetPort(window) # XXXX Needed?
821 local = GlobalToLocal(where)
822 pcode, control = FindControl(local, window)
823 if pcode and control:
824 self.do_rawcontrolhit(window, control, pcode, local, event)
825 else:
826 if DEBUG: print "FindControl(%s, %s) -> (%s, %s)" % \
827 (local, window, pcode, control)
828 self.do_contentclick(local, modifiers, event)
830 def do_rawcontrolhit(self, window, control, pcode, local, event):
831 pcode = control.TrackControl(local)
832 if pcode:
833 self.do_controlhit(window, control, pcode, event)
835 class ScrolledWindow(ControlsWindow):
836 def __init__(self, parent):
837 self.barx = self.bary = None
838 self.barx_enabled = self.bary_enabled = 1
839 self.activated = 1
840 ControlsWindow.__init__(self, parent)
842 def scrollbars(self, wantx=1, wanty=1):
843 SetPort(self.wid)
844 self.barx = self.bary = None
845 self.barx_enabled = self.bary_enabled = 1
846 x0, y0, x1, y1 = self.wid.GetWindowPort().portRect
847 vx, vy = self.getscrollbarvalues()
848 if vx == None: self.barx_enabled, vx = 0, 0
849 if vy == None: self.bary_enabled, vy = 0, 0
850 if wantx:
851 rect = x0-1, y1-(SCROLLBARWIDTH-1), x1-(SCROLLBARWIDTH-2), y1+1
852 self.barx = NewControl(self.wid, rect, "", 1, vx, 0, 32767, 16, 0)
853 if not self.barx_enabled: self.barx.HiliteControl(255)
854 ## InvalRect(rect)
855 if wanty:
856 rect = x1-(SCROLLBARWIDTH-1), y0-1, x1+1, y1-(SCROLLBARWIDTH-2)
857 self.bary = NewControl(self.wid, rect, "", 1, vy, 0, 32767, 16, 0)
858 if not self.bary_enabled: self.bary.HiliteControl(255)
859 ## InvalRect(rect)
861 def do_postclose(self):
862 self.barx = self.bary = None
863 ControlsWindow.do_postclose(self)
865 def do_activate(self, onoff, event):
866 self.activated = onoff
867 if onoff:
868 if self.barx and self.barx_enabled:
869 self.barx.ShowControl() # jvr
870 if self.bary and self.bary_enabled:
871 self.bary.ShowControl() # jvr
872 else:
873 if self.barx:
874 self.barx.HideControl() # jvr; An inactive window should have *hidden*
875 # scrollbars, not just dimmed (no matter what
876 # BBEdit does... look at the Finder)
877 if self.bary:
878 self.bary.HideControl() # jvr
879 self.wid.DrawGrowIcon() # jvr
881 def do_postresize(self, width, height, window):
882 l, t, r, b = self.wid.GetWindowPort().portRect
883 self.SetPort()
884 if self.barx:
885 self.barx.HideControl() # jvr
886 self.barx.MoveControl(l-1, b-(SCROLLBARWIDTH-1))
887 self.barx.SizeControl((r-l)-(SCROLLBARWIDTH-3), SCROLLBARWIDTH) # jvr
888 if self.bary:
889 self.bary.HideControl() # jvr
890 self.bary.MoveControl(r-(SCROLLBARWIDTH-1), t-1)
891 self.bary.SizeControl(SCROLLBARWIDTH, (b-t)-(SCROLLBARWIDTH-3)) # jvr
892 if self.barx:
893 self.barx.ShowControl() # jvr
894 ValidRect((l, b - SCROLLBARWIDTH + 1, r - SCROLLBARWIDTH + 2, b)) # jvr
895 if self.bary:
896 self.bary.ShowControl() # jvr
897 ValidRect((r - SCROLLBARWIDTH + 1, t, r, b - SCROLLBARWIDTH + 2)) # jvr
898 InvalRect((r - SCROLLBARWIDTH + 1, b - SCROLLBARWIDTH + 1, r, b)) # jvr, growicon
901 def do_rawcontrolhit(self, window, control, pcode, local, event):
902 if control == self.barx:
903 which = 'x'
904 elif control == self.bary:
905 which = 'y'
906 else:
907 return 0
908 if pcode in (inUpButton, inDownButton, inPageUp, inPageDown):
909 # We do the work for the buttons and grey area in the tracker
910 dummy = control.TrackControl(local, self.do_controltrack)
911 else:
912 # but the thumb is handled here
913 pcode = control.TrackControl(local)
914 if pcode == inThumb:
915 value = control.GetControlValue()
916 print 'setbars', which, value #DBG
917 self.scrollbar_callback(which, 'set', value)
918 self.updatescrollbars()
919 else:
920 print 'funny part', pcode #DBG
921 return 1
923 def do_controltrack(self, control, pcode):
924 if control == self.barx:
925 which = 'x'
926 elif control == self.bary:
927 which = 'y'
928 else:
929 return
931 if pcode == inUpButton:
932 what = '-'
933 elif pcode == inDownButton:
934 what = '+'
935 elif pcode == inPageUp:
936 what = '--'
937 elif pcode == inPageDown:
938 what = '++'
939 else:
940 return
941 self.scrollbar_callback(which, what, None)
942 self.updatescrollbars()
944 def updatescrollbars(self):
945 SetPort(self.wid)
946 vx, vy = self.getscrollbarvalues()
947 if self.barx:
948 if vx == None:
949 self.barx.HiliteControl(255)
950 self.barx_enabled = 0
951 else:
952 if not self.barx_enabled:
953 self.barx_enabled = 1
954 if self.activated:
955 self.barx.HiliteControl(0)
956 self.barx.SetControlValue(vx)
957 if self.bary:
958 if vy == None:
959 self.bary.HiliteControl(255)
960 self.bary_enabled = 0
961 else:
962 if not self.bary_enabled:
963 self.bary_enabled = 1
964 if self.activated:
965 self.bary.HiliteControl(0)
966 self.bary.SetControlValue(vy)
968 # Auxiliary function: convert standard text/image/etc coordinate
969 # to something palatable as getscrollbarvalues() return
970 def scalebarvalue(self, absmin, absmax, curmin, curmax):
971 if curmin <= absmin and curmax >= absmax:
972 return None
973 if curmin <= absmin:
974 return 0
975 if curmax >= absmax:
976 return 32767
977 perc = float(curmin-absmin)/float(absmax-absmin)
978 return int(perc*32767)
980 # To be overridden:
982 def getscrollbarvalues(self):
983 return 0, 0
985 def scrollbar_callback(self, which, what, value):
986 print 'scroll', which, what, value
988 class DialogWindow(Window):
989 """A modeless dialog window"""
991 def open(self, resid):
992 self.wid = GetNewDialog(resid, -1)
993 self.do_postopen()
995 def close(self):
996 self.do_postclose()
998 def do_itemhit(self, item, event):
999 print 'Dialog %s, item %d hit'%(self.wid, item)
1001 def do_rawupdate(self, window, event):
1002 pass
1004 def ostypecode(x):
1005 "Convert a long int to the 4-character code it really is"
1006 s = ''
1007 for i in range(4):
1008 x, c = divmod(x, 256)
1009 s = chr(c) + s
1010 return s
1013 class TestApp(Application):
1015 "This class is used by the test() function"
1017 def makeusermenus(self):
1018 self.filemenu = m = Menu(self.menubar, "File")
1019 self.saveitem = MenuItem(m, "Save", "S", self.save)
1020 Separator(m)
1021 self.optionsmenu = mm = SubMenu(m, "Options")
1022 self.opt1 = CheckItem(mm, "Arguments", "A")
1023 self.opt2 = CheckItem(mm, "Being hit on the head lessons", (kMenuOptionModifier, "A"))
1024 self.opt3 = CheckItem(mm, "Complaints", (kMenuOptionModifier|kMenuNoCommandModifier, "A"))
1025 Separator(m)
1026 self.quititem = MenuItem(m, "Quit", "Q", self.quit)
1028 def save(self, *args):
1029 print "Save"
1031 def quit(self, *args):
1032 raise self
1035 def test():
1036 "Test program"
1037 app = TestApp()
1038 app.mainloop()
1041 if __name__ == '__main__':
1042 test()