blob: 549a32a66afc6fbe8993e0396513bfbe1f9902a6 [file] [log] [blame]
:mod:`ScrolledText` --- Scrolled Text Widget
============================================
.. module:: ScrolledText
:platform: Tk
:synopsis: Text widget with a vertical scroll bar.
.. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org>
The :mod:`ScrolledText` module provides a class of the same name which
implements a basic text widget which has a vertical scroll bar configured to do
the "right thing." Using the :class:`~ScrolledText.ScrolledText` class is a lot easier than
setting up a text widget and scroll bar directly. The constructor is the same
as that of the :class:`Tkinter.Text` class.
.. note::
:mod:`ScrolledText` has been renamed to :mod:`tkinter.scrolledtext` in Python
3. The :term:`2to3` tool will automatically adapt imports when converting
your sources to Python 3.
The text widget and scrollbar are packed together in a :class:`Frame`, and the
methods of the :class:`Grid` and :class:`Pack` geometry managers are acquired
from the :class:`Frame` object. This allows the :class:`~ScrolledText.ScrolledText` widget to
be used directly to achieve most normal geometry management behavior.
Should more specific control be necessary, the following attributes are
available:
.. attribute:: ScrolledText.frame
The frame which surrounds the text and scroll bar widgets.
.. attribute:: ScrolledText.vbar
The scroll bar widget.