~ubuntu-branches/ubuntu/saucy/xfce4-panel/saucy-proposed

« back to all changes in this revision

Viewing changes to docs/references/html/libxfce4panel-GObject-Oriented-Panel-Plugin-Registers-Macros.html

  • Committer: Package Import Robot
  • Author(s): Lionel Le Folgoc
  • Date: 2013-07-07 10:54:09 UTC
  • mfrom: (4.2.15 sid)
  • Revision ID: package-import@ubuntu.com-20130707105409-nam2sh68h1reuiv4
Tags: 4.10.1-1ubuntu1
* Merge from Debian unstable, remaining Ubuntu changes:
  - debian/patches:
    + xubuntu_migrate-tasklist-separator.patch: added, try to be smart and
      work around the non-expandable tasklist plugin from 4.10 by setting
      as expandable the separator next to it (should work with the default
      panel layouts from Xubuntu, Mythbuntu and UbuntuStudio).
    + xubuntu_add-calendar-popup-to-clock-plugin.patch: added, taken from
      upstream git to show a calendar when left-clicking on the clock plugin
      (so we don't need orage/xfce4-datetime-plugin for this feature only).

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>GObject Oriented Panel Plugin Registers Macros</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7
7
<link rel="home" href="index.html" title="Libxfce4panel Reference Manual">
8
8
<link rel="up" href="libxfce4panel-plugins.html" title="Part II. Panel Plugins">
9
9
<link rel="prev" href="libxfce4panel-Panel-Plugin-Register-Macros-(4.6-Style).html" title="Panel Plugin Register Macros (4.6 Style)">
78
78
Define a new (resident) GObject panel plugin, the parent type of the object
79
79
should be XFCE_TYPE_PANEL_PLUGIN.
80
80
</p>
81
 
<div class="variablelist"><table border="0">
 
81
<div class="variablelist"><table border="0" class="variablelist">
 
82
<colgroup>
82
83
<col align="left" valign="top">
 
84
<col>
 
85
</colgroup>
83
86
<tbody>
84
87
<tr>
85
88
<td><p><span class="term"><em class="parameter"><code>TypeName</code></em> :</span></p></td>
108
111
a resident plugin will never be unloaded after the first load, avoiding
109
112
those issues.
110
113
</p>
111
 
<div class="variablelist"><table border="0">
 
114
<div class="variablelist"><table border="0" class="variablelist">
 
115
<colgroup>
112
116
<col align="left" valign="top">
 
117
<col>
 
118
</colgroup>
113
119
<tbody>
114
120
<tr>
115
121
<td><p><span class="term"><em class="parameter"><code>TypeName</code></em> :</span></p></td>
143
149
The _register_type function should be added to the args in
144
150
<a class="link" href="libxfce4panel-GObject-Oriented-Panel-Plugin-Registers-Macros.html#XFCE-PANEL-DEFINE-PLUGIN:CAPS" title="XFCE_PANEL_DEFINE_PLUGIN()"><span class="type">XFCE_PANEL_DEFINE_PLUGIN</span></a>.
145
151
</p>
146
 
<div class="variablelist"><table border="0">
 
152
<div class="variablelist"><table border="0" class="variablelist">
 
153
<colgroup>
147
154
<col align="left" valign="top">
 
155
<col>
 
156
</colgroup>
148
157
<tbody>
149
158
<tr>
150
159
<td><p><span class="term"><em class="parameter"><code>TypeName</code></em> :</span></p></td>
168
177
<pre class="programlisting">#define             XFCE_PANEL_DEFINE_PREINIT_FUNC(preinit_func)</pre>
169
178
<p>
170
179
Registers a pre-init function in the plugin module. This function
171
 
is called before <a href="http://library.gnome.org/devel/gtk3/gtk-General.html#gtk-init"><code class="function">gtk_init()</code></a> and can be used to initialize
 
180
is called before <a href="http://developer.gnome.org/gtk2/gtk3-General.html#gtk-init"><code class="function">gtk_init()</code></a> and can be used to initialize
172
181
special libaries.
173
182
Downside of this that the plugin cannot run internal. Even if you
174
183
set X-XFCE-Interal=TRUE in the desktop file, the panel will force
175
184
the plugin to run inside a wrapper (this because the panel called
176
 
<a href="http://library.gnome.org/devel/gtk3/gtk-General.html#gtk-init"><code class="function">gtk_init()</code></a> long before it starts to load the plugins).
 
185
<a href="http://developer.gnome.org/gtk2/gtk3-General.html#gtk-init"><code class="function">gtk_init()</code></a> long before it starts to load the plugins).
177
186
</p>
178
187
<p>
179
188
Note that you can only use this once and it only works in
180
189
combination with the plugins register/define functions added
181
190
in 4.8.
182
191
</p>
183
 
<div class="variablelist"><table border="0">
 
192
<div class="variablelist"><table border="0" class="variablelist">
 
193
<colgroup>
184
194
<col align="left" valign="top">
 
195
<col>
 
196
</colgroup>
185
197
<tbody><tr>
186
198
<td><p><span class="term"><em class="parameter"><code>preinit_func</code></em> :</span></p></td>
187
199
<td>name of the function that points to an