1"""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.)
6
7Configuration 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
18
19class ScrolledText(Text):
20    def __init__(self, master=None, **kw):
21        self.frame = Frame(master)
22        self.vbar = Scrollbar(self.frame)
23        self.vbar.pack(side=RIGHT, fill=Y)
24
25        kw.update({'yscrollcommand': self.vbar.set})
26        Text.__init__(self, self.frame, **kw)
27        self.pack(side=LEFT, fill=BOTH, expand=True)
28        self.vbar['command'] = self.yview
29
30        # Copy geometry methods of self.frame without overriding Text
31        # methods -- hack!
32        text_meths = vars(Text).keys()
33        methods = vars(Pack).keys() | vars(Grid).keys() | vars(Place).keys()
34        methods = methods.difference(text_meths)
35
36        for m in methods:
37            if m[0] != '_' and m != 'config' and m != 'configure':
38                setattr(self, m, getattr(self.frame, m))
39
40    def __str__(self):
41        return str(self.frame)
42
43
44def example():
45    from tkinter.constants import END
46
47    stext = ScrolledText(bg='white', height=10)
48    stext.insert(END, __doc__)
49    stext.pack(fill=BOTH, side=LEFT, expand=True)
50    stext.focus_set()
51    stext.mainloop()
52
53if __name__ == "__main__":
54    example()
55