43
43
<a name="BamfMatcher.synopsis"></a><h2>Synopsis</h2>
44
44
<pre class="synopsis">struct <a class="link" href="BamfMatcher.html#BamfMatcher-struct" title="struct BamfMatcher">BamfMatcher</a>;
45
45
struct <a class="link" href="BamfMatcher.html#BamfMatcherClass" title="struct BamfMatcherClass">BamfMatcherClass</a>;
46
<a class="link" href="BamfMatcher.html#BamfMatcherPrivate" title="BamfMatcherPrivate">BamfMatcherPrivate</a>;
46
47
<a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="returnvalue">BamfMatcher</span></a> * <a class="link" href="BamfMatcher.html#bamf-matcher-get-default" title="bamf_matcher_get_default ()">bamf_matcher_get_default</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
47
48
<a class="link" href="BamfApplication.html" title="BamfApplication"><span class="returnvalue">BamfApplication</span></a> * <a class="link" href="BamfMatcher.html#bamf-matcher-get-active-application" title="bamf_matcher_get_active_application ()">bamf_matcher_get_active_application</a> (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>);
48
49
<a class="link" href="BamfWindow.html" title="BamfWindow"><span class="returnvalue">BamfWindow</span></a> * <a class="link" href="BamfMatcher.html#bamf-matcher-get-active-window" title="bamf_matcher_get_active_window ()">bamf_matcher_get_active_window</a> (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>);
52
53
<a class="link" href="BamfApplication.html" title="BamfApplication"><span class="returnvalue">BamfApplication</span></a> * <a class="link" href="BamfMatcher.html#bamf-matcher-get-application-for-window" title="bamf_matcher_get_application_for_window ()">bamf_matcher_get_application_for_window</a>
53
54
(<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>,
54
55
<em class="parameter"><code><a class="link" href="BamfWindow.html" title="BamfWindow"><span class="type">BamfWindow</span></a> *window</code></em>);
55
<span class="returnvalue">gboolean</span> <a class="link" href="BamfMatcher.html#bamf-matcher-application-is-running" title="bamf_matcher_application_is_running ()">bamf_matcher_application_is_running</a> (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>,
56
<em class="parameter"><code>const <span class="type">gchar</span> *application</code></em>);
57
<span class="returnvalue">GList</span> * <a class="link" href="BamfMatcher.html#bamf-matcher-get-applications" title="bamf_matcher_get_applications ()">bamf_matcher_get_applications</a> (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>);
56
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="BamfMatcher.html#bamf-matcher-application-is-running" title="bamf_matcher_application_is_running ()">bamf_matcher_application_is_running</a> (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>,
57
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *application</code></em>);
58
<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * <a class="link" href="BamfMatcher.html#bamf-matcher-get-applications" title="bamf_matcher_get_applications ()">bamf_matcher_get_applications</a> (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>);
58
59
<span class="returnvalue">void</span> <a class="link" href="BamfMatcher.html#bamf-matcher-register-favorites" title="bamf_matcher_register_favorites ()">bamf_matcher_register_favorites</a> (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>,
59
<em class="parameter"><code>const <span class="type">gchar</span> **favorites</code></em>);
60
<span class="returnvalue">GList</span> * <a class="link" href="BamfMatcher.html#bamf-matcher-get-running-applications" title="bamf_matcher_get_running_applications ()">bamf_matcher_get_running_applications</a>
60
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **favorites</code></em>);
61
<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * <a class="link" href="BamfMatcher.html#bamf-matcher-get-running-applications" title="bamf_matcher_get_running_applications ()">bamf_matcher_get_running_applications</a>
61
62
(<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>);
62
<span class="returnvalue">GList</span> * <a class="link" href="BamfMatcher.html#bamf-matcher-get-tabs" title="bamf_matcher_get_tabs ()">bamf_matcher_get_tabs</a> (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>);
63
<span class="returnvalue">GArray</span> * <a class="link" href="BamfMatcher.html#bamf-matcher-get-xids-for-application" title="bamf_matcher_get_xids_for_application ()">bamf_matcher_get_xids_for_application</a>
63
<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * <a class="link" href="BamfMatcher.html#bamf-matcher-get-tabs" title="bamf_matcher_get_tabs ()">bamf_matcher_get_tabs</a> (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>);
64
<a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> * <a class="link" href="BamfMatcher.html#bamf-matcher-get-xids-for-application" title="bamf_matcher_get_xids_for_application ()">bamf_matcher_get_xids_for_application</a>
64
65
(<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>,
65
<em class="parameter"><code>const <span class="type">gchar</span> *application</code></em>);
66
<span class="returnvalue">GList</span> * <a class="link" href="BamfMatcher.html#bamf-matcher-get-windows" title="bamf_matcher_get_windows ()">bamf_matcher_get_windows</a> (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>);
66
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *application</code></em>);
67
<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * <a class="link" href="BamfMatcher.html#bamf-matcher-get-windows" title="bamf_matcher_get_windows ()">bamf_matcher_get_windows</a> (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>);
67
68
<a class="link" href="BamfApplication.html" title="BamfApplication"><span class="returnvalue">BamfApplication</span></a> * <a class="link" href="BamfMatcher.html#bamf-matcher-get-application-for-desktop-file" title="bamf_matcher_get_application_for_desktop_file ()">bamf_matcher_get_application_for_desktop_file</a>
68
69
(<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>,
69
<em class="parameter"><code>const <span class="type">gchar</span> *desktop_file_path</code></em>,
70
<em class="parameter"><code><span class="type">gboolean</span> create_if_not_found</code></em>);
71
<a class="link" href="BamfMatcher.html#BamfMatcherPrivate" title="BamfMatcherPrivate">BamfMatcherPrivate</a>;
70
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *desktop_file_path</code></em>,
71
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> create_if_not_found</code></em>);
74
74
<div class="refsect1">
75
75
<a name="BamfMatcher.object-hierarchy"></a><h2>Object Hierarchy</h2>
76
76
<pre class="synopsis">
77
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
235
242
<div class="refsect2">
236
243
<a name="bamf-matcher-application-is-running"></a><h3>bamf_matcher_application_is_running ()</h3>
237
<pre class="programlisting"><span class="returnvalue">gboolean</span> bamf_matcher_application_is_running (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>,
238
<em class="parameter"><code>const <span class="type">gchar</span> *application</code></em>);</pre>
244
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> bamf_matcher_application_is_running (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>,
245
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *application</code></em>);</pre>
243
250
<div class="refsect2">
244
251
<a name="bamf-matcher-get-applications"></a><h3>bamf_matcher_get_applications ()</h3>
245
<pre class="programlisting"><span class="returnvalue">GList</span> * bamf_matcher_get_applications (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>);</pre>
252
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * bamf_matcher_get_applications (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>);</pre>
247
254
Used to fetch all xid's associated with an application. Useful for performing window
266
273
<div class="refsect2">
267
274
<a name="bamf-matcher-register-favorites"></a><h3>bamf_matcher_register_favorites ()</h3>
268
275
<pre class="programlisting"><span class="returnvalue">void</span> bamf_matcher_register_favorites (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>,
269
<em class="parameter"><code>const <span class="type">gchar</span> **favorites</code></em>);</pre>
276
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **favorites</code></em>);</pre>
271
278
Used to effect how bamf performs matching. Desktop files passed to this method will
272
279
be prefered by bamf to system desktop files.
337
344
<div class="refsect2">
338
345
<a name="bamf-matcher-get-xids-for-application"></a><h3>bamf_matcher_get_xids_for_application ()</h3>
339
<pre class="programlisting"><span class="returnvalue">GArray</span> * bamf_matcher_get_xids_for_application
346
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> * bamf_matcher_get_xids_for_application
340
347
(<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>,
341
<em class="parameter"><code>const <span class="type">gchar</span> *application</code></em>);</pre>
348
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *application</code></em>);</pre>
346
353
<div class="refsect2">
347
354
<a name="bamf-matcher-get-windows"></a><h3>bamf_matcher_get_windows ()</h3>
348
<pre class="programlisting"><span class="returnvalue">GList</span> * bamf_matcher_get_windows (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>);</pre>
355
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * bamf_matcher_get_windows (<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>);</pre>
350
357
Used to fetch all windows that BAMF knows about.
370
377
<a name="bamf-matcher-get-application-for-desktop-file"></a><h3>bamf_matcher_get_application_for_desktop_file ()</h3>
371
378
<pre class="programlisting"><a class="link" href="BamfApplication.html" title="BamfApplication"><span class="returnvalue">BamfApplication</span></a> * bamf_matcher_get_application_for_desktop_file
372
379
(<em class="parameter"><code><a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *matcher</code></em>,
373
<em class="parameter"><code>const <span class="type">gchar</span> *desktop_file_path</code></em>,
374
<em class="parameter"><code><span class="type">gboolean</span> create_if_not_found</code></em>);</pre>
379
<div class="refsect2">
380
<a name="BamfMatcherPrivate"></a><h3>BamfMatcherPrivate</h3>
381
<pre class="programlisting">typedef struct _BamfMatcherPrivate BamfMatcherPrivate;</pre>
380
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *desktop_file_path</code></em>,
381
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> create_if_not_found</code></em>);</pre>
388
388
<div class="refsect2">
389
389
<a name="BamfMatcher-active-application-changed"></a><h3>The <code class="literal">"active-application-changed"</code> signal</h3>
390
390
<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *bamfmatcher,
391
<span class="type">GObject</span> *arg1,
392
<span class="type">GObject</span> *arg2,
393
<span class="type">gpointer</span> user_data)</pre>
391
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *arg1,
392
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *arg2,
393
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
396
396
<div class="variablelist"><table border="0">
411
411
<div class="refsect2">
412
412
<a name="BamfMatcher-active-window-changed"></a><h3>The <code class="literal">"active-window-changed"</code> signal</h3>
413
413
<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *bamfmatcher,
414
<span class="type">GObject</span> *arg1,
415
<span class="type">GObject</span> *arg2,
416
<span class="type">gpointer</span> user_data)</pre>
414
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *arg1,
415
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *arg2,
416
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
419
419
<div class="variablelist"><table border="0">
434
434
<div class="refsect2">
435
435
<a name="BamfMatcher-view-closed"></a><h3>The <code class="literal">"view-closed"</code> signal</h3>
436
436
<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *bamfmatcher,
437
<span class="type">GObject</span> *arg1,
438
<span class="type">gpointer</span> user_data)</pre>
437
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *arg1,
438
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
441
441
<div class="variablelist"><table border="0">
456
456
<div class="refsect2">
457
457
<a name="BamfMatcher-view-opened"></a><h3>The <code class="literal">"view-opened"</code> signal</h3>
458
458
<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="BamfMatcher.html" title="BamfMatcher"><span class="type">BamfMatcher</span></a> *bamfmatcher,
459
<span class="type">GObject</span> *arg1,
460
<span class="type">gpointer</span> user_data)</pre>
459
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *arg1,
460
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
463
463
<div class="variablelist"><table border="0">