blob: d2a9987221b3edb68ad8661c2313f6e5c31b06ca [file] [log] [blame]
Martin v. Löwise354d782008-12-29 16:03:04 +00001"""A ScrolledText widget feels like a text widget but also has a
2vertical scroll bar on its right. (Later, options may be added to
3add a horizontal bar as well, to make the bars disappear
4automatically when not needed, to move them to the other side of the
5window, etc.)
Guido van Rossum18468821994-06-20 07:49:28 +00006
Martin v. Löwise354d782008-12-29 16:03:04 +00007Configuration options are passed to the Text widget.
8A Frame widget is inserted between the master and the text, to hold
9the Scrollbar widget.
10Most methods calls are inherited from the Text widget; Pack, Grid and
11Place methods are redirected to the Frame widget however.
12"""
13
14__all__ = ['ScrolledText']
15
16from tkinter import Frame, Text, Scrollbar, Pack, Grid, Place
17from tkinter.constants import RIGHT, LEFT, Y, BOTH
Guido van Rossum18468821994-06-20 07:49:28 +000018
Guido van Rossum460b6bb1994-07-06 21:54:39 +000019class ScrolledText(Text):
Martin v. Löwise354d782008-12-29 16:03:04 +000020 def __init__(self, master=None, **kw):
21 self.frame = Frame(master)
22 self.vbar = Scrollbar(self.frame)
Fred Draked038ca82000-10-23 18:31:14 +000023 self.vbar.pack(side=RIGHT, fill=Y)
Martin v. Löwise354d782008-12-29 16:03:04 +000024
25 kw.update({'yscrollcommand': self.vbar.set})
26 Text.__init__(self, self.frame, **kw)
27 self.pack(side=LEFT, fill=BOTH, expand=True)
Fred Draked038ca82000-10-23 18:31:14 +000028 self.vbar['command'] = self.yview
Guido van Rossum460b6bb1994-07-06 21:54:39 +000029
Guido van Rossum61d36372001-12-10 16:42:43 +000030 # Copy geometry methods of self.frame -- hack!
Martin v. Löwise354d782008-12-29 16:03:04 +000031 methods = vars(Pack).keys() + vars(Grid).keys() + vars(Place).keys()
Guido van Rossum61d36372001-12-10 16:42:43 +000032
33 for m in methods:
Fred Draked038ca82000-10-23 18:31:14 +000034 if m[0] != '_' and m != 'config' and m != 'configure':
35 setattr(self, m, getattr(self.frame, m))
Martin v. Löwise354d782008-12-29 16:03:04 +000036
37 def __str__(self):
38 return str(self.frame)
39
40
41def example():
42 import __main__
43 from tkinter.constants import END
44
45 stext = ScrolledText(bg='white', height=10)
46 stext.insert(END, __main__.__doc__)
47 stext.pack(fill=BOTH, side=LEFT, expand=True)
48 stext.focus_set()
49 stext.mainloop()
50
51if __name__ == "__main__":
52 example()