Codebase list xapp / e98737a
New upstream version 1.6.2 Norbert Preining 4 years ago
62 changed file(s) with 11291 addition(s) and 85 deletion(s). Raw diff Collapse all Expand all
1414 This project is still relatively new though and we can't yet commit to a stable ABI.
1515
1616 You are welcome to use libxapp or xapps-common in your application, but if you do, please make sure to tell us, so that we can communicate with you going forward about any potential changes.
17
18 # API Reference
19
20 http://developer.linuxmint.com/xapps/reference/index.html
1721
1822 ## XAppMonitorBlanker
1923
0 xapp (1.6.2) tricia; urgency=medium
1
2 [ Eli Schwartz ]
3 * mate applet: fix configuring
4 * mate applet: fix regression in install location
5 * debian: fixup changed file locations
6
7 [ Michael Webster ]
8 * mate-xapp-status-applet.py: handle a null icon name correctly.
9 * test-scripts: have xapp-status-applet sort icons in the same manner the real applets do (symbolic to the right, then by alpha process name).
10 * xapp-status-icon.c: Keep an account of button presses so an orphan release doesn't activate or pop up a menu.
11 * xapp-status-icon: Track and notify changes in types of support for the icon - notify when a status icon is picked up by a native applet, a traditional system tray, or is not being picked up by anything.
12 * xapp-status-icon.c: Replace g_enum_to_string with a custom function, this isn't available with lmde's glib.
13
14 -- Clement Lefebvre <root@linuxmint.com> Fri, 22 Nov 2019 10:36:41 +0000
15
16 xapp (1.6.1) tricia; urgency=medium
17
18 [ Michael Webster ]
19 * xapp-status-icon: Add a function to check for the existence of any active status applets.
20
21 -- Clement Lefebvre <root@linuxmint.com> Wed, 13 Nov 2019 17:33:22 +0100
22
23 xapp (1.6.0) tricia; urgency=medium
24
25 [ Clement Lefebvre ]
26 * Implement XAppStatusIcon (#67)
27
28 [ James Ross ]
29 * libxapp: cleanup compile warnings (#69)
30
31 [ Michael Webster ]
32 * status icons: Add a monitor class for applets - XAppStatusIconMonitor, (#70)
33 * test-scripts: add a status-icon-via-libappindicator script.
34 * xapp-status-icon.c: Remove leftover debug line
35 * xapp-status-icon: When a menu is provided to XAppStatusIcon, handle positioning and showing it internally instead of requiring the application to do it.
36 * xapp-status-icon.c: Use G_ class macros to cleanup header file, fix xapp_status_icon_get_menu() (copy/paste error).
37 * Add some useful build C-flags, fix test script exec bit.
38
39 [ Clement Lefebvre ]
40 * Add API reference in docs/reference/
41 * Set theme jekyll-theme-architect
42 * README: Add link to API reference
43
44 [ Michael Webster ]
45 * xapp-status-icon.c: Emit 'activate' during fallback status icon activation.
46 * docs: Generate html automatically
47
48 [ Stephen Collins ]
49 * xapp-icon-chooser-dialog.c: Remove unused variable
50 * icon chooser dialog: add default_icon property
51 * icon chooser dialog: add *_add_custom_category () function
52
53 [ Michael Webster ]
54 * Add a Mate status applet (#72)
55 * xapp-status-icon.c: Refactor event handling.
56
57 [ Stephen Collins ]
58 * xapp-icon-chooser-dialog.c: prevent segfault on non-existent icon name (#76)
59
60 [ Clement Lefebvre ]
61 * IconChooserButton: Add the ability to set the default category (#77)
62
63 [ Stephen Collins ]
64 * xapp-icon-chooser-button.c: add missing dispose method (#78)
65
66 [ Michael Webster ]
67 * mate-xapp-status-applet.py: Make improvements to event handling and widget appearance during clicks.
68 * Add a custom install script for installing the generated header file.
69 * Add i18n for the mate applet.
70 * mate applet: Add an about window, use more appropriate install locations, move build replacement strings to a separate imported file.
71 * xapp-status-icon.c: During async ops, when checking for cancellation, use the error code, as the cancellable may have reset in the interim, but the code will be correct.
72
73 [ Michael Webster ]
74 * status icons: Support multiple icons from the same process.
75
76 [ Clement Lefebvre ]
77 * Revert "docs: Generate html automatically"
78 * Add a makedoc script to update docs/reference
79 * Update reference docs
80
81 [ Stephen Collins ]
82 * xapp-icon-chooser-dialog.c: color the symbolic icons properly and fix hidpi (#79)
83
84 [ Clement Lefebvre ]
85 * l10n: Update POT
86
87 -- Clement Lefebvre <root@linuxmint.com> Tue, 12 Nov 2019 11:12:12 +0100
88
089 xapp (1.4.9) tina; urgency=medium
190
291 [ Michael Webster ]
11 usr/bin/
22 usr/share/icons
33 usr/share/locale
4 usr/libexec/xapps
5 usr/share/mate-panel/applets
6 usr/share/dbus-1/services
0 theme: jekyll-theme-architect
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>XAppGtkWindow: XApp Reference Manual</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
6 <link rel="home" href="index.html" title="XApp Reference Manual">
7 <link rel="up" href="ch01.html" title="API reference">
8 <link rel="prev" href="ch01.html" title="API reference">
9 <link rel="next" href="XAppIconChooserButton.html" title="XAppIconChooserButton">
10 <meta name="generator" content="GTK-Doc V1.27 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 </head>
13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
15 <td width="100%" align="left" class="shortcuts">
16 <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
17 <a href="#XAppGtkWindow.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
18 <a href="#XAppGtkWindow.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces">  <span class="dim">|</span> 
19 <a href="#XAppGtkWindow.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span>
20 </td>
21 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
22 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
23 <td><a accesskey="p" href="ch01.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
24 <td><a accesskey="n" href="XAppIconChooserButton.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
25 </tr></table>
26 <div class="refentry">
27 <a name="XAppGtkWindow"></a><div class="titlepage"></div>
28 <div class="refnamediv"><table width="100%"><tr>
29 <td valign="top">
30 <h2><span class="refentrytitle"><a name="XAppGtkWindow.top_of_page"></a>XAppGtkWindow</span></h2>
31 <p>XAppGtkWindow — A subclass of <a href="../gtk3/GtkWindow.html#GtkWindow-struct"><code class="literal">GtkWindow</code></a> that allows additional
32 communication with the window manager.</p>
33 </td>
34 <td class="gallery_image" valign="top" align="right"></td>
35 </tr></table></div>
36 <div class="refsect1">
37 <a name="XAppGtkWindow.functions"></a><h2>Functions</h2>
38 <div class="informaltable"><table class="informaltable" width="100%" border="0">
39 <colgroup>
40 <col width="150px" class="functions_return">
41 <col class="functions_name">
42 </colgroup>
43 <tbody>
44 <tr>
45 <td class="function_type">
46 <a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
47 </td>
48 <td class="function_name">
49 <a class="link" href="XAppGtkWindow.html#xapp-gtk-window-new" title="xapp_gtk_window_new ()">xapp_gtk_window_new</a> <span class="c_punctuation">()</span>
50 </td>
51 </tr>
52 <tr>
53 <td class="function_type">
54 <span class="returnvalue">void</span>
55 </td>
56 <td class="function_name">
57 <a class="link" href="XAppGtkWindow.html#xapp-gtk-window-set-icon-name" title="xapp_gtk_window_set_icon_name ()">xapp_gtk_window_set_icon_name</a> <span class="c_punctuation">()</span>
58 </td>
59 </tr>
60 <tr>
61 <td class="function_type">
62 <span class="returnvalue">void</span>
63 </td>
64 <td class="function_name">
65 <a class="link" href="XAppGtkWindow.html#xapp-gtk-window-set-icon-from-file" title="xapp_gtk_window_set_icon_from_file ()">xapp_gtk_window_set_icon_from_file</a> <span class="c_punctuation">()</span>
66 </td>
67 </tr>
68 <tr>
69 <td class="function_type">
70 <span class="returnvalue">void</span>
71 </td>
72 <td class="function_name">
73 <a class="link" href="XAppGtkWindow.html#xapp-gtk-window-set-progress" title="xapp_gtk_window_set_progress ()">xapp_gtk_window_set_progress</a> <span class="c_punctuation">()</span>
74 </td>
75 </tr>
76 <tr>
77 <td class="function_type">
78 <span class="returnvalue">void</span>
79 </td>
80 <td class="function_name">
81 <a class="link" href="XAppGtkWindow.html#xapp-gtk-window-set-progress-pulse" title="xapp_gtk_window_set_progress_pulse ()">xapp_gtk_window_set_progress_pulse</a> <span class="c_punctuation">()</span>
82 </td>
83 </tr>
84 <tr>
85 <td class="function_type">
86 <span class="returnvalue">void</span>
87 </td>
88 <td class="function_name">
89 <a class="link" href="XAppGtkWindow.html#xapp-set-window-icon-name" title="xapp_set_window_icon_name ()">xapp_set_window_icon_name</a> <span class="c_punctuation">()</span>
90 </td>
91 </tr>
92 <tr>
93 <td class="function_type">
94 <span class="returnvalue">void</span>
95 </td>
96 <td class="function_name">
97 <a class="link" href="XAppGtkWindow.html#xapp-set-window-icon-from-file" title="xapp_set_window_icon_from_file ()">xapp_set_window_icon_from_file</a> <span class="c_punctuation">()</span>
98 </td>
99 </tr>
100 <tr>
101 <td class="function_type">
102 <span class="returnvalue">void</span>
103 </td>
104 <td class="function_name">
105 <a class="link" href="XAppGtkWindow.html#xapp-set-window-progress" title="xapp_set_window_progress ()">xapp_set_window_progress</a> <span class="c_punctuation">()</span>
106 </td>
107 </tr>
108 <tr>
109 <td class="function_type">
110 <span class="returnvalue">void</span>
111 </td>
112 <td class="function_name">
113 <a class="link" href="XAppGtkWindow.html#xapp-set-window-progress-pulse" title="xapp_set_window_progress_pulse ()">xapp_set_window_progress_pulse</a> <span class="c_punctuation">()</span>
114 </td>
115 </tr>
116 <tr>
117 <td class="function_type">
118 <span class="returnvalue">void</span>
119 </td>
120 <td class="function_name">
121 <a class="link" href="XAppGtkWindow.html#xapp-set-xid-icon-name" title="xapp_set_xid_icon_name ()">xapp_set_xid_icon_name</a> <span class="c_punctuation">()</span>
122 </td>
123 </tr>
124 <tr>
125 <td class="function_type">
126 <span class="returnvalue">void</span>
127 </td>
128 <td class="function_name">
129 <a class="link" href="XAppGtkWindow.html#xapp-set-xid-icon-from-file" title="xapp_set_xid_icon_from_file ()">xapp_set_xid_icon_from_file</a> <span class="c_punctuation">()</span>
130 </td>
131 </tr>
132 <tr>
133 <td class="function_type">
134 <span class="returnvalue">void</span>
135 </td>
136 <td class="function_name">
137 <a class="link" href="XAppGtkWindow.html#xapp-set-xid-progress" title="xapp_set_xid_progress ()">xapp_set_xid_progress</a> <span class="c_punctuation">()</span>
138 </td>
139 </tr>
140 <tr>
141 <td class="function_type">
142 <span class="returnvalue">void</span>
143 </td>
144 <td class="function_name">
145 <a class="link" href="XAppGtkWindow.html#xapp-set-xid-progress-pulse" title="xapp_set_xid_progress_pulse ()">xapp_set_xid_progress_pulse</a> <span class="c_punctuation">()</span>
146 </td>
147 </tr>
148 </tbody>
149 </table></div>
150 </div>
151 <div class="refsect1">
152 <a name="XAppGtkWindow.other"></a><h2>Types and Values</h2>
153 <div class="informaltable"><table class="informaltable" width="100%" border="0">
154 <colgroup>
155 <col width="150px" class="name">
156 <col class="description">
157 </colgroup>
158 <tbody>
159 <tr>
160 <td class="define_keyword">#define</td>
161 <td class="function_name"><a class="link" href="XAppGtkWindow.html#XAPP-TYPE-GTK-WINDOW:CAPS" title="XAPP_TYPE_GTK_WINDOW">XAPP_TYPE_GTK_WINDOW</a></td>
162 </tr>
163 <tr>
164 <td class="datatype_keyword">struct</td>
165 <td class="function_name"><a class="link" href="XAppGtkWindow.html#XAppGtkWindowClass" title="struct XAppGtkWindowClass">XAppGtkWindowClass</a></td>
166 </tr>
167 <tr>
168 <td class="datatype_keyword"> </td>
169 <td class="function_name"><a class="link" href="XAppGtkWindow.html#XAppGtkWindow-struct" title="XAppGtkWindow">XAppGtkWindow</a></td>
170 </tr>
171 </tbody>
172 </table></div>
173 </div>
174 <div class="refsect1">
175 <a name="XAppGtkWindow.object-hierarchy"></a><h2>Object Hierarchy</h2>
176 <pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
177 <span class="lineart">╰──</span> <a href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
178 <span class="lineart">╰──</span> <a href="../gtk3/GtkWidget.html#GtkWidget-struct">GtkWidget</a>
179 <span class="lineart">╰──</span> <a href="../gtk3/GtkContainer.html#GtkContainer-struct">GtkContainer</a>
180 <span class="lineart">╰──</span> <a href="../gtk3/GtkBin.html#GtkBin-struct">GtkBin</a>
181 <span class="lineart">╰──</span> <a href="../gtk3/GtkWindow.html#GtkWindow-struct">GtkWindow</a>
182 <span class="lineart">╰──</span> XAppGtkWindow
183 <span class="lineart">╰──</span> <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
184 </pre>
185 </div>
186 <div class="refsect1">
187 <a name="XAppGtkWindow.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
188 <p>
189 XAppGtkWindow implements
190 AtkImplementorIface and <a href="../gtk3/GtkBuildable.html#GtkBuildable-struct">GtkBuildable</a>.</p>
191 </div>
192 <div class="refsect1">
193 <a name="XAppGtkWindow.description"></a><h2>Description</h2>
194 <p>This widget is a simple subclass of GtkWindow that provides the following
195 additional capabilities:</p>
196 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
197 <li class="listitem"><p>Ability to set an icon name or icon file path for the window manager to
198 make use of, rather than relying on a desktop file or fixed-size window-
199 backed icon that Gtk normally generates. The window manager must support
200 the NET_WM_XAPP_ICON_NAME hint.</p></li>
201 <li class="listitem"><p>Ability to send progress info to the window manager, in the form of an integer,
202 0-100, which can then be used to display this progress in some manner in a task
203 manager or window list. The window manager must support the NET_WM_XAPP_PROGRESS
204 hint.</p></li>
205 <li class="listitem"><p>Ability to signal a 'pulsing' progress state, of potentially indeterminate value,
206 in the form of a boolean, which can be passed on to a window list. The window
207 manager must support the NET_WM_XAPP_PROGRESS_PULSE hint</p></li>
208 </ul></div>
209 <p>Wrappers:</p>
210 <p>Also provided are corresponding wrapper functions for normal GtkWindows.
211 They are not class methods - they are called with the target widget as their first
212 argument.</p>
213 <p>For example:</p>
214 <p>win = Gtk.Window()
215 XApp.set_window_icon_name(win, "foobar")</p>
216 <p>These functions mirror those of the <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow"><span class="type">XAppGtkWindow</span></a> class, but allow the properties
217 to work with normal GtkWindows and descendants of GtkWindow.</p>
218 </div>
219 <div class="refsect1">
220 <a name="XAppGtkWindow.functions_details"></a><h2>Functions</h2>
221 <div class="refsect2">
222 <a name="xapp-gtk-window-new"></a><h3>xapp_gtk_window_new ()</h3>
223 <pre class="programlisting"><a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
224 xapp_gtk_window_new (<em class="parameter"><code><a href="../gtk3/GtkWindow.html#GtkWindowType"><span class="type">GtkWindowType</span></a> type</code></em>);</pre>
225 <p>Creates a new <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow"><span class="type">XAppGtkWindow</span></a> of type <em class="parameter"><code>type</code></em>
226 . See <a href="../gtk3/GtkWindow.html#gtk-window-new"><code class="function">gtk_window_new()</code></a>
227 for more details.</p>
228 <div class="refsect3">
229 <a name="xapp-gtk-window-new.parameters"></a><h4>Parameters</h4>
230 <div class="informaltable"><table class="informaltable" width="100%" border="0">
231 <colgroup>
232 <col width="150px" class="parameters_name">
233 <col class="parameters_description">
234 <col width="200px" class="parameters_annotations">
235 </colgroup>
236 <tbody><tr>
237 <td class="parameter_name"><p>type</p></td>
238 <td class="parameter_description"><p>The <a href="../gtk3/GtkWindow.html#GtkWindowType"><span class="type">GtkWindowType</span></a> to use</p></td>
239 <td class="parameter_annotations"> </td>
240 </tr></tbody>
241 </table></div>
242 </div>
243 <div class="refsect3">
244 <a name="xapp-gtk-window-new.returns"></a><h4>Returns</h4>
245 <p> A new <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow"><span class="type">XAppGtkWindow</span></a> (transfer: full)</p>
246 </div>
247 </div>
248 <hr>
249 <div class="refsect2">
250 <a name="xapp-gtk-window-set-icon-name"></a><h3>xapp_gtk_window_set_icon_name ()</h3>
251 <pre class="programlisting"><span class="returnvalue">void</span>
252 xapp_gtk_window_set_icon_name (<em class="parameter"><code><a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow"><span class="type">XAppGtkWindow</span></a> *window</code></em>,
253 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>);</pre>
254 <p>Sets the icon name hint for a window manager (like muffin) to make
255 available when applications want to change their icons during runtime
256 without having to resort to the internal low-res pixbufs that GdkWindow
257 sets on the client side. This also chains up and calls GtkWindow.set_icon_name
258 for convenience and compatibility. Set to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset.</p>
259 <div class="refsect3">
260 <a name="xapp-gtk-window-set-icon-name.parameters"></a><h4>Parameters</h4>
261 <div class="informaltable"><table class="informaltable" width="100%" border="0">
262 <colgroup>
263 <col width="150px" class="parameters_name">
264 <col class="parameters_description">
265 <col width="200px" class="parameters_annotations">
266 </colgroup>
267 <tbody>
268 <tr>
269 <td class="parameter_name"><p>window</p></td>
270 <td class="parameter_description"><p>The <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow"><span class="type">XAppGtkWindow</span></a> to set the icon name for</p></td>
271 <td class="parameter_annotations"> </td>
272 </tr>
273 <tr>
274 <td class="parameter_name"><p>icon_name</p></td>
275 <td class="parameter_description"><p>The icon name or path to set, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset. </p></td>
276 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
277 </tr>
278 </tbody>
279 </table></div>
280 </div>
281 </div>
282 <hr>
283 <div class="refsect2">
284 <a name="xapp-gtk-window-set-icon-from-file"></a><h3>xapp_gtk_window_set_icon_from_file ()</h3>
285 <pre class="programlisting"><span class="returnvalue">void</span>
286 xapp_gtk_window_set_icon_from_file (<em class="parameter"><code><a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow"><span class="type">XAppGtkWindow</span></a> *window</code></em>,
287 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *file_name</code></em>,
288 <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
289 <p>Sets the icon name hint for a window manager (like muffin) to make
290 available when applications want to change their icons during runtime
291 without having to resort to the internal low-res pixbufs that GdkWindow
292 sets on the client side. This also chains up and calls GtkWindow.set_icon_from_file
293 for convenience and compatibility. Set to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset.</p>
294 <div class="refsect3">
295 <a name="xapp-gtk-window-set-icon-from-file.parameters"></a><h4>Parameters</h4>
296 <div class="informaltable"><table class="informaltable" width="100%" border="0">
297 <colgroup>
298 <col width="150px" class="parameters_name">
299 <col class="parameters_description">
300 <col width="200px" class="parameters_annotations">
301 </colgroup>
302 <tbody>
303 <tr>
304 <td class="parameter_name"><p>window</p></td>
305 <td class="parameter_description"><p>The <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow"><span class="type">XAppGtkWindow</span></a> to set the icon name for</p></td>
306 <td class="parameter_annotations"> </td>
307 </tr>
308 <tr>
309 <td class="parameter_name"><p>file_name</p></td>
310 <td class="parameter_description"><p>The icon path to set, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset. </p></td>
311 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
312 </tr>
313 <tr>
314 <td class="parameter_name"><p>error</p></td>
315 <td class="parameter_description"><p>An error to set if something goes wrong. </p></td>
316 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
317 </tr>
318 </tbody>
319 </table></div>
320 </div>
321 </div>
322 <hr>
323 <div class="refsect2">
324 <a name="xapp-gtk-window-set-progress"></a><h3>xapp_gtk_window_set_progress ()</h3>
325 <pre class="programlisting"><span class="returnvalue">void</span>
326 xapp_gtk_window_set_progress (<em class="parameter"><code><a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow"><span class="type">XAppGtkWindow</span></a> *window</code></em>,
327 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> progress</code></em>);</pre>
328 <p>Sets the progress hint for a window manager (like muffin) to make
329 available when applications want to display the application's progress
330 in some operation. The value sent to the WM will be clamped to
331 between 0 and 100.</p>
332 <p>Note: If a window will stick around after progress is complete, you will
333 probaby need to set progress to 0 to remove any progress effects on taskbars
334 and window lists.</p>
335 <p>Setting progress will also cancel the 'pulsing' flag on the window as
336 well, if it has been set.</p>
337 <div class="refsect3">
338 <a name="xapp-gtk-window-set-progress.parameters"></a><h4>Parameters</h4>
339 <div class="informaltable"><table class="informaltable" width="100%" border="0">
340 <colgroup>
341 <col width="150px" class="parameters_name">
342 <col class="parameters_description">
343 <col width="200px" class="parameters_annotations">
344 </colgroup>
345 <tbody>
346 <tr>
347 <td class="parameter_name"><p>window</p></td>
348 <td class="parameter_description"><p>The <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow"><span class="type">XAppGtkWindow</span></a> to set the progress for</p></td>
349 <td class="parameter_annotations"> </td>
350 </tr>
351 <tr>
352 <td class="parameter_name"><p>progress</p></td>
353 <td class="parameter_description"><p>The value to set for progress.</p></td>
354 <td class="parameter_annotations"> </td>
355 </tr>
356 </tbody>
357 </table></div>
358 </div>
359 </div>
360 <hr>
361 <div class="refsect2">
362 <a name="xapp-gtk-window-set-progress-pulse"></a><h3>xapp_gtk_window_set_progress_pulse ()</h3>
363 <pre class="programlisting"><span class="returnvalue">void</span>
364 xapp_gtk_window_set_progress_pulse (<em class="parameter"><code><a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow"><span class="type">XAppGtkWindow</span></a> *window</code></em>,
365 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> pulse</code></em>);</pre>
366 <p>Sets the progress pulse hint hint for a window manager (like muffin)
367 to make available when applications want to display indeterminate or
368 ongoing progress in a task manager.</p>
369 <p>Note: If a window will stick around after progress is complete, you will
370 probaby need to set progress to 0 to remove any progress effects on taskbars
371 and window lists. This will also remove the pulse state, if it is set.</p>
372 <p>Setting an explicit progress value will unset this flag.</p>
373 <div class="refsect3">
374 <a name="xapp-gtk-window-set-progress-pulse.parameters"></a><h4>Parameters</h4>
375 <div class="informaltable"><table class="informaltable" width="100%" border="0">
376 <colgroup>
377 <col width="150px" class="parameters_name">
378 <col class="parameters_description">
379 <col width="200px" class="parameters_annotations">
380 </colgroup>
381 <tbody>
382 <tr>
383 <td class="parameter_name"><p>window</p></td>
384 <td class="parameter_description"><p>The <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow"><span class="type">XAppGtkWindow</span></a> to set the progress for</p></td>
385 <td class="parameter_annotations"> </td>
386 </tr>
387 <tr>
388 <td class="parameter_name"><p>pulse</p></td>
389 <td class="parameter_description"><p>Whether to have pulsing set or not.</p></td>
390 <td class="parameter_annotations"> </td>
391 </tr>
392 </tbody>
393 </table></div>
394 </div>
395 </div>
396 <hr>
397 <div class="refsect2">
398 <a name="xapp-set-window-icon-name"></a><h3>xapp_set_window_icon_name ()</h3>
399 <pre class="programlisting"><span class="returnvalue">void</span>
400 xapp_set_window_icon_name (<em class="parameter"><code><a href="../gtk3/GtkWindow.html#GtkWindow-struct"><span class="type">GtkWindow</span></a> *window</code></em>,
401 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>);</pre>
402 <p>Sets the icon name hint for a window manager (like muffin) to make
403 available when applications want to change their icons during runtime
404 without having to resort to the internal low-res pixbufs that GdkWindow
405 sets on the client side. This is a function, not a method, for taking
406 advantage of this feature with descendants of GtkWindows, such as
407 GtkDialogs. Sets gtk_window_set_icon_name as well, to avoid needing
408 to have two calls each time. Set to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset.</p>
409 <div class="refsect3">
410 <a name="xapp-set-window-icon-name.parameters"></a><h4>Parameters</h4>
411 <div class="informaltable"><table class="informaltable" width="100%" border="0">
412 <colgroup>
413 <col width="150px" class="parameters_name">
414 <col class="parameters_description">
415 <col width="200px" class="parameters_annotations">
416 </colgroup>
417 <tbody>
418 <tr>
419 <td class="parameter_name"><p>window</p></td>
420 <td class="parameter_description"><p>The <a href="../gtk3/GtkWindow.html#GtkWindow-struct"><span class="type">GtkWindow</span></a> to set the icon name for</p></td>
421 <td class="parameter_annotations"> </td>
422 </tr>
423 <tr>
424 <td class="parameter_name"><p>icon_name</p></td>
425 <td class="parameter_description"><p>The icon name to set, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset. </p></td>
426 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
427 </tr>
428 </tbody>
429 </table></div>
430 </div>
431 </div>
432 <hr>
433 <div class="refsect2">
434 <a name="xapp-set-window-icon-from-file"></a><h3>xapp_set_window_icon_from_file ()</h3>
435 <pre class="programlisting"><span class="returnvalue">void</span>
436 xapp_set_window_icon_from_file (<em class="parameter"><code><a href="../gtk3/GtkWindow.html#GtkWindow-struct"><span class="type">GtkWindow</span></a> *window</code></em>,
437 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *file_name</code></em>,
438 <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
439 <p>Sets the icon name hint for a window manager (like muffin) to make
440 available when applications want to change their icons during runtime
441 without having to resort to the internal low-res pixbufs that GdkWindow
442 sets on the client side. This also chains up and calls GtkWindow.set_icon_from_file
443 for convenience and compatibility. Set to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset.</p>
444 <div class="refsect3">
445 <a name="xapp-set-window-icon-from-file.parameters"></a><h4>Parameters</h4>
446 <div class="informaltable"><table class="informaltable" width="100%" border="0">
447 <colgroup>
448 <col width="150px" class="parameters_name">
449 <col class="parameters_description">
450 <col width="200px" class="parameters_annotations">
451 </colgroup>
452 <tbody>
453 <tr>
454 <td class="parameter_name"><p>window</p></td>
455 <td class="parameter_description"><p>The <a href="../gtk3/GtkWindow.html#GtkWindow-struct"><span class="type">GtkWindow</span></a> to set the icon name for</p></td>
456 <td class="parameter_annotations"> </td>
457 </tr>
458 <tr>
459 <td class="parameter_name"><p>file_name</p></td>
460 <td class="parameter_description"><p>The icon path to set, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset. </p></td>
461 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
462 </tr>
463 <tr>
464 <td class="parameter_name"><p>error</p></td>
465 <td class="parameter_description"><p>An error to set if something goes wrong. </p></td>
466 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
467 </tr>
468 </tbody>
469 </table></div>
470 </div>
471 </div>
472 <hr>
473 <div class="refsect2">
474 <a name="xapp-set-window-progress"></a><h3>xapp_set_window_progress ()</h3>
475 <pre class="programlisting"><span class="returnvalue">void</span>
476 xapp_set_window_progress (<em class="parameter"><code><a href="../gtk3/GtkWindow.html#GtkWindow-struct"><span class="type">GtkWindow</span></a> *window</code></em>,
477 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> progress</code></em>);</pre>
478 <p>Sets the progress hint for a window manager (like muffin) to make
479 available when applications want to display the application's progress
480 in some operation. The value sent to the WM will be clamped to
481 between 0 and 100.</p>
482 <p>Note: If a window will stick around after progress is complete, you will
483 probaby need to set progress to 0 to remove any progress effects on taskbars
484 and window lists.</p>
485 <p>Setting progress will also cancel the 'pulsing' flag on the window as
486 well, if it has been set.</p>
487 <div class="refsect3">
488 <a name="xapp-set-window-progress.parameters"></a><h4>Parameters</h4>
489 <div class="informaltable"><table class="informaltable" width="100%" border="0">
490 <colgroup>
491 <col width="150px" class="parameters_name">
492 <col class="parameters_description">
493 <col width="200px" class="parameters_annotations">
494 </colgroup>
495 <tbody>
496 <tr>
497 <td class="parameter_name"><p>window</p></td>
498 <td class="parameter_description"><p>The <a href="../gtk3/GtkWindow.html#GtkWindow-struct"><span class="type">GtkWindow</span></a> to set the progress for</p></td>
499 <td class="parameter_annotations"> </td>
500 </tr>
501 <tr>
502 <td class="parameter_name"><p>progress</p></td>
503 <td class="parameter_description"><p>The value to set for progress.</p></td>
504 <td class="parameter_annotations"> </td>
505 </tr>
506 </tbody>
507 </table></div>
508 </div>
509 </div>
510 <hr>
511 <div class="refsect2">
512 <a name="xapp-set-window-progress-pulse"></a><h3>xapp_set_window_progress_pulse ()</h3>
513 <pre class="programlisting"><span class="returnvalue">void</span>
514 xapp_set_window_progress_pulse (<em class="parameter"><code><a href="../gtk3/GtkWindow.html#GtkWindow-struct"><span class="type">GtkWindow</span></a> *window</code></em>,
515 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> pulse</code></em>);</pre>
516 <p>Sets the progress pulse hint hint for a window manager (like muffin)
517 to make available when applications want to display indeterminate or
518 ongoing progress in a task manager.</p>
519 <p>Note: If a window will stick around after progress is complete, you will
520 probaby need to set progress to 0 to remove any progress effects on taskbars
521 and window lists. This will also remove the pulse state, if it is set.</p>
522 <p>Setting an explicit progress value will unset this flag.</p>
523 <div class="refsect3">
524 <a name="xapp-set-window-progress-pulse.parameters"></a><h4>Parameters</h4>
525 <div class="informaltable"><table class="informaltable" width="100%" border="0">
526 <colgroup>
527 <col width="150px" class="parameters_name">
528 <col class="parameters_description">
529 <col width="200px" class="parameters_annotations">
530 </colgroup>
531 <tbody>
532 <tr>
533 <td class="parameter_name"><p>window</p></td>
534 <td class="parameter_description"><p>The <a href="../gtk3/GtkWindow.html#GtkWindow-struct"><span class="type">GtkWindow</span></a> to set the progress for</p></td>
535 <td class="parameter_annotations"> </td>
536 </tr>
537 <tr>
538 <td class="parameter_name"><p>pulse</p></td>
539 <td class="parameter_description"><p>Whether to have pulsing set or not.</p></td>
540 <td class="parameter_annotations"> </td>
541 </tr>
542 </tbody>
543 </table></div>
544 </div>
545 </div>
546 <hr>
547 <div class="refsect2">
548 <a name="xapp-set-xid-icon-name"></a><h3>xapp_set_xid_icon_name ()</h3>
549 <pre class="programlisting"><span class="returnvalue">void</span>
550 xapp_set_xid_icon_name (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> xid</code></em>,
551 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>);</pre>
552 <p>Sets the icon name hint for a window manager (like muffin) to make
553 available when applications want to change their icons during runtime
554 without having to resort to the internal low-res pixbufs that GdkWindow
555 sets on the client side. This is a function, not a method, for applying
556 the icon name property for a given (possibly foreign) window, by passing
557 the window's XID. Set to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset.</p>
558 <div class="refsect3">
559 <a name="xapp-set-xid-icon-name.parameters"></a><h4>Parameters</h4>
560 <div class="informaltable"><table class="informaltable" width="100%" border="0">
561 <colgroup>
562 <col width="150px" class="parameters_name">
563 <col class="parameters_description">
564 <col width="200px" class="parameters_annotations">
565 </colgroup>
566 <tbody>
567 <tr>
568 <td class="parameter_name"><p>xid</p></td>
569 <td class="parameter_description"><p>The Window to set the icon name for</p></td>
570 <td class="parameter_annotations"> </td>
571 </tr>
572 <tr>
573 <td class="parameter_name"><p>icon_name</p></td>
574 <td class="parameter_description"><p>The icon name to set, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset. </p></td>
575 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
576 </tr>
577 </tbody>
578 </table></div>
579 </div>
580 </div>
581 <hr>
582 <div class="refsect2">
583 <a name="xapp-set-xid-icon-from-file"></a><h3>xapp_set_xid_icon_from_file ()</h3>
584 <pre class="programlisting"><span class="returnvalue">void</span>
585 xapp_set_xid_icon_from_file (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> xid</code></em>,
586 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *file_name</code></em>);</pre>
587 <p>Sets the icon name hint for a window manager (like muffin) to make
588 available when applications want to change their icons during runtime
589 without having to resort to the internal low-res pixbufs that GdkWindow
590 sets on the client side. This is a function, not a method, for applying
591 the icon name property for a given (possibly foreign) window, by passing
592 the window's XID. Set to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset.</p>
593 <div class="refsect3">
594 <a name="xapp-set-xid-icon-from-file.parameters"></a><h4>Parameters</h4>
595 <div class="informaltable"><table class="informaltable" width="100%" border="0">
596 <colgroup>
597 <col width="150px" class="parameters_name">
598 <col class="parameters_description">
599 <col width="200px" class="parameters_annotations">
600 </colgroup>
601 <tbody>
602 <tr>
603 <td class="parameter_name"><p>xid</p></td>
604 <td class="parameter_description"><p>The Window to set the icon name for</p></td>
605 <td class="parameter_annotations"> </td>
606 </tr>
607 <tr>
608 <td class="parameter_name"><p>file_name</p></td>
609 <td class="parameter_description"><p>The icon path to set, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset. </p></td>
610 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
611 </tr>
612 </tbody>
613 </table></div>
614 </div>
615 </div>
616 <hr>
617 <div class="refsect2">
618 <a name="xapp-set-xid-progress"></a><h3>xapp_set_xid_progress ()</h3>
619 <pre class="programlisting"><span class="returnvalue">void</span>
620 xapp_set_xid_progress (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> xid</code></em>,
621 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> progress</code></em>);</pre>
622 <p>Sets the progress hint for a window manager (like muffin) to make
623 available when applications want to display the application's progress
624 in some operation. The value sent to the WM will be clamped to
625 between 0 and 100.</p>
626 <p>Setting progress will also cancel the 'pulsing' flag on the window as
627 well, if it has been set.</p>
628 <p>Note: If a window will stick around after progress is complete, you will
629 probaby need to set progress to 0 to remove any progress effects on taskbars
630 and window lists.</p>
631 <p>This is a function, not a method, for applying the progress property for
632 a given (possibly foreign) window, by passing the window's XID.</p>
633 <div class="refsect3">
634 <a name="xapp-set-xid-progress.parameters"></a><h4>Parameters</h4>
635 <div class="informaltable"><table class="informaltable" width="100%" border="0">
636 <colgroup>
637 <col width="150px" class="parameters_name">
638 <col class="parameters_description">
639 <col width="200px" class="parameters_annotations">
640 </colgroup>
641 <tbody>
642 <tr>
643 <td class="parameter_name"><p>xid</p></td>
644 <td class="parameter_description"><p>The Window to set the progress for</p></td>
645 <td class="parameter_annotations"> </td>
646 </tr>
647 <tr>
648 <td class="parameter_name"><p>progress</p></td>
649 <td class="parameter_description"><p>The value to set for progress.</p></td>
650 <td class="parameter_annotations"> </td>
651 </tr>
652 </tbody>
653 </table></div>
654 </div>
655 </div>
656 <hr>
657 <div class="refsect2">
658 <a name="xapp-set-xid-progress-pulse"></a><h3>xapp_set_xid_progress_pulse ()</h3>
659 <pre class="programlisting"><span class="returnvalue">void</span>
660 xapp_set_xid_progress_pulse (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> xid</code></em>,
661 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> pulse</code></em>);</pre>
662 <p>Sets the progress pulse hint hint for a window manager (like muffin)
663 to make available when applications want to display indeterminate or
664 ongoing progress in a task manager.</p>
665 <p>Note: If a window will stick around after progress is complete, you will
666 probaby need to set progress to 0 to remove any progress effects on taskbars
667 and window lists.</p>
668 <p>Setting an explicit progress value will unset this flag.</p>
669 <div class="refsect3">
670 <a name="xapp-set-xid-progress-pulse.parameters"></a><h4>Parameters</h4>
671 <div class="informaltable"><table class="informaltable" width="100%" border="0">
672 <colgroup>
673 <col width="150px" class="parameters_name">
674 <col class="parameters_description">
675 <col width="200px" class="parameters_annotations">
676 </colgroup>
677 <tbody>
678 <tr>
679 <td class="parameter_name"><p>xid</p></td>
680 <td class="parameter_description"><p>The Window to set the progress for</p></td>
681 <td class="parameter_annotations"> </td>
682 </tr>
683 <tr>
684 <td class="parameter_name"><p>pulse</p></td>
685 <td class="parameter_description"><p>Whether to have pulsing set or not.</p></td>
686 <td class="parameter_annotations"> </td>
687 </tr>
688 </tbody>
689 </table></div>
690 </div>
691 </div>
692 </div>
693 <div class="refsect1">
694 <a name="XAppGtkWindow.other_details"></a><h2>Types and Values</h2>
695 <div class="refsect2">
696 <a name="XAPP-TYPE-GTK-WINDOW:CAPS"></a><h3>XAPP_TYPE_GTK_WINDOW</h3>
697 <pre class="programlisting">#define XAPP_TYPE_GTK_WINDOW (xapp_gtk_window_get_type ())
698 </pre>
699 </div>
700 <hr>
701 <div class="refsect2">
702 <a name="XAppGtkWindowClass"></a><h3>struct XAppGtkWindowClass</h3>
703 <pre class="programlisting">struct XAppGtkWindowClass {
704 GtkWindowClass parent_class;
705
706 gpointer padding[12];
707 };
708 </pre>
709 </div>
710 <hr>
711 <div class="refsect2">
712 <a name="XAppGtkWindow-struct"></a><h3>XAppGtkWindow</h3>
713 <pre class="programlisting">typedef struct _XAppGtkWindow XAppGtkWindow;</pre>
714 </div>
715 </div>
716 </div>
717 <div class="footer">
718 <hr>Generated by GTK-Doc V1.27</div>
719 </body>
720 </html>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>XAppIconChooserButton: XApp Reference Manual</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
6 <link rel="home" href="index.html" title="XApp Reference Manual">
7 <link rel="up" href="ch01.html" title="API reference">
8 <link rel="prev" href="XAppGtkWindow.html" title="XAppGtkWindow">
9 <link rel="next" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">
10 <meta name="generator" content="GTK-Doc V1.27 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 </head>
13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
15 <td width="100%" align="left" class="shortcuts">
16 <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
17 <a href="#XAppIconChooserButton.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
18 <a href="#XAppIconChooserButton.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces">  <span class="dim">|</span> 
19 <a href="#XAppIconChooserButton.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties">  <span class="dim">|</span> 
20 <a href="#XAppIconChooserButton.properties" class="shortcut">Properties</a></span>
21 </td>
22 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
23 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
24 <td><a accesskey="p" href="XAppGtkWindow.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
25 <td><a accesskey="n" href="XAppIconChooserDialog.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
26 </tr></table>
27 <div class="refentry">
28 <a name="XAppIconChooserButton"></a><div class="titlepage"></div>
29 <div class="refnamediv"><table width="100%"><tr>
30 <td valign="top">
31 <h2><span class="refentrytitle"><a name="XAppIconChooserButton.top_of_page"></a>XAppIconChooserButton</span></h2>
32 <p>XAppIconChooserButton — A button for selecting an icon</p>
33 </td>
34 <td class="gallery_image" valign="top" align="right"></td>
35 </tr></table></div>
36 <div class="refsect1">
37 <a name="XAppIconChooserButton.functions"></a><h2>Functions</h2>
38 <div class="informaltable"><table class="informaltable" width="100%" border="0">
39 <colgroup>
40 <col width="150px" class="functions_return">
41 <col class="functions_name">
42 </colgroup>
43 <tbody>
44 <tr>
45 <td class="function_type">
46 <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="returnvalue">XAppIconChooserButton</span></a> *
47 </td>
48 <td class="function_name">
49 <a class="link" href="XAppIconChooserButton.html#xapp-icon-chooser-button-new" title="xapp_icon_chooser_button_new ()">xapp_icon_chooser_button_new</a> <span class="c_punctuation">()</span>
50 </td>
51 </tr>
52 <tr>
53 <td class="function_type">
54 <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="returnvalue">XAppIconChooserButton</span></a> *
55 </td>
56 <td class="function_name">
57 <a class="link" href="XAppIconChooserButton.html#xapp-icon-chooser-button-new-with-size" title="xapp_icon_chooser_button_new_with_size ()">xapp_icon_chooser_button_new_with_size</a> <span class="c_punctuation">()</span>
58 </td>
59 </tr>
60 <tr>
61 <td class="function_type">
62 <span class="returnvalue">void</span>
63 </td>
64 <td class="function_name">
65 <a class="link" href="XAppIconChooserButton.html#xapp-icon-chooser-button-set-icon-size" title="xapp_icon_chooser_button_set_icon_size ()">xapp_icon_chooser_button_set_icon_size</a> <span class="c_punctuation">()</span>
66 </td>
67 </tr>
68 <tr>
69 <td class="function_type">
70 <span class="returnvalue">void</span>
71 </td>
72 <td class="function_name">
73 <a class="link" href="XAppIconChooserButton.html#xapp-icon-chooser-button-set-icon" title="xapp_icon_chooser_button_set_icon ()">xapp_icon_chooser_button_set_icon</a> <span class="c_punctuation">()</span>
74 </td>
75 </tr>
76 <tr>
77 <td class="function_type">
78 <span class="returnvalue">void</span>
79 </td>
80 <td class="function_name">
81 <a class="link" href="XAppIconChooserButton.html#xapp-icon-chooser-button-set-default-category" title="xapp_icon_chooser_button_set_default_category ()">xapp_icon_chooser_button_set_default_category</a> <span class="c_punctuation">()</span>
82 </td>
83 </tr>
84 <tr>
85 <td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
86 </td>
87 <td class="function_name">
88 <a class="link" href="XAppIconChooserButton.html#xapp-icon-chooser-button-get-icon" title="xapp_icon_chooser_button_get_icon ()">xapp_icon_chooser_button_get_icon</a> <span class="c_punctuation">()</span>
89 </td>
90 </tr>
91 <tr>
92 <td class="function_type">
93 <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="returnvalue">XAppIconChooserDialog</span></a> *
94 </td>
95 <td class="function_name">
96 <a class="link" href="XAppIconChooserButton.html#xapp-icon-chooser-button-get-dialog" title="xapp_icon_chooser_button_get_dialog ()">xapp_icon_chooser_button_get_dialog</a> <span class="c_punctuation">()</span>
97 </td>
98 </tr>
99 </tbody>
100 </table></div>
101 </div>
102 <div class="refsect1">
103 <a name="XAppIconChooserButton.properties"></a><h2>Properties</h2>
104 <div class="informaltable"><table class="informaltable" border="0">
105 <colgroup>
106 <col width="150px" class="properties_type">
107 <col width="300px" class="properties_name">
108 <col width="200px" class="properties_flags">
109 </colgroup>
110 <tbody>
111 <tr>
112 <td class="property_type">
113 <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
114 <td class="property_name"><a class="link" href="XAppIconChooserButton.html#XAppIconChooserButton--category" title="The “category” property">category</a></td>
115 <td class="property_flags">Read / Write</td>
116 </tr>
117 <tr>
118 <td class="property_type">
119 <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
120 <td class="property_name"><a class="link" href="XAppIconChooserButton.html#XAppIconChooserButton--icon" title="The “icon” property">icon</a></td>
121 <td class="property_flags">Read / Write</td>
122 </tr>
123 <tr>
124 <td class="property_type"><a href="../gtk3/gtk3-Themeable-Stock-Images.html#GtkIconSize"><span class="type">GtkIconSize</span></a></td>
125 <td class="property_name"><a class="link" href="XAppIconChooserButton.html#XAppIconChooserButton--icon-size" title="The “icon-size” property">icon-size</a></td>
126 <td class="property_flags">Read / Write</td>
127 </tr>
128 </tbody>
129 </table></div>
130 </div>
131 <div class="refsect1">
132 <a name="XAppIconChooserButton.other"></a><h2>Types and Values</h2>
133 <div class="informaltable"><table class="informaltable" width="100%" border="0">
134 <colgroup>
135 <col width="150px" class="name">
136 <col class="description">
137 </colgroup>
138 <tbody>
139 <tr>
140 <td class="define_keyword">#define</td>
141 <td class="function_name"><a class="link" href="XAppIconChooserButton.html#XAPP-TYPE-ICON-CHOOSER-BUTTON:CAPS" title="XAPP_TYPE_ICON_CHOOSER_BUTTON">XAPP_TYPE_ICON_CHOOSER_BUTTON</a></td>
142 </tr>
143 <tr>
144 <td class="datatype_keyword"> </td>
145 <td class="function_name"><a class="link" href="XAppIconChooserButton.html#XAppIconChooserButton-struct" title="XAppIconChooserButton">XAppIconChooserButton</a></td>
146 </tr>
147 </tbody>
148 </table></div>
149 </div>
150 <div class="refsect1">
151 <a name="XAppIconChooserButton.object-hierarchy"></a><h2>Object Hierarchy</h2>
152 <pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
153 <span class="lineart">╰──</span> <a href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
154 <span class="lineart">╰──</span> <a href="../gtk3/GtkWidget.html#GtkWidget-struct">GtkWidget</a>
155 <span class="lineart">╰──</span> <a href="../gtk3/GtkContainer.html#GtkContainer-struct">GtkContainer</a>
156 <span class="lineart">╰──</span> <a href="../gtk3/GtkBin.html#GtkBin-struct">GtkBin</a>
157 <span class="lineart">╰──</span> <a href="../gtk3/GtkButton.html#GtkButton-struct">GtkButton</a>
158 <span class="lineart">╰──</span> XAppIconChooserButton
159 </pre>
160 </div>
161 <div class="refsect1">
162 <a name="XAppIconChooserButton.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
163 <p>
164 XAppIconChooserButton implements
165 AtkImplementorIface, <a href="../gtk3/GtkBuildable.html#GtkBuildable-struct">GtkBuildable</a>, <a href="../gtk3/GtkActionable.html#GtkActionable-struct">GtkActionable</a> and <a href="../gtk3/GtkActivatable.html#GtkActivatable-struct">GtkActivatable</a>.</p>
166 </div>
167 <div class="refsect1">
168 <a name="XAppIconChooserButton.description"></a><h2>Description</h2>
169 <p>The XAppIconChooserButton creates a button so that
170 the user can select an icon. When the button is clicked
171 it will open an XAppIconChooserDialog. The currently
172 selected icon will be displayed as the button image.</p>
173 </div>
174 <div class="refsect1">
175 <a name="XAppIconChooserButton.functions_details"></a><h2>Functions</h2>
176 <div class="refsect2">
177 <a name="xapp-icon-chooser-button-new"></a><h3>xapp_icon_chooser_button_new ()</h3>
178 <pre class="programlisting"><a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="returnvalue">XAppIconChooserButton</span></a> *
179 xapp_icon_chooser_button_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
180 <p>Creates a new <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a> and sets its icon to <em class="parameter"><code>icon</code></em>
181 .</p>
182 <div class="refsect3">
183 <a name="xapp-icon-chooser-button-new.returns"></a><h4>Returns</h4>
184 <p> a newly created <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a></p>
185 </div>
186 </div>
187 <hr>
188 <div class="refsect2">
189 <a name="xapp-icon-chooser-button-new-with-size"></a><h3>xapp_icon_chooser_button_new_with_size ()</h3>
190 <pre class="programlisting"><a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="returnvalue">XAppIconChooserButton</span></a> *
191 xapp_icon_chooser_button_new_with_size
192 (<em class="parameter"><code><a href="../gtk3/gtk3-Themeable-Stock-Images.html#GtkIconSize"><span class="type">GtkIconSize</span></a> icon_size</code></em>);</pre>
193 <p>Creates a new <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a>, and sets the sizes of the button image and the icons in
194 the dialog. Note that xapp_icon_chooser_button_new_with_size (NULL, NULL) is the same as calling
195 <a class="link" href="XAppIconChooserButton.html#xapp-icon-chooser-button-new" title="xapp_icon_chooser_button_new ()"><code class="function">xapp_icon_chooser_button_new()</code></a>.</p>
196 <div class="refsect3">
197 <a name="xapp-icon-chooser-button-new-with-size.parameters"></a><h4>Parameters</h4>
198 <div class="informaltable"><table class="informaltable" width="100%" border="0">
199 <colgroup>
200 <col width="150px" class="parameters_name">
201 <col class="parameters_description">
202 <col width="200px" class="parameters_annotations">
203 </colgroup>
204 <tbody><tr>
205 <td class="parameter_name"><p>icon_size</p></td>
206 <td class="parameter_description"><p>the size of icon to use in the button, or NULL to use the default value.</p></td>
207 <td class="parameter_annotations"> </td>
208 </tr></tbody>
209 </table></div>
210 </div>
211 <div class="refsect3">
212 <a name="xapp-icon-chooser-button-new-with-size.returns"></a><h4>Returns</h4>
213 <p> a newly created <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a></p>
214 </div>
215 </div>
216 <hr>
217 <div class="refsect2">
218 <a name="xapp-icon-chooser-button-set-icon-size"></a><h3>xapp_icon_chooser_button_set_icon_size ()</h3>
219 <pre class="programlisting"><span class="returnvalue">void</span>
220 xapp_icon_chooser_button_set_icon_size
221 (<em class="parameter"><code><a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a> *button</code></em>,
222 <em class="parameter"><code><a href="../gtk3/gtk3-Themeable-Stock-Images.html#GtkIconSize"><span class="type">GtkIconSize</span></a> icon_size</code></em>);</pre>
223 <p>Sets the icon size used in the button.</p>
224 <div class="refsect3">
225 <a name="xapp-icon-chooser-button-set-icon-size.parameters"></a><h4>Parameters</h4>
226 <div class="informaltable"><table class="informaltable" width="100%" border="0">
227 <colgroup>
228 <col width="150px" class="parameters_name">
229 <col class="parameters_description">
230 <col width="200px" class="parameters_annotations">
231 </colgroup>
232 <tbody>
233 <tr>
234 <td class="parameter_name"><p>button</p></td>
235 <td class="parameter_description"><p>a <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a></p></td>
236 <td class="parameter_annotations"> </td>
237 </tr>
238 <tr>
239 <td class="parameter_name"><p>icon_size</p></td>
240 <td class="parameter_description"><p>the size of icon to use in the button, or -1 to use the default value.</p></td>
241 <td class="parameter_annotations"> </td>
242 </tr>
243 </tbody>
244 </table></div>
245 </div>
246 </div>
247 <hr>
248 <div class="refsect2">
249 <a name="xapp-icon-chooser-button-set-icon"></a><h3>xapp_icon_chooser_button_set_icon ()</h3>
250 <pre class="programlisting"><span class="returnvalue">void</span>
251 xapp_icon_chooser_button_set_icon (<em class="parameter"><code><a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a> *button</code></em>,
252 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon</code></em>);</pre>
253 <p>Sets the icon on the <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a>.</p>
254 <div class="refsect3">
255 <a name="xapp-icon-chooser-button-set-icon.parameters"></a><h4>Parameters</h4>
256 <div class="informaltable"><table class="informaltable" width="100%" border="0">
257 <colgroup>
258 <col width="150px" class="parameters_name">
259 <col class="parameters_description">
260 <col width="200px" class="parameters_annotations">
261 </colgroup>
262 <tbody>
263 <tr>
264 <td class="parameter_name"><p>button</p></td>
265 <td class="parameter_description"><p>a <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a></p></td>
266 <td class="parameter_annotations"> </td>
267 </tr>
268 <tr>
269 <td class="parameter_name"><p>icon</p></td>
270 <td class="parameter_description"><p>a string representing the icon to be set. This may be an icon name or a file path. </p></td>
271 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
272 </tr>
273 </tbody>
274 </table></div>
275 </div>
276 </div>
277 <hr>
278 <div class="refsect2">
279 <a name="xapp-icon-chooser-button-set-default-category"></a><h3>xapp_icon_chooser_button_set_default_category ()</h3>
280 <pre class="programlisting"><span class="returnvalue">void</span>
281 xapp_icon_chooser_button_set_default_category
282 (<em class="parameter"><code><a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a> *button</code></em>,
283 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *category</code></em>);</pre>
284 <p>Sets the icon on the <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a>.</p>
285 <div class="refsect3">
286 <a name="xapp-icon-chooser-button-set-default-category.parameters"></a><h4>Parameters</h4>
287 <div class="informaltable"><table class="informaltable" width="100%" border="0">
288 <colgroup>
289 <col width="150px" class="parameters_name">
290 <col class="parameters_description">
291 <col width="200px" class="parameters_annotations">
292 </colgroup>
293 <tbody>
294 <tr>
295 <td class="parameter_name"><p>button</p></td>
296 <td class="parameter_description"><p>a <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a></p></td>
297 <td class="parameter_annotations"> </td>
298 </tr>
299 <tr>
300 <td class="parameter_name"><p>category</p></td>
301 <td class="parameter_description"><p>a string representing the category selected by default. </p></td>
302 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
303 </tr>
304 </tbody>
305 </table></div>
306 </div>
307 </div>
308 <hr>
309 <div class="refsect2">
310 <a name="xapp-icon-chooser-button-get-icon"></a><h3>xapp_icon_chooser_button_get_icon ()</h3>
311 <pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
312 xapp_icon_chooser_button_get_icon (<em class="parameter"><code><a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a> *button</code></em>);</pre>
313 <p>Gets the icon from the <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a>.</p>
314 <div class="refsect3">
315 <a name="xapp-icon-chooser-button-get-icon.parameters"></a><h4>Parameters</h4>
316 <div class="informaltable"><table class="informaltable" width="100%" border="0">
317 <colgroup>
318 <col width="150px" class="parameters_name">
319 <col class="parameters_description">
320 <col width="200px" class="parameters_annotations">
321 </colgroup>
322 <tbody><tr>
323 <td class="parameter_name"><p>button</p></td>
324 <td class="parameter_description"><p>a <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a></p></td>
325 <td class="parameter_annotations"> </td>
326 </tr></tbody>
327 </table></div>
328 </div>
329 <div class="refsect3">
330 <a name="xapp-icon-chooser-button-get-icon.returns"></a><h4>Returns</h4>
331 <p> a string representing the icon. This may be an icon name or a file path.</p>
332 </div>
333 </div>
334 <hr>
335 <div class="refsect2">
336 <a name="xapp-icon-chooser-button-get-dialog"></a><h3>xapp_icon_chooser_button_get_dialog ()</h3>
337 <pre class="programlisting"><a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="returnvalue">XAppIconChooserDialog</span></a> *
338 xapp_icon_chooser_button_get_dialog (<em class="parameter"><code><a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a> *button</code></em>);</pre>
339 <p>Gets a reference to the icon chooser dialog for the <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a>.
340 This is useful for setting properties on the dialog.</p>
341 <div class="refsect3">
342 <a name="xapp-icon-chooser-button-get-dialog.parameters"></a><h4>Parameters</h4>
343 <div class="informaltable"><table class="informaltable" width="100%" border="0">
344 <colgroup>
345 <col width="150px" class="parameters_name">
346 <col class="parameters_description">
347 <col width="200px" class="parameters_annotations">
348 </colgroup>
349 <tbody><tr>
350 <td class="parameter_name"><p>button</p></td>
351 <td class="parameter_description"><p>a <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton"><span class="type">XAppIconChooserButton</span></a></p></td>
352 <td class="parameter_annotations"> </td>
353 </tr></tbody>
354 </table></div>
355 </div>
356 <div class="refsect3">
357 <a name="xapp-icon-chooser-button-get-dialog.returns"></a><h4>Returns</h4>
358 <p>the <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a>. </p>
359 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
360 </div>
361 </div>
362 </div>
363 <div class="refsect1">
364 <a name="XAppIconChooserButton.other_details"></a><h2>Types and Values</h2>
365 <div class="refsect2">
366 <a name="XAPP-TYPE-ICON-CHOOSER-BUTTON:CAPS"></a><h3>XAPP_TYPE_ICON_CHOOSER_BUTTON</h3>
367 <pre class="programlisting">#define XAPP_TYPE_ICON_CHOOSER_BUTTON (xapp_icon_chooser_button_get_type ())
368 </pre>
369 </div>
370 <hr>
371 <div class="refsect2">
372 <a name="XAppIconChooserButton-struct"></a><h3>XAppIconChooserButton</h3>
373 <pre class="programlisting">typedef struct _XAppIconChooserButton XAppIconChooserButton;</pre>
374 </div>
375 </div>
376 <div class="refsect1">
377 <a name="XAppIconChooserButton.property-details"></a><h2>Property Details</h2>
378 <div class="refsect2">
379 <a name="XAppIconChooserButton--category"></a><h3>The <code class="literal">“category”</code> property</h3>
380 <pre class="programlisting"> “category” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
381 <p>The category selected by default.</p>
382 <p>Flags: Read / Write</p>
383 <p>Default value: ""</p>
384 </div>
385 <hr>
386 <div class="refsect2">
387 <a name="XAppIconChooserButton--icon"></a><h3>The <code class="literal">“icon”</code> property</h3>
388 <pre class="programlisting"> “icon” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
389 <p>The preferred size to use when looking up icons. This only works with icon names.
390 Additionally, there is no guarantee that a selected icon name will exist in a
391 particular size.</p>
392 <p>Flags: Read / Write</p>
393 <p>Default value: ""</p>
394 </div>
395 <hr>
396 <div class="refsect2">
397 <a name="XAppIconChooserButton--icon-size"></a><h3>The <code class="literal">“icon-size”</code> property</h3>
398 <pre class="programlisting"> “icon-size” <a href="../gtk3/gtk3-Themeable-Stock-Images.html#GtkIconSize"><span class="type">GtkIconSize</span></a></pre>
399 <p>The size to use when displaying the icon.</p>
400 <p>Flags: Read / Write</p>
401 <p>Default value: GTK_ICON_SIZE_DND</p>
402 </div>
403 </div>
404 </div>
405 <div class="footer">
406 <hr>Generated by GTK-Doc V1.27</div>
407 </body>
408 </html>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>XAppIconChooserDialog: XApp Reference Manual</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
6 <link rel="home" href="index.html" title="XApp Reference Manual">
7 <link rel="up" href="ch01.html" title="API reference">
8 <link rel="prev" href="XAppIconChooserButton.html" title="XAppIconChooserButton">
9 <link rel="next" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">
10 <meta name="generator" content="GTK-Doc V1.27 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 </head>
13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
15 <td width="100%" align="left" class="shortcuts">
16 <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
17 <a href="#XAppIconChooserDialog.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
18 <a href="#XAppIconChooserDialog.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces">  <span class="dim">|</span> 
19 <a href="#XAppIconChooserDialog.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties">  <span class="dim">|</span> 
20 <a href="#XAppIconChooserDialog.properties" class="shortcut">Properties</a></span><span id="nav_signals">  <span class="dim">|</span> 
21 <a href="#XAppIconChooserDialog.signals" class="shortcut">Signals</a></span>
22 </td>
23 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
24 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
25 <td><a accesskey="p" href="XAppIconChooserButton.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
26 <td><a accesskey="n" href="XAppKbdLayoutController.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
27 </tr></table>
28 <div class="refentry">
29 <a name="XAppIconChooserDialog"></a><div class="titlepage"></div>
30 <div class="refnamediv"><table width="100%"><tr>
31 <td valign="top">
32 <h2><span class="refentrytitle"><a name="XAppIconChooserDialog.top_of_page"></a>XAppIconChooserDialog</span></h2>
33 <p>XAppIconChooserDialog — A dialog for selecting an icon</p>
34 </td>
35 <td class="gallery_image" valign="top" align="right"></td>
36 </tr></table></div>
37 <div class="refsect1">
38 <a name="XAppIconChooserDialog.functions"></a><h2>Functions</h2>
39 <div class="informaltable"><table class="informaltable" width="100%" border="0">
40 <colgroup>
41 <col width="150px" class="functions_return">
42 <col class="functions_name">
43 </colgroup>
44 <tbody>
45 <tr>
46 <td class="function_type">
47 <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="returnvalue">XAppIconChooserDialog</span></a> *
48 </td>
49 <td class="function_name">
50 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-new" title="xapp_icon_chooser_dialog_new ()">xapp_icon_chooser_dialog_new</a> <span class="c_punctuation">()</span>
51 </td>
52 </tr>
53 <tr>
54 <td class="function_type">
55 <a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
56 </td>
57 <td class="function_name">
58 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-run" title="xapp_icon_chooser_dialog_run ()">xapp_icon_chooser_dialog_run</a> <span class="c_punctuation">()</span>
59 </td>
60 </tr>
61 <tr>
62 <td class="function_type">
63 <a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
64 </td>
65 <td class="function_name">
66 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-run-with-icon" title="xapp_icon_chooser_dialog_run_with_icon ()">xapp_icon_chooser_dialog_run_with_icon</a> <span class="c_punctuation">()</span>
67 </td>
68 </tr>
69 <tr>
70 <td class="function_type">
71 <a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
72 </td>
73 <td class="function_name">
74 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-run-with-category" title="xapp_icon_chooser_dialog_run_with_category ()">xapp_icon_chooser_dialog_run_with_category</a> <span class="c_punctuation">()</span>
75 </td>
76 </tr>
77 <tr>
78 <td class="function_type">
79 <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
80 </td>
81 <td class="function_name">
82 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-get-icon-string" title="xapp_icon_chooser_dialog_get_icon_string ()">xapp_icon_chooser_dialog_get_icon_string</a> <span class="c_punctuation">()</span>
83 </td>
84 </tr>
85 <tr>
86 <td class="function_type">
87 <span class="returnvalue">void</span>
88 </td>
89 <td class="function_name">
90 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-add-button" title="xapp_icon_chooser_dialog_add_button ()">xapp_icon_chooser_dialog_add_button</a> <span class="c_punctuation">()</span>
91 </td>
92 </tr>
93 <tr>
94 <td class="function_type">
95 <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
96 </td>
97 <td class="function_name">
98 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-get-default-icon" title="xapp_icon_chooser_dialog_get_default_icon ()">xapp_icon_chooser_dialog_get_default_icon</a> <span class="c_punctuation">()</span>
99 </td>
100 </tr>
101 <tr>
102 <td class="function_type">
103 <span class="returnvalue">void</span>
104 </td>
105 <td class="function_name">
106 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-set-default-icon" title="xapp_icon_chooser_dialog_set_default_icon ()">xapp_icon_chooser_dialog_set_default_icon</a> <span class="c_punctuation">()</span>
107 </td>
108 </tr>
109 <tr>
110 <td class="function_type">
111 <span class="returnvalue">void</span>
112 </td>
113 <td class="function_name">
114 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-add-custom-category" title="xapp_icon_chooser_dialog_add_custom_category ()">xapp_icon_chooser_dialog_add_custom_category</a> <span class="c_punctuation">()</span>
115 </td>
116 </tr>
117 </tbody>
118 </table></div>
119 </div>
120 <div class="refsect1">
121 <a name="XAppIconChooserDialog.properties"></a><h2>Properties</h2>
122 <div class="informaltable"><table class="informaltable" border="0">
123 <colgroup>
124 <col width="150px" class="properties_type">
125 <col width="300px" class="properties_name">
126 <col width="200px" class="properties_flags">
127 </colgroup>
128 <tbody>
129 <tr>
130 <td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
131 <td class="property_name"><a class="link" href="XAppIconChooserDialog.html#XAppIconChooserDialog--allow-paths" title="The “allow-paths” property">allow-paths</a></td>
132 <td class="property_flags">Read / Write</td>
133 </tr>
134 <tr>
135 <td class="property_type">
136 <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
137 <td class="property_name"><a class="link" href="XAppIconChooserDialog.html#XAppIconChooserDialog--default-icon" title="The “default-icon” property">default-icon</a></td>
138 <td class="property_flags">Read / Write</td>
139 </tr>
140 <tr>
141 <td class="property_type"><a class="link" href="XAppIconChooserDialog.html#XAppIconSize" title="enum XAppIconSize"><span class="type">XAppIconSize</span></a></td>
142 <td class="property_name"><a class="link" href="XAppIconChooserDialog.html#XAppIconChooserDialog--icon-size" title="The “icon-size” property">icon-size</a></td>
143 <td class="property_flags">Read / Write</td>
144 </tr>
145 </tbody>
146 </table></div>
147 </div>
148 <div class="refsect1">
149 <a name="XAppIconChooserDialog.signals"></a><h2>Signals</h2>
150 <div class="informaltable"><table class="informaltable" border="0">
151 <colgroup>
152 <col width="150px" class="signals_return">
153 <col width="300px" class="signals_name">
154 <col width="200px" class="signals_flags">
155 </colgroup>
156 <tbody>
157 <tr>
158 <td class="signal_type"><span class="returnvalue">void</span></td>
159 <td class="signal_name"><a class="link" href="XAppIconChooserDialog.html#XAppIconChooserDialog-close" title="The “close” signal">close</a></td>
160 <td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
161 </tr>
162 <tr>
163 <td class="signal_type"><span class="returnvalue">void</span></td>
164 <td class="signal_name"><a class="link" href="XAppIconChooserDialog.html#XAppIconChooserDialog-select" title="The “select” signal">select</a></td>
165 <td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
166 </tr>
167 </tbody>
168 </table></div>
169 </div>
170 <div class="refsect1">
171 <a name="XAppIconChooserDialog.other"></a><h2>Types and Values</h2>
172 <div class="informaltable"><table class="informaltable" width="100%" border="0">
173 <colgroup>
174 <col width="150px" class="name">
175 <col class="description">
176 </colgroup>
177 <tbody>
178 <tr>
179 <td class="define_keyword">#define</td>
180 <td class="function_name"><a class="link" href="XAppIconChooserDialog.html#XAPP-TYPE-ICON-CHOOSER-DIALOG:CAPS" title="XAPP_TYPE_ICON_CHOOSER_DIALOG">XAPP_TYPE_ICON_CHOOSER_DIALOG</a></td>
181 </tr>
182 <tr>
183 <td class="datatype_keyword">enum</td>
184 <td class="function_name"><a class="link" href="XAppIconChooserDialog.html#XAppIconSize" title="enum XAppIconSize">XAppIconSize</a></td>
185 </tr>
186 <tr>
187 <td class="datatype_keyword"> </td>
188 <td class="function_name"><a class="link" href="XAppIconChooserDialog.html#XAppIconChooserDialog-struct" title="XAppIconChooserDialog">XAppIconChooserDialog</a></td>
189 </tr>
190 </tbody>
191 </table></div>
192 </div>
193 <div class="refsect1">
194 <a name="XAppIconChooserDialog.object-hierarchy"></a><h2>Object Hierarchy</h2>
195 <pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html">GEnum</a>
196 <span class="lineart">╰──</span> XAppIconSize
197 <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
198 <span class="lineart">╰──</span> <a href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
199 <span class="lineart">╰──</span> <a href="../gtk3/GtkWidget.html#GtkWidget-struct">GtkWidget</a>
200 <span class="lineart">╰──</span> <a href="../gtk3/GtkContainer.html#GtkContainer-struct">GtkContainer</a>
201 <span class="lineart">╰──</span> <a href="../gtk3/GtkBin.html#GtkBin-struct">GtkBin</a>
202 <span class="lineart">╰──</span> <a href="../gtk3/GtkWindow.html#GtkWindow-struct">GtkWindow</a>
203 <span class="lineart">╰──</span> <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
204 <span class="lineart">╰──</span> XAppIconChooserDialog
205 </pre>
206 </div>
207 <div class="refsect1">
208 <a name="XAppIconChooserDialog.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
209 <p>
210 XAppIconChooserDialog implements
211 AtkImplementorIface and <a href="../gtk3/GtkBuildable.html#GtkBuildable-struct">GtkBuildable</a>.</p>
212 </div>
213 <div class="refsect1">
214 <a name="XAppIconChooserDialog.description"></a><h2>Description</h2>
215 <p>The XAppIconChooserDialog creates a dialog so that
216 the user can select an icon. It provides the ability
217 to browse by category, search by icon name, or select
218 from a specific file.</p>
219 </div>
220 <div class="refsect1">
221 <a name="XAppIconChooserDialog.functions_details"></a><h2>Functions</h2>
222 <div class="refsect2">
223 <a name="xapp-icon-chooser-dialog-new"></a><h3>xapp_icon_chooser_dialog_new ()</h3>
224 <pre class="programlisting"><a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="returnvalue">XAppIconChooserDialog</span></a> *
225 xapp_icon_chooser_dialog_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
226 <p>Creates a new <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a>.</p>
227 <div class="refsect3">
228 <a name="xapp-icon-chooser-dialog-new.returns"></a><h4>Returns</h4>
229 <p> a newly created <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a></p>
230 </div>
231 </div>
232 <hr>
233 <div class="refsect2">
234 <a name="xapp-icon-chooser-dialog-run"></a><h3>xapp_icon_chooser_dialog_run ()</h3>
235 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
236 xapp_icon_chooser_dialog_run (<em class="parameter"><code><a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a> *dialog</code></em>);</pre>
237 <p>Shows the dialog and enters a separate main loop until an icon is chosen or the action is canceled.</p>
238 <p>xapp_icon_chooser_dialog_run (), <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-run-with-icon" title="xapp_icon_chooser_dialog_run_with_icon ()"><code class="function">xapp_icon_chooser_dialog_run_with_icon()</code></a>, and
239 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-run-with-category" title="xapp_icon_chooser_dialog_run_with_category ()"><code class="function">xapp_icon_chooser_dialog_run_with_category()</code></a> may all be called multiple times. This is useful for
240 applications which use this dialog multiple times, as it may improve performance for subsequent
241 calls.</p>
242 <div class="refsect3">
243 <a name="xapp-icon-chooser-dialog-run.parameters"></a><h4>Parameters</h4>
244 <div class="informaltable"><table class="informaltable" width="100%" border="0">
245 <colgroup>
246 <col width="150px" class="parameters_name">
247 <col class="parameters_description">
248 <col width="200px" class="parameters_annotations">
249 </colgroup>
250 <tbody><tr>
251 <td class="parameter_name"><p>dialog</p></td>
252 <td class="parameter_description"><p>a <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a></p></td>
253 <td class="parameter_annotations"> </td>
254 </tr></tbody>
255 </table></div>
256 </div>
257 <div class="refsect3">
258 <a name="xapp-icon-chooser-dialog-run.returns"></a><h4>Returns</h4>
259 <p> GTK_RESPONSE_OK if the user selected an icon, or GTK_RESPONSE_CANCEL otherwise</p>
260 </div>
261 </div>
262 <hr>
263 <div class="refsect2">
264 <a name="xapp-icon-chooser-dialog-run-with-icon"></a><h3>xapp_icon_chooser_dialog_run_with_icon ()</h3>
265 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
266 xapp_icon_chooser_dialog_run_with_icon
267 (<em class="parameter"><code><a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a> *dialog</code></em>,
268 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon</code></em>);</pre>
269 <p>Like xapp_icon_chooser_dialog_run but selects the icon specified by <em class="parameter"><code>icon</code></em>
270 . This can be either an
271 icon name or a path. Passing an icon string or path that doesn't exist is accepted, but it may show
272 multiple results, or none at all. This behavior is useful if, for example, you wish to have the
273 user select an image file from a particular directory.</p>
274 <p>If the property allow_paths is FALSE, setting a path will yield no results when the dialog is opened.</p>
275 <p>xapp_icon_chooser_dialog_run (), <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-run-with-icon" title="xapp_icon_chooser_dialog_run_with_icon ()"><code class="function">xapp_icon_chooser_dialog_run_with_icon()</code></a>, and
276 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-run-with-category" title="xapp_icon_chooser_dialog_run_with_category ()"><code class="function">xapp_icon_chooser_dialog_run_with_category()</code></a> may all be called multiple times. This is useful for
277 applications which use this dialog multiple times, as it may improve performance for subsequent
278 calls.</p>
279 <div class="refsect3">
280 <a name="xapp-icon-chooser-dialog-run-with-icon.parameters"></a><h4>Parameters</h4>
281 <div class="informaltable"><table class="informaltable" width="100%" border="0">
282 <colgroup>
283 <col width="150px" class="parameters_name">
284 <col class="parameters_description">
285 <col width="200px" class="parameters_annotations">
286 </colgroup>
287 <tbody>
288 <tr>
289 <td class="parameter_name"><p>dialog</p></td>
290 <td class="parameter_description"><p>a <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a></p></td>
291 <td class="parameter_annotations"> </td>
292 </tr>
293 <tr>
294 <td class="parameter_name"><p>icon</p></td>
295 <td class="parameter_description"><p>a string representing the icon that should be selected</p></td>
296 <td class="parameter_annotations"> </td>
297 </tr>
298 </tbody>
299 </table></div>
300 </div>
301 <div class="refsect3">
302 <a name="xapp-icon-chooser-dialog-run-with-icon.returns"></a><h4>Returns</h4>
303 <p> GTK_RESPONSE_OK if the user selected an icon, or GTK_RESPONSE_CANCEL otherwise</p>
304 </div>
305 </div>
306 <hr>
307 <div class="refsect2">
308 <a name="xapp-icon-chooser-dialog-run-with-category"></a><h3>xapp_icon_chooser_dialog_run_with_category ()</h3>
309 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
310 xapp_icon_chooser_dialog_run_with_category
311 (<em class="parameter"><code><a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a> *dialog</code></em>,
312 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *category</code></em>);</pre>
313 <p>Like xapp_icon_chooser_dialog_run but selects a particular category specified by <em class="parameter"><code>category</code></em>
314 .
315 This is used when there is a particular category of icon that is more appropriate than the
316 others. If the category does not exist, the first category in the list will be selected. To
317 get a list of possible categories, use <a href="../gtk3/GtkIconTheme.html#gtk-icon-theme-list-contexts"><code class="function">gtk_icon_theme_list_contexts()</code></a>.</p>
318 <p>xapp_icon_chooser_dialog_run (), <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-run-with-icon" title="xapp_icon_chooser_dialog_run_with_icon ()"><code class="function">xapp_icon_chooser_dialog_run_with_icon()</code></a>, and
319 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-run-with-category" title="xapp_icon_chooser_dialog_run_with_category ()"><code class="function">xapp_icon_chooser_dialog_run_with_category()</code></a> may all be called multiple times. This is useful for
320 applications which use this dialog multiple times, as it may improve performance for subsequent
321 calls.</p>
322 <div class="refsect3">
323 <a name="xapp-icon-chooser-dialog-run-with-category.parameters"></a><h4>Parameters</h4>
324 <div class="informaltable"><table class="informaltable" width="100%" border="0">
325 <colgroup>
326 <col width="150px" class="parameters_name">
327 <col class="parameters_description">
328 <col width="200px" class="parameters_annotations">
329 </colgroup>
330 <tbody><tr>
331 <td class="parameter_name"><p>dialog</p></td>
332 <td class="parameter_description"><p>a <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a></p></td>
333 <td class="parameter_annotations"> </td>
334 </tr></tbody>
335 </table></div>
336 </div>
337 <div class="refsect3">
338 <a name="xapp-icon-chooser-dialog-run-with-category.returns"></a><h4>Returns</h4>
339 <p> GTK_RESPONSE_OK if the user selected an icon, or GTK_RESPONSE_CANCEL otherwise</p>
340 </div>
341 </div>
342 <hr>
343 <div class="refsect2">
344 <a name="xapp-icon-chooser-dialog-get-icon-string"></a><h3>xapp_icon_chooser_dialog_get_icon_string ()</h3>
345 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
346 xapp_icon_chooser_dialog_get_icon_string
347 (<em class="parameter"><code><a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a> *dialog</code></em>);</pre>
348 <p>Gets the currently selected icon from the dialog. If allow-paths is TRUE, this function may return
349 either an icon name or a path depending on what the user selects. Otherwise it will only return an
350 icon name.</p>
351 <div class="refsect3">
352 <a name="xapp-icon-chooser-dialog-get-icon-string.parameters"></a><h4>Parameters</h4>
353 <div class="informaltable"><table class="informaltable" width="100%" border="0">
354 <colgroup>
355 <col width="150px" class="parameters_name">
356 <col class="parameters_description">
357 <col width="200px" class="parameters_annotations">
358 </colgroup>
359 <tbody><tr>
360 <td class="parameter_name"><p>dialog</p></td>
361 <td class="parameter_description"><p>a <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a></p></td>
362 <td class="parameter_annotations"> </td>
363 </tr></tbody>
364 </table></div>
365 </div>
366 <div class="refsect3">
367 <a name="xapp-icon-chooser-dialog-get-icon-string.returns"></a><h4>Returns</h4>
368 <p>the string representation of the currently selected icon or NULL
369 if no icon is selected. </p>
370 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
371 </div>
372 </div>
373 <hr>
374 <div class="refsect2">
375 <a name="xapp-icon-chooser-dialog-add-button"></a><h3>xapp_icon_chooser_dialog_add_button ()</h3>
376 <pre class="programlisting"><span class="returnvalue">void</span>
377 xapp_icon_chooser_dialog_add_button (<em class="parameter"><code><a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a> *dialog</code></em>,
378 <em class="parameter"><code><a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> *button</code></em>,
379 <em class="parameter"><code><a href="../gtk3/gtk3-Standard-Enumerations.html#GtkPackType"><span class="type">GtkPackType</span></a> packing</code></em>,
380 <em class="parameter"><code><a href="../gtk3/GtkDialog.html#GtkResponseType"><span class="type">GtkResponseType</span></a> response_id</code></em>);</pre>
381 <p>Allows a button to be added to the <a href="../gtk3/GtkActionBar.html#GtkActionBar-struct"><span class="type">GtkActionBar</span></a> of the dialog with a custom
382 response id.</p>
383 <div class="refsect3">
384 <a name="xapp-icon-chooser-dialog-add-button.parameters"></a><h4>Parameters</h4>
385 <div class="informaltable"><table class="informaltable" width="100%" border="0">
386 <colgroup>
387 <col width="150px" class="parameters_name">
388 <col class="parameters_description">
389 <col width="200px" class="parameters_annotations">
390 </colgroup>
391 <tbody>
392 <tr>
393 <td class="parameter_name"><p>dialog</p></td>
394 <td class="parameter_description"><p>an <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a></p></td>
395 <td class="parameter_annotations"> </td>
396 </tr>
397 <tr>
398 <td class="parameter_name"><p>button</p></td>
399 <td class="parameter_description"><p>a <a href="../gtk3/GtkButton.html#GtkButton-struct"><span class="type">GtkButton</span></a> to add</p></td>
400 <td class="parameter_annotations"> </td>
401 </tr>
402 <tr>
403 <td class="parameter_name"><p>packing</p></td>
404 <td class="parameter_description"><p>the <a href="../gtk3/gtk3-Standard-Enumerations.html#GtkPackType"><span class="type">GtkPackType</span></a> to specify start or end packing to the action bar</p></td>
405 <td class="parameter_annotations"> </td>
406 </tr>
407 <tr>
408 <td class="parameter_name"><p>response_id</p></td>
409 <td class="parameter_description"><p>the dialog response id to return when this button is clicked.</p></td>
410 <td class="parameter_annotations"> </td>
411 </tr>
412 </tbody>
413 </table></div>
414 </div>
415 </div>
416 <hr>
417 <div class="refsect2">
418 <a name="xapp-icon-chooser-dialog-get-default-icon"></a><h3>xapp_icon_chooser_dialog_get_default_icon ()</h3>
419 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
420 xapp_icon_chooser_dialog_get_default_icon
421 (<em class="parameter"><code><a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a> *dialog</code></em>);</pre>
422 <p>Returns the default icon (if set).</p>
423 <div class="refsect3">
424 <a name="xapp-icon-chooser-dialog-get-default-icon.returns"></a><h4>Returns</h4>
425 <p>the default icon, or NULL if none is set. </p>
426 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
427 </div>
428 </div>
429 <hr>
430 <div class="refsect2">
431 <a name="xapp-icon-chooser-dialog-set-default-icon"></a><h3>xapp_icon_chooser_dialog_set_default_icon ()</h3>
432 <pre class="programlisting"><span class="returnvalue">void</span>
433 xapp_icon_chooser_dialog_set_default_icon
434 (<em class="parameter"><code><a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a> *dialog</code></em>,
435 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon</code></em>);</pre>
436 <p>Sets the default icon. If <em class="parameter"><code>icon</code></em>
437 is not NULL, a button will be shown that
438 will reset the dialog to it's default value.</p>
439 <div class="refsect3">
440 <a name="xapp-icon-chooser-dialog-set-default-icon.parameters"></a><h4>Parameters</h4>
441 <div class="informaltable"><table class="informaltable" width="100%" border="0">
442 <colgroup>
443 <col width="150px" class="parameters_name">
444 <col class="parameters_description">
445 <col width="200px" class="parameters_annotations">
446 </colgroup>
447 <tbody><tr>
448 <td class="parameter_name"><p>icon</p></td>
449 <td class="parameter_description"><p>the default icon, or NULL to unset</p></td>
450 <td class="parameter_annotations"> </td>
451 </tr></tbody>
452 </table></div>
453 </div>
454 </div>
455 <hr>
456 <div class="refsect2">
457 <a name="xapp-icon-chooser-dialog-add-custom-category"></a><h3>xapp_icon_chooser_dialog_add_custom_category ()</h3>
458 <pre class="programlisting"><span class="returnvalue">void</span>
459 xapp_icon_chooser_dialog_add_custom_category
460 (<em class="parameter"><code><a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a> *dialog</code></em>,
461 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
462 <em class="parameter"><code><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *icons</code></em>);</pre>
463 <p>Adds a custom category to the dialog.</p>
464 <div class="refsect3">
465 <a name="xapp-icon-chooser-dialog-add-custom-category.parameters"></a><h4>Parameters</h4>
466 <div class="informaltable"><table class="informaltable" width="100%" border="0">
467 <colgroup>
468 <col width="150px" class="parameters_name">
469 <col class="parameters_description">
470 <col width="200px" class="parameters_annotations">
471 </colgroup>
472 <tbody>
473 <tr>
474 <td class="parameter_name"><p>dialog</p></td>
475 <td class="parameter_description"><p>a <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a></p></td>
476 <td class="parameter_annotations"> </td>
477 </tr>
478 <tr>
479 <td class="parameter_name"><p>name</p></td>
480 <td class="parameter_description"><p>the name of the category as it will be displayed in the category list</p></td>
481 <td class="parameter_annotations"> </td>
482 </tr>
483 <tr>
484 <td class="parameter_name"><p>icons</p></td>
485 <td class="parameter_description"><p>a list of icon names to add to the new category. </p></td>
486 <td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span></td>
487 </tr>
488 </tbody>
489 </table></div>
490 </div>
491 </div>
492 </div>
493 <div class="refsect1">
494 <a name="XAppIconChooserDialog.other_details"></a><h2>Types and Values</h2>
495 <div class="refsect2">
496 <a name="XAPP-TYPE-ICON-CHOOSER-DIALOG:CAPS"></a><h3>XAPP_TYPE_ICON_CHOOSER_DIALOG</h3>
497 <pre class="programlisting">#define XAPP_TYPE_ICON_CHOOSER_DIALOG (xapp_icon_chooser_dialog_get_type ())
498 </pre>
499 </div>
500 <hr>
501 <div class="refsect2">
502 <a name="XAppIconSize"></a><h3>enum XAppIconSize</h3>
503 <div class="refsect3">
504 <a name="XAppIconSize.members"></a><h4>Members</h4>
505 <div class="informaltable"><table class="informaltable" width="100%" border="0">
506 <colgroup>
507 <col width="300px" class="enum_members_name">
508 <col class="enum_members_description">
509 <col width="200px" class="enum_members_annotations">
510 </colgroup>
511 <tbody>
512 <tr>
513 <td class="enum_member_name"><p><a name="XAPP-ICON-SIZE-16:CAPS"></a>XAPP_ICON_SIZE_16</p></td>
514 <td> </td>
515 <td> </td>
516 </tr>
517 <tr>
518 <td class="enum_member_name"><p><a name="XAPP-ICON-SIZE-22:CAPS"></a>XAPP_ICON_SIZE_22</p></td>
519 <td> </td>
520 <td> </td>
521 </tr>
522 <tr>
523 <td class="enum_member_name"><p><a name="XAPP-ICON-SIZE-24:CAPS"></a>XAPP_ICON_SIZE_24</p></td>
524 <td> </td>
525 <td> </td>
526 </tr>
527 <tr>
528 <td class="enum_member_name"><p><a name="XAPP-ICON-SIZE-32:CAPS"></a>XAPP_ICON_SIZE_32</p></td>
529 <td> </td>
530 <td> </td>
531 </tr>
532 <tr>
533 <td class="enum_member_name"><p><a name="XAPP-ICON-SIZE-48:CAPS"></a>XAPP_ICON_SIZE_48</p></td>
534 <td> </td>
535 <td> </td>
536 </tr>
537 <tr>
538 <td class="enum_member_name"><p><a name="XAPP-ICON-SIZE-96:CAPS"></a>XAPP_ICON_SIZE_96</p></td>
539 <td> </td>
540 <td> </td>
541 </tr>
542 </tbody>
543 </table></div>
544 </div>
545 </div>
546 <hr>
547 <div class="refsect2">
548 <a name="XAppIconChooserDialog-struct"></a><h3>XAppIconChooserDialog</h3>
549 <pre class="programlisting">typedef struct _XAppIconChooserDialog XAppIconChooserDialog;</pre>
550 </div>
551 </div>
552 <div class="refsect1">
553 <a name="XAppIconChooserDialog.property-details"></a><h2>Property Details</h2>
554 <div class="refsect2">
555 <a name="XAppIconChooserDialog--allow-paths"></a><h3>The <code class="literal">“allow-paths”</code> property</h3>
556 <pre class="programlisting"> “allow-paths” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
557 <p>Whether to allow paths to be searched and selected or only icon names.</p>
558 <p>Flags: Read / Write</p>
559 <p>Default value: TRUE</p>
560 </div>
561 <hr>
562 <div class="refsect2">
563 <a name="XAppIconChooserDialog--default-icon"></a><h3>The <code class="literal">“default-icon”</code> property</h3>
564 <pre class="programlisting"> “default-icon” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
565 <p>The icon to use by default.</p>
566 <p>Flags: Read / Write</p>
567 <p>Default value: NULL</p>
568 </div>
569 <hr>
570 <div class="refsect2">
571 <a name="XAppIconChooserDialog--icon-size"></a><h3>The <code class="literal">“icon-size”</code> property</h3>
572 <pre class="programlisting"> “icon-size” <a class="link" href="XAppIconChooserDialog.html#XAppIconSize" title="enum XAppIconSize"><span class="type">XAppIconSize</span></a></pre>
573 <p>The preferred size to use when looking up icons. This only works with icon names.
574 Additionally, there is no guarantee that a selected icon name will exist in a
575 particular size.</p>
576 <p>Flags: Read / Write</p>
577 <p>Default value: XAPP_ICON_SIZE_32</p>
578 </div>
579 </div>
580 <div class="refsect1">
581 <a name="XAppIconChooserDialog.signal-details"></a><h2>Signal Details</h2>
582 <div class="refsect2">
583 <a name="XAppIconChooserDialog-close"></a><h3>The <code class="literal">“close”</code> signal</h3>
584 <pre class="programlisting"><span class="returnvalue">void</span>
585 user_function (<a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a> *xappiconchooserdialog,
586 <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
587 <p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
588 </div>
589 <hr>
590 <div class="refsect2">
591 <a name="XAppIconChooserDialog-select"></a><h3>The <code class="literal">“select”</code> signal</h3>
592 <pre class="programlisting"><span class="returnvalue">void</span>
593 user_function (<a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog"><span class="type">XAppIconChooserDialog</span></a> *xappiconchooserdialog,
594 <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
595 <p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
596 </div>
597 </div>
598 </div>
599 <div class="footer">
600 <hr>Generated by GTK-Doc V1.27</div>
601 </body>
602 </html>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>XAppKbdLayoutController: XApp Reference Manual</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
6 <link rel="home" href="index.html" title="XApp Reference Manual">
7 <link rel="up" href="ch01.html" title="API reference">
8 <link rel="prev" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">
9 <link rel="next" href="XAppMonitorBlanker.html" title="XAppMonitorBlanker">
10 <meta name="generator" content="GTK-Doc V1.27 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 </head>
13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
15 <td width="100%" align="left" class="shortcuts">
16 <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
17 <a href="#XAppKbdLayoutController.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
18 <a href="#XAppKbdLayoutController.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties">  <span class="dim">|</span> 
19 <a href="#XAppKbdLayoutController.properties" class="shortcut">Properties</a></span><span id="nav_signals">  <span class="dim">|</span> 
20 <a href="#XAppKbdLayoutController.signals" class="shortcut">Signals</a></span>
21 </td>
22 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
23 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
24 <td><a accesskey="p" href="XAppIconChooserDialog.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
25 <td><a accesskey="n" href="XAppMonitorBlanker.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
26 </tr></table>
27 <div class="refentry">
28 <a name="XAppKbdLayoutController"></a><div class="titlepage"></div>
29 <div class="refnamediv"><table width="100%"><tr>
30 <td valign="top">
31 <h2><span class="refentrytitle"><a name="XAppKbdLayoutController.top_of_page"></a>XAppKbdLayoutController</span></h2>
32 <p>XAppKbdLayoutController — Keyboard layout selection UI element provider.</p>
33 </td>
34 <td class="gallery_image" valign="top" align="right"></td>
35 </tr></table></div>
36 <div class="refsect1">
37 <a name="XAppKbdLayoutController.functions"></a><h2>Functions</h2>
38 <div class="informaltable"><table class="informaltable" width="100%" border="0">
39 <colgroup>
40 <col width="150px" class="functions_return">
41 <col class="functions_name">
42 </colgroup>
43 <tbody>
44 <tr>
45 <td class="function_type">
46 <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="returnvalue">XAppKbdLayoutController</span></a> *
47 </td>
48 <td class="function_name">
49 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-new" title="xapp_kbd_layout_controller_new ()">xapp_kbd_layout_controller_new</a> <span class="c_punctuation">()</span>
50 </td>
51 </tr>
52 <tr>
53 <td class="function_type">
54 <a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
55 </td>
56 <td class="function_name">
57 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-enabled" title="xapp_kbd_layout_controller_get_enabled ()">xapp_kbd_layout_controller_get_enabled</a> <span class="c_punctuation">()</span>
58 </td>
59 </tr>
60 <tr>
61 <td class="function_type">
62 <a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
63 </td>
64 <td class="function_name">
65 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-group" title="xapp_kbd_layout_controller_get_current_group ()">xapp_kbd_layout_controller_get_current_group</a> <span class="c_punctuation">()</span>
66 </td>
67 </tr>
68 <tr>
69 <td class="function_type">
70 <span class="returnvalue">void</span>
71 </td>
72 <td class="function_name">
73 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-set-current-group" title="xapp_kbd_layout_controller_set_current_group ()">xapp_kbd_layout_controller_set_current_group</a> <span class="c_punctuation">()</span>
74 </td>
75 </tr>
76 <tr>
77 <td class="function_type">
78 <span class="returnvalue">void</span>
79 </td>
80 <td class="function_name">
81 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-next-group" title="xapp_kbd_layout_controller_next_group ()">xapp_kbd_layout_controller_next_group</a> <span class="c_punctuation">()</span>
82 </td>
83 </tr>
84 <tr>
85 <td class="function_type">
86 <span class="returnvalue">void</span>
87 </td>
88 <td class="function_name">
89 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-previous-group" title="xapp_kbd_layout_controller_previous_group ()">xapp_kbd_layout_controller_previous_group</a> <span class="c_punctuation">()</span>
90 </td>
91 </tr>
92 <tr>
93 <td class="function_type">
94 <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
95 </td>
96 <td class="function_name">
97 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-name" title="xapp_kbd_layout_controller_get_current_name ()">xapp_kbd_layout_controller_get_current_name</a> <span class="c_punctuation">()</span>
98 </td>
99 </tr>
100 <tr>
101 <td class="function_type">
102 <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
103 </td>
104 <td class="function_name">
105 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-all-names" title="xapp_kbd_layout_controller_get_all_names ()">xapp_kbd_layout_controller_get_all_names</a> <span class="c_punctuation">()</span>
106 </td>
107 </tr>
108 <tr>
109 <td class="function_type">
110 <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
111 </td>
112 <td class="function_name">
113 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-icon-name" title="xapp_kbd_layout_controller_get_current_icon_name ()">xapp_kbd_layout_controller_get_current_icon_name</a> <span class="c_punctuation">()</span>
114 </td>
115 </tr>
116 <tr>
117 <td class="function_type">
118 <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
119 </td>
120 <td class="function_name">
121 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-icon-name-for-group" title="xapp_kbd_layout_controller_get_icon_name_for_group ()">xapp_kbd_layout_controller_get_icon_name_for_group</a> <span class="c_punctuation">()</span>
122 </td>
123 </tr>
124 <tr>
125 <td class="function_type">
126 <a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
127 </td>
128 <td class="function_name">
129 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-flag-id" title="xapp_kbd_layout_controller_get_current_flag_id ()">xapp_kbd_layout_controller_get_current_flag_id</a> <span class="c_punctuation">()</span>
130 </td>
131 </tr>
132 <tr>
133 <td class="function_type">
134 <a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
135 </td>
136 <td class="function_name">
137 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-flag-id-for-group" title="xapp_kbd_layout_controller_get_flag_id_for_group ()">xapp_kbd_layout_controller_get_flag_id_for_group</a> <span class="c_punctuation">()</span>
138 </td>
139 </tr>
140 <tr>
141 <td class="function_type">
142 <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
143 </td>
144 <td class="function_name">
145 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-short-group-label" title="xapp_kbd_layout_controller_get_current_short_group_label ()">xapp_kbd_layout_controller_get_current_short_group_label</a> <span class="c_punctuation">()</span>
146 </td>
147 </tr>
148 <tr>
149 <td class="function_type">
150 <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
151 </td>
152 <td class="function_name">
153 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-short-group-label-for-group" title="xapp_kbd_layout_controller_get_short_group_label_for_group ()">xapp_kbd_layout_controller_get_short_group_label_for_group</a> <span class="c_punctuation">()</span>
154 </td>
155 </tr>
156 <tr>
157 <td class="function_type">
158 <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
159 </td>
160 <td class="function_name">
161 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-variant-label" title="xapp_kbd_layout_controller_get_current_variant_label ()">xapp_kbd_layout_controller_get_current_variant_label</a> <span class="c_punctuation">()</span>
162 </td>
163 </tr>
164 <tr>
165 <td class="function_type">
166 <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
167 </td>
168 <td class="function_name">
169 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-variant-label-for-group" title="xapp_kbd_layout_controller_get_variant_label_for_group ()">xapp_kbd_layout_controller_get_variant_label_for_group</a> <span class="c_punctuation">()</span>
170 </td>
171 </tr>
172 <tr>
173 <td class="function_type">
174 <span class="returnvalue">void</span>
175 </td>
176 <td class="function_name">
177 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-render-cairo-subscript" title="xapp_kbd_layout_controller_render_cairo_subscript ()">xapp_kbd_layout_controller_render_cairo_subscript</a> <span class="c_punctuation">()</span>
178 </td>
179 </tr>
180 </tbody>
181 </table></div>
182 </div>
183 <div class="refsect1">
184 <a name="XAppKbdLayoutController.properties"></a><h2>Properties</h2>
185 <div class="informaltable"><table class="informaltable" border="0">
186 <colgroup>
187 <col width="150px" class="properties_type">
188 <col width="300px" class="properties_name">
189 <col width="200px" class="properties_flags">
190 </colgroup>
191 <tbody><tr>
192 <td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
193 <td class="property_name"><a class="link" href="XAppKbdLayoutController.html#XAppKbdLayoutController--enabled" title="The “enabled” property">enabled</a></td>
194 <td class="property_flags">Read</td>
195 </tr></tbody>
196 </table></div>
197 </div>
198 <div class="refsect1">
199 <a name="XAppKbdLayoutController.signals"></a><h2>Signals</h2>
200 <div class="informaltable"><table class="informaltable" border="0">
201 <colgroup>
202 <col width="150px" class="signals_return">
203 <col width="300px" class="signals_name">
204 <col width="200px" class="signals_flags">
205 </colgroup>
206 <tbody>
207 <tr>
208 <td class="signal_type"><span class="returnvalue">void</span></td>
209 <td class="signal_name"><a class="link" href="XAppKbdLayoutController.html#XAppKbdLayoutController-config-changed" title="The “config-changed” signal">config-changed</a></td>
210 <td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
211 </tr>
212 <tr>
213 <td class="signal_type"><span class="returnvalue">void</span></td>
214 <td class="signal_name"><a class="link" href="XAppKbdLayoutController.html#XAppKbdLayoutController-layout-changed" title="The “layout-changed” signal">layout-changed</a></td>
215 <td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
216 </tr>
217 </tbody>
218 </table></div>
219 </div>
220 <div class="refsect1">
221 <a name="XAppKbdLayoutController.object-hierarchy"></a><h2>Object Hierarchy</h2>
222 <pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
223 <span class="lineart">╰──</span> XAppKbdLayoutController
224 </pre>
225 </div>
226 <div class="refsect1">
227 <a name="XAppKbdLayoutController.description"></a><h2>Description</h2>
228 <p>A GObject wrapper for Gkbd that provides additional UI element
229 support for keyboard layout flags and abbreviations, as well as
230 Wfacilities to distinguish regional and hardware-based variants
231 which might otherwise appear identical in a layout list.</p>
232 </div>
233 <div class="refsect1">
234 <a name="XAppKbdLayoutController.functions_details"></a><h2>Functions</h2>
235 <div class="refsect2">
236 <a name="xapp-kbd-layout-controller-new"></a><h3>xapp_kbd_layout_controller_new ()</h3>
237 <pre class="programlisting"><a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="returnvalue">XAppKbdLayoutController</span></a> *
238 xapp_kbd_layout_controller_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
239 <p>Creates a new XAppKbdLayoutController instance.</p>
240 <div class="refsect3">
241 <a name="xapp-kbd-layout-controller-new.returns"></a><h4>Returns</h4>
242 <p>a new <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> instance. </p>
243 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
244 </div>
245 </div>
246 <hr>
247 <div class="refsect2">
248 <a name="xapp-kbd-layout-controller-get-enabled"></a><h3>xapp_kbd_layout_controller_get_enabled ()</h3>
249 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
250 xapp_kbd_layout_controller_get_enabled
251 (<em class="parameter"><code><a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> *controller</code></em>);</pre>
252 <p>Returns whether or not the layout controller is enabled</p>
253 <div class="refsect3">
254 <a name="xapp-kbd-layout-controller-get-enabled.parameters"></a><h4>Parameters</h4>
255 <div class="informaltable"><table class="informaltable" width="100%" border="0">
256 <colgroup>
257 <col width="150px" class="parameters_name">
258 <col class="parameters_description">
259 <col width="200px" class="parameters_annotations">
260 </colgroup>
261 <tbody><tr>
262 <td class="parameter_name"><p>controller</p></td>
263 <td class="parameter_description"><p>the <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a></p></td>
264 <td class="parameter_annotations"> </td>
265 </tr></tbody>
266 </table></div>
267 </div>
268 </div>
269 <hr>
270 <div class="refsect2">
271 <a name="xapp-kbd-layout-controller-get-current-group"></a><h3>xapp_kbd_layout_controller_get_current_group ()</h3>
272 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
273 xapp_kbd_layout_controller_get_current_group
274 (<em class="parameter"><code><a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> *controller</code></em>);</pre>
275 <p>Selects the previous group in the group list.</p>
276 <div class="refsect3">
277 <a name="xapp-kbd-layout-controller-get-current-group.parameters"></a><h4>Parameters</h4>
278 <div class="informaltable"><table class="informaltable" width="100%" border="0">
279 <colgroup>
280 <col width="150px" class="parameters_name">
281 <col class="parameters_description">
282 <col width="200px" class="parameters_annotations">
283 </colgroup>
284 <tbody><tr>
285 <td class="parameter_name"><p>controller</p></td>
286 <td class="parameter_description"><p>the <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a></p></td>
287 <td class="parameter_annotations"> </td>
288 </tr></tbody>
289 </table></div>
290 </div>
291 </div>
292 <hr>
293 <div class="refsect2">
294 <a name="xapp-kbd-layout-controller-set-current-group"></a><h3>xapp_kbd_layout_controller_set_current_group ()</h3>
295 <pre class="programlisting"><span class="returnvalue">void</span>
296 xapp_kbd_layout_controller_set_current_group
297 (<em class="parameter"><code><a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> *controller</code></em>,
298 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> group</code></em>);</pre>
299 <p>Selects the given group number as active.</p>
300 <div class="refsect3">
301 <a name="xapp-kbd-layout-controller-set-current-group.parameters"></a><h4>Parameters</h4>
302 <div class="informaltable"><table class="informaltable" width="100%" border="0">
303 <colgroup>
304 <col width="150px" class="parameters_name">
305 <col class="parameters_description">
306 <col width="200px" class="parameters_annotations">
307 </colgroup>
308 <tbody>
309 <tr>
310 <td class="parameter_name"><p>controller</p></td>
311 <td class="parameter_description"><p>the <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a></p></td>
312 <td class="parameter_annotations"> </td>
313 </tr>
314 <tr>
315 <td class="parameter_name"><p>group</p></td>
316 <td class="parameter_description"><p>the group number to make active</p></td>
317 <td class="parameter_annotations"> </td>
318 </tr>
319 </tbody>
320 </table></div>
321 </div>
322 </div>
323 <hr>
324 <div class="refsect2">
325 <a name="xapp-kbd-layout-controller-next-group"></a><h3>xapp_kbd_layout_controller_next_group ()</h3>
326 <pre class="programlisting"><span class="returnvalue">void</span>
327 xapp_kbd_layout_controller_next_group (<em class="parameter"><code><a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> *controller</code></em>);</pre>
328 <p>Selects the next group in the group list.</p>
329 <div class="refsect3">
330 <a name="xapp-kbd-layout-controller-next-group.parameters"></a><h4>Parameters</h4>
331 <div class="informaltable"><table class="informaltable" width="100%" border="0">
332 <colgroup>
333 <col width="150px" class="parameters_name">
334 <col class="parameters_description">
335 <col width="200px" class="parameters_annotations">
336 </colgroup>
337 <tbody><tr>
338 <td class="parameter_name"><p>controller</p></td>
339 <td class="parameter_description"><p>the <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a></p></td>
340 <td class="parameter_annotations"> </td>
341 </tr></tbody>
342 </table></div>
343 </div>
344 </div>
345 <hr>
346 <div class="refsect2">
347 <a name="xapp-kbd-layout-controller-previous-group"></a><h3>xapp_kbd_layout_controller_previous_group ()</h3>
348 <pre class="programlisting"><span class="returnvalue">void</span>
349 xapp_kbd_layout_controller_previous_group
350 (<em class="parameter"><code><a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> *controller</code></em>);</pre>
351 <p>Selects the previous group in the group list.</p>
352 <div class="refsect3">
353 <a name="xapp-kbd-layout-controller-previous-group.parameters"></a><h4>Parameters</h4>
354 <div class="informaltable"><table class="informaltable" width="100%" border="0">
355 <colgroup>
356 <col width="150px" class="parameters_name">
357 <col class="parameters_description">
358 <col width="200px" class="parameters_annotations">
359 </colgroup>
360 <tbody><tr>
361 <td class="parameter_name"><p>controller</p></td>
362 <td class="parameter_description"><p>the <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a></p></td>
363 <td class="parameter_annotations"> </td>
364 </tr></tbody>
365 </table></div>
366 </div>
367 </div>
368 <hr>
369 <div class="refsect2">
370 <a name="xapp-kbd-layout-controller-get-current-name"></a><h3>xapp_kbd_layout_controller_get_current_name ()</h3>
371 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
372 xapp_kbd_layout_controller_get_current_name
373 (<em class="parameter"><code><a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> *controller</code></em>);</pre>
374 <p>Returns the full name of the current keyboard layout.</p>
375 <div class="refsect3">
376 <a name="xapp-kbd-layout-controller-get-current-name.parameters"></a><h4>Parameters</h4>
377 <div class="informaltable"><table class="informaltable" width="100%" border="0">
378 <colgroup>
379 <col width="150px" class="parameters_name">
380 <col class="parameters_description">
381 <col width="200px" class="parameters_annotations">
382 </colgroup>
383 <tbody><tr>
384 <td class="parameter_name"><p>controller</p></td>
385 <td class="parameter_description"><p>the <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a></p></td>
386 <td class="parameter_annotations"> </td>
387 </tr></tbody>
388 </table></div>
389 </div>
390 <div class="refsect3">
391 <a name="xapp-kbd-layout-controller-get-current-name.returns"></a><h4>Returns</h4>
392 <p>the newly created string or NULL
393 if something went wrong. </p>
394 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
395 </div>
396 </div>
397 <hr>
398 <div class="refsect2">
399 <a name="xapp-kbd-layout-controller-get-all-names"></a><h3>xapp_kbd_layout_controller_get_all_names ()</h3>
400 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
401 xapp_kbd_layout_controller_get_all_names
402 (<em class="parameter"><code><a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> *controller</code></em>);</pre>
403 <p>Returns an array of all full layout names</p>
404 <div class="refsect3">
405 <a name="xapp-kbd-layout-controller-get-all-names.parameters"></a><h4>Parameters</h4>
406 <div class="informaltable"><table class="informaltable" width="100%" border="0">
407 <colgroup>
408 <col width="150px" class="parameters_name">
409 <col class="parameters_description">
410 <col width="200px" class="parameters_annotations">
411 </colgroup>
412 <tbody><tr>
413 <td class="parameter_name"><p>controller</p></td>
414 <td class="parameter_description"><p>the <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a></p></td>
415 <td class="parameter_annotations"> </td>
416 </tr></tbody>
417 </table></div>
418 </div>
419 <div class="refsect3">
420 <a name="xapp-kbd-layout-controller-get-all-names.returns"></a><h4>Returns</h4>
421 <p>array of names. </p>
422 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></p>
423 </div>
424 </div>
425 <hr>
426 <div class="refsect2">
427 <a name="xapp-kbd-layout-controller-get-current-icon-name"></a><h3>xapp_kbd_layout_controller_get_current_icon_name ()</h3>
428 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
429 xapp_kbd_layout_controller_get_current_icon_name
430 (<em class="parameter"><code><a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> *controller</code></em>);</pre>
431 <p>Returns the icon file name (no path or extension) to use for the current layout</p>
432 <div class="refsect3">
433 <a name="xapp-kbd-layout-controller-get-current-icon-name.parameters"></a><h4>Parameters</h4>
434 <div class="informaltable"><table class="informaltable" width="100%" border="0">
435 <colgroup>
436 <col width="150px" class="parameters_name">
437 <col class="parameters_description">
438 <col width="200px" class="parameters_annotations">
439 </colgroup>
440 <tbody><tr>
441 <td class="parameter_name"><p>controller</p></td>
442 <td class="parameter_description"><p>the <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a></p></td>
443 <td class="parameter_annotations"> </td>
444 </tr></tbody>
445 </table></div>
446 </div>
447 <div class="refsect3">
448 <a name="xapp-kbd-layout-controller-get-current-icon-name.returns"></a><h4>Returns</h4>
449 <p>a new string with the icon name. </p>
450 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
451 </div>
452 </div>
453 <hr>
454 <div class="refsect2">
455 <a name="xapp-kbd-layout-controller-get-icon-name-for-group"></a><h3>xapp_kbd_layout_controller_get_icon_name_for_group ()</h3>
456 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
457 xapp_kbd_layout_controller_get_icon_name_for_group
458 (<em class="parameter"><code><a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> *controller</code></em>,
459 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> group</code></em>);</pre>
460 <p>Returns the icon file name (no path or extension) to use for the specified layout.</p>
461 <div class="refsect3">
462 <a name="xapp-kbd-layout-controller-get-icon-name-for-group.parameters"></a><h4>Parameters</h4>
463 <div class="informaltable"><table class="informaltable" width="100%" border="0">
464 <colgroup>
465 <col width="150px" class="parameters_name">
466 <col class="parameters_description">
467 <col width="200px" class="parameters_annotations">
468 </colgroup>
469 <tbody>
470 <tr>
471 <td class="parameter_name"><p>controller</p></td>
472 <td class="parameter_description"><p>the <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a></p></td>
473 <td class="parameter_annotations"> </td>
474 </tr>
475 <tr>
476 <td class="parameter_name"><p>group</p></td>
477 <td class="parameter_description"><p>a group number</p></td>
478 <td class="parameter_annotations"> </td>
479 </tr>
480 </tbody>
481 </table></div>
482 </div>
483 <div class="refsect3">
484 <a name="xapp-kbd-layout-controller-get-icon-name-for-group.returns"></a><h4>Returns</h4>
485 <p>a new string with the icon name. </p>
486 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
487 </div>
488 </div>
489 <hr>
490 <div class="refsect2">
491 <a name="xapp-kbd-layout-controller-get-current-flag-id"></a><h3>xapp_kbd_layout_controller_get_current_flag_id ()</h3>
492 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
493 xapp_kbd_layout_controller_get_current_flag_id
494 (<em class="parameter"><code><a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> *controller</code></em>);</pre>
495 <p>Returns the duplicate id for the current layout</p>
496 <div class="refsect3">
497 <a name="xapp-kbd-layout-controller-get-current-flag-id.parameters"></a><h4>Parameters</h4>
498 <div class="informaltable"><table class="informaltable" width="100%" border="0">
499 <colgroup>
500 <col width="150px" class="parameters_name">
501 <col class="parameters_description">
502 <col width="200px" class="parameters_annotations">
503 </colgroup>
504 <tbody><tr>
505 <td class="parameter_name"><p>controller</p></td>
506 <td class="parameter_description"><p>the <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a></p></td>
507 <td class="parameter_annotations"> </td>
508 </tr></tbody>
509 </table></div>
510 </div>
511 <div class="refsect3">
512 <a name="xapp-kbd-layout-controller-get-current-flag-id.returns"></a><h4>Returns</h4>
513 <p> the id</p>
514 </div>
515 </div>
516 <hr>
517 <div class="refsect2">
518 <a name="xapp-kbd-layout-controller-get-flag-id-for-group"></a><h3>xapp_kbd_layout_controller_get_flag_id_for_group ()</h3>
519 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
520 xapp_kbd_layout_controller_get_flag_id_for_group
521 (<em class="parameter"><code><a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> *controller</code></em>,
522 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> group</code></em>);</pre>
523 </div>
524 <hr>
525 <div class="refsect2">
526 <a name="xapp-kbd-layout-controller-get-current-short-group-label"></a><h3>xapp_kbd_layout_controller_get_current_short_group_label ()</h3>
527 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
528 xapp_kbd_layout_controller_get_current_short_group_label
529 (<em class="parameter"><code><a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> *controller</code></em>);</pre>
530 <p>Returns the short group label (and subscript, if any) of the current layout</p>
531 <div class="refsect3">
532 <a name="xapp-kbd-layout-controller-get-current-short-group-label.parameters"></a><h4>Parameters</h4>
533 <div class="informaltable"><table class="informaltable" width="100%" border="0">
534 <colgroup>
535 <col width="150px" class="parameters_name">
536 <col class="parameters_description">
537 <col width="200px" class="parameters_annotations">
538 </colgroup>
539 <tbody><tr>
540 <td class="parameter_name"><p>controller</p></td>
541 <td class="parameter_description"><p>the <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a></p></td>
542 <td class="parameter_annotations"> </td>
543 </tr></tbody>
544 </table></div>
545 </div>
546 <div class="refsect3">
547 <a name="xapp-kbd-layout-controller-get-current-short-group-label.returns"></a><h4>Returns</h4>
548 <p>a new string or NULL. </p>
549 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
550 </div>
551 </div>
552 <hr>
553 <div class="refsect2">
554 <a name="xapp-kbd-layout-controller-get-short-group-label-for-group"></a><h3>xapp_kbd_layout_controller_get_short_group_label_for_group ()</h3>
555 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
556 xapp_kbd_layout_controller_get_short_group_label_for_group
557 (<em class="parameter"><code><a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> *controller</code></em>,
558 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> group</code></em>);</pre>
559 <p>Returns the short group label and subscript of the specified layout.</p>
560 <div class="refsect3">
561 <a name="xapp-kbd-layout-controller-get-short-group-label-for-group.parameters"></a><h4>Parameters</h4>
562 <div class="informaltable"><table class="informaltable" width="100%" border="0">
563 <colgroup>
564 <col width="150px" class="parameters_name">
565 <col class="parameters_description">
566 <col width="200px" class="parameters_annotations">
567 </colgroup>
568 <tbody>
569 <tr>
570 <td class="parameter_name"><p>controller</p></td>
571 <td class="parameter_description"><p>the <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a></p></td>
572 <td class="parameter_annotations"> </td>
573 </tr>
574 <tr>
575 <td class="parameter_name"><p>group</p></td>
576 <td class="parameter_description"><p>a group number</p></td>
577 <td class="parameter_annotations"> </td>
578 </tr>
579 </tbody>
580 </table></div>
581 </div>
582 <div class="refsect3">
583 <a name="xapp-kbd-layout-controller-get-short-group-label-for-group.returns"></a><h4>Returns</h4>
584 <p>a new string or NULL. </p>
585 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
586 </div>
587 </div>
588 <hr>
589 <div class="refsect2">
590 <a name="xapp-kbd-layout-controller-get-current-variant-label"></a><h3>xapp_kbd_layout_controller_get_current_variant_label ()</h3>
591 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
592 xapp_kbd_layout_controller_get_current_variant_label
593 (<em class="parameter"><code><a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> *controller</code></em>);</pre>
594 <p>Returns the variant label (and subscript, if any) of the current layout</p>
595 <div class="refsect3">
596 <a name="xapp-kbd-layout-controller-get-current-variant-label.parameters"></a><h4>Parameters</h4>
597 <div class="informaltable"><table class="informaltable" width="100%" border="0">
598 <colgroup>
599 <col width="150px" class="parameters_name">
600 <col class="parameters_description">
601 <col width="200px" class="parameters_annotations">
602 </colgroup>
603 <tbody><tr>
604 <td class="parameter_name"><p>controller</p></td>
605 <td class="parameter_description"><p>the <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a></p></td>
606 <td class="parameter_annotations"> </td>
607 </tr></tbody>
608 </table></div>
609 </div>
610 <div class="refsect3">
611 <a name="xapp-kbd-layout-controller-get-current-variant-label.returns"></a><h4>Returns</h4>
612 <p>a new string or NULL. </p>
613 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
614 </div>
615 </div>
616 <hr>
617 <div class="refsect2">
618 <a name="xapp-kbd-layout-controller-get-variant-label-for-group"></a><h3>xapp_kbd_layout_controller_get_variant_label_for_group ()</h3>
619 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
620 xapp_kbd_layout_controller_get_variant_label_for_group
621 (<em class="parameter"><code><a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> *controller</code></em>,
622 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> group</code></em>);</pre>
623 <p>Returns the variant label and subscript of the specified layout.</p>
624 <div class="refsect3">
625 <a name="xapp-kbd-layout-controller-get-variant-label-for-group.parameters"></a><h4>Parameters</h4>
626 <div class="informaltable"><table class="informaltable" width="100%" border="0">
627 <colgroup>
628 <col width="150px" class="parameters_name">
629 <col class="parameters_description">
630 <col width="200px" class="parameters_annotations">
631 </colgroup>
632 <tbody>
633 <tr>
634 <td class="parameter_name"><p>controller</p></td>
635 <td class="parameter_description"><p>the <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a></p></td>
636 <td class="parameter_annotations"> </td>
637 </tr>
638 <tr>
639 <td class="parameter_name"><p>group</p></td>
640 <td class="parameter_description"><p>a group number</p></td>
641 <td class="parameter_annotations"> </td>
642 </tr>
643 </tbody>
644 </table></div>
645 </div>
646 <div class="refsect3">
647 <a name="xapp-kbd-layout-controller-get-variant-label-for-group.returns"></a><h4>Returns</h4>
648 <p>a new string or NULL. </p>
649 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
650 </div>
651 </div>
652 <hr>
653 <div class="refsect2">
654 <a name="xapp-kbd-layout-controller-render-cairo-subscript"></a><h3>xapp_kbd_layout_controller_render_cairo_subscript ()</h3>
655 <pre class="programlisting"><span class="returnvalue">void</span>
656 xapp_kbd_layout_controller_render_cairo_subscript
657 (<em class="parameter"><code><span class="type">cairo_t</span> *cr</code></em>,
658 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x</code></em>,
659 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y</code></em>,
660 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> width</code></em>,
661 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> height</code></em>,
662 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> subscript</code></em>);</pre>
663 <p>Renders a subscript number in the given work area. This should
664 be called from within a "draw" or "paint" widget/actor function,
665 where a valid cairo_t is provided to draw with.</p>
666 <div class="refsect3">
667 <a name="xapp-kbd-layout-controller-render-cairo-subscript.parameters"></a><h4>Parameters</h4>
668 <div class="informaltable"><table class="informaltable" width="100%" border="0">
669 <colgroup>
670 <col width="150px" class="parameters_name">
671 <col class="parameters_description">
672 <col width="200px" class="parameters_annotations">
673 </colgroup>
674 <tbody>
675 <tr>
676 <td class="parameter_name"><p>cr</p></td>
677 <td class="parameter_description"><p>a <span class="type">cairo_t</span></p></td>
678 <td class="parameter_annotations"> </td>
679 </tr>
680 <tr>
681 <td class="parameter_name"><p>x</p></td>
682 <td class="parameter_description"><p>the x position of the drawing area</p></td>
683 <td class="parameter_annotations"> </td>
684 </tr>
685 <tr>
686 <td class="parameter_name"><p>y</p></td>
687 <td class="parameter_description"><p>the y position of the drawing area</p></td>
688 <td class="parameter_annotations"> </td>
689 </tr>
690 <tr>
691 <td class="parameter_name"><p>width</p></td>
692 <td class="parameter_description"><p>the width of the drawing area</p></td>
693 <td class="parameter_annotations"> </td>
694 </tr>
695 <tr>
696 <td class="parameter_name"><p>height</p></td>
697 <td class="parameter_description"><p>the height of the drawing area</p></td>
698 <td class="parameter_annotations"> </td>
699 </tr>
700 <tr>
701 <td class="parameter_name"><p>subscript</p></td>
702 <td class="parameter_description"><p>the number to render</p></td>
703 <td class="parameter_annotations"> </td>
704 </tr>
705 </tbody>
706 </table></div>
707 </div>
708 </div>
709 </div>
710 <div class="refsect1">
711 <a name="XAppKbdLayoutController.other_details"></a><h2>Types and Values</h2>
712 </div>
713 <div class="refsect1">
714 <a name="XAppKbdLayoutController.property-details"></a><h2>Property Details</h2>
715 <div class="refsect2">
716 <a name="XAppKbdLayoutController--enabled"></a><h3>The <code class="literal">“enabled”</code> property</h3>
717 <pre class="programlisting"> “enabled” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
718 <p>Whether we're enabled (more than one keyboard layout is installed).</p>
719 <p>Flags: Read</p>
720 <p>Default value: FALSE</p>
721 </div>
722 </div>
723 <div class="refsect1">
724 <a name="XAppKbdLayoutController.signal-details"></a><h2>Signal Details</h2>
725 <div class="refsect2">
726 <a name="XAppKbdLayoutController-config-changed"></a><h3>The <code class="literal">“config-changed”</code> signal</h3>
727 <pre class="programlisting"><span class="returnvalue">void</span>
728 user_function (<a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> *xappkbdlayoutcontroller,
729 <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
730 <p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
731 </div>
732 <hr>
733 <div class="refsect2">
734 <a name="XAppKbdLayoutController-layout-changed"></a><h3>The <code class="literal">“layout-changed”</code> signal</h3>
735 <pre class="programlisting"><span class="returnvalue">void</span>
736 user_function (<a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController"><span class="type">XAppKbdLayoutController</span></a> *xappkbdlayoutcontroller,
737 <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg1,
738 <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
739 <p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
740 </div>
741 </div>
742 </div>
743 <div class="footer">
744 <hr>Generated by GTK-Doc V1.27</div>
745 </body>
746 </html>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>XAppMonitorBlanker: XApp Reference Manual</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
6 <link rel="home" href="index.html" title="XApp Reference Manual">
7 <link rel="up" href="ch01.html" title="API reference">
8 <link rel="prev" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">
9 <link rel="next" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow">
10 <meta name="generator" content="GTK-Doc V1.27 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 </head>
13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
15 <td width="100%" align="left" class="shortcuts">
16 <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
17 <a href="#XAppMonitorBlanker.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
18 <a href="#XAppMonitorBlanker.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
19 </td>
20 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
21 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
22 <td><a accesskey="p" href="XAppKbdLayoutController.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
23 <td><a accesskey="n" href="XAppPreferencesWindow.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
24 </tr></table>
25 <div class="refentry">
26 <a name="XAppMonitorBlanker"></a><div class="titlepage"></div>
27 <div class="refnamediv"><table width="100%"><tr>
28 <td valign="top">
29 <h2><span class="refentrytitle"><a name="XAppMonitorBlanker.top_of_page"></a>XAppMonitorBlanker</span></h2>
30 <p>XAppMonitorBlanker — Blank and unblank unused monitors</p>
31 </td>
32 <td class="gallery_image" valign="top" align="right"></td>
33 </tr></table></div>
34 <div class="refsect1">
35 <a name="XAppMonitorBlanker.functions"></a><h2>Functions</h2>
36 <div class="informaltable"><table class="informaltable" width="100%" border="0">
37 <colgroup>
38 <col width="150px" class="functions_return">
39 <col class="functions_name">
40 </colgroup>
41 <tbody>
42 <tr>
43 <td class="function_type">
44 <a class="link" href="XAppMonitorBlanker.html" title="XAppMonitorBlanker"><span class="returnvalue">XAppMonitorBlanker</span></a> *
45 </td>
46 <td class="function_name">
47 <a class="link" href="XAppMonitorBlanker.html#xapp-monitor-blanker-new" title="xapp_monitor_blanker_new ()">xapp_monitor_blanker_new</a> <span class="c_punctuation">()</span>
48 </td>
49 </tr>
50 <tr>
51 <td class="function_type">
52 <span class="returnvalue">void</span>
53 </td>
54 <td class="function_name">
55 <a class="link" href="XAppMonitorBlanker.html#xapp-monitor-blanker-blank-other-monitors" title="xapp_monitor_blanker_blank_other_monitors ()">xapp_monitor_blanker_blank_other_monitors</a> <span class="c_punctuation">()</span>
56 </td>
57 </tr>
58 <tr>
59 <td class="function_type">
60 <span class="returnvalue">void</span>
61 </td>
62 <td class="function_name">
63 <a class="link" href="XAppMonitorBlanker.html#xapp-monitor-blanker-unblank-monitors" title="xapp_monitor_blanker_unblank_monitors ()">xapp_monitor_blanker_unblank_monitors</a> <span class="c_punctuation">()</span>
64 </td>
65 </tr>
66 <tr>
67 <td class="function_type">
68 <a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
69 </td>
70 <td class="function_name">
71 <a class="link" href="XAppMonitorBlanker.html#xapp-monitor-blanker-are-monitors-blanked" title="xapp_monitor_blanker_are_monitors_blanked ()">xapp_monitor_blanker_are_monitors_blanked</a> <span class="c_punctuation">()</span>
72 </td>
73 </tr>
74 </tbody>
75 </table></div>
76 </div>
77 <div class="refsect1">
78 <a name="XAppMonitorBlanker.object-hierarchy"></a><h2>Object Hierarchy</h2>
79 <pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
80 <span class="lineart">╰──</span> XAppMonitorBlanker
81 </pre>
82 </div>
83 <div class="refsect1">
84 <a name="XAppMonitorBlanker.description"></a><h2>Description</h2>
85 <p>The XAppMonitorBlanker widget that creates one or more
86 POPUP type GtkWindows that are used to blank unused
87 monitors in multiple monitor setups.</p>
88 </div>
89 <div class="refsect1">
90 <a name="XAppMonitorBlanker.functions_details"></a><h2>Functions</h2>
91 <div class="refsect2">
92 <a name="xapp-monitor-blanker-new"></a><h3>xapp_monitor_blanker_new ()</h3>
93 <pre class="programlisting"><a class="link" href="XAppMonitorBlanker.html" title="XAppMonitorBlanker"><span class="returnvalue">XAppMonitorBlanker</span></a> *
94 xapp_monitor_blanker_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
95 <p>Creates a new <a class="link" href="XAppMonitorBlanker.html" title="XAppMonitorBlanker"><span class="type">XAppMonitorBlanker</span></a>.</p>
96 <div class="refsect3">
97 <a name="xapp-monitor-blanker-new.returns"></a><h4>Returns</h4>
98 <p> a newly created <a class="link" href="XAppMonitorBlanker.html" title="XAppMonitorBlanker"><span class="type">XAppMonitorBlanker</span></a></p>
99 </div>
100 </div>
101 <hr>
102 <div class="refsect2">
103 <a name="xapp-monitor-blanker-blank-other-monitors"></a><h3>xapp_monitor_blanker_blank_other_monitors ()</h3>
104 <pre class="programlisting"><span class="returnvalue">void</span>
105 xapp_monitor_blanker_blank_other_monitors
106 (<em class="parameter"><code><a class="link" href="XAppMonitorBlanker.html" title="XAppMonitorBlanker"><span class="type">XAppMonitorBlanker</span></a> *self</code></em>,
107 <em class="parameter"><code><a href="../gtk3/GtkWindow.html#GtkWindow-struct"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
108 <p>Blanks monitors besides the one where the <em class="parameter"><code>window</code></em>
109 is.</p>
110 <div class="refsect3">
111 <a name="xapp-monitor-blanker-blank-other-monitors.parameters"></a><h4>Parameters</h4>
112 <div class="informaltable"><table class="informaltable" width="100%" border="0">
113 <colgroup>
114 <col width="150px" class="parameters_name">
115 <col class="parameters_description">
116 <col width="200px" class="parameters_annotations">
117 </colgroup>
118 <tbody>
119 <tr>
120 <td class="parameter_name"><p>self</p></td>
121 <td class="parameter_description"><p>a <a class="link" href="XAppMonitorBlanker.html" title="XAppMonitorBlanker"><span class="type">XAppMonitorBlanker</span></a></p></td>
122 <td class="parameter_annotations"> </td>
123 </tr>
124 <tr>
125 <td class="parameter_name"><p>window</p></td>
126 <td class="parameter_description"><p>a <a href="../gtk3/GtkWindow.html#GtkWindow-struct"><span class="type">GtkWindow</span></a></p></td>
127 <td class="parameter_annotations"> </td>
128 </tr>
129 </tbody>
130 </table></div>
131 </div>
132 </div>
133 <hr>
134 <div class="refsect2">
135 <a name="xapp-monitor-blanker-unblank-monitors"></a><h3>xapp_monitor_blanker_unblank_monitors ()</h3>
136 <pre class="programlisting"><span class="returnvalue">void</span>
137 xapp_monitor_blanker_unblank_monitors (<em class="parameter"><code><a class="link" href="XAppMonitorBlanker.html" title="XAppMonitorBlanker"><span class="type">XAppMonitorBlanker</span></a> *self</code></em>);</pre>
138 <p>Unblanks monitors that were blanked by
139 <a class="link" href="XAppMonitorBlanker.html#xapp-monitor-blanker-blank-other-monitors" title="xapp_monitor_blanker_blank_other_monitors ()"><code class="function">xapp_monitor_blanker_blank_other_monitors()</code></a>;</p>
140 <div class="refsect3">
141 <a name="xapp-monitor-blanker-unblank-monitors.parameters"></a><h4>Parameters</h4>
142 <div class="informaltable"><table class="informaltable" width="100%" border="0">
143 <colgroup>
144 <col width="150px" class="parameters_name">
145 <col class="parameters_description">
146 <col width="200px" class="parameters_annotations">
147 </colgroup>
148 <tbody><tr>
149 <td class="parameter_name"><p>self</p></td>
150 <td class="parameter_description"><p>a <a class="link" href="XAppMonitorBlanker.html" title="XAppMonitorBlanker"><span class="type">XAppMonitorBlanker</span></a></p></td>
151 <td class="parameter_annotations"> </td>
152 </tr></tbody>
153 </table></div>
154 </div>
155 </div>
156 <hr>
157 <div class="refsect2">
158 <a name="xapp-monitor-blanker-are-monitors-blanked"></a><h3>xapp_monitor_blanker_are_monitors_blanked ()</h3>
159 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
160 xapp_monitor_blanker_are_monitors_blanked
161 (<em class="parameter"><code><a class="link" href="XAppMonitorBlanker.html" title="XAppMonitorBlanker"><span class="type">XAppMonitorBlanker</span></a> *self</code></em>);</pre>
162 <p>Returns whether monitors are currently blanked.
163 See <a class="link" href="XAppMonitorBlanker.html#xapp-monitor-blanker-blank-other-monitors" title="xapp_monitor_blanker_blank_other_monitors ()"><code class="function">xapp_monitor_blanker_blank_other_monitors()</code></a>.</p>
164 <div class="refsect3">
165 <a name="xapp-monitor-blanker-are-monitors-blanked.parameters"></a><h4>Parameters</h4>
166 <div class="informaltable"><table class="informaltable" width="100%" border="0">
167 <colgroup>
168 <col width="150px" class="parameters_name">
169 <col class="parameters_description">
170 <col width="200px" class="parameters_annotations">
171 </colgroup>
172 <tbody><tr>
173 <td class="parameter_name"><p>self</p></td>
174 <td class="parameter_description"><p>a <a class="link" href="XAppMonitorBlanker.html" title="XAppMonitorBlanker"><span class="type">XAppMonitorBlanker</span></a></p></td>
175 <td class="parameter_annotations"> </td>
176 </tr></tbody>
177 </table></div>
178 </div>
179 <div class="refsect3">
180 <a name="xapp-monitor-blanker-are-monitors-blanked.returns"></a><h4>Returns</h4>
181 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if monitors are blanked.</p>
182 </div>
183 </div>
184 </div>
185 <div class="refsect1">
186 <a name="XAppMonitorBlanker.other_details"></a><h2>Types and Values</h2>
187 </div>
188 </div>
189 <div class="footer">
190 <hr>Generated by GTK-Doc V1.27</div>
191 </body>
192 </html>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>XAppPreferencesWindow: XApp Reference Manual</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
6 <link rel="home" href="index.html" title="XApp Reference Manual">
7 <link rel="up" href="ch01.html" title="API reference">
8 <link rel="prev" href="XAppMonitorBlanker.html" title="XAppMonitorBlanker">
9 <link rel="next" href="XAppStackSidebar.html" title="XAppStackSidebar">
10 <meta name="generator" content="GTK-Doc V1.27 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 </head>
13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
15 <td width="100%" align="left" class="shortcuts">
16 <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
17 <a href="#XAppPreferencesWindow.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
18 <a href="#XAppPreferencesWindow.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces">  <span class="dim">|</span> 
19 <a href="#XAppPreferencesWindow.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_signals">  <span class="dim">|</span> 
20 <a href="#XAppPreferencesWindow.signals" class="shortcut">Signals</a></span>
21 </td>
22 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
23 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
24 <td><a accesskey="p" href="XAppMonitorBlanker.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
25 <td><a accesskey="n" href="XAppStackSidebar.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
26 </tr></table>
27 <div class="refentry">
28 <a name="XAppPreferencesWindow"></a><div class="titlepage"></div>
29 <div class="refnamediv"><table width="100%"><tr>
30 <td valign="top">
31 <h2><span class="refentrytitle"><a name="XAppPreferencesWindow.top_of_page"></a>XAppPreferencesWindow</span></h2>
32 <p>XAppPreferencesWindow — A base preferences window</p>
33 </td>
34 <td class="gallery_image" valign="top" align="right"></td>
35 </tr></table></div>
36 <div class="refsect1">
37 <a name="XAppPreferencesWindow.functions"></a><h2>Functions</h2>
38 <div class="informaltable"><table class="informaltable" width="100%" border="0">
39 <colgroup>
40 <col width="150px" class="functions_return">
41 <col class="functions_name">
42 </colgroup>
43 <tbody>
44 <tr>
45 <td class="function_type">
46 <a class="link" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow"><span class="returnvalue">XAppPreferencesWindow</span></a> *
47 </td>
48 <td class="function_name">
49 <a class="link" href="XAppPreferencesWindow.html#xapp-preferences-window-new" title="xapp_preferences_window_new ()">xapp_preferences_window_new</a> <span class="c_punctuation">()</span>
50 </td>
51 </tr>
52 <tr>
53 <td class="function_type">
54 <span class="returnvalue">void</span>
55 </td>
56 <td class="function_name">
57 <a class="link" href="XAppPreferencesWindow.html#xapp-preferences-window-add-page" title="xapp_preferences_window_add_page ()">xapp_preferences_window_add_page</a> <span class="c_punctuation">()</span>
58 </td>
59 </tr>
60 <tr>
61 <td class="function_type">
62 <span class="returnvalue">void</span>
63 </td>
64 <td class="function_name">
65 <a class="link" href="XAppPreferencesWindow.html#xapp-preferences-window-add-button" title="xapp_preferences_window_add_button ()">xapp_preferences_window_add_button</a> <span class="c_punctuation">()</span>
66 </td>
67 </tr>
68 </tbody>
69 </table></div>
70 </div>
71 <div class="refsect1">
72 <a name="XAppPreferencesWindow.signals"></a><h2>Signals</h2>
73 <div class="informaltable"><table class="informaltable" border="0">
74 <colgroup>
75 <col width="150px" class="signals_return">
76 <col width="300px" class="signals_name">
77 <col width="200px" class="signals_flags">
78 </colgroup>
79 <tbody><tr>
80 <td class="signal_type"><span class="returnvalue">void</span></td>
81 <td class="signal_name"><a class="link" href="XAppPreferencesWindow.html#XAppPreferencesWindow-close" title="The “close” signal">close</a></td>
82 <td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
83 </tr></tbody>
84 </table></div>
85 </div>
86 <div class="refsect1">
87 <a name="XAppPreferencesWindow.other"></a><h2>Types and Values</h2>
88 <div class="informaltable"><table class="informaltable" width="100%" border="0">
89 <colgroup>
90 <col width="150px" class="name">
91 <col class="description">
92 </colgroup>
93 <tbody>
94 <tr>
95 <td class="define_keyword">#define</td>
96 <td class="function_name"><a class="link" href="XAppPreferencesWindow.html#XAPP-TYPE-PREFERENCES-WINDOW:CAPS" title="XAPP_TYPE_PREFERENCES_WINDOW">XAPP_TYPE_PREFERENCES_WINDOW</a></td>
97 </tr>
98 <tr>
99 <td class="datatype_keyword">struct</td>
100 <td class="function_name"><a class="link" href="XAppPreferencesWindow.html#XAppPreferencesWindowClass" title="struct XAppPreferencesWindowClass">XAppPreferencesWindowClass</a></td>
101 </tr>
102 <tr>
103 <td class="datatype_keyword"> </td>
104 <td class="function_name"><a class="link" href="XAppPreferencesWindow.html#XAppPreferencesWindow-struct" title="XAppPreferencesWindow">XAppPreferencesWindow</a></td>
105 </tr>
106 </tbody>
107 </table></div>
108 </div>
109 <div class="refsect1">
110 <a name="XAppPreferencesWindow.object-hierarchy"></a><h2>Object Hierarchy</h2>
111 <pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
112 <span class="lineart">╰──</span> <a href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
113 <span class="lineart">╰──</span> <a href="../gtk3/GtkWidget.html#GtkWidget-struct">GtkWidget</a>
114 <span class="lineart">╰──</span> <a href="../gtk3/GtkContainer.html#GtkContainer-struct">GtkContainer</a>
115 <span class="lineart">╰──</span> <a href="../gtk3/GtkBin.html#GtkBin-struct">GtkBin</a>
116 <span class="lineart">╰──</span> <a href="../gtk3/GtkWindow.html#GtkWindow-struct">GtkWindow</a>
117 <span class="lineart">╰──</span> XAppPreferencesWindow
118 </pre>
119 </div>
120 <div class="refsect1">
121 <a name="XAppPreferencesWindow.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
122 <p>
123 XAppPreferencesWindow implements
124 AtkImplementorIface and <a href="../gtk3/GtkBuildable.html#GtkBuildable-struct">GtkBuildable</a>.</p>
125 </div>
126 <div class="refsect1">
127 <a name="XAppPreferencesWindow.description"></a><h2>Description</h2>
128 <p>The XAppPreferencesWindow sets up a simple dialog
129 window with a GtkStack, GtkSidebarSwitcher, and
130 GtkActionBar. The stack switcher and action bar only
131 show when needed.</p>
132 </div>
133 <div class="refsect1">
134 <a name="XAppPreferencesWindow.functions_details"></a><h2>Functions</h2>
135 <div class="refsect2">
136 <a name="xapp-preferences-window-new"></a><h3>xapp_preferences_window_new ()</h3>
137 <pre class="programlisting"><a class="link" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow"><span class="returnvalue">XAppPreferencesWindow</span></a> *
138 xapp_preferences_window_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
139 <p>Creates a new <a class="link" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow"><span class="type">XAppPreferencesWindow</span></a>.</p>
140 <div class="refsect3">
141 <a name="xapp-preferences-window-new.returns"></a><h4>Returns</h4>
142 <p> a newly created <a class="link" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow"><span class="type">XAppPreferencesWindow</span></a></p>
143 </div>
144 </div>
145 <hr>
146 <div class="refsect2">
147 <a name="xapp-preferences-window-add-page"></a><h3>xapp_preferences_window_add_page ()</h3>
148 <pre class="programlisting"><span class="returnvalue">void</span>
149 xapp_preferences_window_add_page (<em class="parameter"><code><a class="link" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow"><span class="type">XAppPreferencesWindow</span></a> *window</code></em>,
150 <em class="parameter"><code><a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> *widget</code></em>,
151 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
152 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>);</pre>
153 <p>Adds a page to the window. The page is identified by name. The
154 title will be used in the sidebar so should be short. The sidebar
155 will show automatically once at least two pages are added.</p>
156 <div class="refsect3">
157 <a name="xapp-preferences-window-add-page.parameters"></a><h4>Parameters</h4>
158 <div class="informaltable"><table class="informaltable" width="100%" border="0">
159 <colgroup>
160 <col width="150px" class="parameters_name">
161 <col class="parameters_description">
162 <col width="200px" class="parameters_annotations">
163 </colgroup>
164 <tbody>
165 <tr>
166 <td class="parameter_name"><p>window</p></td>
167 <td class="parameter_description"><p>a <a class="link" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow"><span class="type">XAppPreferencesWindow</span></a></p></td>
168 <td class="parameter_annotations"> </td>
169 </tr>
170 <tr>
171 <td class="parameter_name"><p>widget</p></td>
172 <td class="parameter_description"><p>a <a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> to add</p></td>
173 <td class="parameter_annotations"> </td>
174 </tr>
175 <tr>
176 <td class="parameter_name"><p>name</p></td>
177 <td class="parameter_description"><p>the name for the page</p></td>
178 <td class="parameter_annotations"> </td>
179 </tr>
180 <tr>
181 <td class="parameter_name"><p>title</p></td>
182 <td class="parameter_description"><p>a human-readable title for the page</p></td>
183 <td class="parameter_annotations"> </td>
184 </tr>
185 </tbody>
186 </table></div>
187 </div>
188 </div>
189 <hr>
190 <div class="refsect2">
191 <a name="xapp-preferences-window-add-button"></a><h3>xapp_preferences_window_add_button ()</h3>
192 <pre class="programlisting"><span class="returnvalue">void</span>
193 xapp_preferences_window_add_button (<em class="parameter"><code><a class="link" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow"><span class="type">XAppPreferencesWindow</span></a> *window</code></em>,
194 <em class="parameter"><code><a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> *button</code></em>,
195 <em class="parameter"><code><a href="../gtk3/gtk3-Standard-Enumerations.html#GtkPackType"><span class="type">GtkPackType</span></a> pack_type</code></em>);</pre>
196 <p>Adds a button to the bottom action bar of the window. Where
197 the button is place will be determined by the <a href="../gtk3/gtk3-Standard-Enumerations.html#GtkPackType"><span class="type">GtkPackType</span></a>. The
198 action bar will show automatically once at least one button is
199 added.</p>
200 <div class="refsect3">
201 <a name="xapp-preferences-window-add-button.parameters"></a><h4>Parameters</h4>
202 <div class="informaltable"><table class="informaltable" width="100%" border="0">
203 <colgroup>
204 <col width="150px" class="parameters_name">
205 <col class="parameters_description">
206 <col width="200px" class="parameters_annotations">
207 </colgroup>
208 <tbody>
209 <tr>
210 <td class="parameter_name"><p>window</p></td>
211 <td class="parameter_description"><p>a <a class="link" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow"><span class="type">XAppPreferencesWindow</span></a></p></td>
212 <td class="parameter_annotations"> </td>
213 </tr>
214 <tr>
215 <td class="parameter_name"><p>button</p></td>
216 <td class="parameter_description"><p>a <a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> to add</p></td>
217 <td class="parameter_annotations"> </td>
218 </tr>
219 <tr>
220 <td class="parameter_name"><p>pack_type</p></td>
221 <td class="parameter_description"><p>a <a href="../gtk3/gtk3-Standard-Enumerations.html#GtkPackType"><span class="type">GtkPackType</span></a> to use</p></td>
222 <td class="parameter_annotations"> </td>
223 </tr>
224 </tbody>
225 </table></div>
226 </div>
227 </div>
228 </div>
229 <div class="refsect1">
230 <a name="XAppPreferencesWindow.other_details"></a><h2>Types and Values</h2>
231 <div class="refsect2">
232 <a name="XAPP-TYPE-PREFERENCES-WINDOW:CAPS"></a><h3>XAPP_TYPE_PREFERENCES_WINDOW</h3>
233 <pre class="programlisting">#define XAPP_TYPE_PREFERENCES_WINDOW (xapp_preferences_window_get_type ())
234 </pre>
235 </div>
236 <hr>
237 <div class="refsect2">
238 <a name="XAppPreferencesWindowClass"></a><h3>struct XAppPreferencesWindowClass</h3>
239 <pre class="programlisting">struct XAppPreferencesWindowClass {
240 GtkWindowClass parent_class;
241
242 /* Keybinding signals */
243 void (* close) (XAppPreferencesWindow *window);
244 };
245 </pre>
246 </div>
247 <hr>
248 <div class="refsect2">
249 <a name="XAppPreferencesWindow-struct"></a><h3>XAppPreferencesWindow</h3>
250 <pre class="programlisting">typedef struct _XAppPreferencesWindow XAppPreferencesWindow;</pre>
251 </div>
252 </div>
253 <div class="refsect1">
254 <a name="XAppPreferencesWindow.signal-details"></a><h2>Signal Details</h2>
255 <div class="refsect2">
256 <a name="XAppPreferencesWindow-close"></a><h3>The <code class="literal">“close”</code> signal</h3>
257 <pre class="programlisting"><span class="returnvalue">void</span>
258 user_function (<a class="link" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow"><span class="type">XAppPreferencesWindow</span></a> *xapppreferenceswindow,
259 <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
260 <p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
261 </div>
262 </div>
263 </div>
264 <div class="footer">
265 <hr>Generated by GTK-Doc V1.27</div>
266 </body>
267 </html>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>XAppStackSidebar: XApp Reference Manual</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
6 <link rel="home" href="index.html" title="XApp Reference Manual">
7 <link rel="up" href="ch01.html" title="API reference">
8 <link rel="prev" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow">
9 <link rel="next" href="XAppStatusIcon.html" title="XAppStatusIcon">
10 <meta name="generator" content="GTK-Doc V1.27 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 </head>
13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
15 <td width="100%" align="left" class="shortcuts">
16 <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
17 <a href="#XAppStackSidebar.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
18 <a href="#XAppStackSidebar.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces">  <span class="dim">|</span> 
19 <a href="#XAppStackSidebar.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties">  <span class="dim">|</span> 
20 <a href="#XAppStackSidebar.properties" class="shortcut">Properties</a></span>
21 </td>
22 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
23 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
24 <td><a accesskey="p" href="XAppPreferencesWindow.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
25 <td><a accesskey="n" href="XAppStatusIcon.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
26 </tr></table>
27 <div class="refentry">
28 <a name="XAppStackSidebar"></a><div class="titlepage"></div>
29 <div class="refnamediv"><table width="100%"><tr>
30 <td valign="top">
31 <h2><span class="refentrytitle"><a name="XAppStackSidebar.top_of_page"></a>XAppStackSidebar</span></h2>
32 <p>XAppStackSidebar — An automatic sidebar widget</p>
33 </td>
34 <td class="gallery_image" valign="top" align="right"></td>
35 </tr></table></div>
36 <div class="refsect1">
37 <a name="XAppStackSidebar.functions"></a><h2>Functions</h2>
38 <div class="informaltable"><table class="informaltable" width="100%" border="0">
39 <colgroup>
40 <col width="150px" class="functions_return">
41 <col class="functions_name">
42 </colgroup>
43 <tbody>
44 <tr>
45 <td class="function_type">
46 <a class="link" href="XAppStackSidebar.html" title="XAppStackSidebar"><span class="returnvalue">XAppStackSidebar</span></a> *
47 </td>
48 <td class="function_name">
49 <a class="link" href="XAppStackSidebar.html#xapp-stack-sidebar-new" title="xapp_stack_sidebar_new ()">xapp_stack_sidebar_new</a> <span class="c_punctuation">()</span>
50 </td>
51 </tr>
52 <tr>
53 <td class="function_type">
54 <span class="returnvalue">void</span>
55 </td>
56 <td class="function_name">
57 <a class="link" href="XAppStackSidebar.html#xapp-stack-sidebar-set-stack" title="xapp_stack_sidebar_set_stack ()">xapp_stack_sidebar_set_stack</a> <span class="c_punctuation">()</span>
58 </td>
59 </tr>
60 <tr>
61 <td class="function_type">
62 <a href="../gtk3/GtkStack.html#GtkStack-struct"><span class="returnvalue">GtkStack</span></a> *
63 </td>
64 <td class="function_name">
65 <a class="link" href="XAppStackSidebar.html#xapp-stack-sidebar-get-stack" title="xapp_stack_sidebar_get_stack ()">xapp_stack_sidebar_get_stack</a> <span class="c_punctuation">()</span>
66 </td>
67 </tr>
68 </tbody>
69 </table></div>
70 </div>
71 <div class="refsect1">
72 <a name="XAppStackSidebar.properties"></a><h2>Properties</h2>
73 <div class="informaltable"><table class="informaltable" border="0">
74 <colgroup>
75 <col width="150px" class="properties_type">
76 <col width="300px" class="properties_name">
77 <col width="200px" class="properties_flags">
78 </colgroup>
79 <tbody><tr>
80 <td class="property_type">
81 <a href="../gtk3/GtkStack.html#GtkStack-struct"><span class="type">GtkStack</span></a> *</td>
82 <td class="property_name"><a class="link" href="XAppStackSidebar.html#XAppStackSidebar--stack" title="The “stack” property">stack</a></td>
83 <td class="property_flags">Read / Write</td>
84 </tr></tbody>
85 </table></div>
86 </div>
87 <div class="refsect1">
88 <a name="XAppStackSidebar.other"></a><h2>Types and Values</h2>
89 <div class="informaltable"><table class="informaltable" width="100%" border="0">
90 <colgroup>
91 <col width="150px" class="name">
92 <col class="description">
93 </colgroup>
94 <tbody>
95 <tr>
96 <td class="define_keyword">#define</td>
97 <td class="function_name"><a class="link" href="XAppStackSidebar.html#XAPP-TYPE-STACK-SIDEBAR:CAPS" title="XAPP_TYPE_STACK_SIDEBAR">XAPP_TYPE_STACK_SIDEBAR</a></td>
98 </tr>
99 <tr>
100 <td class="datatype_keyword"> </td>
101 <td class="function_name"><a class="link" href="XAppStackSidebar.html#XAppStackSidebar-struct" title="XAppStackSidebar">XAppStackSidebar</a></td>
102 </tr>
103 </tbody>
104 </table></div>
105 </div>
106 <div class="refsect1">
107 <a name="XAppStackSidebar.object-hierarchy"></a><h2>Object Hierarchy</h2>
108 <pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
109 <span class="lineart">╰──</span> <a href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
110 <span class="lineart">╰──</span> <a href="../gtk3/GtkWidget.html#GtkWidget-struct">GtkWidget</a>
111 <span class="lineart">╰──</span> <a href="../gtk3/GtkContainer.html#GtkContainer-struct">GtkContainer</a>
112 <span class="lineart">╰──</span> <a href="../gtk3/GtkBin.html#GtkBin-struct">GtkBin</a>
113 <span class="lineart">╰──</span> XAppStackSidebar
114 </pre>
115 </div>
116 <div class="refsect1">
117 <a name="XAppStackSidebar.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
118 <p>
119 XAppStackSidebar implements
120 AtkImplementorIface and <a href="../gtk3/GtkBuildable.html#GtkBuildable-struct">GtkBuildable</a>.</p>
121 </div>
122 <div class="refsect1">
123 <a name="XAppStackSidebar.description"></a><h2>Description</h2>
124 <p>A XAppStackSidebar allows you to quickly and easily provide a
125 consistent "sidebar" object for your user interface</p>
126 <p>In order to use a XAppStackSidebar, you simply use a GtkStack to
127 organize your UI flow, and add the sidebar to your sidebar area. You
128 can use <a class="link" href="XAppStackSidebar.html#xapp-stack-sidebar-set-stack" title="xapp_stack_sidebar_set_stack ()"><code class="function">xapp_stack_sidebar_set_stack()</code></a> to connect the <a class="link" href="XAppStackSidebar.html" title="XAppStackSidebar"><span class="type">XAppStackSidebar</span></a>
129 to the <a href="../gtk3/GtkStack.html#GtkStack-struct"><span class="type">GtkStack</span></a>. The <a class="link" href="XAppStackSidebar.html" title="XAppStackSidebar"><span class="type">XAppStackSidebar</span></a> is an extended version of the
130 the <a href="../gtk3/GtkStackSidebar.html#GtkStackSidebar-struct"><span class="type">GtkStackSidebar</span></a> that allows showing an icon in addition to the text.</p>
131 <div class="refsect2">
132 <a name="id-1.2.8.8.4"></a><h3>CSS nodes</h3>
133 <p>XAppStackSidebar has a single CSS node with the name stacksidebar and
134 style class .sidebar</p>
135 <p>When circumstances require it, XAppStackSidebar adds the
136 .needs-attention style class to the widgets representing the stack
137 pages.</p>
138 </div>
139 </div>
140 <div class="refsect1">
141 <a name="XAppStackSidebar.functions_details"></a><h2>Functions</h2>
142 <div class="refsect2">
143 <a name="xapp-stack-sidebar-new"></a><h3>xapp_stack_sidebar_new ()</h3>
144 <pre class="programlisting"><a class="link" href="XAppStackSidebar.html" title="XAppStackSidebar"><span class="returnvalue">XAppStackSidebar</span></a> *
145 xapp_stack_sidebar_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
146 <p>Creates a new sidebar.</p>
147 <div class="refsect3">
148 <a name="xapp-stack-sidebar-new.returns"></a><h4>Returns</h4>
149 <p> the new <a class="link" href="XAppStackSidebar.html" title="XAppStackSidebar"><span class="type">XAppStackSidebar</span></a></p>
150 </div>
151 </div>
152 <hr>
153 <div class="refsect2">
154 <a name="xapp-stack-sidebar-set-stack"></a><h3>xapp_stack_sidebar_set_stack ()</h3>
155 <pre class="programlisting"><span class="returnvalue">void</span>
156 xapp_stack_sidebar_set_stack (<em class="parameter"><code><a class="link" href="XAppStackSidebar.html" title="XAppStackSidebar"><span class="type">XAppStackSidebar</span></a> *sidebar</code></em>,
157 <em class="parameter"><code><a href="../gtk3/GtkStack.html#GtkStack-struct"><span class="type">GtkStack</span></a> *stack</code></em>);</pre>
158 <p>Set the <a href="../gtk3/GtkStack.html#GtkStack-struct"><span class="type">GtkStack</span></a> associated with this <a class="link" href="XAppStackSidebar.html" title="XAppStackSidebar"><span class="type">XAppStackSidebar</span></a>.</p>
159 <p>The sidebar widget will automatically update according to the order
160 (packing) and items within the given <a href="../gtk3/GtkStack.html#GtkStack-struct"><span class="type">GtkStack</span></a>.</p>
161 <div class="refsect3">
162 <a name="xapp-stack-sidebar-set-stack.parameters"></a><h4>Parameters</h4>
163 <div class="informaltable"><table class="informaltable" width="100%" border="0">
164 <colgroup>
165 <col width="150px" class="parameters_name">
166 <col class="parameters_description">
167 <col width="200px" class="parameters_annotations">
168 </colgroup>
169 <tbody>
170 <tr>
171 <td class="parameter_name"><p>sidebar</p></td>
172 <td class="parameter_description"><p>a <a class="link" href="XAppStackSidebar.html" title="XAppStackSidebar"><span class="type">XAppStackSidebar</span></a></p></td>
173 <td class="parameter_annotations"> </td>
174 </tr>
175 <tr>
176 <td class="parameter_name"><p>stack</p></td>
177 <td class="parameter_description"><p>a <a href="../gtk3/GtkStack.html#GtkStack-struct"><span class="type">GtkStack</span></a></p></td>
178 <td class="parameter_annotations"> </td>
179 </tr>
180 </tbody>
181 </table></div>
182 </div>
183 </div>
184 <hr>
185 <div class="refsect2">
186 <a name="xapp-stack-sidebar-get-stack"></a><h3>xapp_stack_sidebar_get_stack ()</h3>
187 <pre class="programlisting"><a href="../gtk3/GtkStack.html#GtkStack-struct"><span class="returnvalue">GtkStack</span></a> *
188 xapp_stack_sidebar_get_stack (<em class="parameter"><code><a class="link" href="XAppStackSidebar.html" title="XAppStackSidebar"><span class="type">XAppStackSidebar</span></a> *sidebar</code></em>);</pre>
189 <p>Retrieves the stack.
190 See <a class="link" href="XAppStackSidebar.html#xapp-stack-sidebar-set-stack" title="xapp_stack_sidebar_set_stack ()"><code class="function">xapp_stack_sidebar_set_stack()</code></a>.</p>
191 <div class="refsect3">
192 <a name="xapp-stack-sidebar-get-stack.parameters"></a><h4>Parameters</h4>
193 <div class="informaltable"><table class="informaltable" width="100%" border="0">
194 <colgroup>
195 <col width="150px" class="parameters_name">
196 <col class="parameters_description">
197 <col width="200px" class="parameters_annotations">
198 </colgroup>
199 <tbody><tr>
200 <td class="parameter_name"><p>sidebar</p></td>
201 <td class="parameter_description"><p>a <a class="link" href="XAppStackSidebar.html" title="XAppStackSidebar"><span class="type">XAppStackSidebar</span></a></p></td>
202 <td class="parameter_annotations"> </td>
203 </tr></tbody>
204 </table></div>
205 </div>
206 <div class="refsect3">
207 <a name="xapp-stack-sidebar-get-stack.returns"></a><h4>Returns</h4>
208 <p>the associated <a href="../gtk3/GtkStack.html#GtkStack-struct"><span class="type">GtkStack</span></a> or
209 <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none has been set explicitly. </p>
210 <p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
211 </div>
212 </div>
213 </div>
214 <div class="refsect1">
215 <a name="XAppStackSidebar.other_details"></a><h2>Types and Values</h2>
216 <div class="refsect2">
217 <a name="XAPP-TYPE-STACK-SIDEBAR:CAPS"></a><h3>XAPP_TYPE_STACK_SIDEBAR</h3>
218 <pre class="programlisting">#define XAPP_TYPE_STACK_SIDEBAR (xapp_stack_sidebar_get_type ())
219 </pre>
220 </div>
221 <hr>
222 <div class="refsect2">
223 <a name="XAppStackSidebar-struct"></a><h3>XAppStackSidebar</h3>
224 <pre class="programlisting">typedef struct _XAppStackSidebar XAppStackSidebar;</pre>
225 </div>
226 </div>
227 <div class="refsect1">
228 <a name="XAppStackSidebar.property-details"></a><h2>Property Details</h2>
229 <div class="refsect2">
230 <a name="XAppStackSidebar--stack"></a><h3>The <code class="literal">“stack”</code> property</h3>
231 <pre class="programlisting"> “stack” <a href="../gtk3/GtkStack.html#GtkStack-struct"><span class="type">GtkStack</span></a> *</pre>
232 <p>Associated stack for this XAppStackSidebar.</p>
233 <p>Flags: Read / Write</p>
234 </div>
235 </div>
236 </div>
237 <div class="footer">
238 <hr>Generated by GTK-Doc V1.27</div>
239 </body>
240 </html>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>XAppStatusIcon: XApp Reference Manual</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
6 <link rel="home" href="index.html" title="XApp Reference Manual">
7 <link rel="up" href="ch01.html" title="API reference">
8 <link rel="prev" href="XAppStackSidebar.html" title="XAppStackSidebar">
9 <link rel="next" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor">
10 <meta name="generator" content="GTK-Doc V1.27 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 </head>
13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
15 <td width="100%" align="left" class="shortcuts">
16 <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
17 <a href="#XAppStatusIcon.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
18 <a href="#XAppStatusIcon.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties">  <span class="dim">|</span> 
19 <a href="#XAppStatusIcon.properties" class="shortcut">Properties</a></span><span id="nav_signals">  <span class="dim">|</span> 
20 <a href="#XAppStatusIcon.signals" class="shortcut">Signals</a></span>
21 </td>
22 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
23 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
24 <td><a accesskey="p" href="XAppStackSidebar.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
25 <td><a accesskey="n" href="XAppStatusIconMonitor.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
26 </tr></table>
27 <div class="refentry">
28 <a name="XAppStatusIcon"></a><div class="titlepage"></div>
29 <div class="refnamediv"><table width="100%"><tr>
30 <td valign="top">
31 <h2><span class="refentrytitle"><a name="XAppStatusIcon.top_of_page"></a>XAppStatusIcon</span></h2>
32 <p>XAppStatusIcon — Broadcasts status information over DBUS</p>
33 </td>
34 <td class="gallery_image" valign="top" align="right"></td>
35 </tr></table></div>
36 <div class="refsect1">
37 <a name="XAppStatusIcon.functions"></a><h2>Functions</h2>
38 <div class="informaltable"><table class="informaltable" width="100%" border="0">
39 <colgroup>
40 <col width="150px" class="functions_return">
41 <col class="functions_name">
42 </colgroup>
43 <tbody>
44 <tr>
45 <td class="function_type">
46 <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="returnvalue">XAppStatusIcon</span></a> *
47 </td>
48 <td class="function_name">
49 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-new" title="xapp_status_icon_new ()">xapp_status_icon_new</a> <span class="c_punctuation">()</span>
50 </td>
51 </tr>
52 <tr>
53 <td class="function_type">
54 <span class="returnvalue">void</span>
55 </td>
56 <td class="function_name">
57 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-set-name" title="xapp_status_icon_set_name ()">xapp_status_icon_set_name</a> <span class="c_punctuation">()</span>
58 </td>
59 </tr>
60 <tr>
61 <td class="function_type">
62 <span class="returnvalue">void</span>
63 </td>
64 <td class="function_name">
65 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-set-icon-name" title="xapp_status_icon_set_icon_name ()">xapp_status_icon_set_icon_name</a> <span class="c_punctuation">()</span>
66 </td>
67 </tr>
68 <tr>
69 <td class="function_type">
70 <span class="returnvalue">void</span>
71 </td>
72 <td class="function_name">
73 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-set-tooltip-text" title="xapp_status_icon_set_tooltip_text ()">xapp_status_icon_set_tooltip_text</a> <span class="c_punctuation">()</span>
74 </td>
75 </tr>
76 <tr>
77 <td class="function_type">
78 <span class="returnvalue">void</span>
79 </td>
80 <td class="function_name">
81 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-set-label" title="xapp_status_icon_set_label ()">xapp_status_icon_set_label</a> <span class="c_punctuation">()</span>
82 </td>
83 </tr>
84 <tr>
85 <td class="function_type">
86 <span class="returnvalue">void</span>
87 </td>
88 <td class="function_name">
89 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-set-visible" title="xapp_status_icon_set_visible ()">xapp_status_icon_set_visible</a> <span class="c_punctuation">()</span>
90 </td>
91 </tr>
92 <tr>
93 <td class="function_type">
94 <span class="returnvalue">void</span>
95 </td>
96 <td class="function_name">
97 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-set-primary-menu" title="xapp_status_icon_set_primary_menu ()">xapp_status_icon_set_primary_menu</a> <span class="c_punctuation">()</span>
98 </td>
99 </tr>
100 <tr>
101 <td class="function_type">
102 <a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
103 </td>
104 <td class="function_name">
105 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-get-primary-menu" title="xapp_status_icon_get_primary_menu ()">xapp_status_icon_get_primary_menu</a> <span class="c_punctuation">()</span>
106 </td>
107 </tr>
108 <tr>
109 <td class="function_type">
110 <span class="returnvalue">void</span>
111 </td>
112 <td class="function_name">
113 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-set-secondary-menu" title="xapp_status_icon_set_secondary_menu ()">xapp_status_icon_set_secondary_menu</a> <span class="c_punctuation">()</span>
114 </td>
115 </tr>
116 <tr>
117 <td class="function_type">
118 <a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
119 </td>
120 <td class="function_name">
121 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-get-secondary-menu" title="xapp_status_icon_get_secondary_menu ()">xapp_status_icon_get_secondary_menu</a> <span class="c_punctuation">()</span>
122 </td>
123 </tr>
124 </tbody>
125 </table></div>
126 </div>
127 <div class="refsect1">
128 <a name="XAppStatusIcon.properties"></a><h2>Properties</h2>
129 <div class="informaltable"><table class="informaltable" border="0">
130 <colgroup>
131 <col width="150px" class="properties_type">
132 <col width="300px" class="properties_name">
133 <col width="200px" class="properties_flags">
134 </colgroup>
135 <tbody>
136 <tr>
137 <td class="property_type">
138 <a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> *</td>
139 <td class="property_name"><a class="link" href="XAppStatusIcon.html#XAppStatusIcon--primary-menu" title="The “primary-menu” property">primary-menu</a></td>
140 <td class="property_flags">Read / Write</td>
141 </tr>
142 <tr>
143 <td class="property_type">
144 <a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> *</td>
145 <td class="property_name"><a class="link" href="XAppStatusIcon.html#XAppStatusIcon--secondary-menu" title="The “secondary-menu” property">secondary-menu</a></td>
146 <td class="property_flags">Read / Write</td>
147 </tr>
148 </tbody>
149 </table></div>
150 </div>
151 <div class="refsect1">
152 <a name="XAppStatusIcon.signals"></a><h2>Signals</h2>
153 <div class="informaltable"><table class="informaltable" border="0">
154 <colgroup>
155 <col width="150px" class="signals_return">
156 <col width="300px" class="signals_name">
157 <col width="200px" class="signals_flags">
158 </colgroup>
159 <tbody>
160 <tr>
161 <td class="signal_type"><span class="returnvalue">void</span></td>
162 <td class="signal_name"><a class="link" href="XAppStatusIcon.html#XAppStatusIcon-activate" title="The “activate” signal">activate</a></td>
163 <td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
164 </tr>
165 <tr>
166 <td class="signal_type"><span class="returnvalue">void</span></td>
167 <td class="signal_name"><a class="link" href="XAppStatusIcon.html#XAppStatusIcon-button-press-event" title="The “button-press-event” signal">button-press-event</a></td>
168 <td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
169 </tr>
170 <tr>
171 <td class="signal_type"><span class="returnvalue">void</span></td>
172 <td class="signal_name"><a class="link" href="XAppStatusIcon.html#XAppStatusIcon-button-release-event" title="The “button-release-event” signal">button-release-event</a></td>
173 <td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
174 </tr>
175 </tbody>
176 </table></div>
177 </div>
178 <div class="refsect1">
179 <a name="XAppStatusIcon.other"></a><h2>Types and Values</h2>
180 <div class="informaltable"><table class="informaltable" width="100%" border="0">
181 <colgroup>
182 <col width="150px" class="name">
183 <col class="description">
184 </colgroup>
185 <tbody>
186 <tr>
187 <td class="define_keyword">#define</td>
188 <td class="function_name"><a class="link" href="XAppStatusIcon.html#XAPP-TYPE-STATUS-ICON:CAPS" title="XAPP_TYPE_STATUS_ICON">XAPP_TYPE_STATUS_ICON</a></td>
189 </tr>
190 <tr>
191 <td class="datatype_keyword"> </td>
192 <td class="function_name"><a class="link" href="XAppStatusIcon.html#XAppStatusIcon-struct" title="XAppStatusIcon">XAppStatusIcon</a></td>
193 </tr>
194 </tbody>
195 </table></div>
196 </div>
197 <div class="refsect1">
198 <a name="XAppStatusIcon.object-hierarchy"></a><h2>Object Hierarchy</h2>
199 <pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
200 <span class="lineart">╰──</span> XAppStatusIcon
201 </pre>
202 </div>
203 <div class="refsect1">
204 <a name="XAppStatusIcon.description"></a><h2>Description</h2>
205 <p>The XAppStatusIcon allows applications to share status info
206 about themselves. It replaces the obsolete and very similar
207 Gtk.StatusIcon widget.</p>
208 <p>If used in an environment where no applet is handling XAppStatusIcons,
209 the XAppStatusIcon delegates its calls to a Gtk.StatusIcon.</p>
210 </div>
211 <div class="refsect1">
212 <a name="XAppStatusIcon.functions_details"></a><h2>Functions</h2>
213 <div class="refsect2">
214 <a name="xapp-status-icon-new"></a><h3>xapp_status_icon_new ()</h3>
215 <pre class="programlisting"><a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="returnvalue">XAppStatusIcon</span></a> *
216 xapp_status_icon_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
217 <p>Creates a new <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a> instance</p>
218 <div class="refsect3">
219 <a name="xapp-status-icon-new.returns"></a><h4>Returns</h4>
220 <p>a new <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a>. Use g_object_unref when finished. </p>
221 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
222 </div>
223 <p class="since">Since: 1.6</p>
224 </div>
225 <hr>
226 <div class="refsect2">
227 <a name="xapp-status-icon-set-name"></a><h3>xapp_status_icon_set_name ()</h3>
228 <pre class="programlisting"><span class="returnvalue">void</span>
229 xapp_status_icon_set_name (<em class="parameter"><code><a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a> *icon</code></em>,
230 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
231 <p>Sets the status icon name. This is not shown to users.</p>
232 <div class="refsect3">
233 <a name="xapp-status-icon-set-name.parameters"></a><h4>Parameters</h4>
234 <div class="informaltable"><table class="informaltable" width="100%" border="0">
235 <colgroup>
236 <col width="150px" class="parameters_name">
237 <col class="parameters_description">
238 <col width="200px" class="parameters_annotations">
239 </colgroup>
240 <tbody>
241 <tr>
242 <td class="parameter_name"><p>icon</p></td>
243 <td class="parameter_description"><p>a <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a></p></td>
244 <td class="parameter_annotations"> </td>
245 </tr>
246 <tr>
247 <td class="parameter_name"><p>name</p></td>
248 <td class="parameter_description"><p>a name (this defaults to the name of the application, if not set)</p></td>
249 <td class="parameter_annotations"> </td>
250 </tr>
251 </tbody>
252 </table></div>
253 </div>
254 <p class="since">Since: 1.6</p>
255 </div>
256 <hr>
257 <div class="refsect2">
258 <a name="xapp-status-icon-set-icon-name"></a><h3>xapp_status_icon_set_icon_name ()</h3>
259 <pre class="programlisting"><span class="returnvalue">void</span>
260 xapp_status_icon_set_icon_name (<em class="parameter"><code><a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a> *icon</code></em>,
261 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>);</pre>
262 <p>Sets the icon name or local path to use.</p>
263 <div class="refsect3">
264 <a name="xapp-status-icon-set-icon-name.parameters"></a><h4>Parameters</h4>
265 <div class="informaltable"><table class="informaltable" width="100%" border="0">
266 <colgroup>
267 <col width="150px" class="parameters_name">
268 <col class="parameters_description">
269 <col width="200px" class="parameters_annotations">
270 </colgroup>
271 <tbody>
272 <tr>
273 <td class="parameter_name"><p>icon</p></td>
274 <td class="parameter_description"><p>a <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a></p></td>
275 <td class="parameter_annotations"> </td>
276 </tr>
277 <tr>
278 <td class="parameter_name"><p>icon_name</p></td>
279 <td class="parameter_description"><p>An icon name or absolute path to an icon.</p></td>
280 <td class="parameter_annotations"> </td>
281 </tr>
282 </tbody>
283 </table></div>
284 </div>
285 <p class="since">Since: 1.6</p>
286 </div>
287 <hr>
288 <div class="refsect2">
289 <a name="xapp-status-icon-set-tooltip-text"></a><h3>xapp_status_icon_set_tooltip_text ()</h3>
290 <pre class="programlisting"><span class="returnvalue">void</span>
291 xapp_status_icon_set_tooltip_text (<em class="parameter"><code><a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a> *icon</code></em>,
292 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tooltip_text</code></em>);</pre>
293 <p>Sets the tooltip text</p>
294 <div class="refsect3">
295 <a name="xapp-status-icon-set-tooltip-text.parameters"></a><h4>Parameters</h4>
296 <div class="informaltable"><table class="informaltable" width="100%" border="0">
297 <colgroup>
298 <col width="150px" class="parameters_name">
299 <col class="parameters_description">
300 <col width="200px" class="parameters_annotations">
301 </colgroup>
302 <tbody>
303 <tr>
304 <td class="parameter_name"><p>icon</p></td>
305 <td class="parameter_description"><p>a <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a></p></td>
306 <td class="parameter_annotations"> </td>
307 </tr>
308 <tr>
309 <td class="parameter_name"><p>tooltip_text</p></td>
310 <td class="parameter_description"><p>the text to show in the tooltip</p></td>
311 <td class="parameter_annotations"> </td>
312 </tr>
313 </tbody>
314 </table></div>
315 </div>
316 <p class="since">Since: 1.6</p>
317 </div>
318 <hr>
319 <div class="refsect2">
320 <a name="xapp-status-icon-set-label"></a><h3>xapp_status_icon_set_label ()</h3>
321 <pre class="programlisting"><span class="returnvalue">void</span>
322 xapp_status_icon_set_label (<em class="parameter"><code><a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a> *icon</code></em>,
323 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);</pre>
324 <p>Sets a label, shown beside the icon</p>
325 <div class="refsect3">
326 <a name="xapp-status-icon-set-label.parameters"></a><h4>Parameters</h4>
327 <div class="informaltable"><table class="informaltable" width="100%" border="0">
328 <colgroup>
329 <col width="150px" class="parameters_name">
330 <col class="parameters_description">
331 <col width="200px" class="parameters_annotations">
332 </colgroup>
333 <tbody>
334 <tr>
335 <td class="parameter_name"><p>icon</p></td>
336 <td class="parameter_description"><p>a <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a></p></td>
337 <td class="parameter_annotations"> </td>
338 </tr>
339 <tr>
340 <td class="parameter_name"><p>label</p></td>
341 <td class="parameter_description"><p>some text</p></td>
342 <td class="parameter_annotations"> </td>
343 </tr>
344 </tbody>
345 </table></div>
346 </div>
347 <p class="since">Since: 1.6</p>
348 </div>
349 <hr>
350 <div class="refsect2">
351 <a name="xapp-status-icon-set-visible"></a><h3>xapp_status_icon_set_visible ()</h3>
352 <pre class="programlisting"><span class="returnvalue">void</span>
353 xapp_status_icon_set_visible (<em class="parameter"><code><a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a> *icon</code></em>,
354 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> visible</code></em>);</pre>
355 <p>Sets the visibility of the status icon</p>
356 <div class="refsect3">
357 <a name="xapp-status-icon-set-visible.parameters"></a><h4>Parameters</h4>
358 <div class="informaltable"><table class="informaltable" width="100%" border="0">
359 <colgroup>
360 <col width="150px" class="parameters_name">
361 <col class="parameters_description">
362 <col width="200px" class="parameters_annotations">
363 </colgroup>
364 <tbody>
365 <tr>
366 <td class="parameter_name"><p>icon</p></td>
367 <td class="parameter_description"><p>a <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a></p></td>
368 <td class="parameter_annotations"> </td>
369 </tr>
370 <tr>
371 <td class="parameter_name"><p>visible</p></td>
372 <td class="parameter_description"><p>whether or not the status icon should be visible</p></td>
373 <td class="parameter_annotations"> </td>
374 </tr>
375 </tbody>
376 </table></div>
377 </div>
378 <p class="since">Since: 1.6</p>
379 </div>
380 <hr>
381 <div class="refsect2">
382 <a name="xapp-status-icon-set-primary-menu"></a><h3>xapp_status_icon_set_primary_menu ()</h3>
383 <pre class="programlisting"><span class="returnvalue">void</span>
384 xapp_status_icon_set_primary_menu (<em class="parameter"><code><a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a> *icon</code></em>,
385 <em class="parameter"><code><a href="../gtk3/GtkMenu.html#GtkMenu-struct"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
386 <p>See the <a class="link" href="XAppStatusIcon.html#XAppStatusIcon--primary-menu" title="The “primary-menu” property"><span class="type">“primary-menu”</span></a> property for details</p>
387 <div class="refsect3">
388 <a name="xapp-status-icon-set-primary-menu.parameters"></a><h4>Parameters</h4>
389 <div class="informaltable"><table class="informaltable" width="100%" border="0">
390 <colgroup>
391 <col width="150px" class="parameters_name">
392 <col class="parameters_description">
393 <col width="200px" class="parameters_annotations">
394 </colgroup>
395 <tbody>
396 <tr>
397 <td class="parameter_name"><p>icon</p></td>
398 <td class="parameter_description"><p>an <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a></p></td>
399 <td class="parameter_annotations"> </td>
400 </tr>
401 <tr>
402 <td class="parameter_name"><p>menu</p></td>
403 <td class="parameter_description"><p>A <a href="../gtk3/GtkMenu.html#GtkMenu-struct"><span class="type">GtkMenu</span></a> to display when the primary mouse button is released. </p></td>
404 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
405 </tr>
406 </tbody>
407 </table></div>
408 </div>
409 <p class="since">Since: 1.6</p>
410 </div>
411 <hr>
412 <div class="refsect2">
413 <a name="xapp-status-icon-get-primary-menu"></a><h3>xapp_status_icon_get_primary_menu ()</h3>
414 <pre class="programlisting"><a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
415 xapp_status_icon_get_primary_menu (<em class="parameter"><code><a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a> *icon</code></em>);</pre>
416 <p>Returns a pointer to a <a href="../gtk3/GtkMenu.html#GtkMenu-struct"><span class="type">GtkMenu</span></a> that was set previously for the
417 primary mouse button. If no menu was set, this returns <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
418 <div class="refsect3">
419 <a name="xapp-status-icon-get-primary-menu.parameters"></a><h4>Parameters</h4>
420 <div class="informaltable"><table class="informaltable" width="100%" border="0">
421 <colgroup>
422 <col width="150px" class="parameters_name">
423 <col class="parameters_description">
424 <col width="200px" class="parameters_annotations">
425 </colgroup>
426 <tbody><tr>
427 <td class="parameter_name"><p>icon</p></td>
428 <td class="parameter_description"><p>an <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a></p></td>
429 <td class="parameter_annotations"> </td>
430 </tr></tbody>
431 </table></div>
432 </div>
433 <div class="refsect3">
434 <a name="xapp-status-icon-get-primary-menu.returns"></a><h4>Returns</h4>
435 <p>the <a href="../gtk3/GtkMenu.html#GtkMenu-struct"><span class="type">GtkMenu</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none was set. </p>
436 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
437 </div>
438 <p class="since">Since: 1.6</p>
439 </div>
440 <hr>
441 <div class="refsect2">
442 <a name="xapp-status-icon-set-secondary-menu"></a><h3>xapp_status_icon_set_secondary_menu ()</h3>
443 <pre class="programlisting"><span class="returnvalue">void</span>
444 xapp_status_icon_set_secondary_menu (<em class="parameter"><code><a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a> *icon</code></em>,
445 <em class="parameter"><code><a href="../gtk3/GtkMenu.html#GtkMenu-struct"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
446 <p>See the <a class="link" href="XAppStatusIcon.html#XAppStatusIcon--secondary-menu" title="The “secondary-menu” property"><span class="type">“secondary-menu”</span></a> property for details</p>
447 <div class="refsect3">
448 <a name="xapp-status-icon-set-secondary-menu.parameters"></a><h4>Parameters</h4>
449 <div class="informaltable"><table class="informaltable" width="100%" border="0">
450 <colgroup>
451 <col width="150px" class="parameters_name">
452 <col class="parameters_description">
453 <col width="200px" class="parameters_annotations">
454 </colgroup>
455 <tbody>
456 <tr>
457 <td class="parameter_name"><p>icon</p></td>
458 <td class="parameter_description"><p>an <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a></p></td>
459 <td class="parameter_annotations"> </td>
460 </tr>
461 <tr>
462 <td class="parameter_name"><p>menu</p></td>
463 <td class="parameter_description"><p>A <a href="../gtk3/GtkMenu.html#GtkMenu-struct"><span class="type">GtkMenu</span></a> to display when the primary mouse button is released. </p></td>
464 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
465 </tr>
466 </tbody>
467 </table></div>
468 </div>
469 <p class="since">Since: 1.6</p>
470 </div>
471 <hr>
472 <div class="refsect2">
473 <a name="xapp-status-icon-get-secondary-menu"></a><h3>xapp_status_icon_get_secondary_menu ()</h3>
474 <pre class="programlisting"><a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
475 xapp_status_icon_get_secondary_menu (<em class="parameter"><code><a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a> *icon</code></em>);</pre>
476 <p>Returns a pointer to a <a href="../gtk3/GtkMenu.html#GtkMenu-struct"><span class="type">GtkMenu</span></a> that was set previously for the
477 secondary mouse button. If no menu was set, this returns <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
478 <div class="refsect3">
479 <a name="xapp-status-icon-get-secondary-menu.parameters"></a><h4>Parameters</h4>
480 <div class="informaltable"><table class="informaltable" width="100%" border="0">
481 <colgroup>
482 <col width="150px" class="parameters_name">
483 <col class="parameters_description">
484 <col width="200px" class="parameters_annotations">
485 </colgroup>
486 <tbody><tr>
487 <td class="parameter_name"><p>icon</p></td>
488 <td class="parameter_description"><p>an <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a></p></td>
489 <td class="parameter_annotations"> </td>
490 </tr></tbody>
491 </table></div>
492 </div>
493 <div class="refsect3">
494 <a name="xapp-status-icon-get-secondary-menu.returns"></a><h4>Returns</h4>
495 <p>the <a href="../gtk3/GtkMenu.html#GtkMenu-struct"><span class="type">GtkMenu</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none was set. </p>
496 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
497 </div>
498 <p class="since">Since: 1.6</p>
499 </div>
500 </div>
501 <div class="refsect1">
502 <a name="XAppStatusIcon.other_details"></a><h2>Types and Values</h2>
503 <div class="refsect2">
504 <a name="XAPP-TYPE-STATUS-ICON:CAPS"></a><h3>XAPP_TYPE_STATUS_ICON</h3>
505 <pre class="programlisting">#define XAPP_TYPE_STATUS_ICON (xapp_status_icon_get_type ())
506 </pre>
507 </div>
508 <hr>
509 <div class="refsect2">
510 <a name="XAppStatusIcon-struct"></a><h3>XAppStatusIcon</h3>
511 <pre class="programlisting">typedef struct _XAppStatusIcon XAppStatusIcon;</pre>
512 </div>
513 </div>
514 <div class="refsect1">
515 <a name="XAppStatusIcon.property-details"></a><h2>Property Details</h2>
516 <div class="refsect2">
517 <a name="XAppStatusIcon--primary-menu"></a><h3>The <code class="literal">“primary-menu”</code> property</h3>
518 <pre class="programlisting"> “primary-menu” <a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> *</pre>
519 <p>A <a href="../gtk3/GtkMenu.html#GtkMenu-struct"><span class="type">GtkMenu</span></a> to use when requested by the remote monitor via a left (or primary) click.</p>
520 <p>When this property is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the menu will be automatically positioned and
521 displayed during a primary button release.</p>
522 <p>When this property IS <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the <a class="link" href="XAppStatusIcon.html#XAppStatusIcon-activate" title="The “activate” signal"><span class="type">“activate”</span></a> will be sent for primary
523 button presses.</p>
524 <p>In both cases, the <a class="link" href="XAppStatusIcon.html#XAppStatusIcon-button-press-event" title="The “button-press-event” signal"><span class="type">“button-press-event”</span></a> and <a href="XAppStatusIcon.html#XAppStatusIcon-button-release-event"><span class="type">“button-release-events”</span></a>
525 will be fired like normal.</p>
526 <p>Setting this will remove any floating reference to the menu and assume ownership.
527 As a result, it is not necessary to maintain a reference to it in the parent
528 application (or unref it when finished with it - if you wish to replace the menu,
529 simply call this method again with a new menu.</p>
530 <p>The same <a href="../gtk3/GtkMenu.html#GtkMenu-struct"><span class="type">GtkMenu</span></a> widget can be set as both the primary and secondary.</p>
531 <p>Flags: Read / Write</p>
532 </div>
533 <hr>
534 <div class="refsect2">
535 <a name="XAppStatusIcon--secondary-menu"></a><h3>The <code class="literal">“secondary-menu”</code> property</h3>
536 <pre class="programlisting"> “secondary-menu” <a href="../gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> *</pre>
537 <p>A <a href="../gtk3/GtkMenu.html#GtkMenu-struct"><span class="type">GtkMenu</span></a> to use when requested by the remote monitor via a right (or secondary) click.</p>
538 <p>When this property is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the menu will be automatically positioned and
539 displayed during a secondary button release.</p>
540 <p>When this property IS <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the <a class="link" href="XAppStatusIcon.html#XAppStatusIcon-activate" title="The “activate” signal"><span class="type">“activate”</span></a> will be sent for secondary
541 button presses.</p>
542 <p>In both cases, the <a class="link" href="XAppStatusIcon.html#XAppStatusIcon-button-press-event" title="The “button-press-event” signal"><span class="type">“button-press-event”</span></a> and <a href="XAppStatusIcon.html#XAppStatusIcon-button-release-event"><span class="type">“button-release-events”</span></a>
543 will be fired like normal.</p>
544 <p>Setting this will remove any floating reference to the menu and assume ownership.
545 As a result, it is not necessary to maintain a reference to it in the parent
546 application (or unref it when finished with it - if you wish to replace the menu,
547 simply call this method again with a new menu.</p>
548 <p>The same <a href="../gtk3/GtkMenu.html#GtkMenu-struct"><span class="type">GtkMenu</span></a> widget can be set as both the primary and secondary.</p>
549 <p>Flags: Read / Write</p>
550 </div>
551 </div>
552 <div class="refsect1">
553 <a name="XAppStatusIcon.signal-details"></a><h2>Signal Details</h2>
554 <div class="refsect2">
555 <a name="XAppStatusIcon-activate"></a><h3>The <code class="literal">“activate”</code> signal</h3>
556 <pre class="programlisting"><span class="returnvalue">void</span>
557 user_function (<a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a> *icon,
558 <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> button,
559 <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> time,
560 <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
561 <p>Gets emitted when the user activates the status icon. If the XAppStatusIcon:primary-menu or
562 XAppStatusIcon:secondary-menu is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, this signal is skipped for the respective button
563 presses. A middle button click will always send this signal when pressed.</p>
564 <div class="refsect3">
565 <a name="XAppStatusIcon-activate.parameters"></a><h4>Parameters</h4>
566 <div class="informaltable"><table class="informaltable" width="100%" border="0">
567 <colgroup>
568 <col width="150px" class="parameters_name">
569 <col class="parameters_description">
570 <col width="200px" class="parameters_annotations">
571 </colgroup>
572 <tbody>
573 <tr>
574 <td class="parameter_name"><p>icon</p></td>
575 <td class="parameter_description"><p>The <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a></p></td>
576 <td class="parameter_annotations"> </td>
577 </tr>
578 <tr>
579 <td class="parameter_name"><p>button</p></td>
580 <td class="parameter_description"><p>The button that was pressed</p></td>
581 <td class="parameter_annotations"> </td>
582 </tr>
583 <tr>
584 <td class="parameter_name"><p>time</p></td>
585 <td class="parameter_description"><p>The time supplied by the event, or 0</p></td>
586 <td class="parameter_annotations"> </td>
587 </tr>
588 <tr>
589 <td class="parameter_name"><p>user_data</p></td>
590 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
591 <td class="parameter_annotations"> </td>
592 </tr>
593 </tbody>
594 </table></div>
595 </div>
596 <p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
597 </div>
598 <hr>
599 <div class="refsect2">
600 <a name="XAppStatusIcon-button-press-event"></a><h3>The <code class="literal">“button-press-event”</code> signal</h3>
601 <pre class="programlisting"><span class="returnvalue">void</span>
602 user_function (<a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a> *icon,
603 <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x,
604 <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y,
605 <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> button,
606 <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> time,
607 <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> panel_position,
608 <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
609 <p>Gets emitted when there is a button press received from an applet</p>
610 <div class="refsect3">
611 <a name="XAppStatusIcon-button-press-event.parameters"></a><h4>Parameters</h4>
612 <div class="informaltable"><table class="informaltable" width="100%" border="0">
613 <colgroup>
614 <col width="150px" class="parameters_name">
615 <col class="parameters_description">
616 <col width="200px" class="parameters_annotations">
617 </colgroup>
618 <tbody>
619 <tr>
620 <td class="parameter_name"><p>icon</p></td>
621 <td class="parameter_description"><p>The <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a></p></td>
622 <td class="parameter_annotations"> </td>
623 </tr>
624 <tr>
625 <td class="parameter_name"><p>x</p></td>
626 <td class="parameter_description"><p>The absolute x position to use for menu positioning</p></td>
627 <td class="parameter_annotations"> </td>
628 </tr>
629 <tr>
630 <td class="parameter_name"><p>y</p></td>
631 <td class="parameter_description"><p>The absolute y position to use for menu positioning</p></td>
632 <td class="parameter_annotations"> </td>
633 </tr>
634 <tr>
635 <td class="parameter_name"><p>button</p></td>
636 <td class="parameter_description"><p>The button that was pressed</p></td>
637 <td class="parameter_annotations"> </td>
638 </tr>
639 <tr>
640 <td class="parameter_name"><p>time</p></td>
641 <td class="parameter_description"><p>The time supplied by the event, or 0</p></td>
642 <td class="parameter_annotations"> </td>
643 </tr>
644 <tr>
645 <td class="parameter_name"><p>panel_position</p></td>
646 <td class="parameter_description"><p>The <a href="../gtk3/gtk3-Standard-Enumerations.html#GtkPositionType"><span class="type">GtkPositionType</span></a> to use for menu positioning</p></td>
647 <td class="parameter_annotations"> </td>
648 </tr>
649 <tr>
650 <td class="parameter_name"><p>user_data</p></td>
651 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
652 <td class="parameter_annotations"> </td>
653 </tr>
654 </tbody>
655 </table></div>
656 </div>
657 <p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
658 </div>
659 <hr>
660 <div class="refsect2">
661 <a name="XAppStatusIcon-button-release-event"></a><h3>The <code class="literal">“button-release-event”</code> signal</h3>
662 <pre class="programlisting"><span class="returnvalue">void</span>
663 user_function (<a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a> *icon,
664 <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x,
665 <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y,
666 <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> button,
667 <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> time,
668 <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> panel_position,
669 <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
670 <p>Gets emitted when there is a button release received from an applet</p>
671 <div class="refsect3">
672 <a name="XAppStatusIcon-button-release-event.parameters"></a><h4>Parameters</h4>
673 <div class="informaltable"><table class="informaltable" width="100%" border="0">
674 <colgroup>
675 <col width="150px" class="parameters_name">
676 <col class="parameters_description">
677 <col width="200px" class="parameters_annotations">
678 </colgroup>
679 <tbody>
680 <tr>
681 <td class="parameter_name"><p>icon</p></td>
682 <td class="parameter_description"><p>The <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a></p></td>
683 <td class="parameter_annotations"> </td>
684 </tr>
685 <tr>
686 <td class="parameter_name"><p>x</p></td>
687 <td class="parameter_description"><p>The absolute x position to use for menu positioning</p></td>
688 <td class="parameter_annotations"> </td>
689 </tr>
690 <tr>
691 <td class="parameter_name"><p>y</p></td>
692 <td class="parameter_description"><p>The absolute y position to use for menu positioning</p></td>
693 <td class="parameter_annotations"> </td>
694 </tr>
695 <tr>
696 <td class="parameter_name"><p>button</p></td>
697 <td class="parameter_description"><p>The button that was released</p></td>
698 <td class="parameter_annotations"> </td>
699 </tr>
700 <tr>
701 <td class="parameter_name"><p>time</p></td>
702 <td class="parameter_description"><p>The time supplied by the event, or 0</p></td>
703 <td class="parameter_annotations"> </td>
704 </tr>
705 <tr>
706 <td class="parameter_name"><p>panel_position</p></td>
707 <td class="parameter_description"><p>The <a href="../gtk3/gtk3-Standard-Enumerations.html#GtkPositionType"><span class="type">GtkPositionType</span></a> to use for menu positioning</p></td>
708 <td class="parameter_annotations"> </td>
709 </tr>
710 <tr>
711 <td class="parameter_name"><p>user_data</p></td>
712 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
713 <td class="parameter_annotations"> </td>
714 </tr>
715 </tbody>
716 </table></div>
717 </div>
718 <p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
719 </div>
720 </div>
721 </div>
722 <div class="footer">
723 <hr>Generated by GTK-Doc V1.27</div>
724 </body>
725 </html>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>XAppStatusIconInterfaceSkeleton: XApp Reference Manual</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
6 <link rel="home" href="index.html" title="XApp Reference Manual">
7 <link rel="up" href="ch01.html" title="API reference">
8 <link rel="prev" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor">
9 <link rel="next" href="object-tree.html" title="Object Hierarchy">
10 <meta name="generator" content="GTK-Doc V1.27 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 </head>
13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
15 <td width="100%" align="left" class="shortcuts">
16 <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
17 <a href="#XAppStatusIconInterfaceSkeleton.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
18 <a href="#XAppStatusIconInterfaceSkeleton.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties">  <span class="dim">|</span> 
19 <a href="#XAppStatusIconInterfaceSkeleton.properties" class="shortcut">Properties</a></span><span id="nav_signals">  <span class="dim">|</span> 
20 <a href="#XAppStatusIconInterfaceSkeleton.signals" class="shortcut">Signals</a></span>
21 </td>
22 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
23 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
24 <td><a accesskey="p" href="XAppStatusIconMonitor.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
25 <td><a accesskey="n" href="object-tree.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
26 </tr></table>
27 <div class="refentry">
28 <a name="XAppStatusIconInterfaceSkeleton"></a><div class="titlepage"></div>
29 <div class="refnamediv"><table width="100%"><tr>
30 <td valign="top">
31 <h2><span class="refentrytitle"><a name="XAppStatusIconInterfaceSkeleton.top_of_page"></a>XAppStatusIconInterfaceSkeleton</span></h2>
32 <p>XAppStatusIconInterfaceSkeleton</p>
33 </td>
34 <td class="gallery_image" valign="top" align="right"></td>
35 </tr></table></div>
36 <div class="refsect1">
37 <a name="XAppStatusIconInterfaceSkeleton.functions"></a><h2>Functions</h2>
38 <div class="informaltable"><table class="informaltable" width="100%" border="0">
39 <colgroup>
40 <col width="150px" class="functions_return">
41 <col class="functions_name">
42 </colgroup>
43 <tbody>
44 <tr>
45 <td class="function_type">
46 <a href="../gio/gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo-struct"><span class="returnvalue">GDBusInterfaceInfo</span></a> *
47 </td>
48 <td class="function_name">
49 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-interface-info" title="xapp_status_icon_interface_interface_info ()">xapp_status_icon_interface_interface_info</a> <span class="c_punctuation">()</span>
50 </td>
51 </tr>
52 <tr>
53 <td class="function_type">
54 <a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
55 </td>
56 <td class="function_name">
57 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-override-properties" title="xapp_status_icon_interface_override_properties ()">xapp_status_icon_interface_override_properties</a> <span class="c_punctuation">()</span>
58 </td>
59 </tr>
60 <tr>
61 <td class="function_type">
62 <span class="returnvalue">void</span>
63 </td>
64 <td class="function_name">
65 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-complete-button-press" title="xapp_status_icon_interface_complete_button_press ()">xapp_status_icon_interface_complete_button_press</a> <span class="c_punctuation">()</span>
66 </td>
67 </tr>
68 <tr>
69 <td class="function_type">
70 <span class="returnvalue">void</span>
71 </td>
72 <td class="function_name">
73 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-complete-button-release" title="xapp_status_icon_interface_complete_button_release ()">xapp_status_icon_interface_complete_button_release</a> <span class="c_punctuation">()</span>
74 </td>
75 </tr>
76 <tr>
77 <td class="function_type">
78 <span class="returnvalue">void</span>
79 </td>
80 <td class="function_name">
81 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-press" title="xapp_status_icon_interface_call_button_press ()">xapp_status_icon_interface_call_button_press</a> <span class="c_punctuation">()</span>
82 </td>
83 </tr>
84 <tr>
85 <td class="function_type">
86 <a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
87 </td>
88 <td class="function_name">
89 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-press-finish" title="xapp_status_icon_interface_call_button_press_finish ()">xapp_status_icon_interface_call_button_press_finish</a> <span class="c_punctuation">()</span>
90 </td>
91 </tr>
92 <tr>
93 <td class="function_type">
94 <a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
95 </td>
96 <td class="function_name">
97 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-press-sync" title="xapp_status_icon_interface_call_button_press_sync ()">xapp_status_icon_interface_call_button_press_sync</a> <span class="c_punctuation">()</span>
98 </td>
99 </tr>
100 <tr>
101 <td class="function_type">
102 <span class="returnvalue">void</span>
103 </td>
104 <td class="function_name">
105 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-release" title="xapp_status_icon_interface_call_button_release ()">xapp_status_icon_interface_call_button_release</a> <span class="c_punctuation">()</span>
106 </td>
107 </tr>
108 <tr>
109 <td class="function_type">
110 <a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
111 </td>
112 <td class="function_name">
113 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-release-finish" title="xapp_status_icon_interface_call_button_release_finish ()">xapp_status_icon_interface_call_button_release_finish</a> <span class="c_punctuation">()</span>
114 </td>
115 </tr>
116 <tr>
117 <td class="function_type">
118 <a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
119 </td>
120 <td class="function_name">
121 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-release-sync" title="xapp_status_icon_interface_call_button_release_sync ()">xapp_status_icon_interface_call_button_release_sync</a> <span class="c_punctuation">()</span>
122 </td>
123 </tr>
124 <tr>
125 <td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
126 </td>
127 <td class="function_name">
128 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-get-name" title="xapp_status_icon_interface_get_name ()">xapp_status_icon_interface_get_name</a> <span class="c_punctuation">()</span>
129 </td>
130 </tr>
131 <tr>
132 <td class="function_type">
133 <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
134 </td>
135 <td class="function_name">
136 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-dup-name" title="xapp_status_icon_interface_dup_name ()">xapp_status_icon_interface_dup_name</a> <span class="c_punctuation">()</span>
137 </td>
138 </tr>
139 <tr>
140 <td class="function_type">
141 <span class="returnvalue">void</span>
142 </td>
143 <td class="function_name">
144 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-set-name" title="xapp_status_icon_interface_set_name ()">xapp_status_icon_interface_set_name</a> <span class="c_punctuation">()</span>
145 </td>
146 </tr>
147 <tr>
148 <td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
149 </td>
150 <td class="function_name">
151 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-get-icon-name" title="xapp_status_icon_interface_get_icon_name ()">xapp_status_icon_interface_get_icon_name</a> <span class="c_punctuation">()</span>
152 </td>
153 </tr>
154 <tr>
155 <td class="function_type">
156 <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
157 </td>
158 <td class="function_name">
159 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-dup-icon-name" title="xapp_status_icon_interface_dup_icon_name ()">xapp_status_icon_interface_dup_icon_name</a> <span class="c_punctuation">()</span>
160 </td>
161 </tr>
162 <tr>
163 <td class="function_type">
164 <span class="returnvalue">void</span>
165 </td>
166 <td class="function_name">
167 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-set-icon-name" title="xapp_status_icon_interface_set_icon_name ()">xapp_status_icon_interface_set_icon_name</a> <span class="c_punctuation">()</span>
168 </td>
169 </tr>
170 <tr>
171 <td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
172 </td>
173 <td class="function_name">
174 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-get-tooltip-text" title="xapp_status_icon_interface_get_tooltip_text ()">xapp_status_icon_interface_get_tooltip_text</a> <span class="c_punctuation">()</span>
175 </td>
176 </tr>
177 <tr>
178 <td class="function_type">
179 <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
180 </td>
181 <td class="function_name">
182 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-dup-tooltip-text" title="xapp_status_icon_interface_dup_tooltip_text ()">xapp_status_icon_interface_dup_tooltip_text</a> <span class="c_punctuation">()</span>
183 </td>
184 </tr>
185 <tr>
186 <td class="function_type">
187 <span class="returnvalue">void</span>
188 </td>
189 <td class="function_name">
190 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-set-tooltip-text" title="xapp_status_icon_interface_set_tooltip_text ()">xapp_status_icon_interface_set_tooltip_text</a> <span class="c_punctuation">()</span>
191 </td>
192 </tr>
193 <tr>
194 <td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
195 </td>
196 <td class="function_name">
197 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-get-label" title="xapp_status_icon_interface_get_label ()">xapp_status_icon_interface_get_label</a> <span class="c_punctuation">()</span>
198 </td>
199 </tr>
200 <tr>
201 <td class="function_type">
202 <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
203 </td>
204 <td class="function_name">
205 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-dup-label" title="xapp_status_icon_interface_dup_label ()">xapp_status_icon_interface_dup_label</a> <span class="c_punctuation">()</span>
206 </td>
207 </tr>
208 <tr>
209 <td class="function_type">
210 <span class="returnvalue">void</span>
211 </td>
212 <td class="function_name">
213 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-set-label" title="xapp_status_icon_interface_set_label ()">xapp_status_icon_interface_set_label</a> <span class="c_punctuation">()</span>
214 </td>
215 </tr>
216 <tr>
217 <td class="function_type">
218 <a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
219 </td>
220 <td class="function_name">
221 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-get-visible" title="xapp_status_icon_interface_get_visible ()">xapp_status_icon_interface_get_visible</a> <span class="c_punctuation">()</span>
222 </td>
223 </tr>
224 <tr>
225 <td class="function_type">
226 <span class="returnvalue">void</span>
227 </td>
228 <td class="function_name">
229 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-set-visible" title="xapp_status_icon_interface_set_visible ()">xapp_status_icon_interface_set_visible</a> <span class="c_punctuation">()</span>
230 </td>
231 </tr>
232 <tr>
233 <td class="function_type">
234 <span class="returnvalue">void</span>
235 </td>
236 <td class="function_name">
237 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new" title="xapp_status_icon_interface_proxy_new ()">xapp_status_icon_interface_proxy_new</a> <span class="c_punctuation">()</span>
238 </td>
239 </tr>
240 <tr>
241 <td class="function_type">
242 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="returnvalue">XAppStatusIconInterface</span></a> *
243 </td>
244 <td class="function_name">
245 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-finish" title="xapp_status_icon_interface_proxy_new_finish ()">xapp_status_icon_interface_proxy_new_finish</a> <span class="c_punctuation">()</span>
246 </td>
247 </tr>
248 <tr>
249 <td class="function_type">
250 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="returnvalue">XAppStatusIconInterface</span></a> *
251 </td>
252 <td class="function_name">
253 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-sync" title="xapp_status_icon_interface_proxy_new_sync ()">xapp_status_icon_interface_proxy_new_sync</a> <span class="c_punctuation">()</span>
254 </td>
255 </tr>
256 <tr>
257 <td class="function_type">
258 <span class="returnvalue">void</span>
259 </td>
260 <td class="function_name">
261 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-for-bus" title="xapp_status_icon_interface_proxy_new_for_bus ()">xapp_status_icon_interface_proxy_new_for_bus</a> <span class="c_punctuation">()</span>
262 </td>
263 </tr>
264 <tr>
265 <td class="function_type">
266 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="returnvalue">XAppStatusIconInterface</span></a> *
267 </td>
268 <td class="function_name">
269 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-for-bus-finish" title="xapp_status_icon_interface_proxy_new_for_bus_finish ()">xapp_status_icon_interface_proxy_new_for_bus_finish</a> <span class="c_punctuation">()</span>
270 </td>
271 </tr>
272 <tr>
273 <td class="function_type">
274 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="returnvalue">XAppStatusIconInterface</span></a> *
275 </td>
276 <td class="function_name">
277 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-for-bus-sync" title="xapp_status_icon_interface_proxy_new_for_bus_sync ()">xapp_status_icon_interface_proxy_new_for_bus_sync</a> <span class="c_punctuation">()</span>
278 </td>
279 </tr>
280 <tr>
281 <td class="function_type">
282 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="returnvalue">XAppStatusIconInterface</span></a> *
283 </td>
284 <td class="function_name">
285 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-skeleton-new" title="xapp_status_icon_interface_skeleton_new ()">xapp_status_icon_interface_skeleton_new</a> <span class="c_punctuation">()</span>
286 </td>
287 </tr>
288 </tbody>
289 </table></div>
290 </div>
291 <div class="refsect1">
292 <a name="XAppStatusIconInterfaceSkeleton.properties"></a><h2>Properties</h2>
293 <div class="informaltable"><table class="informaltable" border="0">
294 <colgroup>
295 <col width="150px" class="properties_type">
296 <col width="300px" class="properties_name">
297 <col width="200px" class="properties_flags">
298 </colgroup>
299 <tbody>
300 <tr>
301 <td class="property_type">
302 <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
303 <td class="property_name"><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface--icon-name" title="The “icon-name” property">icon-name</a></td>
304 <td class="property_flags">Read / Write</td>
305 </tr>
306 <tr>
307 <td class="property_type">
308 <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
309 <td class="property_name"><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface--label" title="The “label” property">label</a></td>
310 <td class="property_flags">Read / Write</td>
311 </tr>
312 <tr>
313 <td class="property_type">
314 <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
315 <td class="property_name"><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface--name" title="The “name” property">name</a></td>
316 <td class="property_flags">Read / Write</td>
317 </tr>
318 <tr>
319 <td class="property_type">
320 <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
321 <td class="property_name"><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface--tooltip-text" title="The “tooltip-text” property">tooltip-text</a></td>
322 <td class="property_flags">Read / Write</td>
323 </tr>
324 <tr>
325 <td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
326 <td class="property_name"><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface--visible" title="The “visible” property">visible</a></td>
327 <td class="property_flags">Read / Write</td>
328 </tr>
329 </tbody>
330 </table></div>
331 </div>
332 <div class="refsect1">
333 <a name="XAppStatusIconInterfaceSkeleton.signals"></a><h2>Signals</h2>
334 <div class="informaltable"><table class="informaltable" border="0">
335 <colgroup>
336 <col width="150px" class="signals_return">
337 <col width="300px" class="signals_name">
338 <col width="200px" class="signals_flags">
339 </colgroup>
340 <tbody>
341 <tr>
342 <td class="signal_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
343 <td class="signal_name"><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface-handle-button-press" title="The “handle-button-press” signal">handle-button-press</a></td>
344 <td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
345 </tr>
346 <tr>
347 <td class="signal_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
348 <td class="signal_name"><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface-handle-button-release" title="The “handle-button-release” signal">handle-button-release</a></td>
349 <td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
350 </tr>
351 </tbody>
352 </table></div>
353 </div>
354 <a name="XAppStatusIconInterface"></a><a name="XAppStatusIconInterfaceProxy"></a><div class="refsect1">
355 <a name="XAppStatusIconInterfaceSkeleton.object-hierarchy"></a><h2>Object Hierarchy</h2>
356 <pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/GTypeModule.html">GInterface</a>
357 <span class="lineart">╰──</span> XAppStatusIconInterface
358 <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
359 <span class="lineart">├──</span> <a href="../gio/GDBusInterfaceSkeleton.html#GDBusInterfaceSkeleton-struct">GDBusInterfaceSkeleton</a>
360 <span class="lineart">│</span> <span class="lineart">╰──</span> XAppStatusIconInterfaceSkeleton
361 <span class="lineart">╰──</span> <a href="../gio/GDBusProxy.html#GDBusProxy-struct">GDBusProxy</a>
362 <span class="lineart">╰──</span> XAppStatusIconInterfaceProxy
363 </pre>
364 </div>
365 <div class="refsect1">
366 <a name="XAppStatusIconInterfaceSkeleton.description"></a><h2>Description</h2>
367 </div>
368 <div class="refsect1">
369 <a name="XAppStatusIconInterfaceSkeleton.functions_details"></a><h2>Functions</h2>
370 <div class="refsect2">
371 <a name="xapp-status-icon-interface-interface-info"></a><h3>xapp_status_icon_interface_interface_info ()</h3>
372 <pre class="programlisting"><a href="../gio/gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo-struct"><span class="returnvalue">GDBusInterfaceInfo</span></a> *
373 xapp_status_icon_interface_interface_info
374 (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
375 <p>Gets a machine-readable description of the org.x.StatusIcon D-Bus interface.</p>
376 <div class="refsect3">
377 <a name="xapp-status-icon-interface-interface-info.returns"></a><h4>Returns</h4>
378 <p>A <a href="../gio/gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo-struct"><span class="type">GDBusInterfaceInfo</span></a>. Do not free. </p>
379 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
380 </div>
381 </div>
382 <hr>
383 <div class="refsect2">
384 <a name="xapp-status-icon-interface-override-properties"></a><h3>xapp_status_icon_interface_override_properties ()</h3>
385 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
386 xapp_status_icon_interface_override_properties
387 (<em class="parameter"><code><a href="../gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *klass</code></em>,
388 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property_id_begin</code></em>);</pre>
389 <p>Overrides all <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> properties in the <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> interface for a concrete class.
390 The properties are overridden in the order they are defined.</p>
391 <div class="refsect3">
392 <a name="xapp-status-icon-interface-override-properties.parameters"></a><h4>Parameters</h4>
393 <div class="informaltable"><table class="informaltable" width="100%" border="0">
394 <colgroup>
395 <col width="150px" class="parameters_name">
396 <col class="parameters_description">
397 <col width="200px" class="parameters_annotations">
398 </colgroup>
399 <tbody>
400 <tr>
401 <td class="parameter_name"><p>klass</p></td>
402 <td class="parameter_description"><p>The class structure for a <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> derived class.</p></td>
403 <td class="parameter_annotations"> </td>
404 </tr>
405 <tr>
406 <td class="parameter_name"><p>property_id_begin</p></td>
407 <td class="parameter_description"><p>The property id to assign to the first overridden property.</p></td>
408 <td class="parameter_annotations"> </td>
409 </tr>
410 </tbody>
411 </table></div>
412 </div>
413 <div class="refsect3">
414 <a name="xapp-status-icon-interface-override-properties.returns"></a><h4>Returns</h4>
415 <p> The last property id.</p>
416 </div>
417 </div>
418 <hr>
419 <div class="refsect2">
420 <a name="xapp-status-icon-interface-complete-button-press"></a><h3>xapp_status_icon_interface_complete_button_press ()</h3>
421 <pre class="programlisting"><span class="returnvalue">void</span>
422 xapp_status_icon_interface_complete_button_press
423 (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object</code></em>,
424 <em class="parameter"><code><a href="../gio/GDBusMethodInvocation.html#GDBusMethodInvocation-struct"><span class="type">GDBusMethodInvocation</span></a> *invocation</code></em>);</pre>
425 <p>Helper function used in service implementations to finish handling invocations of the <GTKDOCLINK HREF="ButtonPress"><code class="function">ButtonPress()</code></GTKDOCLINK> D-Bus method. If you instead want to finish handling an invocation by returning an error, use <a href="../gio/GDBusMethodInvocation.html#g-dbus-method-invocation-return-error"><code class="function">g_dbus_method_invocation_return_error()</code></a> or similar.</p>
426 <p>This method will free <em class="parameter"><code>invocation</code></em>
427 , you cannot use it afterwards.</p>
428 <div class="refsect3">
429 <a name="xapp-status-icon-interface-complete-button-press.parameters"></a><h4>Parameters</h4>
430 <div class="informaltable"><table class="informaltable" width="100%" border="0">
431 <colgroup>
432 <col width="150px" class="parameters_name">
433 <col class="parameters_description">
434 <col width="200px" class="parameters_annotations">
435 </colgroup>
436 <tbody>
437 <tr>
438 <td class="parameter_name"><p>object</p></td>
439 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
440 <td class="parameter_annotations"> </td>
441 </tr>
442 <tr>
443 <td class="parameter_name"><p>invocation</p></td>
444 <td class="parameter_description"><p>A <a href="../gio/GDBusMethodInvocation.html#GDBusMethodInvocation-struct"><span class="type">GDBusMethodInvocation</span></a>. </p></td>
445 <td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
446 </tr>
447 </tbody>
448 </table></div>
449 </div>
450 </div>
451 <hr>
452 <div class="refsect2">
453 <a name="xapp-status-icon-interface-complete-button-release"></a><h3>xapp_status_icon_interface_complete_button_release ()</h3>
454 <pre class="programlisting"><span class="returnvalue">void</span>
455 xapp_status_icon_interface_complete_button_release
456 (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object</code></em>,
457 <em class="parameter"><code><a href="../gio/GDBusMethodInvocation.html#GDBusMethodInvocation-struct"><span class="type">GDBusMethodInvocation</span></a> *invocation</code></em>);</pre>
458 <p>Helper function used in service implementations to finish handling invocations of the <GTKDOCLINK HREF="ButtonRelease"><code class="function">ButtonRelease()</code></GTKDOCLINK> D-Bus method. If you instead want to finish handling an invocation by returning an error, use <a href="../gio/GDBusMethodInvocation.html#g-dbus-method-invocation-return-error"><code class="function">g_dbus_method_invocation_return_error()</code></a> or similar.</p>
459 <p>This method will free <em class="parameter"><code>invocation</code></em>
460 , you cannot use it afterwards.</p>
461 <div class="refsect3">
462 <a name="xapp-status-icon-interface-complete-button-release.parameters"></a><h4>Parameters</h4>
463 <div class="informaltable"><table class="informaltable" width="100%" border="0">
464 <colgroup>
465 <col width="150px" class="parameters_name">
466 <col class="parameters_description">
467 <col width="200px" class="parameters_annotations">
468 </colgroup>
469 <tbody>
470 <tr>
471 <td class="parameter_name"><p>object</p></td>
472 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
473 <td class="parameter_annotations"> </td>
474 </tr>
475 <tr>
476 <td class="parameter_name"><p>invocation</p></td>
477 <td class="parameter_description"><p>A <a href="../gio/GDBusMethodInvocation.html#GDBusMethodInvocation-struct"><span class="type">GDBusMethodInvocation</span></a>. </p></td>
478 <td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
479 </tr>
480 </tbody>
481 </table></div>
482 </div>
483 </div>
484 <hr>
485 <div class="refsect2">
486 <a name="xapp-status-icon-interface-call-button-press"></a><h3>xapp_status_icon_interface_call_button_press ()</h3>
487 <pre class="programlisting"><span class="returnvalue">void</span>
488 xapp_status_icon_interface_call_button_press
489 (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *proxy</code></em>,
490 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_x</code></em>,
491 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_y</code></em>,
492 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_button</code></em>,
493 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_time</code></em>,
494 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_panel_position</code></em>,
495 <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
496 <em class="parameter"><code><a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
497 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
498 <p>Asynchronously invokes the <GTKDOCLINK HREF="ButtonPress"><code class="function">ButtonPress()</code></GTKDOCLINK> D-Bus method on <em class="parameter"><code>proxy</code></em>
499 .
500 When the operation is finished, <em class="parameter"><code>callback</code></em>
501 will be invoked in the <a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main loop</a> of the thread you are calling this method from.
502 You can then call <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-press-finish" title="xapp_status_icon_interface_call_button_press_finish ()"><code class="function">xapp_status_icon_interface_call_button_press_finish()</code></a> to get the result of the operation.</p>
503 <p>See <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-press-sync" title="xapp_status_icon_interface_call_button_press_sync ()"><code class="function">xapp_status_icon_interface_call_button_press_sync()</code></a> for the synchronous, blocking version of this method.</p>
504 <div class="refsect3">
505 <a name="xapp-status-icon-interface-call-button-press.parameters"></a><h4>Parameters</h4>
506 <div class="informaltable"><table class="informaltable" width="100%" border="0">
507 <colgroup>
508 <col width="150px" class="parameters_name">
509 <col class="parameters_description">
510 <col width="200px" class="parameters_annotations">
511 </colgroup>
512 <tbody>
513 <tr>
514 <td class="parameter_name"><p>proxy</p></td>
515 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterfaceProxy"><span class="type">XAppStatusIconInterfaceProxy</span></a>.</p></td>
516 <td class="parameter_annotations"> </td>
517 </tr>
518 <tr>
519 <td class="parameter_name"><p>arg_x</p></td>
520 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
521 <td class="parameter_annotations"> </td>
522 </tr>
523 <tr>
524 <td class="parameter_name"><p>arg_y</p></td>
525 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
526 <td class="parameter_annotations"> </td>
527 </tr>
528 <tr>
529 <td class="parameter_name"><p>arg_button</p></td>
530 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
531 <td class="parameter_annotations"> </td>
532 </tr>
533 <tr>
534 <td class="parameter_name"><p>arg_time</p></td>
535 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
536 <td class="parameter_annotations"> </td>
537 </tr>
538 <tr>
539 <td class="parameter_name"><p>arg_panel_position</p></td>
540 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
541 <td class="parameter_annotations"> </td>
542 </tr>
543 <tr>
544 <td class="parameter_name"><p>cancellable</p></td>
545 <td class="parameter_description"><p>A <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
546 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
547 </tr>
548 <tr>
549 <td class="parameter_name"><p>callback</p></td>
550 <td class="parameter_description"><p>A <a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
551 <td class="parameter_annotations"> </td>
552 </tr>
553 <tr>
554 <td class="parameter_name"><p>user_data</p></td>
555 <td class="parameter_description"><p>User data to pass to <em class="parameter"><code>callback</code></em>
556 .</p></td>
557 <td class="parameter_annotations"> </td>
558 </tr>
559 </tbody>
560 </table></div>
561 </div>
562 </div>
563 <hr>
564 <div class="refsect2">
565 <a name="xapp-status-icon-interface-call-button-press-finish"></a><h3>xapp_status_icon_interface_call_button_press_finish ()</h3>
566 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
567 xapp_status_icon_interface_call_button_press_finish
568 (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *proxy</code></em>,
569 <em class="parameter"><code><a href="../gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *res</code></em>,
570 <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
571 <p>Finishes an operation started with <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-press" title="xapp_status_icon_interface_call_button_press ()"><code class="function">xapp_status_icon_interface_call_button_press()</code></a>.</p>
572 <div class="refsect3">
573 <a name="xapp-status-icon-interface-call-button-press-finish.parameters"></a><h4>Parameters</h4>
574 <div class="informaltable"><table class="informaltable" width="100%" border="0">
575 <colgroup>
576 <col width="150px" class="parameters_name">
577 <col class="parameters_description">
578 <col width="200px" class="parameters_annotations">
579 </colgroup>
580 <tbody>
581 <tr>
582 <td class="parameter_name"><p>proxy</p></td>
583 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterfaceProxy"><span class="type">XAppStatusIconInterfaceProxy</span></a>.</p></td>
584 <td class="parameter_annotations"> </td>
585 </tr>
586 <tr>
587 <td class="parameter_name"><p>res</p></td>
588 <td class="parameter_description"><p>The <a href="../gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> obtained from the <a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> passed to <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-press" title="xapp_status_icon_interface_call_button_press ()"><code class="function">xapp_status_icon_interface_call_button_press()</code></a>.</p></td>
589 <td class="parameter_annotations"> </td>
590 </tr>
591 <tr>
592 <td class="parameter_name"><p>error</p></td>
593 <td class="parameter_description"><p>Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
594 <td class="parameter_annotations"> </td>
595 </tr>
596 </tbody>
597 </table></div>
598 </div>
599 <div class="refsect3">
600 <a name="xapp-status-icon-interface-call-button-press-finish.returns"></a><h4>Returns</h4>
601 <p><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the call succeded, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <em class="parameter"><code>error</code></em>
602 is set. </p>
603 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
604 </div>
605 </div>
606 <hr>
607 <div class="refsect2">
608 <a name="xapp-status-icon-interface-call-button-press-sync"></a><h3>xapp_status_icon_interface_call_button_press_sync ()</h3>
609 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
610 xapp_status_icon_interface_call_button_press_sync
611 (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *proxy</code></em>,
612 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_x</code></em>,
613 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_y</code></em>,
614 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_button</code></em>,
615 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_time</code></em>,
616 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_panel_position</code></em>,
617 <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
618 <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
619 <p>Synchronously invokes the <GTKDOCLINK HREF="ButtonPress"><code class="function">ButtonPress()</code></GTKDOCLINK> D-Bus method on <em class="parameter"><code>proxy</code></em>
620 . The calling thread is blocked until a reply is received.</p>
621 <p>See <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-press" title="xapp_status_icon_interface_call_button_press ()"><code class="function">xapp_status_icon_interface_call_button_press()</code></a> for the asynchronous version of this method.</p>
622 <div class="refsect3">
623 <a name="xapp-status-icon-interface-call-button-press-sync.parameters"></a><h4>Parameters</h4>
624 <div class="informaltable"><table class="informaltable" width="100%" border="0">
625 <colgroup>
626 <col width="150px" class="parameters_name">
627 <col class="parameters_description">
628 <col width="200px" class="parameters_annotations">
629 </colgroup>
630 <tbody>
631 <tr>
632 <td class="parameter_name"><p>proxy</p></td>
633 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterfaceProxy"><span class="type">XAppStatusIconInterfaceProxy</span></a>.</p></td>
634 <td class="parameter_annotations"> </td>
635 </tr>
636 <tr>
637 <td class="parameter_name"><p>arg_x</p></td>
638 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
639 <td class="parameter_annotations"> </td>
640 </tr>
641 <tr>
642 <td class="parameter_name"><p>arg_y</p></td>
643 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
644 <td class="parameter_annotations"> </td>
645 </tr>
646 <tr>
647 <td class="parameter_name"><p>arg_button</p></td>
648 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
649 <td class="parameter_annotations"> </td>
650 </tr>
651 <tr>
652 <td class="parameter_name"><p>arg_time</p></td>
653 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
654 <td class="parameter_annotations"> </td>
655 </tr>
656 <tr>
657 <td class="parameter_name"><p>arg_panel_position</p></td>
658 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
659 <td class="parameter_annotations"> </td>
660 </tr>
661 <tr>
662 <td class="parameter_name"><p>cancellable</p></td>
663 <td class="parameter_description"><p>A <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
664 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
665 </tr>
666 <tr>
667 <td class="parameter_name"><p>error</p></td>
668 <td class="parameter_description"><p>Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
669 <td class="parameter_annotations"> </td>
670 </tr>
671 </tbody>
672 </table></div>
673 </div>
674 <div class="refsect3">
675 <a name="xapp-status-icon-interface-call-button-press-sync.returns"></a><h4>Returns</h4>
676 <p><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the call succeded, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <em class="parameter"><code>error</code></em>
677 is set. </p>
678 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
679 </div>
680 </div>
681 <hr>
682 <div class="refsect2">
683 <a name="xapp-status-icon-interface-call-button-release"></a><h3>xapp_status_icon_interface_call_button_release ()</h3>
684 <pre class="programlisting"><span class="returnvalue">void</span>
685 xapp_status_icon_interface_call_button_release
686 (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *proxy</code></em>,
687 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_x</code></em>,
688 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_y</code></em>,
689 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_button</code></em>,
690 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_time</code></em>,
691 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_panel_position</code></em>,
692 <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
693 <em class="parameter"><code><a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
694 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
695 <p>Asynchronously invokes the <GTKDOCLINK HREF="ButtonRelease"><code class="function">ButtonRelease()</code></GTKDOCLINK> D-Bus method on <em class="parameter"><code>proxy</code></em>
696 .
697 When the operation is finished, <em class="parameter"><code>callback</code></em>
698 will be invoked in the <a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main loop</a> of the thread you are calling this method from.
699 You can then call <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-release-finish" title="xapp_status_icon_interface_call_button_release_finish ()"><code class="function">xapp_status_icon_interface_call_button_release_finish()</code></a> to get the result of the operation.</p>
700 <p>See <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-release-sync" title="xapp_status_icon_interface_call_button_release_sync ()"><code class="function">xapp_status_icon_interface_call_button_release_sync()</code></a> for the synchronous, blocking version of this method.</p>
701 <div class="refsect3">
702 <a name="xapp-status-icon-interface-call-button-release.parameters"></a><h4>Parameters</h4>
703 <div class="informaltable"><table class="informaltable" width="100%" border="0">
704 <colgroup>
705 <col width="150px" class="parameters_name">
706 <col class="parameters_description">
707 <col width="200px" class="parameters_annotations">
708 </colgroup>
709 <tbody>
710 <tr>
711 <td class="parameter_name"><p>proxy</p></td>
712 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterfaceProxy"><span class="type">XAppStatusIconInterfaceProxy</span></a>.</p></td>
713 <td class="parameter_annotations"> </td>
714 </tr>
715 <tr>
716 <td class="parameter_name"><p>arg_x</p></td>
717 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
718 <td class="parameter_annotations"> </td>
719 </tr>
720 <tr>
721 <td class="parameter_name"><p>arg_y</p></td>
722 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
723 <td class="parameter_annotations"> </td>
724 </tr>
725 <tr>
726 <td class="parameter_name"><p>arg_button</p></td>
727 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
728 <td class="parameter_annotations"> </td>
729 </tr>
730 <tr>
731 <td class="parameter_name"><p>arg_time</p></td>
732 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
733 <td class="parameter_annotations"> </td>
734 </tr>
735 <tr>
736 <td class="parameter_name"><p>arg_panel_position</p></td>
737 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
738 <td class="parameter_annotations"> </td>
739 </tr>
740 <tr>
741 <td class="parameter_name"><p>cancellable</p></td>
742 <td class="parameter_description"><p>A <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
743 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
744 </tr>
745 <tr>
746 <td class="parameter_name"><p>callback</p></td>
747 <td class="parameter_description"><p>A <a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
748 <td class="parameter_annotations"> </td>
749 </tr>
750 <tr>
751 <td class="parameter_name"><p>user_data</p></td>
752 <td class="parameter_description"><p>User data to pass to <em class="parameter"><code>callback</code></em>
753 .</p></td>
754 <td class="parameter_annotations"> </td>
755 </tr>
756 </tbody>
757 </table></div>
758 </div>
759 </div>
760 <hr>
761 <div class="refsect2">
762 <a name="xapp-status-icon-interface-call-button-release-finish"></a><h3>xapp_status_icon_interface_call_button_release_finish ()</h3>
763 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
764 xapp_status_icon_interface_call_button_release_finish
765 (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *proxy</code></em>,
766 <em class="parameter"><code><a href="../gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *res</code></em>,
767 <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
768 <p>Finishes an operation started with <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-release" title="xapp_status_icon_interface_call_button_release ()"><code class="function">xapp_status_icon_interface_call_button_release()</code></a>.</p>
769 <div class="refsect3">
770 <a name="xapp-status-icon-interface-call-button-release-finish.parameters"></a><h4>Parameters</h4>
771 <div class="informaltable"><table class="informaltable" width="100%" border="0">
772 <colgroup>
773 <col width="150px" class="parameters_name">
774 <col class="parameters_description">
775 <col width="200px" class="parameters_annotations">
776 </colgroup>
777 <tbody>
778 <tr>
779 <td class="parameter_name"><p>proxy</p></td>
780 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterfaceProxy"><span class="type">XAppStatusIconInterfaceProxy</span></a>.</p></td>
781 <td class="parameter_annotations"> </td>
782 </tr>
783 <tr>
784 <td class="parameter_name"><p>res</p></td>
785 <td class="parameter_description"><p>The <a href="../gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> obtained from the <a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> passed to <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-release" title="xapp_status_icon_interface_call_button_release ()"><code class="function">xapp_status_icon_interface_call_button_release()</code></a>.</p></td>
786 <td class="parameter_annotations"> </td>
787 </tr>
788 <tr>
789 <td class="parameter_name"><p>error</p></td>
790 <td class="parameter_description"><p>Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
791 <td class="parameter_annotations"> </td>
792 </tr>
793 </tbody>
794 </table></div>
795 </div>
796 <div class="refsect3">
797 <a name="xapp-status-icon-interface-call-button-release-finish.returns"></a><h4>Returns</h4>
798 <p><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the call succeded, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <em class="parameter"><code>error</code></em>
799 is set. </p>
800 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
801 </div>
802 </div>
803 <hr>
804 <div class="refsect2">
805 <a name="xapp-status-icon-interface-call-button-release-sync"></a><h3>xapp_status_icon_interface_call_button_release_sync ()</h3>
806 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
807 xapp_status_icon_interface_call_button_release_sync
808 (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *proxy</code></em>,
809 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_x</code></em>,
810 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_y</code></em>,
811 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_button</code></em>,
812 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_time</code></em>,
813 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_panel_position</code></em>,
814 <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
815 <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
816 <p>Synchronously invokes the <GTKDOCLINK HREF="ButtonRelease"><code class="function">ButtonRelease()</code></GTKDOCLINK> D-Bus method on <em class="parameter"><code>proxy</code></em>
817 . The calling thread is blocked until a reply is received.</p>
818 <p>See <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-release" title="xapp_status_icon_interface_call_button_release ()"><code class="function">xapp_status_icon_interface_call_button_release()</code></a> for the asynchronous version of this method.</p>
819 <div class="refsect3">
820 <a name="xapp-status-icon-interface-call-button-release-sync.parameters"></a><h4>Parameters</h4>
821 <div class="informaltable"><table class="informaltable" width="100%" border="0">
822 <colgroup>
823 <col width="150px" class="parameters_name">
824 <col class="parameters_description">
825 <col width="200px" class="parameters_annotations">
826 </colgroup>
827 <tbody>
828 <tr>
829 <td class="parameter_name"><p>proxy</p></td>
830 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterfaceProxy"><span class="type">XAppStatusIconInterfaceProxy</span></a>.</p></td>
831 <td class="parameter_annotations"> </td>
832 </tr>
833 <tr>
834 <td class="parameter_name"><p>arg_x</p></td>
835 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
836 <td class="parameter_annotations"> </td>
837 </tr>
838 <tr>
839 <td class="parameter_name"><p>arg_y</p></td>
840 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
841 <td class="parameter_annotations"> </td>
842 </tr>
843 <tr>
844 <td class="parameter_name"><p>arg_button</p></td>
845 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
846 <td class="parameter_annotations"> </td>
847 </tr>
848 <tr>
849 <td class="parameter_name"><p>arg_time</p></td>
850 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
851 <td class="parameter_annotations"> </td>
852 </tr>
853 <tr>
854 <td class="parameter_name"><p>arg_panel_position</p></td>
855 <td class="parameter_description"><p>Argument to pass with the method invocation.</p></td>
856 <td class="parameter_annotations"> </td>
857 </tr>
858 <tr>
859 <td class="parameter_name"><p>cancellable</p></td>
860 <td class="parameter_description"><p>A <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
861 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
862 </tr>
863 <tr>
864 <td class="parameter_name"><p>error</p></td>
865 <td class="parameter_description"><p>Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
866 <td class="parameter_annotations"> </td>
867 </tr>
868 </tbody>
869 </table></div>
870 </div>
871 <div class="refsect3">
872 <a name="xapp-status-icon-interface-call-button-release-sync.returns"></a><h4>Returns</h4>
873 <p><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the call succeded, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <em class="parameter"><code>error</code></em>
874 is set. </p>
875 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
876 </div>
877 </div>
878 <hr>
879 <div class="refsect2">
880 <a name="xapp-status-icon-interface-get-name"></a><h3>xapp_status_icon_interface_get_name ()</h3>
881 <pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
882 xapp_status_icon_interface_get_name (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object</code></em>);</pre>
883 <p>Gets the value of the "Name" D-Bus property.</p>
884 <p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
885 <div class="warning">The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where <em class="parameter"><code>object</code></em> was constructed. Use <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-dup-name" title="xapp_status_icon_interface_dup_name ()"><code class="function">xapp_status_icon_interface_dup_name()</code></a> if on another thread.</div>
886 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
887 <div class="refsect3">
888 <a name="xapp-status-icon-interface-get-name.parameters"></a><h4>Parameters</h4>
889 <div class="informaltable"><table class="informaltable" width="100%" border="0">
890 <colgroup>
891 <col width="150px" class="parameters_name">
892 <col class="parameters_description">
893 <col width="200px" class="parameters_annotations">
894 </colgroup>
895 <tbody><tr>
896 <td class="parameter_name"><p>object</p></td>
897 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
898 <td class="parameter_annotations"> </td>
899 </tr></tbody>
900 </table></div>
901 </div>
902 <div class="refsect3">
903 <a name="xapp-status-icon-interface-get-name.returns"></a><h4>Returns</h4>
904 <p>The property value or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. Do not free the returned value, it belongs to <em class="parameter"><code>object</code></em>
905 . </p>
906 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
907 </div>
908 </div>
909 <hr>
910 <div class="refsect2">
911 <a name="xapp-status-icon-interface-dup-name"></a><h3>xapp_status_icon_interface_dup_name ()</h3>
912 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
913 xapp_status_icon_interface_dup_name (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object</code></em>);</pre>
914 <p>Gets a copy of the "Name" D-Bus property.</p>
915 <p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
916 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
917 <div class="refsect3">
918 <a name="xapp-status-icon-interface-dup-name.parameters"></a><h4>Parameters</h4>
919 <div class="informaltable"><table class="informaltable" width="100%" border="0">
920 <colgroup>
921 <col width="150px" class="parameters_name">
922 <col class="parameters_description">
923 <col width="200px" class="parameters_annotations">
924 </colgroup>
925 <tbody><tr>
926 <td class="parameter_name"><p>object</p></td>
927 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
928 <td class="parameter_annotations"> </td>
929 </tr></tbody>
930 </table></div>
931 </div>
932 <div class="refsect3">
933 <a name="xapp-status-icon-interface-dup-name.returns"></a><h4>Returns</h4>
934 <p>The property value or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. The returned value should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
935 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
936 </div>
937 </div>
938 <hr>
939 <div class="refsect2">
940 <a name="xapp-status-icon-interface-set-name"></a><h3>xapp_status_icon_interface_set_name ()</h3>
941 <pre class="programlisting"><span class="returnvalue">void</span>
942 xapp_status_icon_interface_set_name (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object</code></em>,
943 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
944 <p>Sets the "Name" D-Bus property to <em class="parameter"><code>value</code></em>
945 .</p>
946 <p>Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.</p>
947 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
948 <div class="refsect3">
949 <a name="xapp-status-icon-interface-set-name.parameters"></a><h4>Parameters</h4>
950 <div class="informaltable"><table class="informaltable" width="100%" border="0">
951 <colgroup>
952 <col width="150px" class="parameters_name">
953 <col class="parameters_description">
954 <col width="200px" class="parameters_annotations">
955 </colgroup>
956 <tbody>
957 <tr>
958 <td class="parameter_name"><p>object</p></td>
959 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
960 <td class="parameter_annotations"> </td>
961 </tr>
962 <tr>
963 <td class="parameter_name"><p>value</p></td>
964 <td class="parameter_description"><p>The value to set.</p></td>
965 <td class="parameter_annotations"> </td>
966 </tr>
967 </tbody>
968 </table></div>
969 </div>
970 </div>
971 <hr>
972 <div class="refsect2">
973 <a name="xapp-status-icon-interface-get-icon-name"></a><h3>xapp_status_icon_interface_get_icon_name ()</h3>
974 <pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
975 xapp_status_icon_interface_get_icon_name
976 (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object</code></em>);</pre>
977 <p>Gets the value of the "IconName" D-Bus property.</p>
978 <p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
979 <div class="warning">The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where <em class="parameter"><code>object</code></em> was constructed. Use <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-dup-icon-name" title="xapp_status_icon_interface_dup_icon_name ()"><code class="function">xapp_status_icon_interface_dup_icon_name()</code></a> if on another thread.</div>
980 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
981 <div class="refsect3">
982 <a name="xapp-status-icon-interface-get-icon-name.parameters"></a><h4>Parameters</h4>
983 <div class="informaltable"><table class="informaltable" width="100%" border="0">
984 <colgroup>
985 <col width="150px" class="parameters_name">
986 <col class="parameters_description">
987 <col width="200px" class="parameters_annotations">
988 </colgroup>
989 <tbody><tr>
990 <td class="parameter_name"><p>object</p></td>
991 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
992 <td class="parameter_annotations"> </td>
993 </tr></tbody>
994 </table></div>
995 </div>
996 <div class="refsect3">
997 <a name="xapp-status-icon-interface-get-icon-name.returns"></a><h4>Returns</h4>
998 <p>The property value or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. Do not free the returned value, it belongs to <em class="parameter"><code>object</code></em>
999 . </p>
1000 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
1001 </div>
1002 </div>
1003 <hr>
1004 <div class="refsect2">
1005 <a name="xapp-status-icon-interface-dup-icon-name"></a><h3>xapp_status_icon_interface_dup_icon_name ()</h3>
1006 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1007 xapp_status_icon_interface_dup_icon_name
1008 (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object</code></em>);</pre>
1009 <p>Gets a copy of the "IconName" D-Bus property.</p>
1010 <p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
1011 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
1012 <div class="refsect3">
1013 <a name="xapp-status-icon-interface-dup-icon-name.parameters"></a><h4>Parameters</h4>
1014 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1015 <colgroup>
1016 <col width="150px" class="parameters_name">
1017 <col class="parameters_description">
1018 <col width="200px" class="parameters_annotations">
1019 </colgroup>
1020 <tbody><tr>
1021 <td class="parameter_name"><p>object</p></td>
1022 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
1023 <td class="parameter_annotations"> </td>
1024 </tr></tbody>
1025 </table></div>
1026 </div>
1027 <div class="refsect3">
1028 <a name="xapp-status-icon-interface-dup-icon-name.returns"></a><h4>Returns</h4>
1029 <p>The property value or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. The returned value should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
1030 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
1031 </div>
1032 </div>
1033 <hr>
1034 <div class="refsect2">
1035 <a name="xapp-status-icon-interface-set-icon-name"></a><h3>xapp_status_icon_interface_set_icon_name ()</h3>
1036 <pre class="programlisting"><span class="returnvalue">void</span>
1037 xapp_status_icon_interface_set_icon_name
1038 (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object</code></em>,
1039 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1040 <p>Sets the "IconName" D-Bus property to <em class="parameter"><code>value</code></em>
1041 .</p>
1042 <p>Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.</p>
1043 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
1044 <div class="refsect3">
1045 <a name="xapp-status-icon-interface-set-icon-name.parameters"></a><h4>Parameters</h4>
1046 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1047 <colgroup>
1048 <col width="150px" class="parameters_name">
1049 <col class="parameters_description">
1050 <col width="200px" class="parameters_annotations">
1051 </colgroup>
1052 <tbody>
1053 <tr>
1054 <td class="parameter_name"><p>object</p></td>
1055 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
1056 <td class="parameter_annotations"> </td>
1057 </tr>
1058 <tr>
1059 <td class="parameter_name"><p>value</p></td>
1060 <td class="parameter_description"><p>The value to set.</p></td>
1061 <td class="parameter_annotations"> </td>
1062 </tr>
1063 </tbody>
1064 </table></div>
1065 </div>
1066 </div>
1067 <hr>
1068 <div class="refsect2">
1069 <a name="xapp-status-icon-interface-get-tooltip-text"></a><h3>xapp_status_icon_interface_get_tooltip_text ()</h3>
1070 <pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1071 xapp_status_icon_interface_get_tooltip_text
1072 (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object</code></em>);</pre>
1073 <p>Gets the value of the "TooltipText" D-Bus property.</p>
1074 <p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
1075 <div class="warning">The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where <em class="parameter"><code>object</code></em> was constructed. Use <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-dup-tooltip-text" title="xapp_status_icon_interface_dup_tooltip_text ()"><code class="function">xapp_status_icon_interface_dup_tooltip_text()</code></a> if on another thread.</div>
1076 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
1077 <div class="refsect3">
1078 <a name="xapp-status-icon-interface-get-tooltip-text.parameters"></a><h4>Parameters</h4>
1079 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1080 <colgroup>
1081 <col width="150px" class="parameters_name">
1082 <col class="parameters_description">
1083 <col width="200px" class="parameters_annotations">
1084 </colgroup>
1085 <tbody><tr>
1086 <td class="parameter_name"><p>object</p></td>
1087 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
1088 <td class="parameter_annotations"> </td>
1089 </tr></tbody>
1090 </table></div>
1091 </div>
1092 <div class="refsect3">
1093 <a name="xapp-status-icon-interface-get-tooltip-text.returns"></a><h4>Returns</h4>
1094 <p>The property value or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. Do not free the returned value, it belongs to <em class="parameter"><code>object</code></em>
1095 . </p>
1096 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
1097 </div>
1098 </div>
1099 <hr>
1100 <div class="refsect2">
1101 <a name="xapp-status-icon-interface-dup-tooltip-text"></a><h3>xapp_status_icon_interface_dup_tooltip_text ()</h3>
1102 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1103 xapp_status_icon_interface_dup_tooltip_text
1104 (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object</code></em>);</pre>
1105 <p>Gets a copy of the "TooltipText" D-Bus property.</p>
1106 <p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
1107 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
1108 <div class="refsect3">
1109 <a name="xapp-status-icon-interface-dup-tooltip-text.parameters"></a><h4>Parameters</h4>
1110 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1111 <colgroup>
1112 <col width="150px" class="parameters_name">
1113 <col class="parameters_description">
1114 <col width="200px" class="parameters_annotations">
1115 </colgroup>
1116 <tbody><tr>
1117 <td class="parameter_name"><p>object</p></td>
1118 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
1119 <td class="parameter_annotations"> </td>
1120 </tr></tbody>
1121 </table></div>
1122 </div>
1123 <div class="refsect3">
1124 <a name="xapp-status-icon-interface-dup-tooltip-text.returns"></a><h4>Returns</h4>
1125 <p>The property value or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. The returned value should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
1126 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
1127 </div>
1128 </div>
1129 <hr>
1130 <div class="refsect2">
1131 <a name="xapp-status-icon-interface-set-tooltip-text"></a><h3>xapp_status_icon_interface_set_tooltip_text ()</h3>
1132 <pre class="programlisting"><span class="returnvalue">void</span>
1133 xapp_status_icon_interface_set_tooltip_text
1134 (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object</code></em>,
1135 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1136 <p>Sets the "TooltipText" D-Bus property to <em class="parameter"><code>value</code></em>
1137 .</p>
1138 <p>Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.</p>
1139 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
1140 <div class="refsect3">
1141 <a name="xapp-status-icon-interface-set-tooltip-text.parameters"></a><h4>Parameters</h4>
1142 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1143 <colgroup>
1144 <col width="150px" class="parameters_name">
1145 <col class="parameters_description">
1146 <col width="200px" class="parameters_annotations">
1147 </colgroup>
1148 <tbody>
1149 <tr>
1150 <td class="parameter_name"><p>object</p></td>
1151 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
1152 <td class="parameter_annotations"> </td>
1153 </tr>
1154 <tr>
1155 <td class="parameter_name"><p>value</p></td>
1156 <td class="parameter_description"><p>The value to set.</p></td>
1157 <td class="parameter_annotations"> </td>
1158 </tr>
1159 </tbody>
1160 </table></div>
1161 </div>
1162 </div>
1163 <hr>
1164 <div class="refsect2">
1165 <a name="xapp-status-icon-interface-get-label"></a><h3>xapp_status_icon_interface_get_label ()</h3>
1166 <pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1167 xapp_status_icon_interface_get_label (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object</code></em>);</pre>
1168 <p>Gets the value of the "Label" D-Bus property.</p>
1169 <p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
1170 <div class="warning">The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where <em class="parameter"><code>object</code></em> was constructed. Use <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-dup-label" title="xapp_status_icon_interface_dup_label ()"><code class="function">xapp_status_icon_interface_dup_label()</code></a> if on another thread.</div>
1171 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
1172 <div class="refsect3">
1173 <a name="xapp-status-icon-interface-get-label.parameters"></a><h4>Parameters</h4>
1174 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1175 <colgroup>
1176 <col width="150px" class="parameters_name">
1177 <col class="parameters_description">
1178 <col width="200px" class="parameters_annotations">
1179 </colgroup>
1180 <tbody><tr>
1181 <td class="parameter_name"><p>object</p></td>
1182 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
1183 <td class="parameter_annotations"> </td>
1184 </tr></tbody>
1185 </table></div>
1186 </div>
1187 <div class="refsect3">
1188 <a name="xapp-status-icon-interface-get-label.returns"></a><h4>Returns</h4>
1189 <p>The property value or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. Do not free the returned value, it belongs to <em class="parameter"><code>object</code></em>
1190 . </p>
1191 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
1192 </div>
1193 </div>
1194 <hr>
1195 <div class="refsect2">
1196 <a name="xapp-status-icon-interface-dup-label"></a><h3>xapp_status_icon_interface_dup_label ()</h3>
1197 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1198 xapp_status_icon_interface_dup_label (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object</code></em>);</pre>
1199 <p>Gets a copy of the "Label" D-Bus property.</p>
1200 <p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
1201 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
1202 <div class="refsect3">
1203 <a name="xapp-status-icon-interface-dup-label.parameters"></a><h4>Parameters</h4>
1204 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1205 <colgroup>
1206 <col width="150px" class="parameters_name">
1207 <col class="parameters_description">
1208 <col width="200px" class="parameters_annotations">
1209 </colgroup>
1210 <tbody><tr>
1211 <td class="parameter_name"><p>object</p></td>
1212 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
1213 <td class="parameter_annotations"> </td>
1214 </tr></tbody>
1215 </table></div>
1216 </div>
1217 <div class="refsect3">
1218 <a name="xapp-status-icon-interface-dup-label.returns"></a><h4>Returns</h4>
1219 <p>The property value or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. The returned value should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
1220 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
1221 </div>
1222 </div>
1223 <hr>
1224 <div class="refsect2">
1225 <a name="xapp-status-icon-interface-set-label"></a><h3>xapp_status_icon_interface_set_label ()</h3>
1226 <pre class="programlisting"><span class="returnvalue">void</span>
1227 xapp_status_icon_interface_set_label (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object</code></em>,
1228 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1229 <p>Sets the "Label" D-Bus property to <em class="parameter"><code>value</code></em>
1230 .</p>
1231 <p>Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.</p>
1232 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
1233 <div class="refsect3">
1234 <a name="xapp-status-icon-interface-set-label.parameters"></a><h4>Parameters</h4>
1235 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1236 <colgroup>
1237 <col width="150px" class="parameters_name">
1238 <col class="parameters_description">
1239 <col width="200px" class="parameters_annotations">
1240 </colgroup>
1241 <tbody>
1242 <tr>
1243 <td class="parameter_name"><p>object</p></td>
1244 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
1245 <td class="parameter_annotations"> </td>
1246 </tr>
1247 <tr>
1248 <td class="parameter_name"><p>value</p></td>
1249 <td class="parameter_description"><p>The value to set.</p></td>
1250 <td class="parameter_annotations"> </td>
1251 </tr>
1252 </tbody>
1253 </table></div>
1254 </div>
1255 </div>
1256 <hr>
1257 <div class="refsect2">
1258 <a name="xapp-status-icon-interface-get-visible"></a><h3>xapp_status_icon_interface_get_visible ()</h3>
1259 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1260 xapp_status_icon_interface_get_visible
1261 (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object</code></em>);</pre>
1262 <p>Gets the value of the "Visible" D-Bus property.</p>
1263 <p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
1264 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
1265 <div class="refsect3">
1266 <a name="xapp-status-icon-interface-get-visible.parameters"></a><h4>Parameters</h4>
1267 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1268 <colgroup>
1269 <col width="150px" class="parameters_name">
1270 <col class="parameters_description">
1271 <col width="200px" class="parameters_annotations">
1272 </colgroup>
1273 <tbody><tr>
1274 <td class="parameter_name"><p>object</p></td>
1275 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
1276 <td class="parameter_annotations"> </td>
1277 </tr></tbody>
1278 </table></div>
1279 </div>
1280 <div class="refsect3">
1281 <a name="xapp-status-icon-interface-get-visible.returns"></a><h4>Returns</h4>
1282 <p> The property value.</p>
1283 </div>
1284 </div>
1285 <hr>
1286 <div class="refsect2">
1287 <a name="xapp-status-icon-interface-set-visible"></a><h3>xapp_status_icon_interface_set_visible ()</h3>
1288 <pre class="programlisting"><span class="returnvalue">void</span>
1289 xapp_status_icon_interface_set_visible
1290 (<em class="parameter"><code><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object</code></em>,
1291 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> value</code></em>);</pre>
1292 <p>Sets the "Visible" D-Bus property to <em class="parameter"><code>value</code></em>
1293 .</p>
1294 <p>Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.</p>
1295 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
1296 <div class="refsect3">
1297 <a name="xapp-status-icon-interface-set-visible.parameters"></a><h4>Parameters</h4>
1298 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1299 <colgroup>
1300 <col width="150px" class="parameters_name">
1301 <col class="parameters_description">
1302 <col width="200px" class="parameters_annotations">
1303 </colgroup>
1304 <tbody>
1305 <tr>
1306 <td class="parameter_name"><p>object</p></td>
1307 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
1308 <td class="parameter_annotations"> </td>
1309 </tr>
1310 <tr>
1311 <td class="parameter_name"><p>value</p></td>
1312 <td class="parameter_description"><p>The value to set.</p></td>
1313 <td class="parameter_annotations"> </td>
1314 </tr>
1315 </tbody>
1316 </table></div>
1317 </div>
1318 </div>
1319 <hr>
1320 <div class="refsect2">
1321 <a name="xapp-status-icon-interface-proxy-new"></a><h3>xapp_status_icon_interface_proxy_new ()</h3>
1322 <pre class="programlisting"><span class="returnvalue">void</span>
1323 xapp_status_icon_interface_proxy_new (<em class="parameter"><code><a href="../gio/GDBusConnection.html#GDBusConnection-struct"><span class="type">GDBusConnection</span></a> *connection</code></em>,
1324 <em class="parameter"><code><a href="../gio/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
1325 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
1326 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
1327 <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1328 <em class="parameter"><code><a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1329 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1330 <p>Asynchronously creates a proxy for the D-Bus interface org.x.StatusIcon. See <a href="../gio/GDBusProxy.html#g-dbus-proxy-new"><code class="function">g_dbus_proxy_new()</code></a> for more details.</p>
1331 <p>When the operation is finished, <em class="parameter"><code>callback</code></em>
1332 will be invoked in the <a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main loop</a> of the thread you are calling this method from.
1333 You can then call <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-finish" title="xapp_status_icon_interface_proxy_new_finish ()"><code class="function">xapp_status_icon_interface_proxy_new_finish()</code></a> to get the result of the operation.</p>
1334 <p>See <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-sync" title="xapp_status_icon_interface_proxy_new_sync ()"><code class="function">xapp_status_icon_interface_proxy_new_sync()</code></a> for the synchronous, blocking version of this constructor.</p>
1335 <div class="refsect3">
1336 <a name="xapp-status-icon-interface-proxy-new.parameters"></a><h4>Parameters</h4>
1337 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1338 <colgroup>
1339 <col width="150px" class="parameters_name">
1340 <col class="parameters_description">
1341 <col width="200px" class="parameters_annotations">
1342 </colgroup>
1343 <tbody>
1344 <tr>
1345 <td class="parameter_name"><p>connection</p></td>
1346 <td class="parameter_description"><p>A <a href="../gio/GDBusConnection.html#GDBusConnection-struct"><span class="type">GDBusConnection</span></a>.</p></td>
1347 <td class="parameter_annotations"> </td>
1348 </tr>
1349 <tr>
1350 <td class="parameter_name"><p>flags</p></td>
1351 <td class="parameter_description"><p>Flags from the <a href="../gio/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</p></td>
1352 <td class="parameter_annotations"> </td>
1353 </tr>
1354 <tr>
1355 <td class="parameter_name"><p>name</p></td>
1356 <td class="parameter_description"><p>A bus name (well-known or unique) or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>connection</code></em>
1357 is not a message bus connection. </p></td>
1358 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
1359 </tr>
1360 <tr>
1361 <td class="parameter_name"><p>object_path</p></td>
1362 <td class="parameter_description"><p>An object path.</p></td>
1363 <td class="parameter_annotations"> </td>
1364 </tr>
1365 <tr>
1366 <td class="parameter_name"><p>cancellable</p></td>
1367 <td class="parameter_description"><p>A <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1368 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
1369 </tr>
1370 <tr>
1371 <td class="parameter_name"><p>callback</p></td>
1372 <td class="parameter_description"><p>A <a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied.</p></td>
1373 <td class="parameter_annotations"> </td>
1374 </tr>
1375 <tr>
1376 <td class="parameter_name"><p>user_data</p></td>
1377 <td class="parameter_description"><p>User data to pass to <em class="parameter"><code>callback</code></em>
1378 .</p></td>
1379 <td class="parameter_annotations"> </td>
1380 </tr>
1381 </tbody>
1382 </table></div>
1383 </div>
1384 </div>
1385 <hr>
1386 <div class="refsect2">
1387 <a name="xapp-status-icon-interface-proxy-new-finish"></a><h3>xapp_status_icon_interface_proxy_new_finish ()</h3>
1388 <pre class="programlisting"><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="returnvalue">XAppStatusIconInterface</span></a> *
1389 xapp_status_icon_interface_proxy_new_finish
1390 (<em class="parameter"><code><a href="../gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *res</code></em>,
1391 <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1392 <p>Finishes an operation started with <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new" title="xapp_status_icon_interface_proxy_new ()"><code class="function">xapp_status_icon_interface_proxy_new()</code></a>.</p>
1393 <div class="refsect3">
1394 <a name="xapp-status-icon-interface-proxy-new-finish.parameters"></a><h4>Parameters</h4>
1395 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1396 <colgroup>
1397 <col width="150px" class="parameters_name">
1398 <col class="parameters_description">
1399 <col width="200px" class="parameters_annotations">
1400 </colgroup>
1401 <tbody>
1402 <tr>
1403 <td class="parameter_name"><p>res</p></td>
1404 <td class="parameter_description"><p>The <a href="../gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> obtained from the <a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> passed to <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new" title="xapp_status_icon_interface_proxy_new ()"><code class="function">xapp_status_icon_interface_proxy_new()</code></a>.</p></td>
1405 <td class="parameter_annotations"> </td>
1406 </tr>
1407 <tr>
1408 <td class="parameter_name"><p>error</p></td>
1409 <td class="parameter_description"><p>Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1410 <td class="parameter_annotations"> </td>
1411 </tr>
1412 </tbody>
1413 </table></div>
1414 </div>
1415 <div class="refsect3">
1416 <a name="xapp-status-icon-interface-proxy-new-finish.returns"></a><h4>Returns</h4>
1417 <p>The constructed proxy object or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
1418 is set. </p>
1419 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> XAppStatusIconInterfaceProxy]</span></p>
1420 </div>
1421 </div>
1422 <hr>
1423 <div class="refsect2">
1424 <a name="xapp-status-icon-interface-proxy-new-sync"></a><h3>xapp_status_icon_interface_proxy_new_sync ()</h3>
1425 <pre class="programlisting"><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="returnvalue">XAppStatusIconInterface</span></a> *
1426 xapp_status_icon_interface_proxy_new_sync
1427 (<em class="parameter"><code><a href="../gio/GDBusConnection.html#GDBusConnection-struct"><span class="type">GDBusConnection</span></a> *connection</code></em>,
1428 <em class="parameter"><code><a href="../gio/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
1429 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
1430 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
1431 <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1432 <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1433 <p>Synchronously creates a proxy for the D-Bus interface org.x.StatusIcon. See <a href="../gio/GDBusProxy.html#g-dbus-proxy-new-sync"><code class="function">g_dbus_proxy_new_sync()</code></a> for more details.</p>
1434 <p>The calling thread is blocked until a reply is received.</p>
1435 <p>See <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new" title="xapp_status_icon_interface_proxy_new ()"><code class="function">xapp_status_icon_interface_proxy_new()</code></a> for the asynchronous version of this constructor.</p>
1436 <div class="refsect3">
1437 <a name="xapp-status-icon-interface-proxy-new-sync.parameters"></a><h4>Parameters</h4>
1438 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1439 <colgroup>
1440 <col width="150px" class="parameters_name">
1441 <col class="parameters_description">
1442 <col width="200px" class="parameters_annotations">
1443 </colgroup>
1444 <tbody>
1445 <tr>
1446 <td class="parameter_name"><p>connection</p></td>
1447 <td class="parameter_description"><p>A <a href="../gio/GDBusConnection.html#GDBusConnection-struct"><span class="type">GDBusConnection</span></a>.</p></td>
1448 <td class="parameter_annotations"> </td>
1449 </tr>
1450 <tr>
1451 <td class="parameter_name"><p>flags</p></td>
1452 <td class="parameter_description"><p>Flags from the <a href="../gio/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</p></td>
1453 <td class="parameter_annotations"> </td>
1454 </tr>
1455 <tr>
1456 <td class="parameter_name"><p>name</p></td>
1457 <td class="parameter_description"><p>A bus name (well-known or unique) or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>connection</code></em>
1458 is not a message bus connection. </p></td>
1459 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
1460 </tr>
1461 <tr>
1462 <td class="parameter_name"><p>object_path</p></td>
1463 <td class="parameter_description"><p>An object path.</p></td>
1464 <td class="parameter_annotations"> </td>
1465 </tr>
1466 <tr>
1467 <td class="parameter_name"><p>cancellable</p></td>
1468 <td class="parameter_description"><p>A <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1469 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
1470 </tr>
1471 <tr>
1472 <td class="parameter_name"><p>error</p></td>
1473 <td class="parameter_description"><p>Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1474 <td class="parameter_annotations"> </td>
1475 </tr>
1476 </tbody>
1477 </table></div>
1478 </div>
1479 <div class="refsect3">
1480 <a name="xapp-status-icon-interface-proxy-new-sync.returns"></a><h4>Returns</h4>
1481 <p>The constructed proxy object or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
1482 is set. </p>
1483 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> XAppStatusIconInterfaceProxy]</span></p>
1484 </div>
1485 </div>
1486 <hr>
1487 <div class="refsect2">
1488 <a name="xapp-status-icon-interface-proxy-new-for-bus"></a><h3>xapp_status_icon_interface_proxy_new_for_bus ()</h3>
1489 <pre class="programlisting"><span class="returnvalue">void</span>
1490 xapp_status_icon_interface_proxy_new_for_bus
1491 (<em class="parameter"><code><a href="../gio/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
1492 <em class="parameter"><code><a href="../gio/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
1493 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
1494 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
1495 <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1496 <em class="parameter"><code><a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1497 <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1498 <p>Like <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new" title="xapp_status_icon_interface_proxy_new ()"><code class="function">xapp_status_icon_interface_proxy_new()</code></a> but takes a <a href="../gio/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> instead of a <a href="../gio/GDBusConnection.html#GDBusConnection-struct"><span class="type">GDBusConnection</span></a>.</p>
1499 <p>When the operation is finished, <em class="parameter"><code>callback</code></em>
1500 will be invoked in the <a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main loop</a> of the thread you are calling this method from.
1501 You can then call <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-for-bus-finish" title="xapp_status_icon_interface_proxy_new_for_bus_finish ()"><code class="function">xapp_status_icon_interface_proxy_new_for_bus_finish()</code></a> to get the result of the operation.</p>
1502 <p>See <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-for-bus-sync" title="xapp_status_icon_interface_proxy_new_for_bus_sync ()"><code class="function">xapp_status_icon_interface_proxy_new_for_bus_sync()</code></a> for the synchronous, blocking version of this constructor.</p>
1503 <div class="refsect3">
1504 <a name="xapp-status-icon-interface-proxy-new-for-bus.parameters"></a><h4>Parameters</h4>
1505 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1506 <colgroup>
1507 <col width="150px" class="parameters_name">
1508 <col class="parameters_description">
1509 <col width="200px" class="parameters_annotations">
1510 </colgroup>
1511 <tbody>
1512 <tr>
1513 <td class="parameter_name"><p>bus_type</p></td>
1514 <td class="parameter_description"><p>A <a href="../gio/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a>.</p></td>
1515 <td class="parameter_annotations"> </td>
1516 </tr>
1517 <tr>
1518 <td class="parameter_name"><p>flags</p></td>
1519 <td class="parameter_description"><p>Flags from the <a href="../gio/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</p></td>
1520 <td class="parameter_annotations"> </td>
1521 </tr>
1522 <tr>
1523 <td class="parameter_name"><p>name</p></td>
1524 <td class="parameter_description"><p>A bus name (well-known or unique).</p></td>
1525 <td class="parameter_annotations"> </td>
1526 </tr>
1527 <tr>
1528 <td class="parameter_name"><p>object_path</p></td>
1529 <td class="parameter_description"><p>An object path.</p></td>
1530 <td class="parameter_annotations"> </td>
1531 </tr>
1532 <tr>
1533 <td class="parameter_name"><p>cancellable</p></td>
1534 <td class="parameter_description"><p>A <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1535 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
1536 </tr>
1537 <tr>
1538 <td class="parameter_name"><p>callback</p></td>
1539 <td class="parameter_description"><p>A <a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied.</p></td>
1540 <td class="parameter_annotations"> </td>
1541 </tr>
1542 <tr>
1543 <td class="parameter_name"><p>user_data</p></td>
1544 <td class="parameter_description"><p>User data to pass to <em class="parameter"><code>callback</code></em>
1545 .</p></td>
1546 <td class="parameter_annotations"> </td>
1547 </tr>
1548 </tbody>
1549 </table></div>
1550 </div>
1551 </div>
1552 <hr>
1553 <div class="refsect2">
1554 <a name="xapp-status-icon-interface-proxy-new-for-bus-finish"></a><h3>xapp_status_icon_interface_proxy_new_for_bus_finish ()</h3>
1555 <pre class="programlisting"><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="returnvalue">XAppStatusIconInterface</span></a> *
1556 xapp_status_icon_interface_proxy_new_for_bus_finish
1557 (<em class="parameter"><code><a href="../gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *res</code></em>,
1558 <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1559 <p>Finishes an operation started with <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-for-bus" title="xapp_status_icon_interface_proxy_new_for_bus ()"><code class="function">xapp_status_icon_interface_proxy_new_for_bus()</code></a>.</p>
1560 <div class="refsect3">
1561 <a name="xapp-status-icon-interface-proxy-new-for-bus-finish.parameters"></a><h4>Parameters</h4>
1562 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1563 <colgroup>
1564 <col width="150px" class="parameters_name">
1565 <col class="parameters_description">
1566 <col width="200px" class="parameters_annotations">
1567 </colgroup>
1568 <tbody>
1569 <tr>
1570 <td class="parameter_name"><p>res</p></td>
1571 <td class="parameter_description"><p>The <a href="../gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> obtained from the <a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> passed to <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-for-bus" title="xapp_status_icon_interface_proxy_new_for_bus ()"><code class="function">xapp_status_icon_interface_proxy_new_for_bus()</code></a>.</p></td>
1572 <td class="parameter_annotations"> </td>
1573 </tr>
1574 <tr>
1575 <td class="parameter_name"><p>error</p></td>
1576 <td class="parameter_description"><p>Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1577 <td class="parameter_annotations"> </td>
1578 </tr>
1579 </tbody>
1580 </table></div>
1581 </div>
1582 <div class="refsect3">
1583 <a name="xapp-status-icon-interface-proxy-new-for-bus-finish.returns"></a><h4>Returns</h4>
1584 <p>The constructed proxy object or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
1585 is set. </p>
1586 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> XAppStatusIconInterfaceProxy]</span></p>
1587 </div>
1588 </div>
1589 <hr>
1590 <div class="refsect2">
1591 <a name="xapp-status-icon-interface-proxy-new-for-bus-sync"></a><h3>xapp_status_icon_interface_proxy_new_for_bus_sync ()</h3>
1592 <pre class="programlisting"><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="returnvalue">XAppStatusIconInterface</span></a> *
1593 xapp_status_icon_interface_proxy_new_for_bus_sync
1594 (<em class="parameter"><code><a href="../gio/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
1595 <em class="parameter"><code><a href="../gio/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
1596 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
1597 <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
1598 <em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1599 <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1600 <p>Like <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-sync" title="xapp_status_icon_interface_proxy_new_sync ()"><code class="function">xapp_status_icon_interface_proxy_new_sync()</code></a> but takes a <a href="../gio/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> instead of a <a href="../gio/GDBusConnection.html#GDBusConnection-struct"><span class="type">GDBusConnection</span></a>.</p>
1601 <p>The calling thread is blocked until a reply is received.</p>
1602 <p>See <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-for-bus" title="xapp_status_icon_interface_proxy_new_for_bus ()"><code class="function">xapp_status_icon_interface_proxy_new_for_bus()</code></a> for the asynchronous version of this constructor.</p>
1603 <div class="refsect3">
1604 <a name="xapp-status-icon-interface-proxy-new-for-bus-sync.parameters"></a><h4>Parameters</h4>
1605 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1606 <colgroup>
1607 <col width="150px" class="parameters_name">
1608 <col class="parameters_description">
1609 <col width="200px" class="parameters_annotations">
1610 </colgroup>
1611 <tbody>
1612 <tr>
1613 <td class="parameter_name"><p>bus_type</p></td>
1614 <td class="parameter_description"><p>A <a href="../gio/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a>.</p></td>
1615 <td class="parameter_annotations"> </td>
1616 </tr>
1617 <tr>
1618 <td class="parameter_name"><p>flags</p></td>
1619 <td class="parameter_description"><p>Flags from the <a href="../gio/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</p></td>
1620 <td class="parameter_annotations"> </td>
1621 </tr>
1622 <tr>
1623 <td class="parameter_name"><p>name</p></td>
1624 <td class="parameter_description"><p>A bus name (well-known or unique).</p></td>
1625 <td class="parameter_annotations"> </td>
1626 </tr>
1627 <tr>
1628 <td class="parameter_name"><p>object_path</p></td>
1629 <td class="parameter_description"><p>An object path.</p></td>
1630 <td class="parameter_annotations"> </td>
1631 </tr>
1632 <tr>
1633 <td class="parameter_name"><p>cancellable</p></td>
1634 <td class="parameter_description"><p>A <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1635 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
1636 </tr>
1637 <tr>
1638 <td class="parameter_name"><p>error</p></td>
1639 <td class="parameter_description"><p>Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1640 <td class="parameter_annotations"> </td>
1641 </tr>
1642 </tbody>
1643 </table></div>
1644 </div>
1645 <div class="refsect3">
1646 <a name="xapp-status-icon-interface-proxy-new-for-bus-sync.returns"></a><h4>Returns</h4>
1647 <p>The constructed proxy object or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
1648 is set. </p>
1649 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> XAppStatusIconInterfaceProxy]</span></p>
1650 </div>
1651 </div>
1652 <hr>
1653 <div class="refsect2">
1654 <a name="xapp-status-icon-interface-skeleton-new"></a><h3>xapp_status_icon_interface_skeleton_new ()</h3>
1655 <pre class="programlisting"><a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="returnvalue">XAppStatusIconInterface</span></a> *
1656 xapp_status_icon_interface_skeleton_new
1657 (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1658 <p>Creates a skeleton object for the D-Bus interface org.x.StatusIcon.</p>
1659 <div class="refsect3">
1660 <a name="xapp-status-icon-interface-skeleton-new.returns"></a><h4>Returns</h4>
1661 <p>The skeleton object. </p>
1662 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> XAppStatusIconInterfaceSkeleton]</span></p>
1663 </div>
1664 </div>
1665 </div>
1666 <div class="refsect1">
1667 <a name="XAppStatusIconInterfaceSkeleton.other_details"></a><h2>Types and Values</h2>
1668 </div>
1669 <div class="refsect1">
1670 <a name="XAppStatusIconInterfaceSkeleton.property-details"></a><h2>Property Details</h2>
1671 <div class="refsect2">
1672 <a name="XAppStatusIconInterface--icon-name"></a><h3>The <code class="literal">“icon-name”</code> property</h3>
1673 <pre class="programlisting"> “icon-name” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
1674 <p>Represents the D-Bus property "IconName".</p>
1675 <p>Since the D-Bus property for this <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.</p>
1676 <p>Flags: Read / Write</p>
1677 <p>Default value: NULL</p>
1678 </div>
1679 <hr>
1680 <div class="refsect2">
1681 <a name="XAppStatusIconInterface--label"></a><h3>The <code class="literal">“label”</code> property</h3>
1682 <pre class="programlisting"> “label” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
1683 <p>Represents the D-Bus property "Label".</p>
1684 <p>Since the D-Bus property for this <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.</p>
1685 <p>Flags: Read / Write</p>
1686 <p>Default value: NULL</p>
1687 </div>
1688 <hr>
1689 <div class="refsect2">
1690 <a name="XAppStatusIconInterface--name"></a><h3>The <code class="literal">“name”</code> property</h3>
1691 <pre class="programlisting"> “name” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
1692 <p>Represents the D-Bus property "Name".</p>
1693 <p>Since the D-Bus property for this <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.</p>
1694 <p>Flags: Read / Write</p>
1695 <p>Default value: NULL</p>
1696 </div>
1697 <hr>
1698 <div class="refsect2">
1699 <a name="XAppStatusIconInterface--tooltip-text"></a><h3>The <code class="literal">“tooltip-text”</code> property</h3>
1700 <pre class="programlisting"> “tooltip-text” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
1701 <p>Represents the D-Bus property "TooltipText".</p>
1702 <p>Since the D-Bus property for this <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.</p>
1703 <p>Flags: Read / Write</p>
1704 <p>Default value: NULL</p>
1705 </div>
1706 <hr>
1707 <div class="refsect2">
1708 <a name="XAppStatusIconInterface--visible"></a><h3>The <code class="literal">“visible”</code> property</h3>
1709 <pre class="programlisting"> “visible” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
1710 <p>Represents the D-Bus property "Visible".</p>
1711 <p>Since the D-Bus property for this <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.</p>
1712 <p>Flags: Read / Write</p>
1713 <p>Default value: FALSE</p>
1714 </div>
1715 </div>
1716 <div class="refsect1">
1717 <a name="XAppStatusIconInterfaceSkeleton.signal-details"></a><h2>Signal Details</h2>
1718 <div class="refsect2">
1719 <a name="XAppStatusIconInterface-handle-button-press"></a><h3>The <code class="literal">“handle-button-press”</code> signal</h3>
1720 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1721 user_function (<a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object,
1722 <a href="../gio/GDBusMethodInvocation.html#GDBusMethodInvocation-struct"><span class="type">GDBusMethodInvocation</span></a> *invocation,
1723 <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_x,
1724 <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_y,
1725 <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_button,
1726 <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_time,
1727 <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_panel_position,
1728 <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
1729 <p>Signal emitted when a remote caller is invoking the <GTKDOCLINK HREF="ButtonPress"><code class="function">ButtonPress()</code></GTKDOCLINK> D-Bus method.</p>
1730 <p>If a signal handler returns <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, it means the signal handler will handle the invocation (e.g. take a reference to <em class="parameter"><code>invocation</code></em>
1731 and eventually call <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-complete-button-press" title="xapp_status_icon_interface_complete_button_press ()"><code class="function">xapp_status_icon_interface_complete_button_press()</code></a> or e.g. <a href="../gio/GDBusMethodInvocation.html#g-dbus-method-invocation-return-error"><code class="function">g_dbus_method_invocation_return_error()</code></a> on it) and no order signal handlers will run. If no signal handler handles the invocation, the <a href="../gio/gio-GDBusError.html#G-DBUS-ERROR-UNKNOWN-METHOD:CAPS"><code class="literal">G_DBUS_ERROR_UNKNOWN_METHOD</code></a> error is returned.</p>
1732 <div class="refsect3">
1733 <a name="XAppStatusIconInterface-handle-button-press.parameters"></a><h4>Parameters</h4>
1734 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1735 <colgroup>
1736 <col width="150px" class="parameters_name">
1737 <col class="parameters_description">
1738 <col width="200px" class="parameters_annotations">
1739 </colgroup>
1740 <tbody>
1741 <tr>
1742 <td class="parameter_name"><p>object</p></td>
1743 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
1744 <td class="parameter_annotations"> </td>
1745 </tr>
1746 <tr>
1747 <td class="parameter_name"><p>invocation</p></td>
1748 <td class="parameter_description"><p>A <a href="../gio/GDBusMethodInvocation.html#GDBusMethodInvocation-struct"><span class="type">GDBusMethodInvocation</span></a>.</p></td>
1749 <td class="parameter_annotations"> </td>
1750 </tr>
1751 <tr>
1752 <td class="parameter_name"><p>arg_x</p></td>
1753 <td class="parameter_description"><p>Argument passed by remote caller.</p></td>
1754 <td class="parameter_annotations"> </td>
1755 </tr>
1756 <tr>
1757 <td class="parameter_name"><p>arg_y</p></td>
1758 <td class="parameter_description"><p>Argument passed by remote caller.</p></td>
1759 <td class="parameter_annotations"> </td>
1760 </tr>
1761 <tr>
1762 <td class="parameter_name"><p>arg_button</p></td>
1763 <td class="parameter_description"><p>Argument passed by remote caller.</p></td>
1764 <td class="parameter_annotations"> </td>
1765 </tr>
1766 <tr>
1767 <td class="parameter_name"><p>arg_time</p></td>
1768 <td class="parameter_description"><p>Argument passed by remote caller.</p></td>
1769 <td class="parameter_annotations"> </td>
1770 </tr>
1771 <tr>
1772 <td class="parameter_name"><p>arg_panel_position</p></td>
1773 <td class="parameter_description"><p>Argument passed by remote caller.</p></td>
1774 <td class="parameter_annotations"> </td>
1775 </tr>
1776 <tr>
1777 <td class="parameter_name"><p>user_data</p></td>
1778 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
1779 <td class="parameter_annotations"> </td>
1780 </tr>
1781 </tbody>
1782 </table></div>
1783 </div>
1784 <div class="refsect3">
1785 <a name="XAppStatusIconInterface-handle-button-press.returns"></a><h4>Returns</h4>
1786 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the invocation was handled, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to let other signal handlers run.</p>
1787 </div>
1788 <p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
1789 </div>
1790 <hr>
1791 <div class="refsect2">
1792 <a name="XAppStatusIconInterface-handle-button-release"></a><h3>The <code class="literal">“handle-button-release”</code> signal</h3>
1793 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1794 user_function (<a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a> *object,
1795 <a href="../gio/GDBusMethodInvocation.html#GDBusMethodInvocation-struct"><span class="type">GDBusMethodInvocation</span></a> *invocation,
1796 <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_x,
1797 <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_y,
1798 <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_button,
1799 <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_time,
1800 <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> arg_panel_position,
1801 <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
1802 <p>Signal emitted when a remote caller is invoking the <GTKDOCLINK HREF="ButtonRelease"><code class="function">ButtonRelease()</code></GTKDOCLINK> D-Bus method.</p>
1803 <p>If a signal handler returns <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, it means the signal handler will handle the invocation (e.g. take a reference to <em class="parameter"><code>invocation</code></em>
1804 and eventually call <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-complete-button-release" title="xapp_status_icon_interface_complete_button_release ()"><code class="function">xapp_status_icon_interface_complete_button_release()</code></a> or e.g. <a href="../gio/GDBusMethodInvocation.html#g-dbus-method-invocation-return-error"><code class="function">g_dbus_method_invocation_return_error()</code></a> on it) and no order signal handlers will run. If no signal handler handles the invocation, the <a href="../gio/gio-GDBusError.html#G-DBUS-ERROR-UNKNOWN-METHOD:CAPS"><code class="literal">G_DBUS_ERROR_UNKNOWN_METHOD</code></a> error is returned.</p>
1805 <div class="refsect3">
1806 <a name="XAppStatusIconInterface-handle-button-release.parameters"></a><h4>Parameters</h4>
1807 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1808 <colgroup>
1809 <col width="150px" class="parameters_name">
1810 <col class="parameters_description">
1811 <col width="200px" class="parameters_annotations">
1812 </colgroup>
1813 <tbody>
1814 <tr>
1815 <td class="parameter_name"><p>object</p></td>
1816 <td class="parameter_description"><p>A <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface"><span class="type">XAppStatusIconInterface</span></a>.</p></td>
1817 <td class="parameter_annotations"> </td>
1818 </tr>
1819 <tr>
1820 <td class="parameter_name"><p>invocation</p></td>
1821 <td class="parameter_description"><p>A <a href="../gio/GDBusMethodInvocation.html#GDBusMethodInvocation-struct"><span class="type">GDBusMethodInvocation</span></a>.</p></td>
1822 <td class="parameter_annotations"> </td>
1823 </tr>
1824 <tr>
1825 <td class="parameter_name"><p>arg_x</p></td>
1826 <td class="parameter_description"><p>Argument passed by remote caller.</p></td>
1827 <td class="parameter_annotations"> </td>
1828 </tr>
1829 <tr>
1830 <td class="parameter_name"><p>arg_y</p></td>
1831 <td class="parameter_description"><p>Argument passed by remote caller.</p></td>
1832 <td class="parameter_annotations"> </td>
1833 </tr>
1834 <tr>
1835 <td class="parameter_name"><p>arg_button</p></td>
1836 <td class="parameter_description"><p>Argument passed by remote caller.</p></td>
1837 <td class="parameter_annotations"> </td>
1838 </tr>
1839 <tr>
1840 <td class="parameter_name"><p>arg_time</p></td>
1841 <td class="parameter_description"><p>Argument passed by remote caller.</p></td>
1842 <td class="parameter_annotations"> </td>
1843 </tr>
1844 <tr>
1845 <td class="parameter_name"><p>arg_panel_position</p></td>
1846 <td class="parameter_description"><p>Argument passed by remote caller.</p></td>
1847 <td class="parameter_annotations"> </td>
1848 </tr>
1849 <tr>
1850 <td class="parameter_name"><p>user_data</p></td>
1851 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
1852 <td class="parameter_annotations"> </td>
1853 </tr>
1854 </tbody>
1855 </table></div>
1856 </div>
1857 <div class="refsect3">
1858 <a name="XAppStatusIconInterface-handle-button-release.returns"></a><h4>Returns</h4>
1859 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the invocation was handled, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to let other signal handlers run.</p>
1860 </div>
1861 <p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
1862 </div>
1863 </div>
1864 </div>
1865 <div class="footer">
1866 <hr>Generated by GTK-Doc V1.27</div>
1867 </body>
1868 </html>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>XAppStatusIconMonitor: XApp Reference Manual</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
6 <link rel="home" href="index.html" title="XApp Reference Manual">
7 <link rel="up" href="ch01.html" title="API reference">
8 <link rel="prev" href="XAppStatusIcon.html" title="XAppStatusIcon">
9 <link rel="next" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">
10 <meta name="generator" content="GTK-Doc V1.27 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 </head>
13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
15 <td width="100%" align="left" class="shortcuts">
16 <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
17 <a href="#XAppStatusIconMonitor.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
18 <a href="#XAppStatusIconMonitor.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_signals">  <span class="dim">|</span> 
19 <a href="#XAppStatusIconMonitor.signals" class="shortcut">Signals</a></span>
20 </td>
21 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
22 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
23 <td><a accesskey="p" href="XAppStatusIcon.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
24 <td><a accesskey="n" href="XAppStatusIconInterfaceSkeleton.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
25 </tr></table>
26 <div class="refentry">
27 <a name="XAppStatusIconMonitor"></a><div class="titlepage"></div>
28 <div class="refnamediv"><table width="100%"><tr>
29 <td valign="top">
30 <h2><span class="refentrytitle"><a name="XAppStatusIconMonitor.top_of_page"></a>XAppStatusIconMonitor</span></h2>
31 <p>XAppStatusIconMonitor — Looks for XAppStatusIcons on DBUS and communicates
32 info to an applet to represent the icons.</p>
33 </td>
34 <td class="gallery_image" valign="top" align="right"></td>
35 </tr></table></div>
36 <div class="refsect1">
37 <a name="XAppStatusIconMonitor.functions"></a><h2>Functions</h2>
38 <div class="informaltable"><table class="informaltable" width="100%" border="0">
39 <colgroup>
40 <col width="150px" class="functions_return">
41 <col class="functions_name">
42 </colgroup>
43 <tbody>
44 <tr>
45 <td class="function_type">
46 <a class="link" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor"><span class="returnvalue">XAppStatusIconMonitor</span></a> *
47 </td>
48 <td class="function_name">
49 <a class="link" href="XAppStatusIconMonitor.html#xapp-status-icon-monitor-new" title="xapp_status_icon_monitor_new ()">xapp_status_icon_monitor_new</a> <span class="c_punctuation">()</span>
50 </td>
51 </tr>
52 <tr>
53 <td class="function_type">
54 <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
55 </td>
56 <td class="function_name">
57 <a class="link" href="XAppStatusIconMonitor.html#xapp-status-icon-monitor-list-icons" title="xapp_status_icon_monitor_list_icons ()">xapp_status_icon_monitor_list_icons</a> <span class="c_punctuation">()</span>
58 </td>
59 </tr>
60 </tbody>
61 </table></div>
62 </div>
63 <div class="refsect1">
64 <a name="XAppStatusIconMonitor.signals"></a><h2>Signals</h2>
65 <div class="informaltable"><table class="informaltable" border="0">
66 <colgroup>
67 <col width="150px" class="signals_return">
68 <col width="300px" class="signals_name">
69 <col width="200px" class="signals_flags">
70 </colgroup>
71 <tbody>
72 <tr>
73 <td class="signal_type"><span class="returnvalue">void</span></td>
74 <td class="signal_name"><a class="link" href="XAppStatusIconMonitor.html#XAppStatusIconMonitor-icon-added" title="The “icon-added” signal">icon-added</a></td>
75 <td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
76 </tr>
77 <tr>
78 <td class="signal_type"><span class="returnvalue">void</span></td>
79 <td class="signal_name"><a class="link" href="XAppStatusIconMonitor.html#XAppStatusIconMonitor-icon-removed" title="The “icon-removed” signal">icon-removed</a></td>
80 <td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
81 </tr>
82 </tbody>
83 </table></div>
84 </div>
85 <div class="refsect1">
86 <a name="XAppStatusIconMonitor.other"></a><h2>Types and Values</h2>
87 <div class="informaltable"><table class="informaltable" width="100%" border="0">
88 <colgroup>
89 <col width="150px" class="name">
90 <col class="description">
91 </colgroup>
92 <tbody>
93 <tr>
94 <td class="define_keyword">#define</td>
95 <td class="function_name"><a class="link" href="XAppStatusIconMonitor.html#XAPP-TYPE-STATUS-ICON-MONITOR:CAPS" title="XAPP_TYPE_STATUS_ICON_MONITOR">XAPP_TYPE_STATUS_ICON_MONITOR</a></td>
96 </tr>
97 <tr>
98 <td class="datatype_keyword"> </td>
99 <td class="function_name"><a class="link" href="XAppStatusIconMonitor.html#XAppStatusIconMonitor-struct" title="XAppStatusIconMonitor">XAppStatusIconMonitor</a></td>
100 </tr>
101 </tbody>
102 </table></div>
103 </div>
104 <div class="refsect1">
105 <a name="XAppStatusIconMonitor.object-hierarchy"></a><h2>Object Hierarchy</h2>
106 <pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
107 <span class="lineart">╰──</span> XAppStatusIconMonitor
108 </pre>
109 </div>
110 <div class="refsect1">
111 <a name="XAppStatusIconMonitor.description"></a><h2>Description</h2>
112 <p>The XAppStatusIconMonitor is intended to be utilized by some status applet
113 to display info about an app.</p>
114 <p>The simplest way to use is to make a new instance of this monitor, and connect
115 to the <a class="link" href="XAppStatusIconMonitor.html#XAppStatusIconMonitor-icon-added" title="The “icon-added” signal"><span class="type">“icon-added”</span></a> and <a class="link" href="XAppStatusIconMonitor.html#XAppStatusIconMonitor-icon-removed" title="The “icon-removed” signal"><span class="type">“icon-removed”</span></a> signals.
116 The received object for both of these signals is an <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterfaceProxy"><span class="type">XAppStatusIconInterfaceProxy</span></a>.
117 It represents an application's <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a>, and has properties available for
118 describing the icon name, tooltip, label and visibility.</p>
119 <p>The proxy also provides methods to handle clicks, which can be called by the applet,
120 to request that the app display its menu.</p>
121 </div>
122 <div class="refsect1">
123 <a name="XAppStatusIconMonitor.functions_details"></a><h2>Functions</h2>
124 <div class="refsect2">
125 <a name="xapp-status-icon-monitor-new"></a><h3>xapp_status_icon_monitor_new ()</h3>
126 <pre class="programlisting"><a class="link" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor"><span class="returnvalue">XAppStatusIconMonitor</span></a> *
127 xapp_status_icon_monitor_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
128 <p>Creates a new monitor.</p>
129 <div class="refsect3">
130 <a name="xapp-status-icon-monitor-new.returns"></a><h4>Returns</h4>
131 <p>a new <a class="link" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor"><span class="type">XAppStatusIconMonitor</span></a>. Use g_object_unref when finished. </p>
132 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
133 </div>
134 <p class="since">Since: 1.6</p>
135 </div>
136 <hr>
137 <div class="refsect2">
138 <a name="xapp-status-icon-monitor-list-icons"></a><h3>xapp_status_icon_monitor_list_icons ()</h3>
139 <pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
140 xapp_status_icon_monitor_list_icons (<em class="parameter"><code><a class="link" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor"><span class="type">XAppStatusIconMonitor</span></a> *monitor</code></em>);</pre>
141 <p>List known icon proxies.</p>
142 <div class="refsect3">
143 <a name="xapp-status-icon-monitor-list-icons.parameters"></a><h4>Parameters</h4>
144 <div class="informaltable"><table class="informaltable" width="100%" border="0">
145 <colgroup>
146 <col width="150px" class="parameters_name">
147 <col class="parameters_description">
148 <col width="200px" class="parameters_annotations">
149 </colgroup>
150 <tbody><tr>
151 <td class="parameter_name"><p>monitor</p></td>
152 <td class="parameter_description"><p>a <a class="link" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor"><span class="type">XAppStatusIconMonitor</span></a></p></td>
153 <td class="parameter_annotations"> </td>
154 </tr></tbody>
155 </table></div>
156 </div>
157 <div class="refsect3">
158 <a name="xapp-status-icon-monitor-list-icons.returns"></a><h4>Returns</h4>
159 <p>a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of icons. </p>
160 <p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> XAppStatusIconMonitor][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></p>
161 </div>
162 <p class="since">Since: 1.6</p>
163 </div>
164 </div>
165 <div class="refsect1">
166 <a name="XAppStatusIconMonitor.other_details"></a><h2>Types and Values</h2>
167 <div class="refsect2">
168 <a name="XAPP-TYPE-STATUS-ICON-MONITOR:CAPS"></a><h3>XAPP_TYPE_STATUS_ICON_MONITOR</h3>
169 <pre class="programlisting">#define XAPP_TYPE_STATUS_ICON_MONITOR (xapp_status_icon_monitor_get_type ())
170 </pre>
171 </div>
172 <hr>
173 <div class="refsect2">
174 <a name="XAppStatusIconMonitor-struct"></a><h3>XAppStatusIconMonitor</h3>
175 <pre class="programlisting">typedef struct _XAppStatusIconMonitor XAppStatusIconMonitor;</pre>
176 </div>
177 </div>
178 <div class="refsect1">
179 <a name="XAppStatusIconMonitor.signal-details"></a><h2>Signal Details</h2>
180 <div class="refsect2">
181 <a name="XAppStatusIconMonitor-icon-added"></a><h3>The <code class="literal">“icon-added”</code> signal</h3>
182 <pre class="programlisting"><span class="returnvalue">void</span>
183 user_function (<a class="link" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor"><span class="type">XAppStatusIconMonitor</span></a> *monitor,
184 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterfaceProxy"><span class="type">XAppStatusIconInterfaceProxy</span></a> *proxy,
185 <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
186 <p>This signal is emitted by the monitor when it has discovered a new
187 <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a> on the bus.</p>
188 <div class="refsect3">
189 <a name="XAppStatusIconMonitor-icon-added.parameters"></a><h4>Parameters</h4>
190 <div class="informaltable"><table class="informaltable" width="100%" border="0">
191 <colgroup>
192 <col width="150px" class="parameters_name">
193 <col class="parameters_description">
194 <col width="200px" class="parameters_annotations">
195 </colgroup>
196 <tbody>
197 <tr>
198 <td class="parameter_name"><p>monitor</p></td>
199 <td class="parameter_description"><p>the <a class="link" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor"><span class="type">XAppStatusIconMonitor</span></a></p></td>
200 <td class="parameter_annotations"> </td>
201 </tr>
202 <tr>
203 <td class="parameter_name"><p>proxy</p></td>
204 <td class="parameter_description"><p>the interface proxy for the <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a> that has been added.</p></td>
205 <td class="parameter_annotations"> </td>
206 </tr>
207 <tr>
208 <td class="parameter_name"><p>user_data</p></td>
209 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
210 <td class="parameter_annotations"> </td>
211 </tr>
212 </tbody>
213 </table></div>
214 </div>
215 <p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
216 </div>
217 <hr>
218 <div class="refsect2">
219 <a name="XAppStatusIconMonitor-icon-removed"></a><h3>The <code class="literal">“icon-removed”</code> signal</h3>
220 <pre class="programlisting"><span class="returnvalue">void</span>
221 user_function (<a class="link" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor"><span class="type">XAppStatusIconMonitor</span></a> *monitor,
222 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterfaceProxy"><span class="type">XAppStatusIconInterfaceProxy</span></a> *proxy,
223 <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
224 <p>This signal is emitted by the monitor when an <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a> has disappeared
225 from the bus.</p>
226 <div class="refsect3">
227 <a name="XAppStatusIconMonitor-icon-removed.parameters"></a><h4>Parameters</h4>
228 <div class="informaltable"><table class="informaltable" width="100%" border="0">
229 <colgroup>
230 <col width="150px" class="parameters_name">
231 <col class="parameters_description">
232 <col width="200px" class="parameters_annotations">
233 </colgroup>
234 <tbody>
235 <tr>
236 <td class="parameter_name"><p>monitor</p></td>
237 <td class="parameter_description"><p>the <a class="link" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor"><span class="type">XAppStatusIconMonitor</span></a></p></td>
238 <td class="parameter_annotations"> </td>
239 </tr>
240 <tr>
241 <td class="parameter_name"><p>proxy</p></td>
242 <td class="parameter_description"><p>the <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon"><span class="type">XAppStatusIcon</span></a> proxy that has been removed.</p></td>
243 <td class="parameter_annotations"> </td>
244 </tr>
245 <tr>
246 <td class="parameter_name"><p>user_data</p></td>
247 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
248 <td class="parameter_annotations"> </td>
249 </tr>
250 </tbody>
251 </table></div>
252 </div>
253 <p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
254 </div>
255 </div>
256 </div>
257 <div class="footer">
258 <hr>Generated by GTK-Doc V1.27</div>
259 </body>
260 </html>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>Annotation Glossary: XApp Reference Manual</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
6 <link rel="home" href="index.html" title="XApp Reference Manual">
7 <link rel="up" href="index.html" title="XApp Reference Manual">
8 <link rel="prev" href="deprecated-api-index.html" title="Index of deprecated API">
9 <meta name="generator" content="GTK-Doc V1.27 (XML mode)">
10 <link rel="stylesheet" href="style.css" type="text/css">
11 </head>
12 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
13 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
14 <td width="100%" align="left" class="shortcuts"><span id="nav_glossary"><a class="shortcut" href="#glsA">A</a>
15  <span class="dim">|</span> 
16 <a class="shortcut" href="#glsE">E</a>
17  <span class="dim">|</span> 
18 <a class="shortcut" href="#glsN">N</a>
19  <span class="dim">|</span> 
20 <a class="shortcut" href="#glsS">S</a>
21  <span class="dim">|</span> 
22 <a class="shortcut" href="#glsT">T</a></span></td>
23 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
24 <td><img src="up-insensitive.png" width="16" height="16" border="0"></td>
25 <td><a accesskey="p" href="deprecated-api-index.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
26 <td><img src="right-insensitive.png" width="16" height="16" border="0"></td>
27 </tr></table>
28 <div class="glossary">
29 <div class="titlepage"><div><div><h1 class="title">
30 <a name="annotation-glossary"></a>Annotation Glossary</h1></div></div></div>
31 <a name="glsA"></a><h3 class="title">A</h3>
32 <dt><span class="glossterm"><a name="annotation-glossterm-array"></a>array</span></dt>
33 <dd class="glossdef"><p>Parameter points to an array of items.</p></dd>
34 <a name="glsE"></a><h3 class="title">E</h3>
35 <dt><span class="glossterm"><a name="annotation-glossterm-element-type"></a>element-type</span></dt>
36 <dd class="glossdef"><p>Generics and defining elements of containers and arrays.</p></dd>
37 <a name="glsN"></a><h3 class="title">N</h3>
38 <dt><span class="glossterm"><a name="annotation-glossterm-nullable"></a>nullable</span></dt>
39 <dd class="glossdef"><p>NULL may be passed as the value in, out, in-out; or as a return value.</p></dd>
40 <a name="glsS"></a><h3 class="title">S</h3>
41 <dt><span class="glossterm"><a name="annotation-glossterm-skip"></a>skip</span></dt>
42 <dd class="glossdef"><p>Exposed in C code, not necessarily available in other languages.</p></dd>
43 <a name="glsT"></a><h3 class="title">T</h3>
44 <dt><span class="glossterm"><a name="annotation-glossterm-transfer%20container"></a>transfer container</span></dt>
45 <dd class="glossdef"><p>Free data container after the code is done.</p></dd>
46 <dt><span class="glossterm"><a name="annotation-glossterm-transfer%20full"></a>transfer full</span></dt>
47 <dd class="glossdef"><p>Free data after the code is done.</p></dd>
48 <dt><span class="glossterm"><a name="annotation-glossterm-transfer%20none"></a>transfer none</span></dt>
49 <dd class="glossdef"><p>Don't free data after the code is done.</p></dd>
50 <dt><span class="glossterm"><a name="annotation-glossterm-type"></a>type</span></dt>
51 <dd class="glossdef"><p>Override the parsed C type with given type.</p></dd>
52 </div>
53 <div class="footer">
54 <hr>Generated by GTK-Doc V1.27</div>
55 </body>
56 </html>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>API Index: XApp Reference Manual</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
6 <link rel="home" href="index.html" title="XApp Reference Manual">
7 <link rel="up" href="index.html" title="XApp Reference Manual">
8 <link rel="prev" href="object-tree.html" title="Object Hierarchy">
9 <link rel="next" href="deprecated-api-index.html" title="Index of deprecated API">
10 <meta name="generator" content="GTK-Doc V1.27 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 </head>
13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
15 <td width="100%" align="left" class="shortcuts"><span id="nav_index"><a class="shortcut" href="#idxG">G</a>
16  <span class="dim">|</span> 
17 <a class="shortcut" href="#idxI">I</a>
18  <span class="dim">|</span> 
19 <a class="shortcut" href="#idxK">K</a>
20  <span class="dim">|</span> 
21 <a class="shortcut" href="#idxM">M</a>
22  <span class="dim">|</span> 
23 <a class="shortcut" href="#idxP">P</a>
24  <span class="dim">|</span> 
25 <a class="shortcut" href="#idxS">S</a>
26  <span class="dim">|</span> 
27 <a class="shortcut" href="#idxT">T</a></span></td>
28 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
29 <td><img src="up-insensitive.png" width="16" height="16" border="0"></td>
30 <td><a accesskey="p" href="object-tree.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
31 <td><a accesskey="n" href="deprecated-api-index.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
32 </tr></table>
33 <div class="index">
34 <div class="titlepage"><div><div><h1 class="title">
35 <a name="api-index-full"></a>API Index</h1></div></div></div>
36 <a name="idx"></a><a name="idxG"></a><h3 class="title">G</h3>
37 <dt>
38 <a class="link" href="XAppGtkWindow.html#XAppGtkWindow-struct" title="XAppGtkWindow">XAppGtkWindow</a>, struct in <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
39 </dt>
40 <dd></dd>
41 <dt>
42 <a class="link" href="XAppGtkWindow.html#XAppGtkWindowClass" title="struct XAppGtkWindowClass">XAppGtkWindowClass</a>, struct in <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
43 </dt>
44 <dd></dd>
45 <dt>
46 <a class="link" href="XAppGtkWindow.html#xapp-gtk-window-new" title="xapp_gtk_window_new ()">xapp_gtk_window_new</a>, function in <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
47 </dt>
48 <dd></dd>
49 <dt>
50 <a class="link" href="XAppGtkWindow.html#xapp-gtk-window-set-icon-from-file" title="xapp_gtk_window_set_icon_from_file ()">xapp_gtk_window_set_icon_from_file</a>, function in <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
51 </dt>
52 <dd></dd>
53 <dt>
54 <a class="link" href="XAppGtkWindow.html#xapp-gtk-window-set-icon-name" title="xapp_gtk_window_set_icon_name ()">xapp_gtk_window_set_icon_name</a>, function in <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
55 </dt>
56 <dd></dd>
57 <dt>
58 <a class="link" href="XAppGtkWindow.html#xapp-gtk-window-set-progress" title="xapp_gtk_window_set_progress ()">xapp_gtk_window_set_progress</a>, function in <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
59 </dt>
60 <dd></dd>
61 <dt>
62 <a class="link" href="XAppGtkWindow.html#xapp-gtk-window-set-progress-pulse" title="xapp_gtk_window_set_progress_pulse ()">xapp_gtk_window_set_progress_pulse</a>, function in <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
63 </dt>
64 <dd></dd>
65 <a name="idxI"></a><h3 class="title">I</h3>
66 <dt>
67 <a class="link" href="XAppIconChooserButton.html#XAppIconChooserButton-struct" title="XAppIconChooserButton">XAppIconChooserButton</a>, struct in <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton">XAppIconChooserButton</a>
68 </dt>
69 <dd></dd>
70 <dt>
71 <a class="link" href="XAppIconChooserButton.html#XAppIconChooserButton--category" title="The “category” property">XAppIconChooserButton:category</a>, object property in <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton">XAppIconChooserButton</a>
72 </dt>
73 <dd></dd>
74 <dt>
75 <a class="link" href="XAppIconChooserButton.html#XAppIconChooserButton--icon" title="The “icon” property">XAppIconChooserButton:icon</a>, object property in <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton">XAppIconChooserButton</a>
76 </dt>
77 <dd></dd>
78 <dt>
79 <a class="link" href="XAppIconChooserButton.html#XAppIconChooserButton--icon-size" title="The “icon-size” property">XAppIconChooserButton:icon-size</a>, object property in <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton">XAppIconChooserButton</a>
80 </dt>
81 <dd></dd>
82 <dt>
83 <a class="link" href="XAppIconChooserDialog.html#XAppIconChooserDialog-struct" title="XAppIconChooserDialog">XAppIconChooserDialog</a>, struct in <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
84 </dt>
85 <dd></dd>
86 <dt>
87 <a class="link" href="XAppIconChooserDialog.html#XAppIconChooserDialog-close" title="The “close” signal">XAppIconChooserDialog::close</a>, object signal in <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
88 </dt>
89 <dd></dd>
90 <dt>
91 <a class="link" href="XAppIconChooserDialog.html#XAppIconChooserDialog-select" title="The “select” signal">XAppIconChooserDialog::select</a>, object signal in <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
92 </dt>
93 <dd></dd>
94 <dt>
95 <a class="link" href="XAppIconChooserDialog.html#XAppIconChooserDialog--allow-paths" title="The “allow-paths” property">XAppIconChooserDialog:allow-paths</a>, object property in <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
96 </dt>
97 <dd></dd>
98 <dt>
99 <a class="link" href="XAppIconChooserDialog.html#XAppIconChooserDialog--default-icon" title="The “default-icon” property">XAppIconChooserDialog:default-icon</a>, object property in <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
100 </dt>
101 <dd></dd>
102 <dt>
103 <a class="link" href="XAppIconChooserDialog.html#XAppIconChooserDialog--icon-size" title="The “icon-size” property">XAppIconChooserDialog:icon-size</a>, object property in <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
104 </dt>
105 <dd></dd>
106 <dt>
107 <a class="link" href="XAppIconChooserDialog.html#XAppIconSize" title="enum XAppIconSize">XAppIconSize</a>, enum in <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
108 </dt>
109 <dd></dd>
110 <dt>
111 <a class="link" href="XAppIconChooserButton.html#xapp-icon-chooser-button-get-dialog" title="xapp_icon_chooser_button_get_dialog ()">xapp_icon_chooser_button_get_dialog</a>, function in <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton">XAppIconChooserButton</a>
112 </dt>
113 <dd></dd>
114 <dt>
115 <a class="link" href="XAppIconChooserButton.html#xapp-icon-chooser-button-get-icon" title="xapp_icon_chooser_button_get_icon ()">xapp_icon_chooser_button_get_icon</a>, function in <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton">XAppIconChooserButton</a>
116 </dt>
117 <dd></dd>
118 <dt>
119 <a class="link" href="XAppIconChooserButton.html#xapp-icon-chooser-button-new" title="xapp_icon_chooser_button_new ()">xapp_icon_chooser_button_new</a>, function in <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton">XAppIconChooserButton</a>
120 </dt>
121 <dd></dd>
122 <dt>
123 <a class="link" href="XAppIconChooserButton.html#xapp-icon-chooser-button-new-with-size" title="xapp_icon_chooser_button_new_with_size ()">xapp_icon_chooser_button_new_with_size</a>, function in <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton">XAppIconChooserButton</a>
124 </dt>
125 <dd></dd>
126 <dt>
127 <a class="link" href="XAppIconChooserButton.html#xapp-icon-chooser-button-set-default-category" title="xapp_icon_chooser_button_set_default_category ()">xapp_icon_chooser_button_set_default_category</a>, function in <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton">XAppIconChooserButton</a>
128 </dt>
129 <dd></dd>
130 <dt>
131 <a class="link" href="XAppIconChooserButton.html#xapp-icon-chooser-button-set-icon" title="xapp_icon_chooser_button_set_icon ()">xapp_icon_chooser_button_set_icon</a>, function in <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton">XAppIconChooserButton</a>
132 </dt>
133 <dd></dd>
134 <dt>
135 <a class="link" href="XAppIconChooserButton.html#xapp-icon-chooser-button-set-icon-size" title="xapp_icon_chooser_button_set_icon_size ()">xapp_icon_chooser_button_set_icon_size</a>, function in <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton">XAppIconChooserButton</a>
136 </dt>
137 <dd></dd>
138 <dt>
139 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-add-button" title="xapp_icon_chooser_dialog_add_button ()">xapp_icon_chooser_dialog_add_button</a>, function in <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
140 </dt>
141 <dd></dd>
142 <dt>
143 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-add-custom-category" title="xapp_icon_chooser_dialog_add_custom_category ()">xapp_icon_chooser_dialog_add_custom_category</a>, function in <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
144 </dt>
145 <dd></dd>
146 <dt>
147 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-get-default-icon" title="xapp_icon_chooser_dialog_get_default_icon ()">xapp_icon_chooser_dialog_get_default_icon</a>, function in <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
148 </dt>
149 <dd></dd>
150 <dt>
151 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-get-icon-string" title="xapp_icon_chooser_dialog_get_icon_string ()">xapp_icon_chooser_dialog_get_icon_string</a>, function in <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
152 </dt>
153 <dd></dd>
154 <dt>
155 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-new" title="xapp_icon_chooser_dialog_new ()">xapp_icon_chooser_dialog_new</a>, function in <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
156 </dt>
157 <dd></dd>
158 <dt>
159 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-run" title="xapp_icon_chooser_dialog_run ()">xapp_icon_chooser_dialog_run</a>, function in <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
160 </dt>
161 <dd></dd>
162 <dt>
163 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-run-with-category" title="xapp_icon_chooser_dialog_run_with_category ()">xapp_icon_chooser_dialog_run_with_category</a>, function in <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
164 </dt>
165 <dd></dd>
166 <dt>
167 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-run-with-icon" title="xapp_icon_chooser_dialog_run_with_icon ()">xapp_icon_chooser_dialog_run_with_icon</a>, function in <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
168 </dt>
169 <dd></dd>
170 <dt>
171 <a class="link" href="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-set-default-icon" title="xapp_icon_chooser_dialog_set_default_icon ()">xapp_icon_chooser_dialog_set_default_icon</a>, function in <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
172 </dt>
173 <dd></dd>
174 <a name="idxK"></a><h3 class="title">K</h3>
175 <dt>
176 <a class="link" href="XAppKbdLayoutController.html#XAppKbdLayoutController-config-changed" title="The “config-changed” signal">XAppKbdLayoutController::config-changed</a>, object signal in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
177 </dt>
178 <dd></dd>
179 <dt>
180 <a class="link" href="XAppKbdLayoutController.html#XAppKbdLayoutController-layout-changed" title="The “layout-changed” signal">XAppKbdLayoutController::layout-changed</a>, object signal in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
181 </dt>
182 <dd></dd>
183 <dt>
184 <a class="link" href="XAppKbdLayoutController.html#XAppKbdLayoutController--enabled" title="The “enabled” property">XAppKbdLayoutController:enabled</a>, object property in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
185 </dt>
186 <dd></dd>
187 <dt>
188 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-all-names" title="xapp_kbd_layout_controller_get_all_names ()">xapp_kbd_layout_controller_get_all_names</a>, function in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
189 </dt>
190 <dd></dd>
191 <dt>
192 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-flag-id" title="xapp_kbd_layout_controller_get_current_flag_id ()">xapp_kbd_layout_controller_get_current_flag_id</a>, function in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
193 </dt>
194 <dd></dd>
195 <dt>
196 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-group" title="xapp_kbd_layout_controller_get_current_group ()">xapp_kbd_layout_controller_get_current_group</a>, function in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
197 </dt>
198 <dd></dd>
199 <dt>
200 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-icon-name" title="xapp_kbd_layout_controller_get_current_icon_name ()">xapp_kbd_layout_controller_get_current_icon_name</a>, function in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
201 </dt>
202 <dd></dd>
203 <dt>
204 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-name" title="xapp_kbd_layout_controller_get_current_name ()">xapp_kbd_layout_controller_get_current_name</a>, function in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
205 </dt>
206 <dd></dd>
207 <dt>
208 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-short-group-label" title="xapp_kbd_layout_controller_get_current_short_group_label ()">xapp_kbd_layout_controller_get_current_short_group_label</a>, function in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
209 </dt>
210 <dd></dd>
211 <dt>
212 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-variant-label" title="xapp_kbd_layout_controller_get_current_variant_label ()">xapp_kbd_layout_controller_get_current_variant_label</a>, function in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
213 </dt>
214 <dd></dd>
215 <dt>
216 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-enabled" title="xapp_kbd_layout_controller_get_enabled ()">xapp_kbd_layout_controller_get_enabled</a>, function in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
217 </dt>
218 <dd></dd>
219 <dt>
220 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-flag-id-for-group" title="xapp_kbd_layout_controller_get_flag_id_for_group ()">xapp_kbd_layout_controller_get_flag_id_for_group</a>, function in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
221 </dt>
222 <dd></dd>
223 <dt>
224 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-icon-name-for-group" title="xapp_kbd_layout_controller_get_icon_name_for_group ()">xapp_kbd_layout_controller_get_icon_name_for_group</a>, function in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
225 </dt>
226 <dd></dd>
227 <dt>
228 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-short-group-label-for-group" title="xapp_kbd_layout_controller_get_short_group_label_for_group ()">xapp_kbd_layout_controller_get_short_group_label_for_group</a>, function in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
229 </dt>
230 <dd></dd>
231 <dt>
232 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-variant-label-for-group" title="xapp_kbd_layout_controller_get_variant_label_for_group ()">xapp_kbd_layout_controller_get_variant_label_for_group</a>, function in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
233 </dt>
234 <dd></dd>
235 <dt>
236 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-new" title="xapp_kbd_layout_controller_new ()">xapp_kbd_layout_controller_new</a>, function in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
237 </dt>
238 <dd></dd>
239 <dt>
240 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-next-group" title="xapp_kbd_layout_controller_next_group ()">xapp_kbd_layout_controller_next_group</a>, function in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
241 </dt>
242 <dd></dd>
243 <dt>
244 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-previous-group" title="xapp_kbd_layout_controller_previous_group ()">xapp_kbd_layout_controller_previous_group</a>, function in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
245 </dt>
246 <dd></dd>
247 <dt>
248 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-render-cairo-subscript" title="xapp_kbd_layout_controller_render_cairo_subscript ()">xapp_kbd_layout_controller_render_cairo_subscript</a>, function in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
249 </dt>
250 <dd></dd>
251 <dt>
252 <a class="link" href="XAppKbdLayoutController.html#xapp-kbd-layout-controller-set-current-group" title="xapp_kbd_layout_controller_set_current_group ()">xapp_kbd_layout_controller_set_current_group</a>, function in <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
253 </dt>
254 <dd></dd>
255 <a name="idxM"></a><h3 class="title">M</h3>
256 <dt>
257 <a class="link" href="XAppMonitorBlanker.html#xapp-monitor-blanker-are-monitors-blanked" title="xapp_monitor_blanker_are_monitors_blanked ()">xapp_monitor_blanker_are_monitors_blanked</a>, function in <a class="link" href="XAppMonitorBlanker.html" title="XAppMonitorBlanker">XAppMonitorBlanker</a>
258 </dt>
259 <dd></dd>
260 <dt>
261 <a class="link" href="XAppMonitorBlanker.html#xapp-monitor-blanker-blank-other-monitors" title="xapp_monitor_blanker_blank_other_monitors ()">xapp_monitor_blanker_blank_other_monitors</a>, function in <a class="link" href="XAppMonitorBlanker.html" title="XAppMonitorBlanker">XAppMonitorBlanker</a>
262 </dt>
263 <dd></dd>
264 <dt>
265 <a class="link" href="XAppMonitorBlanker.html#xapp-monitor-blanker-new" title="xapp_monitor_blanker_new ()">xapp_monitor_blanker_new</a>, function in <a class="link" href="XAppMonitorBlanker.html" title="XAppMonitorBlanker">XAppMonitorBlanker</a>
266 </dt>
267 <dd></dd>
268 <dt>
269 <a class="link" href="XAppMonitorBlanker.html#xapp-monitor-blanker-unblank-monitors" title="xapp_monitor_blanker_unblank_monitors ()">xapp_monitor_blanker_unblank_monitors</a>, function in <a class="link" href="XAppMonitorBlanker.html" title="XAppMonitorBlanker">XAppMonitorBlanker</a>
270 </dt>
271 <dd></dd>
272 <a name="idxP"></a><h3 class="title">P</h3>
273 <dt>
274 <a class="link" href="XAppPreferencesWindow.html#XAppPreferencesWindow-struct" title="XAppPreferencesWindow">XAppPreferencesWindow</a>, struct in <a class="link" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow">XAppPreferencesWindow</a>
275 </dt>
276 <dd></dd>
277 <dt>
278 <a class="link" href="XAppPreferencesWindow.html#XAppPreferencesWindow-close" title="The “close” signal">XAppPreferencesWindow::close</a>, object signal in <a class="link" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow">XAppPreferencesWindow</a>
279 </dt>
280 <dd></dd>
281 <dt>
282 <a class="link" href="XAppPreferencesWindow.html#XAppPreferencesWindowClass" title="struct XAppPreferencesWindowClass">XAppPreferencesWindowClass</a>, struct in <a class="link" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow">XAppPreferencesWindow</a>
283 </dt>
284 <dd></dd>
285 <dt>
286 <a class="link" href="XAppPreferencesWindow.html#xapp-preferences-window-add-button" title="xapp_preferences_window_add_button ()">xapp_preferences_window_add_button</a>, function in <a class="link" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow">XAppPreferencesWindow</a>
287 </dt>
288 <dd></dd>
289 <dt>
290 <a class="link" href="XAppPreferencesWindow.html#xapp-preferences-window-add-page" title="xapp_preferences_window_add_page ()">xapp_preferences_window_add_page</a>, function in <a class="link" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow">XAppPreferencesWindow</a>
291 </dt>
292 <dd></dd>
293 <dt>
294 <a class="link" href="XAppPreferencesWindow.html#xapp-preferences-window-new" title="xapp_preferences_window_new ()">xapp_preferences_window_new</a>, function in <a class="link" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow">XAppPreferencesWindow</a>
295 </dt>
296 <dd></dd>
297 <a name="idxS"></a><h3 class="title">S</h3>
298 <dt>
299 <a class="link" href="XAppGtkWindow.html#xapp-set-window-icon-from-file" title="xapp_set_window_icon_from_file ()">xapp_set_window_icon_from_file</a>, function in <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
300 </dt>
301 <dd></dd>
302 <dt>
303 <a class="link" href="XAppGtkWindow.html#xapp-set-window-icon-name" title="xapp_set_window_icon_name ()">xapp_set_window_icon_name</a>, function in <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
304 </dt>
305 <dd></dd>
306 <dt>
307 <a class="link" href="XAppGtkWindow.html#xapp-set-window-progress" title="xapp_set_window_progress ()">xapp_set_window_progress</a>, function in <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
308 </dt>
309 <dd></dd>
310 <dt>
311 <a class="link" href="XAppGtkWindow.html#xapp-set-window-progress-pulse" title="xapp_set_window_progress_pulse ()">xapp_set_window_progress_pulse</a>, function in <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
312 </dt>
313 <dd></dd>
314 <dt>
315 <a class="link" href="XAppGtkWindow.html#xapp-set-xid-icon-from-file" title="xapp_set_xid_icon_from_file ()">xapp_set_xid_icon_from_file</a>, function in <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
316 </dt>
317 <dd></dd>
318 <dt>
319 <a class="link" href="XAppGtkWindow.html#xapp-set-xid-icon-name" title="xapp_set_xid_icon_name ()">xapp_set_xid_icon_name</a>, function in <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
320 </dt>
321 <dd></dd>
322 <dt>
323 <a class="link" href="XAppGtkWindow.html#xapp-set-xid-progress" title="xapp_set_xid_progress ()">xapp_set_xid_progress</a>, function in <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
324 </dt>
325 <dd></dd>
326 <dt>
327 <a class="link" href="XAppGtkWindow.html#xapp-set-xid-progress-pulse" title="xapp_set_xid_progress_pulse ()">xapp_set_xid_progress_pulse</a>, function in <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
328 </dt>
329 <dd></dd>
330 <dt>
331 <a class="link" href="XAppStackSidebar.html#XAppStackSidebar-struct" title="XAppStackSidebar">XAppStackSidebar</a>, struct in <a class="link" href="XAppStackSidebar.html" title="XAppStackSidebar">XAppStackSidebar</a>
332 </dt>
333 <dd></dd>
334 <dt>
335 <a class="link" href="XAppStackSidebar.html#XAppStackSidebar--stack" title="The “stack” property">XAppStackSidebar:stack</a>, object property in <a class="link" href="XAppStackSidebar.html" title="XAppStackSidebar">XAppStackSidebar</a>
336 </dt>
337 <dd></dd>
338 <dt>
339 <a class="link" href="XAppStackSidebar.html#xapp-stack-sidebar-get-stack" title="xapp_stack_sidebar_get_stack ()">xapp_stack_sidebar_get_stack</a>, function in <a class="link" href="XAppStackSidebar.html" title="XAppStackSidebar">XAppStackSidebar</a>
340 </dt>
341 <dd></dd>
342 <dt>
343 <a class="link" href="XAppStackSidebar.html#xapp-stack-sidebar-new" title="xapp_stack_sidebar_new ()">xapp_stack_sidebar_new</a>, function in <a class="link" href="XAppStackSidebar.html" title="XAppStackSidebar">XAppStackSidebar</a>
344 </dt>
345 <dd></dd>
346 <dt>
347 <a class="link" href="XAppStackSidebar.html#xapp-stack-sidebar-set-stack" title="xapp_stack_sidebar_set_stack ()">xapp_stack_sidebar_set_stack</a>, function in <a class="link" href="XAppStackSidebar.html" title="XAppStackSidebar">XAppStackSidebar</a>
348 </dt>
349 <dd></dd>
350 <dt>
351 <a class="link" href="XAppStatusIcon.html#XAppStatusIcon-struct" title="XAppStatusIcon">XAppStatusIcon</a>, struct in <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
352 </dt>
353 <dd></dd>
354 <dt>
355 <a class="link" href="XAppStatusIcon.html#XAppStatusIcon-activate" title="The “activate” signal">XAppStatusIcon::activate</a>, object signal in <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
356 </dt>
357 <dd></dd>
358 <dt>
359 <a class="link" href="XAppStatusIcon.html#XAppStatusIcon-button-press-event" title="The “button-press-event” signal">XAppStatusIcon::button-press-event</a>, object signal in <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
360 </dt>
361 <dd></dd>
362 <dt>
363 <a class="link" href="XAppStatusIcon.html#XAppStatusIcon-button-release-event" title="The “button-release-event” signal">XAppStatusIcon::button-release-event</a>, object signal in <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
364 </dt>
365 <dd></dd>
366 <dt>
367 <a class="link" href="XAppStatusIcon.html#XAppStatusIcon--primary-menu" title="The “primary-menu” property">XAppStatusIcon:primary-menu</a>, object property in <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
368 </dt>
369 <dd></dd>
370 <dt>
371 <a class="link" href="XAppStatusIcon.html#XAppStatusIcon--secondary-menu" title="The “secondary-menu” property">XAppStatusIcon:secondary-menu</a>, object property in <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
372 </dt>
373 <dd></dd>
374 <dt>
375 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface-handle-button-press" title="The “handle-button-press” signal">XAppStatusIconInterface::handle-button-press</a>, object signal in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
376 </dt>
377 <dd></dd>
378 <dt>
379 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface-handle-button-release" title="The “handle-button-release” signal">XAppStatusIconInterface::handle-button-release</a>, object signal in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
380 </dt>
381 <dd></dd>
382 <dt>
383 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface--icon-name" title="The “icon-name” property">XAppStatusIconInterface:icon-name</a>, object property in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
384 </dt>
385 <dd></dd>
386 <dt>
387 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface--label" title="The “label” property">XAppStatusIconInterface:label</a>, object property in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
388 </dt>
389 <dd></dd>
390 <dt>
391 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface--name" title="The “name” property">XAppStatusIconInterface:name</a>, object property in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
392 </dt>
393 <dd></dd>
394 <dt>
395 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface--tooltip-text" title="The “tooltip-text” property">XAppStatusIconInterface:tooltip-text</a>, object property in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
396 </dt>
397 <dd></dd>
398 <dt>
399 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface--visible" title="The “visible” property">XAppStatusIconInterface:visible</a>, object property in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
400 </dt>
401 <dd></dd>
402 <dt>
403 <a class="link" href="XAppStatusIconMonitor.html#XAppStatusIconMonitor-struct" title="XAppStatusIconMonitor">XAppStatusIconMonitor</a>, struct in <a class="link" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor">XAppStatusIconMonitor</a>
404 </dt>
405 <dd></dd>
406 <dt>
407 <a class="link" href="XAppStatusIconMonitor.html#XAppStatusIconMonitor-icon-added" title="The “icon-added” signal">XAppStatusIconMonitor::icon-added</a>, object signal in <a class="link" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor">XAppStatusIconMonitor</a>
408 </dt>
409 <dd></dd>
410 <dt>
411 <a class="link" href="XAppStatusIconMonitor.html#XAppStatusIconMonitor-icon-removed" title="The “icon-removed” signal">XAppStatusIconMonitor::icon-removed</a>, object signal in <a class="link" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor">XAppStatusIconMonitor</a>
412 </dt>
413 <dd></dd>
414 <dt>
415 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-get-primary-menu" title="xapp_status_icon_get_primary_menu ()">xapp_status_icon_get_primary_menu</a>, function in <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
416 </dt>
417 <dd></dd>
418 <dt>
419 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-get-secondary-menu" title="xapp_status_icon_get_secondary_menu ()">xapp_status_icon_get_secondary_menu</a>, function in <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
420 </dt>
421 <dd></dd>
422 <dt>
423 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-press" title="xapp_status_icon_interface_call_button_press ()">xapp_status_icon_interface_call_button_press</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
424 </dt>
425 <dd></dd>
426 <dt>
427 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-press-finish" title="xapp_status_icon_interface_call_button_press_finish ()">xapp_status_icon_interface_call_button_press_finish</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
428 </dt>
429 <dd></dd>
430 <dt>
431 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-press-sync" title="xapp_status_icon_interface_call_button_press_sync ()">xapp_status_icon_interface_call_button_press_sync</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
432 </dt>
433 <dd></dd>
434 <dt>
435 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-release" title="xapp_status_icon_interface_call_button_release ()">xapp_status_icon_interface_call_button_release</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
436 </dt>
437 <dd></dd>
438 <dt>
439 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-release-finish" title="xapp_status_icon_interface_call_button_release_finish ()">xapp_status_icon_interface_call_button_release_finish</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
440 </dt>
441 <dd></dd>
442 <dt>
443 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-release-sync" title="xapp_status_icon_interface_call_button_release_sync ()">xapp_status_icon_interface_call_button_release_sync</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
444 </dt>
445 <dd></dd>
446 <dt>
447 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-complete-button-press" title="xapp_status_icon_interface_complete_button_press ()">xapp_status_icon_interface_complete_button_press</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
448 </dt>
449 <dd></dd>
450 <dt>
451 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-complete-button-release" title="xapp_status_icon_interface_complete_button_release ()">xapp_status_icon_interface_complete_button_release</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
452 </dt>
453 <dd></dd>
454 <dt>
455 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-dup-icon-name" title="xapp_status_icon_interface_dup_icon_name ()">xapp_status_icon_interface_dup_icon_name</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
456 </dt>
457 <dd></dd>
458 <dt>
459 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-dup-label" title="xapp_status_icon_interface_dup_label ()">xapp_status_icon_interface_dup_label</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
460 </dt>
461 <dd></dd>
462 <dt>
463 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-dup-name" title="xapp_status_icon_interface_dup_name ()">xapp_status_icon_interface_dup_name</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
464 </dt>
465 <dd></dd>
466 <dt>
467 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-dup-tooltip-text" title="xapp_status_icon_interface_dup_tooltip_text ()">xapp_status_icon_interface_dup_tooltip_text</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
468 </dt>
469 <dd></dd>
470 <dt>
471 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-get-icon-name" title="xapp_status_icon_interface_get_icon_name ()">xapp_status_icon_interface_get_icon_name</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
472 </dt>
473 <dd></dd>
474 <dt>
475 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-get-label" title="xapp_status_icon_interface_get_label ()">xapp_status_icon_interface_get_label</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
476 </dt>
477 <dd></dd>
478 <dt>
479 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-get-name" title="xapp_status_icon_interface_get_name ()">xapp_status_icon_interface_get_name</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
480 </dt>
481 <dd></dd>
482 <dt>
483 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-get-tooltip-text" title="xapp_status_icon_interface_get_tooltip_text ()">xapp_status_icon_interface_get_tooltip_text</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
484 </dt>
485 <dd></dd>
486 <dt>
487 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-get-visible" title="xapp_status_icon_interface_get_visible ()">xapp_status_icon_interface_get_visible</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
488 </dt>
489 <dd></dd>
490 <dt>
491 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-interface-info" title="xapp_status_icon_interface_interface_info ()">xapp_status_icon_interface_interface_info</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
492 </dt>
493 <dd></dd>
494 <dt>
495 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-override-properties" title="xapp_status_icon_interface_override_properties ()">xapp_status_icon_interface_override_properties</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
496 </dt>
497 <dd></dd>
498 <dt>
499 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new" title="xapp_status_icon_interface_proxy_new ()">xapp_status_icon_interface_proxy_new</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
500 </dt>
501 <dd></dd>
502 <dt>
503 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-finish" title="xapp_status_icon_interface_proxy_new_finish ()">xapp_status_icon_interface_proxy_new_finish</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
504 </dt>
505 <dd></dd>
506 <dt>
507 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-for-bus" title="xapp_status_icon_interface_proxy_new_for_bus ()">xapp_status_icon_interface_proxy_new_for_bus</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
508 </dt>
509 <dd></dd>
510 <dt>
511 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-for-bus-finish" title="xapp_status_icon_interface_proxy_new_for_bus_finish ()">xapp_status_icon_interface_proxy_new_for_bus_finish</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
512 </dt>
513 <dd></dd>
514 <dt>
515 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-for-bus-sync" title="xapp_status_icon_interface_proxy_new_for_bus_sync ()">xapp_status_icon_interface_proxy_new_for_bus_sync</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
516 </dt>
517 <dd></dd>
518 <dt>
519 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-sync" title="xapp_status_icon_interface_proxy_new_sync ()">xapp_status_icon_interface_proxy_new_sync</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
520 </dt>
521 <dd></dd>
522 <dt>
523 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-set-icon-name" title="xapp_status_icon_interface_set_icon_name ()">xapp_status_icon_interface_set_icon_name</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
524 </dt>
525 <dd></dd>
526 <dt>
527 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-set-label" title="xapp_status_icon_interface_set_label ()">xapp_status_icon_interface_set_label</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
528 </dt>
529 <dd></dd>
530 <dt>
531 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-set-name" title="xapp_status_icon_interface_set_name ()">xapp_status_icon_interface_set_name</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
532 </dt>
533 <dd></dd>
534 <dt>
535 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-set-tooltip-text" title="xapp_status_icon_interface_set_tooltip_text ()">xapp_status_icon_interface_set_tooltip_text</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
536 </dt>
537 <dd></dd>
538 <dt>
539 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-set-visible" title="xapp_status_icon_interface_set_visible ()">xapp_status_icon_interface_set_visible</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
540 </dt>
541 <dd></dd>
542 <dt>
543 <a class="link" href="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-skeleton-new" title="xapp_status_icon_interface_skeleton_new ()">xapp_status_icon_interface_skeleton_new</a>, function in <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
544 </dt>
545 <dd></dd>
546 <dt>
547 <a class="link" href="XAppStatusIconMonitor.html#xapp-status-icon-monitor-list-icons" title="xapp_status_icon_monitor_list_icons ()">xapp_status_icon_monitor_list_icons</a>, function in <a class="link" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor">XAppStatusIconMonitor</a>
548 </dt>
549 <dd></dd>
550 <dt>
551 <a class="link" href="XAppStatusIconMonitor.html#xapp-status-icon-monitor-new" title="xapp_status_icon_monitor_new ()">xapp_status_icon_monitor_new</a>, function in <a class="link" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor">XAppStatusIconMonitor</a>
552 </dt>
553 <dd></dd>
554 <dt>
555 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-new" title="xapp_status_icon_new ()">xapp_status_icon_new</a>, function in <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
556 </dt>
557 <dd></dd>
558 <dt>
559 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-set-icon-name" title="xapp_status_icon_set_icon_name ()">xapp_status_icon_set_icon_name</a>, function in <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
560 </dt>
561 <dd></dd>
562 <dt>
563 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-set-label" title="xapp_status_icon_set_label ()">xapp_status_icon_set_label</a>, function in <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
564 </dt>
565 <dd></dd>
566 <dt>
567 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-set-name" title="xapp_status_icon_set_name ()">xapp_status_icon_set_name</a>, function in <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
568 </dt>
569 <dd></dd>
570 <dt>
571 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-set-primary-menu" title="xapp_status_icon_set_primary_menu ()">xapp_status_icon_set_primary_menu</a>, function in <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
572 </dt>
573 <dd></dd>
574 <dt>
575 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-set-secondary-menu" title="xapp_status_icon_set_secondary_menu ()">xapp_status_icon_set_secondary_menu</a>, function in <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
576 </dt>
577 <dd></dd>
578 <dt>
579 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-set-tooltip-text" title="xapp_status_icon_set_tooltip_text ()">xapp_status_icon_set_tooltip_text</a>, function in <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
580 </dt>
581 <dd></dd>
582 <dt>
583 <a class="link" href="XAppStatusIcon.html#xapp-status-icon-set-visible" title="xapp_status_icon_set_visible ()">xapp_status_icon_set_visible</a>, function in <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
584 </dt>
585 <dd></dd>
586 <a name="idxT"></a><h3 class="title">T</h3>
587 <dt>
588 <a class="link" href="XAppGtkWindow.html#XAPP-TYPE-GTK-WINDOW:CAPS" title="XAPP_TYPE_GTK_WINDOW">XAPP_TYPE_GTK_WINDOW</a>, macro in <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
589 </dt>
590 <dd></dd>
591 <dt>
592 <a class="link" href="XAppIconChooserButton.html#XAPP-TYPE-ICON-CHOOSER-BUTTON:CAPS" title="XAPP_TYPE_ICON_CHOOSER_BUTTON">XAPP_TYPE_ICON_CHOOSER_BUTTON</a>, macro in <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton">XAppIconChooserButton</a>
593 </dt>
594 <dd></dd>
595 <dt>
596 <a class="link" href="XAppIconChooserDialog.html#XAPP-TYPE-ICON-CHOOSER-DIALOG:CAPS" title="XAPP_TYPE_ICON_CHOOSER_DIALOG">XAPP_TYPE_ICON_CHOOSER_DIALOG</a>, macro in <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
597 </dt>
598 <dd></dd>
599 <dt>
600 <a class="link" href="XAppPreferencesWindow.html#XAPP-TYPE-PREFERENCES-WINDOW:CAPS" title="XAPP_TYPE_PREFERENCES_WINDOW">XAPP_TYPE_PREFERENCES_WINDOW</a>, macro in <a class="link" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow">XAppPreferencesWindow</a>
601 </dt>
602 <dd></dd>
603 <dt>
604 <a class="link" href="XAppStackSidebar.html#XAPP-TYPE-STACK-SIDEBAR:CAPS" title="XAPP_TYPE_STACK_SIDEBAR">XAPP_TYPE_STACK_SIDEBAR</a>, macro in <a class="link" href="XAppStackSidebar.html" title="XAppStackSidebar">XAppStackSidebar</a>
605 </dt>
606 <dd></dd>
607 <dt>
608 <a class="link" href="XAppStatusIcon.html#XAPP-TYPE-STATUS-ICON:CAPS" title="XAPP_TYPE_STATUS_ICON">XAPP_TYPE_STATUS_ICON</a>, macro in <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
609 </dt>
610 <dd></dd>
611 <dt>
612 <a class="link" href="XAppStatusIconMonitor.html#XAPP-TYPE-STATUS-ICON-MONITOR:CAPS" title="XAPP_TYPE_STATUS_ICON_MONITOR">XAPP_TYPE_STATUS_ICON_MONITOR</a>, macro in <a class="link" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor">XAppStatusIconMonitor</a>
613 </dt>
614 <dd></dd>
615 </div>
616 <div class="footer">
617 <hr>Generated by GTK-Doc V1.27</div>
618 </body>
619 </html>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>API reference: XApp Reference Manual</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
6 <link rel="home" href="index.html" title="XApp Reference Manual">
7 <link rel="up" href="index.html" title="XApp Reference Manual">
8 <link rel="prev" href="index.html" title="XApp Reference Manual">
9 <link rel="next" href="XAppGtkWindow.html" title="XAppGtkWindow">
10 <meta name="generator" content="GTK-Doc V1.27 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 </head>
13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
15 <td width="100%" align="left" class="shortcuts"></td>
16 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
17 <td><img src="up-insensitive.png" width="16" height="16" border="0"></td>
18 <td><a accesskey="p" href="index.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
19 <td><a accesskey="n" href="XAppGtkWindow.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
20 </tr></table>
21 <div class="chapter">
22 <div class="titlepage"><div><div><h1 class="title">
23 <a name="id-1.2"></a>API reference</h1></div></div></div>
24 <div class="toc"><dl class="toc">
25 <dt>
26 <span class="refentrytitle"><a href="XAppGtkWindow.html">XAppGtkWindow</a></span><span class="refpurpose"> — A subclass of <code class="literal">GtkWindow</code> that allows additional
27 communication with the window manager.</span>
28 </dt>
29 <dt>
30 <span class="refentrytitle"><a href="XAppIconChooserButton.html">XAppIconChooserButton</a></span><span class="refpurpose"> — A button for selecting an icon</span>
31 </dt>
32 <dt>
33 <span class="refentrytitle"><a href="XAppIconChooserDialog.html">XAppIconChooserDialog</a></span><span class="refpurpose"> — A dialog for selecting an icon</span>
34 </dt>
35 <dt>
36 <span class="refentrytitle"><a href="XAppKbdLayoutController.html">XAppKbdLayoutController</a></span><span class="refpurpose"> — Keyboard layout selection UI element provider.</span>
37 </dt>
38 <dt>
39 <span class="refentrytitle"><a href="XAppMonitorBlanker.html">XAppMonitorBlanker</a></span><span class="refpurpose"> — Blank and unblank unused monitors</span>
40 </dt>
41 <dt>
42 <span class="refentrytitle"><a href="XAppPreferencesWindow.html">XAppPreferencesWindow</a></span><span class="refpurpose"> — A base preferences window</span>
43 </dt>
44 <dt>
45 <span class="refentrytitle"><a href="XAppStackSidebar.html">XAppStackSidebar</a></span><span class="refpurpose"> — An automatic sidebar widget</span>
46 </dt>
47 <dt>
48 <span class="refentrytitle"><a href="XAppStatusIcon.html">XAppStatusIcon</a></span><span class="refpurpose"> — Broadcasts status information over DBUS</span>
49 </dt>
50 <dt>
51 <span class="refentrytitle"><a href="XAppStatusIconMonitor.html">XAppStatusIconMonitor</a></span><span class="refpurpose"> — Looks for XAppStatusIcons on DBUS and communicates
52 info to an applet to represent the icons.</span>
53 </dt>
54 <dt>
55 <span class="refentrytitle"><a href="XAppStatusIconInterfaceSkeleton.html">XAppStatusIconInterfaceSkeleton</a></span><span class="refpurpose"></span>
56 </dt>
57 </dl></div>
58 </div>
59 <div class="footer">
60 <hr>Generated by GTK-Doc V1.27</div>
61 </body>
62 </html>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>Index of deprecated API: XApp Reference Manual</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
6 <link rel="home" href="index.html" title="XApp Reference Manual">
7 <link rel="up" href="index.html" title="XApp Reference Manual">
8 <link rel="prev" href="api-index-full.html" title="API Index">
9 <link rel="next" href="annotation-glossary.html" title="Annotation Glossary">
10 <meta name="generator" content="GTK-Doc V1.27 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 </head>
13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
15 <td width="100%" align="left" class="shortcuts"></td>
16 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
17 <td><img src="up-insensitive.png" width="16" height="16" border="0"></td>
18 <td><a accesskey="p" href="api-index-full.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
19 <td><a accesskey="n" href="annotation-glossary.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
20 </tr></table>
21 <div class="index">
22 <div class="titlepage"><div><div><h1 class="title">
23 <a name="deprecated-api-index"></a>Index of deprecated API</h1></div></div></div>
24 <a name="idx"></a>
25 </div>
26 <div class="footer">
27 <hr>Generated by GTK-Doc V1.27</div>
28 </body>
29 </html>
Binary diff not shown
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>XApp Reference Manual: XApp Reference Manual</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
6 <link rel="home" href="index.html" title="XApp Reference Manual">
7 <link rel="next" href="ch01.html" title="API reference">
8 <meta name="generator" content="GTK-Doc V1.27 (XML mode)">
9 <link rel="stylesheet" href="style.css" type="text/css">
10 </head>
11 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
12 <div class="book">
13 <div class="titlepage">
14 <div>
15 <div><table class="navigation" id="top" width="100%" cellpadding="2" cellspacing="0"><tr><th valign="middle"><p class="title">XApp Reference Manual</p></th></tr></table></div>
16 <div><p class="releaseinfo">
17 xapp 1.5.0
18 </p></div>
19 </div>
20 <hr>
21 </div>
22 <div class="toc"><dl class="toc">
23 <dt><span class="chapter"><a href="ch01.html">API reference</a></span></dt>
24 <dd><dl>
25 <dt>
26 <span class="refentrytitle"><a href="XAppGtkWindow.html">XAppGtkWindow</a></span><span class="refpurpose"> — A subclass of <code class="literal">GtkWindow</code> that allows additional
27 communication with the window manager.</span>
28 </dt>
29 <dt>
30 <span class="refentrytitle"><a href="XAppIconChooserButton.html">XAppIconChooserButton</a></span><span class="refpurpose"> — A button for selecting an icon</span>
31 </dt>
32 <dt>
33 <span class="refentrytitle"><a href="XAppIconChooserDialog.html">XAppIconChooserDialog</a></span><span class="refpurpose"> — A dialog for selecting an icon</span>
34 </dt>
35 <dt>
36 <span class="refentrytitle"><a href="XAppKbdLayoutController.html">XAppKbdLayoutController</a></span><span class="refpurpose"> — Keyboard layout selection UI element provider.</span>
37 </dt>
38 <dt>
39 <span class="refentrytitle"><a href="XAppMonitorBlanker.html">XAppMonitorBlanker</a></span><span class="refpurpose"> — Blank and unblank unused monitors</span>
40 </dt>
41 <dt>
42 <span class="refentrytitle"><a href="XAppPreferencesWindow.html">XAppPreferencesWindow</a></span><span class="refpurpose"> — A base preferences window</span>
43 </dt>
44 <dt>
45 <span class="refentrytitle"><a href="XAppStackSidebar.html">XAppStackSidebar</a></span><span class="refpurpose"> — An automatic sidebar widget</span>
46 </dt>
47 <dt>
48 <span class="refentrytitle"><a href="XAppStatusIcon.html">XAppStatusIcon</a></span><span class="refpurpose"> — Broadcasts status information over DBUS</span>
49 </dt>
50 <dt>
51 <span class="refentrytitle"><a href="XAppStatusIconMonitor.html">XAppStatusIconMonitor</a></span><span class="refpurpose"> — Looks for XAppStatusIcons on DBUS and communicates
52 info to an applet to represent the icons.</span>
53 </dt>
54 <dt>
55 <span class="refentrytitle"><a href="XAppStatusIconInterfaceSkeleton.html">XAppStatusIconInterfaceSkeleton</a></span><span class="refpurpose"></span>
56 </dt>
57 </dl></dd>
58 <dt><span class="chapter"><a href="object-tree.html">Object Hierarchy</a></span></dt>
59 <dt><span class="index"><a href="api-index-full.html">API Index</a></span></dt>
60 <dt><span class="index"><a href="deprecated-api-index.html">Index of deprecated API</a></span></dt>
61 <dt><span class="glossary"><a href="annotation-glossary.html">Annotation Glossary</a></span></dt>
62 </dl></div>
63 </div>
64 <div class="footer">
65 <hr>Generated by GTK-Doc V1.27</div>
66 </body>
67 </html>
Binary diff not shown
0 <?xml version="1.0" encoding="utf-8" standalone="no"?>
1 <book xmlns="http://www.devhelp.net/book" title="XApp Reference Manual" link="index.html" author="" name="libxapp" version="2" language="c">
2 <chapters>
3 <sub name="API reference" link="ch01.html">
4 <sub name="XAppGtkWindow" link="XAppGtkWindow.html"/>
5 <sub name="XAppIconChooserButton" link="XAppIconChooserButton.html"/>
6 <sub name="XAppIconChooserDialog" link="XAppIconChooserDialog.html"/>
7 <sub name="XAppKbdLayoutController" link="XAppKbdLayoutController.html"/>
8 <sub name="XAppMonitorBlanker" link="XAppMonitorBlanker.html"/>
9 <sub name="XAppPreferencesWindow" link="XAppPreferencesWindow.html"/>
10 <sub name="XAppStackSidebar" link="XAppStackSidebar.html"/>
11 <sub name="XAppStatusIcon" link="XAppStatusIcon.html"/>
12 <sub name="XAppStatusIconMonitor" link="XAppStatusIconMonitor.html"/>
13 <sub name="XAppStatusIconInterfaceSkeleton" link="XAppStatusIconInterfaceSkeleton.html"/>
14 </sub>
15 <sub name="Object Hierarchy" link="object-tree.html"/>
16 <sub name="API Index" link="api-index-full.html"/>
17 <sub name="Index of deprecated API" link="deprecated-api-index.html"/>
18 <sub name="Annotation Glossary" link="annotation-glossary.html"/>
19 </chapters>
20 <functions>
21 <keyword type="function" name="xapp_gtk_window_new ()" link="XAppGtkWindow.html#xapp-gtk-window-new"/>
22 <keyword type="function" name="xapp_gtk_window_set_icon_name ()" link="XAppGtkWindow.html#xapp-gtk-window-set-icon-name"/>
23 <keyword type="function" name="xapp_gtk_window_set_icon_from_file ()" link="XAppGtkWindow.html#xapp-gtk-window-set-icon-from-file"/>
24 <keyword type="function" name="xapp_gtk_window_set_progress ()" link="XAppGtkWindow.html#xapp-gtk-window-set-progress"/>
25 <keyword type="function" name="xapp_gtk_window_set_progress_pulse ()" link="XAppGtkWindow.html#xapp-gtk-window-set-progress-pulse"/>
26 <keyword type="function" name="xapp_set_window_icon_name ()" link="XAppGtkWindow.html#xapp-set-window-icon-name"/>
27 <keyword type="function" name="xapp_set_window_icon_from_file ()" link="XAppGtkWindow.html#xapp-set-window-icon-from-file"/>
28 <keyword type="function" name="xapp_set_window_progress ()" link="XAppGtkWindow.html#xapp-set-window-progress"/>
29 <keyword type="function" name="xapp_set_window_progress_pulse ()" link="XAppGtkWindow.html#xapp-set-window-progress-pulse"/>
30 <keyword type="function" name="xapp_set_xid_icon_name ()" link="XAppGtkWindow.html#xapp-set-xid-icon-name"/>
31 <keyword type="function" name="xapp_set_xid_icon_from_file ()" link="XAppGtkWindow.html#xapp-set-xid-icon-from-file"/>
32 <keyword type="function" name="xapp_set_xid_progress ()" link="XAppGtkWindow.html#xapp-set-xid-progress"/>
33 <keyword type="function" name="xapp_set_xid_progress_pulse ()" link="XAppGtkWindow.html#xapp-set-xid-progress-pulse"/>
34 <keyword type="macro" name="XAPP_TYPE_GTK_WINDOW" link="XAppGtkWindow.html#XAPP-TYPE-GTK-WINDOW:CAPS"/>
35 <keyword type="struct" name="struct XAppGtkWindowClass" link="XAppGtkWindow.html#XAppGtkWindowClass"/>
36 <keyword type="struct" name="XAppGtkWindow" link="XAppGtkWindow.html#XAppGtkWindow-struct"/>
37 <keyword type="function" name="xapp_icon_chooser_button_new ()" link="XAppIconChooserButton.html#xapp-icon-chooser-button-new"/>
38 <keyword type="function" name="xapp_icon_chooser_button_new_with_size ()" link="XAppIconChooserButton.html#xapp-icon-chooser-button-new-with-size"/>
39 <keyword type="function" name="xapp_icon_chooser_button_set_icon_size ()" link="XAppIconChooserButton.html#xapp-icon-chooser-button-set-icon-size"/>
40 <keyword type="function" name="xapp_icon_chooser_button_set_icon ()" link="XAppIconChooserButton.html#xapp-icon-chooser-button-set-icon"/>
41 <keyword type="function" name="xapp_icon_chooser_button_set_default_category ()" link="XAppIconChooserButton.html#xapp-icon-chooser-button-set-default-category"/>
42 <keyword type="function" name="xapp_icon_chooser_button_get_icon ()" link="XAppIconChooserButton.html#xapp-icon-chooser-button-get-icon"/>
43 <keyword type="function" name="xapp_icon_chooser_button_get_dialog ()" link="XAppIconChooserButton.html#xapp-icon-chooser-button-get-dialog"/>
44 <keyword type="macro" name="XAPP_TYPE_ICON_CHOOSER_BUTTON" link="XAppIconChooserButton.html#XAPP-TYPE-ICON-CHOOSER-BUTTON:CAPS"/>
45 <keyword type="struct" name="XAppIconChooserButton" link="XAppIconChooserButton.html#XAppIconChooserButton-struct"/>
46 <keyword type="property" name="The “category” property" link="XAppIconChooserButton.html#XAppIconChooserButton--category"/>
47 <keyword type="property" name="The “icon” property" link="XAppIconChooserButton.html#XAppIconChooserButton--icon"/>
48 <keyword type="property" name="The “icon-size” property" link="XAppIconChooserButton.html#XAppIconChooserButton--icon-size"/>
49 <keyword type="function" name="xapp_icon_chooser_dialog_new ()" link="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-new"/>
50 <keyword type="function" name="xapp_icon_chooser_dialog_run ()" link="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-run"/>
51 <keyword type="function" name="xapp_icon_chooser_dialog_run_with_icon ()" link="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-run-with-icon"/>
52 <keyword type="function" name="xapp_icon_chooser_dialog_run_with_category ()" link="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-run-with-category"/>
53 <keyword type="function" name="xapp_icon_chooser_dialog_get_icon_string ()" link="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-get-icon-string"/>
54 <keyword type="function" name="xapp_icon_chooser_dialog_add_button ()" link="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-add-button"/>
55 <keyword type="function" name="xapp_icon_chooser_dialog_get_default_icon ()" link="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-get-default-icon"/>
56 <keyword type="function" name="xapp_icon_chooser_dialog_set_default_icon ()" link="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-set-default-icon"/>
57 <keyword type="function" name="xapp_icon_chooser_dialog_add_custom_category ()" link="XAppIconChooserDialog.html#xapp-icon-chooser-dialog-add-custom-category"/>
58 <keyword type="macro" name="XAPP_TYPE_ICON_CHOOSER_DIALOG" link="XAppIconChooserDialog.html#XAPP-TYPE-ICON-CHOOSER-DIALOG:CAPS"/>
59 <keyword type="enum" name="enum XAppIconSize" link="XAppIconChooserDialog.html#XAppIconSize"/>
60 <keyword type="struct" name="XAppIconChooserDialog" link="XAppIconChooserDialog.html#XAppIconChooserDialog-struct"/>
61 <keyword type="property" name="The “allow-paths” property" link="XAppIconChooserDialog.html#XAppIconChooserDialog--allow-paths"/>
62 <keyword type="property" name="The “default-icon” property" link="XAppIconChooserDialog.html#XAppIconChooserDialog--default-icon"/>
63 <keyword type="property" name="The “icon-size” property" link="XAppIconChooserDialog.html#XAppIconChooserDialog--icon-size"/>
64 <keyword type="signal" name="The “close” signal" link="XAppIconChooserDialog.html#XAppIconChooserDialog-close"/>
65 <keyword type="signal" name="The “select” signal" link="XAppIconChooserDialog.html#XAppIconChooserDialog-select"/>
66 <keyword type="function" name="xapp_kbd_layout_controller_new ()" link="XAppKbdLayoutController.html#xapp-kbd-layout-controller-new"/>
67 <keyword type="function" name="xapp_kbd_layout_controller_get_enabled ()" link="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-enabled"/>
68 <keyword type="function" name="xapp_kbd_layout_controller_get_current_group ()" link="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-group"/>
69 <keyword type="function" name="xapp_kbd_layout_controller_set_current_group ()" link="XAppKbdLayoutController.html#xapp-kbd-layout-controller-set-current-group"/>
70 <keyword type="function" name="xapp_kbd_layout_controller_next_group ()" link="XAppKbdLayoutController.html#xapp-kbd-layout-controller-next-group"/>
71 <keyword type="function" name="xapp_kbd_layout_controller_previous_group ()" link="XAppKbdLayoutController.html#xapp-kbd-layout-controller-previous-group"/>
72 <keyword type="function" name="xapp_kbd_layout_controller_get_current_name ()" link="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-name"/>
73 <keyword type="function" name="xapp_kbd_layout_controller_get_all_names ()" link="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-all-names"/>
74 <keyword type="function" name="xapp_kbd_layout_controller_get_current_icon_name ()" link="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-icon-name"/>
75 <keyword type="function" name="xapp_kbd_layout_controller_get_icon_name_for_group ()" link="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-icon-name-for-group"/>
76 <keyword type="function" name="xapp_kbd_layout_controller_get_current_flag_id ()" link="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-flag-id"/>
77 <keyword type="function" name="xapp_kbd_layout_controller_get_flag_id_for_group ()" link="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-flag-id-for-group"/>
78 <keyword type="function" name="xapp_kbd_layout_controller_get_current_short_group_label ()" link="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-short-group-label"/>
79 <keyword type="function" name="xapp_kbd_layout_controller_get_short_group_label_for_group ()" link="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-short-group-label-for-group"/>
80 <keyword type="function" name="xapp_kbd_layout_controller_get_current_variant_label ()" link="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-current-variant-label"/>
81 <keyword type="function" name="xapp_kbd_layout_controller_get_variant_label_for_group ()" link="XAppKbdLayoutController.html#xapp-kbd-layout-controller-get-variant-label-for-group"/>
82 <keyword type="function" name="xapp_kbd_layout_controller_render_cairo_subscript ()" link="XAppKbdLayoutController.html#xapp-kbd-layout-controller-render-cairo-subscript"/>
83 <keyword type="property" name="The “enabled” property" link="XAppKbdLayoutController.html#XAppKbdLayoutController--enabled"/>
84 <keyword type="signal" name="The “config-changed” signal" link="XAppKbdLayoutController.html#XAppKbdLayoutController-config-changed"/>
85 <keyword type="signal" name="The “layout-changed” signal" link="XAppKbdLayoutController.html#XAppKbdLayoutController-layout-changed"/>
86 <keyword type="function" name="xapp_monitor_blanker_new ()" link="XAppMonitorBlanker.html#xapp-monitor-blanker-new"/>
87 <keyword type="function" name="xapp_monitor_blanker_blank_other_monitors ()" link="XAppMonitorBlanker.html#xapp-monitor-blanker-blank-other-monitors"/>
88 <keyword type="function" name="xapp_monitor_blanker_unblank_monitors ()" link="XAppMonitorBlanker.html#xapp-monitor-blanker-unblank-monitors"/>
89 <keyword type="function" name="xapp_monitor_blanker_are_monitors_blanked ()" link="XAppMonitorBlanker.html#xapp-monitor-blanker-are-monitors-blanked"/>
90 <keyword type="function" name="xapp_preferences_window_new ()" link="XAppPreferencesWindow.html#xapp-preferences-window-new"/>
91 <keyword type="function" name="xapp_preferences_window_add_page ()" link="XAppPreferencesWindow.html#xapp-preferences-window-add-page"/>
92 <keyword type="function" name="xapp_preferences_window_add_button ()" link="XAppPreferencesWindow.html#xapp-preferences-window-add-button"/>
93 <keyword type="macro" name="XAPP_TYPE_PREFERENCES_WINDOW" link="XAppPreferencesWindow.html#XAPP-TYPE-PREFERENCES-WINDOW:CAPS"/>
94 <keyword type="struct" name="struct XAppPreferencesWindowClass" link="XAppPreferencesWindow.html#XAppPreferencesWindowClass"/>
95 <keyword type="struct" name="XAppPreferencesWindow" link="XAppPreferencesWindow.html#XAppPreferencesWindow-struct"/>
96 <keyword type="signal" name="The “close” signal" link="XAppPreferencesWindow.html#XAppPreferencesWindow-close"/>
97 <keyword type="function" name="xapp_stack_sidebar_new ()" link="XAppStackSidebar.html#xapp-stack-sidebar-new"/>
98 <keyword type="function" name="xapp_stack_sidebar_set_stack ()" link="XAppStackSidebar.html#xapp-stack-sidebar-set-stack"/>
99 <keyword type="function" name="xapp_stack_sidebar_get_stack ()" link="XAppStackSidebar.html#xapp-stack-sidebar-get-stack"/>
100 <keyword type="macro" name="XAPP_TYPE_STACK_SIDEBAR" link="XAppStackSidebar.html#XAPP-TYPE-STACK-SIDEBAR:CAPS"/>
101 <keyword type="struct" name="XAppStackSidebar" link="XAppStackSidebar.html#XAppStackSidebar-struct"/>
102 <keyword type="property" name="The “stack” property" link="XAppStackSidebar.html#XAppStackSidebar--stack"/>
103 <keyword type="function" name="xapp_status_icon_new ()" link="XAppStatusIcon.html#xapp-status-icon-new" since="1.6"/>
104 <keyword type="function" name="xapp_status_icon_set_name ()" link="XAppStatusIcon.html#xapp-status-icon-set-name" since="1.6"/>
105 <keyword type="function" name="xapp_status_icon_set_icon_name ()" link="XAppStatusIcon.html#xapp-status-icon-set-icon-name" since="1.6"/>
106 <keyword type="function" name="xapp_status_icon_set_tooltip_text ()" link="XAppStatusIcon.html#xapp-status-icon-set-tooltip-text" since="1.6"/>
107 <keyword type="function" name="xapp_status_icon_set_label ()" link="XAppStatusIcon.html#xapp-status-icon-set-label" since="1.6"/>
108 <keyword type="function" name="xapp_status_icon_set_visible ()" link="XAppStatusIcon.html#xapp-status-icon-set-visible" since="1.6"/>
109 <keyword type="function" name="xapp_status_icon_set_primary_menu ()" link="XAppStatusIcon.html#xapp-status-icon-set-primary-menu" since="1.6"/>
110 <keyword type="function" name="xapp_status_icon_get_primary_menu ()" link="XAppStatusIcon.html#xapp-status-icon-get-primary-menu" since="1.6"/>
111 <keyword type="function" name="xapp_status_icon_set_secondary_menu ()" link="XAppStatusIcon.html#xapp-status-icon-set-secondary-menu" since="1.6"/>
112 <keyword type="function" name="xapp_status_icon_get_secondary_menu ()" link="XAppStatusIcon.html#xapp-status-icon-get-secondary-menu" since="1.6"/>
113 <keyword type="macro" name="XAPP_TYPE_STATUS_ICON" link="XAppStatusIcon.html#XAPP-TYPE-STATUS-ICON:CAPS"/>
114 <keyword type="struct" name="XAppStatusIcon" link="XAppStatusIcon.html#XAppStatusIcon-struct"/>
115 <keyword type="property" name="The “primary-menu” property" link="XAppStatusIcon.html#XAppStatusIcon--primary-menu"/>
116 <keyword type="property" name="The “secondary-menu” property" link="XAppStatusIcon.html#XAppStatusIcon--secondary-menu"/>
117 <keyword type="signal" name="The “activate” signal" link="XAppStatusIcon.html#XAppStatusIcon-activate"/>
118 <keyword type="signal" name="The “button-press-event” signal" link="XAppStatusIcon.html#XAppStatusIcon-button-press-event"/>
119 <keyword type="signal" name="The “button-release-event” signal" link="XAppStatusIcon.html#XAppStatusIcon-button-release-event"/>
120 <keyword type="function" name="xapp_status_icon_monitor_new ()" link="XAppStatusIconMonitor.html#xapp-status-icon-monitor-new" since="1.6"/>
121 <keyword type="function" name="xapp_status_icon_monitor_list_icons ()" link="XAppStatusIconMonitor.html#xapp-status-icon-monitor-list-icons" since="1.6"/>
122 <keyword type="macro" name="XAPP_TYPE_STATUS_ICON_MONITOR" link="XAppStatusIconMonitor.html#XAPP-TYPE-STATUS-ICON-MONITOR:CAPS"/>
123 <keyword type="struct" name="XAppStatusIconMonitor" link="XAppStatusIconMonitor.html#XAppStatusIconMonitor-struct"/>
124 <keyword type="signal" name="The “icon-added” signal" link="XAppStatusIconMonitor.html#XAppStatusIconMonitor-icon-added"/>
125 <keyword type="signal" name="The “icon-removed” signal" link="XAppStatusIconMonitor.html#XAppStatusIconMonitor-icon-removed"/>
126 <keyword type="function" name="xapp_status_icon_interface_interface_info ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-interface-info"/>
127 <keyword type="function" name="xapp_status_icon_interface_override_properties ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-override-properties"/>
128 <keyword type="function" name="xapp_status_icon_interface_complete_button_press ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-complete-button-press"/>
129 <keyword type="function" name="xapp_status_icon_interface_complete_button_release ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-complete-button-release"/>
130 <keyword type="function" name="xapp_status_icon_interface_call_button_press ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-press"/>
131 <keyword type="function" name="xapp_status_icon_interface_call_button_press_finish ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-press-finish"/>
132 <keyword type="function" name="xapp_status_icon_interface_call_button_press_sync ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-press-sync"/>
133 <keyword type="function" name="xapp_status_icon_interface_call_button_release ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-release"/>
134 <keyword type="function" name="xapp_status_icon_interface_call_button_release_finish ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-release-finish"/>
135 <keyword type="function" name="xapp_status_icon_interface_call_button_release_sync ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-call-button-release-sync"/>
136 <keyword type="function" name="xapp_status_icon_interface_get_name ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-get-name"/>
137 <keyword type="function" name="xapp_status_icon_interface_dup_name ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-dup-name"/>
138 <keyword type="function" name="xapp_status_icon_interface_set_name ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-set-name"/>
139 <keyword type="function" name="xapp_status_icon_interface_get_icon_name ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-get-icon-name"/>
140 <keyword type="function" name="xapp_status_icon_interface_dup_icon_name ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-dup-icon-name"/>
141 <keyword type="function" name="xapp_status_icon_interface_set_icon_name ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-set-icon-name"/>
142 <keyword type="function" name="xapp_status_icon_interface_get_tooltip_text ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-get-tooltip-text"/>
143 <keyword type="function" name="xapp_status_icon_interface_dup_tooltip_text ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-dup-tooltip-text"/>
144 <keyword type="function" name="xapp_status_icon_interface_set_tooltip_text ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-set-tooltip-text"/>
145 <keyword type="function" name="xapp_status_icon_interface_get_label ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-get-label"/>
146 <keyword type="function" name="xapp_status_icon_interface_dup_label ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-dup-label"/>
147 <keyword type="function" name="xapp_status_icon_interface_set_label ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-set-label"/>
148 <keyword type="function" name="xapp_status_icon_interface_get_visible ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-get-visible"/>
149 <keyword type="function" name="xapp_status_icon_interface_set_visible ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-set-visible"/>
150 <keyword type="function" name="xapp_status_icon_interface_proxy_new ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new"/>
151 <keyword type="function" name="xapp_status_icon_interface_proxy_new_finish ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-finish"/>
152 <keyword type="function" name="xapp_status_icon_interface_proxy_new_sync ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-sync"/>
153 <keyword type="function" name="xapp_status_icon_interface_proxy_new_for_bus ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-for-bus"/>
154 <keyword type="function" name="xapp_status_icon_interface_proxy_new_for_bus_finish ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-for-bus-finish"/>
155 <keyword type="function" name="xapp_status_icon_interface_proxy_new_for_bus_sync ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-proxy-new-for-bus-sync"/>
156 <keyword type="function" name="xapp_status_icon_interface_skeleton_new ()" link="XAppStatusIconInterfaceSkeleton.html#xapp-status-icon-interface-skeleton-new"/>
157 <keyword type="property" name="The “icon-name” property" link="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface--icon-name"/>
158 <keyword type="property" name="The “label” property" link="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface--label"/>
159 <keyword type="property" name="The “name” property" link="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface--name"/>
160 <keyword type="property" name="The “tooltip-text” property" link="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface--tooltip-text"/>
161 <keyword type="property" name="The “visible” property" link="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface--visible"/>
162 <keyword type="signal" name="The “handle-button-press” signal" link="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface-handle-button-press"/>
163 <keyword type="signal" name="The “handle-button-release” signal" link="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface-handle-button-release"/>
164 <keyword type="constant" name="XAPP_ICON_SIZE_16" link="XAppIconChooserDialog.html#XAPP-ICON-SIZE-16:CAPS"/>
165 <keyword type="constant" name="XAPP_ICON_SIZE_22" link="XAppIconChooserDialog.html#XAPP-ICON-SIZE-22:CAPS"/>
166 <keyword type="constant" name="XAPP_ICON_SIZE_24" link="XAppIconChooserDialog.html#XAPP-ICON-SIZE-24:CAPS"/>
167 <keyword type="constant" name="XAPP_ICON_SIZE_32" link="XAppIconChooserDialog.html#XAPP-ICON-SIZE-32:CAPS"/>
168 <keyword type="constant" name="XAPP_ICON_SIZE_48" link="XAppIconChooserDialog.html#XAPP-ICON-SIZE-48:CAPS"/>
169 <keyword type="constant" name="XAPP_ICON_SIZE_96" link="XAppIconChooserDialog.html#XAPP-ICON-SIZE-96:CAPS"/>
170 </functions>
171 </book>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>Object Hierarchy: XApp Reference Manual</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
6 <link rel="home" href="index.html" title="XApp Reference Manual">
7 <link rel="up" href="index.html" title="XApp Reference Manual">
8 <link rel="prev" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">
9 <link rel="next" href="api-index-full.html" title="API Index">
10 <meta name="generator" content="GTK-Doc V1.27 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 </head>
13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
15 <td width="100%" align="left" class="shortcuts"></td>
16 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
17 <td><img src="up-insensitive.png" width="16" height="16" border="0"></td>
18 <td><a accesskey="p" href="XAppStatusIconInterfaceSkeleton.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
19 <td><a accesskey="n" href="api-index-full.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
20 </tr></table>
21 <div class="chapter">
22 <div class="titlepage"><div><div><h1 class="title">
23 <a name="object-tree"></a>Object Hierarchy</h1></div></div></div>
24 <pre class="screen">
25 <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
26 <span class="lineart">├──</span> <a href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
27 <span class="lineart">│</span> <span class="lineart">╰──</span> <a href="../gtk3/GtkWidget.html#GtkWidget-struct">GtkWidget</a>
28 <span class="lineart">│</span> <span class="lineart">╰──</span> <a href="../gtk3/GtkContainer.html#GtkContainer-struct">GtkContainer</a>
29 <span class="lineart">│</span> <span class="lineart">╰──</span> <a href="../gtk3/GtkBin.html#GtkBin-struct">GtkBin</a>
30 <span class="lineart">│</span> <span class="lineart">├──</span> <a href="../gtk3/GtkWindow.html#GtkWindow-struct">GtkWindow</a>
31 <span class="lineart">│</span> <span class="lineart">│</span> <span class="lineart">├──</span> <a class="link" href="XAppGtkWindow.html" title="XAppGtkWindow">XAppGtkWindow</a>
32 <span class="lineart">│</span> <span class="lineart">│</span> <span class="lineart">│</span> <span class="lineart">╰──</span> <a class="link" href="XAppIconChooserDialog.html" title="XAppIconChooserDialog">XAppIconChooserDialog</a>
33 <span class="lineart">│</span> <span class="lineart">│</span> <span class="lineart">╰──</span> <a class="link" href="XAppPreferencesWindow.html" title="XAppPreferencesWindow">XAppPreferencesWindow</a>
34 <span class="lineart">│</span> <span class="lineart">├──</span> <a href="../gtk3/GtkButton.html#GtkButton-struct">GtkButton</a>
35 <span class="lineart">│</span> <span class="lineart">│</span> <span class="lineart">╰──</span> <a class="link" href="XAppIconChooserButton.html" title="XAppIconChooserButton">XAppIconChooserButton</a>
36 <span class="lineart">│</span> <span class="lineart">╰──</span> <a class="link" href="XAppStackSidebar.html" title="XAppStackSidebar">XAppStackSidebar</a>
37 <span class="lineart">├──</span> <a class="link" href="XAppKbdLayoutController.html" title="XAppKbdLayoutController">XAppKbdLayoutController</a>
38 <span class="lineart">├──</span> <a class="link" href="XAppMonitorBlanker.html" title="XAppMonitorBlanker">XAppMonitorBlanker</a>
39 <span class="lineart">├──</span> <a class="link" href="XAppStatusIcon.html" title="XAppStatusIcon">XAppStatusIcon</a>
40 <span class="lineart">├──</span> <a href="../gio/GDBusProxy.html#GDBusProxy-struct">GDBusProxy</a>
41 <span class="lineart">│</span> <span class="lineart">╰──</span> <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterfaceProxy">XAppStatusIconInterfaceProxy</a>
42 <span class="lineart">├──</span> <a href="../gio/GDBusInterfaceSkeleton.html#GDBusInterfaceSkeleton-struct">GDBusInterfaceSkeleton</a>
43 <span class="lineart">│</span> <span class="lineart">╰──</span> <a class="link" href="XAppStatusIconInterfaceSkeleton.html" title="XAppStatusIconInterfaceSkeleton">XAppStatusIconInterfaceSkeleton</a>
44 <span class="lineart">╰──</span> <a class="link" href="XAppStatusIconMonitor.html" title="XAppStatusIconMonitor">XAppStatusIconMonitor</a>
45 <a href="/usr/share/gtk-doc/html/gobject/GTypeModule.html">GInterface</a>
46 <span class="lineart">╰──</span> <a class="link" href="XAppStatusIconInterfaceSkeleton.html#XAppStatusIconInterface">XAppStatusIconInterface</a>
47 <a href="/usr/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html">GEnum</a>
48 <span class="lineart">╰──</span> <a class="link" href="XAppIconChooserDialog.html#XAppIconSize" title="enum XAppIconSize">XAppIconSize</a>
49 </pre>
50 </div>
51 <div class="footer">
52 <hr>Generated by GTK-Doc V1.27</div>
53 </body>
54 </html>
Binary diff not shown
0 body
1 {
2 font-family: cantarell, sans-serif;
3 }
4 .synopsis, .classsynopsis
5 {
6 /* tango:aluminium 1/2 */
7 background: #eeeeec;
8 background: rgba(238, 238, 236, 0.5);
9 border: solid 1px rgb(238, 238, 236);
10 padding: 0.5em;
11 }
12 .programlisting
13 {
14 /* tango:sky blue 0/1 */
15 /* fallback for no rgba support */
16 background: #e6f3ff;
17 border: solid 1px #729fcf;
18 background: rgba(114, 159, 207, 0.1);
19 border: solid 1px rgba(114, 159, 207, 0.2);
20 padding: 0.5em;
21 }
22 .variablelist
23 {
24 padding: 4px;
25 margin-left: 3em;
26 }
27 .variablelist td:first-child
28 {
29 vertical-align: top;
30 }
31
32 div.gallery-float
33 {
34 float: left;
35 padding: 10px;
36 }
37 div.gallery-float img
38 {
39 border-style: none;
40 }
41 div.gallery-spacer
42 {
43 clear: both;
44 }
45
46 a, a:visited
47 {
48 text-decoration: none;
49 /* tango:sky blue 2 */
50 color: #3465a4;
51 }
52 a:hover
53 {
54 text-decoration: underline;
55 /* tango:sky blue 1 */
56 color: #729fcf;
57 }
58
59 div.informaltable table
60 {
61 border-collapse: separate;
62 border-spacing: 1em 0.3em;
63 border: none;
64 }
65
66 div.informaltable table td, div.informaltable table th
67 {
68 vertical-align: top;
69 }
70
71 .function_type,
72 .variable_type,
73 .property_type,
74 .signal_type,
75 .parameter_name,
76 .struct_member_name,
77 .union_member_name,
78 .define_keyword,
79 .datatype_keyword,
80 .typedef_keyword
81 {
82 text-align: right;
83 }
84
85 /* dim non-primary columns */
86 .c_punctuation,
87 .function_type,
88 .variable_type,
89 .property_type,
90 .signal_type,
91 .define_keyword,
92 .datatype_keyword,
93 .typedef_keyword,
94 .property_flags,
95 .signal_flags,
96 .parameter_annotations,
97 .enum_member_annotations,
98 .struct_member_annotations,
99 .union_member_annotations
100 {
101 color: #888a85;
102 }
103
104 .function_type a,
105 .function_type a:visited,
106 .function_type a:hover,
107 .property_type a,
108 .property_type a:visited,
109 .property_type a:hover,
110 .signal_type a,
111 .signal_type a:visited,
112 .signal_type a:hover,
113 .signal_flags a,
114 .signal_flags a:visited,
115 .signal_flags a:hover
116 {
117 color: #729fcf;
118 }
119
120 td p
121 {
122 margin: 0.25em;
123 }
124
125 div.table table
126 {
127 border-collapse: collapse;
128 border-spacing: 0px;
129 /* tango:aluminium 3 */
130 border: solid 1px #babdb6;
131 }
132
133 div.table table td, div.table table th
134 {
135 /* tango:aluminium 3 */
136 border: solid 1px #babdb6;
137 padding: 3px;
138 vertical-align: top;
139 }
140
141 div.table table th
142 {
143 /* tango:aluminium 2 */
144 background-color: #d3d7cf;
145 }
146
147 h4
148 {
149 color: #555753;
150 margin-top: 1em;
151 margin-bottom: 1em;
152 }
153
154 hr
155 {
156 /* tango:aluminium 1 */
157 color: #d3d7cf;
158 background: #d3d7cf;
159 border: none 0px;
160 height: 1px;
161 clear: both;
162 margin: 2.0em 0em 2.0em 0em;
163 }
164
165 dl.toc dt
166 {
167 padding-bottom: 0.25em;
168 }
169
170 dl.toc > dt
171 {
172 padding-top: 0.25em;
173 padding-bottom: 0.25em;
174 font-weight: bold;
175 }
176
177 dl.toc > dl
178 {
179 padding-bottom: 0.5em;
180 }
181
182 .parameter
183 {
184 font-style: normal;
185 }
186
187 .footer
188 {
189 padding-top: 3.5em;
190 /* tango:aluminium 3 */
191 color: #babdb6;
192 text-align: center;
193 font-size: 80%;
194 }
195
196 .informalfigure,
197 .figure
198 {
199 margin: 1em;
200 }
201
202 .informalexample,
203 .example
204 {
205 margin-top: 1em;
206 margin-bottom: 1em;
207 }
208
209 .warning
210 {
211 /* tango:orange 0/1 */
212 background: #ffeed9;
213 background: rgba(252, 175, 62, 0.1);
214 border-color: #ffb04f;
215 border-color: rgba(252, 175, 62, 0.2);
216 }
217 .note
218 {
219 /* tango:chameleon 0/0.5 */
220 background: #d8ffb2;
221 background: rgba(138, 226, 52, 0.1);
222 border-color: #abf562;
223 border-color: rgba(138, 226, 52, 0.2);
224 }
225 div.blockquote
226 {
227 border-color: #eeeeec;
228 }
229 .note, .warning, div.blockquote
230 {
231 padding: 0.5em;
232 border-width: 1px;
233 border-style: solid;
234 margin: 2em;
235 }
236 .note p, .warning p
237 {
238 margin: 0;
239 }
240
241 div.warning h3.title,
242 div.note h3.title
243 {
244 display: none;
245 }
246
247 p + div.section
248 {
249 margin-top: 1em;
250 }
251
252 div.refnamediv,
253 div.refsynopsisdiv,
254 div.refsect1,
255 div.refsect2,
256 div.toc,
257 div.section
258 {
259 margin-bottom: 1em;
260 }
261
262 /* blob links */
263 h2 .extralinks, h3 .extralinks
264 {
265 float: right;
266 /* tango:aluminium 3 */
267 color: #babdb6;
268 font-size: 80%;
269 font-weight: normal;
270 }
271
272 .lineart
273 {
274 color: #d3d7cf;
275 font-weight: normal;
276 }
277
278 .annotation
279 {
280 /* tango:aluminium 5 */
281 color: #555753;
282 font-weight: normal;
283 }
284
285 .structfield
286 {
287 font-style: normal;
288 font-weight: normal;
289 }
290
291 acronym,abbr
292 {
293 border-bottom: 1px dotted gray;
294 }
295
296 /* code listings */
297
298 .listing_code .programlisting .normal,
299 .listing_code .programlisting .normal a,
300 .listing_code .programlisting .number,
301 .listing_code .programlisting .cbracket,
302 .listing_code .programlisting .symbol { color: #555753; }
303 .listing_code .programlisting .comment,
304 .listing_code .programlisting .linenum { color: #babdb6; } /* tango: aluminium 3 */
305 .listing_code .programlisting .function,
306 .listing_code .programlisting .function a,
307 .listing_code .programlisting .preproc { color: #204a87; } /* tango: sky blue 3 */
308 .listing_code .programlisting .string { color: #ad7fa8; } /* tango: plum */
309 .listing_code .programlisting .keyword,
310 .listing_code .programlisting .usertype,
311 .listing_code .programlisting .type,
312 .listing_code .programlisting .type a { color: #4e9a06; } /* tango: chameleon 3 */
313
314 .listing_frame {
315 /* tango:sky blue 1 */
316 border: solid 1px #729fcf;
317 border: solid 1px rgba(114, 159, 207, 0.2);
318 padding: 0px;
319 }
320
321 .listing_lines, .listing_code {
322 margin-top: 0px;
323 margin-bottom: 0px;
324 padding: 0.5em;
325 }
326 .listing_lines {
327 /* tango:sky blue 0.5 */
328 background: #a6c5e3;
329 background: rgba(114, 159, 207, 0.2);
330 /* tango:aluminium 6 */
331 color: #2e3436;
332 }
333 .listing_code {
334 /* tango:sky blue 0 */
335 background: #e6f3ff;
336 background: rgba(114, 159, 207, 0.1);
337 }
338 .listing_code .programlisting {
339 /* override from previous */
340 border: none 0px;
341 padding: 0px;
342 background: none;
343 }
344 .listing_lines pre, .listing_code pre {
345 margin: 0px;
346 }
347
348 @media screen {
349 /* these have a <sup> as a first child, but since there are no parent selectors
350 * we can't use that. */
351 a.footnote
352 {
353 position: relative;
354 top: 0em ! important;
355 }
356 /* this is needed so that the local anchors are displayed below the naviagtion */
357 div.footnote a[name], div.refnamediv a[name], div.refsect1 a[name], div.refsect2 a[name], div.index a[name], div.glossary a[name], div.sect1 a[name]
358 {
359 display: inline-block;
360 position: relative;
361 top:-5em;
362 }
363 /* this seems to be a bug in the xsl style sheets when generating indexes */
364 div.index div.index
365 {
366 top: 0em;
367 }
368 /* make space for the fixed navigation bar and add space at the bottom so that
369 * link targets appear somewhat close to top
370 */
371 body
372 {
373 padding-top: 2.5em;
374 padding-bottom: 500px;
375 max-width: 60em;
376 }
377 p
378 {
379 max-width: 60em;
380 }
381 /* style and size the navigation bar */
382 table.navigation#top
383 {
384 position: fixed;
385 background: #e2e2e2;
386 border-bottom: solid 1px #babdb6;
387 border-spacing: 5px;
388 margin-top: 0;
389 margin-bottom: 0;
390 top: 0;
391 left: 0;
392 z-index: 10;
393 }
394 table.navigation#top td
395 {
396 padding-left: 6px;
397 padding-right: 6px;
398 }
399 .navigation a, .navigation a:visited
400 {
401 /* tango:sky blue 3 */
402 color: #204a87;
403 }
404 .navigation a:hover
405 {
406 /* tango:sky blue 2 */
407 color: #3465a4;
408 }
409 td.shortcuts
410 {
411 /* tango:sky blue 2 */
412 color: #3465a4;
413 font-size: 80%;
414 white-space: nowrap;
415 }
416 td.shortcuts .dim
417 {
418 color: #babdb6;
419 }
420 .navigation .title
421 {
422 font-size: 80%;
423 max-width: none;
424 margin: 0px;
425 font-weight: normal;
426 }
427 }
428 @media screen and (min-width: 60em) {
429 /* screen larger than 60em */
430 body { margin: auto; }
431 }
432 @media screen and (max-width: 60em) {
433 /* screen less than 60em */
434 #nav_hierarchy { display: none; }
435 #nav_interfaces { display: none; }
436 #nav_prerequisites { display: none; }
437 #nav_derived_interfaces { display: none; }
438 #nav_implementations { display: none; }
439 #nav_child_properties { display: none; }
440 #nav_style_properties { display: none; }
441 #nav_index { display: none; }
442 #nav_glossary { display: none; }
443 .gallery_image { display: none; }
444 .property_flags { display: none; }
445 .signal_flags { display: none; }
446 .parameter_annotations { display: none; }
447 .enum_member_annotations { display: none; }
448 .struct_member_annotations { display: none; }
449 .union_member_annotations { display: none; }
450 /* now that a column is hidden, optimize space */
451 col.parameters_name { width: auto; }
452 col.parameters_description { width: auto; }
453 col.struct_members_name { width: auto; }
454 col.struct_members_description { width: auto; }
455 col.enum_members_name { width: auto; }
456 col.enum_members_description { width: auto; }
457 col.union_members_name { width: auto; }
458 col.union_members_description { width: auto; }
459 .listing_lines { display: none; }
460 }
461 @media print {
462 table.navigation {
463 visibility: collapse;
464 display: none;
465 }
466 div.titlepage table.navigation {
467 visibility: visible;
468 display: table;
469 background: #e2e2e2;
470 border: solid 1px #babdb6;
471 margin-top: 0;
472 margin-bottom: 0;
473 top: 0;
474 left: 0;
475 height: 3em;
476 }
477 }
478
Binary diff not shown
2222 <xi:include href="xml/xapp-monitor-blanker.xml"/>
2323 <xi:include href="xml/xapp-preferences-window.xml"/>
2424 <xi:include href="xml/xapp-stack-sidebar.xml"/>
25 <xi:include href="xml/xapp-status-icon.xml"/>
26 <xi:include href="xml/xapp-status-icon-monitor.xml"/>
27 <xi:include href="xml/xapp-statusicon-interface.xml"/>
2528
2629 </chapter>
2730 <chapter id="object-tree">
00 GtkWindow cheader_filename="libxapp/xapp-gtk-window.h"
11 MonitorBlanker cheader_filename="libxapp/xapp-monitor-blanker.h"
22 KbdLayoutController cheader_filename="libxapp/xapp-kbd-layout-controller.h"
3 StatusIcon cheader_filename="libxapp/xapp-status-icon.h"
34 XApp cheader_filename="libxapp/xapp-gtk-window.h"
0 #!/usr/bin/env python3
1
2 '''
3 FIXME
4
5 This script is used only to call gdbus-codegen and simulate the
6 generation of the source code and header as different targets.
7
8 Both are generated implicitly, so meson is not able to know how
9 many files are generated, so it does generate only one opaque
10 target that represents the two files.
11
12 originally from:
13 https://gitlab.gnome.org/GNOME/gnome-settings-daemon/commit/5924d72931a030b24554116a48140a661a99652b
14
15 Please see:
16 https://bugzilla.gnome.org/show_bug.cgi?id=791015
17 https://github.com/mesonbuild/meson/pull/2930
18 '''
19
20 import subprocess
21 import sys
22 import os
23
24 subprocess.call([
25 'gdbus-codegen',
26 '--interface-prefix=' + sys.argv[1],
27 '--generate-c-code=' + os.path.join(sys.argv[4], sys.argv[2]),
28 '--c-namespace=XApp',
29 '--annotate', sys.argv[1], 'org.gtk.GDBus.C.Name', sys.argv[3],
30 sys.argv[5]
31 ])
0 #!/usr/bin/python3
1
2 import os
3 import sys
4 import subprocess
5
6 install_dir = os.path.join(os.environ['MESON_INSTALL_DESTDIR_PREFIX'], 'include', 'xapp', 'libxapp')
7 header_path = os.path.join(os.environ['MESON_BUILD_ROOT'], 'libxapp', sys.argv[1])
8
9 print("\nInstalling generated header '%s' to %s\n" % (sys.argv[1], install_dir))
10
11 subprocess.call(['cp', header_path, install_dir])
1616 'xapp-monitor-blanker.h',
1717 'xapp-preferences-window.h',
1818 'xapp-stack-sidebar.h',
19 'xapp-status-icon.h',
20 'xapp-status-icon-monitor.h'
1921 ]
2022
2123 xapp_sources = [
2729 'xapp-monitor-blanker.c',
2830 'xapp-preferences-window.c',
2931 'xapp-stack-sidebar.c',
32 'xapp-status-icon.c',
33 'xapp-status-icon-monitor.c'
3034 ]
35
36 codegen = find_program('g-codegen.py')
37
38 dbus_headers = []
39
40 # FIXME: Ugly workaround that simulates the generation of
41 # two different targets, so headers can be included
42 # explicitly for introspection.
43 #
44 # This can be removed once all platforms use meson >=.46
45 # and replaced with gnome.gdbus_codegen
46 generated_sources = custom_target(
47 'xapp-statusicon-interface',
48 input: 'org.x.StatusIcon.xml',
49 output: ['xapp-statusicon-interface.h', 'xapp-statusicon-interface.c'],
50 command: [
51 codegen,
52 'org.x.StatusIcon',
53 'xapp-statusicon-interface',
54 'StatusIconInterface',
55 meson.current_build_dir(),
56 '@INPUT@', '@OUTPUT@'
57 ]
58 )
59
60 # You can't actually access the generated header udring the install_header command below,
61 # because the command is evaluated prior to the files being generated. So we need to manually
62 # install the dbus header file (custom install scripts really *do* get evaluated after build,
63 # during the install phase.)
64 meson.add_install_script('install_generated_header.py', 'xapp-statusicon-interface.h')
65
66 dbus_headers += generated_sources[0]
67 xapp_sources += generated_sources[1]
3168
3269 xapp_enums = gnome.mkenums('xapp-enums',
3370 sources : xapp_headers,
3875 )
3976
4077 libxapp = library('xapp',
41 sources : xapp_headers + xapp_sources + xapp_enums,
78 sources : xapp_headers + xapp_sources + xapp_enums + dbus_headers,
4279 include_directories: [top_inc],
4380 version: meson.project_version(),
4481 soversion: '1',
4582 dependencies: libdeps,
46 c_args: ['-Wno-declaration-after-statement'],
83 c_args: ['-Wno-declaration-after-statement', '-DG_LOG_DOMAIN="XApp"'],
4784 link_args: [ '-Wl,-Bsymbolic', '-Wl,-z,relro', '-Wl,-z,now', '-lm'],
4885 install: true
4986 )
5693 link_with: libxapp,
5794 include_directories: top_inc,
5895 dependencies: libdeps,
59 sources: [ xapp_headers ]
96 sources: [ xapp_headers, dbus_headers ]
6097 )
6198
6299 gir = gnome.generate_gir(libxapp,
63100 namespace: 'XApp',
64101 nsversion: '1.0',
65 sources: xapp_headers + xapp_sources,
102 sources: xapp_headers + xapp_sources + dbus_headers,
66103 identifier_prefix: 'XApp',
67104 symbol_prefix: 'xapp_',
68105 includes: ['GObject-2.0', 'Gtk-3.0'],
0 <!DOCTYPE node PUBLIC "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN"
1 "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
2 <!-- GDBus 2.48.1 -->
3 <node>
4 <interface name='org.x.StatusIcon'>
5 <method name='ButtonPress'>
6 <arg name='x' direction='in' type='i'/>
7 <arg name='y' direction='in' type='i'/>
8 <arg name='button' direction='in' type='u'/>
9 <arg name='time' direction='in' type='u'/>
10 <arg name='panel_position' direction='in' type='i'/>
11 </method>
12 <method name='ButtonRelease'>
13 <arg name='x' direction='in' type='i'/>
14 <arg name='y' direction='in' type='i'/>
15 <arg name='button' direction='in' type='u'/>
16 <arg name='time' direction='in' type='u'/>
17 <arg name='panel_position' direction='in' type='i'/>
18 </method>
19 <property type='s' name='Name' access='read'/>
20 <property type='s' name='IconName' access='read'/>
21 <property type='s' name='TooltipText' access='read'/>
22 <property type='s' name='Label' access='read'/>
23 <property type='b' name='Visible' access='read'/>
24 </interface>
25 </node>
22 #include "config.h"
33 #include "xapp-enums.h"
44 #include "xapp-icon-chooser-dialog.h"
5 #include "xapp-status-icon.h"
56
67 #define C_ENUM(v) ((gint) v)
78 #define C_FLAGS(v) ((guint) v)
2020 XAppIconChooserDialog *dialog;
2121 GtkIconSize icon_size;
2222 gchar *icon_string;
23 gchar *category_string;
2324 } XAppIconChooserButtonPrivate;
2425
2526 struct _XAppIconChooserButton
3233 PROP_0,
3334 PROP_ICON_SIZE,
3435 PROP_ICON,
36 PROP_CATEGORY,
3537 N_PROPERTIES
3638 };
3739
6971 gtk_window_set_transient_for (GTK_WINDOW (priv->dialog), GTK_WINDOW (toplevel));
7072 gtk_window_set_modal (GTK_WINDOW (priv->dialog), gtk_window_get_modal (GTK_WINDOW (toplevel)));
7173
72 if (priv->icon_string == NULL)
74 if (priv->category_string)
75 {
76 response = xapp_icon_chooser_dialog_run_with_category (priv->dialog, priv->category_string);
77 }
78 else if (priv->icon_string)
79 {
80 response = xapp_icon_chooser_dialog_run_with_icon (priv->dialog, priv->icon_string);
81 }
82 else
7383 {
7484 response = xapp_icon_chooser_dialog_run (priv->dialog);
75 }
76 else
77 {
78 response = xapp_icon_chooser_dialog_run_with_icon (priv->dialog, priv->icon_string);
7985 }
8086
8187 if (response == GTK_RESPONSE_OK)
107113 case PROP_ICON:
108114 g_value_set_string (value, priv->icon_string);
109115 break;
116 case PROP_CATEGORY:
117 g_value_set_string (value, priv->category_string);
118 break;
110119 default:
111120 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
112121 break;
120129 GParamSpec *pspec)
121130 {
122131 XAppIconChooserButton *button;
123 XAppIconChooserButtonPrivate *priv;
124132
125133 button = XAPP_ICON_CHOOSER_BUTTON (object);
126 priv = xapp_icon_chooser_button_get_instance_private (button);
127134
128135 switch (prop_id)
129136 {
133140 case PROP_ICON:
134141 xapp_icon_chooser_button_set_icon (button, g_value_get_string (value));
135142 break;
143 case PROP_CATEGORY:
144 xapp_icon_chooser_button_set_default_category (button, g_value_get_string (value));
145 break;
136146 default:
137147 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
138148 break;
139149 }
150 }
151
152 void
153 xapp_icon_chooser_button_dispose (GObject *object)
154 {
155 XAppIconChooserButtonPrivate *priv;
156
157 priv = xapp_icon_chooser_button_get_instance_private (XAPP_ICON_CHOOSER_BUTTON (object));
158
159 g_clear_pointer (&priv->icon_string, g_free);
160 g_clear_pointer (&priv->category_string, g_free);
161
162 g_clear_object (&priv->dialog);
163
164 G_OBJECT_CLASS (xapp_icon_chooser_button_parent_class)->dispose (object);
140165 }
141166
142167 static void
162187 static void
163188 xapp_icon_chooser_button_class_init (XAppIconChooserButtonClass *klass)
164189 {
165 GtkBindingSet *binding_set;
166190 GObjectClass *object_class = G_OBJECT_CLASS (klass);
167191 GtkButtonClass *button_class = GTK_BUTTON_CLASS (klass);
168192
169193 object_class->get_property = xapp_icon_chooser_button_get_property;
170194 object_class->set_property = xapp_icon_chooser_button_set_property;
195 object_class->dispose = xapp_icon_chooser_button_dispose;
171196
172197 button_class->clicked = on_clicked;
173198
198223 "",
199224 G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY);
200225
226 /**
227 * XAppIconChooserButton:category:
228 *
229 * The category selected by default.
230 */
231 obj_properties[PROP_CATEGORY] =
232 g_param_spec_string ("category",
233 _("Category"),
234 _("The default category."),
235 "",
236 G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY);
237
201238 g_object_class_install_properties (object_class, N_PROPERTIES, obj_properties);
202239 }
203240
346383 }
347384
348385 /**
386 * xapp_icon_chooser_button_set_default_category:
387 * @button: a #XAppIconChooserButton
388 * @category: (nullable): a string representing the category selected by default.
389 *
390 * Sets the icon on the #XAppIconChooserButton.
391 */
392 void
393 xapp_icon_chooser_button_set_default_category (XAppIconChooserButton *button,
394 const gchar *category)
395 {
396 XAppIconChooserButtonPrivate *priv;
397
398 priv = xapp_icon_chooser_button_get_instance_private (button);
399
400 if (priv->category_string != NULL)
401 {
402 g_free (priv->category_string);
403 }
404
405 priv->category_string = g_strdup (category);
406 }
407
408 /**
349409 * xapp_icon_chooser_button_get_dialog:
350410 * @button: a #XAppIconChooserButton
351411 *
2121 void xapp_icon_chooser_button_set_icon (XAppIconChooserButton *button,
2222 const gchar *icon);
2323
24 void xapp_icon_chooser_button_set_default_category (XAppIconChooserButton *button,
25 const gchar *category);
26
2427 const gchar* xapp_icon_chooser_button_get_icon (XAppIconChooserButton *button);
2528 XAppIconChooserDialog * xapp_icon_chooser_button_get_dialog (XAppIconChooserButton *button);
2629
3232 {
3333 GtkResponseType response;
3434 XAppIconSize icon_size;
35 GtkListStore *category_list;
3635 GtkListStore *search_icon_store;
3736 GFileEnumerator *search_file_enumerator;
3837 GCancellable *cancellable;
4342 GtkWidget *search_bar;
4443 GtkWidget *icon_view;
4544 GtkWidget *list_box;
45 GtkWidget *default_button;
4646 GtkWidget *select_button;
4747 GtkWidget *browse_button;
4848 GtkWidget *action_area;
5151 gchar *current_text;
5252 gulong search_changed_id;
5353 gboolean allow_paths;
54 gchar *default_icon;
5455 IconCategoryInfo *current_category;
5556 } XAppIconChooserDialogPrivate;
5657
133134 PROP_0,
134135 PROP_ICON_SIZE,
135136 PROP_ALLOW_PATHS,
137 PROP_DEFAULT_ICON,
136138 N_PROPERTIES
137139 };
138140
172174 static void on_cancel_button_clicked (GtkButton *button,
173175 gpointer user_data);
174176
177 static gboolean on_default_button_clicked (GtkButton *button,
178 gpointer user_data);
179
175180 static gboolean on_search_bar_key_pressed (GtkWidget *widget,
176181 GdkEvent *event,
177182 gpointer user_data);
178183
179184 static gboolean on_delete_event (GtkWidget *widget,
180185 GdkEventAny *event);
181
182 static gboolean on_select_event (XAppIconChooserDialog *dialog,
183 GdkEventAny *event);
184186
185187 static void on_icon_view_item_activated (GtkIconView *iconview,
186188 GtkTreePath *path,
314316 break;
315317 case PROP_ALLOW_PATHS:
316318 g_value_set_boolean (value, priv->allow_paths);
319 break;
320 case PROP_DEFAULT_ICON:
321 g_value_set_string (value, xapp_icon_chooser_dialog_get_default_icon(dialog));
317322 break;
318323 default:
319324 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
351356 gtk_widget_set_no_show_all (priv->browse_button, TRUE);
352357 }
353358 break;
359 case PROP_DEFAULT_ICON:
360 xapp_icon_chooser_dialog_set_default_icon (dialog, g_value_get_string (value));
361 break;
354362 default:
355363 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
356364 break;
379387 }
380388
381389 g_clear_pointer (&priv->icon_string, g_free);
390 g_clear_pointer (&priv->default_icon, g_free);
382391 g_clear_pointer (&priv->current_text, g_free);
383392 g_clear_object (&priv->cancellable);
384393
399408 GtkToolItem *tool_item;
400409 GtkWidget *toolbar_box;
401410 GtkWidget *right_box;
402 GtkCellRenderer *renderer;
403 GtkTreeViewColumn *column;
404411 GtkStyleContext *style;
405412 GtkSizeGroup *button_size_group;
406413 GtkWidget *cancel_button;
407414 GtkWidget *button_area;
408 GtkWidget *selection;
409415 GtkWidget *scrolled_window;
410416
411417 priv = xapp_icon_chooser_dialog_get_instance_private (dialog);
549555 gtk_box_pack_start (GTK_BOX (main_box), button_area, FALSE, FALSE, 0);
550556
551557 button_size_group = gtk_size_group_new (GTK_SIZE_GROUP_HORIZONTAL);
558
559 priv->default_button = gtk_button_new_with_label (_("Default"));
560 gtk_widget_set_no_show_all (priv->default_button, TRUE);
561 style = gtk_widget_get_style_context (GTK_WIDGET (priv->default_button));
562 gtk_style_context_add_class (style, "text-button");
563 gtk_size_group_add_widget (button_size_group, priv->default_button);
564 gtk_action_bar_pack_start (GTK_ACTION_BAR (button_area), priv->default_button);
565
566 g_signal_connect (priv->default_button, "clicked",
567 G_CALLBACK (on_default_button_clicked), dialog);
552568
553569 priv->select_button = gtk_button_new_with_label (_("Select"));
554570 style = gtk_widget_get_style_context (GTK_WIDGET (priv->select_button));
610626 _("Whether to allow paths."),
611627 TRUE,
612628 G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY);
629
630 /**
631 * XAppIconChooserDialog:default-icon:
632 *
633 * The icon to use by default.
634 */
635 obj_properties[PROP_DEFAULT_ICON] =
636 g_param_spec_string ("default-icon",
637 _("Default Icon"),
638 _("The icon to use by default"),
639 NULL,
640 G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY);
613641
614642 g_object_class_install_properties (object_class, N_PROPERTIES, obj_properties);
615643
766794 }
767795
768796 /**
797 * xapp_icon_chooser_dialog_get_default_icon:
798 *
799 * Returns the default icon (if set).
800 *
801 * Returns: (transfer full): the default icon, or NULL if none is set
802 */
803 gchar *
804 xapp_icon_chooser_dialog_get_default_icon (XAppIconChooserDialog *dialog)
805 {
806 XAppIconChooserDialogPrivate *priv;
807
808 priv = xapp_icon_chooser_dialog_get_instance_private (dialog);
809
810 return g_strdup(priv->default_icon);
811 }
812
813 /**
814 * xapp_icon_chooser_dialog_set_default_icon:
815 * @icon: the default icon, or NULL to unset
816 *
817 * Sets the default icon. If @icon is not NULL, a button will be shown that
818 * will reset the dialog to it's default value.
819 */
820 void
821 xapp_icon_chooser_dialog_set_default_icon (XAppIconChooserDialog *dialog,
822 const gchar *icon)
823 {
824 XAppIconChooserDialogPrivate *priv;
825
826 priv = xapp_icon_chooser_dialog_get_instance_private (dialog);
827
828 priv->default_icon = g_strdup (icon);
829 if (icon == NULL)
830 {
831 gtk_widget_hide (priv->default_button);
832 }
833 else
834 {
835 gtk_widget_show (priv->default_button);
836 }
837 }
838
839 /**
840 * xapp_icon_chooser_dialog_add_custom_category:
841 * @dialog: a #XAppIconChooserDialog
842 * @name: the name of the category as it will be displayed in the category list
843 * @icons: (transfer full) (element-type utf8): a list of icon names to add to the new category
844 *
845 * Adds a custom category to the dialog.
846 */
847 void
848 xapp_icon_chooser_dialog_add_custom_category (XAppIconChooserDialog *dialog,
849 const gchar *name,
850 GList *icons)
851 {
852 XAppIconChooserDialogPrivate *priv;
853 IconCategoryInfo *category_info;
854 GtkWidget *row;
855 GtkWidget *label;
856
857 priv = xapp_icon_chooser_dialog_get_instance_private (dialog);
858
859 category_info = g_new0 (IconCategoryInfo, 1);
860 category_info->name = name;
861 category_info->icons = icons;
862
863 category_info->model = gtk_list_store_new (3, G_TYPE_STRING, G_TYPE_STRING, GDK_TYPE_PIXBUF);
864 g_signal_connect (category_info->model, "row-inserted",
865 G_CALLBACK (on_icon_store_icons_added), dialog);
866
867 category_info->icons = g_list_sort (category_info->icons, (GCompareFunc) g_utf8_collate);
868
869 row = gtk_list_box_row_new ();
870 label = gtk_label_new (category_info->name);
871 gtk_label_set_xalign (GTK_LABEL (label), 0.0);
872 gtk_widget_set_margin_start (GTK_WIDGET (label), 6);
873 gtk_widget_set_margin_end (GTK_WIDGET (label), 6);
874
875 gtk_container_add (GTK_CONTAINER (row), label);
876 gtk_container_add (GTK_CONTAINER (priv->list_box), row);
877
878 g_hash_table_insert (priv->categories, row, category_info);
879 }
880
881 /**
769882 * xapp_icon_chooser_dialog_get_icon_string:
770883 * @dialog: a #XAppIconChooserDialog
771884 *
828941 GtkResponseType response_id)
829942 {
830943 XAppIconChooserDialogPrivate *priv;
831 GtkWidget *action_area;
832944
833945 priv = xapp_icon_chooser_dialog_get_instance_private (dialog);
834946
10701182
10711183 callback_info = (FileIconInfoLoadCallbackInfo*) user_data;
10721184 priv = xapp_icon_chooser_dialog_get_instance_private (callback_info->dialog);
1073
1185
10741186 if (g_cancellable_is_cancelled (callback_info->cancellable))
10751187 {
10761188 free_file_info (callback_info);
10951207
10961208 callback_info = (NamedIconInfoLoadCallbackInfo*) user_data;
10971209 priv = xapp_icon_chooser_dialog_get_instance_private (callback_info->dialog);
1098
1210
10991211 if (g_cancellable_is_cancelled (callback_info->cancellable))
11001212 {
11011213 free_named_info (callback_info);
11271239
11281240 return G_SOURCE_REMOVE;
11291241 }
1130
1242
11311243 search_icon_name (callback_info->dialog,
11321244 priv->current_text,
11331245 priv->search_icon_store);
11461258 FileIconInfoLoadCallbackInfo *callback_info;
11471259 GdkPixbuf *pixbuf, *final_pixbuf;
11481260 GError *error = NULL;
1149 GtkTreeIter iter;
11501261
11511262 callback_info = (FileIconInfoLoadCallbackInfo *) user_data;
11521263 priv = xapp_icon_chooser_dialog_get_instance_private (callback_info->dialog);
12761387 callback_info = (NamedIconInfoLoadCallbackInfo*) user_data;
12771388 priv = xapp_icon_chooser_dialog_get_instance_private (callback_info->dialog);
12781389
1279 pixbuf = gtk_icon_info_load_icon_finish (GTK_ICON_INFO (info), res, &error);
1390 pixbuf = gtk_icon_info_load_symbolic_for_context_finish (GTK_ICON_INFO (info), res, NULL, &error);
12801391 g_object_unref (info);
12811392
12821393 if (g_cancellable_is_cancelled (callback_info->cancellable))
13471458 XAppIconChooserDialogPrivate *priv;
13481459 GtkIconTheme *theme;
13491460 gint chunk_count;
1461 gint scale;
13501462
13511463 priv = xapp_icon_chooser_dialog_get_instance_private (dialog);
13521464 theme = gtk_icon_theme_get_default ();
1465
1466 scale = gtk_widget_get_scale_factor (GTK_WIDGET (dialog));
13531467
13541468 for (chunk_count = 0; chunk_count < CATEGORY_CHUNK_SIZE; chunk_count++)
13551469 {
13851499 }
13861500 else
13871501 {
1388 GtkIconInfo *info;
1389
1390 info = gtk_icon_theme_lookup_icon (theme, name, icon_size, GTK_ICON_LOOKUP_FORCE_SIZE);
1391 gtk_icon_info_load_icon_async (info, NULL, (GAsyncReadyCallback) (finish_pixbuf_load_from_name), callback_info);
1502 GtkIconInfo *info;
1503 GtkStyleContext *context;
1504
1505 info = gtk_icon_theme_lookup_icon_for_scale (theme, name, icon_size, scale, GTK_ICON_LOOKUP_FORCE_SIZE);
1506 if (info == NULL)
1507 {
1508 // this shouldn't be the case most of the time, but if a custom category is defined it's possible
1509 // the icon doesn't exist. In that case it's best to just skip over it since trying to load it will
1510 // lead to a segfault.
1511 continue;
1512 }
1513
1514 context = gtk_widget_get_style_context (priv->icon_view);
1515 gtk_icon_info_load_symbolic_for_context_async (info, context, NULL, (GAsyncReadyCallback) (finish_pixbuf_load_from_name), callback_info);
13921516 }
13931517 }
13941518 else
14071531 GList *selection;
14081532 GtkWidget *selected;
14091533 IconCategoryInfo *category_info;
1410 GtkTreePath *new_path;
14111534
14121535 priv = xapp_icon_chooser_dialog_get_instance_private (dialog);
14131536
16031726 XAppIconChooserDialogPrivate *priv;
16041727 GtkIconTheme *theme;
16051728 GList *icons;
1606 GtkIconInfo *info;
1607 NamedIconInfoLoadCallbackInfo *callback_info;
16081729 gint chunk_count;
1730 gint scale;
16091731
16101732 priv = xapp_icon_chooser_dialog_get_instance_private (dialog);
16111733
16121734 theme = gtk_icon_theme_get_default ();
1735 scale = gtk_widget_get_scale_factor (GTK_WIDGET (dialog));
16131736
16141737 icons = priv->full_icon_list;
16151738
16531776 }
16541777 else
16551778 {
1656 GtkIconInfo *info;
1657
1658 info = gtk_icon_theme_lookup_icon (theme, name, priv->icon_size, GTK_ICON_LOOKUP_FORCE_SIZE);
1659 gtk_icon_info_load_icon_async (info, NULL, (GAsyncReadyCallback) (finish_pixbuf_load_from_name), callback_info);
1779 GtkIconInfo *info;
1780 GtkStyleContext *context;
1781
1782 info = gtk_icon_theme_lookup_icon_for_scale (theme, name, priv->icon_size, scale, GTK_ICON_LOOKUP_FORCE_SIZE);
1783 context = gtk_widget_get_style_context (priv->icon_view);
1784 gtk_icon_info_load_symbolic_for_context_async (info, context, NULL, (GAsyncReadyCallback) (finish_pixbuf_load_from_name), callback_info);
16601785 }
1661
1786
16621787 chunk_count++;
16631788 }
16641789 }
18631988 xapp_icon_chooser_dialog_close (XAPP_ICON_CHOOSER_DIALOG (widget), GTK_RESPONSE_CANCEL);
18641989
18651990 return TRUE;
1866 }
1867
1868 static gboolean
1869 on_select_event (XAppIconChooserDialog *dialog,
1870 GdkEventAny *event)
1871 {
1872 XAppIconChooserDialogPrivate *priv;
1873
1874 priv = xapp_icon_chooser_dialog_get_instance_private (dialog);
1875
1876 if (priv->icon_string != NULL)
1877 {
1878 xapp_icon_chooser_dialog_close (dialog, GTK_RESPONSE_OK);
1879 }
18801991 }
18811992
18821993 static void
19142025
19152026 return FALSE;
19162027 }
2028
2029 static gboolean
2030 on_default_button_clicked (GtkButton *button,
2031 gpointer user_data)
2032 {
2033 XAppIconChooserDialogPrivate *priv;
2034
2035 priv = xapp_icon_chooser_dialog_get_instance_private (user_data);
2036
2037 gtk_entry_set_text (GTK_ENTRY (priv->search_bar), priv->default_icon);
2038
2039 }
3737 GtkWidget *button,
3838 GtkPackType packing,
3939 GtkResponseType response_id);
40
41 gchar * xapp_icon_chooser_dialog_get_default_icon (XAppIconChooserDialog *dialog);
42 void xapp_icon_chooser_dialog_set_default_icon (XAppIconChooserDialog *dialog,
43 const gchar *icon);
44
45 void xapp_icon_chooser_dialog_add_custom_category (XAppIconChooserDialog *dialog,
46 const gchar *name,
47 GList *icons);
48
4049 G_END_DECLS
4150
4251 #endif /* _XAPP_ICON_CHOOSER_DIALOG_H_ */
5353 const GValue *value,
5454 GParamSpec *pspec)
5555 {
56 XAppStackSidebar *sidebar = XAPP_STACK_SIDEBAR (object);
57
5856 switch (prop_id)
5957 {
6058 case PROP_STACK:
0
1 #include <config.h>
2
3 #include <stdio.h>
4 #include <stdlib.h>
5 #include <string.h>
6
7 #include <sys/types.h>
8 #include <unistd.h>
9
10 #include <gdk/gdkx.h>
11 #include <gtk/gtk.h>
12
13 #include <glib/gi18n-lib.h>
14
15 #include "xapp-status-icon.h"
16 #include "xapp-status-icon-monitor.h"
17 #include "xapp-statusicon-interface.h"
18
19 #define MONITOR_PATH "/org/x/StatusIconMonitor"
20 #define MONITOR_NAME "org.x.StatusIconMonitor"
21
22 #define STATUS_ICON_MATCH "org.x.StatusIcon."
23
24 #define STATUS_ICON_ID_FORMAT "org.x.StatusIcon.PID-%d-%d"
25 #define STATUS_ICON_PATH_PREFIX "/org/x/StatusIcon/"
26
27 enum
28 {
29 ICON_ADDED,
30 ICON_REMOVED,
31 LAST_SIGNAL
32 };
33
34 static guint signals[LAST_SIGNAL] = {0, };
35
36 /**
37 * SECTION:xapp-status-icon-monitor
38 * @Short_description: Looks for XAppStatusIcons on DBUS and communicates
39 * info to an applet to represent the icons.
40 * @Title: XAppStatusIconMonitor
41 *
42 * The XAppStatusIconMonitor is intended to be utilized by some status applet
43 * to display info about an app.
44 *
45 * The simplest way to use is to make a new instance of this monitor, and connect
46 * to the #XAppStatusIconMonitor::icon-added and #XAppStatusIconMonitor::icon-removed signals.
47 * The received object for both of these signals is an #XAppStatusIconInterfaceProxy.
48 * It represents an application's #XAppStatusIcon, and has properties available for
49 * describing the icon name, tooltip, label and visibility.
50 *
51 * The proxy also provides methods to handle clicks, which can be called by the applet,
52 * to request that the app display its menu.
53 */
54 typedef struct
55 {
56 GDBusConnection *connection;
57
58 GHashTable *icons;
59 gchar *name;
60
61 guint owner_id;
62 guint listener_id;
63
64 } XAppStatusIconMonitorPrivate;
65
66 struct _XAppStatusIconMonitor
67 {
68 GObject parent_instance;
69 };
70
71 G_DEFINE_TYPE_WITH_PRIVATE (XAppStatusIconMonitor, xapp_status_icon_monitor, G_TYPE_OBJECT)
72
73 static void remove_icon (XAppStatusIconMonitor *self, const gchar *name);
74
75 static void
76 on_proxy_name_owner_changed (GObject *object,
77 GParamSpec *pspec,
78 gpointer user_data)
79 {
80 XAppStatusIconMonitor *self = XAPP_STATUS_ICON_MONITOR (user_data);
81
82 gchar *name_owner = NULL;
83 gchar *proxy_name = NULL;
84
85 g_object_get (object,
86 "g-name-owner", &name_owner,
87 "g-name", &proxy_name,
88 NULL);
89
90 g_debug("XAppStatusIconMonitor: proxy name owner changed - name owner '%s' is now '%s')", proxy_name, name_owner);
91
92 if (name_owner == NULL)
93 {
94 remove_icon (self, proxy_name);
95 }
96
97 g_free (name_owner);
98 g_free (proxy_name);
99 }
100
101 static void
102 remove_icon (XAppStatusIconMonitor *self,
103 const gchar *name)
104 {
105 XAppStatusIconMonitorPrivate *priv = xapp_status_icon_monitor_get_instance_private (self);
106 XAppStatusIconInterface *proxy;
107
108 proxy = g_hash_table_lookup (priv->icons, name);
109
110 if (proxy)
111 {
112 g_object_ref (proxy);
113
114 g_signal_handlers_disconnect_by_func (proxy,
115 on_proxy_name_owner_changed,
116 self);
117
118 if (g_hash_table_remove (priv->icons, name))
119 {
120 g_debug("XAppStatusIconMonitor: removing icon: '%s'", name);
121
122 g_signal_emit (self, signals[ICON_REMOVED], 0, proxy);
123 }
124 else
125 {
126 g_assert_not_reached ();
127 }
128
129 g_object_unref (proxy);
130 }
131 }
132
133 static void
134 new_status_icon_proxy_complete (GObject *object,
135 GAsyncResult *res,
136 gpointer user_data)
137 {
138 XAppStatusIconMonitor *self = XAPP_STATUS_ICON_MONITOR (user_data);
139 XAppStatusIconMonitorPrivate *priv = xapp_status_icon_monitor_get_instance_private (self);
140 XAppStatusIconInterface *proxy;
141 GError *error;
142 gchar *g_name;
143
144 error = NULL;
145
146 proxy = xapp_status_icon_interface_proxy_new_finish (res,
147 &error);
148
149 if (error)
150 {
151 g_warning ("Couldn't add status icon: %s", error->message);
152 g_error_free (error);
153 return;
154 }
155
156 g_signal_connect_object (proxy,
157 "notify::g-name-owner",
158 G_CALLBACK (on_proxy_name_owner_changed),
159 self,
160 0);
161
162 g_object_get (proxy, "g-name", &g_name, NULL);
163
164 g_hash_table_insert (priv->icons,
165 g_name,
166 proxy);
167
168 g_signal_emit (self, signals[ICON_ADDED], 0, proxy);
169 }
170
171 static void
172 add_icon (XAppStatusIconMonitor *self,
173 const gchar *name)
174 {
175 XAppStatusIconMonitorPrivate *priv = xapp_status_icon_monitor_get_instance_private (self);
176 gchar *unique_path;
177 gint pid, id;
178
179 if (sscanf (name, STATUS_ICON_ID_FORMAT, &pid, &id) == 2)
180 {
181 unique_path = g_strdup_printf (STATUS_ICON_PATH_PREFIX "%d", id);
182
183 g_debug("XAppStatusIconMonitor: adding icon: '%s' with path '%s'", name, unique_path);
184
185 xapp_status_icon_interface_proxy_new (priv->connection,
186 G_DBUS_PROXY_FLAGS_NONE,
187 name,
188 unique_path,
189 NULL,
190 new_status_icon_proxy_complete,
191 self);
192
193 g_free (unique_path);
194 }
195 else
196 {
197 g_debug ("XAppStatusIconMonitor: adding icon failed, name '%s' is invalid", name);
198 }
199 }
200
201 static void
202 on_list_names_completed (GObject *source,
203 GAsyncResult *res,
204 gpointer user_data)
205 {
206 XAppStatusIconMonitor *self = XAPP_STATUS_ICON_MONITOR (user_data);
207 GVariant *result;
208 GVariantIter *iter;
209 gchar *str;
210 GError *error;
211
212 error = NULL;
213
214 result = g_dbus_connection_call_finish (G_DBUS_CONNECTION (source),
215 res,
216 &error);
217
218 if (error != NULL)
219 {
220 g_critical ("XAppStatusIconMonitor: attempt to ListNames failed: %s\n", error->message);
221 g_error_free (error);
222 return;
223 }
224
225 g_variant_get (result, "(as)", &iter);
226
227 while (g_variant_iter_loop (iter, "s", &str))
228 {
229 /* the '.' at the end so we don't catch ourselves in this */
230 if (g_str_has_prefix (str, STATUS_ICON_MATCH))
231 {
232 g_debug ("XAppStatusIconMonitor: found icon: %s", str);
233 add_icon (self, str);
234 }
235 }
236
237 g_variant_iter_free (iter);
238 g_variant_unref (result);
239 }
240
241 static void
242 find_and_add_icons (XAppStatusIconMonitor *self)
243 {
244 XAppStatusIconMonitorPrivate *priv = xapp_status_icon_monitor_get_instance_private (self);
245
246
247 g_debug("XAppStatusIconMonitor: looking for status icons on the bus");
248
249 /* If there are no monitors (applets) already running when this is set up,
250 * this won't find anything. The XAppStatusIcons will be in fallback mode,
251 * and will only attempt to switch back after seeing this monitor appear
252 * on the bus, which means they'll show up via our NameOwnerChanged handler.
253 * Basically, this will never find anything if we're the first monitor to appear
254 * on the bus.
255 */
256
257 g_dbus_connection_call (priv->connection,
258 "org.freedesktop.DBus",
259 "/org/freedesktop/DBus",
260 "org.freedesktop.DBus",
261 "ListNames",
262 NULL,
263 G_VARIANT_TYPE ("(as)"),
264 G_DBUS_CALL_FLAGS_NONE,
265 3000, /* 3 secs */
266 NULL,
267 on_list_names_completed,
268 self);
269 }
270
271 static void
272 status_icon_name_appeared (XAppStatusIconMonitor *self,
273 const gchar *name,
274 const gchar *owner)
275 {
276 XAppStatusIconMonitorPrivate *priv = xapp_status_icon_monitor_get_instance_private (self);
277
278 if (!g_str_has_prefix (name, STATUS_ICON_MATCH))
279 {
280 return;
281 }
282
283 if (g_hash_table_contains (priv->icons, name))
284 {
285 return;
286 }
287
288 g_debug ("XAppStatusIconMonitor: new icon appeared: %s", name);
289
290 add_icon (self, name);
291 }
292
293 static void
294 status_icon_name_vanished (XAppStatusIconMonitor *self,
295 const gchar *name)
296 {
297 if (!g_str_has_prefix (name, STATUS_ICON_MATCH))
298 {
299 return;
300 }
301
302 g_debug ("XAppStatusIconMonitor: icon presence vanished: %s", name);
303
304 remove_icon (self, name);
305 }
306
307 static void
308 name_owner_changed (GDBusConnection *connection,
309 const gchar *sender_name,
310 const gchar *object_path,
311 const gchar *interface_name,
312 const gchar *signal_name,
313 GVariant *parameters,
314 gpointer user_data)
315 {
316 XAppStatusIconMonitor *self = XAPP_STATUS_ICON_MONITOR (user_data);
317
318 const gchar *name;
319 const gchar *old_owner;
320 const gchar *new_owner;
321
322 g_debug("XAppStatusIconMonitor: NameOwnerChanged signal received: %s)", sender_name);
323
324 g_variant_get (parameters, "(&s&s&s)", &name, &old_owner, &new_owner);
325
326 if (old_owner[0] != '\0')
327 {
328 status_icon_name_vanished (self, name);
329 }
330
331 if (new_owner[0] != '\0')
332 {
333 status_icon_name_appeared (self, name, new_owner);
334 }
335 }
336
337
338 static void
339 add_name_listener (XAppStatusIconMonitor *self)
340 {
341 XAppStatusIconMonitorPrivate *priv = xapp_status_icon_monitor_get_instance_private (self);
342
343 g_debug ("XAppStatusIconMonitor: Adding NameOwnerChanged listener for status icons");
344
345 priv->listener_id = g_dbus_connection_signal_subscribe (priv->connection,
346 "org.freedesktop.DBus",
347 "org.freedesktop.DBus",
348 "NameOwnerChanged",
349 "/org/freedesktop/DBus",
350 "org.x.StatusIcon",
351 G_DBUS_SIGNAL_FLAGS_MATCH_ARG0_NAMESPACE,
352 name_owner_changed,
353 self,
354 NULL);
355 }
356
357 static void
358 on_name_lost (GDBusConnection *connection,
359 const gchar *name,
360 gpointer user_data)
361 {
362 if (connection == NULL)
363 {
364 g_warning ("error acquiring session bus");
365 }
366 }
367
368 static void
369 on_name_acquired (GDBusConnection *connection,
370 const gchar *name,
371 gpointer user_data)
372 {
373 XAppStatusIconMonitor *self = XAPP_STATUS_ICON_MONITOR (user_data);
374
375 g_debug ("XAppStatusIconMonitor: name acquired on dbus");
376
377 add_name_listener (self);
378 find_and_add_icons (self);
379 }
380
381 static void
382 on_bus_acquired (GDBusConnection *connection,
383 const gchar *name,
384 gpointer user_data)
385 {
386 XAppStatusIconMonitor *self = XAPP_STATUS_ICON_MONITOR (user_data);
387 XAppStatusIconMonitorPrivate *priv = xapp_status_icon_monitor_get_instance_private (self);
388
389 g_debug ("XAppStatusIconMonitor: session bus connection acquired");
390
391 priv->connection = connection;
392 }
393
394 static void
395 connect_to_bus (XAppStatusIconMonitor *self)
396 {
397 XAppStatusIconMonitorPrivate *priv = xapp_status_icon_monitor_get_instance_private (self);
398
399 static gint unique_id = 0;
400
401 char *owner_name = g_strdup_printf("%s.PID-%d-%d", MONITOR_NAME, getpid (), unique_id);
402
403 unique_id++;
404
405 g_debug ("XAppStatusIconMonitor: Attempting to acquire presence on dbus as %s", owner_name);
406
407 priv->owner_id = g_bus_own_name (G_BUS_TYPE_SESSION,
408 owner_name,
409 G_DBUS_CONNECTION_FLAGS_NONE,
410 on_bus_acquired,
411 on_name_acquired,
412 on_name_lost,
413 self,
414 NULL);
415
416 g_free(owner_name);
417 }
418
419 static void
420 xapp_status_icon_monitor_init (XAppStatusIconMonitor *self)
421 {
422 XAppStatusIconMonitorPrivate *priv = xapp_status_icon_monitor_get_instance_private (self);
423
424 priv->name = g_strdup_printf("%s", g_get_application_name());
425
426 priv->icons = g_hash_table_new_full (g_str_hash, g_str_equal,
427 g_free, g_object_unref);
428
429 connect_to_bus (self);
430 }
431
432 static void
433 xapp_status_icon_monitor_dispose (GObject *object)
434 {
435 XAppStatusIconMonitor *self = XAPP_STATUS_ICON_MONITOR (object);
436 XAppStatusIconMonitorPrivate *priv = xapp_status_icon_monitor_get_instance_private (self);
437
438 g_debug ("XAppStatusIconMonitor dispose (%p)", object);
439
440 if (priv->connection != NULL)
441 {
442 if (priv->listener_id > 0)
443 {
444 g_dbus_connection_signal_unsubscribe (priv->connection, priv->listener_id);
445 }
446
447 if (priv->owner_id > 0)
448 {
449 g_bus_unown_name(priv->owner_id);
450 }
451
452 g_clear_object (&priv->connection);
453 }
454
455 g_free (priv->name);
456 g_clear_pointer (&priv->icons, g_hash_table_unref);
457
458 G_OBJECT_CLASS (xapp_status_icon_monitor_parent_class)->dispose (object);
459 }
460
461 static void
462 xapp_status_icon_monitor_finalize (GObject *object)
463 {
464 g_debug ("XAppStatusIconMonitor finalize (%p)", object);
465
466 G_OBJECT_CLASS (xapp_status_icon_monitor_parent_class)->dispose (object);
467 }
468
469 static void
470 xapp_status_icon_monitor_class_init (XAppStatusIconMonitorClass *klass)
471 {
472 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
473
474 gobject_class->dispose = xapp_status_icon_monitor_dispose;
475 gobject_class->finalize = xapp_status_icon_monitor_finalize;
476
477 /**
478 * XAppStatusIconMonitor::icon-added:
479 * @monitor: the #XAppStatusIconMonitor
480 * @proxy: the interface proxy for the #XAppStatusIcon that has been added.
481 *
482 * This signal is emitted by the monitor when it has discovered a new
483 * #XAppStatusIcon on the bus.
484 */
485 signals[ICON_ADDED] =
486 g_signal_new ("icon-added",
487 XAPP_TYPE_STATUS_ICON_MONITOR,
488 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
489 0,
490 NULL, NULL, NULL,
491 G_TYPE_NONE, 1, XAPP_TYPE_STATUS_ICON_INTERFACE_PROXY);
492
493 /**
494 * XAppStatusIconMonitor::icon-removed:
495 * @monitor: the #XAppStatusIconMonitor
496 * @proxy: the #XAppStatusIcon proxy that has been removed.
497 *
498 * This signal is emitted by the monitor when an #XAppStatusIcon has disappeared
499 * from the bus.
500 */
501 signals[ICON_REMOVED] =
502 g_signal_new ("icon-removed",
503 XAPP_TYPE_STATUS_ICON_MONITOR,
504 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
505 0,
506 NULL, NULL, NULL,
507 G_TYPE_NONE, 1, XAPP_TYPE_STATUS_ICON_INTERFACE_PROXY);
508 }
509
510 /**
511 * xapp_status_icon_monitor_list_icons:
512 * @monitor: a #XAppStatusIconMonitor
513 *
514 * List known icon proxies.
515 *
516 * Returns: (element-type XAppStatusIconMonitor) (transfer container): a #GList of icons
517 *
518 * Since: 1.6
519 */
520 GList *
521 xapp_status_icon_monitor_list_icons (XAppStatusIconMonitor *monitor)
522 {
523 g_return_val_if_fail (XAPP_IS_STATUS_ICON_MONITOR (monitor), NULL);
524
525 XAppStatusIconMonitorPrivate *priv = xapp_status_icon_monitor_get_instance_private (monitor);
526
527 return g_hash_table_get_values (priv->icons);
528 }
529
530 /**
531 * xapp_status_icon_monitor_new:
532 *
533 * Creates a new monitor.
534 *
535 * Returns: (transfer full): a new #XAppStatusIconMonitor. Use g_object_unref when finished.
536 *
537 * Since: 1.6
538 */
539 XAppStatusIconMonitor *
540 xapp_status_icon_monitor_new (void)
541 {
542 return g_object_new (XAPP_TYPE_STATUS_ICON_MONITOR, NULL);
543 }
544
0 #ifndef __XAPP_STATUS_ICON_MONITOR_H__
1 #define __XAPP_STATUS_ICON_MONITOR_H__
2
3 #include <stdio.h>
4 #include <gtk/gtk.h>
5
6 #include <glib-object.h>
7
8 G_BEGIN_DECLS
9
10 #define XAPP_TYPE_STATUS_ICON_MONITOR (xapp_status_icon_monitor_get_type ())
11
12 G_DECLARE_FINAL_TYPE (XAppStatusIconMonitor, xapp_status_icon_monitor, XAPP, STATUS_ICON_MONITOR, GObject)
13
14 XAppStatusIconMonitor *xapp_status_icon_monitor_new (void);
15 GList *xapp_status_icon_monitor_list_icons (XAppStatusIconMonitor *monitor);
16
17 G_END_DECLS
18
19 #endif /* __XAPP_STATUS_ICON_MONITOR_H__ */
0
1 #include <config.h>
2
3 #include <stdio.h>
4 #include <stdlib.h>
5 #include <string.h>
6
7 #include <sys/types.h>
8 #include <unistd.h>
9
10 #include <gdk/gdkx.h>
11 #include <gtk/gtk.h>
12
13 #include <glib/gi18n-lib.h>
14
15 #include "xapp-status-icon.h"
16 #include "xapp-statusicon-interface.h"
17 #include "xapp-enums.h"
18
19 #define FDO_DBUS_NAME "org.freedesktop.DBus"
20 #define FDO_DBUS_PATH "/org/freedesktop/DBus"
21
22 #define ICON_PATH "/org/x/StatusIcon"
23 #define ICON_NAME "org.x.StatusIcon"
24
25 #define STATUS_ICON_MONITOR_MATCH "org.x.StatusIconMonitor"
26
27 #define MAX_NAME_FAILS 3
28
29 static gint unique_id = 0;
30
31 enum
32 {
33 BUTTON_PRESS,
34 BUTTON_RELEASE,
35 ACTIVATE,
36 STATE_CHANGED,
37 LAST_SIGNAL
38 };
39
40 static guint signals[LAST_SIGNAL] = {0, };
41
42 enum
43 {
44 PROP_0,
45 PROP_PRIMARY_MENU,
46 PROP_SECONDARY_MENU,
47 N_PROPERTIES
48 };
49
50 /**
51 * SECTION:xapp-status-icon
52 * @Short_description: Broadcasts status information over DBUS
53 * @Title: XAppStatusIcon
54 *
55 * The XAppStatusIcon allows applications to share status info
56 * about themselves. It replaces the obsolete and very similar
57 * Gtk.StatusIcon widget.
58 *
59 * If used in an environment where no applet is handling XAppStatusIcons,
60 * the XAppStatusIcon delegates its calls to a Gtk.StatusIcon.
61 */
62 typedef struct
63 {
64 XAppStatusIconInterface *skeleton;
65 GDBusConnection *connection;
66
67 GCancellable *cancellable;
68
69 GtkStatusIcon *gtk_status_icon;
70 GtkWidget *primary_menu;
71 GtkWidget *secondary_menu;
72
73 XAppStatusIconState state;
74
75 gchar *name;
76 gchar *icon_name;
77 gchar *tooltip_text;
78 gchar *label;
79 gboolean visible;
80
81 guint owner_id;
82 guint listener_id;
83
84 gint fail_counter;
85 gboolean have_button_press;
86 } XAppStatusIconPrivate;
87
88 struct _XAppStatusIcon
89 {
90 GObject parent_instance;
91 XAppStatusIconPrivate *priv;
92 };
93
94 G_DEFINE_TYPE_WITH_PRIVATE (XAppStatusIcon, xapp_status_icon, G_TYPE_OBJECT)
95
96 static void refresh_icon (XAppStatusIcon *self);
97 static void use_gtk_status_icon (XAppStatusIcon *self);
98 static void tear_down_dbus (XAppStatusIcon *self);
99
100 static void
101 cancellable_reset (XAppStatusIcon *self)
102 {
103 if (self->priv->cancellable)
104 {
105 g_cancellable_cancel (self->priv->cancellable);
106 g_object_unref (self->priv->cancellable);
107 }
108
109 self->priv->cancellable = g_cancellable_new ();
110 }
111
112 static const gchar *
113 panel_position_to_str (GtkPositionType type)
114 {
115 switch (type)
116 {
117 case GTK_POS_LEFT:
118 return "Left";
119 case GTK_POS_RIGHT:
120 return "Right";
121 case GTK_POS_TOP:
122 return "Top";
123 case GTK_POS_BOTTOM:
124 default:
125 return "Bottom";
126 }
127 }
128
129 static const gchar *
130 button_to_str (guint button)
131 {
132 switch (button)
133 {
134 case GDK_BUTTON_PRIMARY:
135 return "Left";
136 case GDK_BUTTON_SECONDARY:
137 return "Right";
138 case GDK_BUTTON_MIDDLE:
139 return "Middle";
140 default:
141 return "Unknown";
142 }
143 }
144
145 static const gchar *
146 state_to_str (XAppStatusIconState state)
147 {
148 switch (state)
149 {
150 case XAPP_STATUS_ICON_STATE_NATIVE:
151 return "Native";
152 case XAPP_STATUS_ICON_STATE_FALLBACK:
153 return "Fallback";
154 case XAPP_STATUS_ICON_STATE_NO_SUPPORT:
155 return "NoSupport";
156 default:
157 return "Unknown";
158 }
159 }
160
161 typedef struct {
162 gint x;
163 gint y;
164 gint position;
165 guint32 t;
166 } PositionData;
167
168 static void
169 position_menu_cb (GtkMenu *menu,
170 gint *x,
171 gint *y,
172 gboolean *push_in,
173 gpointer user_data)
174 {
175 GtkAllocation alloc;
176 PositionData *position_data = (PositionData *) user_data;
177
178 *x = position_data->x;
179 *y = position_data->y;
180
181 gtk_widget_get_allocation (GTK_WIDGET (menu), &alloc);
182
183 switch (position_data->position) {
184 case GTK_POS_BOTTOM:
185 *y = *y - alloc.height;
186 break;
187 case GTK_POS_RIGHT:
188 *x = *x - alloc.width;
189 break;
190 }
191
192 *push_in = TRUE;
193 }
194
195 static void
196 popup_native_icon_menu (XAppStatusIcon *self,
197 GtkMenu *menu,
198 gint x,
199 gint y,
200 guint button,
201 guint _time,
202 gint panel_position)
203 {
204 GdkDisplay *display;
205 GdkDevice *pointer;
206
207 g_debug ("XAppStatusIcon: Popup menu on behalf of application");
208
209 PositionData position_data = {
210 x, y, panel_position, _time
211 };
212
213 display = gdk_display_get_default ();
214 pointer = gdk_device_manager_get_client_pointer (gdk_display_get_device_manager (display));
215
216 gtk_menu_popup_for_device (menu,
217 pointer,
218 NULL,
219 NULL,
220 position_menu_cb,
221 &position_data,
222 NULL,
223 button,
224 _time);
225 }
226
227 static gboolean
228 should_send_activate (XAppStatusIcon *icon,
229 guint button)
230 {
231 gboolean do_activate = TRUE;
232
233 switch (button)
234 {
235 case GDK_BUTTON_PRIMARY:
236 if (icon->priv->primary_menu)
237 {
238 do_activate = FALSE;
239 }
240 break;
241 case GDK_BUTTON_SECONDARY:
242 if (icon->priv->secondary_menu)
243 {
244 do_activate = FALSE;
245 }
246 break;
247 default:
248 break;
249 }
250
251 return do_activate;
252 }
253
254 static gboolean
255 handle_appindicator_button_press (XAppStatusIcon *icon,
256 guint button,
257 guint _time)
258 {
259 if (g_object_get_data (G_OBJECT (icon), "app-indicator"))
260 {
261 if (button == GDK_BUTTON_MIDDLE)
262 {
263 g_debug ("XAppStatusIcon: sending activate for middle-click event (libappindicator)");
264
265 g_signal_emit (icon, signals[ACTIVATE], 0,
266 button,
267 _time);
268 }
269 else
270 {
271 g_debug ("XAppStatusIcon: GtkStatusIcon (app-indicator) ignoring %s button press.", button_to_str (button));
272 }
273
274 return TRUE;
275 }
276
277 return FALSE;
278 }
279
280 static GtkWidget *
281 get_menu_to_use (XAppStatusIcon *icon,
282 guint button)
283 {
284 GtkWidget *menu_to_use = NULL;
285
286 switch (button)
287 {
288 case GDK_BUTTON_PRIMARY:
289 menu_to_use = icon->priv->primary_menu;
290 break;
291 case GDK_BUTTON_SECONDARY:
292 /* Icons originated in app-indicator only set a primary menu,
293 * but expect it to be opened on left and right-clicks */
294
295 if (g_object_get_data (G_OBJECT (icon), "app-indicator"))
296 {
297 menu_to_use = icon->priv->primary_menu;
298 }
299 else
300 {
301 menu_to_use = icon->priv->secondary_menu;
302 }
303 break;
304 }
305
306 return menu_to_use;
307 }
308
309 static gboolean
310 handle_click_method (XAppStatusIconInterface *skeleton,
311 GDBusMethodInvocation *invocation,
312 gint x,
313 gint y,
314 guint button,
315 guint _time,
316 gint panel_position,
317 XAppStatusIcon *icon)
318 {
319 const gchar *name = g_dbus_method_invocation_get_method_name (invocation);
320
321 if (g_strcmp0 (name, "ButtonPress") == 0)
322 {
323 g_debug ("XAppStatusIcon: received ButtonPress from monitor %s: "
324 "pos:%d,%d , button: %s , time: %u , orientation: %s",
325 g_dbus_method_invocation_get_sender (invocation),
326 x, y, button_to_str (button), _time, panel_position_to_str (panel_position));
327
328 if (!handle_appindicator_button_press (icon, button, _time))
329 {
330 if (should_send_activate (icon, button))
331 {
332 g_debug ("XAppStatusIcon: native sending 'activate' for %s button", button_to_str (button));
333 g_signal_emit (icon, signals[ACTIVATE], 0,
334 button,
335 _time);
336 }
337 }
338
339 icon->priv->have_button_press = TRUE;
340
341 g_signal_emit (icon, signals[BUTTON_PRESS], 0,
342 x, y,
343 button,
344 _time,
345 panel_position);
346
347 xapp_status_icon_interface_complete_button_press (skeleton,
348 invocation);
349 }
350 else
351 if (g_strcmp0 (name, "ButtonRelease") == 0)
352 {
353 g_debug ("XAppStatusIcon: received ButtonRelease from monitor %s: "
354 "pos:%d,%d , button: %s , time: %u , orientation: %s",
355 g_dbus_method_invocation_get_sender (invocation),
356 x, y, button_to_str (button), _time, panel_position_to_str (panel_position));
357
358 if (icon->priv->have_button_press)
359 {
360 GtkWidget *menu_to_use = get_menu_to_use (icon, button);
361
362 if (menu_to_use)
363 {
364 popup_native_icon_menu (icon,
365 GTK_MENU (menu_to_use),
366 x, y,
367 button,
368 _time,
369 panel_position);
370 }
371
372 g_signal_emit (icon, signals[BUTTON_RELEASE], 0,
373 x, y,
374 button,
375 _time,
376 panel_position);
377 }
378
379 icon->priv->have_button_press = FALSE;
380
381 xapp_status_icon_interface_complete_button_release (skeleton,
382 invocation);
383 }
384
385 return TRUE;
386 }
387
388 static void
389 popup_gtk_status_icon_with_menu (XAppStatusIcon *icon,
390 GtkMenu *menu,
391 GtkStatusIcon *gtk_status_icon,
392 guint button,
393 guint activate_time)
394 {
395 gtk_menu_popup (menu,
396 NULL,
397 NULL,
398 gtk_status_icon_position_menu,
399 gtk_status_icon,
400 button,
401 activate_time);
402 }
403
404 static void
405 calculate_gtk_status_icon_position_and_orientation (XAppStatusIcon *icon,
406 GtkStatusIcon *status_icon,
407 gint *x, gint *y, gint *orientation)
408 {
409 GdkScreen *screen;
410 GdkRectangle irect;
411 GtkOrientation iorientation;
412 gint final_x, final_y, final_o;
413
414 final_x = 0;
415 final_y = 0;
416 final_o = 0;
417
418 if (gtk_status_icon_get_geometry (status_icon,
419 &screen,
420 &irect,
421 &iorientation))
422 {
423 GdkDisplay *display = gdk_screen_get_display (screen);
424 GdkMonitor *monitor;
425 GdkRectangle mrect;
426
427 monitor = gdk_display_get_monitor_at_point (display,
428 irect.x + (irect.width / 2),
429 irect.y + (irect.height / 2));
430
431 gdk_monitor_get_workarea (monitor, &mrect);
432
433 switch (iorientation)
434 {
435 case GTK_ORIENTATION_HORIZONTAL:
436 final_x = irect.x;
437
438 if (irect.y + irect.height + 100 < mrect.y + mrect.height)
439 {
440 final_y = irect.y + irect.height;
441 final_o = GTK_POS_TOP;
442 }
443 else
444 {
445 final_y = irect.y;
446 final_o = GTK_POS_BOTTOM;
447 }
448
449 break;
450 case GTK_ORIENTATION_VERTICAL:
451 final_y = irect.y;
452
453 if (irect.x + irect.width + 100 < mrect.x + mrect.width)
454 {
455 final_x = irect.x + irect.width;
456 final_o = GTK_POS_LEFT;
457 }
458 else
459 {
460 final_x = irect.x;
461 final_o = GTK_POS_RIGHT;
462 }
463 }
464 }
465
466 *x = final_x;
467 *y = final_y;
468 *orientation = final_o;
469 }
470
471 static gboolean
472 on_gtk_status_icon_button_press (GtkStatusIcon *status_icon,
473 GdkEvent *event,
474 gpointer user_data)
475 {
476 XAppStatusIcon *icon = user_data;
477
478 guint _time;
479 guint button;
480 gint x, y, orientation;
481
482 button = event->button.button;
483 _time = event->button.time;
484
485 /* Button press equates to activate when there's no menu,
486 * but for appindicator, left click and right click will always
487 * bring up the same menu, and only a middle click should activate. */
488
489 g_debug ("XAppStatusIcon: GtkStatusIcon button-press-event with %s button", button_to_str (button));
490
491 if (!handle_appindicator_button_press (icon, button, _time))
492 {
493 /* We always send 'activate' for a button that has no corresponding menu,
494 * and for middle clicks. */
495 if (should_send_activate (icon, button))
496 {
497 g_debug ("XAppStatusIcon: GtkStatusIcon activated by %s button", button_to_str (button));
498
499 g_signal_emit (icon, signals[ACTIVATE], 0,
500 button,
501 _time);
502 }
503 }
504
505 calculate_gtk_status_icon_position_and_orientation (icon,
506 status_icon,
507 &x,
508 &y,
509 &orientation);
510
511 icon->priv->have_button_press = TRUE;
512
513 g_signal_emit (icon, signals[BUTTON_PRESS], 0,
514 x, y,
515 button,
516 _time,
517 orientation);
518 }
519
520 static void
521 on_gtk_status_icon_button_release (GtkStatusIcon *status_icon,
522 GdkEvent *event,
523 gpointer user_data)
524 {
525 XAppStatusIcon *icon = user_data;
526 guint _time;
527 guint button;
528 gint x, y, orientation;
529
530 button = event->button.button;
531 _time = event->button.time;
532
533 g_debug ("XAppStatusIcon: GtkStatusIcon button-release-event with %s button", button_to_str (button));
534
535 /* Icons originated in app-indicator have only a single menu, which displays on either
536 * right or left-click. */
537 if (g_object_get_data (G_OBJECT (status_icon), "app-indicator"))
538 {
539 if (button == GDK_BUTTON_PRIMARY || button == GDK_BUTTON_SECONDARY)
540 {
541 popup_gtk_status_icon_with_menu (icon,
542 GTK_MENU (icon->priv->primary_menu),
543 status_icon,
544 button,
545 _time);
546 }
547 }
548 else
549 {
550 /* Native icons can have two menus, so we must determine which to use based
551 * on the gtk icon event's button. */
552 GtkWidget *menu_to_use;
553
554 menu_to_use = get_menu_to_use (icon, button);
555
556 if (menu_to_use)
557 {
558 g_debug ("XAppStatusIcon: GtkStatusIcon popup menu for %s button", button_to_str (button));
559
560 popup_gtk_status_icon_with_menu (icon,
561 GTK_MENU (menu_to_use),
562 status_icon,
563 button,
564 _time);
565 }
566 }
567
568 calculate_gtk_status_icon_position_and_orientation (icon,
569 status_icon,
570 &x,
571 &y,
572 &orientation);
573
574 icon->priv->have_button_press = FALSE;
575
576 g_signal_emit (icon, signals[BUTTON_RELEASE], 0,
577 x, y,
578 button,
579 _time,
580 orientation);
581 }
582
583 static void
584 name_owner_changed (GDBusConnection *connection,
585 const gchar *sender_name,
586 const gchar *object_path,
587 const gchar *interface_name,
588 const gchar *signal_name,
589 GVariant *parameters,
590 gpointer user_data)
591 {
592 XAppStatusIcon *self = XAPP_STATUS_ICON (user_data);
593 g_debug("XAppStatusIcon: NameOwnerChanged signal received, refreshing icon");
594
595 refresh_icon (self);
596 }
597
598 static void
599 add_name_listener (XAppStatusIcon *self)
600 {
601 g_debug ("XAppStatusIcon: Adding NameOwnerChanged listener for status monitors");
602
603 self->priv->listener_id = g_dbus_connection_signal_subscribe (self->priv->connection,
604 FDO_DBUS_NAME,
605 FDO_DBUS_NAME,
606 "NameOwnerChanged",
607 FDO_DBUS_PATH,
608 STATUS_ICON_MONITOR_MATCH,
609 G_DBUS_SIGNAL_FLAGS_MATCH_ARG0_NAMESPACE,
610 name_owner_changed,
611 self,
612 NULL);
613 }
614
615 static void
616 on_name_lost (GDBusConnection *connection,
617 const gchar *name,
618 gpointer user_data)
619 {
620 XAppStatusIcon *self = XAPP_STATUS_ICON (user_data);
621
622 g_warning ("XAppStatusIcon: lost or could not acquire presence on dbus. Refreshing.");
623
624 self->priv->fail_counter++;
625
626 refresh_icon (self);
627 }
628
629 static void
630 sync_skeleton (XAppStatusIcon *self)
631 {
632 XAppStatusIconPrivate *priv = self->priv;
633
634 priv->fail_counter = 0;
635
636 g_clear_object (&self->priv->gtk_status_icon);
637
638 g_object_set (G_OBJECT (priv->skeleton),
639 "name", priv->name,
640 "label", priv->label,
641 "icon-name", priv->icon_name,
642 "tooltip-text", priv->tooltip_text,
643 "visible", priv->visible,
644 NULL);
645
646 g_dbus_interface_skeleton_flush (G_DBUS_INTERFACE_SKELETON (priv->skeleton));
647 }
648
649 static void
650 on_name_acquired (GDBusConnection *connection,
651 const gchar *name,
652 gpointer user_data)
653 {
654 XAppStatusIcon *self = XAPP_STATUS_ICON (user_data);
655
656 self->priv->state = XAPP_STATUS_ICON_STATE_NATIVE;
657
658 sync_skeleton (self);
659
660 g_debug ("XAppStatusIcon: name acquired on dbus, syncing icon properties. State is now: %s",
661 state_to_str (self->priv->state));
662 g_signal_emit (self, signals[STATE_CHANGED], 0, self->priv->state);
663 }
664
665 typedef struct
666 {
667 const gchar *signal_name;
668 gpointer callback;
669 } SkeletonSignal;
670
671 static SkeletonSignal skeleton_signals[] = {
672 // signal name callback
673 { "handle-button-press", handle_click_method },
674 { "handle-button-release", handle_click_method }
675 };
676
677 static gboolean
678 export_icon_interface (XAppStatusIcon *self)
679 {
680 GError *error = NULL;
681 gint i;
682 gchar *unique_path;
683
684 if (self->priv->skeleton) {
685 return TRUE;
686 }
687
688 self->priv->skeleton = xapp_status_icon_interface_skeleton_new ();
689
690 unique_path = g_strdup_printf (ICON_PATH "/%d", unique_id);
691
692 g_debug ("XAppStatusIcon: exporting StatusIcon dbus interface to %s", unique_path);
693
694 g_dbus_interface_skeleton_export (G_DBUS_INTERFACE_SKELETON (self->priv->skeleton),
695 self->priv->connection,
696 unique_path,
697 &error);
698
699 g_free (unique_path);
700
701 if (error != NULL) {
702 g_critical ("XAppStatusIcon: could not export StatusIcon interface: %s", error->message);
703 g_error_free (error);
704
705 return FALSE;
706 }
707
708 for (i = 0; i < G_N_ELEMENTS (skeleton_signals); i++) {
709 SkeletonSignal sig = skeleton_signals[i];
710
711 g_signal_connect (self->priv->skeleton,
712 sig.signal_name,
713 G_CALLBACK (sig.callback),
714 self);
715 }
716
717 return TRUE;
718 }
719
720 static void
721 connect_with_status_applet (XAppStatusIcon *self)
722 {
723
724 char *owner_name = g_strdup_printf("%s.PID-%d-%d", ICON_NAME, getpid (), unique_id);
725
726 unique_id++;
727
728 g_debug ("XAppStatusIcon: Attempting to acquire presence on dbus as %s", owner_name);
729
730 self->priv->owner_id = g_bus_own_name_on_connection (self->priv->connection,
731 owner_name,
732 G_DBUS_CONNECTION_FLAGS_NONE,
733 on_name_acquired,
734 on_name_lost,
735 self,
736 NULL);
737
738 g_free(owner_name);
739 }
740
741 static void
742 update_fallback_icon (XAppStatusIcon *self,
743 const gchar *icon_name)
744 {
745 if (g_path_is_absolute (icon_name))
746 {
747 gtk_status_icon_set_from_file (self->priv->gtk_status_icon, icon_name);
748 }
749 else
750 {
751 gtk_status_icon_set_from_icon_name (self->priv->gtk_status_icon, icon_name);
752 }
753 }
754
755 static void
756 on_gtk_status_icon_embedded_changed (GtkStatusIcon *icon,
757 GParamSpec *pspec,
758 gpointer user_data)
759 {
760 g_return_if_fail (GTK_IS_STATUS_ICON (icon));
761
762 XAppStatusIcon *self = XAPP_STATUS_ICON (user_data);
763 XAppStatusIconPrivate *priv = self->priv;
764
765 if (gtk_status_icon_is_embedded (icon))
766 {
767 priv->state = XAPP_STATUS_ICON_STATE_FALLBACK;
768 }
769 else
770 {
771 priv->state = XAPP_STATUS_ICON_STATE_NO_SUPPORT;
772 }
773
774 g_debug ("XAppStatusIcon fallback icon embedded_changed. State is now %s",
775 state_to_str (priv->state));
776 g_signal_emit (self, signals[STATE_CHANGED], 0, priv->state);
777 }
778
779 static void
780 use_gtk_status_icon (XAppStatusIcon *self)
781 {
782 XAppStatusIconPrivate *priv = self->priv;
783
784 g_debug ("XAppStatusIcon: falling back to GtkStatusIcon");
785
786 tear_down_dbus (self);
787
788 // Make sure there wasn't already one
789 g_clear_object (&self->priv->gtk_status_icon);
790
791 self->priv->gtk_status_icon = gtk_status_icon_new ();
792
793 g_signal_connect (priv->gtk_status_icon,
794 "button-press-event",
795 G_CALLBACK (on_gtk_status_icon_button_press),
796 self);
797 g_signal_connect (priv->gtk_status_icon,
798 "button-release-event",
799 G_CALLBACK (on_gtk_status_icon_button_release),
800 self);
801 g_signal_connect (priv->gtk_status_icon,
802 "notify::embedded",
803 G_CALLBACK (on_gtk_status_icon_embedded_changed),
804 self);
805
806 update_fallback_icon (self, priv->icon_name ? priv->icon_name : "");
807 gtk_status_icon_set_tooltip_text (self->priv->gtk_status_icon, priv->tooltip_text);
808 }
809
810 static void
811 on_list_names_completed (GObject *source,
812 GAsyncResult *res,
813 gpointer user_data)
814 {
815 XAppStatusIcon *self = XAPP_STATUS_ICON(user_data);
816 GVariant *result;
817 GVariantIter *iter;
818 gchar *str;
819 GError *error;
820 gboolean found;
821
822 error = NULL;
823
824 result = g_dbus_connection_call_finish (G_DBUS_CONNECTION (source),
825 res,
826 &error);
827
828 if (error != NULL)
829 {
830 if (error->code != G_IO_ERROR_CANCELLED)
831 {
832 g_critical ("XAppStatusIcon: attempt to ListNames failed: %s\n", error->message);
833 use_gtk_status_icon (self);
834 }
835 else
836 {
837 g_debug ("XAppStatusIcon: attempt to ListNames cancelled");
838 }
839
840 g_error_free (error);
841 return;
842 }
843
844 g_variant_get (result, "(as)", &iter);
845
846 found = FALSE;
847
848 while (g_variant_iter_loop (iter, "s", &str))
849 {
850 if (g_str_has_prefix (str, STATUS_ICON_MONITOR_MATCH))
851 {
852 g_debug ("XAppStatusIcon: Discovered active status monitor (%s)", str);
853 found = TRUE;
854 }
855 }
856
857 g_variant_iter_free (iter);
858 g_variant_unref (result);
859
860 if (found && export_icon_interface (self))
861 {
862 if (self->priv->owner_id > 0)
863 {
864 g_debug ("XAppStatusIcon: We already exist on the bus, syncing icon properties");
865 sync_skeleton (self);
866 }
867 else
868 {
869 connect_with_status_applet (self);
870
871 return;
872 }
873 }
874 else
875 {
876 use_gtk_status_icon (self);
877 }
878 }
879
880 static void
881 look_for_status_applet (XAppStatusIcon *self)
882 {
883 // Check that there is at least one applet on DBUS
884 g_debug("XAppStatusIcon: Looking for status monitors");
885
886 cancellable_reset (self);
887
888 g_dbus_connection_call (self->priv->connection,
889 FDO_DBUS_NAME,
890 FDO_DBUS_PATH,
891 FDO_DBUS_NAME,
892 "ListNames",
893 NULL,
894 G_VARIANT_TYPE ("(as)"),
895 G_DBUS_CALL_FLAGS_NONE,
896 3000, /* 3 secs */
897 self->priv->cancellable,
898 on_list_names_completed,
899 self);
900 }
901
902 static void
903 complete_icon_setup (XAppStatusIcon *self)
904 {
905 if (self->priv->listener_id == 0)
906 {
907 add_name_listener (self);
908 }
909
910 /* There is a potential loop in the g_bus_own_name sequence -
911 * if we fail to acquire a name, we refresh again and potentially
912 * fail again. If we fail more than MAX_NAME_FAILS, then quit trying
913 * and just use the fallback icon It's pretty unlikely for*/
914 if (self->priv->fail_counter == MAX_NAME_FAILS)
915 {
916 use_gtk_status_icon (self);
917 return;
918 }
919
920 look_for_status_applet (self);
921 }
922
923 static void
924 on_session_bus_connected (GObject *source,
925 GAsyncResult *res,
926 gpointer user_data)
927 {
928 XAppStatusIcon *self = XAPP_STATUS_ICON (user_data);
929 GError *error;
930
931 error = NULL;
932
933 self->priv->connection = g_bus_get_finish (res, &error);
934
935 if (error != NULL)
936 {
937 if (error->code != G_IO_ERROR_CANCELLED)
938 {
939 g_critical ("XAppStatusIcon: Unable to acquire session bus: %s", error->message);
940
941
942 /* If we never get a connection, we use the Gtk icon exclusively, and will never
943 * re-try. FIXME? this is unlikely to happen, so I don't see the point in trying
944 * later, as there are probably bigger problems in this case. */
945 use_gtk_status_icon (self);
946 }
947 else
948 {
949 g_debug ("XAppStatusIcon: Cancelled session bus acquire");
950 }
951
952 g_error_free (error);
953 return;
954 }
955
956 if (self->priv->connection)
957 {
958 complete_icon_setup (self);
959 return;
960 }
961
962 use_gtk_status_icon (self);
963 }
964
965 static void
966 refresh_icon (XAppStatusIcon *self)
967 {
968 if (!self->priv->connection)
969 {
970 g_debug ("XAppStatusIcon: Trying to acquire session bus connection");
971
972 cancellable_reset (self);
973
974 g_bus_get (G_BUS_TYPE_SESSION,
975 self->priv->cancellable,
976 on_session_bus_connected,
977 self);
978 }
979 else
980 {
981 complete_icon_setup (self);
982 }
983 }
984
985 static void
986 xapp_status_icon_set_property (GObject *object,
987 guint prop_id,
988 const GValue *value,
989 GParamSpec *pspec)
990 {
991 switch (prop_id)
992 {
993 case PROP_PRIMARY_MENU:
994 xapp_status_icon_set_primary_menu (XAPP_STATUS_ICON (object), g_value_get_object (value));
995 break;
996 case PROP_SECONDARY_MENU:
997 xapp_status_icon_set_secondary_menu (XAPP_STATUS_ICON (object), g_value_get_object (value));
998 break;
999 default:
1000 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1001 break;
1002 }
1003 }
1004
1005 static void
1006 xapp_status_icon_get_property (GObject *object,
1007 guint prop_id,
1008 GValue *value,
1009 GParamSpec *pspec)
1010 {
1011 XAppStatusIcon *icon = XAPP_STATUS_ICON (object);
1012
1013 switch (prop_id)
1014 {
1015 case PROP_PRIMARY_MENU:
1016 g_value_set_object (value, icon->priv->primary_menu);
1017 break;
1018 case PROP_SECONDARY_MENU:
1019 g_value_set_object (value, icon->priv->secondary_menu);
1020 break;
1021 default:
1022 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1023 break;
1024 }
1025 }
1026
1027 static void
1028 xapp_status_icon_init (XAppStatusIcon *self)
1029 {
1030 self->priv = xapp_status_icon_get_instance_private (self);
1031
1032 self->priv->name = g_strdup_printf("%s", g_get_application_name());
1033 self->priv->state = XAPP_STATUS_ICON_STATE_NO_SUPPORT;
1034
1035 g_debug ("XAppStatusIcon: init: application name: '%s'", self->priv->name);
1036
1037 // Default to visible (the same behavior as GtkStatusIcon)
1038 self->priv->visible = TRUE;
1039
1040 refresh_icon (self);
1041 }
1042
1043 static void
1044 tear_down_dbus (XAppStatusIcon *self)
1045 {
1046 g_return_if_fail (XAPP_IS_STATUS_ICON (self));
1047
1048 if (self->priv->owner_id > 0)
1049 {
1050 g_debug ("XAppStatusIcon: removing dbus presence (%p)", self);
1051
1052 g_bus_unown_name(self->priv->owner_id);
1053 self->priv->owner_id = 0;
1054 }
1055
1056 if (self->priv->skeleton)
1057 {
1058 g_debug ("XAppStatusIcon: removing dbus interface (%p)", self);
1059
1060 g_dbus_interface_skeleton_unexport (G_DBUS_INTERFACE_SKELETON (self->priv->skeleton));
1061 g_object_unref (self->priv->skeleton);
1062 self->priv->skeleton = NULL;
1063 }
1064 }
1065
1066 static void
1067 xapp_status_icon_dispose (GObject *object)
1068 {
1069 XAppStatusIcon *self = XAPP_STATUS_ICON (object);
1070
1071 g_debug ("XAppStatusIcon dispose (%p)", object);
1072
1073 g_free (self->priv->name);
1074 g_free (self->priv->icon_name);
1075 g_free (self->priv->tooltip_text);
1076 g_free (self->priv->label);
1077
1078 g_clear_object (&self->priv->cancellable);
1079
1080 g_clear_object (&self->priv->primary_menu);
1081 g_clear_object (&self->priv->secondary_menu);
1082
1083 g_signal_handlers_disconnect_by_func (self->priv->gtk_status_icon, on_gtk_status_icon_button_press, self);
1084 g_signal_handlers_disconnect_by_func (self->priv->gtk_status_icon, on_gtk_status_icon_button_release, self);
1085 g_clear_object (&self->priv->gtk_status_icon);
1086
1087 tear_down_dbus (self);
1088
1089 if (self->priv->listener_id > 0)
1090 {
1091 g_dbus_connection_signal_unsubscribe (self->priv->connection, self->priv->listener_id);
1092 }
1093
1094 g_clear_object (&self->priv->connection);
1095
1096 G_OBJECT_CLASS (xapp_status_icon_parent_class)->dispose (object);
1097 }
1098
1099 static void
1100 xapp_status_icon_finalize (GObject *object)
1101 {
1102 g_debug ("XAppStatusIcon finalize (%p)", object);
1103
1104 g_clear_object (&XAPP_STATUS_ICON (object)->priv->cancellable);
1105
1106 G_OBJECT_CLASS (xapp_status_icon_parent_class)->finalize (object);
1107 }
1108
1109 static void
1110 xapp_status_icon_class_init (XAppStatusIconClass *klass)
1111 {
1112 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
1113
1114 gobject_class->dispose = xapp_status_icon_dispose;
1115 gobject_class->finalize = xapp_status_icon_finalize;
1116 gobject_class->set_property = xapp_status_icon_set_property;
1117 gobject_class->get_property = xapp_status_icon_get_property;
1118
1119 /**
1120 * XAppStatusIcon:primary-menu:
1121 *
1122 * A #GtkMenu to use when requested by the remote monitor via a left (or primary) click.
1123 *
1124 * When this property is not %NULL, the menu will be automatically positioned and
1125 * displayed during a primary button release.
1126 *
1127 * When this property IS %NULL, the #XAppStatusIcon::activate will be sent for primary
1128 * button presses.
1129 *
1130 * In both cases, the #XAppStatusIcon::button-press-event and #XAppStatusIcon::button-release-events
1131 * will be fired like normal.
1132 *
1133 * Setting this will remove any floating reference to the menu and assume ownership.
1134 * As a result, it is not necessary to maintain a reference to it in the parent
1135 * application (or unref it when finished with it - if you wish to replace the menu,
1136 * simply call this method again with a new menu.
1137 *
1138 * The same #GtkMenu widget can be set as both the primary and secondary.
1139 */
1140 g_object_class_install_property (gobject_class, PROP_PRIMARY_MENU,
1141 g_param_spec_object ("primary-menu",
1142 "Status icon primary (left-click) menu",
1143 "A menu to bring up when the status icon is left-clicked",
1144 GTK_TYPE_WIDGET,
1145 G_PARAM_READWRITE));
1146
1147 /**
1148 * XAppStatusIcon:secondary-menu:
1149 *
1150 * A #GtkMenu to use when requested by the remote monitor via a right (or secondary) click.
1151 *
1152 * When this property is not %NULL, the menu will be automatically positioned and
1153 * displayed during a secondary button release.
1154 *
1155 * When this property IS %NULL, the #XAppStatusIcon::activate will be sent for secondary
1156 * button presses.
1157 *
1158 * In both cases, the #XAppStatusIcon::button-press-event and #XAppStatusIcon::button-release-events
1159 * will be fired like normal.
1160 *
1161 * Setting this will remove any floating reference to the menu and assume ownership.
1162 * As a result, it is not necessary to maintain a reference to it in the parent
1163 * application (or unref it when finished with it - if you wish to replace the menu,
1164 * simply call this method again with a new menu.
1165 *
1166 * The same #GtkMenu widget can be set as both the primary and secondary.
1167 */
1168 g_object_class_install_property (gobject_class, PROP_SECONDARY_MENU,
1169 g_param_spec_object ("secondary-menu",
1170 "Status icon secondary (right-click) menu",
1171 "A menu to bring up when the status icon is right-clicked",
1172 GTK_TYPE_WIDGET,
1173 G_PARAM_READWRITE));
1174
1175
1176 /**
1177 * XAppStatusIcon::button-press-event:
1178 * @icon: The #XAppStatusIcon
1179 * @x: The absolute x position to use for menu positioning
1180 * @y: The absolute y position to use for menu positioning
1181 * @button: The button that was pressed
1182 * @time: The time supplied by the event, or 0
1183 * @panel_position: The #GtkPositionType to use for menu positioning
1184 *
1185 * Gets emitted when there is a button press received from an applet
1186 */
1187 signals[BUTTON_PRESS] =
1188 g_signal_new ("button-press-event",
1189 XAPP_TYPE_STATUS_ICON,
1190 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1191 0,
1192 NULL, NULL, NULL,
1193 G_TYPE_NONE, 5, G_TYPE_INT, G_TYPE_INT, G_TYPE_UINT, G_TYPE_UINT, G_TYPE_INT);
1194
1195 /**
1196 * XAppStatusIcon::button-release-event:
1197 * @icon: The #XAppStatusIcon
1198 * @x: The absolute x position to use for menu positioning
1199 * @y: The absolute y position to use for menu positioning
1200 * @button: The button that was released
1201 * @time: The time supplied by the event, or 0
1202 * @panel_position: The #GtkPositionType to use for menu positioning
1203 *
1204 * Gets emitted when there is a button release received from an applet
1205 */
1206 signals[BUTTON_RELEASE] =
1207 g_signal_new ("button-release-event",
1208 XAPP_TYPE_STATUS_ICON,
1209 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1210 0,
1211 NULL, NULL, NULL,
1212 G_TYPE_NONE, 5, G_TYPE_INT, G_TYPE_INT, G_TYPE_UINT, G_TYPE_UINT, G_TYPE_INT);
1213
1214 /**
1215 * XAppStatusIcon::activate:
1216 * @icon: The #XAppStatusIcon
1217 * @button: The button that was pressed
1218 * @time: The time supplied by the event, or 0
1219 *
1220 * Gets emitted when the user activates the status icon. If the XAppStatusIcon:primary-menu or
1221 * XAppStatusIcon:secondary-menu is not %NULL, this signal is skipped for the respective button
1222 * presses. A middle button click will always send this signal when pressed.
1223 */
1224 signals [ACTIVATE] =
1225 g_signal_new ("activate",
1226 XAPP_TYPE_STATUS_ICON,
1227 G_SIGNAL_RUN_FIRST | G_SIGNAL_ACTION,
1228 0,
1229 NULL, NULL, NULL,
1230 G_TYPE_NONE, 2, G_TYPE_UINT, G_TYPE_UINT);
1231
1232 /**
1233 * XAppStatusIcon::state-changed:
1234 * @icon: The #XAppStatusIcon
1235 * @new_state: The new #XAppStatusIconState of the icon
1236 *
1237 * Gets emitted when the state of the icon changes. If you wish
1238 * to react to changes in how the status icon is being handled
1239 * (perhaps to alter the menu or other click behavior), you should
1240 * connect to this - see #XAppStatusIconState for more details.
1241 */
1242 signals [STATE_CHANGED] =
1243 g_signal_new ("state-changed",
1244 XAPP_TYPE_STATUS_ICON,
1245 G_SIGNAL_RUN_FIRST | G_SIGNAL_ACTION,
1246 0,
1247 NULL, NULL, NULL,
1248 G_TYPE_NONE, 1, XAPP_TYPE_STATUS_ICON_STATE);
1249 }
1250
1251 /**
1252 * xapp_status_icon_set_name:
1253 * @icon: a #XAppStatusIcon
1254 * @name: a name (this defaults to the name of the application, if not set)
1255 *
1256 * Sets the status icon name. This is not shown to users.
1257 *
1258 * Since: 1.6
1259 */
1260 void
1261 xapp_status_icon_set_name (XAppStatusIcon *icon, const gchar *name)
1262 {
1263 g_return_if_fail (XAPP_IS_STATUS_ICON (icon));
1264 g_clear_pointer (&icon->priv->name, g_free);
1265 icon->priv->name = g_strdup (name);
1266
1267 g_debug ("XAppStatusIcon set_name: %s", name);
1268
1269 if (icon->priv->skeleton)
1270 {
1271 xapp_status_icon_interface_set_name (icon->priv->skeleton, name);
1272 }
1273
1274 if (icon->priv->gtk_status_icon != NULL)
1275 {
1276 gtk_status_icon_set_name (icon->priv->gtk_status_icon, name);
1277 }
1278 }
1279
1280 /**
1281 * xapp_status_icon_set_icon_name:
1282 * @icon: a #XAppStatusIcon
1283 * @icon_name: An icon name or absolute path to an icon.
1284 *
1285 * Sets the icon name or local path to use.
1286 *
1287 * Since: 1.6
1288 */
1289 void
1290 xapp_status_icon_set_icon_name (XAppStatusIcon *icon, const gchar *icon_name)
1291 {
1292 g_return_if_fail (XAPP_IS_STATUS_ICON (icon));
1293 g_clear_pointer (&icon->priv->icon_name, g_free);
1294 icon->priv->icon_name = g_strdup (icon_name);
1295
1296 g_debug ("XAppStatusIcon set_icon_name: %s", icon_name);
1297
1298 if (icon->priv->skeleton)
1299 {
1300 xapp_status_icon_interface_set_icon_name (icon->priv->skeleton, icon_name);
1301 }
1302
1303 if (icon->priv->gtk_status_icon != NULL)
1304 {
1305 update_fallback_icon (icon, icon_name);
1306 }
1307 }
1308
1309 /**
1310 * xapp_status_icon_set_tooltip_text:
1311 * @icon: a #XAppStatusIcon
1312 * @tooltip_text: the text to show in the tooltip
1313 *
1314 * Sets the tooltip text
1315 *
1316 * Since: 1.6
1317 */
1318 void
1319 xapp_status_icon_set_tooltip_text (XAppStatusIcon *icon, const gchar *tooltip_text)
1320 {
1321 g_return_if_fail (XAPP_IS_STATUS_ICON (icon));
1322 g_clear_pointer (&icon->priv->tooltip_text, g_free);
1323 icon->priv->tooltip_text = g_strdup (tooltip_text);
1324
1325 g_debug ("XAppStatusIcon set_tooltip_text: %s", tooltip_text);
1326
1327 if (icon->priv->skeleton)
1328 {
1329 xapp_status_icon_interface_set_tooltip_text (icon->priv->skeleton, tooltip_text);
1330 }
1331
1332 if (icon->priv->gtk_status_icon != NULL)
1333 {
1334 gtk_status_icon_set_tooltip_text (icon->priv->gtk_status_icon, tooltip_text);
1335 }
1336 }
1337
1338 /**
1339 * xapp_status_icon_set_label:
1340 * @icon: a #XAppStatusIcon
1341 * @label: some text
1342 *
1343 * Sets a label, shown beside the icon
1344 *
1345 * Since: 1.6
1346 */
1347 void
1348 xapp_status_icon_set_label (XAppStatusIcon *icon, const gchar *label)
1349 {
1350 g_return_if_fail (XAPP_IS_STATUS_ICON (icon));
1351 g_clear_pointer (&icon->priv->label, g_free);
1352 icon->priv->label = g_strdup (label);
1353
1354 g_debug ("XAppStatusIcon set_label: '%s'", label);
1355
1356 if (icon->priv->skeleton)
1357 {
1358 xapp_status_icon_interface_set_label (icon->priv->skeleton, label);
1359 }
1360 }
1361
1362 /**
1363 * xapp_status_icon_set_visible:
1364 * @icon: a #XAppStatusIcon
1365 * @visible: whether or not the status icon should be visible
1366 *
1367 * Sets the visibility of the status icon
1368 *
1369 * Since: 1.6
1370 */
1371 void
1372 xapp_status_icon_set_visible (XAppStatusIcon *icon, const gboolean visible)
1373 {
1374 g_return_if_fail (XAPP_IS_STATUS_ICON (icon));
1375 icon->priv->visible = visible;
1376
1377 g_debug ("XAppStatusIcon set_visible: %s", visible ? "TRUE" : "FALSE");
1378
1379 if (icon->priv->skeleton)
1380 {
1381 xapp_status_icon_interface_set_visible (icon->priv->skeleton, visible);
1382 }
1383
1384 if (icon->priv->gtk_status_icon != NULL)
1385 {
1386 gtk_status_icon_set_visible (icon->priv->gtk_status_icon, visible);
1387 }
1388 }
1389
1390 /**
1391 * xapp_status_icon_set_primary_menu:
1392 * @icon: an #XAppStatusIcon
1393 * @menu: (nullable): A #GtkMenu to display when the primary mouse button is released.
1394 *
1395 * See the #XAppStatusIcon:primary-menu property for details
1396 *
1397 * Since: 1.6
1398 */
1399 void
1400 xapp_status_icon_set_primary_menu (XAppStatusIcon *icon,
1401 GtkMenu *menu)
1402 {
1403 g_return_if_fail (XAPP_IS_STATUS_ICON (icon));
1404
1405 g_clear_object (&icon->priv->primary_menu);
1406
1407 g_debug ("XAppStatusIcon set_primary_menu: %p", menu);
1408
1409 if (menu)
1410 {
1411 icon->priv->primary_menu = GTK_WIDGET (g_object_ref_sink (menu));
1412 }
1413 }
1414
1415 /**
1416 * xapp_status_icon_get_primary_menu:
1417 * @icon: an #XAppStatusIcon
1418 *
1419 * Returns a pointer to a #GtkMenu that was set previously for the
1420 * primary mouse button. If no menu was set, this returns %NULL.
1421 *
1422 * Returns: (transfer none): the #GtkMenu or %NULL if none was set.
1423
1424 * Since: 1.6
1425 */
1426 GtkWidget *
1427 xapp_status_icon_get_primary_menu (XAppStatusIcon *icon)
1428 {
1429 g_return_val_if_fail (XAPP_IS_STATUS_ICON (icon), NULL);
1430
1431 g_debug ("XAppStatusIcon get_menu: %p", icon->priv->primary_menu);
1432
1433 return icon->priv->primary_menu;
1434 }
1435
1436 /**
1437 * xapp_status_icon_set_secondary_menu:
1438 * @icon: an #XAppStatusIcon
1439 * @menu: (nullable): A #GtkMenu to display when the primary mouse button is released.
1440 *
1441 * See the #XAppStatusIcon:secondary-menu property for details
1442 *
1443 * Since: 1.6
1444 */
1445 void
1446 xapp_status_icon_set_secondary_menu (XAppStatusIcon *icon,
1447 GtkMenu *menu)
1448 {
1449 g_return_if_fail (XAPP_IS_STATUS_ICON (icon));
1450
1451 g_clear_object (&icon->priv->secondary_menu);
1452
1453 g_debug ("XAppStatusIcon set_secondary_menu: %p", menu);
1454
1455 if (menu)
1456 {
1457 icon->priv->secondary_menu = GTK_WIDGET (g_object_ref_sink (menu));
1458 }
1459 }
1460
1461 /**
1462 * xapp_status_icon_get_secondary_menu:
1463 * @icon: an #XAppStatusIcon
1464 *
1465 * Returns a pointer to a #GtkMenu that was set previously for the
1466 * secondary mouse button. If no menu was set, this returns %NULL.
1467 *
1468 * Returns: (transfer none): the #GtkMenu or %NULL if none was set.
1469
1470 * Since: 1.6
1471 */
1472 GtkWidget *
1473 xapp_status_icon_get_secondary_menu (XAppStatusIcon *icon)
1474 {
1475 g_return_val_if_fail (XAPP_IS_STATUS_ICON (icon), NULL);
1476
1477 g_debug ("XAppStatusIcon get_menu: %p", icon->priv->secondary_menu);
1478
1479 return icon->priv->secondary_menu;
1480 }
1481
1482 /**
1483 * xapp_status_icon_new:
1484 *
1485 * Creates a new #XAppStatusIcon instance
1486 *
1487 * Returns: (transfer full): a new #XAppStatusIcon. Use g_object_unref when finished.
1488 *
1489 * Since: 1.6
1490 */
1491 XAppStatusIcon *
1492 xapp_status_icon_new (void)
1493 {
1494 return g_object_new (XAPP_TYPE_STATUS_ICON, NULL);
1495 }
1496
1497 /**
1498 * xapp_status_icon_get_state:
1499 * @icon: an #XAppStatusIcon
1500 *
1501 * Gets the current #XAppStatusIconState of icon. The state is determined by whether
1502 * the icon is being displayed by an #XAppStatusMonitor client, a fallback tray icon,
1503 * or not being displayed at all.
1504 *
1505 * See #XAppStatusIconState for more details.
1506 *
1507 * Returns: the icon's state.
1508 *
1509 * Since: 1.6
1510 */
1511 XAppStatusIconState
1512 xapp_status_icon_get_state (XAppStatusIcon *icon)
1513 {
1514 g_return_val_if_fail (XAPP_IS_STATUS_ICON (icon), XAPP_STATUS_ICON_STATE_NO_SUPPORT);
1515
1516 g_debug ("XAppStatusIcon get_state: %s", state_to_str (icon->priv->state));
1517
1518 return icon->priv->state;
1519 }
1520
1521 /**
1522 * xapp_status_icon_any_monitors:
1523 *
1524 * Looks for the existence of any active #XAppStatusIconMonitors on the bus.
1525 *
1526 * Returns: %TRUE if at least one monitor was found.
1527 *
1528 * Since: 1.6
1529 */
1530 gboolean
1531 xapp_status_icon_any_monitors (void)
1532 {
1533 GDBusConnection *connection;
1534 GError *error;
1535 gboolean found;
1536
1537 g_debug("XAppStatusIcon: any_monitors: Looking for status monitors");
1538
1539 error = NULL;
1540 found = FALSE;
1541
1542 connection = g_bus_get_sync (G_BUS_TYPE_SESSION, NULL, &error);
1543
1544 if (connection)
1545 {
1546 GVariant *result;
1547
1548 result = g_dbus_connection_call_sync (connection,
1549 FDO_DBUS_NAME,
1550 FDO_DBUS_PATH,
1551 FDO_DBUS_NAME,
1552 "ListNames",
1553 NULL,
1554 G_VARIANT_TYPE ("(as)"),
1555 G_DBUS_CALL_FLAGS_NONE,
1556 2, NULL, &error);
1557
1558 if (result)
1559 {
1560 GVariantIter *iter;
1561 gchar *str;
1562
1563 g_variant_get (result, "(as)", &iter);
1564
1565 found = FALSE;
1566
1567 while (g_variant_iter_loop (iter, "s", &str))
1568 {
1569 if (g_str_has_prefix (str, STATUS_ICON_MONITOR_MATCH))
1570 {
1571 g_debug ("XAppStatusIcon: any_monitors: discovered active status monitor (%s)", str);
1572
1573 found = TRUE;
1574
1575 g_free (str);
1576 break;
1577 }
1578 }
1579
1580 g_variant_iter_free (iter);
1581 g_variant_unref (result);
1582 }
1583
1584 g_object_unref (connection);
1585 }
1586
1587 if (error)
1588 {
1589 g_warning ("XAppStatusIcon: any_monitors: Unable to check for monitors: %s", error->message);
1590 g_error_free (error);
1591 }
1592
1593 g_debug ("XAppStatusIcon: any_monitors: %s", found ? "TRUE" : "FALSE");
1594
1595 return found;
1596 }
1597
0 #ifndef __XAPP_STATUS_ICON_H__
1 #define __XAPP_STATUS_ICON_H__
2
3 #include <stdio.h>
4 #include <gtk/gtk.h>
5
6 #include <glib-object.h>
7
8 G_BEGIN_DECLS
9
10 #define XAPP_TYPE_STATUS_ICON (xapp_status_icon_get_type ())
11
12 G_DECLARE_FINAL_TYPE (XAppStatusIcon, xapp_status_icon, XAPP, STATUS_ICON, GObject)
13
14 /**
15 * XAppStatusIconState:
16 * @XAPP_STATUS_ICON_STATE_NATIVE: The #XAppStatusIcon is currently being handled
17 * by an #XAppStatusIconMonitor (usually in an applet).
18 * @XAPP_STATUS_ICON_STATE_FALLBACK: The #XAppStatusIcon is currently being handled
19 * by a legacy system tray implementation (using GtkStatusIcon).
20 * @XAPP_STATUS_ICON_STATE_NO_SUPPORT: The #XAppStatusIcon is not currently being handled by any
21 * kind of status icon implementation.
22 */
23 typedef enum
24 {
25 XAPP_STATUS_ICON_STATE_NATIVE,
26 XAPP_STATUS_ICON_STATE_FALLBACK,
27 XAPP_STATUS_ICON_STATE_NO_SUPPORT
28 } XAppStatusIconState;
29
30 XAppStatusIcon *xapp_status_icon_new (void);
31 void xapp_status_icon_set_name (XAppStatusIcon *icon, const gchar *name);
32 void xapp_status_icon_set_icon_name (XAppStatusIcon *icon, const gchar *icon_name);
33 void xapp_status_icon_set_tooltip_text (XAppStatusIcon *icon, const gchar *tooltip_text);
34 void xapp_status_icon_set_label (XAppStatusIcon *icon, const gchar *label);
35 void xapp_status_icon_set_visible (XAppStatusIcon *icon, const gboolean visible);
36 void xapp_status_icon_set_primary_menu (XAppStatusIcon *icon, GtkMenu *menu);
37 GtkWidget *xapp_status_icon_get_primary_menu (XAppStatusIcon *icon);
38 void xapp_status_icon_set_secondary_menu (XAppStatusIcon *icon, GtkMenu *menu);
39 GtkWidget *xapp_status_icon_get_secondary_menu (XAppStatusIcon *icon);
40 XAppStatusIconState xapp_status_icon_get_state (XAppStatusIcon *icon);
41
42 /* static */
43 gboolean xapp_status_icon_any_monitors (void);
44 G_END_DECLS
45
46 #endif /* __XAPP_STATUS_ICON_H__ */
0 #!/usr/bin/python3
1
2 # This script is used to update the docs in docs/reference
3 # which are served at http://developer.linuxmint.com/xapps/reference/index.html.
4
5 import os
6 import sys
7
8 SRC="debian/tmp/usr/share/gtk-doc/html/libxapp/"
9
10 if not os.path.exists(SRC):
11 print("Build first, with dpkg-buildpackage")
12 sys.exit(1)
13
14 os.system("rm -rf docs/reference/*")
15 os.system("cp -R %s/* docs/reference/" % SRC)
16
17 print ("Docs updated, you can now commit and push.")
00 #!/bin/bash
11
2 xgettext --language=C --keyword=_ --keyword=N_ --output=xapp.pot libxapp/*.c
2 rm -f xapp.pot
3 touch xapp.pot
4 xgettext --language=C --add-comments --keyword=_ --keyword=N_ --output=xapp.pot libxapp/*.c
5 xgettext --language=Python --add-comments --keyword=_ --join-existing --output=xapp.pot status-applets/*/*.py
6 xgettext --language=Desktop --join-existing --add-comments \
7 -k --keyword=Name --keyword=Description --output=xapp.pot status-applets/*/*.in
38
00 project('xapp',
11 'c',
2 version : '1.4.9'
2 version : '1.6.2'
33 )
44
55 gnome = import('gnome')
88
99 cdata = configuration_data()
1010 cdata.set('GETTEXT_PACKAGE', '"xapp"')
11
12 add_global_arguments([
13 '-Wunused',
14 '-Wimplicit-function-declaration'
15 ],
16 language: 'c'
17 )
1118
1219 if not get_option('deprecated_warnings')
1320 add_global_arguments([
3037 subdir('pygobject')
3138 subdir('files')
3239 subdir('schemas')
40 subdir('status-applets')
3341
3442 if get_option('docs')
3543 subdir('docs')
0 LOCALEDIR = "@locale@"
1 PKGVERSION = "@pkgversion@"
0 #!/usr/bin/python3
1
2 import locale
3 import gettext
4 import os
5 import sys
6 import setproctitle
7
8 import gi
9 gi.require_version("Gtk", "3.0")
10 gi.require_version("XApp", "1.0")
11 gi.require_version('MatePanelApplet', '4.0')
12 from gi.repository import Gtk, GdkPixbuf, Gdk, GObject, Gio, XApp, GLib, MatePanelApplet
13
14 import applet_constants
15
16 # Rename the process
17 setproctitle.setproctitle('mate-xapp-status-applet')
18
19 # i18n
20 gettext.install("xapp", applet_constants.LOCALEDIR)
21 locale.bindtextdomain("xapp", applet_constants.LOCALEDIR)
22 locale.textdomain("xapp")
23
24 ICON_SIZE_REDUCTION = 2
25 VISIBLE_LABEL_MARGIN = 5 # When an icon has a label, add a margin between icon and label
26
27 statusicon_css_string = """
28 .statuswidget-horizontal {
29 border: none;
30 padding-top: 0;
31 padding-left: 2px;
32 padding-bottom: 0;
33 padding-right: 2px;
34 }
35
36 .statuswidget-vertical {
37 border: none;
38 padding-top: 2px;
39 padding-left: 0;
40 padding-bottom: 2px;
41 padding-right: 0;
42 }
43 """
44
45 def translate_applet_orientation_to_xapp(mate_applet_orientation):
46 # wtf...mate panel's orientation is.. the direction to center of monitor?
47 if mate_applet_orientation == MatePanelApplet.AppletOrient.UP:
48 return Gtk.PositionType.BOTTOM
49 elif mate_applet_orientation == MatePanelApplet.AppletOrient.DOWN:
50 return Gtk.PositionType.TOP
51 elif mate_applet_orientation == MatePanelApplet.AppletOrient.LEFT:
52 return Gtk.PositionType.RIGHT
53 elif mate_applet_orientation == MatePanelApplet.AppletOrient.RIGHT:
54 return Gtk.PositionType.LEFT
55
56 class StatusWidget(Gtk.ToggleButton):
57 def __init__(self, icon, orientation, size):
58 super(Gtk.Button, self).__init__()
59 self.theme = Gtk.IconTheme.get_default()
60 self.orientation = orientation
61 self.size = size
62
63 self.proxy = icon
64
65 # this is the bus owned name
66 self.name = self.proxy.get_name()
67
68 # this is (usually) the name of the remote process
69 self.proc_name = self.proxy.props.name
70
71 self.box = Gtk.Box(orientation=Gtk.Orientation.HORIZONTAL)
72
73 self.image = Gtk.Image(hexpand=True)
74 self.image.show()
75 self.label = Gtk.Label(no_show_all=True)
76 self.box.pack_start(self.image, True, False, 0)
77 self.box.pack_start(self.label, False, False, 0)
78 self.add(self.box)
79
80 self.set_can_default(False)
81 self.set_can_focus(False)
82 self.set_relief(Gtk.ReliefStyle.NONE)
83 self.set_focus_on_click(False)
84
85 flags = GObject.BindingFlags.DEFAULT | GObject.BindingFlags.SYNC_CREATE
86
87 self.proxy.bind_property("label", self.label, "label", flags)
88 self.proxy.bind_property("tooltip-text", self, "tooltip-text", flags)
89 self.proxy.bind_property("visible", self, "visible", flags)
90
91 self.proxy.connect("notify::icon-name", self._on_icon_name_changed)
92
93 self.in_widget = False
94 self.plain_surface = None
95 self.saturated_surface = None
96
97 self.connect("button-press-event", self.on_button_press)
98 self.connect("button-release-event", self.on_button_release)
99 self.connect("enter-notify-event", self.on_enter_notify)
100 self.connect("leave-notify-event", self.on_leave_notify)
101
102 self.update_orientation()
103 self.update_icon()
104
105 self.show_all()
106
107 def _on_icon_name_changed(self, proxy, gparamspec, data=None):
108 self.update_icon()
109
110 def update_icon(self):
111 string = self.proxy.props.icon_name
112
113 self.set_icon(string)
114
115 def update_style(self, orientation):
116 ctx = self.get_style_context()
117
118 if orientation == Gtk.Orientation.HORIZONTAL:
119 ctx.remove_class("statuswidget-vertical")
120 ctx.add_class("statuswidget-horizontal")
121 else:
122 ctx.remove_class("statuswidget-horizontal")
123 ctx.add_class("statuswidget-vertical")
124
125 def update_orientation(self):
126 if self.orientation in (MatePanelApplet.AppletOrient.UP, MatePanelApplet.AppletOrient.DOWN):
127 box_orientation = Gtk.Orientation.HORIZONTAL
128 else:
129 box_orientation = Gtk.Orientation.VERTICAL
130
131 self.update_style(box_orientation)
132 self.box.set_orientation(box_orientation)
133
134 if len(self.label.props.label) > 0 and box_orientation == Gtk.Orientation.HORIZONTAL:
135 self.label.set_visible(True)
136 self.label.set_margin_start(VISIBLE_LABEL_MARGIN)
137 else:
138 self.label.set_visible(False)
139 self.label.set_margin_start(0)
140
141 def set_icon(self, string):
142 size = self.size - ICON_SIZE_REDUCTION
143
144 self.image.set_pixel_size(size)
145
146 fallback = True
147
148 if string:
149 try:
150 if os.path.exists(string):
151 icon_file = Gio.File.new_for_path(string)
152 icon = Gio.FileIcon.new(icon_file)
153 self.image.set_from_gicon(icon, Gtk.IconSize.MENU)
154 else:
155 if self.theme.has_icon(string):
156 icon = Gio.ThemedIcon.new(string)
157 self.image.set_from_gicon(icon, Gtk.IconSize.MENU)
158
159 fallback = False
160 except GLib.Error as e:
161 print("MateXAppStatusApplet: Could not load icon '%s' for '%s': %s" % (string, self.proc_name, e.message))
162 except TypeError as e:
163 print("MateXAppStatusApplet: Could not load icon '%s' for '%s': %s" % (string, self.proc_name, str(e)))
164
165 #fallback
166 if fallback:
167 self.image.set_from_icon_name("image-missing", Gtk.IconSize.MENU)
168
169 # TODO?
170 def on_enter_notify(self, widget, event):
171 self.in_widget = True
172
173 return Gdk.EVENT_PROPAGATE
174
175 def on_leave_notify(self, widget, event):
176 self.in_widget = False
177
178 return Gdk.EVENT_PROPAGATE
179 # /TODO
180
181 def after_release_idle(self, data=None):
182 self.set_active(False)
183
184 return GLib.SOURCE_REMOVE
185
186 def on_button_press(self, widget, event):
187 orientation = translate_applet_orientation_to_xapp(self.orientation)
188
189 x, y = self.calc_menu_origin(widget, orientation)
190 self.proxy.call_button_press(x, y, event.button, event.time, orientation, None, None)
191
192 if event.button != Gdk.BUTTON_PRIMARY:
193 self.set_active(True)
194
195 if event.button in (Gdk.BUTTON_MIDDLE, Gdk.BUTTON_SECONDARY):
196 # Block the 'remove from panel' menu, and the middle-click drag.
197 # They can still accomplish these things along the edges of the applet
198 return Gdk.EVENT_STOP
199
200 return Gdk.EVENT_PROPAGATE
201
202 def on_button_release(self, widget, event):
203 orientation = translate_applet_orientation_to_xapp(self.orientation)
204
205 x, y = self.calc_menu_origin(widget, orientation)
206 self.proxy.call_button_release(x, y, event.button, event.time, orientation, None, None)
207
208 GObject.timeout_add(200, self.after_release_idle)
209
210 return Gdk.EVENT_PROPAGATE
211
212 def calc_menu_origin(self, widget, orientation):
213 alloc = widget.get_allocation()
214 ignore, x, y = widget.get_window().get_origin()
215 rx = 0
216 ry = 0
217
218 if orientation == Gtk.PositionType.TOP:
219 rx = x + alloc.x
220 ry = y + alloc.y + alloc.height
221 elif orientation == Gtk.PositionType.BOTTOM:
222 rx = x + alloc.x
223 ry = y + alloc.y
224 elif orientation == Gtk.PositionType.LEFT:
225 rx = x + alloc.x + alloc.width
226 ry = y + alloc.y
227 elif orientation == Gtk.PositionType.RIGHT:
228 rx = x + alloc.x
229 ry = y + alloc.y
230 else:
231 rx = x
232 ry = y
233
234 return rx, ry
235
236 class MateXAppStatusApplet(object):
237 def __init__(self, applet, iid):
238 self.applet = applet
239 self.applet.set_flags(MatePanelApplet.AppletFlags.EXPAND_MINOR |
240 MatePanelApplet.AppletFlags.HAS_HANDLE)
241 self.applet.set_can_focus(False)
242 self.applet.set_background_widget(self.applet)
243
244 self.add_about()
245
246 button_css = Gtk.CssProvider()
247
248 if button_css.load_from_data(statusicon_css_string.encode()):
249 Gtk.StyleContext.add_provider_for_screen(Gdk.Screen.get_default(), button_css, 600)
250
251 self.applet.connect("realize", self.on_applet_realized)
252 self.applet.connect("destroy", self.on_applet_destroy)
253
254 self.indicators = {}
255 self.monitor = None
256
257 def add_about(self):
258 group = Gtk.ActionGroup(name="xapp-status-applet-group")
259 group.set_translation_domain("xapp")
260
261 about_action = Gtk.Action(name="ShowAbout",
262 icon_name="info",
263 label=_("About"),
264 visible=True)
265
266 about_action.connect("activate", self.show_about)
267 group.add_action(about_action)
268
269 xml = '\
270 <menuitem name="ShowDesktopAboutItem" action="ShowAbout"/> \
271 '
272
273 self.applet.setup_menu(xml, group)
274
275 def show_about(self, action, data=None):
276 dialog = Gtk.AboutDialog.new()
277
278 dialog.set_program_name("XApp Status Applet")
279 dialog.set_version(applet_constants.PKGVERSION)
280 dialog.set_license_type(Gtk.License.GPL_3_0)
281 dialog.set_website("https://github.com/linuxmint/xapps")
282 dialog.set_logo_icon_name("panel-applets")
283 dialog.set_comments(_("Area where XApp status icons appear"))
284
285 dialog.run()
286 dialog.destroy()
287
288 def on_applet_realized(self, widget, data=None):
289 self.indicator_box = Gtk.Box(visible=True)
290
291 self.applet.add(self.indicator_box)
292 self.applet.connect("change-size", self.on_applet_size_changed)
293 self.applet.connect("change-orient", self.on_applet_orientation_changed)
294 self.update_orientation()
295
296 if not self.monitor:
297 self.setup_monitor()
298
299 def on_applet_destroy(self, widget, data=None):
300 self.destroy_monitor()
301 Gtk.main_quit()
302
303 def setup_monitor (self):
304 self.monitor = XApp.StatusIconMonitor()
305 self.monitor.connect("icon-added", self.on_icon_added)
306 self.monitor.connect("icon-removed", self.on_icon_removed)
307
308 def destroy_monitor (self):
309 for key in self.indicators.keys():
310 self.indicator_box.remove(self.indicators[key])
311
312 self.monitor = None
313 self.indicators = {}
314
315 def on_icon_added(self, monitor, proxy):
316 name = proxy.get_name()
317
318 self.indicators[name] = StatusWidget(proxy, self.applet.get_orient(), self.applet.get_size())
319 self.indicator_box.add(self.indicators[name])
320
321 self.sort_icons()
322
323 def on_icon_removed(self, monitor, proxy):
324 name = proxy.get_name()
325
326 self.indicator_box.remove(self.indicators[name])
327 del(self.indicators[name])
328
329 self.sort_icons()
330
331 def update_orientation(self):
332 self.on_applet_orientation_changed(self, self.applet.get_orient())
333
334 def on_applet_size_changed(self, applet, size, data=None):
335 for key in self.indicators.keys():
336 indicator = self.indicators[key]
337
338 indicator.size = applet.get_size()
339 indicator.update_icon()
340
341 self.applet.queue_resize()
342
343 def on_applet_orientation_changed(self, applet, applet_orient, data=None):
344 orient = self.applet.get_orient()
345
346 for key in self.indicators.keys():
347 indicator = self.indicators[key]
348
349 indicator.orientation = orient
350 indicator.update_orientation()
351
352 box_orientation = Gtk.Orientation.HORIZONTAL
353
354 if orient in (MatePanelApplet.AppletOrient.LEFT, MatePanelApplet.AppletOrient.RIGHT):
355 box_orientation = Gtk.Orientation.VERTICAL
356
357 self.indicator_box.set_orientation(box_orientation)
358 self.indicator_box.queue_resize()
359
360 def sort_icons(self):
361 icon_list = list(self.indicators.values())
362
363 # for i in icon_list:
364 # print("before: ", i.proxy.props.icon_name, i.proxy.props.name.lower())
365
366 icon_list.sort(key=lambda icon: icon.proxy.props.name.lower())
367 icon_list.sort(key=lambda icon: icon.proxy.props.icon_name.lower().endswith("symbolic"))
368
369 # for i in icon_list:
370 # print("after: ", i.proxy.props.icon_name, i.proxy.props.name.lower())
371
372 icon_list.reverse()
373
374 for icon in icon_list:
375 self.indicator_box.reorder_child(icon, 0)
376
377 def applet_factory(applet, iid, data):
378 MateXAppStatusApplet(applet, iid)
379 applet.show()
380 return True
381
382 def quit_all(widget):
383 Gtk.main_quit()
384 sys.exit(0)
385
386 MatePanelApplet.Applet.factory_main("MateXAppStatusAppletFactory", True,
387 MatePanelApplet.Applet.__gtype__,
388 applet_factory, None)
0 ## Applet file
1
2 conf = configuration_data()
3 conf.set('locale', join_paths(get_option('prefix'), get_option('localedir')))
4 conf.set('pkgversion', meson.project_version())
5
6 # Put replacements in a separate file, and import the file into the applet.
7 # This is mainly to make testing/dev easier - if you put the conf replacement
8 # strings inside the applet itself, you have to build each time to get a valid
9 # file (with all replacements made). With this, you can just copy from source,
10 # and your replacements are already there in this file.
11 constants_file = configure_file(
12 input : 'applet_constants.py.in',
13 output: 'applet_constants.py',
14 configuration: conf,
15 )
16
17 libexec_files = [
18 constants_file,
19 'mate-xapp-status-applet.py'
20 ]
21
22 install_data(libexec_files,
23 install_dir: join_paths(get_option('libexecdir'), 'xapps')
24 )
25
26 ## DBus service file
27
28 conf = configuration_data()
29 conf.set('libexec', join_paths(get_option('prefix'), get_option('libexecdir')))
30
31 service_file = configure_file(
32 input : 'org.mate.panel.applet.MateXAppStatusAppletFactory.service.in',
33 output: 'org.mate.panel.applet.MateXAppStatusAppletFactory.service',
34 configuration: conf,
35 )
36
37 install_data(service_file,
38 install_dir: join_paths(get_option('datadir'), 'dbus-1', 'services')
39 )
40
41 ## Applet definition file
42
43 def_file = configure_file(
44 input: 'org.x.MateXAppStatusApplet.mate-panel-applet.in.in',
45 output: 'org.x.MateXAppStatusApplet.mate-panel-applet.in',
46 configuration: conf,
47 )
48
49 i18n.merge_file(
50 input: def_file,
51 output: 'org.x.MateXAppStatusApplet.mate-panel-applet',
52 type: 'desktop',
53 po_dir: join_paths(meson.source_root(), 'po'),
54 install: true,
55 install_dir: join_paths(get_option('datadir'), 'mate-panel', 'applets')
56 )
0 [D-BUS Service]
1 Name=org.mate.panel.applet.MateXAppStatusAppletFactory
2 Exec=@libexec@/xapps/mate-xapp-status-applet.py
0 [Applet Factory]
1 Id=MateXAppStatusAppletFactory
2 InProcess=false
3 Location=@libexec@/xapps/mate-xapp-status-applet.py
4 Name=XApp Status Applet Factory
5 Description=Area where XApp status icons appear
6
7 [MateXAppStatusApplet]
8 Name=XApp Status Applet
9 Description=Area where XApp status icons appear
10 Icon=panel-applets
11 MateComponentId=OAFIID:MATE_MateXAppStatusApplet;
12
2727
2828 args = parser.parse_args()
2929
30 dialog = XApp.IconChooserDialog(allow_paths=args.paths)
30 dialog = XApp.IconChooserDialog(allow_paths=args.paths, default_icon='folder')
3131 dialog.set_skip_taskbar_hint(False)
3232 if args.category:
3333 response = dialog.run_with_category(args.category)
0 #!/usr/bin/python3
1 import gi
2 gi.require_version('Gtk', '3.0')
3 gi.require_version('XApp', '1.0')
4 from gi.repository import Gio, GLib, GObject, Gtk, XApp
5 import os
6 import sys
7
8 DBUS_NAME = "org.x.StatusIcon"
9 DBUS_PATH = "/org/x/StatusIcon"
10
11 class StatusWidget(Gtk.Button):
12
13 def __init__(self, icon):
14 super(Gtk.Button, self).__init__()
15
16 self.proxy = icon
17 self.name = self.proxy.get_name()
18
19 box = Gtk.Box(orientation=Gtk.Orientation.HORIZONTAL)
20
21 self.image = Gtk.Image()
22 self.label = Gtk.Label()
23 box.pack_start(self.image, False, False, 6)
24 box.add(self.label)
25 self.add(box)
26
27 flags = GObject.BindingFlags.DEFAULT | GObject.BindingFlags.SYNC_CREATE
28
29 self.image.props.icon_size = Gtk.IconSize.DIALOG
30 self.set_icon(self.proxy.props.icon_name)
31 self.proxy.bind_property("label", self.label, "label", flags)
32 self.proxy.bind_property("tooltip-text", self, "tooltip-text", flags)
33 self.proxy.bind_property("visible", self, "visible", flags)
34
35 self.proxy.connect("notify::icon-name", self.on_icon_name_changed)
36
37 self.connect("button-press-event", self.on_button_press)
38 self.connect("button-release-event", self.on_button_release)
39
40 def on_icon_name_changed(self, proxy, gparamspec, data=None):
41 string = self.proxy.props.icon_name
42
43 self.set_icon(string)
44
45 def set_icon(self, string):
46 if string:
47 if string and os.path.exists(string):
48 self.image.set_from_file(string)
49 else:
50 self.image.set_from_icon_name(string, Gtk.IconSize.DIALOG)
51 else:
52 self.image.set_from_icon_name("image-missing", Gtk.IconSize.DIALOG)
53
54 def on_button_press(self, widget, event):
55 # We're simulating a top panel here
56 alloc = widget.get_allocation()
57 ignore, x, y = widget.get_window().get_origin()
58
59 x += alloc.x
60 y += alloc.y + alloc.height
61 time = event.time
62 print ("Button press : %d:%d" % (x, y))
63 self.proxy.call_button_press_sync(x, y, event.button, event.time, Gtk.PositionType.TOP, None)
64
65 def on_button_release(self, widget, event):
66 # We're simulating a top panel here
67 alloc = widget.get_allocation()
68 ignore, x, y = widget.get_window().get_origin()
69
70 x += alloc.x
71 y += alloc.y + alloc.height
72 time = event.time
73 print ("Button release : %d:%d" % (x, y))
74 self.proxy.call_button_release_sync(x, y, event.button, event.time, Gtk.PositionType.TOP, None)
75
76 class StatusApplet(GObject.Object):
77
78 def __init__(self):
79 super(StatusApplet, self).__init__()
80
81 self.window = Gtk.Window()
82 self.window.set_accept_focus (False)
83 self.window.connect("destroy", self.on_window_destroy)
84
85 self.main_box = Gtk.Box(orientation=Gtk.Orientation.VERTICAL,
86 margin=6,
87 spacing=6)
88 self.window.add(self.main_box)
89
90 self.disco_button = Gtk.Button()
91 self.main_box.pack_start(self.disco_button, False, False, 0)
92 self.disco_button.connect("clicked", self.on_disco_button_clicked)
93
94 self.indicator_box = Gtk.Box(orientation=Gtk.Orientation.HORIZONTAL,
95 spacing=6)
96 self.main_box.pack_start(self.indicator_box, False, False, 0)
97
98 self.indicators = {}
99
100 self.monitor = None
101 self.setup_monitor()
102
103 self.window.show_all()
104
105 def on_window_destroy(self, widget, data=None):
106 self.destroy_monitor()
107 Gtk.main_quit()
108
109 def on_disco_button_clicked(self, widget, data=None):
110 if self.monitor == None:
111 self.setup_monitor ()
112 else:
113 self.destroy_monitor()
114
115 def setup_monitor (self):
116 self.monitor = XApp.StatusIconMonitor()
117 self.monitor.connect("icon-added", self.on_icon_added)
118 self.monitor.connect("icon-removed", self.on_icon_removed)
119
120 self.disco_button.set_label("Disconnect monitor")
121
122 def destroy_monitor (self):
123 for key in self.indicators.keys():
124 self.indicator_box.remove(self.indicators[key])
125
126 self.monitor = None
127 self.indicators = {}
128
129 self.disco_button.set_label("Connect monitor")
130
131 def on_icon_added(self, monitor, proxy):
132 name = proxy.get_name()
133
134 self.indicators[name] = StatusWidget(proxy)
135 self.indicator_box.add(self.indicators[name])
136 self.window.show_all()
137
138 self.sort_icons()
139
140 def on_icon_removed(self, monitor, proxy):
141 name = proxy.get_name()
142
143 self.indicator_box.remove(self.indicators[name])
144 del(self.indicators[name])
145
146 self.sort_icons()
147
148 def sort_icons(self, status_icon=None):
149 icon_list = list(self.indicators.values())
150
151 # for i in icon_list:
152 # print("before: ", i.proxy.props.icon_name, i.proxy.props.name.lower())
153
154 icon_list.sort(key=lambda icon: icon.proxy.props.name.lower())
155 icon_list.sort(key=lambda icon: icon.proxy.props.icon_name.lower().endswith("symbolic"))
156
157 # for i in icon_list:
158 # print("after: ", i.proxy.props.icon_name, i.proxy.props.name.lower())
159
160 icon_list.reverse()
161
162 for icon in icon_list:
163 self.indicator_box.reorder_child(icon, 0)
164
165 if __name__ == '__main__':
166 applet = StatusApplet()
167 Gtk.main()
168 sys.exit(0)
0 #!/usr/bin/python3
1
2 import gi
3 gi.require_version('XApp', '1.0')
4 from gi.repository import XApp, Gtk, Gdk
5 from gi.repository import GLib, GObject
6 import sys
7
8 """
9 This variant tests behavior of giving a only a secondary menu to the StatusIcon instance.
10 This results in 'activate' signals being sent for primary clicks only.
11 """
12
13 class App(GObject.Object):
14
15 def __init__(self):
16 super(App, self).__init__()
17 self.status_icon = XApp.StatusIcon()
18 self.status_icon.connect("state-changed", self.on_icon_state_changed)
19
20 self.status_icon.set_icon_name("folder-symbolic")
21 self.status_icon.set_tooltip_text("Testing primary activate and secondary menu")
22 self.status_icon.set_label("label 1")
23 self.status_icon.set_visible(True)
24
25 self.counter = 1
26
27 menu = Gtk.Menu()
28 menu.append(Gtk.MenuItem.new_with_label("Hi, secondary menu here!"))
29 menu.append(Gtk.SeparatorMenuItem())
30 menu.append(Gtk.MenuItem.new_with_label("Help me!"))
31 menu.show_all()
32
33 self.status_icon.set_secondary_menu(menu)
34 self.status_icon.connect("activate", self.on_status_icon_activate)
35
36 GLib.timeout_add_seconds(2, self.on_timeout_cb)
37
38 def on_icon_state_changed(self, icon, new_state):
39 print("Icon state changed - the state is now: %s" % new_state)
40
41 def on_timeout_cb(self):
42 self.counter += 1
43 self.status_icon.set_label("label %d" % self.counter)
44 return True
45
46 def on_status_icon_activate(self, icon, button, time):
47 print("Activated via button %d" % button)
48 self.counter = 0
49 self.status_icon.set_label("label %d" % self.counter)
50
51 if __name__ == '__main__':
52 GLib.setenv ("G_MESSAGES_DEBUG", "all", True)
53 app = App()
54 try:
55 GLib.MainLoop().run()
56 except KeyboardInterrupt:
57 pass
58 sys.exit(0)
0 #!/usr/bin/python3
1
2 import gi
3 gi.require_version('AppIndicator3', '0.1')
4 gi.require_version('Gtk', '3.0')
5 from gi.repository import Gtk, Gdk, AppIndicator3
6 from gi.repository import GLib, GObject
7 import sys
8
9 """
10 This variant tests behavior of a program using mint-patched AppIndicator, which will fall
11 back to XAppStatusIcon if there is no AppIndicator support in the desktop environment.
12 AppIndicator expects both left- and right-click to display the menu, so internally, AppIndicator
13 sets both primary and secondary menus on the XAppStatusIcon.
14 """
15
16 class App(GObject.Object):
17 def __init__(self):
18 super(App, self).__init__()
19 self.indicator = AppIndicator3.Indicator.new("xapp-status-icon-via-libappindicator",
20 "info",
21 AppIndicator3.IndicatorCategory.SYSTEM_SERVICES)
22 self.indicator.set_icon_full("info", "Everything is fine.")
23 self.indicator.set_label("AppIndicator3 1", "AppIndicator3 1000")
24 self.indicator.set_status(AppIndicator3.IndicatorStatus.ACTIVE)
25 self.indicator.set_title("Testing patched appindicator fallback to XApp.StatusIcon")
26 self.counter = 1
27
28 self.menu = Gtk.Menu()
29 secondary_activation_item = Gtk.MenuItem.new_with_label("Activate target (middle click)")
30 secondary_activation_item.connect("activate", self.activate_window)
31 self.indicator.set_secondary_activate_target(secondary_activation_item)
32
33 self.menu.append(secondary_activation_item)
34 self.menu.append(Gtk.MenuItem.new_with_label("Engage the hyperdrive"))
35 self.menu.append(Gtk.SeparatorMenuItem())
36 self.menu.append(Gtk.MenuItem.new_with_label("It's a trap!"))
37 self.menu.show_all()
38
39 self.indicator.set_menu(self.menu)
40
41 GLib.timeout_add_seconds(2, self.on_timeout_cb)
42
43 def activate_window(self, item, data=None):
44 w = Gtk.Window(default_width=300, default_height=130)
45 b = Gtk.Box(orientation=Gtk.Orientation.VERTICAL)
46 w.add(b)
47 b.pack_start(Gtk.Label("How can I help you?"), True, True, 0)
48 w.show_all()
49
50 def on_timeout_cb(self):
51 self.counter += 1
52 self.indicator.set_label("AppIndicator3 %d" % self.counter, "AppIndicator3 1000")
53 return True
54
55 if __name__ == '__main__':
56 GLib.setenv ("G_MESSAGES_DEBUG", "all", True)
57 app = App()
58 try:
59 GLib.MainLoop().run()
60 except KeyboardInterrupt:
61 pass
62 sys.exit(0)
0 #!/usr/bin/python3
1
2 import gi
3 gi.require_version('XApp', '1.0')
4 from gi.repository import XApp, Gtk, Gdk
5 from gi.repository import GLib, GObject
6 import sys
7
8 """
9 This variant tests behavior of giving primary and secondary menus to the StatusIcon instance.
10 The instance handles all menu-related things internally. There is no activation signal.
11 """
12
13 class App(GObject.Object):
14
15 def __init__(self):
16 super(App, self).__init__()
17 self.status_icon = XApp.StatusIcon()
18 self.status_icon.connect("state-changed", self.on_icon_state_changed)
19
20 self.status_icon.set_icon_name("folder-symbolic")
21 self.status_icon.set_tooltip_text("Testing primary and secondary menus")
22 self.status_icon.set_label("label 1")
23 self.status_icon.set_visible(True)
24
25 self.counter = 1
26
27 menu = Gtk.Menu()
28 menu.append(Gtk.MenuItem.new_with_label("Engage the hyperdrive"))
29 menu.append(Gtk.SeparatorMenuItem())
30 menu.append(Gtk.MenuItem.new_with_label("It's a trap!"))
31 menu.show_all()
32
33 self.status_icon.set_primary_menu(menu)
34
35 menu = Gtk.Menu()
36 menu.append(Gtk.MenuItem.new_with_label("Hi, secondary menu here!"))
37 menu.append(Gtk.SeparatorMenuItem())
38 menu.append(Gtk.MenuItem.new_with_label("Help me!"))
39 menu.show_all()
40
41 self.status_icon.set_secondary_menu(menu)
42
43 GLib.timeout_add_seconds(2, self.on_timeout_cb)
44
45 def on_icon_state_changed(self, icon, new_state):
46 print("Icon state changed - the state is now: %s" % new_state)
47
48 def on_timeout_cb(self):
49 self.counter += 1
50 self.status_icon.set_label("label %d" % self.counter)
51 return True
52
53 if __name__ == '__main__':
54 GLib.setenv ("G_MESSAGES_DEBUG", "all", True)
55 app = App()
56 try:
57 GLib.MainLoop().run()
58 except KeyboardInterrupt:
59 pass
60 sys.exit(0)
0 #!/usr/bin/python3
1
2 import gi
3 gi.require_version('XApp', '1.0')
4 from gi.repository import XApp, Gtk, Gdk
5 from gi.repository import GLib, GObject
6 import sys
7
8 """
9 This variant tests behavior of providing no menus to the StatusIcon instance.
10 This results in 'activate' signals being sent for all button presses.
11 """
12
13 class App(GObject.Object):
14
15 def __init__(self):
16 super(App, self).__init__()
17 self.status_icon = XApp.StatusIcon()
18 self.status_icon.connect("state-changed", self.on_icon_state_changed)
19
20 self.status_icon.set_icon_name("folder-symbolic")
21 self.status_icon.set_tooltip_text("Testing primary activate and secondary menu")
22 self.status_icon.set_label("label 1")
23 self.status_icon.set_visible(True)
24
25 self.counter = 1
26
27 self.status_icon.connect("activate", self.on_status_icon_activate)
28
29 GLib.timeout_add_seconds(2, self.on_timeout_cb)
30
31 def on_icon_state_changed(self, icon, new_state):
32 print("Icon state changed - the state is now: %s" % new_state)
33
34 def on_timeout_cb(self):
35 self.counter += 1
36 self.status_icon.set_label("label %d" % self.counter)
37 return True
38
39 def on_status_icon_activate(self, icon, button, time):
40 print("Activated via button %d" % button)
41 self.counter = 0
42 self.status_icon.set_label("label %d" % self.counter)
43
44 if __name__ == '__main__':
45 GLib.setenv ("G_MESSAGES_DEBUG", "all", True)
46 app = App()
47 try:
48 GLib.MainLoop().run()
49 except KeyboardInterrupt:
50 pass
51 sys.exit(0)
0 #!/usr/bin/python3
1
2 import gi
3 gi.require_version('XApp', '1.0')
4 from gi.repository import XApp, Gtk, Gdk
5 from gi.repository import GLib, GObject
6 import sys
7
8 """
9 This variant tests button-press-event and button-release-event with no menus assigned -
10 it must do all menu handling itself.
11 """
12
13 class App(GObject.Object):
14
15 def __init__(self):
16 super(App, self).__init__()
17 self.status_icon = XApp.StatusIcon()
18 self.status_icon.connect("state-changed", self.on_icon_state_changed)
19
20 self.status_icon.set_icon_name("folder-symbolic")
21 self.status_icon.set_tooltip_text("Testing raw button press and release events")
22 self.status_icon.set_label("label 1")
23 self.status_icon.set_visible(True)
24
25 self.counter = 1
26
27 self.menu = Gtk.Menu()
28 self.menu.append(Gtk.MenuItem.new_with_label("Engage the hyperdrive"))
29 self.menu.append(Gtk.SeparatorMenuItem())
30 self.menu.append(Gtk.MenuItem.new_with_label("It's a trap!"))
31 self.menu.show_all()
32
33 self.status_icon.connect("button-press-event", self.on_button_press)
34 self.status_icon.connect("button-release-event", self.on_button_release)
35
36 GLib.timeout_add_seconds(2, self.on_timeout_cb)
37
38 def on_icon_state_changed(self, icon, new_state):
39 print("Icon state changed - the state is now: %s" % new_state)
40
41 def on_timeout_cb(self):
42 self.counter += 1
43 self.status_icon.set_label("label %d" % self.counter)
44 return True
45
46 def on_button_press(self, status_icon, x, y, button, time, position_type):
47 print("Mouse button %d was pressed at %d %d" % (button, x, y))
48 self.counter = 0
49 self.status_icon.set_label("label %d" % self.counter)
50
51 def on_button_release(self, status_icon, x, y, button, time, position_type):
52 print("Mouse button %d was released at %d %d" % (button, x, y))
53 if button == 3:
54 def position_menu_cb(menu, pointer_x, pointer_y, user_data):
55 [x, y, position] = user_data;
56 if (position_type == Gtk.PositionType.BOTTOM):
57 y = y - menu.get_allocation().height;
58 if (position_type == Gtk.PositionType.RIGHT):
59 x = x - menu.get_allocation().width;
60 return (x, y, False)
61
62 device = Gdk.Display.get_default().get_device_manager().get_client_pointer()
63
64 self.menu.popup_for_device(device, None, None, position_menu_cb, [x, y, position_type], button, 0)
65
66 if __name__ == '__main__':
67 GLib.setenv ("G_MESSAGES_DEBUG", "all", True)
68 app = App()
69 try:
70 GLib.MainLoop().run()
71 except KeyboardInterrupt:
72 pass
73 sys.exit(0)
77 msgstr ""
88 "Project-Id-Version: PACKAGE VERSION\n"
99 "Report-Msgid-Bugs-To: \n"
10 "POT-Creation-Date: 2018-11-15 10:11+0000\n"
10 "POT-Creation-Date: 2019-11-12 11:04+0100\n"
1111 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1212 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
1313 "Language-Team: LANGUAGE <LL@li.org>\n"
1616 "Content-Type: text/plain; charset=CHARSET\n"
1717 "Content-Transfer-Encoding: 8bit\n"
1818
19 #: libxapp/xapp-icon-chooser-button.c:162
20 #: libxapp/xapp-icon-chooser-dialog.c:601
19 #: libxapp/xapp-icon-chooser-button.c:207
20 #: libxapp/xapp-icon-chooser-dialog.c:613
2121 msgid "Icon size"
2222 msgstr ""
2323
24 #: libxapp/xapp-icon-chooser-button.c:163
25 #: libxapp/xapp-icon-chooser-dialog.c:602
24 #: libxapp/xapp-icon-chooser-button.c:208
25 #: libxapp/xapp-icon-chooser-dialog.c:614
2626 msgid "The preferred icon size."
2727 msgstr ""
2828
29 #: libxapp/xapp-icon-chooser-button.c:177
29 #: libxapp/xapp-icon-chooser-button.c:222
3030 msgid "Icon"
3131 msgstr ""
3232
33 #: libxapp/xapp-icon-chooser-button.c:178
33 #: libxapp/xapp-icon-chooser-button.c:223
3434 msgid "The string representing the icon."
3535 msgstr ""
3636
37 #: libxapp/xapp-icon-chooser-dialog.c:93
37 #: libxapp/xapp-icon-chooser-button.c:234
38 msgid "Category"
39 msgstr ""
40
41 #: libxapp/xapp-icon-chooser-button.c:235
42 msgid "The default category."
43 msgstr ""
44
45 #: libxapp/xapp-icon-chooser-dialog.c:95
3846 msgid "Actions"
3947 msgstr ""
4048
41 #: libxapp/xapp-icon-chooser-dialog.c:96
49 #: libxapp/xapp-icon-chooser-dialog.c:98
4250 msgid "Applications"
4351 msgstr ""
4452
45 #: libxapp/xapp-icon-chooser-dialog.c:99
53 #: libxapp/xapp-icon-chooser-dialog.c:101
4654 msgid "Categories"
4755 msgstr ""
4856
49 #: libxapp/xapp-icon-chooser-dialog.c:102
57 #: libxapp/xapp-icon-chooser-dialog.c:104
5058 msgid "Devices"
5159 msgstr ""
5260
53 #: libxapp/xapp-icon-chooser-dialog.c:105
61 #: libxapp/xapp-icon-chooser-dialog.c:107
5462 msgid "Emblems"
5563 msgstr ""
5664
57 #: libxapp/xapp-icon-chooser-dialog.c:108
65 #: libxapp/xapp-icon-chooser-dialog.c:110
5866 msgid "Emoji"
5967 msgstr ""
6068
61 #: libxapp/xapp-icon-chooser-dialog.c:111
69 #: libxapp/xapp-icon-chooser-dialog.c:113
6270 msgid "Mime types"
6371 msgstr ""
6472
65 #: libxapp/xapp-icon-chooser-dialog.c:114
73 #: libxapp/xapp-icon-chooser-dialog.c:116
6674 msgid "Places"
6775 msgstr ""
6876
69 #: libxapp/xapp-icon-chooser-dialog.c:117
77 #: libxapp/xapp-icon-chooser-dialog.c:119
7078 msgid "Status"
7179 msgstr ""
7280
73 #: libxapp/xapp-icon-chooser-dialog.c:120
81 #: libxapp/xapp-icon-chooser-dialog.c:122
7482 msgid "Other"
7583 msgstr ""
7684
77 #: libxapp/xapp-icon-chooser-dialog.c:449
85 #: libxapp/xapp-icon-chooser-dialog.c:451
7886 msgid "Choose an icon"
7987 msgstr ""
8088
81 #: libxapp/xapp-icon-chooser-dialog.c:471
89 #: libxapp/xapp-icon-chooser-dialog.c:473
8290 msgid "Search"
8391 msgstr ""
8492
85 #: libxapp/xapp-icon-chooser-dialog.c:478
93 #: libxapp/xapp-icon-chooser-dialog.c:480
8694 msgid "Browse"
8795 msgstr ""
8896
89 #: libxapp/xapp-icon-chooser-dialog.c:534
97 #: libxapp/xapp-icon-chooser-dialog.c:536
9098 msgid "Loading..."
9199 msgstr ""
92100
93 #: libxapp/xapp-icon-chooser-dialog.c:558
101 #: libxapp/xapp-icon-chooser-dialog.c:560
102 msgid "Default"
103 msgstr ""
104
105 #: libxapp/xapp-icon-chooser-dialog.c:570
94106 msgid "Select"
95107 msgstr ""
96108
97 #: libxapp/xapp-icon-chooser-dialog.c:567
98 #: libxapp/xapp-icon-chooser-dialog.c:1787
109 #: libxapp/xapp-icon-chooser-dialog.c:579
110 #: libxapp/xapp-icon-chooser-dialog.c:1937
99111 msgid "Cancel"
100112 msgstr ""
101113
102 #: libxapp/xapp-icon-chooser-dialog.c:614
114 #: libxapp/xapp-icon-chooser-dialog.c:626
103115 msgid "Allow Paths"
104116 msgstr ""
105117
106 #: libxapp/xapp-icon-chooser-dialog.c:615
118 #: libxapp/xapp-icon-chooser-dialog.c:627
107119 msgid "Whether to allow paths."
108120 msgstr ""
109121
110 #: libxapp/xapp-icon-chooser-dialog.c:1784
122 #: libxapp/xapp-icon-chooser-dialog.c:638
123 msgid "Default Icon"
124 msgstr ""
125
126 #: libxapp/xapp-icon-chooser-dialog.c:639
127 msgid "The icon to use by default"
128 msgstr ""
129
130 #: libxapp/xapp-icon-chooser-dialog.c:1934
111131 msgid "Select image file"
112132 msgstr ""
113133
114 #: libxapp/xapp-icon-chooser-dialog.c:1789
134 #: libxapp/xapp-icon-chooser-dialog.c:1939
115135 msgid "Open"
116136 msgstr ""
117137
118 #: libxapp/xapp-icon-chooser-dialog.c:1804
138 #: libxapp/xapp-icon-chooser-dialog.c:1954
119139 msgid "Image"
120140 msgstr ""
141
142 #: status-applets/mate/mate-xapp-status-applet.py:260
143 msgid "About"
144 msgstr ""
145
146 #: status-applets/mate/mate-xapp-status-applet.py:280
147 #: status-applets/mate/org.x.MateXAppStatusApplet.mate-panel-applet.in:7
148 #: status-applets/mate/org.x.MateXAppStatusApplet.mate-panel-applet.in:11
149 msgid "Area where XApp status icons appear"
150 msgstr ""
151
152 #: status-applets/mate/org.x.MateXAppStatusApplet.mate-panel-applet.in:6
153 msgid "XApp Status Applet Factory"
154 msgstr ""
155
156 #: status-applets/mate/org.x.MateXAppStatusApplet.mate-panel-applet.in:10
157 msgid "XApp Status Applet"
158 msgstr ""