~ubuntu-branches/ubuntu/lucid/gedit/lucid-proposed

« 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-02-22 23:48:52 UTC
  • mfrom: (1.1.74 upstream)
  • Revision ID: james.westby@ubuntu.com-20100222234852-j17emhgwyobpiswf
Tags: 2.29.7-0ubuntu1
* New upstream version:
  - Many string fixes
  - Misc bugfixes
* debian/control.in:
  - updated gtksourceview and pygtksourceview requirements
  - Misc bugfixes
* debian/patches/90_autoconf.patch:
  - new version update

Show diffs side-by-side

added added

removed removed

Lines of Context:
6
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
7
<link rel="home" href="index.html" title="gedit Reference Manual">
8
8
<link rel="up" href="ch01.html" title="gedit">
9
 
<link rel="prev" href="GeditFileChooserDialog.html" title="GeditFileChooserDialog">
 
9
<link rel="prev" href="gedit-gedit-file-chooser-dialog.html" title="GeditFileChooserDialog">
10
10
<link rel="next" href="gedit-GeditMessageType.html" title="GeditMessageType">
11
 
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="ch01.html" title="gedit">
14
14
</head>
15
15
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
16
16
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
17
17
<tr valign="middle">
18
 
<td><a accesskey="p" href="GeditFileChooserDialog.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
18
<td><a accesskey="p" href="gedit-gedit-file-chooser-dialog.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
19
19
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
20
20
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
21
21
<th width="100%" align="center">gedit Reference Manual</th>
23
23
</tr>
24
24
<tr><td colspan="5" class="shortcuts">
25
25
<a href="#GeditMessageBus.synopsis" class="shortcut">Top</a>
26
 
                 | 
27
 
                <a href="#GeditMessageBus.description" class="shortcut">Description</a>
28
 
                 | 
29
 
                <a href="#GeditMessageBus.object-hierarchy" class="shortcut">Object Hierarchy</a>
30
 
                 | 
31
 
                <a href="#GeditMessageBus.signals" class="shortcut">Signals</a>
 
26
                   | 
 
27
                  <a href="#GeditMessageBus.description" class="shortcut">Description</a>
 
28
                   | 
 
29
                  <a href="#GeditMessageBus.object-hierarchy" class="shortcut">Object Hierarchy</a>
 
30
                   | 
 
31
                  <a href="#GeditMessageBus.signals" class="shortcut">Signals</a>
32
32
</td></tr>
33
33
</table>
34
34
<div class="refentry" title="GeditMessageBus">
43
43
<div class="refsynopsisdiv" title="Synopsis">
44
44
<a name="GeditMessageBus.synopsis"></a><h2>Synopsis</h2>
45
45
<pre class="synopsis">
46
 
 
47
46
#include &lt;gedit/gedit-message-bus.h&gt;
48
47
 
49
48
                    <a class="link" href="GeditMessageBus.html#GeditMessageBus-struct" title="GeditMessageBus">GeditMessageBus</a>;
50
 
void                (<a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()">*GeditMessageCallback</a>)             (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
51
 
                                                         <a class="link" href="GeditMessage.html" title="GeditMessage">GeditMessage</a> *message,
52
 
                                                         <a
53
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
54
 
>gpointer</a> userdata);
55
 
<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *   <a class="link" href="GeditMessageBus.html#gedit-message-bus-get-default" title="gedit_message_bus_get_default ()">gedit_message_bus_get_default</a>       (void);
56
 
<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *   <a class="link" href="GeditMessageBus.html#gedit-message-bus-new" title="gedit_message_bus_new ()">gedit_message_bus_new</a>               (void);
57
 
<a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType">GeditMessageType</a> *  <a class="link" href="GeditMessageBus.html#gedit-message-bus-lookup" title="gedit_message_bus_lookup ()">gedit_message_bus_lookup</a>            (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
58
 
                                                         const <a
59
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
60
 
>gchar</a> *object_path,
61
 
                                                         const <a
62
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
63
 
>gchar</a> *method);
64
 
<a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType">GeditMessageType</a> *  <a class="link" href="GeditMessageBus.html#gedit-message-bus-register" title="gedit_message_bus_register ()">gedit_message_bus_register</a>          (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
65
 
                                                         const <a
66
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
67
 
>gchar</a> *object_path,
68
 
                                                         const <a
69
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
70
 
>gchar</a> *method,
71
 
                                                         <a
72
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
73
 
>guint</a> num_optional,
74
 
                                                         ...);
75
 
void                <a class="link" href="GeditMessageBus.html#gedit-message-bus-unregister" title="gedit_message_bus_unregister ()">gedit_message_bus_unregister</a>        (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
76
 
                                                         <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType">GeditMessageType</a> *message_type);
77
 
void                <a class="link" href="GeditMessageBus.html#gedit-message-bus-unregister-all" title="gedit_message_bus_unregister_all ()">gedit_message_bus_unregister_all</a>    (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
78
 
                                                         const <a
79
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
80
 
>gchar</a> *object_path);
81
 
<a
82
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
83
 
>gboolean</a>            <a class="link" href="GeditMessageBus.html#gedit-message-bus-is-registered" title="gedit_message_bus_is_registered ()">gedit_message_bus_is_registered</a>     (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
84
 
                                                         const <a
85
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
86
 
>gchar</a> *object_path,
87
 
                                                         const <a
88
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
89
 
>gchar</a> *method);
90
 
void                <a class="link" href="GeditMessageBus.html#gedit-message-bus-foreach" title="gedit_message_bus_foreach ()">gedit_message_bus_foreach</a>           (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
91
 
                                                         GeditMessageBusForeach func,
92
 
                                                         <a
93
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
94
 
>gpointer</a> userdata);
95
 
<a
96
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
97
 
>guint</a>               <a class="link" href="GeditMessageBus.html#gedit-message-bus-connect" title="gedit_message_bus_connect ()">gedit_message_bus_connect</a>           (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
98
 
                                                         const <a
99
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
100
 
>gchar</a> *object_path,
101
 
                                                         const <a
102
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
103
 
>gchar</a> *method,
104
 
                                                         <a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()">GeditMessageCallback</a> callback,
105
 
                                                         <a
106
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
107
 
>gpointer</a> userdata,
108
 
                                                         <a
109
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
110
 
>GDestroyNotify</a> destroy_data);
111
 
void                <a class="link" href="GeditMessageBus.html#gedit-message-bus-disconnect" title="gedit_message_bus_disconnect ()">gedit_message_bus_disconnect</a>        (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
112
 
                                                         <a
113
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
114
 
>guint</a> id);
115
 
void                <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>
116
 
                                                        (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
117
 
                                                         const <a
118
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
119
 
>gchar</a> *object_path,
120
 
                                                         const <a
121
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
122
 
>gchar</a> *method,
123
 
                                                         <a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()">GeditMessageCallback</a> callback,
124
 
                                                         <a
125
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
126
 
>gpointer</a> userdata);
127
 
void                <a class="link" href="GeditMessageBus.html#gedit-message-bus-block" title="gedit_message_bus_block ()">gedit_message_bus_block</a>             (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
128
 
                                                         <a
129
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
130
 
>guint</a> id);
131
 
void                <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>     (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
132
 
                                                         const <a
133
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
134
 
>gchar</a> *object_path,
135
 
                                                         const <a
136
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
137
 
>gchar</a> *method,
138
 
                                                         <a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()">GeditMessageCallback</a> callback,
139
 
                                                         <a
140
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
141
 
>gpointer</a> userdata);
142
 
void                <a class="link" href="GeditMessageBus.html#gedit-message-bus-unblock" title="gedit_message_bus_unblock ()">gedit_message_bus_unblock</a>           (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
143
 
                                                         <a
144
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
145
 
>guint</a> id);
146
 
void                <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>   (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
147
 
                                                         const <a
148
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
149
 
>gchar</a> *object_path,
150
 
                                                         const <a
151
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
152
 
>gchar</a> *method,
153
 
                                                         <a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()">GeditMessageCallback</a> callback,
154
 
                                                         <a
155
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
156
 
>gpointer</a> userdata);
157
 
void                <a class="link" href="GeditMessageBus.html#gedit-message-bus-send-message" title="gedit_message_bus_send_message ()">gedit_message_bus_send_message</a>      (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
158
 
                                                         <a class="link" href="GeditMessage.html" title="GeditMessage">GeditMessage</a> *message);
159
 
void                <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> (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
160
 
                                                         <a class="link" href="GeditMessage.html" title="GeditMessage">GeditMessage</a> *message);
161
 
void                <a class="link" href="GeditMessageBus.html#gedit-message-bus-send" title="gedit_message_bus_send ()">gedit_message_bus_send</a>              (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
162
 
                                                         const <a
163
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
164
 
>gchar</a> *object_path,
165
 
                                                         const <a
166
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
167
 
>gchar</a> *method,
168
 
                                                         ...);
169
 
<a class="link" href="GeditMessage.html" title="GeditMessage">GeditMessage</a> *      <a class="link" href="GeditMessageBus.html#gedit-message-bus-send-sync" title="gedit_message_bus_send_sync ()">gedit_message_bus_send_sync</a>         (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
170
 
                                                         const <a
171
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
172
 
>gchar</a> *object_path,
173
 
                                                         const <a
174
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
175
 
>gchar</a> *method,
176
 
                                                         ...);
 
49
<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>,
 
50
                                                         <em class="parameter"><code><a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a> *message</code></em>,
 
51
                                                         <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>);
 
52
<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>);
 
53
<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>);
 
54
<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>,
 
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> *object_path</code></em>,
 
56
                                                         <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>);
 
57
<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>,
 
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> *object_path</code></em>,
 
59
                                                         <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>,
 
60
                                                         <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>,
 
61
                                                         <em class="parameter"><code>...</code></em>);
 
62
<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>,
 
63
                                                         <em class="parameter"><code><a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a> *message_type</code></em>);
 
64
<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>,
 
65
                                                         <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>);
 
66
<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>,
 
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> *object_path</code></em>,
 
68
                                                         <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>);
 
69
<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>,
 
70
                                                         <em class="parameter"><code><span class="type">GeditMessageBusForeach</span> func</code></em>,
 
71
                                                         <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>);
 
72
<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>,
 
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> *object_path</code></em>,
 
74
                                                         <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>,
 
75
                                                         <em class="parameter"><code><a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()"><span class="type">GeditMessageCallback</span></a> callback</code></em>,
 
76
                                                         <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>,
 
77
                                                         <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>);
 
78
<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>,
 
79
                                                         <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>);
 
80
<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>
 
81
                                                        (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</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> *object_path</code></em>,
 
83
                                                         <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>,
 
84
                                                         <em class="parameter"><code><a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()"><span class="type">GeditMessageCallback</span></a> callback</code></em>,
 
85
                                                         <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>);
 
86
<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>,
 
87
                                                         <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>);
 
88
<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>,
 
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> *object_path</code></em>,
 
90
                                                         <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>,
 
91
                                                         <em class="parameter"><code><a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()"><span class="type">GeditMessageCallback</span></a> callback</code></em>,
 
92
                                                         <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>);
 
93
<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>,
 
94
                                                         <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>);
 
95
<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>,
 
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> *object_path</code></em>,
 
97
                                                         <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>,
 
98
                                                         <em class="parameter"><code><a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()"><span class="type">GeditMessageCallback</span></a> callback</code></em>,
 
99
                                                         <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>);
 
100
<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>,
 
101
                                                         <em class="parameter"><code><a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a> *message</code></em>);
 
102
<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>,
 
103
                                                         <em class="parameter"><code><a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a> *message</code></em>);
 
104
<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>,
 
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> *object_path</code></em>,
 
106
                                                         <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>,
 
107
                                                         <em class="parameter"><code>...</code></em>);
 
108
<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>,
 
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> *object_path</code></em>,
 
110
                                                         <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>,
 
111
                                                         <em class="parameter"><code>...</code></em>);
177
112
</pre>
178
113
</div>
179
114
<div class="refsect1" title="Object Hierarchy">
180
115
<a name="GeditMessageBus.object-hierarchy"></a><h2>Object Hierarchy</h2>
181
116
<pre class="synopsis">
182
 
  <a
183
 
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
184
 
>GObject</a>
 
117
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
185
118
   +----GeditMessageBus
186
119
</pre>
187
120
</div>
204
137
<p>
205
138
There are two different communication busses available. The default bus
206
139
(see <a class="link" href="GeditMessageBus.html#gedit-message-bus-get-default" title="gedit_message_bus_get_default ()"><code class="function">gedit_message_bus_get_default()</code></a>) is an application wide communication
207
 
bus. In addition, each <a class="link" href="GeditWindow.html" title="GeditWindow"><span class="type">GeditWindow</span></a> has a separate, private bus
208
 
(see <a class="link" href="GeditWindow.html#gedit-window-get-message-bus" title="gedit_window_get_message_bus ()"><code class="function">gedit_window_get_message_bus()</code></a>). This makes it easier for plugins to
 
140
bus. In addition, each <a class="link" href="gedit-gedit-window.html#GeditWindow"><span class="type">GeditWindow</span></a> has a separate, private bus
 
141
(see <a class="link" href="gedit-gedit-window.html#gedit-window-get-message-bus" title="gedit_window_get_message_bus ()"><code class="function">gedit_window_get_message_bus()</code></a>). This makes it easier for plugins to
209
142
communicate to other plugins in the same window.
210
143
</p>
211
144
<p>
220
153
<p>
221
154
</p>
222
155
<div class="example">
223
 
<a name="id527769"></a><p class="title"><b>Example 1. Registering a message type</b></p>
224
 
<div class="example-contents"><pre class="programlisting">
225
 
GeditMessageBus *bus = gedit_message_bus_get_default ();
226
 
 
227
 
// Register 'method' at '/plugins/example' with one required
228
 
// string argument 'arg1'
229
 
GeditMessageType *message_type = gedit_message_bus_register ("/plugins/example", "method", 
230
 
                                                             0, 
231
 
                                                             "arg1", G_TYPE_STRING,
232
 
                                                             NULL);
233
 
</pre></div>
 
156
<a name="id516774"></a><p class="title"><b>Example 1. Registering a message type</b></p>
 
157
<div class="example-contents">
 
158
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 
159
    <tbody>
 
160
      <tr>
 
161
        <td class="listing_lines" align="right"><pre>1
 
162
2
 
163
3
 
164
4
 
165
5
 
166
6
 
167
7
 
168
8</pre></td>
 
169
        <td class="listing_code"><pre class="programlisting">GeditMessageBus *bus = gedit_message_bus_get_default ();
 
170
 
 
171
<span class="comment">// Register 'method' at '/plugins/example' with one required</span>
 
172
<span class="comment">// string argument 'arg1'</span>
 
173
GeditMessageType *message_type = gedit_message_bus_register (<span class="number">&quot;/plugins/example&quot;</span>, <span class="number">&quot;method&quot;</span>,
 
174
                                                             <span class="number">0</span>,
 
175
                                                             <span class="number">&quot;arg1&quot;</span>, G_TYPE_STRING,
 
176
                                                             <span class="number">NULL</span>);</pre></td>
 
177
      </tr>
 
178
    </tbody>
 
179
  </table>
 
180
</div>
 
181
 
234
182
</div>
235
183
<p><br class="example-break">
236
184
</p>
237
185
<div class="example">
238
 
<a name="id527786"></a><p class="title"><b>Example 2. Connecting a callback</b></p>
239
 
<div class="example-contents"><pre class="programlisting">
240
 
static void
 
186
<a name="id516791"></a><p class="title"><b>Example 2. Connecting a callback</b></p>
 
187
<div class="example-contents">
 
188
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 
189
    <tbody>
 
190
      <tr>
 
191
        <td class="listing_lines" align="right"><pre>1
 
192
2
 
193
3
 
194
4
 
195
5
 
196
6
 
197
7
 
198
8
 
199
9
 
200
10
 
201
11
 
202
12
 
203
13
 
204
14
 
205
15
 
206
16
 
207
17
 
208
18
 
209
19</pre></td>
 
210
        <td class="listing_code"><pre class="programlisting"><span class="type">static</span> <span class="type">void</span>
241
211
example_method_cb (GeditMessageBus *bus,
242
212
                   GeditMessage    *message,
243
213
                   gpointer         userdata)
244
214
{
245
 
        gchar *arg1 = NULL;
 
215
        gchar *arg1 = <span class="number">NULL</span>;
246
216
 
247
 
        gedit_message_get (message, "arg1", &amp;arg1, NULL);
248
 
        g_message ("Evoked /plugins/example.method with: %s", arg1);
249
 
        g_free (arg1);
 
217
        gedit_message_get (message, <span class="number">&quot;arg1&quot;</span>, &amp;arg1, <span class="number">NULL</span>);
 
218
        g_message (<span class="number">&quot;Evoked /plugins/example.method with: </span><span class="symbol">%s</span><span class="number">&quot;</span>, arg1);
 
219
        g_free (arg1);
250
220
}
251
221
 
252
222
GeditMessageBus *bus = gedit_message_bus_get_default ();
253
223
 
254
 
guint id = gedit_message_bus_connect (bus, 
255
 
                                      "/plugins/example", "method",
 
224
guint id = gedit_message_bus_connect (bus,
 
225
                                      <span class="number">&quot;/plugins/example&quot;</span>, <span class="number">&quot;method&quot;</span>,
256
226
                                      example_method_cb,
257
 
                                      NULL,
258
 
                                      NULL);
259
 
                                       
260
 
</pre></div>
 
227
                                      <span class="number">NULL</span>,
 
228
                                      <span class="number">NULL</span>);</pre></td>
 
229
      </tr>
 
230
    </tbody>
 
231
  </table>
 
232
</div>
 
233
 
261
234
</div>
262
235
<p><br class="example-break">
263
236
</p>
264
237
<div class="example">
265
 
<a name="id527805"></a><p class="title"><b>Example 3. Sending a message</b></p>
266
 
<div class="example-contents"><pre class="programlisting">
267
 
GeditMessageBus *bus = gedit_message_bus_get_default ();
268
 
 
269
 
gedit_message_bus_send (bus, 
270
 
                        "/plugins/example", "method", 
271
 
                        "arg1", "Hello World", 
272
 
                        NULL);
273
 
</pre></div>
 
238
<a name="id516810"></a><p class="title"><b>Example 3. Sending a message</b></p>
 
239
<div class="example-contents">
 
240
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 
241
    <tbody>
 
242
      <tr>
 
243
        <td class="listing_lines" align="right"><pre>1
 
244
2
 
245
3
 
246
4
 
247
5
 
248
6</pre></td>
 
249
        <td class="listing_code"><pre class="programlisting">GeditMessageBus *bus = gedit_message_bus_get_default ();
 
250
 
 
251
gedit_message_bus_send (bus,
 
252
                        <span class="number">&quot;/plugins/example&quot;</span>, <span class="number">&quot;method&quot;</span>,
 
253
                        <span class="number">&quot;arg1&quot;</span>, <span class="number">&quot;Hello World&quot;</span>,
 
254
                        <span class="number">NULL</span>);</pre></td>
 
255
      </tr>
 
256
    </tbody>
 
257
  </table>
 
258
</div>
 
259
 
274
260
</div>
275
261
<p><br class="example-break"></p>
276
 
<p>
277
 
</p>
278
262
</div>
279
263
<div class="refsect1" title="Details">
280
264
<a name="GeditMessageBus.details"></a><h2>Details</h2>
281
265
<div class="refsect2" title="GeditMessageBus">
282
266
<a name="GeditMessageBus-struct"></a><h3>GeditMessageBus</h3>
283
267
<pre class="programlisting">typedef struct _GeditMessageBus GeditMessageBus;</pre>
284
 
<p>
285
 
</p>
286
268
</div>
287
269
<hr>
288
270
<div class="refsect2" title="GeditMessageCallback ()">
289
271
<a name="GeditMessageCallback"></a><h3>GeditMessageCallback ()</h3>
290
 
<pre class="programlisting">void                (*GeditMessageCallback)             (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
291
 
                                                         <a class="link" href="GeditMessage.html" title="GeditMessage">GeditMessage</a> *message,
292
 
                                                         <a
293
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
294
 
>gpointer</a> userdata);</pre>
 
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>,
 
273
                                                         <em class="parameter"><code><a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a> *message</code></em>,
 
274
                                                         <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>
295
275
<p>
296
276
Callback signature used for connecting callback functions to be called
297
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>).</p>
298
 
<p>
299
 
</p>
300
278
<div class="variablelist"><table border="0">
301
279
<col align="left" valign="top">
302
280
<tbody>
303
281
<tr>
304
282
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
305
 
<td> the <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> on which the message was sent
 
283
<td>the <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> on which the message was sent
306
284
</td>
307
285
</tr>
308
286
<tr>
309
287
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
310
 
<td> the <a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a> which was sent
 
288
<td>the <a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a> which was sent
311
289
</td>
312
290
</tr>
313
291
<tr>
314
292
<td><p><span class="term"><em class="parameter"><code>userdata</code></em> :</span></p></td>
315
 
<td> the supplied user data when connecting the callback
 
293
<td>the supplied user data when connecting the callback
316
294
</td>
317
295
</tr>
318
296
</tbody>
321
299
<hr>
322
300
<div class="refsect2" title="gedit_message_bus_get_default ()">
323
301
<a name="gedit-message-bus-get-default"></a><h3>gedit_message_bus_get_default ()</h3>
324
 
<pre class="programlisting"><a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *   gedit_message_bus_get_default       (void);</pre>
 
302
<pre class="programlisting"><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="returnvalue">GeditMessageBus</span></a> *   gedit_message_bus_get_default       (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
325
303
<p>
326
304
Get the default application <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>.</p>
327
 
<p>
328
 
</p>
329
305
<div class="variablelist"><table border="0">
330
306
<col align="left" valign="top">
331
307
<tbody><tr>
339
315
<hr>
340
316
<div class="refsect2" title="gedit_message_bus_new ()">
341
317
<a name="gedit-message-bus-new"></a><h3>gedit_message_bus_new ()</h3>
342
 
<pre class="programlisting"><a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *   gedit_message_bus_new               (void);</pre>
 
318
<pre class="programlisting"><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="returnvalue">GeditMessageBus</span></a> *   gedit_message_bus_new               (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
343
319
<p>
344
320
Create a new message bus. Use <a class="link" href="GeditMessageBus.html#gedit-message-bus-get-default" title="gedit_message_bus_get_default ()"><code class="function">gedit_message_bus_get_default()</code></a> to get the
345
321
default, application wide, message bus. Creating a new bus is useful for
346
 
associating a specific bus with for instance a <a class="link" href="GeditWindow.html" title="GeditWindow"><span class="type">GeditWindow</span></a>.</p>
347
 
<p>
348
 
</p>
 
322
associating a specific bus with for instance a <a class="link" href="gedit-gedit-window.html#GeditWindow"><span class="type">GeditWindow</span></a>.</p>
349
323
<div class="variablelist"><table border="0">
350
324
<col align="left" valign="top">
351
325
<tbody><tr>
359
333
<hr>
360
334
<div class="refsect2" title="gedit_message_bus_lookup ()">
361
335
<a name="gedit-message-bus-lookup"></a><h3>gedit_message_bus_lookup ()</h3>
362
 
<pre class="programlisting"><a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType">GeditMessageType</a> *  gedit_message_bus_lookup            (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
363
 
                                                         const <a
364
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
365
 
>gchar</a> *object_path,
366
 
                                                         const <a
367
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
368
 
>gchar</a> *method);</pre>
 
336
<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>,
 
337
                                                         <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>,
 
338
                                                         <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>
369
339
<p>
370
340
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 
371
341
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.</p>
372
 
<p>
373
 
</p>
374
342
<div class="variablelist"><table border="0">
375
343
<col align="left" valign="top">
376
344
<tbody>
377
345
<tr>
378
346
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
379
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
347
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
380
348
</td>
381
349
</tr>
382
350
<tr>
383
351
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
384
 
<td> the object path
 
352
<td>the object path
385
353
</td>
386
354
</tr>
387
355
<tr>
388
356
<td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td>
389
 
<td> the method
 
357
<td>the method
390
358
</td>
391
359
</tr>
392
360
<tr>
393
361
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
394
 
<td> the registered <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a> or <code class="literal">NULL</code> if no message type
 
362
<td> the registered <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a> or <a href="/opt/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if no message type
395
363
              is registered for <em class="parameter"><code>method</code></em> at <em class="parameter"><code>object_path</code></em>
396
364
 
397
365
</td>
402
370
<hr>
403
371
<div class="refsect2" title="gedit_message_bus_register ()">
404
372
<a name="gedit-message-bus-register"></a><h3>gedit_message_bus_register ()</h3>
405
 
<pre class="programlisting"><a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType">GeditMessageType</a> *  gedit_message_bus_register          (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
406
 
                                                         const <a
407
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
408
 
>gchar</a> *object_path,
409
 
                                                         const <a
410
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
411
 
>gchar</a> *method,
412
 
                                                         <a
413
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
414
 
>guint</a> num_optional,
415
 
                                                         ...);</pre>
 
373
<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>,
 
374
                                                         <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>,
 
375
                                                         <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>,
 
376
                                                         <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>,
 
377
                                                         <em class="parameter"><code>...</code></em>);</pre>
416
378
<p>
417
379
Register a message on the bus. A message must be registered on the bus before
418
380
it can be send. This function registers the type arguments for <em class="parameter"><code>method</code></em> at 
419
381
<em class="parameter"><code>object_path</code></em>. The arguments are specified with the variable arguments which 
420
 
should contain pairs of const gchar *key and GType terminated by <code class="literal">NULL</code>. The 
 
382
should contain pairs of const gchar *key and GType terminated by <a href="/opt/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. The 
421
383
last <em class="parameter"><code>num_optional</code></em> arguments are registered as optional (and are thus not
422
384
required when sending a message).
423
385
</p>
424
386
<p>
425
387
This function emits a <a class="link" href="GeditMessageBus.html#GeditMessageBus-registered" title='The "registered" signal'><span class="type">"registered"</span></a> signal.</p>
426
 
<p>
427
 
</p>
428
388
<div class="variablelist"><table border="0">
429
389
<col align="left" valign="top">
430
390
<tbody>
431
391
<tr>
432
392
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
433
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
393
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
434
394
</td>
435
395
</tr>
436
396
<tr>
437
397
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
438
 
<td> the object path
 
398
<td>the object path
439
399
</td>
440
400
</tr>
441
401
<tr>
442
402
<td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td>
443
 
<td> the method to register
 
403
<td>the method to register
444
404
</td>
445
405
</tr>
446
406
<tr>
447
407
<td><p><span class="term"><em class="parameter"><code>num_optional</code></em> :</span></p></td>
448
 
<td> the number of optional arguments
 
408
<td>the number of optional arguments
449
409
</td>
450
410
</tr>
451
411
<tr>
452
412
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
453
 
<td> NULL terminated list of key/gtype method argument pairs
 
413
<td>NULL terminated list of key/gtype method argument pairs
454
414
</td>
455
415
</tr>
456
416
<tr>
467
427
<hr>
468
428
<div class="refsect2" title="gedit_message_bus_unregister ()">
469
429
<a name="gedit-message-bus-unregister"></a><h3>gedit_message_bus_unregister ()</h3>
470
 
<pre class="programlisting">void                gedit_message_bus_unregister        (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
471
 
                                                         <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType">GeditMessageType</a> *message_type);</pre>
 
430
<pre class="programlisting"><span class="returnvalue">void</span>                gedit_message_bus_unregister        (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
 
431
                                                         <em class="parameter"><code><a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a> *message_type</code></em>);</pre>
472
432
<p>
473
433
Unregisters a previously registered message type. This is especially useful 
474
434
for plugins which should unregister message types when they are deactivated.
475
435
</p>
476
436
<p>
477
437
This function emits the <a class="link" href="GeditMessageBus.html#GeditMessageBus-unregistered" title='The "unregistered" signal'><span class="type">"unregistered"</span></a> signal.</p>
478
 
<p>
479
 
</p>
480
438
<div class="variablelist"><table border="0">
481
439
<col align="left" valign="top">
482
440
<tbody>
483
441
<tr>
484
442
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
485
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
443
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
486
444
</td>
487
445
</tr>
488
446
<tr>
489
447
<td><p><span class="term"><em class="parameter"><code>message_type</code></em> :</span></p></td>
490
 
<td> the <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a> to unregister
 
448
<td>the <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a> to unregister
491
449
</td>
492
450
</tr>
493
451
</tbody>
496
454
<hr>
497
455
<div class="refsect2" title="gedit_message_bus_unregister_all ()">
498
456
<a name="gedit-message-bus-unregister-all"></a><h3>gedit_message_bus_unregister_all ()</h3>
499
 
<pre class="programlisting">void                gedit_message_bus_unregister_all    (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
500
 
                                                         const <a
501
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
502
 
>gchar</a> *object_path);</pre>
 
457
<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>,
 
458
                                                         <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>
503
459
<p>
504
460
Unregisters all message types for <em class="parameter"><code>object_path</code></em>. This is especially useful for
505
461
plugins which should unregister message types when they are deactivated.
507
463
<p>
508
464
This function emits the <a class="link" href="GeditMessageBus.html#GeditMessageBus-unregistered" title='The "unregistered" signal'><span class="type">"unregistered"</span></a> signal for all
509
465
unregistered message types.</p>
510
 
<p>
511
 
</p>
512
466
<div class="variablelist"><table border="0">
513
467
<col align="left" valign="top">
514
468
<tbody>
515
469
<tr>
516
470
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
517
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
471
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
518
472
</td>
519
473
</tr>
520
474
<tr>
521
475
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
522
 
<td> the object path
 
476
<td>the object path
523
477
</td>
524
478
</tr>
525
479
</tbody>
528
482
<hr>
529
483
<div class="refsect2" title="gedit_message_bus_is_registered ()">
530
484
<a name="gedit-message-bus-is-registered"></a><h3>gedit_message_bus_is_registered ()</h3>
531
 
<pre class="programlisting"><a
532
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
533
 
>gboolean</a>            gedit_message_bus_is_registered     (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
534
 
                                                         const <a
535
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
536
 
>gchar</a> *object_path,
537
 
                                                         const <a
538
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
539
 
>gchar</a> *method);</pre>
 
485
<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>,
 
486
                                                         <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>,
 
487
                                                         <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>
540
488
<p>
541
489
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 
542
490
bus.</p>
543
 
<p>
544
 
</p>
545
491
<div class="variablelist"><table border="0">
546
492
<col align="left" valign="top">
547
493
<tbody>
548
494
<tr>
549
495
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
550
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
496
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
551
497
</td>
552
498
</tr>
553
499
<tr>
554
500
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
555
 
<td> the object path
 
501
<td>the object path
556
502
</td>
557
503
</tr>
558
504
<tr>
559
505
<td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td>
560
 
<td> the method
 
506
<td>the method
561
507
</td>
562
508
</tr>
563
509
<tr>
564
510
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
565
 
<td> <code class="literal">TRUE</code> if the <em class="parameter"><code>method</code></em> at <em class="parameter"><code>object_path</code></em> is a registered message 
 
511
<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 
566
512
              type on the bus
567
513
 
568
514
</td>
573
519
<hr>
574
520
<div class="refsect2" title="gedit_message_bus_foreach ()">
575
521
<a name="gedit-message-bus-foreach"></a><h3>gedit_message_bus_foreach ()</h3>
576
 
<pre class="programlisting">void                gedit_message_bus_foreach           (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
577
 
                                                         GeditMessageBusForeach func,
578
 
                                                         <a
579
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
580
 
>gpointer</a> userdata);</pre>
 
522
<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>,
 
523
                                                         <em class="parameter"><code><span class="type">GeditMessageBusForeach</span> func</code></em>,
 
524
                                                         <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>
581
525
<p>
582
526
Calls <em class="parameter"><code>func</code></em> for each message type registered on the bus</p>
583
 
<p>
584
 
</p>
585
527
<div class="variablelist"><table border="0">
586
528
<col align="left" valign="top">
587
529
<tbody>
588
530
<tr>
589
531
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
590
 
<td> the <span class="type">GeditMessagebus</span>
 
532
<td>the <span class="type">GeditMessagebus</span>
591
533
</td>
592
534
</tr>
593
535
<tr>
594
536
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
595
 
<td> the callback function
 
537
<td>the callback function
596
538
</td>
597
539
</tr>
598
540
<tr>
599
541
<td><p><span class="term"><em class="parameter"><code>userdata</code></em> :</span></p></td>
600
 
<td> the user data to supply to the callback function
 
542
<td>the user data to supply to the callback function
601
543
</td>
602
544
</tr>
603
545
</tbody>
606
548
<hr>
607
549
<div class="refsect2" title="gedit_message_bus_connect ()">
608
550
<a name="gedit-message-bus-connect"></a><h3>gedit_message_bus_connect ()</h3>
609
 
<pre class="programlisting"><a
610
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
611
 
>guint</a>               gedit_message_bus_connect           (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
612
 
                                                         const <a
613
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
614
 
>gchar</a> *object_path,
615
 
                                                         const <a
616
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
617
 
>gchar</a> *method,
618
 
                                                         <a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()">GeditMessageCallback</a> callback,
619
 
                                                         <a
620
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
621
 
>gpointer</a> userdata,
622
 
                                                         <a
623
 
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
624
 
>GDestroyNotify</a> destroy_data);</pre>
 
551
<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>,
 
552
                                                         <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>,
 
553
                                                         <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>,
 
554
                                                         <em class="parameter"><code><a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()"><span class="type">GeditMessageCallback</span></a> callback</code></em>,
 
555
                                                         <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>,
 
556
                                                         <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>
625
557
<p>
626
558
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>
627
559
is sent over the bus.</p>
628
 
<p>
629
 
</p>
630
560
<div class="variablelist"><table border="0">
631
561
<col align="left" valign="top">
632
562
<tbody>
633
563
<tr>
634
564
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
635
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
565
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
636
566
</td>
637
567
</tr>
638
568
<tr>
639
569
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
640
 
<td> the object path
 
570
<td>the object path
641
571
</td>
642
572
</tr>
643
573
<tr>
644
574
<td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td>
645
 
<td> the method
 
575
<td>the method
646
576
</td>
647
577
</tr>
648
578
<tr>
649
579
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
650
 
<td> function to be called when message <em class="parameter"><code>method</code></em> at <em class="parameter"><code>object_path</code></em> is sent
 
580
<td>function to be called when message <em class="parameter"><code>method</code></em> at <em class="parameter"><code>object_path</code></em> is sent
651
581
</td>
652
582
</tr>
653
583
<tr>
654
584
<td><p><span class="term"><em class="parameter"><code>userdata</code></em> :</span></p></td>
655
 
<td> userdata to use for the callback
 
585
<td>userdata to use for the callback
656
586
</td>
657
587
</tr>
658
588
<tr>
659
589
<td><p><span class="term"><em class="parameter"><code>destroy_data</code></em> :</span></p></td>
660
 
<td> function to evoke with <em class="parameter"><code>userdata</code></em> as argument when <em class="parameter"><code>userdata</code></em>
 
590
<td>function to evoke with <em class="parameter"><code>userdata</code></em> as argument when <em class="parameter"><code>userdata</code></em>
661
591
               needs to be freed
662
592
</td>
663
593
</tr>
673
603
<hr>
674
604
<div class="refsect2" title="gedit_message_bus_disconnect ()">
675
605
<a name="gedit-message-bus-disconnect"></a><h3>gedit_message_bus_disconnect ()</h3>
676
 
<pre class="programlisting">void                gedit_message_bus_disconnect        (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
677
 
                                                         <a
678
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
679
 
>guint</a> id);</pre>
 
606
<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>,
 
607
                                                         <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>
680
608
<p>
681
609
Disconnects a previously connected message callback.</p>
682
 
<p>
683
 
</p>
684
610
<div class="variablelist"><table border="0">
685
611
<col align="left" valign="top">
686
612
<tbody>
687
613
<tr>
688
614
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
689
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
615
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
690
616
</td>
691
617
</tr>
692
618
<tr>
693
619
<td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
694
 
<td> the callback id as returned by <a class="link" href="GeditMessageBus.html#gedit-message-bus-connect" title="gedit_message_bus_connect ()"><code class="function">gedit_message_bus_connect()</code></a>
 
620
<td>the callback id as returned by <a class="link" href="GeditMessageBus.html#gedit-message-bus-connect" title="gedit_message_bus_connect ()"><code class="function">gedit_message_bus_connect()</code></a>
695
621
</td>
696
622
</tr>
697
623
</tbody>
700
626
<hr>
701
627
<div class="refsect2" title="gedit_message_bus_disconnect_by_func ()">
702
628
<a name="gedit-message-bus-disconnect-by-func"></a><h3>gedit_message_bus_disconnect_by_func ()</h3>
703
 
<pre class="programlisting">void                gedit_message_bus_disconnect_by_func
704
 
                                                        (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
705
 
                                                         const <a
706
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
707
 
>gchar</a> *object_path,
708
 
                                                         const <a
709
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
710
 
>gchar</a> *method,
711
 
                                                         <a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()">GeditMessageCallback</a> callback,
712
 
                                                         <a
713
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
714
 
>gpointer</a> userdata);</pre>
 
629
<pre class="programlisting"><span class="returnvalue">void</span>                gedit_message_bus_disconnect_by_func
 
630
                                                        (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
 
631
                                                         <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>,
 
632
                                                         <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>,
 
633
                                                         <em class="parameter"><code><a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()"><span class="type">GeditMessageCallback</span></a> callback</code></em>,
 
634
                                                         <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>
715
635
<p>
716
636
Disconnects a previously connected message callback by matching the 
717
637
provided callback function and userdata. See also 
718
638
<a class="link" href="GeditMessageBus.html#gedit-message-bus-disconnect" title="gedit_message_bus_disconnect ()"><code class="function">gedit_message_bus_disconnect()</code></a>.</p>
719
 
<p>
720
 
</p>
721
639
<div class="variablelist"><table border="0">
722
640
<col align="left" valign="top">
723
641
<tbody>
724
642
<tr>
725
643
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
726
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
644
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
727
645
</td>
728
646
</tr>
729
647
<tr>
730
648
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
731
 
<td> the object path
 
649
<td>the object path
732
650
</td>
733
651
</tr>
734
652
<tr>
735
653
<td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td>
736
 
<td> the method
 
654
<td>the method
737
655
</td>
738
656
</tr>
739
657
<tr>
740
658
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
741
 
<td> the connected callback
 
659
<td>the connected callback
742
660
</td>
743
661
</tr>
744
662
<tr>
745
663
<td><p><span class="term"><em class="parameter"><code>userdata</code></em> :</span></p></td>
746
 
<td> the userdata with which the callback was connected
 
664
<td>the userdata with which the callback was connected
747
665
</td>
748
666
</tr>
749
667
</tbody>
752
670
<hr>
753
671
<div class="refsect2" title="gedit_message_bus_block ()">
754
672
<a name="gedit-message-bus-block"></a><h3>gedit_message_bus_block ()</h3>
755
 
<pre class="programlisting">void                gedit_message_bus_block             (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
756
 
                                                         <a
757
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
758
 
>guint</a> id);</pre>
 
673
<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>,
 
674
                                                         <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>
759
675
<p>
760
676
Blocks evoking the callback specified by <em class="parameter"><code>id</code></em>. Unblock the callback by
761
677
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>.</p>
762
 
<p>
763
 
</p>
764
678
<div class="variablelist"><table border="0">
765
679
<col align="left" valign="top">
766
680
<tbody>
767
681
<tr>
768
682
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
769
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
683
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
770
684
</td>
771
685
</tr>
772
686
<tr>
773
687
<td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
774
 
<td> the callback id
 
688
<td>the callback id
775
689
</td>
776
690
</tr>
777
691
</tbody>
780
694
<hr>
781
695
<div class="refsect2" title="gedit_message_bus_block_by_func ()">
782
696
<a name="gedit-message-bus-block-by-func"></a><h3>gedit_message_bus_block_by_func ()</h3>
783
 
<pre class="programlisting">void                gedit_message_bus_block_by_func     (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
784
 
                                                         const <a
785
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
786
 
>gchar</a> *object_path,
787
 
                                                         const <a
788
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
789
 
>gchar</a> *method,
790
 
                                                         <a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()">GeditMessageCallback</a> callback,
791
 
                                                         <a
792
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
793
 
>gpointer</a> userdata);</pre>
 
697
<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>,
 
698
                                                         <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>,
 
699
                                                         <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>,
 
700
                                                         <em class="parameter"><code><a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()"><span class="type">GeditMessageCallback</span></a> callback</code></em>,
 
701
                                                         <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>
794
702
<p>
795
703
Blocks evoking the callback that matches provided <em class="parameter"><code>callback</code></em> and <em class="parameter"><code>userdata</code></em>.
796
704
Unblock the callback using <code class="function">gedit_message_unblock_by_func()</code>.</p>
797
 
<p>
798
 
</p>
799
705
<div class="variablelist"><table border="0">
800
706
<col align="left" valign="top">
801
707
<tbody>
802
708
<tr>
803
709
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
804
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
710
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
805
711
</td>
806
712
</tr>
807
713
<tr>
808
714
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
809
 
<td> the object path
 
715
<td>the object path
810
716
</td>
811
717
</tr>
812
718
<tr>
813
719
<td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td>
814
 
<td> the method
 
720
<td>the method
815
721
</td>
816
722
</tr>
817
723
<tr>
818
724
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
819
 
<td> the callback to block
 
725
<td>the callback to block
820
726
</td>
821
727
</tr>
822
728
<tr>
823
729
<td><p><span class="term"><em class="parameter"><code>userdata</code></em> :</span></p></td>
824
 
<td> the userdata with which the callback was connected
 
730
<td>the userdata with which the callback was connected
825
731
</td>
826
732
</tr>
827
733
</tbody>
830
736
<hr>
831
737
<div class="refsect2" title="gedit_message_bus_unblock ()">
832
738
<a name="gedit-message-bus-unblock"></a><h3>gedit_message_bus_unblock ()</h3>
833
 
<pre class="programlisting">void                gedit_message_bus_unblock           (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
834
 
                                                         <a
835
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
836
 
>guint</a> id);</pre>
 
739
<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>,
 
740
                                                         <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>
837
741
<p>
838
742
Unblocks the callback specified by <em class="parameter"><code>id</code></em>.</p>
839
 
<p>
840
 
</p>
841
743
<div class="variablelist"><table border="0">
842
744
<col align="left" valign="top">
843
745
<tbody>
844
746
<tr>
845
747
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
846
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
748
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
847
749
</td>
848
750
</tr>
849
751
<tr>
850
752
<td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
851
 
<td> the callback id
 
753
<td>the callback id
852
754
</td>
853
755
</tr>
854
756
</tbody>
857
759
<hr>
858
760
<div class="refsect2" title="gedit_message_bus_unblock_by_func ()">
859
761
<a name="gedit-message-bus-unblock-by-func"></a><h3>gedit_message_bus_unblock_by_func ()</h3>
860
 
<pre class="programlisting">void                gedit_message_bus_unblock_by_func   (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
861
 
                                                         const <a
862
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
863
 
>gchar</a> *object_path,
864
 
                                                         const <a
865
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
866
 
>gchar</a> *method,
867
 
                                                         <a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()">GeditMessageCallback</a> callback,
868
 
                                                         <a
869
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
870
 
>gpointer</a> userdata);</pre>
 
762
<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>,
 
763
                                                         <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>,
 
764
                                                         <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>,
 
765
                                                         <em class="parameter"><code><a class="link" href="GeditMessageBus.html#GeditMessageCallback" title="GeditMessageCallback ()"><span class="type">GeditMessageCallback</span></a> callback</code></em>,
 
766
                                                         <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>
871
767
<p>
872
768
Unblocks the callback that matches provided <em class="parameter"><code>callback</code></em> and <em class="parameter"><code>userdata</code></em>.</p>
873
 
<p>
874
 
</p>
875
769
<div class="variablelist"><table border="0">
876
770
<col align="left" valign="top">
877
771
<tbody>
878
772
<tr>
879
773
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
880
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
774
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
881
775
</td>
882
776
</tr>
883
777
<tr>
884
778
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
885
 
<td> the object path
 
779
<td>the object path
886
780
</td>
887
781
</tr>
888
782
<tr>
889
783
<td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td>
890
 
<td> the method
 
784
<td>the method
891
785
</td>
892
786
</tr>
893
787
<tr>
894
788
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
895
 
<td> the callback to block
 
789
<td>the callback to block
896
790
</td>
897
791
</tr>
898
792
<tr>
899
793
<td><p><span class="term"><em class="parameter"><code>userdata</code></em> :</span></p></td>
900
 
<td> the userdata with which the callback was connected
 
794
<td>the userdata with which the callback was connected
901
795
</td>
902
796
</tr>
903
797
</tbody>
906
800
<hr>
907
801
<div class="refsect2" title="gedit_message_bus_send_message ()">
908
802
<a name="gedit-message-bus-send-message"></a><h3>gedit_message_bus_send_message ()</h3>
909
 
<pre class="programlisting">void                gedit_message_bus_send_message      (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
910
 
                                                         <a class="link" href="GeditMessage.html" title="GeditMessage">GeditMessage</a> *message);</pre>
 
803
<pre class="programlisting"><span class="returnvalue">void</span>                gedit_message_bus_send_message      (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
 
804
                                                         <em class="parameter"><code><a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a> *message</code></em>);</pre>
911
805
<p>
912
806
This sends the provided <em class="parameter"><code>message</code></em> asynchronously over the bus. To send
913
807
a message synchronously, use <a class="link" href="GeditMessageBus.html#gedit-message-bus-send-message-sync" title="gedit_message_bus_send_message_sync ()"><code class="function">gedit_message_bus_send_message_sync()</code></a>. The 
914
808
convenience function <a class="link" href="GeditMessageBus.html#gedit-message-bus-send" title="gedit_message_bus_send ()"><code class="function">gedit_message_bus_send()</code></a> can be used to easily send
915
809
a message without constructing the message object explicitly first.</p>
916
 
<p>
917
 
</p>
918
810
<div class="variablelist"><table border="0">
919
811
<col align="left" valign="top">
920
812
<tbody>
921
813
<tr>
922
814
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
923
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
815
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
924
816
</td>
925
817
</tr>
926
818
<tr>
927
819
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
928
 
<td> the message to send
 
820
<td>the message to send
929
821
</td>
930
822
</tr>
931
823
</tbody>
934
826
<hr>
935
827
<div class="refsect2" title="gedit_message_bus_send_message_sync ()">
936
828
<a name="gedit-message-bus-send-message-sync"></a><h3>gedit_message_bus_send_message_sync ()</h3>
937
 
<pre class="programlisting">void                gedit_message_bus_send_message_sync (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
938
 
                                                         <a class="link" href="GeditMessage.html" title="GeditMessage">GeditMessage</a> *message);</pre>
 
829
<pre class="programlisting"><span class="returnvalue">void</span>                gedit_message_bus_send_message_sync (<em class="parameter"><code><a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a> *bus</code></em>,
 
830
                                                         <em class="parameter"><code><a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a> *message</code></em>);</pre>
939
831
<p>
940
832
This sends the provided <em class="parameter"><code>message</code></em> synchronously over the bus. To send
941
833
a message asynchronously, use <a class="link" href="GeditMessageBus.html#gedit-message-bus-send-message" title="gedit_message_bus_send_message ()"><code class="function">gedit_message_bus_send_message()</code></a>. The 
942
834
convenience function <a class="link" href="GeditMessageBus.html#gedit-message-bus-send-sync" title="gedit_message_bus_send_sync ()"><code class="function">gedit_message_bus_send_sync()</code></a> can be used to easily send
943
835
a message without constructing the message object explicitly first.</p>
944
 
<p>
945
 
</p>
946
836
<div class="variablelist"><table border="0">
947
837
<col align="left" valign="top">
948
838
<tbody>
949
839
<tr>
950
840
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
951
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
841
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
952
842
</td>
953
843
</tr>
954
844
<tr>
955
845
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
956
 
<td> the message to send
 
846
<td>the message to send
957
847
</td>
958
848
</tr>
959
849
</tbody>
962
852
<hr>
963
853
<div class="refsect2" title="gedit_message_bus_send ()">
964
854
<a name="gedit-message-bus-send"></a><h3>gedit_message_bus_send ()</h3>
965
 
<pre class="programlisting">void                gedit_message_bus_send              (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
966
 
                                                         const <a
967
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
968
 
>gchar</a> *object_path,
969
 
                                                         const <a
970
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
971
 
>gchar</a> *method,
972
 
                                                         ...);</pre>
 
855
<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>,
 
856
                                                         <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>,
 
857
                                                         <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>,
 
858
                                                         <em class="parameter"><code>...</code></em>);</pre>
973
859
<p>
974
860
This provides a convenient way to quickly send a message <em class="parameter"><code>method</code></em> at 
975
861
<em class="parameter"><code>object_path</code></em> asynchronously over the bus. The variable argument list 
976
862
specifies key (string) value pairs used to construct the message arguments. 
977
863
To send a message synchronously use <a class="link" href="GeditMessageBus.html#gedit-message-bus-send-sync" title="gedit_message_bus_send_sync ()"><code class="function">gedit_message_bus_send_sync()</code></a>.</p>
978
 
<p>
979
 
</p>
980
864
<div class="variablelist"><table border="0">
981
865
<col align="left" valign="top">
982
866
<tbody>
983
867
<tr>
984
868
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
985
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
869
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
986
870
</td>
987
871
</tr>
988
872
<tr>
989
873
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
990
 
<td> the object path
 
874
<td>the object path
991
875
</td>
992
876
</tr>
993
877
<tr>
994
878
<td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td>
995
 
<td> the method
 
879
<td>the method
996
880
</td>
997
881
</tr>
998
882
<tr>
999
883
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1000
 
<td> NULL terminated list of key/value pairs
 
884
<td>NULL terminated list of key/value pairs
1001
885
</td>
1002
886
</tr>
1003
887
</tbody>
1006
890
<hr>
1007
891
<div class="refsect2" title="gedit_message_bus_send_sync ()">
1008
892
<a name="gedit-message-bus-send-sync"></a><h3>gedit_message_bus_send_sync ()</h3>
1009
 
<pre class="programlisting"><a class="link" href="GeditMessage.html" title="GeditMessage">GeditMessage</a> *      gedit_message_bus_send_sync         (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
1010
 
                                                         const <a
1011
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
1012
 
>gchar</a> *object_path,
1013
 
                                                         const <a
1014
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
1015
 
>gchar</a> *method,
1016
 
                                                         ...);</pre>
 
893
<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>,
 
894
                                                         <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>,
 
895
                                                         <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>,
 
896
                                                         <em class="parameter"><code>...</code></em>);</pre>
1017
897
<p>
1018
898
This provides a convenient way to quickly send a message <em class="parameter"><code>method</code></em> at 
1019
899
<em class="parameter"><code>object_path</code></em> synchronously over the bus. The variable argument list 
1020
900
specifies key (string) value pairs used to construct the message 
1021
901
arguments. To send a message asynchronously use <a class="link" href="GeditMessageBus.html#gedit-message-bus-send" title="gedit_message_bus_send ()"><code class="function">gedit_message_bus_send()</code></a>.</p>
1022
 
<p>
1023
 
</p>
1024
902
<div class="variablelist"><table border="0">
1025
903
<col align="left" valign="top">
1026
904
<tbody>
1027
905
<tr>
1028
906
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
1029
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
907
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
1030
908
</td>
1031
909
</tr>
1032
910
<tr>
1033
911
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
1034
 
<td> the object path
 
912
<td>the object path
1035
913
</td>
1036
914
</tr>
1037
915
<tr>
1038
916
<td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td>
1039
 
<td> the method
 
917
<td>the method
1040
918
</td>
1041
919
</tr>
1042
920
<tr>
1043
921
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1044
 
<td> NULL terminated list of key/value pairs
 
922
<td>NULL terminated list of key/value pairs
1045
923
</td>
1046
924
</tr>
1047
925
<tr>
1048
926
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1049
927
<td> the constructed <a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a>. The caller owns a reference
1050
 
              to the <a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a> and should call <a
1051
 
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"
1052
 
><code class="function">g_object_unref()</code></a> when
 
928
              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
1053
929
              it is no longer needed
1054
930
</td>
1055
931
</tr>
1061
937
<a name="GeditMessageBus.signal-details"></a><h2>Signal Details</h2>
1062
938
<div class="refsect2" title='The "dispatch" signal'>
1063
939
<a name="GeditMessageBus-dispatch"></a><h3>The <code class="literal">"dispatch"</code> signal</h3>
1064
 
<pre class="programlisting">void                user_function                      (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a> *bus,
1065
 
                                                        <a class="link" href="GeditMessage.html" title="GeditMessage">GeditMessage</a>    *message,
1066
 
                                                        <a
1067
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1068
 
>gpointer</a>         user_data)      : Run Last</pre>
 
940
<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,
 
941
                                                        <a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a>    *message,
 
942
                                                        <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>
1069
943
<p>
1070
944
The "dispatch" signal is emitted when a message is to be dispatched.
1071
945
The message is dispatched in the default handler of this signal.
1072
946
Primary use of this signal is to customize the dispatch of a message
1073
947
(for instance to automatically dispatch all messages over DBus).
1074
948
2</p>
1075
 
<p>
1076
 
</p>
1077
949
<div class="variablelist"><table border="0">
1078
950
<col align="left" valign="top">
1079
951
<tbody>
1080
952
<tr>
1081
953
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
1082
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
954
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
1083
955
</td>
1084
956
</tr>
1085
957
<tr>
1086
958
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1087
 
<td> the <a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a> to dispatch
 
959
<td>the <a class="link" href="GeditMessage.html" title="GeditMessage"><span class="type">GeditMessage</span></a> to dispatch
1088
960
</td>
1089
961
</tr>
1090
962
<tr>
1097
969
<hr>
1098
970
<div class="refsect2" title='The "registered" signal'>
1099
971
<a name="GeditMessageBus-registered"></a><h3>The <code class="literal">"registered"</code> signal</h3>
1100
 
<pre class="programlisting">void                user_function                      (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a>  *bus,
1101
 
                                                        <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType">GeditMessageType</a> *message_type,
1102
 
                                                        <a
1103
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1104
 
>gpointer</a>          user_data)         : Run Last</pre>
 
972
<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,
 
973
                                                        <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a> *message_type,
 
974
                                                        <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>
1105
975
<p>
1106
976
The "registered" signal is emitted when a message has been registered
1107
977
on the bus.</p>
1108
 
<p>
1109
 
</p>
1110
978
<div class="variablelist"><table border="0">
1111
979
<col align="left" valign="top">
1112
980
<tbody>
1113
981
<tr>
1114
982
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
1115
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
983
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
1116
984
</td>
1117
985
</tr>
1118
986
<tr>
1119
987
<td><p><span class="term"><em class="parameter"><code>message_type</code></em> :</span></p></td>
1120
 
<td> the registered <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a>
 
988
<td>the registered <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a>
1121
989
</td>
1122
990
</tr>
1123
991
<tr>
1130
998
<hr>
1131
999
<div class="refsect2" title='The "unregistered" signal'>
1132
1000
<a name="GeditMessageBus-unregistered"></a><h3>The <code class="literal">"unregistered"</code> signal</h3>
1133
 
<pre class="programlisting">void                user_function                      (<a class="link" href="GeditMessageBus.html" title="GeditMessageBus">GeditMessageBus</a>  *bus,
1134
 
                                                        <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType">GeditMessageType</a> *message_type,
1135
 
                                                        <a
1136
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1137
 
>gpointer</a>          user_data)         : Run Last</pre>
 
1001
<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,
 
1002
                                                        <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a> *message_type,
 
1003
                                                        <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>
1138
1004
<p>
1139
1005
The "unregistered" signal is emitted when a message has been 
1140
1006
unregistered from the bus.</p>
1141
 
<p>
1142
 
</p>
1143
1007
<div class="variablelist"><table border="0">
1144
1008
<col align="left" valign="top">
1145
1009
<tbody>
1146
1010
<tr>
1147
1011
<td><p><span class="term"><em class="parameter"><code>bus</code></em> :</span></p></td>
1148
 
<td> a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
 
1012
<td>a <a class="link" href="GeditMessageBus.html" title="GeditMessageBus"><span class="type">GeditMessageBus</span></a>
1149
1013
</td>
1150
1014
</tr>
1151
1015
<tr>
1152
1016
<td><p><span class="term"><em class="parameter"><code>message_type</code></em> :</span></p></td>
1153
 
<td> the unregistered <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a>
 
1017
<td>the unregistered <a class="link" href="gedit-GeditMessageType.html#GeditMessageType" title="GeditMessageType"><span class="type">GeditMessageType</span></a>
1154
1018
</td>
1155
1019
</tr>
1156
1020
<tr>
1164
1028
</div>
1165
1029
<div class="footer">
1166
1030
<hr>
1167
 
          Generated by GTK-Doc V1.11</div>
 
1031
          Generated by GTK-Doc V1.14</div>
1168
1032
</body>
1169
 
</html>
 
1033
</html>
 
 
b'\\ No newline at end of file'