libpanel-applet-dev 3.20.1-1+b2 / usr / share / gir-1.0 / PanelApplet-5.0.gir

<?xml version="1.0"?>
<!-- This file was automatically generated from C sources - DO NOT EDIT!
To affect the contents of this file, edit the original C definitions,
and/or use gtk-doc annotations.  -->
<repository version="1.2"
            xmlns="http://www.gtk.org/introspection/core/1.0"
            xmlns:c="http://www.gtk.org/introspection/c/1.0"
            xmlns:glib="http://www.gtk.org/introspection/glib/1.0">
  <include name="GObject" version="2.0"/>
  <include name="Gtk" version="3.0"/>
  <package name="libpanel-applet"/>
  <namespace name="PanelApplet"
             version="5.0"
             shared-library="libpanel-applet.so.0"
             c:identifier-prefixes="Panel"
             c:symbol-prefixes="panel">
    <constant name="APPLET_FLAGS_ALL"
              value="0"
              c:type="PANEL_APPLET_FLAGS_ALL">
      <doc xml:space="preserve">A convenience macro that combines #PANEL_APPLET_EXPAND_MAJOR, #PANEL_APPLET_EXPAND_MINOR and
    #PANEL_APPLET_HAS_HANDLE from #PanelAppletFlags</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <class name="Applet"
           c:symbol-prefix="applet"
           c:type="PanelApplet"
           parent="Gtk.EventBox"
           glib:type-name="PanelApplet"
           glib:get-type="panel_applet_get_type"
           glib:type-struct="AppletClass">
      <doc xml:space="preserve">#PanelApplet is an opaque data structure and can only be accessed using
the following functions.</doc>
      <implements name="Atk.ImplementorIface"/>
      <implements name="Gtk.Buildable"/>
      <function name="factory_main" c:identifier="panel_applet_factory_main">
        <doc xml:space="preserve">Creates the applet factory for @factory_id, so that the factory can create
instances of the applet types it is associated with.

Applet instances created by the applet factory will use @applet_type as
GType. Unless you subclass #PanelApplet, you should use %PANEL_TYPE_APPLET
as @applet_type.

On creation of the applet instances, @callback is called to setup the
applet. If @callback returns %FALSE, the creation of the applet instance is
cancelled.

If using C, it is recommended to use #PANEL_APPLET_OUT_PROCESS_FACTORY
instead as it will create a main() function for you.

It can only be used once, and is incompatible with the use of
%PANEL_APPLET_IN_PROCESS_FACTORY and %PANEL_APPLET_OUT_PROCESS_FACTORY.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">0 on success, 1 if there is an error.</doc>
          <type name="gint" c:type="int"/>
        </return-value>
        <parameters>
          <parameter name="factory_id" transfer-ownership="none">
            <doc xml:space="preserve">identifier of an applet factory.</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="applet_type" transfer-ownership="none">
            <doc xml:space="preserve">GType of the applet this factory creates.</doc>
            <type name="GType" c:type="GType"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     scope="call"
                     closure="3">
            <doc xml:space="preserve">callback to be called when a new applet is created.</doc>
            <type name="AppletFactoryCallback"
                  c:type="PanelAppletFactoryCallback"/>
          </parameter>
          <parameter name="data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">callback data.</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </function>
      <function name="factory_setup_in_process"
                c:identifier="panel_applet_factory_setup_in_process"
                introspectable="0">
        <doc xml:space="preserve">Creates the applet factory for @factory_id, so that the factory can create
instances of the applet types it is associated with.

Applet instances created by the applet factory will use @applet_type as
GType. Unless you subclass #PanelApplet, you should use %PANEL_TYPE_APPLET
as @applet_type.

On creation of the applet instances, @callback is called to setup the
applet. If @callback returns %FALSE, the creation of the applet instance is
cancelled.

It can only be used once, and is incompatible with the use of
%PANEL_APPLET_IN_PROCESS_FACTORY and %PANEL_APPLET_OUT_PROCESS_FACTORY.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">0 on success, 1 if there is an error.</doc>
          <type name="gint" c:type="int"/>
        </return-value>
        <parameters>
          <parameter name="factory_id" transfer-ownership="none">
            <doc xml:space="preserve">identifier of an applet factory.</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="applet_type" transfer-ownership="none">
            <doc xml:space="preserve">GType of the applet this factory creates.</doc>
            <type name="GType" c:type="GType"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     scope="call"
                     closure="3">
            <doc xml:space="preserve">callback to be called when a new applet is created.</doc>
            <type name="AppletFactoryCallback"
                  c:type="PanelAppletFactoryCallback"/>
          </parameter>
          <parameter name="data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">callback data.</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </function>
      <virtual-method name="change_background">
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="applet" transfer-ownership="none">
            <type name="Applet" c:type="PanelApplet*"/>
          </instance-parameter>
          <parameter name="pattern" transfer-ownership="none">
            <type name="cairo.Pattern" c:type="cairo_pattern_t*"/>
          </parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="change_orient">
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="applet" transfer-ownership="none">
            <type name="Applet" c:type="PanelApplet*"/>
          </instance-parameter>
          <parameter name="orient" transfer-ownership="none">
            <type name="AppletOrient" c:type="PanelAppletOrient"/>
          </parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="move_focus_out_of_applet">
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="frame" transfer-ownership="none">
            <type name="Applet" c:type="PanelApplet*"/>
          </instance-parameter>
          <parameter name="direction" transfer-ownership="none">
            <type name="Gtk.DirectionType" c:type="GtkDirectionType"/>
          </parameter>
        </parameters>
      </virtual-method>
      <method name="get_background" c:identifier="panel_applet_get_background">
        <doc xml:space="preserve">Gets the background pattern for @applet, or %NULL if there is none.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #cairo_pattern_t to use as background for
@applet.</doc>
          <type name="cairo.Pattern" c:type="cairo_pattern_t*"/>
        </return-value>
        <parameters>
          <instance-parameter name="applet" transfer-ownership="none">
            <doc xml:space="preserve">a #PanelApplet.</doc>
            <type name="Applet" c:type="PanelApplet*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_flags" c:identifier="panel_applet_get_flags">
        <doc xml:space="preserve">Gets the #PanelAppletFlags of @applet.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the #PanelAppletFlags of @applet.</doc>
          <type name="AppletFlags" c:type="PanelAppletFlags"/>
        </return-value>
        <parameters>
          <instance-parameter name="applet" transfer-ownership="none">
            <doc xml:space="preserve">a #PanelApplet.</doc>
            <type name="Applet" c:type="PanelApplet*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_gtk_orientation"
              c:identifier="panel_applet_get_gtk_orientation"
              version="3.18">
        <doc xml:space="preserve">Gets the #GtkOrientation of @applet.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the #GtkOrientation of @applet.</doc>
          <type name="Gtk.Orientation" c:type="GtkOrientation"/>
        </return-value>
        <parameters>
          <instance-parameter name="applet" transfer-ownership="none">
            <doc xml:space="preserve">a #PanelApplet</doc>
            <type name="Applet" c:type="PanelApplet*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_locked_down"
              c:identifier="panel_applet_get_locked_down">
        <doc xml:space="preserve">Gets whether the panel @applet is on is locked down or not. A locked down
applet should not allow any change to its configuration.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the panel @applet is on is locked down, %FALSE otherwise.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="applet" transfer-ownership="none">
            <doc xml:space="preserve">a #PanelApplet.</doc>
            <type name="Applet" c:type="PanelApplet*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_orient" c:identifier="panel_applet_get_orient">
        <doc xml:space="preserve">Gets the #PanelAppletOrient of @applet.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the #PanelAppletOrient of @applet.</doc>
          <type name="AppletOrient" c:type="PanelAppletOrient"/>
        </return-value>
        <parameters>
          <instance-parameter name="applet" transfer-ownership="none">
            <doc xml:space="preserve">a #PanelApplet.</doc>
            <type name="Applet" c:type="PanelApplet*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="request_focus" c:identifier="panel_applet_request_focus">
        <doc xml:space="preserve">Requests focus for @applet. There is no guarantee that @applet will
successfully get focus after that call.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="applet" transfer-ownership="none">
            <doc xml:space="preserve">a #PanelApplet.</doc>
            <type name="Applet" c:type="PanelApplet*"/>
          </instance-parameter>
          <parameter name="timestamp" transfer-ownership="none">
            <doc xml:space="preserve">the timestamp of the user interaction (typically a button or key
press event) which triggered this call.</doc>
            <type name="guint32" c:type="guint32"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_background_widget"
              c:identifier="panel_applet_set_background_widget"
              deprecated="1"
              deprecated-version="3.20">
        <doc xml:space="preserve">Configure #PanelApplet to automatically draw the background of the applet on
@widget. It is generally enough to call this function with @applet as
@widget.</doc>
        <doc-deprecated xml:space="preserve">Do not use this API. Since 3.20 this function does nothing.</doc-deprecated>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="applet" transfer-ownership="none">
            <doc xml:space="preserve">a #PanelApplet.</doc>
            <type name="Applet" c:type="PanelApplet*"/>
          </instance-parameter>
          <parameter name="widget" transfer-ownership="none">
            <doc xml:space="preserve">a #GtkWidget.</doc>
            <type name="Gtk.Widget" c:type="GtkWidget*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_flags" c:identifier="panel_applet_set_flags">
        <doc xml:space="preserve">Sets the #PanelAppletFlags of @applet. Most of the time, at least
%PANEL_APPLET_EXPAND_MINOR should be used.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="applet" transfer-ownership="none">
            <doc xml:space="preserve">a #PanelApplet.</doc>
            <type name="Applet" c:type="PanelApplet*"/>
          </instance-parameter>
          <parameter name="flags" transfer-ownership="none">
            <doc xml:space="preserve">#PanelAppletFlags to use for @applet.</doc>
            <type name="AppletFlags" c:type="PanelAppletFlags"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_size_hints" c:identifier="panel_applet_set_size_hints">
        <doc xml:space="preserve">Give hints to the panel about sizes @applet is comfortable with. This is
generally useful for applets that can take a lot of space, in case the panel
gets full and needs to restrict the size of some applets.

@size_hints should have an even number of sizes. It is an array of (max,
min) pairs where min(i) &gt; max(i + 1).

@base_size will be added to all sizes in @size_hints, and is therefore a way
to guarantee a minimum size to @applet.

The panel will try to allocate a size that is acceptable to @applet, i.e. in
one of the (@base_size + max, @base_size + min) ranges.

%PANEL_APPLET_EXPAND_MAJOR must be set for @applet to use size hints.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="applet" transfer-ownership="none">
            <doc xml:space="preserve">a #PanelApplet.</doc>
            <type name="Applet" c:type="PanelApplet*"/>
          </instance-parameter>
          <parameter name="size_hints" transfer-ownership="none">
            <doc xml:space="preserve">array of sizes.</doc>
            <type name="gint" c:type="const int*"/>
          </parameter>
          <parameter name="n_elements" transfer-ownership="none">
            <doc xml:space="preserve">length of @size_hints.</doc>
            <type name="gint" c:type="int"/>
          </parameter>
          <parameter name="base_size" transfer-ownership="none">
            <doc xml:space="preserve">base size of the applet.</doc>
            <type name="gint" c:type="int"/>
          </parameter>
        </parameters>
      </method>
      <method name="settings_new" c:identifier="panel_applet_settings_new">
        <doc xml:space="preserve">Creates a new #GSettings object for the per-instance settings of @applet,
with a given schema.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GSettings object for the per-instance settings of @applet.</doc>
          <type name="Gio.Settings" c:type="GSettings*"/>
        </return-value>
        <parameters>
          <instance-parameter name="applet" transfer-ownership="none">
            <doc xml:space="preserve">a #PanelApplet.</doc>
            <type name="Applet" c:type="PanelApplet*"/>
          </instance-parameter>
          <parameter name="schema" transfer-ownership="none">
            <doc xml:space="preserve">the name of the schema.</doc>
            <type name="utf8" c:type="const char*"/>
          </parameter>
        </parameters>
      </method>
      <method name="setup_menu" c:identifier="panel_applet_setup_menu">
        <doc xml:space="preserve">Sets up the context menu of @applet. @xml is a #GtkUIManager UI definition,
describing how to display the menu items. @action_group contains the
various #GSimpleAction that are referenced in @xml.

See also the &lt;link linkend="getting-started.context-menu"&gt;Context
Menu&lt;/link&gt; section.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="applet" transfer-ownership="none">
            <doc xml:space="preserve">a #PanelApplet.</doc>
            <type name="Applet" c:type="PanelApplet*"/>
          </instance-parameter>
          <parameter name="xml" transfer-ownership="none">
            <doc xml:space="preserve">a menu XML string.</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="action_group" transfer-ownership="none">
            <doc xml:space="preserve">a #GSimpleActionGroup.</doc>
            <type name="Gio.SimpleActionGroup" c:type="GSimpleActionGroup*"/>
          </parameter>
          <parameter name="translation_domain" transfer-ownership="none">
            <doc xml:space="preserve">gettext translation domain</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="setup_menu_from_file"
              c:identifier="panel_applet_setup_menu_from_file">
        <doc xml:space="preserve">Sets up the context menu of @applet. @filename is the path to a menu XML
file, containing a #GtkUIManager UI definition that describes how to display
the menu items. @action_group contains the various #GSimpleAction that
are referenced in @xml.

See also the &lt;link linkend="getting-started.context-menu"&gt;Context
Menu&lt;/link&gt; section.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="applet" transfer-ownership="none">
            <doc xml:space="preserve">a #PanelApplet.</doc>
            <type name="Applet" c:type="PanelApplet*"/>
          </instance-parameter>
          <parameter name="filename" transfer-ownership="none">
            <doc xml:space="preserve">path to a menu XML file.</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="action_group" transfer-ownership="none">
            <doc xml:space="preserve">a #GSimpleActionGroup.</doc>
            <type name="Gio.SimpleActionGroup" c:type="GSimpleActionGroup*"/>
          </parameter>
          <parameter name="translation_domain" transfer-ownership="none">
            <doc xml:space="preserve">gettext translation domain</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="setup_menu_from_resource"
              c:identifier="panel_applet_setup_menu_from_resource"
              version="3.4">
        <doc xml:space="preserve">Sets up the context menu of @applet. @filename is a resource path to a menu
XML file, containing a #GtkUIManager UI definition that describes how to
display the menu items. @action_group contains the various #GSimpleAction that
are referenced in @xml.

See also the &lt;link linkend="getting-started.context-menu"&gt;Context
Menu&lt;/link&gt; section.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="applet" transfer-ownership="none">
            <doc xml:space="preserve">a #PanelApplet.</doc>
            <type name="Applet" c:type="PanelApplet*"/>
          </instance-parameter>
          <parameter name="resource_path" transfer-ownership="none">
            <doc xml:space="preserve">a resource path</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="action_group" transfer-ownership="none">
            <doc xml:space="preserve">a #GSimpleActionGroup.</doc>
            <type name="Gio.SimpleActionGroup" c:type="GSimpleActionGroup*"/>
          </parameter>
          <parameter name="translation_domain" transfer-ownership="none">
            <doc xml:space="preserve">gettext translation domain</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="background"
                introspectable="0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Implementation detail.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="closure"
                introspectable="0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Implementation detail.</doc>
        <type name="gpointer" c:type="gpointer"/>
      </property>
      <property name="connection"
                introspectable="0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Implementation detail.</doc>
        <type name="Gio.DBusConnection"/>
      </property>
      <property name="flags" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">The #PanelAppletFlags of the applet.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="id"
                introspectable="0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Implementation detail.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="locked-down" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">Whether the panel the applet is on is locked down.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="orient" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">The #PanelAppletOrient of the applet.

This property gets set when the applet gets embedded, and can change
when the panel position changes.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="out-of-process"
                introspectable="0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Implementation detail.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="settings-path" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">The GSettings path to the per-instance settings of the applet.

This property gets set when the applet gets embedded.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="size-hints" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">The size hints set for the applet. See panel_applet_set_size_hints().</doc>
        <type name="gpointer" c:type="gpointer"/>
      </property>
      <field name="event_box">
        <type name="Gtk.EventBox" c:type="GtkEventBox"/>
      </field>
      <field name="priv" readable="0" private="1">
        <type name="AppletPrivate" c:type="PanelAppletPrivate*"/>
      </field>
      <glib:signal name="change-background" when="last">
        <doc xml:space="preserve">Emitted when the background of @applet has changed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="pattern" transfer-ownership="none">
            <doc xml:space="preserve">the new background pattern for @applet, or %NULL if there is none.</doc>
            <type name="cairo.Pattern"/>
          </parameter>
        </parameters>
      </glib:signal>
      <glib:signal name="change-orient" when="last">
        <doc xml:space="preserve">Emitted when the #PanelAppletOrient of @applet has changed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="orient" transfer-ownership="none">
            <doc xml:space="preserve">the new #PanelAppletOrient of @applet.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </glib:signal>
      <glib:signal name="move-focus-out-of-applet"
                   when="last"
                   action="1"
                   introspectable="0">
        <doc xml:space="preserve">Emitted when the focus is moved out of @applet. This is an
implementation detail.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="direction" transfer-ownership="none">
            <doc xml:space="preserve">the move direction.</doc>
            <type name="Gtk.DirectionType"/>
          </parameter>
        </parameters>
      </glib:signal>
    </class>
    <record name="AppletClass"
            c:type="PanelAppletClass"
            glib:is-gtype-struct-for="Applet">
      <doc xml:space="preserve">The class structure for the #PanelApplet class.</doc>
      <field name="event_box_class">
        <doc xml:space="preserve">The parent class.</doc>
        <type name="Gtk.EventBoxClass" c:type="GtkEventBoxClass"/>
      </field>
      <field name="change_orient">
        <callback name="change_orient">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
          <parameters>
            <parameter name="applet" transfer-ownership="none">
              <type name="Applet" c:type="PanelApplet*"/>
            </parameter>
            <parameter name="orient" transfer-ownership="none">
              <type name="AppletOrient" c:type="PanelAppletOrient"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="change_background">
        <callback name="change_background">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
          <parameters>
            <parameter name="applet" transfer-ownership="none">
              <type name="Applet" c:type="PanelApplet*"/>
            </parameter>
            <parameter name="pattern" transfer-ownership="none">
              <type name="cairo.Pattern" c:type="cairo_pattern_t*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="move_focus_out_of_applet">
        <callback name="move_focus_out_of_applet">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
          <parameters>
            <parameter name="frame" transfer-ownership="none">
              <type name="Applet" c:type="PanelApplet*"/>
            </parameter>
            <parameter name="direction" transfer-ownership="none">
              <type name="Gtk.DirectionType" c:type="GtkDirectionType"/>
            </parameter>
          </parameters>
        </callback>
      </field>
    </record>
    <callback name="AppletFactoryCallback" c:type="PanelAppletFactoryCallback">
      <doc xml:space="preserve">The type used for callbacks after. The callback will usually check that @iid
is a valid applet type identifier for the applet factory, and will then fill
@applet with widgets, connect to signals, etc.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">%TRUE if @iid is a valid applet type identifier for the applet
factory and if the creation of @applet was successfully completed, %FALSE
otherwise.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="applet" transfer-ownership="none">
          <doc xml:space="preserve">a newly-created #PanelApplet.</doc>
          <type name="Applet" c:type="PanelApplet*"/>
        </parameter>
        <parameter name="iid" transfer-ownership="none">
          <doc xml:space="preserve">identifier of the requested applet type.</doc>
          <type name="utf8" c:type="const gchar*"/>
        </parameter>
        <parameter name="user_data"
                   transfer-ownership="none"
                   nullable="1"
                   allow-none="1"
                   closure="2">
          <doc xml:space="preserve">user data.</doc>
          <type name="gpointer" c:type="gpointer"/>
        </parameter>
      </parameters>
    </callback>
    <bitfield name="AppletFlags"
              glib:type-name="PanelAppletFlags"
              glib:get-type="panel_applet_flags_get_type"
              c:type="PanelAppletFlags">
      <doc xml:space="preserve">Flags to be used with panel_applet_get_flags()/panel_applet_set_flags(), to
indicate to the panel a specific behavior requested by the #PanelApplet.</doc>
      <member name="flags_none"
              value="0"
              c:identifier="PANEL_APPLET_FLAGS_NONE"
              glib:nick="flags-none">
        <doc xml:space="preserve">No flags set.</doc>
      </member>
      <member name="expand_major"
              value="1"
              c:identifier="PANEL_APPLET_EXPAND_MAJOR"
              glib:nick="expand-major">
        <doc xml:space="preserve">On horizontal panels, the #PanelApplet will be
allocated as much width as possible. On vertical panels, it will be
allocated as much height as possible.</doc>
      </member>
      <member name="expand_minor"
              value="2"
              c:identifier="PANEL_APPLET_EXPAND_MINOR"
              glib:nick="expand-minor">
        <doc xml:space="preserve">On horizontal panels, the #PanelApplet will be
allocated the full height of the panel. On vertical panels, it will be
allocated the full width. Most applets should set this flag in order to use
the full panel size and allow the applet to be Fitt's Law compliant.</doc>
      </member>
      <member name="has_handle"
              value="4"
              c:identifier="PANEL_APPLET_HAS_HANDLE"
              glib:nick="has-handle">
        <doc xml:space="preserve">The panel will draw a handle for the
#PanelApplet. This handle will be usable to move the applet, and to open the
context menu of the applet.</doc>
      </member>
    </bitfield>
    <enumeration name="AppletOrient"
                 glib:type-name="PanelAppletOrient"
                 glib:get-type="panel_applet_orient_get_type"
                 c:type="PanelAppletOrient">
      <doc xml:space="preserve">Type defining the orientation of the applet. The values may seem backward
(e.g. %PANEL_APPLET_ORIENT_RIGHT means the panel is on the left side), but
this represents the direction the applet is oriented to.</doc>
      <member name="up"
              value="0"
              c:identifier="PANEL_APPLET_ORIENT_UP"
              glib:nick="up">
        <doc xml:space="preserve">The #PanelApplet is on a horizontal panel, at the
bottom of the screen. It is oriented towards the top of the screen.</doc>
      </member>
      <member name="down"
              value="1"
              c:identifier="PANEL_APPLET_ORIENT_DOWN"
              glib:nick="down">
        <doc xml:space="preserve">The #PanelApplet is on a horizontal panel, at the
top of the screen. It is oriented towards the bottom of the screen.</doc>
      </member>
      <member name="left"
              value="2"
              c:identifier="PANEL_APPLET_ORIENT_LEFT"
              glib:nick="left">
        <doc xml:space="preserve">The #PanelApplet is on a vertical panel, at the
right of the screen. It is oriented towards the left of the screen.</doc>
      </member>
      <member name="right"
              value="3"
              c:identifier="PANEL_APPLET_ORIENT_RIGHT"
              glib:nick="right">
        <doc xml:space="preserve">The #PanelApplet is on a vertical panel, at the
left of the screen. It is oriented towards the right of the screen.</doc>
      </member>
    </enumeration>
    <record name="AppletPrivate" c:type="PanelAppletPrivate" disguised="1">
    </record>
  </namespace>
</repository>