Some apps want to embed a very small icon or widget in the panel to
display the status of the app. This can be done without the
operational overhead of an applet. The status docklet will embed a
22 by 22 window inside the panel. This is not a separate applet and
thus is minimally intrusive to the user and is meant for very
temporary status displays for which a full applet would not be
appropriate.
The way StatusDocklet works is a little different from how the
AppletWidget works. Firstly, StatusDocklet object is not a widget,
it is just an abstract GTK+ object. You create a new StatusDocklet
object and then bind
the "build_plug" signal which is emitted when the panel was
contacted and a widget must be built. After binding the
"build_plug" signal, you call run() to actually start
trying to contacting the panel. StatusDocklet is safe to use
without a panel. By default it will try to locate a panel for 15
minutes and after that it will give up. It will also handle panel
restarts by default. If it does, your widget will be destroyed and
"build_plug" will be emitted again when the new panel starts. Even
though the panel will never restart by itself, the user might not
run session management and thus might restart panel by hand, or due
to a bug, the panel might crash and restart itself.
Docklets are not available in GNOME 1.0.
Signals:
build_plug
This signal is emitted when you actually need to build the widget
that you want to place inside the plug in the status docklet. It
should be 22 by 22, and if it is larger it will be cropped.
Gnome.Scores()->set_logo_widget()