← Back to branch summary

~ubuntu-branches/ubuntu/trusty/libzeitgeist/trusty-proposed

« back to all changes in this revision

Viewing changes to .pc/debian-changes-0.3.8-0ubuntu1/doc/reference/html/ZeitgeistDataSource.html

  • Committer: Bazaar Package Importer
  • Author(s): Didier Roche
  • Date: 2011-03-23 17:05:43 UTC
  • mfrom: (1.1.8 upstream)
  • Revision ID: james.westby@ubuntu.com-20110323170543-qks4dcl41i222izh
Tags: 0.3.8-0ubuntu1
https://launchpad.net/bugs/734080
https://launchpad.net/bugs/739653
* New upstream release
  - ZeitgeistLog missing implementation of get_property for "connected"
    (LP: #734080)
  - libzeitgeist vapi needs an update (LP: #739653)

Show diffs side-by-side

added added

removed removed

Lines of Context:
.pc/debian-changes-0.3.8-0ubuntu1/doc/reference/html/ZeitgeistDataSource.html
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
2
<html>
 
3
<head>
 
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 
5
<title>ZeitgeistDataSource</title>
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
 
7
<link rel="home" href="index.html" title="API Documentation for the Zeitgeist Client Library">
 
8
<link rel="up" href="ch04.html" title="API for Zeitgeist Extensions">
 
9
<link rel="prev" href="ZeitgeistIndex.html" title="ZeitgeistIndex">
 
10
<link rel="next" href="ZeitgeistDataSourceRegistry.html" title="ZeitgeistDataSourceRegistry">
 
11
<meta name="generator" content="GTK-Doc V1.16 (XML mode)">
 
12
<link rel="stylesheet" href="style.css" type="text/css">
 
13
</head>
 
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
 
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
 
16
<tr valign="middle">
 
17
<td><a accesskey="p" href="ZeitgeistIndex.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
18
<td><a accesskey="u" href="ch04.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
 
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
 
20
<th width="100%" align="center">API Documentation for the Zeitgeist Client Library</th>
 
21
<td><a accesskey="n" href="ZeitgeistDataSourceRegistry.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
22
</tr>
 
23
<tr><td colspan="5" class="shortcuts">
 
24
<a href="#ZeitgeistDataSource.synopsis" class="shortcut">Top</a>
 
25
                   | 
 
26
                  <a href="#ZeitgeistDataSource.description" class="shortcut">Description</a>
 
27
                   | 
 
28
                  <a href="#ZeitgeistDataSource.object-hierarchy" class="shortcut">Object Hierarchy</a>
 
29
</td></tr>
 
30
</table>
 
31
<div class="refentry">
 
32
<a name="ZeitgeistDataSource"></a><div class="titlepage"></div>
 
33
<div class="refnamediv"><table width="100%"><tr>
 
34
<td valign="top">
 
35
<h2><span class="refentrytitle"><a name="ZeitgeistDataSource.top_of_page"></a>ZeitgeistDataSource</span></h2>
 
36
<p>ZeitgeistDataSource — Abstracts data sources used by
 
37
                    the <a class="link" href="ZeitgeistDataSourceRegistry.html" title="ZeitgeistDataSourceRegistry"><span class="type">ZeitgeistDataSourceRegistry</span></a> extension</p>
 
38
</td>
 
39
<td valign="top" align="right"></td>
 
40
</tr></table></div>
 
41
<div class="refsynopsisdiv">
 
42
<a name="ZeitgeistDataSource.synopsis"></a><h2>Synopsis</h2>
 
43
<pre class="synopsis">
 
44
#include &lt;zeitgeist.h&gt;
 
45
 
 
46
                    <a class="link" href="ZeitgeistDataSource.html#ZeitgeistDataSource-struct" title="ZeitgeistDataSource">ZeitgeistDataSource</a>;
 
47
struct              <a class="link" href="ZeitgeistDataSource.html#ZeitgeistDataSourceClass" title="struct ZeitgeistDataSourceClass">ZeitgeistDataSourceClass</a>;
 
48
<a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="returnvalue">ZeitgeistDataSource</span></a> *  <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-source-new" title="zeitgeist_data_source_new ()">zeitgeist_data_source_new</a>        (<em class="parameter"><code><span class="type">void</span></code></em>);
 
49
<a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="returnvalue">ZeitgeistDataSource</span></a> *  <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-source-new-full" title="zeitgeist_data_source_new_full ()">zeitgeist_data_source_new_full</a>   (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
 
50
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 
51
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *desc</code></em>,
 
52
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *event_templates</code></em>);
 
53
<a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="returnvalue">ZeitgeistDataSource</span></a> *  <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-source-new-from-variant" title="zeitgeist_data_source_new_from_variant ()">zeitgeist_data_source_new_from_variant</a>
 
54
                                                        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *src</code></em>);
 
55
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-source-get-unique-id" title="zeitgeist_data_source_get_unique_id ()">zeitgeist_data_source_get_unique_id</a> (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>);
 
56
<span class="returnvalue">void</span>                <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-source-set-unique-id" title="zeitgeist_data_source_set_unique_id ()">zeitgeist_data_source_set_unique_id</a> (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>,
 
57
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *unique_id</code></em>);
 
58
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-source-get-name" title="zeitgeist_data_source_get_name ()">zeitgeist_data_source_get_name</a>      (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>);
 
59
<span class="returnvalue">void</span>                <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-source-set-name" title="zeitgeist_data_source_set_name ()">zeitgeist_data_source_set_name</a>      (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>,
 
60
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
 
61
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-source-get-description" title="zeitgeist_data_source_get_description ()">zeitgeist_data_source_get_description</a>
 
62
                                                        (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>);
 
63
<span class="returnvalue">void</span>                <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-source-set-description" title="zeitgeist_data_source_set_description ()">zeitgeist_data_source_set_description</a>
 
64
                                                        (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>,
 
65
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *description</code></em>);
 
66
<a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *         <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-source-get-event-templates" title="zeitgeist_data_source_get_event_templates ()">zeitgeist_data_source_get_event_templates</a>
 
67
                                                        (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>);
 
68
<span class="returnvalue">void</span>                <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-source-set-event-templates" title="zeitgeist_data_source_set_event_templates ()">zeitgeist_data_source_set_event_templates</a>
 
69
                                                        (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>,
 
70
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *event_templates</code></em>);
 
71
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-source-is-running" title="zeitgeist_data_source_is_running ()">zeitgeist_data_source_is_running</a>    (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>);
 
72
<span class="returnvalue">void</span>                <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-source-set-running" title="zeitgeist_data_source_set_running ()">zeitgeist_data_source_set_running</a>   (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>,
 
73
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> running</code></em>);
 
74
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-source-get-timestamp" title="zeitgeist_data_source_get_timestamp ()">zeitgeist_data_source_get_timestamp</a> (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>);
 
75
<span class="returnvalue">void</span>                <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-source-set-timestamp" title="zeitgeist_data_source_set_timestamp ()">zeitgeist_data_source_set_timestamp</a> (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>,
 
76
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>);
 
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="ZeitgeistDataSource.html#zeitgeist-data-source-is-enabled" title="zeitgeist_data_source_is_enabled ()">zeitgeist_data_source_is_enabled</a>    (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>);
 
78
<span class="returnvalue">void</span>                <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-source-set-enabled" title="zeitgeist_data_source_set_enabled ()">zeitgeist_data_source_set_enabled</a>   (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>,
 
79
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enabled</code></em>);
 
80
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *          <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-source-to-variant" title="zeitgeist_data_source_to_variant ()">zeitgeist_data_source_to_variant</a>    (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>);
 
81
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *          <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-sources-to-variant" title="zeitgeist_data_sources_to_variant ()">zeitgeist_data_sources_to_variant</a>   (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *sources</code></em>);
 
82
<a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *         <a class="link" href="ZeitgeistDataSource.html#zeitgeist-data-sources-from-variant" title="zeitgeist_data_sources_from_variant ()">zeitgeist_data_sources_from_variant</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *sources</code></em>);
 
83
#define             <a class="link" href="ZeitgeistDataSource.html#ZEITGEIST-DATA-SOURCE-VARIANT-SIGNATURE:CAPS" title="ZEITGEIST_DATA_SOURCE_VARIANT_SIGNATURE">ZEITGEIST_DATA_SOURCE_VARIANT_SIGNATURE</a>
 
84
#define             <a class="link" href="ZeitgeistDataSource.html#ZEITGEIST-DATA-SOURCE-VARIANT-TYPE:CAPS" title="ZEITGEIST_DATA_SOURCE_VARIANT_TYPE">ZEITGEIST_DATA_SOURCE_VARIANT_TYPE</a>
 
85
</pre>
 
86
</div>
 
87
<div class="refsect1">
 
88
<a name="ZeitgeistDataSource.object-hierarchy"></a><h2>Object Hierarchy</h2>
 
89
<pre class="synopsis">
 
90
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
91
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
 
92
         +----ZeitgeistDataSource
 
93
</pre>
 
94
</div>
 
95
<div class="refsect1">
 
96
<a name="ZeitgeistDataSource.description"></a><h2>Description</h2>
 
97
<p>
 
98
<a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> represents a data source used to insert events into
 
99
Zeitgeist. The data sources are identified using the unique_id property,
 
100
and when querying the data source registry you get other interesting
 
101
information like timestamp of the last action of the data source, flag
 
102
whether it is currently running etc.
 
103
</p>
 
104
</div>
 
105
<div class="refsect1">
 
106
<a name="ZeitgeistDataSource.details"></a><h2>Details</h2>
 
107
<div class="refsect2">
 
108
<a name="ZeitgeistDataSource-struct"></a><h3>ZeitgeistDataSource</h3>
 
109
<pre class="programlisting">typedef struct _ZeitgeistDataSource ZeitgeistDataSource;</pre>
 
110
<p>
 
111
</p>
 
112
</div>
 
113
<hr>
 
114
<div class="refsect2">
 
115
<a name="ZeitgeistDataSourceClass"></a><h3>struct ZeitgeistDataSourceClass</h3>
 
116
<pre class="programlisting">struct ZeitgeistDataSourceClass {
 
117
  GInitiallyUnownedClass parent_class;
 
118
};
 
119
</pre>
 
120
<p>
 
121
</p>
 
122
</div>
 
123
<hr>
 
124
<div class="refsect2">
 
125
<a name="zeitgeist-data-source-new"></a><h3>zeitgeist_data_source_new ()</h3>
 
126
<pre class="programlisting"><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="returnvalue">ZeitgeistDataSource</span></a> *  zeitgeist_data_source_new        (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
127
<p>
 
128
Create a new empty data source structure.
 
129
</p>
 
130
<div class="variablelist"><table border="0">
 
131
<col align="left" valign="top">
 
132
<tbody><tr>
 
133
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
134
<td>A new instance of <a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a>. The returned source will
 
135
have a floating reference which will be consumed if you pass the
 
136
data source to any of the methods provided by this library (like
 
137
registering the data source). If you do not do that then you
 
138
must free the data source yourself with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</td>
 
139
</tr></tbody>
 
140
</table></div>
 
141
</div>
 
142
<hr>
 
143
<div class="refsect2">
 
144
<a name="zeitgeist-data-source-new-full"></a><h3>zeitgeist_data_source_new_full ()</h3>
 
145
<pre class="programlisting"><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="returnvalue">ZeitgeistDataSource</span></a> *  zeitgeist_data_source_new_full   (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
 
146
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 
147
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *desc</code></em>,
 
148
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *event_templates</code></em>);</pre>
 
149
<p>
 
150
Creates a new instance of DataSource with the given ID, name and
 
151
description.
 
152
</p>
 
153
<div class="variablelist"><table border="0">
 
154
<col align="left" valign="top">
 
155
<tbody>
 
156
<tr>
 
157
<td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
 
158
<td>Unique ID for the data source.</td>
 
159
</tr>
 
160
<tr>
 
161
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 
162
<td>Name of the data source (may be translated).</td>
 
163
</tr>
 
164
<tr>
 
165
<td><p><span class="term"><em class="parameter"><code>desc</code></em> :</span></p></td>
 
166
<td>Data source description.</td>
 
167
</tr>
 
168
<tr>
 
169
<td><p><span class="term"><em class="parameter"><code>event_templates</code></em> :</span></p></td>
 
170
<td>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> of <a class="link" href="ZeitgeistEvent.html" title="ZeitgeistEvent"><span class="type">ZeitgeistEvent</span></a>s. This parameter
 
171
is optional and purely informational to let data-source
 
172
management applications and other data-sources know what
 
173
sort of information the data source logs.
 
174
The data source will assume ownership of the events and
 
175
the pointer array.
 
176
If you want to keep a reference for yourself you must do a
 
177
<a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#g-ptr-array-ref"><code class="function">g_ptr_array_ref()</code></a> on <em class="parameter"><code>event_templates</code></em> as well as reffing
 
178
the events held by it before calling this method.</td>
 
179
</tr>
 
180
<tr>
 
181
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
182
<td>New instance of <a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> with floating reference,
 
183
if you do not pass the instance to method like
 
184
<a class="link" href="ZeitgeistDataSourceRegistry.html#zeitgeist-data-source-registry-register-data-source" title="zeitgeist_data_source_registry_register_data_source ()"><code class="function">zeitgeist_data_source_registry_register_data_source()</code></a>, then you
 
185
have to free the data source yourself using <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</td>
 
186
</tr>
 
187
</tbody>
 
188
</table></div>
 
189
</div>
 
190
<hr>
 
191
<div class="refsect2">
 
192
<a name="zeitgeist-data-source-new-from-variant"></a><h3>zeitgeist_data_source_new_from_variant ()</h3>
 
193
<pre class="programlisting"><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="returnvalue">ZeitgeistDataSource</span></a> *  zeitgeist_data_source_new_from_variant
 
194
                                                        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *src</code></em>);</pre>
 
195
<p>
 
196
Parse the data in a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> and build a <a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> from it.
 
197
The reverse operation of this is <code class="function">zeitgeist_data_source_to_variant_full()</code>.
 
198
</p>
 
199
<div class="variablelist"><table border="0">
 
200
<col align="left" valign="top">
 
201
<tbody><tr>
 
202
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
203
<td>A newly allocated <a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> filled with the metadata and
 
204
event templates described by <em class="parameter"><code>src</code></em>. The returned data source will
 
205
have a floating reference which will be consumed if you pass the
 
206
data source to any of the methods provided by this library. If you
 
207
do not do that then you must free the data source yourself with
 
208
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>
 
209
</td>
 
210
</tr></tbody>
 
211
</table></div>
 
212
</div>
 
213
<hr>
 
214
<div class="refsect2">
 
215
<a name="zeitgeist-data-source-get-unique-id"></a><h3>zeitgeist_data_source_get_unique_id ()</h3>
 
216
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       zeitgeist_data_source_get_unique_id (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>);</pre>
 
217
<p>
 
218
</p>
 
219
</div>
 
220
<hr>
 
221
<div class="refsect2">
 
222
<a name="zeitgeist-data-source-set-unique-id"></a><h3>zeitgeist_data_source_set_unique_id ()</h3>
 
223
<pre class="programlisting"><span class="returnvalue">void</span>                zeitgeist_data_source_set_unique_id (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>,
 
224
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *unique_id</code></em>);</pre>
 
225
<p>
 
226
</p>
 
227
</div>
 
228
<hr>
 
229
<div class="refsect2">
 
230
<a name="zeitgeist-data-source-get-name"></a><h3>zeitgeist_data_source_get_name ()</h3>
 
231
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       zeitgeist_data_source_get_name      (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>);</pre>
 
232
<p>
 
233
</p>
 
234
</div>
 
235
<hr>
 
236
<div class="refsect2">
 
237
<a name="zeitgeist-data-source-set-name"></a><h3>zeitgeist_data_source_set_name ()</h3>
 
238
<pre class="programlisting"><span class="returnvalue">void</span>                zeitgeist_data_source_set_name      (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>,
 
239
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
 
240
<p>
 
241
</p>
 
242
</div>
 
243
<hr>
 
244
<div class="refsect2">
 
245
<a name="zeitgeist-data-source-get-description"></a><h3>zeitgeist_data_source_get_description ()</h3>
 
246
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       zeitgeist_data_source_get_description
 
247
                                                        (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>);</pre>
 
248
<p>
 
249
</p>
 
250
</div>
 
251
<hr>
 
252
<div class="refsect2">
 
253
<a name="zeitgeist-data-source-set-description"></a><h3>zeitgeist_data_source_set_description ()</h3>
 
254
<pre class="programlisting"><span class="returnvalue">void</span>                zeitgeist_data_source_set_description
 
255
                                                        (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>,
 
256
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *description</code></em>);</pre>
 
257
<p>
 
258
</p>
 
259
</div>
 
260
<hr>
 
261
<div class="refsect2">
 
262
<a name="zeitgeist-data-source-get-event-templates"></a><h3>zeitgeist_data_source_get_event_templates ()</h3>
 
263
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *         zeitgeist_data_source_get_event_templates
 
264
                                                        (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>);</pre>
 
265
<p>
 
266
</p>
 
267
</div>
 
268
<hr>
 
269
<div class="refsect2">
 
270
<a name="zeitgeist-data-source-set-event-templates"></a><h3>zeitgeist_data_source_set_event_templates ()</h3>
 
271
<pre class="programlisting"><span class="returnvalue">void</span>                zeitgeist_data_source_set_event_templates
 
272
                                                        (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>,
 
273
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *event_templates</code></em>);</pre>
 
274
<p>
 
275
Sets event templates which are logged by this <a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a>
 
276
instance.
 
277
</p>
 
278
<div class="variablelist"><table border="0">
 
279
<col align="left" valign="top">
 
280
<tbody>
 
281
<tr>
 
282
<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
 
283
<td>Instance of <a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a>.</td>
 
284
</tr>
 
285
<tr>
 
286
<td><p><span class="term"><em class="parameter"><code>event_templates</code></em> :</span></p></td>
 
287
<td>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> which contains elements of type
 
288
<a class="link" href="ZeitgeistEvent.html" title="ZeitgeistEvent"><span class="type">ZeitgeistEvent</span></a>.
 
289
The data source will assume ownership of the events and
 
290
the pointer array.
 
291
If you want to keep a reference for yourself you must do a
 
292
<a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#g-ptr-array-ref"><code class="function">g_ptr_array_ref()</code></a> on <em class="parameter"><code>templates</code></em> as well as reffing
 
293
the events held by it before calling this method.</td>
 
294
</tr>
 
295
</tbody>
 
296
</table></div>
 
297
</div>
 
298
<hr>
 
299
<div class="refsect2">
 
300
<a name="zeitgeist-data-source-is-running"></a><h3>zeitgeist_data_source_is_running ()</h3>
 
301
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            zeitgeist_data_source_is_running    (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>);</pre>
 
302
<p>
 
303
</p>
 
304
</div>
 
305
<hr>
 
306
<div class="refsect2">
 
307
<a name="zeitgeist-data-source-set-running"></a><h3>zeitgeist_data_source_set_running ()</h3>
 
308
<pre class="programlisting"><span class="returnvalue">void</span>                zeitgeist_data_source_set_running   (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>,
 
309
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> running</code></em>);</pre>
 
310
<p>
 
311
</p>
 
312
</div>
 
313
<hr>
 
314
<div class="refsect2">
 
315
<a name="zeitgeist-data-source-get-timestamp"></a><h3>zeitgeist_data_source_get_timestamp ()</h3>
 
316
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              zeitgeist_data_source_get_timestamp (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>);</pre>
 
317
<p>
 
318
</p>
 
319
</div>
 
320
<hr>
 
321
<div class="refsect2">
 
322
<a name="zeitgeist-data-source-set-timestamp"></a><h3>zeitgeist_data_source_set_timestamp ()</h3>
 
323
<pre class="programlisting"><span class="returnvalue">void</span>                zeitgeist_data_source_set_timestamp (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>,
 
324
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>);</pre>
 
325
<p>
 
326
</p>
 
327
</div>
 
328
<hr>
 
329
<div class="refsect2">
 
330
<a name="zeitgeist-data-source-is-enabled"></a><h3>zeitgeist_data_source_is_enabled ()</h3>
 
331
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            zeitgeist_data_source_is_enabled    (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>);</pre>
 
332
<p>
 
333
</p>
 
334
</div>
 
335
<hr>
 
336
<div class="refsect2">
 
337
<a name="zeitgeist-data-source-set-enabled"></a><h3>zeitgeist_data_source_set_enabled ()</h3>
 
338
<pre class="programlisting"><span class="returnvalue">void</span>                zeitgeist_data_source_set_enabled   (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>,
 
339
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enabled</code></em>);</pre>
 
340
<p>
 
341
</p>
 
342
</div>
 
343
<hr>
 
344
<div class="refsect2">
 
345
<a name="zeitgeist-data-source-to-variant"></a><h3>zeitgeist_data_source_to_variant ()</h3>
 
346
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *          zeitgeist_data_source_to_variant    (<em class="parameter"><code><a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> *src</code></em>);</pre>
 
347
<p>
 
348
Convert a <a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a> to a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> with signature
 
349
<a class="link" href="ZeitgeistDataSource.html#ZEITGEIST-DATA-SOURCE-VARIANT-SIGNATURE:CAPS" title="ZEITGEIST_DATA_SOURCE_VARIANT_SIGNATURE"><span class="type">ZEITGEIST_DATA_SOURCE_VARIANT_SIGNATURE</span></a>.
 
350
</p>
 
351
<div class="variablelist"><table border="0">
 
352
<col align="left" valign="top">
 
353
<tbody><tr>
 
354
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
355
<td>A floating reference to a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> as described above. Unless the
 
356
floating reference is consumed somewhere you must free it with
 
357
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.</td>
 
358
</tr></tbody>
 
359
</table></div>
 
360
</div>
 
361
<hr>
 
362
<div class="refsect2">
 
363
<a name="zeitgeist-data-sources-to-variant"></a><h3>zeitgeist_data_sources_to_variant ()</h3>
 
364
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *          zeitgeist_data_sources_to_variant   (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *sources</code></em>);</pre>
 
365
<p>
 
366
Convert a set of <a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a>&lt;-- --&gt;s to a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> with signature
 
367
as an array of <a class="link" href="ZeitgeistDataSource.html#ZEITGEIST-DATA-SOURCE-VARIANT-SIGNATURE:CAPS" title="ZEITGEIST_DATA_SOURCE_VARIANT_SIGNATURE"><span class="type">ZEITGEIST_DATA_SOURCE_VARIANT_SIGNATURE</span></a>.
 
368
</p>
 
369
<div class="variablelist"><table border="0">
 
370
<col align="left" valign="top">
 
371
<tbody><tr>
 
372
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
373
<td>A floating reference to a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> as described above. Unless the
 
374
floating reference is consumed somewhere you must free it with
 
375
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.</td>
 
376
</tr></tbody>
 
377
</table></div>
 
378
</div>
 
379
<hr>
 
380
<div class="refsect2">
 
381
<a name="zeitgeist-data-sources-from-variant"></a><h3>zeitgeist_data_sources_from_variant ()</h3>
 
382
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *         zeitgeist_data_sources_from_variant (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *sources</code></em>);</pre>
 
383
<div class="variablelist"><table border="0">
 
384
<col align="left" valign="top">
 
385
<tbody>
 
386
<tr>
 
387
<td><p><span class="term"><em class="parameter"><code>sources</code></em> :</span></p></td>
 
388
<td>A <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>  with signature as an array of
 
389
<span class="type">ZEITGEIST_DATA_SOURCE_WITH_INFO_VARIANT_SIGNATURE</span>.
 
390
If <em class="parameter"><code>sources</code></em> is floating this method will consume
 
391
the floating reference.</td>
 
392
</tr>
 
393
<tr>
 
394
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
395
<td>A reference to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> of <a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a>s.
 
396
All the events will be floating references, and the
 
397
<a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a>'s <em class="parameter"><code>free_func</code></em> will be set to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</td>
 
398
</tr>
 
399
</tbody>
 
400
</table></div>
 
401
</div>
 
402
<hr>
 
403
<div class="refsect2">
 
404
<a name="ZEITGEIST-DATA-SOURCE-VARIANT-SIGNATURE:CAPS"></a><h3>ZEITGEIST_DATA_SOURCE_VARIANT_SIGNATURE</h3>
 
405
<pre class="programlisting">#define ZEITGEIST_DATA_SOURCE_VARIANT_SIGNATURE "(sssa(asaasay))"
 
406
</pre>
 
407
<p>
 
408
The <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> signature for a serialized <a class="link" href="ZeitgeistDataSource.html" title="ZeitgeistDataSource"><span class="type">ZeitgeistDataSource</span></a>
 
409
</p>
 
410
</div>
 
411
<hr>
 
412
<div class="refsect2">
 
413
<a name="ZEITGEIST-DATA-SOURCE-VARIANT-TYPE:CAPS"></a><h3>ZEITGEIST_DATA_SOURCE_VARIANT_TYPE</h3>
 
414
<pre class="programlisting">#define ZEITGEIST_DATA_SOURCE_VARIANT_TYPE G_VARIANT_TYPE(ZEITGEIST_DATA_SOURCE_VARIANT_SIGNATURE)
 
415
</pre>
 
416
<p>
 
417
The <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a> of <a class="link" href="ZeitgeistDataSource.html#ZEITGEIST-DATA-SOURCE-VARIANT-SIGNATURE:CAPS" title="ZEITGEIST_DATA_SOURCE_VARIANT_SIGNATURE"><span class="type">ZEITGEIST_DATA_SOURCE_VARIANT_SIGNATURE</span></a>
 
418
</p>
 
419
</div>
 
420
</div>
 
421
</div>
 
422
<div class="footer">
 
423
<hr>
 
424
          Generated by GTK-Doc V1.16</div>
 
425
</body>
 
426
</html>
 
 
b'\\ No newline at end of file'