← Back to branch summary

~ubuntu-branches/ubuntu/natty/gedit/natty

« back to all changes in this revision

Viewing changes to docs/reference/html/GeditMessageBus.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-06-21 15:14:19 UTC
  • mfrom: (1.1.80 upstream)
  • Revision ID: james.westby@ubuntu.com-20100621151419-j79nqokj12vpw9u3
Tags: 2.30.3-0ubuntu1
https://launchpad.net/bugs/586848
* New upstream version
  - Misc bugfixes
  - Handle empty input gracefully (lp: #586848)
  - Translations update

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/html/GeditMessageBus.html
47
47
                    <a class="link" href="GeditMessageBus.html#GeditMessageBus-struct" title="GeditMessageBus">GeditMessageBus</a>;
48
48
<span class="returnvalue">void</span>                (<a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()">*GeditMessageCallback</a>)             (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
49
49
                                                         <em class="parameter"><code><a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a> *message</code></em>,
50
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);
 
50
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);
51
51
<a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="returnvalue">GeditMessageBus</span></a> *   <a class="link" href="GeditMessageBus.html#gedit-message-bus-get-default" title="gedit_message_bus_get_default ()">gedit_message_bus_get_default</a>       (<em class="parameter"><code><span class="type">void</span></code></em>);
52
52
<a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="returnvalue">GeditMessageBus</span></a> *   <a class="link" href="GeditMessageBus.html#gedit-message-bus-new" title="gedit_message_bus_new ()">gedit_message_bus_new</a>               (<em class="parameter"><code><span class="type">void</span></code></em>);
53
53
<a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="returnvalue">GeditMessageType</span></a> *  <a class="link" href="GeditMessageBus.html#gedit-message-bus-lookup" title="gedit_message_bus_lookup ()">gedit_message_bus_lookup</a>            (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
54
 
                                                         <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> *object_path</code></em>,
55
 
                                                         <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> *method</code></em>);
 
54
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
55
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>);
56
56
<a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="returnvalue">GeditMessageType</span></a> *  <a class="link" href="GeditMessageBus.html#gedit-message-bus-register" title="gedit_message_bus_register ()">gedit_message_bus_register</a>          (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</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> *object_path</code></em>,
58
 
                                                         <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> *method</code></em>,
59
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> num_optional</code></em>,
 
57
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
58
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>,
 
59
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> num_optional</code></em>,
60
60
                                                         <em class="parameter"><code>...</code></em>);
61
61
<span class="returnvalue">void</span>                <a class="link" href="GeditMessageBus.html#gedit-message-bus-unregister" title="gedit_message_bus_unregister ()">gedit_message_bus_unregister</a>        (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
62
62
                                                         <em class="parameter"><code><a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a> *message_type</code></em>);
63
63
<span class="returnvalue">void</span>                <a class="link" href="GeditMessageBus.html#gedit-message-bus-unregister-all" title="gedit_message_bus_unregister_all ()">gedit_message_bus_unregister_all</a>    (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
64
 
                                                         <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> *object_path</code></em>);
65
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GeditMessageBus.html#gedit-message-bus-is-registered" title="gedit_message_bus_is_registered ()">gedit_message_bus_is_registered</a>     (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</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> *object_path</code></em>,
67
 
                                                         <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> *method</code></em>);
 
64
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>);
 
65
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GeditMessageBus.html#gedit-message-bus-is-registered" title="gedit_message_bus_is_registered ()">gedit_message_bus_is_registered</a>     (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
 
66
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
67
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>);
68
68
<span class="returnvalue">void</span>                <a class="link" href="GeditMessageBus.html#gedit-message-bus-foreach" title="gedit_message_bus_foreach ()">gedit_message_bus_foreach</a>           (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
69
69
                                                         <em class="parameter"><code><span class="type">GeditMessageBusForeach</span> func</code></em>,
70
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);
71
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="GeditMessageBus.html#gedit-message-bus-connect" title="gedit_message_bus_connect ()">gedit_message_bus_connect</a>           (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
72
 
                                                         <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> *object_path</code></em>,
73
 
                                                         <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> *method</code></em>,
 
70
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);
 
71
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="GeditMessageBus.html#gedit-message-bus-connect" title="gedit_message_bus_connect ()">gedit_message_bus_connect</a>           (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
 
72
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
73
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>,
74
74
                                                         <em class="parameter"><code><a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()"><span class="type">GeditMessageCallback</span></a> callback</code></em>,
75
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>,
76
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy_data</code></em>);
 
75
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>,
 
76
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy_data</code></em>);
77
77
<span class="returnvalue">void</span>                <a class="link" href="GeditMessageBus.html#gedit-message-bus-disconnect" title="gedit_message_bus_disconnect ()">gedit_message_bus_disconnect</a>        (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
78
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> id</code></em>);
 
78
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> id</code></em>);
79
79
<span class="returnvalue">void</span>                <a class="link" href="GeditMessageBus.html#gedit-message-bus-disconnect-by-func" title="gedit_message_bus_disconnect_by_func ()">gedit_message_bus_disconnect_by_func</a>
80
80
                                                        (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
81
 
                                                         <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> *object_path</code></em>,
82
 
                                                         <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> *method</code></em>,
 
81
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
82
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>,
83
83
                                                         <em class="parameter"><code><a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()"><span class="type">GeditMessageCallback</span></a> callback</code></em>,
84
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);
 
84
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);
85
85
<span class="returnvalue">void</span>                <a class="link" href="GeditMessageBus.html#gedit-message-bus-block" title="gedit_message_bus_block ()">gedit_message_bus_block</a>             (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
86
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> id</code></em>);
 
86
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> id</code></em>);
87
87
<span class="returnvalue">void</span>                <a class="link" href="GeditMessageBus.html#gedit-message-bus-block-by-func" title="gedit_message_bus_block_by_func ()">gedit_message_bus_block_by_func</a>     (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
88
 
                                                         <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> *object_path</code></em>,
89
 
                                                         <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> *method</code></em>,
 
88
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
89
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>,
90
90
                                                         <em class="parameter"><code><a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()"><span class="type">GeditMessageCallback</span></a> callback</code></em>,
91
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);
 
91
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);
92
92
<span class="returnvalue">void</span>                <a class="link" href="GeditMessageBus.html#gedit-message-bus-unblock" title="gedit_message_bus_unblock ()">gedit_message_bus_unblock</a>           (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
93
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> id</code></em>);
 
93
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> id</code></em>);
94
94
<span class="returnvalue">void</span>                <a class="link" href="GeditMessageBus.html#gedit-message-bus-unblock-by-func" title="gedit_message_bus_unblock_by_func ()">gedit_message_bus_unblock_by_func</a>   (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
95
 
                                                         <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> *object_path</code></em>,
96
 
                                                         <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> *method</code></em>,
 
95
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
96
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>,
97
97
                                                         <em class="parameter"><code><a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()"><span class="type">GeditMessageCallback</span></a> callback</code></em>,
98
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);
 
98
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);
99
99
<span class="returnvalue">void</span>                <a class="link" href="GeditMessageBus.html#gedit-message-bus-send-message" title="gedit_message_bus_send_message ()">gedit_message_bus_send_message</a>      (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
100
100
                                                         <em class="parameter"><code><a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a> *message</code></em>);
101
101
<span class="returnvalue">void</span>                <a class="link" href="GeditMessageBus.html#gedit-message-bus-send-message-sync" title="gedit_message_bus_send_message_sync ()">gedit_message_bus_send_message_sync</a> (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
102
102
                                                         <em class="parameter"><code><a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a> *message</code></em>);
103
103
<span class="returnvalue">void</span>                <a class="link" href="GeditMessageBus.html#gedit-message-bus-send" title="gedit_message_bus_send ()">gedit_message_bus_send</a>              (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
104
 
                                                         <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> *object_path</code></em>,
105
 
                                                         <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> *method</code></em>,
 
104
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
105
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>,
106
106
                                                         <em class="parameter"><code>...</code></em>);
107
107
<a class="link" href="GeditMessage.html" title="GeditMessage"><span class="returnvalue">GeditMessage</span></a> *      <a class="link" href="GeditMessageBus.html#gedit-message-bus-send-sync" title="gedit_message_bus_send_sync ()">gedit_message_bus_send_sync</a>         (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
108
 
                                                         <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> *object_path</code></em>,
109
 
                                                         <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> *method</code></em>,
 
108
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
109
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>,
110
110
                                                         <em class="parameter"><code>...</code></em>);
111
111
</pre>
112
112
</div>
113
113
<div class="refsect1" title="Object Hierarchy">
114
114
<a name="GeditMessageBus.object-hierarchy"></a><h2>Object Hierarchy</h2>
115
115
<pre class="synopsis">
116
 
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
116
  <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
117
117
   +----GeditMessageBus
118
118
</pre>
119
119
</div>
152
152
<p>
153
153
</p>
154
154
<div class="example">
155
 
<a name="id601020"></a><p class="title"><b>Example 1. Registering a message type</b></p>
 
155
<a name="id600882"></a><p class="title"><b>Example 1. Registering a message type</b></p>
156
156
<div class="example-contents">
157
157
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
158
158
    <tbody>
171
171
<span class="comment">// string argument 'arg1'</span>
172
172
<span class="normal"><a href="gedit-GeditMessageType.html#GeditMessageType">GeditMessageType</a> </span><span class="symbol">*</span><span class="normal">message_type </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GeditMessageBus.html#gedit-message-bus-register">gedit_message_bus_register</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"/plugins/example"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"method"</span><span class="symbol">,</span><span class="normal"> </span>
173
173
<span class="normal">                                                             </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span>
174
 
<span class="normal">                                                             </span><span class="string">"arg1"</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-STRING:CAPS">G_TYPE_STRING</a></span><span class="symbol">,</span>
175
 
<span class="normal">                                                             <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
 
174
<span class="normal">                                                             </span><span class="string">"arg1"</span><span class="symbol">,</span><span class="normal"> <a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#G-TYPE-STRING:CAPS">G_TYPE_STRING</a></span><span class="symbol">,</span>
 
175
<span class="normal">                                                             <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
176
176
      </tr>
177
177
    </tbody>
178
178
  </table>
182
182
<p><br class="example-break">
183
183
</p>
184
184
<div class="example">
185
 
<a name="id601037"></a><p class="title"><b>Example 2. Connecting a callback</b></p>
 
185
<a name="id600899"></a><p class="title"><b>Example 2. Connecting a callback</b></p>
186
186
<div class="example-contents">
187
187
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
188
188
    <tbody>
209
209
        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
210
210
<span class="function">example_method_cb</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="GeditMessageBus.html">GeditMessageBus</a> </span><span class="symbol">*</span><span class="normal">bus</span><span class="symbol">,</span>
211
211
<span class="normal">                   <a href="GeditMessage.html">GeditMessage</a>    </span><span class="symbol">*</span><span class="normal">message</span><span class="symbol">,</span>
212
 
<span class="normal">                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a>         userdata</span><span class="symbol">)</span>
 
212
<span class="normal">                   <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a>         userdata</span><span class="symbol">)</span>
213
213
<span class="cbracket">{</span>
214
 
<span class="normal">   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> </span><span class="symbol">*</span><span class="normal">arg1 </span><span class="symbol">=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
 
214
<span class="normal">   <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> </span><span class="symbol">*</span><span class="normal">arg1 </span><span class="symbol">=</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
215
215
 
216
 
<span class="normal">   </span><span class="function"><a href="GeditMessage.html#gedit-message-get">gedit_message_get</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">message</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"arg1"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">arg1</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
217
 
<span class="normal">   </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#g-message">g_message</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Evoked /plugins/example.method with: %s"</span><span class="symbol">,</span><span class="normal"> arg1</span><span class="symbol">);</span>
218
 
<span class="normal">   </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">arg1</span><span class="symbol">);</span>
 
216
<span class="normal">   </span><span class="function"><a href="GeditMessage.html#gedit-message-get">gedit_message_get</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">message</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"arg1"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">arg1</span><span class="symbol">,</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 
217
<span class="normal">   </span><span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-Message-Logging.html#g-message">g_message</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Evoked /plugins/example.method with: %s"</span><span class="symbol">,</span><span class="normal"> arg1</span><span class="symbol">);</span>
 
218
<span class="normal">   </span><span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">arg1</span><span class="symbol">);</span>
219
219
<span class="cbracket">}</span>
220
220
 
221
221
<span class="normal"><a href="GeditMessageBus.html">GeditMessageBus</a> </span><span class="symbol">*</span><span class="normal">bus </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GeditMessageBus.html#gedit-message-bus-get-default">gedit_message_bus_get_default</a></span><span class="normal"> </span><span class="symbol">();</span>
222
222
 
223
 
<span class="normal"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> id </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GeditMessageBus.html#gedit-message-bus-connect">gedit_message_bus_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">bus</span><span class="symbol">,</span><span class="normal"> </span>
 
223
<span class="normal"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint">guint</a> id </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GeditMessageBus.html#gedit-message-bus-connect">gedit_message_bus_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">bus</span><span class="symbol">,</span><span class="normal"> </span>
224
224
<span class="normal">                                      </span><span class="string">"/plugins/example"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"method"</span><span class="symbol">,</span>
225
225
<span class="normal">                                      example_method_cb</span><span class="symbol">,</span>
226
 
<span class="normal">                                      <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span>
227
 
<span class="normal">                                      <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
 
226
<span class="normal">                                      <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span>
 
227
<span class="normal">                                      <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
228
228
      </tr>
229
229
    </tbody>
230
230
  </table>
234
234
<p><br class="example-break">
235
235
</p>
236
236
<div class="example">
237
 
<a name="id601056"></a><p class="title"><b>Example 3. Sending a message</b></p>
 
237
<a name="id600918"></a><p class="title"><b>Example 3. Sending a message</b></p>
238
238
<div class="example-contents">
239
239
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
240
240
    <tbody>
265
265
<div class="refsect2" title="GeditMessageBus">
266
266
<a name="GeditMessageBus-struct"></a><h3>GeditMessageBus</h3>
267
267
<pre class="programlisting">typedef struct _GeditMessageBus GeditMessageBus;</pre>
268
 
<p>
269
 
</p>
270
268
</div>
271
269
<hr>
272
270
<div class="refsect2" title="GeditMessageCallback ()">
273
271
<a name="GeditMessageCallback"></a><h3>GeditMessageCallback ()</h3>
274
272
<pre class="programlisting"><span class="returnvalue">void</span>                (*GeditMessageCallback)             (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
275
273
                                                         <em class="parameter"><code><a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a> *message</code></em>,
276
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);</pre>
 
274
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);</pre>
277
275
<p>
278
276
Callback signature used for connecting callback functions to be called
279
277
when a message is received (see <a class="link" href="GeditMessageBus.html#gedit-message-bus-connect" title="gedit_message_bus_connect ()"><code class="function">gedit_message_bus_connect()</code></a>).
339
337
<div class="refsect2" title="gedit_message_bus_lookup ()">
340
338
<a name="gedit-message-bus-lookup"></a><h3>gedit_message_bus_lookup ()</h3>
341
339
<pre class="programlisting"><a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="returnvalue">GeditMessageType</span></a> *  gedit_message_bus_lookup            (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
342
 
                                                         <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> *object_path</code></em>,
343
 
                                                         <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> *method</code></em>);</pre>
 
340
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
341
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>);</pre>
344
342
<p>
345
343
Get the registered <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a> for <em class="parameter"><code>method</code></em> at <em class="parameter"><code>object_path</code></em>. The 
346
344
returned <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a> is owned by the bus and should not be unreffed.
365
363
</tr>
366
364
<tr>
367
365
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
368
 
<td> the registered <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no message type
 
366
<td> the registered <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a> or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no message type
369
367
              is registered for <em class="parameter"><code>method</code></em> at <em class="parameter"><code>object_path</code></em>
370
368
 
371
369
</td>
377
375
<div class="refsect2" title="gedit_message_bus_register ()">
378
376
<a name="gedit-message-bus-register"></a><h3>gedit_message_bus_register ()</h3>
379
377
<pre class="programlisting"><a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="returnvalue">GeditMessageType</span></a> *  gedit_message_bus_register          (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
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> *object_path</code></em>,
381
 
                                                         <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> *method</code></em>,
382
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> num_optional</code></em>,
 
378
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
379
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>,
 
380
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> num_optional</code></em>,
383
381
                                                         <em class="parameter"><code>...</code></em>);</pre>
384
382
<p>
385
383
Register a message on the bus. A message must be registered on the bus before
386
384
it can be send. This function registers the type arguments for <em class="parameter"><code>method</code></em> at 
387
385
<em class="parameter"><code>object_path</code></em>. The arguments are specified with the variable arguments which 
388
 
should contain pairs of const gchar *key and GType terminated by <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. The 
 
386
should contain pairs of const gchar *key and GType terminated by <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. The 
389
387
last <em class="parameter"><code>num_optional</code></em> arguments are registered as optional (and are thus not
390
388
required when sending a message).
391
389
</p>
463
461
<div class="refsect2" title="gedit_message_bus_unregister_all ()">
464
462
<a name="gedit-message-bus-unregister-all"></a><h3>gedit_message_bus_unregister_all ()</h3>
465
463
<pre class="programlisting"><span class="returnvalue">void</span>                gedit_message_bus_unregister_all    (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
466
 
                                                         <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> *object_path</code></em>);</pre>
 
464
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>);</pre>
467
465
<p>
468
466
Unregisters all message types for <em class="parameter"><code>object_path</code></em>. This is especially useful for
469
467
plugins which should unregister message types when they are deactivated.
491
489
<hr>
492
490
<div class="refsect2" title="gedit_message_bus_is_registered ()">
493
491
<a name="gedit-message-bus-is-registered"></a><h3>gedit_message_bus_is_registered ()</h3>
494
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gedit_message_bus_is_registered     (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
495
 
                                                         <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> *object_path</code></em>,
496
 
                                                         <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> *method</code></em>);</pre>
 
492
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gedit_message_bus_is_registered     (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
 
493
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
494
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>);</pre>
497
495
<p>
498
496
Check whether a message type <em class="parameter"><code>method</code></em> at <em class="parameter"><code>object_path</code></em> is registered on the 
499
497
bus.
518
516
</tr>
519
517
<tr>
520
518
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
521
 
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>method</code></em> at <em class="parameter"><code>object_path</code></em> is a registered message 
 
519
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>method</code></em> at <em class="parameter"><code>object_path</code></em> is a registered message 
522
520
              type on the bus
523
521
 
524
522
</td>
531
529
<a name="gedit-message-bus-foreach"></a><h3>gedit_message_bus_foreach ()</h3>
532
530
<pre class="programlisting"><span class="returnvalue">void</span>                gedit_message_bus_foreach           (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
533
531
                                                         <em class="parameter"><code><span class="type">GeditMessageBusForeach</span> func</code></em>,
534
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);</pre>
 
532
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);</pre>
535
533
<p>
536
534
Calls <em class="parameter"><code>func</code></em> for each message type registered on the bus
537
535
</p>
559
557
<hr>
560
558
<div class="refsect2" title="gedit_message_bus_connect ()">
561
559
<a name="gedit-message-bus-connect"></a><h3>gedit_message_bus_connect ()</h3>
562
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gedit_message_bus_connect           (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
563
 
                                                         <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> *object_path</code></em>,
564
 
                                                         <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> *method</code></em>,
 
560
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gedit_message_bus_connect           (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
 
561
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
562
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>,
565
563
                                                         <em class="parameter"><code><a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()"><span class="type">GeditMessageCallback</span></a> callback</code></em>,
566
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>,
567
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy_data</code></em>);</pre>
 
564
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>,
 
565
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy_data</code></em>);</pre>
568
566
<p>
569
567
Connect a callback handler to be evoked when message <em class="parameter"><code>method</code></em> at <em class="parameter"><code>object_path</code></em>
570
568
is sent over the bus.
616
614
<div class="refsect2" title="gedit_message_bus_disconnect ()">
617
615
<a name="gedit-message-bus-disconnect"></a><h3>gedit_message_bus_disconnect ()</h3>
618
616
<pre class="programlisting"><span class="returnvalue">void</span>                gedit_message_bus_disconnect        (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
619
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> id</code></em>);</pre>
 
617
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> id</code></em>);</pre>
620
618
<p>
621
619
Disconnects a previously connected message callback.
622
620
</p>
641
639
<a name="gedit-message-bus-disconnect-by-func"></a><h3>gedit_message_bus_disconnect_by_func ()</h3>
642
640
<pre class="programlisting"><span class="returnvalue">void</span>                gedit_message_bus_disconnect_by_func
643
641
                                                        (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
644
 
                                                         <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> *object_path</code></em>,
645
 
                                                         <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> *method</code></em>,
 
642
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
643
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>,
646
644
                                                         <em class="parameter"><code><a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()"><span class="type">GeditMessageCallback</span></a> callback</code></em>,
647
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);</pre>
 
645
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);</pre>
648
646
<p>
649
647
Disconnects a previously connected message callback by matching the 
650
648
provided callback function and userdata. See also 
685
683
<div class="refsect2" title="gedit_message_bus_block ()">
686
684
<a name="gedit-message-bus-block"></a><h3>gedit_message_bus_block ()</h3>
687
685
<pre class="programlisting"><span class="returnvalue">void</span>                gedit_message_bus_block             (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
688
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> id</code></em>);</pre>
 
686
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> id</code></em>);</pre>
689
687
<p>
690
688
Blocks evoking the callback specified by <em class="parameter"><code>id</code></em>. Unblock the callback by
691
689
using <a class="link" href="GeditMessageBus.html#gedit-message-bus-unblock" title="gedit_message_bus_unblock ()"><code class="function">gedit_message_bus_unblock()</code></a>.
710
708
<div class="refsect2" title="gedit_message_bus_block_by_func ()">
711
709
<a name="gedit-message-bus-block-by-func"></a><h3>gedit_message_bus_block_by_func ()</h3>
712
710
<pre class="programlisting"><span class="returnvalue">void</span>                gedit_message_bus_block_by_func     (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
713
 
                                                         <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> *object_path</code></em>,
714
 
                                                         <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> *method</code></em>,
 
711
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
712
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>,
715
713
                                                         <em class="parameter"><code><a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()"><span class="type">GeditMessageCallback</span></a> callback</code></em>,
716
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);</pre>
 
714
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);</pre>
717
715
<p>
718
716
Blocks evoking the callback that matches provided <em class="parameter"><code>callback</code></em> and <em class="parameter"><code>userdata</code></em>.
719
717
Unblock the callback using <code class="function">gedit_message_unblock_by_func()</code>.
753
751
<div class="refsect2" title="gedit_message_bus_unblock ()">
754
752
<a name="gedit-message-bus-unblock"></a><h3>gedit_message_bus_unblock ()</h3>
755
753
<pre class="programlisting"><span class="returnvalue">void</span>                gedit_message_bus_unblock           (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
756
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> id</code></em>);</pre>
 
754
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> id</code></em>);</pre>
757
755
<p>
758
756
Unblocks the callback specified by <em class="parameter"><code>id</code></em>.
759
757
</p>
777
775
<div class="refsect2" title="gedit_message_bus_unblock_by_func ()">
778
776
<a name="gedit-message-bus-unblock-by-func"></a><h3>gedit_message_bus_unblock_by_func ()</h3>
779
777
<pre class="programlisting"><span class="returnvalue">void</span>                gedit_message_bus_unblock_by_func   (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
780
 
                                                         <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> *object_path</code></em>,
781
 
                                                         <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> *method</code></em>,
 
778
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
779
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>,
782
780
                                                         <em class="parameter"><code><a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()"><span class="type">GeditMessageCallback</span></a> callback</code></em>,
783
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);</pre>
 
781
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> userdata</code></em>);</pre>
784
782
<p>
785
783
Unblocks the callback that matches provided <em class="parameter"><code>callback</code></em> and <em class="parameter"><code>userdata</code></em>.
786
784
</p>
873
871
<div class="refsect2" title="gedit_message_bus_send ()">
874
872
<a name="gedit-message-bus-send"></a><h3>gedit_message_bus_send ()</h3>
875
873
<pre class="programlisting"><span class="returnvalue">void</span>                gedit_message_bus_send              (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
876
 
                                                         <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> *object_path</code></em>,
877
 
                                                         <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> *method</code></em>,
 
874
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
875
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>,
878
876
                                                         <em class="parameter"><code>...</code></em>);</pre>
879
877
<p>
880
878
This provides a convenient way to quickly send a message <em class="parameter"><code>method</code></em> at 
912
910
<div class="refsect2" title="gedit_message_bus_send_sync ()">
913
911
<a name="gedit-message-bus-send-sync"></a><h3>gedit_message_bus_send_sync ()</h3>
914
912
<pre class="programlisting"><a class="link" href="GeditMessage.html" title="GeditMessage"><span class="returnvalue">GeditMessage</span></a> *      gedit_message_bus_send_sync         (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
915
 
                                                         <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> *object_path</code></em>,
916
 
                                                         <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> *method</code></em>,
 
913
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
914
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>,
917
915
                                                         <em class="parameter"><code>...</code></em>);</pre>
918
916
<p>
919
917
This provides a convenient way to quickly send a message <em class="parameter"><code>method</code></em> at 
947
945
<tr>
948
946
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
949
947
<td> the constructed <a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a>. The caller owns a reference
950
 
              to the <a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a> and should call <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> when
 
948
              to the <a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a> and should call <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> when
951
949
              it is no longer needed
952
950
</td>
953
951
</tr>
961
959
<a name="GeditMessageBus-dispatch"></a><h3>The <code class="literal">"dispatch"</code> signal</h3>
962
960
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus,
963
961
                                                        <a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a>    *message,
964
 
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>         user_data)      : Run Last</pre>
 
962
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>         user_data)      : Run Last</pre>
965
963
<p>
966
964
The "dispatch" signal is emitted when a message is to be dispatched.
967
965
The message is dispatched in the default handler of this signal.
994
992
<a name="GeditMessageBus-registered"></a><h3>The <code class="literal">"registered"</code> signal</h3>
995
993
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>  *bus,
996
994
                                                        <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a> *message_type,
997
 
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)         : Run Last</pre>
 
995
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)         : Run Last</pre>
998
996
<p>
999
997
The "registered" signal is emitted when a message has been registered
1000
998
on the bus.
1024
1022
<a name="GeditMessageBus-unregistered"></a><h3>The <code class="literal">"unregistered"</code> signal</h3>
1025
1023
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>  *bus,
1026
1024
                                                        <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a> *message_type,
1027
 
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)         : Run Last</pre>
 
1025
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)         : Run Last</pre>
1028
1026
<p>
1029
1027
The "unregistered" signal is emitted when a message has been 
1030
1028
unregistered from the bus.