<!-- ##### SECTION Title ##### -->
PanelApplet

<!-- ##### SECTION Short_Description ##### -->
The PanelApplet object.

<!-- ##### SECTION Long_Description ##### -->
<para>
The #PanelApplet object is an object which encapsulates an applet. It
is a #GtkContainer which may contain a single widget. This widget, in
turn, should contain all widgets exposed by the applet.
</para>

<para>
A #PanelApplet is associated with a #BonoboControl. The control makes
the cross process UI emmbedding required by applets possible.
</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### STRUCT PanelApplet ##### -->
<para>
The #PanelApplet struct contains private data only.
</para>


<!-- ##### TYPEDEF PanelAppletOrient ##### -->
<para>
The #PanelAppletOrient type specifies the orientation of a panel. 

</para>


<!-- ##### MACRO PANEL_APPLET_ORIENT_UP ##### -->
<para>
A panel at the top of the screen.
</para>



<!-- ##### MACRO PANEL_APPLET_ORIENT_DOWN ##### -->
<para>
A panel at the bottom of the screen.
</para>



<!-- ##### MACRO PANEL_APPLET_ORIENT_LEFT ##### -->
<para>
A panel at the left-hand side of the screen.
</para>



<!-- ##### MACRO PANEL_APPLET_ORIENT_RIGHT ##### -->
<para>
A panel at the right-hand side of the screen.
</para>



<!-- ##### ENUM PanelAppletBackgroundType ##### -->
<para>
The #PanelAppletOrient enumerated type specifies the type of background
of a panel.

</para>

@PANEL_NO_BACKGROUND: The panel has no backround, the default is used.
@PANEL_COLOR_BACKGROUND: The panel has a color, i.e rgb value,
background.
@PANEL_PIXMAP_BACKGROUND: 

<!-- ##### FUNCTION panel_applet_new ##### -->
<para>

</para>

@Returns: 
<!-- # Unused Parameters # -->
@widget: 


<!-- ##### FUNCTION panel_applet_get_size ##### -->
<para>

</para>

@applet: 
@Returns: 


<!-- ##### FUNCTION panel_applet_get_orient ##### -->
<para>

</para>

@applet: 
@Returns: 


<!-- ##### FUNCTION panel_applet_get_control ##### -->
<para>

</para>

@applet: 
@Returns: 


<!-- ##### FUNCTION panel_applet_get_popup_component ##### -->
<para>

</para>

@applet: 
@Returns: 


<!-- ##### FUNCTION panel_applet_setup_menu ##### -->
<para>

</para>

@applet: 
@xml: 
@verb_list: 
@user_data: 


<!-- ##### FUNCTION panel_applet_setup_menu_from_file ##### -->
<para>

</para>

@applet: 
@opt_datadir: 
@file: 
@opt_app_name: 
@verb_list: 
@user_data: 


<!-- ##### FUNCTION panel_applet_factory_main ##### -->
<para>

</para>

@iid: 
@applet_type: 
@callback: 
@data: 
@Returns: 
<!-- # Unused Parameters # -->
@argc: 
@argv: 
@name: 
@version: 


<!-- ##### MACRO PANEL_APPLET_BONOBO_FACTORY ##### -->
<para>
Defines a 'main' routine for the applet factory.
</para>

@iid: The bonobo-activation iid of the factory.
@type: 
@name: The applet ID string.
@version: The applet version string.
@callback: The factory callback.
@data: he factory user data pointer.


<!-- ##### SIGNAL PanelApplet::change-background ##### -->
<para>
Emitted when the background of the panel changes. Use @type to
determine which, if any, of @color and @pimxap is valid.
</para>

@panelapplet: The object which received the signal.
@arg1: 
@arg2: 
@arg3: 
<!-- # Unused Parameters # -->
@type: The #PanelAppletBackgroundType.
@color: The #GdkColor if @type is #PANEL_COLOR_BACKGROUND.
@pixmap: The pixmap file name if @type is #PANEL_PIXMAP_BACKGROUND

<!-- ##### SIGNAL PanelApplet::change-orient ##### -->
<para>
Emitted when the orientation of the panel changes.
</para>

@panelapplet: The object which received the signal.
@arg1: 
<!-- # Unused Parameters # -->
@orient: The new #PanelAppletOrient of the applet.

<!-- ##### SIGNAL PanelApplet::change-size ##### -->
<para>
Emitted when the size of the panel changes.
</para>

<para>
Note: this is different for size negotiation which is handled by
size_request() and size_allocate() as usual. This signal should
be used to determine what font size or widget layout to use 
depending on the size of the panel.
</para>

@panelapplet: The object which received the signal.
@arg1: 
<!-- # Unused Parameters # -->
@size: The size, in pixels, of the panel.

