Expander
========

Expanders allow to dynamically hide or show information within a window or
dialog. An expander can take a single widget that will be displayed when
expanded.

Expanders remain expanded until clicked again. When the state of an expander
is changed, the "activate" signal is emitted.

An expander can be programmatically expanded or collapsed by passing `True` or
`False` to :meth:`Gtk.Expander.set_expanded`. Note that doing so causes the
"activate" signal to be emitted.

More than one widget, such as a :class:`Gtk.Label` and :class:`Gtk.Button`,
can be added by appending them to a :class:`Gtk.Box`.

Example
^^^^^^^

.. image:: ../images/expander_example.png

.. literalinclude:: ../examples/expander_example.py
    :linenos: