44
44
<a class="link" href="telepathy-glib-TpContactsMixin.html#TpContactsMixin" title="TpContactsMixin">TpContactsMixin</a>;
45
45
struct <a class="link" href="telepathy-glib-TpContactsMixin.html#TpContactsMixinClass" title="struct TpContactsMixinClass">TpContactsMixinClass</a>;
46
46
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-TpContactsMixin.html#tp-contacts-mixin-add-contact-attributes-iface" title="tp_contacts_mixin_add_contact_attributes_iface ()">tp_contacts_mixin_add_contact_attributes_iface</a>
47
(<em class="parameter"><code><span class="type">GObject</span> *obj</code></em>,
48
<em class="parameter"><code>const <span class="type">gchar</span> *interface</code></em>,
47
(<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
48
<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> *interface</code></em>,
49
49
<em class="parameter"><code><a class="link" href="telepathy-glib-TpContactsMixin.html#TpContactsMixinFillContactAttributesFunc" title="TpContactsMixinFillContactAttributesFunc ()"><span class="type">TpContactsMixinFillContactAttributesFunc</span></a> fill_contact_attributes</code></em>);
50
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-TpContactsMixin.html#tp-contacts-mixin-class-init" title="tp_contacts_mixin_class_init ()">tp_contacts_mixin_class_init</a> (<em class="parameter"><code><span class="type">GObjectClass</span> *obj_cls</code></em>,
51
<em class="parameter"><code><span class="type">glong</span> offset</code></em>);
52
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-TpContactsMixin.html#tp-contacts-mixin-finalize" title="tp_contacts_mixin_finalize ()">tp_contacts_mixin_finalize</a> (<em class="parameter"><code><span class="type">GObject</span> *obj</code></em>);
53
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-TpContactsMixin.html#tp-contacts-mixin-iface-init" title="tp_contacts_mixin_iface_init ()">tp_contacts_mixin_iface_init</a> (<em class="parameter"><code><span class="type">gpointer</span> g_iface</code></em>,
54
<em class="parameter"><code><span class="type">gpointer</span> iface_data</code></em>);
55
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-TpContactsMixin.html#tp-contacts-mixin-init" title="tp_contacts_mixin_init ()">tp_contacts_mixin_init</a> (<em class="parameter"><code><span class="type">GObject</span> *obj</code></em>,
50
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-TpContactsMixin.html#tp-contacts-mixin-class-init" title="tp_contacts_mixin_class_init ()">tp_contacts_mixin_class_init</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *obj_cls</code></em>,
51
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#glong"><span class="type">glong</span></a> offset</code></em>);
52
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-TpContactsMixin.html#tp-contacts-mixin-finalize" title="tp_contacts_mixin_finalize ()">tp_contacts_mixin_finalize</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>);
53
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-TpContactsMixin.html#tp-contacts-mixin-iface-init" title="tp_contacts_mixin_iface_init ()">tp_contacts_mixin_iface_init</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> g_iface</code></em>,
54
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> iface_data</code></em>);
55
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-TpContactsMixin.html#tp-contacts-mixin-init" title="tp_contacts_mixin_init ()">tp_contacts_mixin_init</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
56
56
<em class="parameter"><code><span class="type">gsize</span> offset</code></em>);
57
57
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-TpContactsMixin.html#tp-contacts-mixin-set-contact-attribute" title="tp_contacts_mixin_set_contact_attribute ()">tp_contacts_mixin_set_contact_attribute</a>
58
(<em class="parameter"><code><span class="type">GHashTable</span> *contact_attributes</code></em>,
58
(<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *contact_attributes</code></em>,
59
59
<em class="parameter"><code><a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="type">TpHandle</span></a> handle</code></em>,
60
<em class="parameter"><code>const <span class="type">gchar</span> *attribute</code></em>,
61
<em class="parameter"><code><span class="type">GValue</span> *value</code></em>);
62
<span class="returnvalue">GHashTable</span> * <a class="link" href="telepathy-glib-TpContactsMixin.html#tp-contacts-mixin-get-contact-attributes" title="tp_contacts_mixin_get_contact_attributes ()">tp_contacts_mixin_get_contact_attributes</a>
63
(<em class="parameter"><code><span class="type">GObject</span> *obj</code></em>,
64
<em class="parameter"><code>const <span class="type">GArray</span> *handles</code></em>,
65
<em class="parameter"><code>const <span class="type">gchar</span> **interfaces</code></em>,
66
<em class="parameter"><code>const <span class="type">gchar</span> **assumed_interfaces</code></em>,
67
<em class="parameter"><code>const <span class="type">gchar</span> *sender</code></em>);
60
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
61
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
62
<a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> * <a class="link" href="telepathy-glib-TpContactsMixin.html#tp-contacts-mixin-get-contact-attributes" title="tp_contacts_mixin_get_contact_attributes ()">tp_contacts_mixin_get_contact_attributes</a>
63
(<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
64
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *handles</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> **interfaces</code></em>,
66
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **assumed_interfaces</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> *sender</code></em>);
68
68
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-TpContactsMixin.html#TpContactsMixinFillContactAttributesFunc" title="TpContactsMixinFillContactAttributesFunc ()">*TpContactsMixinFillContactAttributesFunc</a>)
69
(<em class="parameter"><code><span class="type">GObject</span> *obj</code></em>,
70
<em class="parameter"><code>const <span class="type">GArray</span> *contacts</code></em>,
71
<em class="parameter"><code><span class="type">GHashTable</span> *attributes_hash</code></em>);
69
(<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
70
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *contacts</code></em>,
71
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *attributes_hash</code></em>);
74
74
<div class="refsect1">
159
159
<div class="refsect2">
160
160
<a name="tp-contacts-mixin-class-init"></a><h3>tp_contacts_mixin_class_init ()</h3>
161
<pre class="programlisting"><span class="returnvalue">void</span> tp_contacts_mixin_class_init (<em class="parameter"><code><span class="type">GObjectClass</span> *obj_cls</code></em>,
162
<em class="parameter"><code><span class="type">glong</span> offset</code></em>);</pre>
161
<pre class="programlisting"><span class="returnvalue">void</span> tp_contacts_mixin_class_init (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *obj_cls</code></em>,
162
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#glong"><span class="type">glong</span></a> offset</code></em>);</pre>
164
164
Initialize the contacts mixin. Should be called from the implementation's
165
165
class_init function like so:
169
<div class="informalexample"><pre class="programlisting">
170
tp_contacts_mixin_class_init ((GObjectClass *) klass,
171
G_STRUCT_OFFSET (SomeObjectClass, contacts_mixin));
169
<div class="informalexample">
170
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
173
<td class="listing_lines" align="right"><pre>1
175
<td class="listing_code"><pre class="programlisting"><span class="function"><a href="telepathy-glib-TpContactsMixin.html#tp-contacts-mixin-class-init">tp_contacts_mixin_class_init</a></span> <span class="gtkdoc opt">((</span>GObjectClass <span class="gtkdoc opt">*)</span> klass<span class="gtkdoc opt">,</span>
176
<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#G-STRUCT-OFFSET:CAPS">G_STRUCT_OFFSET</a></span> <span class="gtkdoc opt">(</span>SomeObjectClass<span class="gtkdoc opt">,</span> contacts_mixin<span class="gtkdoc opt">));</span></pre></td>
175
184
<div class="variablelist"><table border="0">
266
284
<div class="refsect2">
267
285
<a name="tp-contacts-mixin-set-contact-attribute"></a><h3>tp_contacts_mixin_set_contact_attribute ()</h3>
268
286
<pre class="programlisting"><span class="returnvalue">void</span> tp_contacts_mixin_set_contact_attribute
269
(<em class="parameter"><code><span class="type">GHashTable</span> *contact_attributes</code></em>,
287
(<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *contact_attributes</code></em>,
270
288
<em class="parameter"><code><a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="type">TpHandle</span></a> handle</code></em>,
271
<em class="parameter"><code>const <span class="type">gchar</span> *attribute</code></em>,
272
<em class="parameter"><code><span class="type">GValue</span> *value</code></em>);</pre>
289
<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> *attribute</code></em>,
290
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
274
292
Utility function to set attribute for handle to value in the attributes hash
275
293
as passed to a TpContactsMixinFillContactAttributesFunc.
304
322
<div class="refsect2">
305
323
<a name="tp-contacts-mixin-get-contact-attributes"></a><h3>tp_contacts_mixin_get_contact_attributes ()</h3>
306
<pre class="programlisting"><span class="returnvalue">GHashTable</span> * tp_contacts_mixin_get_contact_attributes
307
(<em class="parameter"><code><span class="type">GObject</span> *obj</code></em>,
308
<em class="parameter"><code>const <span class="type">GArray</span> *handles</code></em>,
309
<em class="parameter"><code>const <span class="type">gchar</span> **interfaces</code></em>,
310
<em class="parameter"><code>const <span class="type">gchar</span> **assumed_interfaces</code></em>,
311
<em class="parameter"><code>const <span class="type">gchar</span> *sender</code></em>);</pre>
324
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> * tp_contacts_mixin_get_contact_attributes
325
(<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
326
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *handles</code></em>,
327
<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> **interfaces</code></em>,
328
<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> **assumed_interfaces</code></em>,
329
<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> *sender</code></em>);</pre>
313
331
Get contact attributes for the given contacts. Provide attributes for all requested
314
332
interfaces. If contact attributes are not immediately known, the behaviour is defined
355
373
<div class="refsect2">
356
374
<a name="TpContactsMixinFillContactAttributesFunc"></a><h3>TpContactsMixinFillContactAttributesFunc ()</h3>
357
375
<pre class="programlisting"><span class="returnvalue">void</span> (*TpContactsMixinFillContactAttributesFunc)
358
(<em class="parameter"><code><span class="type">GObject</span> *obj</code></em>,
359
<em class="parameter"><code>const <span class="type">GArray</span> *contacts</code></em>,
360
<em class="parameter"><code><span class="type">GHashTable</span> *attributes_hash</code></em>);</pre>
376
(<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
377
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *contacts</code></em>,
378
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *attributes_hash</code></em>);</pre>
362
380
This function is called to supply contact attributes pertaining to
363
381
a particular interface, for a list of contacts.