~ubuntu-branches/ubuntu/maverick/telepathy-glib/maverick

« back to all changes in this revision

Viewing changes to docs/reference/html/telepathy-glib-TpPropertiesMixin.html

  • Committer: Bazaar Package Importer
  • Author(s): Simon McVittie
  • Date: 2010-05-10 17:59:54 UTC
  • mfrom: (1.6.1 upstream) (27.1.3 sid)
  • Revision ID: james.westby@ubuntu.com-20100510175954-bxvqq3xx0sy4itmp
Tags: 0.11.5-1
New upstream version with new API/ABI

Show diffs side-by-side

added added

removed removed

Lines of Context:
8
8
<link rel="up" href="ch-service-base.html" title="Service-side implementation">
9
9
<link rel="prev" href="telepathy-glib-TpPresenceMixin.html" title="TpPresenceMixin">
10
10
<link rel="next" href="telepathy-glib-TpGroupMixin.html" title="TpGroupMixin">
11
 
<meta name="generator" content="GTK-Doc V1.13 (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
 
<link rel="chapter" href="ch-dbus.html" title="General D-Bus support">
14
 
<link rel="chapter" href="ch-protocol.html" title="The Telepathy protocol">
15
 
<link rel="chapter" href="ch-client.html" title="Client-side proxies">
16
 
<link rel="chapter" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
17
 
<link rel="chapter" href="ch-service-base.html" title="Service-side implementation">
18
 
<link rel="chapter" href="ch-service-handles.html" title="Service-side handle repositories">
19
 
<link rel="chapter" href="ch-utilities.html" title="Utilities">
20
13
</head>
21
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
22
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
51
44
                    <a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertySignature" title="TpPropertySignature">TpPropertySignature</a>;
52
45
                    <a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpProperty" title="TpProperty">TpProperty</a>;
53
46
                    <a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext">TpPropertiesContext</a>;
54
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (<a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesSetFunc" title="TpPropertiesSetFunc ()">*TpPropertiesSetFunc</a>)              (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
55
 
                                                         <a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="returnvalue">TpPropertiesContext</span></a> *ctx,
56
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
 
47
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (<a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesSetFunc" title="TpPropertiesSetFunc ()">*TpPropertiesSetFunc</a>)              (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
48
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="type">TpPropertiesContext</span></a> *ctx</code></em>,
 
49
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
57
50
                    <a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesMixin" title="TpPropertiesMixin">TpPropertiesMixin</a>;
58
51
                    <a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesMixinClass" title="TpPropertiesMixinClass">TpPropertiesMixinClass</a>;
59
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-class-init" title="tp_properties_mixin_class_init ()">tp_properties_mixin_class_init</a>      (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="returnvalue">GObjectClass</span></a> *obj_cls,
60
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#glong"><span class="returnvalue">glong</span></a> offset,
61
 
                                                         const <a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertySignature" title="TpPropertySignature"><span class="returnvalue">TpPropertySignature</span></a> *signatures,
62
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> num_properties,
63
 
                                                         <a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesSetFunc" title="TpPropertiesSetFunc ()"><span class="returnvalue">TpPropertiesSetFunc</span></a> set_func);
64
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-init" title="tp_properties_mixin_init ()">tp_properties_mixin_init</a>            (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
65
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#glong"><span class="returnvalue">glong</span></a> offset);
66
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-finalize" title="tp_properties_mixin_finalize ()">tp_properties_mixin_finalize</a>        (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj);
67
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-list-properties" title="tp_properties_mixin_list_properties ()">tp_properties_mixin_list_properties</a> (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
68
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> **ret,
69
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
70
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-get-properties" title="tp_properties_mixin_get_properties ()">tp_properties_mixin_get_properties</a>  (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
71
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *properties,
72
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> **ret,
73
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
74
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-set-properties" title="tp_properties_mixin_set_properties ()">tp_properties_mixin_set_properties</a>  (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
75
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *properties,
76
 
                                                         <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="returnvalue">DBusGMethodInvocation</span></a> *context);
77
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-has-property" title="tp_properties_mixin_has_property ()">tp_properties_mixin_has_property</a>    (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
78
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *name,
79
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> *property);
80
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-has" title="tp_properties_context_has ()">tp_properties_context_has</a>           (<a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="returnvalue">TpPropertiesContext</span></a> *ctx,
81
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> property);
82
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-has-other-than" title="tp_properties_context_has_other_than ()">tp_properties_context_has_other_than</a>
83
 
                                                        (<a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="returnvalue">TpPropertiesContext</span></a> *ctx,
84
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> property);
85
 
const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *      <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-get" title="tp_properties_context_get ()">tp_properties_context_get</a>           (<a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="returnvalue">TpPropertiesContext</span></a> *ctx,
86
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> property);
87
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-get-value-count" title="tp_properties_context_get_value_count ()">tp_properties_context_get_value_count</a>
88
 
                                                        (<a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="returnvalue">TpPropertiesContext</span></a> *ctx);
89
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-remove" title="tp_properties_context_remove ()">tp_properties_context_remove</a>        (<a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="returnvalue">TpPropertiesContext</span></a> *ctx,
90
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> property);
91
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-return" title="tp_properties_context_return ()">tp_properties_context_return</a>        (<a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="returnvalue">TpPropertiesContext</span></a> *ctx,
92
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error);
93
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-return-if-done" title="tp_properties_context_return_if_done ()">tp_properties_context_return_if_done</a>
94
 
                                                        (<a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="returnvalue">TpPropertiesContext</span></a> *ctx);
95
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-change-value" title="tp_properties_mixin_change_value ()">tp_properties_mixin_change_value</a>    (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
96
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> prop_id,
97
 
                                                         const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *new_value,
98
 
                                                         <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="returnvalue">TpIntSet</span></a> *props);
99
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-change-flags" title="tp_properties_mixin_change_flags ()">tp_properties_mixin_change_flags</a>    (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
100
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> prop_id,
101
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpPropertyFlags" title="enum TpPropertyFlags"><span class="returnvalue">TpPropertyFlags</span></a> add,
102
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpPropertyFlags" title="enum TpPropertyFlags"><span class="returnvalue">TpPropertyFlags</span></a> del,
103
 
                                                         <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="returnvalue">TpIntSet</span></a> *props);
104
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-emit-changed" title="tp_properties_mixin_emit_changed ()">tp_properties_mixin_emit_changed</a>    (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
105
 
                                                         const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="returnvalue">TpIntSet</span></a> *props);
106
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-emit-flags" title="tp_properties_mixin_emit_flags ()">tp_properties_mixin_emit_flags</a>      (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
107
 
                                                         const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="returnvalue">TpIntSet</span></a> *props);
108
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-is-readable" title="tp_properties_mixin_is_readable ()">tp_properties_mixin_is_readable</a>     (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
109
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> prop_id);
110
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-is-writable" title="tp_properties_mixin_is_writable ()">tp_properties_mixin_is_writable</a>     (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
111
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> prop_id);
112
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-iface-init" title="tp_properties_mixin_iface_init ()">tp_properties_mixin_iface_init</a>      (<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> g_iface,
113
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> iface_data);
 
52
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-class-init" title="tp_properties_mixin_class_init ()">tp_properties_mixin_class_init</a>      (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *obj_cls</code></em>,
 
53
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#glong"><span class="type">glong</span></a> offset</code></em>,
 
54
                                                         <em class="parameter"><code>const <a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertySignature" title="TpPropertySignature"><span class="type">TpPropertySignature</span></a> *signatures</code></em>,
 
55
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> num_properties</code></em>,
 
56
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesSetFunc" title="TpPropertiesSetFunc ()"><span class="type">TpPropertiesSetFunc</span></a> set_func</code></em>);
 
57
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-init" title="tp_properties_mixin_init ()">tp_properties_mixin_init</a>            (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
58
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#glong"><span class="type">glong</span></a> offset</code></em>);
 
59
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-finalize" title="tp_properties_mixin_finalize ()">tp_properties_mixin_finalize</a>        (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>);
 
60
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-list-properties" title="tp_properties_mixin_list_properties ()">tp_properties_mixin_list_properties</a> (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
61
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> **ret</code></em>,
 
62
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 
63
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-get-properties" title="tp_properties_mixin_get_properties ()">tp_properties_mixin_get_properties</a>  (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
64
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *properties</code></em>,
 
65
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> **ret</code></em>,
 
66
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 
67
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-set-properties" title="tp_properties_mixin_set_properties ()">tp_properties_mixin_set_properties</a>  (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
68
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *properties</code></em>,
 
69
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);
 
70
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-has-property" title="tp_properties_mixin_has_property ()">tp_properties_mixin_has_property</a>    (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
71
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 
72
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *property</code></em>);
 
73
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-has" title="tp_properties_context_has ()">tp_properties_context_has</a>           (<em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="type">TpPropertiesContext</span></a> *ctx</code></em>,
 
74
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property</code></em>);
 
75
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-has-other-than" title="tp_properties_context_has_other_than ()">tp_properties_context_has_other_than</a>
 
76
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="type">TpPropertiesContext</span></a> *ctx</code></em>,
 
77
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property</code></em>);
 
78
const <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *      <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-get" title="tp_properties_context_get ()">tp_properties_context_get</a>           (<em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="type">TpPropertiesContext</span></a> *ctx</code></em>,
 
79
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property</code></em>);
 
80
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-get-value-count" title="tp_properties_context_get_value_count ()">tp_properties_context_get_value_count</a>
 
81
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="type">TpPropertiesContext</span></a> *ctx</code></em>);
 
82
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-remove" title="tp_properties_context_remove ()">tp_properties_context_remove</a>        (<em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="type">TpPropertiesContext</span></a> *ctx</code></em>,
 
83
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property</code></em>);
 
84
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-return" title="tp_properties_context_return ()">tp_properties_context_return</a>        (<em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="type">TpPropertiesContext</span></a> *ctx</code></em>,
 
85
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>);
 
86
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-return-if-done" title="tp_properties_context_return_if_done ()">tp_properties_context_return_if_done</a>
 
87
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="type">TpPropertiesContext</span></a> *ctx</code></em>);
 
88
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-change-value" title="tp_properties_mixin_change_value ()">tp_properties_mixin_change_value</a>    (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
89
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> prop_id</code></em>,
 
90
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *new_value</code></em>,
 
91
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *props</code></em>);
 
92
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-change-flags" title="tp_properties_mixin_change_flags ()">tp_properties_mixin_change_flags</a>    (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
93
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> prop_id</code></em>,
 
94
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpPropertyFlags" title="enum TpPropertyFlags"><span class="type">TpPropertyFlags</span></a> add</code></em>,
 
95
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpPropertyFlags" title="enum TpPropertyFlags"><span class="type">TpPropertyFlags</span></a> del</code></em>,
 
96
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *props</code></em>);
 
97
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-emit-changed" title="tp_properties_mixin_emit_changed ()">tp_properties_mixin_emit_changed</a>    (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
98
                                                         <em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *props</code></em>);
 
99
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-emit-flags" title="tp_properties_mixin_emit_flags ()">tp_properties_mixin_emit_flags</a>      (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
100
                                                         <em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *props</code></em>);
 
101
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-is-readable" title="tp_properties_mixin_is_readable ()">tp_properties_mixin_is_readable</a>     (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
102
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> prop_id</code></em>);
 
103
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-is-writable" title="tp_properties_mixin_is_writable ()">tp_properties_mixin_is_writable</a>     (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
104
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> prop_id</code></em>);
 
105
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-iface-init" title="tp_properties_mixin_iface_init ()">tp_properties_mixin_iface_init</a>      (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> g_iface</code></em>,
 
106
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> iface_data</code></em>);
114
107
#define             <a class="link" href="telepathy-glib-TpPropertiesMixin.html#TP-TYPE-PROPERTY-INFO-STRUCT:CAPS" title="TP_TYPE_PROPERTY_INFO_STRUCT">TP_TYPE_PROPERTY_INFO_STRUCT</a>
115
108
#define             <a class="link" href="telepathy-glib-TpPropertiesMixin.html#TP-TYPE-PROPERTY-INFO-LIST:CAPS" title="TP_TYPE_PROPERTY_INFO_LIST">TP_TYPE_PROPERTY_INFO_LIST</a>
116
109
#define             <a class="link" href="telepathy-glib-TpPropertiesMixin.html#TP-TYPE-PROPERTY-VALUE-STRUCT:CAPS" title="TP_TYPE_PROPERTY_VALUE_STRUCT">TP_TYPE_PROPERTY_VALUE_STRUCT</a>
138
131
<a class="link" href="telepathy-glib-svc-generic.html#TpSvcPropertiesInterface"><span class="type">TpSvcPropertiesInterface</span></a>, call
139
132
<code class="literal">G_IMPLEMENT_INTERFACE (TP_TYPE_SVC_PROPERTIES_INTERFACE,
140
133
tp_properties_mixin_iface_init)</code> in the fourth argument to
141
 
<code class="literal">G_DEFINE_TYPE_WITH_CODE</code>.</p>
 
134
<code class="literal">G_DEFINE_TYPE_WITH_CODE</code>.
 
135
</p>
142
136
</div>
143
137
<div class="refsect1" title="Details">
144
138
<a name="telepathy-glib-TpPropertiesMixin.details"></a><h2>Details</h2>
150
144
} TpPropertySignature;
151
145
</pre>
152
146
<p>
153
 
Signature of a property in the Telepathy properties interface.</p>
 
147
Signature of a property in the Telepathy properties interface.
 
148
</p>
154
149
<div class="variablelist"><table border="0">
155
150
<col align="left" valign="top">
156
151
<tbody>
157
152
<tr>
158
 
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="TpPropertySignature.name"></a>name</code></em>;</span></p></td>
159
 
<td> Name of the property as seen in the Telepathy D-Bus protocol
 
153
<td><p><span class="term"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="TpPropertySignature.name"></a>name</code></em>;</span></p></td>
 
154
<td>Name of the property as seen in the Telepathy D-Bus protocol
160
155
</td>
161
156
</tr>
162
157
<tr>
163
 
<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> <em class="structfield"><code><a name="TpPropertySignature.type"></a>type</code></em>;</span></p></td>
164
 
<td> GType which the variant value must have. We currently support
165
 
 only <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-UINT:CAPS"><code class="literal">G_TYPE_UINT</code></a>, <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INT:CAPS"><code class="literal">G_TYPE_INT</code></a>, <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a>, <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-BOOLEAN:CAPS"><code class="literal">G_TYPE_BOOLEAN</code></a>,
 
158
<td><p><span class="term"><a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> <em class="structfield"><code><a name="TpPropertySignature.type"></a>type</code></em>;</span></p></td>
 
159
<td>GType which the variant value must have. We currently support
 
160
 only <a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#G-TYPE-UINT:CAPS"><code class="literal">G_TYPE_UINT</code></a>, <a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#G-TYPE-INT:CAPS"><code class="literal">G_TYPE_INT</code></a>, <a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a>, <a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#G-TYPE-BOOLEAN:CAPS"><code class="literal">G_TYPE_BOOLEAN</code></a>,
166
161
 corresponding to D-Bus signatures 'u', 'i', 's', 'b'.
167
162
</td>
168
163
</tr>
180
175
} TpProperty;
181
176
</pre>
182
177
<p>
183
 
Structure representing the current state of a property.</p>
 
178
Structure representing the current state of a property.
 
179
</p>
184
180
<div class="variablelist"><table border="0">
185
181
<col align="left" valign="top">
186
182
<tbody>
187
183
<tr>
188
 
<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *<em class="structfield"><code><a name="TpProperty.value"></a>value</code></em>;</span></p></td>
189
 
<td> The value of the property
 
184
<td><p><span class="term"><a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *<em class="structfield"><code><a name="TpProperty.value"></a>value</code></em>;</span></p></td>
 
185
<td>The value of the property
190
186
</td>
191
187
</tr>
192
188
<tr>
193
 
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="TpProperty.flags"></a>flags</code></em>;</span></p></td>
194
 
<td> <a class="link" href="telepathy-glib-enums.html#TpPropertyFlags" title="enum TpPropertyFlags"><span class="type">TpPropertyFlags</span></a> indicating the property's permissions
 
189
<td><p><span class="term"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="TpProperty.flags"></a>flags</code></em>;</span></p></td>
 
190
<td>
 
191
<a class="link" href="telepathy-glib-enums.html#TpPropertyFlags" title="enum TpPropertyFlags"><span class="type">TpPropertyFlags</span></a> indicating the property's permissions
195
192
</td>
196
193
</tr>
197
194
</tbody>
203
200
<pre class="programlisting">typedef struct _TpPropertiesContext TpPropertiesContext;</pre>
204
201
<p>
205
202
Opaque pointer representing an incomplete property-setting operation, used
206
 
in the implementation of SetProperties.</p>
 
203
in the implementation of SetProperties.
 
204
</p>
207
205
</div>
208
206
<hr>
209
207
<div class="refsect2" title="TpPropertiesSetFunc ()">
210
208
<a name="TpPropertiesSetFunc"></a><h3>TpPropertiesSetFunc ()</h3>
211
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (*TpPropertiesSetFunc)              (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
212
 
                                                         <a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="returnvalue">TpPropertiesContext</span></a> *ctx,
213
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);</pre>
 
209
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (*TpPropertiesSetFunc)              (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
210
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="type">TpPropertiesContext</span></a> *ctx</code></em>,
 
211
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
214
212
<p>
215
213
A callback used to implement the SetProperties D-Bus method by setting
216
214
properties in the underlying IM protocol.
219
217
The callback must either:
220
218
</p>
221
219
<p>
222
 
* return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to indicate immediate failure
 
220
* return <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to indicate immediate failure
223
221
* call <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-return" title="tp_properties_context_return ()"><code class="function">tp_properties_context_return()</code></a> with an error to indicate failure
224
222
* call <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-remove" title="tp_properties_context_remove ()"><code class="function">tp_properties_context_remove()</code></a> to remove each property from the set
225
223
  of pending properties, then call <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-return-if-done" title="tp_properties_context_return_if_done ()"><code class="function">tp_properties_context_return_if_done()</code></a>
226
 
  or <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-return" title="tp_properties_context_return ()"><code class="function">tp_properties_context_return()</code></a> when all were set</p>
 
224
  or <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-context-return" title="tp_properties_context_return ()"><code class="function">tp_properties_context_return()</code></a> when all were set
 
225
</p>
227
226
<div class="variablelist"><table border="0">
228
227
<col align="left" valign="top">
229
228
<tbody>
230
229
<tr>
231
230
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
232
 
<td> An object with the properties mixin
 
231
<td>An object with the properties mixin
233
232
</td>
234
233
</tr>
235
234
<tr>
236
235
<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td>
237
 
<td> A properties context
 
236
<td>A properties context
238
237
</td>
239
238
</tr>
240
239
<tr>
241
240
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
242
 
<td> Set to the error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned
 
241
<td>Set to the error if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned
243
242
</td>
244
243
</tr>
245
244
<tr>
246
245
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
247
 
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on immediate failure, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> otherwise
 
246
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on immediate failure, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> otherwise
248
247
</td>
249
248
</tr>
250
249
</tbody>
262
261
<p>
263
262
Structure to be placed in a GObject-derived structure containing
264
263
instance data for the properties mixin (i.e. the properties). Initialize
265
 
it using <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-init" title="tp_properties_mixin_init ()"><code class="function">tp_properties_mixin_init()</code></a>.</p>
 
264
it using <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-init" title="tp_properties_mixin_init ()"><code class="function">tp_properties_mixin_init()</code></a>.
 
265
</p>
266
266
<div class="variablelist"><table border="0">
267
267
<col align="left" valign="top">
268
268
<tbody>
269
269
<tr>
270
270
<td><p><span class="term"><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpProperty" title="TpProperty"><span class="type">TpProperty</span></a> *<em class="structfield"><code><a name="TpPropertiesMixin.properties"></a>properties</code></em>;</span></p></td>
271
 
<td> Array of property values, of length klass-&gt;num_props.
 
271
<td>Array of property values, of length klass-&gt;num_props.
272
272
 Should be considered read-only.
273
273
</td>
274
274
</tr>
275
275
<tr>
276
276
<td><p><span class="term"><span class="type">TpPropertiesMixinPrivate</span> *<em class="structfield"><code><a name="TpPropertiesMixin.priv"></a>priv</code></em>;</span></p></td>
277
 
<td> Pointer to opaque private data.
 
277
<td>Pointer to opaque private data.
278
278
</td>
279
279
</tr>
280
280
</tbody>
298
298
<a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-class-init" title="tp_properties_mixin_class_init ()"><code class="function">tp_properties_mixin_class_init()</code></a>.
299
299
</p>
300
300
<p>
301
 
All fields should be considered read-only.</p>
 
301
All fields should be considered read-only.
 
302
</p>
302
303
<div class="variablelist"><table border="0">
303
304
<col align="left" valign="top">
304
305
<tbody>
305
306
<tr>
306
307
<td><p><span class="term">const <a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertySignature" title="TpPropertySignature"><span class="type">TpPropertySignature</span></a> *<em class="structfield"><code><a name="TpPropertiesMixinClass.signatures"></a>signatures</code></em>;</span></p></td>
307
 
<td> Array of property signatures, as provided via
 
308
<td>Array of property signatures, as provided via
308
309
 <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-class-init" title="tp_properties_mixin_class_init ()"><code class="function">tp_properties_mixin_class_init()</code></a>, of length <em class="parameter"><code>num_props</code></em>.
309
310
</td>
310
311
</tr>
311
312
<tr>
312
 
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="TpPropertiesMixinClass.num-props"></a>num_props</code></em>;</span></p></td>
313
 
<td> Number of properties supported.
 
313
<td><p><span class="term"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="TpPropertiesMixinClass.num-props"></a>num_props</code></em>;</span></p></td>
 
314
<td>Number of properties supported.
314
315
</td>
315
316
</tr>
316
317
<tr>
317
318
<td><p><span class="term"><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesSetFunc" title="TpPropertiesSetFunc ()"><span class="type">TpPropertiesSetFunc</span></a> <em class="structfield"><code><a name="TpPropertiesMixinClass.set-properties"></a>set_properties</code></em>;</span></p></td>
318
 
<td> Properties setting function, as supplied to
 
319
<td>Properties setting function, as supplied to
319
320
 <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-class-init" title="tp_properties_mixin_class_init ()"><code class="function">tp_properties_mixin_class_init()</code></a>.
320
321
</td>
321
322
</tr>
322
323
<tr>
323
324
<td><p><span class="term"><span class="type">TpPropertiesMixinClassPrivate</span> *<em class="structfield"><code><a name="TpPropertiesMixinClass.priv"></a>priv</code></em>;</span></p></td>
324
 
<td> Pointer to opaque private data.
 
325
<td>Pointer to opaque private data.
325
326
</td>
326
327
</tr>
327
328
</tbody>
330
331
<hr>
331
332
<div class="refsect2" title="tp_properties_mixin_class_init ()">
332
333
<a name="tp-properties-mixin-class-init"></a><h3>tp_properties_mixin_class_init ()</h3>
333
 
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_class_init      (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="returnvalue">GObjectClass</span></a> *obj_cls,
334
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#glong"><span class="returnvalue">glong</span></a> offset,
335
 
                                                         const <a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertySignature" title="TpPropertySignature"><span class="returnvalue">TpPropertySignature</span></a> *signatures,
336
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> num_properties,
337
 
                                                         <a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesSetFunc" title="TpPropertiesSetFunc ()"><span class="returnvalue">TpPropertiesSetFunc</span></a> set_func);</pre>
 
334
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_class_init      (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *obj_cls</code></em>,
 
335
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#glong"><span class="type">glong</span></a> offset</code></em>,
 
336
                                                         <em class="parameter"><code>const <a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertySignature" title="TpPropertySignature"><span class="type">TpPropertySignature</span></a> *signatures</code></em>,
 
337
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> num_properties</code></em>,
 
338
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesSetFunc" title="TpPropertiesSetFunc ()"><span class="type">TpPropertiesSetFunc</span></a> set_func</code></em>);</pre>
338
339
<p>
339
340
Initialize the mixin. Should be called from the implementation's
340
341
class_init function like so:
349
350
2
350
351
3</pre></td>
351
352
        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-class-init">tp_properties_mixin_class_init</a></span> <span class="symbol">((</span>GObjectClass <span class="symbol">*)</span> klass<span class="symbol">,</span>
352
 
                                <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="symbol">(</span>SomeObjectClass<span class="symbol">,</span>
 
353
                                <span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#G-STRUCT-OFFSET:CAPS">G_STRUCT_OFFSET</a></span> <span class="symbol">(</span>SomeObjectClass<span class="symbol">,</span>
353
354
                                 properties_mixin<span class="symbol">));</span></pre></td>
354
355
      </tr>
355
356
    </tbody>
356
357
  </table>
357
358
</div>
358
359
 
 
360
<p>
 
361
</p>
359
362
<div class="variablelist"><table border="0">
360
363
<col align="left" valign="top">
361
364
<tbody>
362
365
<tr>
363
366
<td><p><span class="term"><em class="parameter"><code>obj_cls</code></em> :</span></p></td>
364
 
<td> The class of an object that has this mixin
 
367
<td>The class of an object that has this mixin
365
368
</td>
366
369
</tr>
367
370
<tr>
368
371
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
369
 
<td> The offset of the TpPropertiesMixinClass structure in the class
 
372
<td>The offset of the TpPropertiesMixinClass structure in the class
370
373
         structure
371
374
</td>
372
375
</tr>
373
376
<tr>
374
377
<td><p><span class="term"><em class="parameter"><code>signatures</code></em> :</span></p></td>
375
 
<td> An array of property signatures
 
378
<td>An array of property signatures
376
379
</td>
377
380
</tr>
378
381
<tr>
379
382
<td><p><span class="term"><em class="parameter"><code>num_properties</code></em> :</span></p></td>
380
 
<td> The number of entries in <em class="parameter"><code>signatures</code></em>
 
383
<td>The number of entries in <em class="parameter"><code>signatures</code></em>
381
384
</td>
382
385
</tr>
383
386
<tr>
384
387
<td><p><span class="term"><em class="parameter"><code>set_func</code></em> :</span></p></td>
385
 
<td> Callback used to set the properties
 
388
<td>Callback used to set the properties
386
389
</td>
387
390
</tr>
388
391
</tbody>
391
394
<hr>
392
395
<div class="refsect2" title="tp_properties_mixin_init ()">
393
396
<a name="tp-properties-mixin-init"></a><h3>tp_properties_mixin_init ()</h3>
394
 
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_init            (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
395
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#glong"><span class="returnvalue">glong</span></a> offset);</pre>
 
397
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_init            (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
398
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#glong"><span class="type">glong</span></a> offset</code></em>);</pre>
396
399
<p>
397
400
Initialize the mixin. Should be called from the implementation's
398
401
instance init function like so:
407
410
2
408
411
3</pre></td>
409
412
        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-init">tp_properties_mixin_init</a></span> <span class="symbol">((</span>GObject <span class="symbol">*)</span> self<span class="symbol">,</span>
410
 
                          <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="symbol">(</span>SomeObject<span class="symbol">,</span> properties_mixin<span class="symbol">),</span>
 
413
                          <span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#G-STRUCT-OFFSET:CAPS">G_STRUCT_OFFSET</a></span> <span class="symbol">(</span>SomeObject<span class="symbol">,</span> properties_mixin<span class="symbol">),</span>
411
414
                          self<span class="symbol">-&gt;</span>contact_repo<span class="symbol">);</span></pre></td>
412
415
      </tr>
413
416
    </tbody>
414
417
  </table>
415
418
</div>
416
419
 
 
420
<p>
 
421
</p>
417
422
<div class="variablelist"><table border="0">
418
423
<col align="left" valign="top">
419
424
<tbody>
420
425
<tr>
421
426
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
422
 
<td> An object that has this mixin
 
427
<td>An object that has this mixin
423
428
</td>
424
429
</tr>
425
430
<tr>
426
431
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
427
 
<td> The offset of the TpPropertiesMixin structure in the object
 
432
<td>The offset of the TpPropertiesMixin structure in the object
428
433
         structure
429
434
</td>
430
435
</tr>
434
439
<hr>
435
440
<div class="refsect2" title="tp_properties_mixin_finalize ()">
436
441
<a name="tp-properties-mixin-finalize"></a><h3>tp_properties_mixin_finalize ()</h3>
437
 
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_finalize        (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj);</pre>
 
442
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_finalize        (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>);</pre>
438
443
<p>
439
 
Free memory used by the TpPropertiesMixin.</p>
 
444
Free memory used by the TpPropertiesMixin.
 
445
</p>
440
446
<div class="variablelist"><table border="0">
441
447
<col align="left" valign="top">
442
448
<tbody><tr>
443
449
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
444
 
<td> An object that has this mixin
 
450
<td>An object that has this mixin
445
451
</td>
446
452
</tr></tbody>
447
453
</table></div>
449
455
<hr>
450
456
<div class="refsect2" title="tp_properties_mixin_list_properties ()">
451
457
<a name="tp-properties-mixin-list-properties"></a><h3>tp_properties_mixin_list_properties ()</h3>
452
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_properties_mixin_list_properties (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
453
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> **ret,
454
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);</pre>
 
458
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_properties_mixin_list_properties (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
459
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> **ret</code></em>,
 
460
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
455
461
<p>
456
462
List all available properties and their flags, as in the ListProperties
457
 
D-Bus method.</p>
 
463
D-Bus method.
 
464
</p>
458
465
<div class="variablelist"><table border="0">
459
466
<col align="left" valign="top">
460
467
<tbody>
461
468
<tr>
462
469
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
463
 
<td> An object with this mixin
 
470
<td>An object with this mixin
464
471
</td>
465
472
</tr>
466
473
<tr>
467
474
<td><p><span class="term"><em class="parameter"><code>ret</code></em> :</span></p></td>
468
 
<td> Output parameter which will be set to a GPtrArray of D-Bus structures
469
 
      if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned
 
475
<td>Output parameter which will be set to a GPtrArray of D-Bus structures
 
476
      if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned
470
477
</td>
471
478
</tr>
472
479
<tr>
473
480
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
474
 
<td> Set to the error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned
 
481
<td>Set to the error if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned
475
482
</td>
476
483
</tr>
477
484
<tr>
478
485
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
479
 
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success
 
486
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success
480
487
</td>
481
488
</tr>
482
489
</tbody>
485
492
<hr>
486
493
<div class="refsect2" title="tp_properties_mixin_get_properties ()">
487
494
<a name="tp-properties-mixin-get-properties"></a><h3>tp_properties_mixin_get_properties ()</h3>
488
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_properties_mixin_get_properties  (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
489
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *properties,
490
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> **ret,
491
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);</pre>
 
495
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_properties_mixin_get_properties  (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
496
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *properties</code></em>,
 
497
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> **ret</code></em>,
 
498
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
492
499
<p>
493
500
Retrieve the values of the given properties, as in the GetProperties
494
 
D-Bus method.</p>
 
501
D-Bus method.
 
502
</p>
495
503
<div class="variablelist"><table border="0">
496
504
<col align="left" valign="top">
497
505
<tbody>
498
506
<tr>
499
507
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
500
 
<td> An object with this mixin
 
508
<td>An object with this mixin
501
509
</td>
502
510
</tr>
503
511
<tr>
504
512
<td><p><span class="term"><em class="parameter"><code>properties</code></em> :</span></p></td>
505
 
<td> an array of integer property IDs
 
513
<td>an array of integer property IDs
506
514
</td>
507
515
</tr>
508
516
<tr>
509
517
<td><p><span class="term"><em class="parameter"><code>ret</code></em> :</span></p></td>
510
 
<td> set to an array of D-Bus structures if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned
 
518
<td>set to an array of D-Bus structures if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned
511
519
</td>
512
520
</tr>
513
521
<tr>
514
522
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
515
 
<td> Set to the error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned
 
523
<td>Set to the error if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned
516
524
</td>
517
525
</tr>
518
526
<tr>
519
527
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
520
 
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success
 
528
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success
521
529
</td>
522
530
</tr>
523
531
</tbody>
526
534
<hr>
527
535
<div class="refsect2" title="tp_properties_mixin_set_properties ()">
528
536
<a name="tp-properties-mixin-set-properties"></a><h3>tp_properties_mixin_set_properties ()</h3>
529
 
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_set_properties  (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
530
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *properties,
531
 
                                                         <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="returnvalue">DBusGMethodInvocation</span></a> *context);</pre>
 
537
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_set_properties  (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
538
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *properties</code></em>,
 
539
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);</pre>
532
540
<p>
533
 
Start to change properties in response to user request via D-Bus.</p>
 
541
Start to change properties in response to user request via D-Bus.
 
542
</p>
534
543
<div class="variablelist"><table border="0">
535
544
<col align="left" valign="top">
536
545
<tbody>
537
546
<tr>
538
547
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
539
 
<td> An object with this mixin
 
548
<td>An object with this mixin
540
549
</td>
541
550
</tr>
542
551
<tr>
543
552
<td><p><span class="term"><em class="parameter"><code>properties</code></em> :</span></p></td>
544
 
<td> An array of D-Bus structures containing property ID and value
 
553
<td>An array of D-Bus structures containing property ID and value
545
554
</td>
546
555
</tr>
547
556
<tr>
548
557
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
549
 
<td> A D-Bus method invocation context for the SetProperties method
 
558
<td>A D-Bus method invocation context for the SetProperties method
550
559
</td>
551
560
</tr>
552
561
</tbody>
555
564
<hr>
556
565
<div class="refsect2" title="tp_properties_mixin_has_property ()">
557
566
<a name="tp-properties-mixin-has-property"></a><h3>tp_properties_mixin_has_property ()</h3>
558
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_properties_mixin_has_property    (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
559
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *name,
560
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> *property);</pre>
 
567
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_properties_mixin_has_property    (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
568
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 
569
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *property</code></em>);</pre>
561
570
<p>
 
571
 
562
572
</p>
563
573
<div class="variablelist"><table border="0">
564
574
<col align="left" valign="top">
565
575
<tbody>
566
576
<tr>
567
577
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
568
 
<td> an object with a properties mixin
 
578
<td>an object with a properties mixin
569
579
</td>
570
580
</tr>
571
581
<tr>
572
582
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
573
 
<td> the string name of the property
 
583
<td>the string name of the property
574
584
</td>
575
585
</tr>
576
586
<tr>
577
587
<td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
578
 
<td> either <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, or a pointer to a location to receive the property
 
588
<td>either <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, or a pointer to a location to receive the property
579
589
           index
580
590
</td>
581
591
</tr>
582
592
<tr>
583
593
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
584
 
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, setting <em class="parameter"><code>property</code></em>, if <em class="parameter"><code>obj</code></em> has a property of that name
 
594
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, setting <em class="parameter"><code>property</code></em>, if <em class="parameter"><code>obj</code></em> has a property of that name
585
595
</td>
586
596
</tr>
587
597
</tbody>
590
600
<hr>
591
601
<div class="refsect2" title="tp_properties_context_has ()">
592
602
<a name="tp-properties-context-has"></a><h3>tp_properties_context_has ()</h3>
593
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_properties_context_has           (<a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="returnvalue">TpPropertiesContext</span></a> *ctx,
594
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> property);</pre>
 
603
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_properties_context_has           (<em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="type">TpPropertiesContext</span></a> *ctx</code></em>,
 
604
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property</code></em>);</pre>
595
605
<p>
 
606
 
596
607
</p>
597
608
<div class="variablelist"><table border="0">
598
609
<col align="left" valign="top">
599
610
<tbody>
600
611
<tr>
601
612
<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td>
602
 
<td> the properties context representing a SetProperties call
 
613
<td>the properties context representing a SetProperties call
603
614
</td>
604
615
</tr>
605
616
<tr>
606
617
<td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
607
 
<td> the property ID
 
618
<td>the property ID
608
619
</td>
609
620
</tr>
610
621
<tr>
611
622
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
612
 
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>ctx</code></em> indicates that <em class="parameter"><code>property</code></em> still needs to be set on
 
623
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>ctx</code></em> indicates that <em class="parameter"><code>property</code></em> still needs to be set on
613
624
the server.
614
625
</td>
615
626
</tr>
619
630
<hr>
620
631
<div class="refsect2" title="tp_properties_context_has_other_than ()">
621
632
<a name="tp-properties-context-has-other-than"></a><h3>tp_properties_context_has_other_than ()</h3>
622
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_properties_context_has_other_than
623
 
                                                        (<a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="returnvalue">TpPropertiesContext</span></a> *ctx,
624
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> property);</pre>
 
633
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_properties_context_has_other_than
 
634
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="type">TpPropertiesContext</span></a> *ctx</code></em>,
 
635
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property</code></em>);</pre>
625
636
<p>
 
637
 
626
638
</p>
627
639
<div class="variablelist"><table border="0">
628
640
<col align="left" valign="top">
629
641
<tbody>
630
642
<tr>
631
643
<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td>
632
 
<td> the properties context representing a SetProperties call
 
644
<td>the properties context representing a SetProperties call
633
645
</td>
634
646
</tr>
635
647
<tr>
636
648
<td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
637
 
<td> the property ID
 
649
<td>the property ID
638
650
</td>
639
651
</tr>
640
652
<tr>
641
653
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
642
 
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>ctx</code></em> has properties other than <em class="parameter"><code>property</code></em> that still
 
654
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>ctx</code></em> has properties other than <em class="parameter"><code>property</code></em> that still
643
655
need to be set on the server
644
656
</td>
645
657
</tr>
649
661
<hr>
650
662
<div class="refsect2" title="tp_properties_context_get ()">
651
663
<a name="tp-properties-context-get"></a><h3>tp_properties_context_get ()</h3>
652
 
<pre class="programlisting">const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *      tp_properties_context_get           (<a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="returnvalue">TpPropertiesContext</span></a> *ctx,
653
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> property);</pre>
 
664
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *      tp_properties_context_get           (<em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="type">TpPropertiesContext</span></a> *ctx</code></em>,
 
665
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property</code></em>);</pre>
654
666
<p>
 
667
 
655
668
</p>
656
669
<div class="variablelist"><table border="0">
657
670
<col align="left" valign="top">
658
671
<tbody>
659
672
<tr>
660
673
<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td>
661
 
<td> the properties context representing a SetProperties call
 
674
<td>the properties context representing a SetProperties call
662
675
</td>
663
676
</tr>
664
677
<tr>
665
678
<td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
666
 
<td> a property ID
 
679
<td>a property ID
667
680
</td>
668
681
</tr>
669
682
<tr>
678
691
<hr>
679
692
<div class="refsect2" title="tp_properties_context_get_value_count ()">
680
693
<a name="tp-properties-context-get-value-count"></a><h3>tp_properties_context_get_value_count ()</h3>
681
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               tp_properties_context_get_value_count
682
 
                                                        (<a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="returnvalue">TpPropertiesContext</span></a> *ctx);</pre>
 
694
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               tp_properties_context_get_value_count
 
695
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="type">TpPropertiesContext</span></a> *ctx</code></em>);</pre>
683
696
<p>
 
697
 
684
698
</p>
685
699
<div class="variablelist"><table border="0">
686
700
<col align="left" valign="top">
687
701
<tbody>
688
702
<tr>
689
703
<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td>
690
 
<td> the properties context representing a SetProperties call
 
704
<td>the properties context representing a SetProperties call
691
705
</td>
692
706
</tr>
693
707
<tr>
702
716
<hr>
703
717
<div class="refsect2" title="tp_properties_context_remove ()">
704
718
<a name="tp-properties-context-remove"></a><h3>tp_properties_context_remove ()</h3>
705
 
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_context_remove        (<a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="returnvalue">TpPropertiesContext</span></a> *ctx,
706
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> property);</pre>
 
719
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_context_remove        (<em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="type">TpPropertiesContext</span></a> *ctx</code></em>,
 
720
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property</code></em>);</pre>
707
721
<p>
708
 
Mark the given property as having been set successfully.</p>
 
722
Mark the given property as having been set successfully.
 
723
</p>
709
724
<div class="variablelist"><table border="0">
710
725
<col align="left" valign="top">
711
726
<tbody>
712
727
<tr>
713
728
<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td>
714
 
<td> the properties context representing a SetProperties call
 
729
<td>the properties context representing a SetProperties call
715
730
</td>
716
731
</tr>
717
732
<tr>
718
733
<td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
719
 
<td> a property ID
 
734
<td>a property ID
720
735
</td>
721
736
</tr>
722
737
</tbody>
725
740
<hr>
726
741
<div class="refsect2" title="tp_properties_context_return ()">
727
742
<a name="tp-properties-context-return"></a><h3>tp_properties_context_return ()</h3>
728
 
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_context_return        (<a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="returnvalue">TpPropertiesContext</span></a> *ctx,
729
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error);</pre>
 
743
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_context_return        (<em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="type">TpPropertiesContext</span></a> *ctx</code></em>,
 
744
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>);</pre>
730
745
<p>
731
 
Commit the property changes and return from the pending D-Bus call.</p>
 
746
Commit the property changes and return from the pending D-Bus call.
 
747
</p>
732
748
<div class="variablelist"><table border="0">
733
749
<col align="left" valign="top">
734
750
<tbody>
735
751
<tr>
736
752
<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td>
737
 
<td> the properties context representing a SetProperties call
 
753
<td>the properties context representing a SetProperties call
738
754
</td>
739
755
</tr>
740
756
<tr>
741
757
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
742
 
<td> If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, return successfully; otherwise return this error
 
758
<td>If <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, return successfully; otherwise return this error
743
759
</td>
744
760
</tr>
745
761
</tbody>
748
764
<hr>
749
765
<div class="refsect2" title="tp_properties_context_return_if_done ()">
750
766
<a name="tp-properties-context-return-if-done"></a><h3>tp_properties_context_return_if_done ()</h3>
751
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_properties_context_return_if_done
752
 
                                                        (<a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="returnvalue">TpPropertiesContext</span></a> *ctx);</pre>
 
767
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_properties_context_return_if_done
 
768
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-TpPropertiesMixin.html#TpPropertiesContext" title="TpPropertiesContext"><span class="type">TpPropertiesContext</span></a> *ctx</code></em>);</pre>
753
769
<p>
754
770
Return from the pending D-Bus call if there are no more properties to be
755
 
dealt with.</p>
 
771
dealt with.
 
772
</p>
756
773
<div class="variablelist"><table border="0">
757
774
<col align="left" valign="top">
758
775
<tbody>
759
776
<tr>
760
777
<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td>
761
 
<td> the properties context representing a SetProperties call
 
778
<td>the properties context representing a SetProperties call
762
779
</td>
763
780
</tr>
764
781
<tr>
765
782
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
766
 
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if we returned from the D-Bus call.
 
783
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if we returned from the D-Bus call.
767
784
</td>
768
785
</tr>
769
786
</tbody>
772
789
<hr>
773
790
<div class="refsect2" title="tp_properties_mixin_change_value ()">
774
791
<a name="tp-properties-mixin-change-value"></a><h3>tp_properties_mixin_change_value ()</h3>
775
 
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_change_value    (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
776
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> prop_id,
777
 
                                                         const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *new_value,
778
 
                                                         <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="returnvalue">TpIntSet</span></a> *props);</pre>
 
792
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_change_value    (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
793
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> prop_id</code></em>,
 
794
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *new_value</code></em>,
 
795
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *props</code></em>);</pre>
779
796
<p>
780
797
Change the value of the given property ID in response to a server state
781
798
change.
785
802
<em class="parameter"><code>props</code></em> is ignored. Otherwise, the following applies:
786
803
</p>
787
804
<p>
788
 
If <em class="parameter"><code>props</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> the PropertiesChanged signal is emitted for this one
 
805
If <em class="parameter"><code>props</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> the PropertiesChanged signal is emitted for this one
789
806
property.
790
807
</p>
791
808
<p>
792
809
Otherwise, the property ID is added to the set; the caller is responsible
793
810
for passing the set to <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-emit-changed" title="tp_properties_mixin_emit_changed ()"><code class="function">tp_properties_mixin_emit_changed()</code></a> once a batch of
794
 
properties have been changed.</p>
 
811
properties have been changed.
 
812
</p>
795
813
<div class="variablelist"><table border="0">
796
814
<col align="left" valign="top">
797
815
<tbody>
798
816
<tr>
799
817
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
800
 
<td> An object with the properties mixin
 
818
<td>An object with the properties mixin
801
819
</td>
802
820
</tr>
803
821
<tr>
804
822
<td><p><span class="term"><em class="parameter"><code>prop_id</code></em> :</span></p></td>
805
 
<td> A property ID on which to act
 
823
<td>A property ID on which to act
806
824
</td>
807
825
</tr>
808
826
<tr>
809
827
<td><p><span class="term"><em class="parameter"><code>new_value</code></em> :</span></p></td>
810
 
<td> Property value
 
828
<td>Property value
811
829
</td>
812
830
</tr>
813
831
<tr>
814
832
<td><p><span class="term"><em class="parameter"><code>props</code></em> :</span></p></td>
815
 
<td> either <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, or a pointer to a TpIntSet
 
833
<td>either <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, or a pointer to a TpIntSet
816
834
</td>
817
835
</tr>
818
836
</tbody>
821
839
<hr>
822
840
<div class="refsect2" title="tp_properties_mixin_change_flags ()">
823
841
<a name="tp-properties-mixin-change-flags"></a><h3>tp_properties_mixin_change_flags ()</h3>
824
 
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_change_flags    (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
825
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> prop_id,
826
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpPropertyFlags" title="enum TpPropertyFlags"><span class="returnvalue">TpPropertyFlags</span></a> add,
827
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpPropertyFlags" title="enum TpPropertyFlags"><span class="returnvalue">TpPropertyFlags</span></a> del,
828
 
                                                         <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="returnvalue">TpIntSet</span></a> *props);</pre>
 
842
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_change_flags    (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
843
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> prop_id</code></em>,
 
844
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpPropertyFlags" title="enum TpPropertyFlags"><span class="type">TpPropertyFlags</span></a> add</code></em>,
 
845
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpPropertyFlags" title="enum TpPropertyFlags"><span class="type">TpPropertyFlags</span></a> del</code></em>,
 
846
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *props</code></em>);</pre>
829
847
<p>
830
848
Change the flags for the given property ID in response to a server state
831
849
change.
835
853
relied upon.
836
854
</p>
837
855
<p>
838
 
If <em class="parameter"><code>props</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> the PropertyFlagsChanged signal is emitted for this
 
856
If <em class="parameter"><code>props</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> the PropertyFlagsChanged signal is emitted for this
839
857
single property.
840
858
</p>
841
859
<p>
842
860
Otherwise, the property ID is added to the set; the caller is responsible
843
861
for passing the set to <a class="link" href="telepathy-glib-TpPropertiesMixin.html#tp-properties-mixin-emit-flags" title="tp_properties_mixin_emit_flags ()"><code class="function">tp_properties_mixin_emit_flags()</code></a> once a batch of
844
 
properties have been changed.</p>
 
862
properties have been changed.
 
863
</p>
845
864
<div class="variablelist"><table border="0">
846
865
<col align="left" valign="top">
847
866
<tbody>
848
867
<tr>
849
868
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
850
 
<td> An object with the properties mixin
 
869
<td>An object with the properties mixin
851
870
</td>
852
871
</tr>
853
872
<tr>
854
873
<td><p><span class="term"><em class="parameter"><code>prop_id</code></em> :</span></p></td>
855
 
<td> A property ID on which to act
 
874
<td>A property ID on which to act
856
875
</td>
857
876
</tr>
858
877
<tr>
859
878
<td><p><span class="term"><em class="parameter"><code>add</code></em> :</span></p></td>
860
 
<td> Property flags to be added via bitwise OR
 
879
<td>Property flags to be added via bitwise OR
861
880
</td>
862
881
</tr>
863
882
<tr>
864
883
<td><p><span class="term"><em class="parameter"><code>del</code></em> :</span></p></td>
865
 
<td> Property flags to be removed via bitwise AND
 
884
<td>Property flags to be removed via bitwise AND
866
885
</td>
867
886
</tr>
868
887
<tr>
869
888
<td><p><span class="term"><em class="parameter"><code>props</code></em> :</span></p></td>
870
 
<td> either <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, or a pointer to a TpIntSet
 
889
<td>either <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, or a pointer to a TpIntSet
871
890
</td>
872
891
</tr>
873
892
</tbody>
876
895
<hr>
877
896
<div class="refsect2" title="tp_properties_mixin_emit_changed ()">
878
897
<a name="tp-properties-mixin-emit-changed"></a><h3>tp_properties_mixin_emit_changed ()</h3>
879
 
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_emit_changed    (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
880
 
                                                         const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="returnvalue">TpIntSet</span></a> *props);</pre>
 
898
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_emit_changed    (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
899
                                                         <em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *props</code></em>);</pre>
881
900
<p>
882
901
Emit the PropertiesChanged signal to indicate that the values of the
883
902
given property IDs have changed; the actual values are automatically
884
 
added using their stored values.</p>
 
903
added using their stored values.
 
904
</p>
885
905
<div class="variablelist"><table border="0">
886
906
<col align="left" valign="top">
887
907
<tbody>
888
908
<tr>
889
909
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
890
 
<td> an object with the properties mixin
 
910
<td>an object with the properties mixin
891
911
</td>
892
912
</tr>
893
913
<tr>
894
914
<td><p><span class="term"><em class="parameter"><code>props</code></em> :</span></p></td>
895
 
<td> a set of property IDs
 
915
<td>a set of property IDs
896
916
</td>
897
917
</tr>
898
918
</tbody>
901
921
<hr>
902
922
<div class="refsect2" title="tp_properties_mixin_emit_flags ()">
903
923
<a name="tp-properties-mixin-emit-flags"></a><h3>tp_properties_mixin_emit_flags ()</h3>
904
 
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_emit_flags      (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
905
 
                                                         const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="returnvalue">TpIntSet</span></a> *props);</pre>
 
924
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_emit_flags      (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
925
                                                         <em class="parameter"><code>const <a class="link" href="telepathy-glib-TpIntSet.html#TpIntSet" title="TpIntSet"><span class="type">TpIntSet</span></a> *props</code></em>);</pre>
906
926
<p>
907
927
Emit the PropertyFlagsChanged signal to indicate that the flags of the
908
928
given property IDs have changed; the actual flags are automatically
909
 
added using their stored values.</p>
 
929
added using their stored values.
 
930
</p>
910
931
<div class="variablelist"><table border="0">
911
932
<col align="left" valign="top">
912
933
<tbody>
913
934
<tr>
914
935
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
915
 
<td> an object with the properties mixin
 
936
<td>an object with the properties mixin
916
937
</td>
917
938
</tr>
918
939
<tr>
919
940
<td><p><span class="term"><em class="parameter"><code>props</code></em> :</span></p></td>
920
 
<td> a set of property IDs
 
941
<td>a set of property IDs
921
942
</td>
922
943
</tr>
923
944
</tbody>
926
947
<hr>
927
948
<div class="refsect2" title="tp_properties_mixin_is_readable ()">
928
949
<a name="tp-properties-mixin-is-readable"></a><h3>tp_properties_mixin_is_readable ()</h3>
929
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_properties_mixin_is_readable     (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
930
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> prop_id);</pre>
 
950
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_properties_mixin_is_readable     (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
951
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> prop_id</code></em>);</pre>
931
952
<p>
 
953
 
932
954
</p>
933
955
<div class="variablelist"><table border="0">
934
956
<col align="left" valign="top">
935
957
<tbody>
936
958
<tr>
937
959
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
938
 
<td> an object with this mixin
 
960
<td>an object with this mixin
939
961
</td>
940
962
</tr>
941
963
<tr>
942
964
<td><p><span class="term"><em class="parameter"><code>prop_id</code></em> :</span></p></td>
943
 
<td> an integer property ID
 
965
<td>an integer property ID
944
966
</td>
945
967
</tr>
946
968
<tr>
947
969
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
948
 
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the given property has the READ flag
 
970
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the given property has the READ flag
949
971
</td>
950
972
</tr>
951
973
</tbody>
954
976
<hr>
955
977
<div class="refsect2" title="tp_properties_mixin_is_writable ()">
956
978
<a name="tp-properties-mixin-is-writable"></a><h3>tp_properties_mixin_is_writable ()</h3>
957
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_properties_mixin_is_writable     (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *obj,
958
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> prop_id);</pre>
 
979
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_properties_mixin_is_writable     (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *obj</code></em>,
 
980
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> prop_id</code></em>);</pre>
959
981
<p>
 
982
 
960
983
</p>
961
984
<div class="variablelist"><table border="0">
962
985
<col align="left" valign="top">
963
986
<tbody>
964
987
<tr>
965
988
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
966
 
<td> an object with this mixin
 
989
<td>an object with this mixin
967
990
</td>
968
991
</tr>
969
992
<tr>
970
993
<td><p><span class="term"><em class="parameter"><code>prop_id</code></em> :</span></p></td>
971
 
<td> an integer property ID
 
994
<td>an integer property ID
972
995
</td>
973
996
</tr>
974
997
<tr>
975
998
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
976
 
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the given property has the WRITE flag
 
999
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the given property has the WRITE flag
977
1000
</td>
978
1001
</tr>
979
1002
</tbody>
982
1005
<hr>
983
1006
<div class="refsect2" title="tp_properties_mixin_iface_init ()">
984
1007
<a name="tp-properties-mixin-iface-init"></a><h3>tp_properties_mixin_iface_init ()</h3>
985
 
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_iface_init      (<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> g_iface,
986
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> iface_data);</pre>
 
1008
<pre class="programlisting"><span class="returnvalue">void</span>                tp_properties_mixin_iface_init      (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> g_iface</code></em>,
 
1009
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> iface_data</code></em>);</pre>
987
1010
<p>
988
1011
Fill in this mixin's method implementations in the given interface vtable.
989
1012
This function should usually be called via G_IMPLEMENT_INTERFACE
990
 
inside the G_DEFINE_TYPE_WITH_CODE macro.</p>
 
1013
inside the G_DEFINE_TYPE_WITH_CODE macro.
 
1014
</p>
991
1015
<div class="variablelist"><table border="0">
992
1016
<col align="left" valign="top">
993
1017
<tbody>
994
1018
<tr>
995
1019
<td><p><span class="term"><em class="parameter"><code>g_iface</code></em> :</span></p></td>
996
 
<td> A pointer to the <a class="link" href="telepathy-glib-svc-generic.html#TpSvcPropertiesInterfaceClass" title="TpSvcPropertiesInterfaceClass"><span class="type">TpSvcPropertiesInterfaceClass</span></a> in an object class
 
1020
<td>A pointer to the <a class="link" href="telepathy-glib-svc-generic.html#TpSvcPropertiesInterfaceClass" title="TpSvcPropertiesInterfaceClass"><span class="type">TpSvcPropertiesInterfaceClass</span></a> in an object class
997
1021
</td>
998
1022
</tr>
999
1023
<tr>
1000
1024
<td><p><span class="term"><em class="parameter"><code>iface_data</code></em> :</span></p></td>
1001
 
<td> Ignored
 
1025
<td>Ignored
1002
1026
</td>
1003
1027
</tr>
1004
1028
</tbody>
1014
1038
ListProperties.
1015
1039
</p>
1016
1040
<p>
1017
 
<em class="parameter"><code>Deprecated</code></em>: Since 0.7.0. Use TP_STRUCT_TYPE_PROPERTY_SPEC instead.</p>
 
1041
<em class="parameter"><code>Deprecated</code></em>: Since 0.7.0. Use TP_STRUCT_TYPE_PROPERTY_SPEC instead.
 
1042
</p>
1018
1043
</div>
1019
1044
<hr>
1020
1045
<div class="refsect2" title="TP_TYPE_PROPERTY_INFO_LIST">
1027
1052
D-Bus signature 'a(ussu)'.
1028
1053
</p>
1029
1054
<p>
1030
 
<em class="parameter"><code>Deprecated</code></em>: Since 0.7.0. Use TP_ARRAY_TYPE_PROPERTY_SPEC_LIST instead.</p>
 
1055
<em class="parameter"><code>Deprecated</code></em>: Since 0.7.0. Use TP_ARRAY_TYPE_PROPERTY_SPEC_LIST instead.
 
1056
</p>
1031
1057
</div>
1032
1058
<hr>
1033
1059
<div class="refsect2" title="TP_TYPE_PROPERTY_VALUE_STRUCT">
1039
1065
GetProperties and emitted in PropertiesChanged.
1040
1066
</p>
1041
1067
<p>
1042
 
<em class="parameter"><code>Deprecated</code></em>: Since 0.7.0. Use TP_STRUCT_TYPE_PROPERTY_VALUE instead.</p>
 
1068
<em class="parameter"><code>Deprecated</code></em>: Since 0.7.0. Use TP_STRUCT_TYPE_PROPERTY_VALUE instead.
 
1069
</p>
1043
1070
</div>
1044
1071
<hr>
1045
1072
<div class="refsect2" title="TP_TYPE_PROPERTY_VALUE_LIST">
1052
1079
TP_TYPE_PROPERTY_VALUE_STRUCT), corresponding to D-Bus signature 'a(uv)'.
1053
1080
</p>
1054
1081
<p>
1055
 
<em class="parameter"><code>Deprecated</code></em>: Since 0.7.0. Use TP_ARRAY_TYPE_PROPERTY_VALUE_LIST instead.</p>
 
1082
<em class="parameter"><code>Deprecated</code></em>: Since 0.7.0. Use TP_ARRAY_TYPE_PROPERTY_VALUE_LIST instead.
 
1083
</p>
1056
1084
</div>
1057
1085
<hr>
1058
1086
<div class="refsect2" title="TP_TYPE_PROPERTY_FLAGS_STRUCT">
1064
1092
PropertyFlagsChanged.
1065
1093
</p>
1066
1094
<p>
1067
 
<em class="parameter"><code>Deprecated</code></em>: Since 0.7.0. Use TP_STRUCT_TYPE_PROPERTY_FLAGS_CHANGE instead.</p>
 
1095
<em class="parameter"><code>Deprecated</code></em>: Since 0.7.0. Use TP_STRUCT_TYPE_PROPERTY_FLAGS_CHANGE instead.
 
1096
</p>
1068
1097
</div>
1069
1098
<hr>
1070
1099
<div class="refsect2" title="TP_TYPE_PROPERTY_FLAGS_LIST">
1078
1107
</p>
1079
1108
<p>
1080
1109
<em class="parameter"><code>Deprecated</code></em>: Since 0.7.0. Use TP_ARRAY_TYPE_PROPERTY_FLAGS_CHANGE_LIST
1081
 
 instead.</p>
 
1110
 instead.
 
1111
</p>
1082
1112
</div>
1083
1113
</div>
1084
1114
<div class="refsect1" title="See Also">
1088
1118
</div>
1089
1119
<div class="footer">
1090
1120
<hr>
1091
 
          Generated by GTK-Doc V1.13</div>
 
1121
          Generated by GTK-Doc V1.14</div>
1092
1122
</body>
1093
1123
</html>
 
 
b'\\ No newline at end of file'