org.freesmartphone.PIM/org.freesmartphone.PIM.Tasks.xml.in

   1 <?xml version="1.0"?>
   2 <node name="/" xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd" doc:id="freesmartphone-pim-contacts-interface">
   3
   4 <doc:doc>
   5   <doc:summary>freesmartphone.org PIM.Tasks Interface</doc:summary>
   6 </doc:doc>
   7
   8 <interface name="org.freesmartphone.PIM.Tasks">
   9
  10   <doc:doc>
  11     <doc:para>
  12       This interface provides access to the collection of PIM tasks.
  13     </doc:para>
  14   </doc:doc>
  15
  16   <method name="Add">
  17     <annotation name="org.freedesktop.DBus.GLib.Async" value="true" />
  18     <doc:doc>
  19       <doc:description>
  20         Add a new task to the default backend for tasks.
  21       </doc:description>
  22     </doc:doc>
  23     <arg direction="in" type="a{sv}" name="task_data">
  24       <doc:doc>
  25         <doc:summary>
  26           The new tasks data.
  27         </doc:summary>
  28       </doc:doc>
  29     </arg>
  30     <arg direction="out" type="s" name="task_path">
  31       <doc:doc>
  32         <doc:summary>
  33           The path of the added task.
  34         </doc:summary>
  35       </doc:doc>
  36     </arg>
  37   </method>
  38
  39   <method name="GetSingleTaskSingleField">
  40     <annotation name="org.freedesktop.DBus.GLib.Async" value="true" />
  41     <doc:doc>
  42       <doc:description>
  43         Query the content of one field of one task.
  44       </doc:description>
  45     </doc:doc>
  46     <arg direction="in" type="a{sv}" name="query">
  47       <doc:doc>
  48         <doc:summary>
  49           The query.
  50         </doc:summary>
  51       </doc:doc>
  52     </arg>
  53     <arg direction="in" type="s" name="field">
  54       <doc:doc>
  55         <doc:summary>
  56           The name of the field to query.
  57         </doc:summary>
  58       </doc:doc>
  59     </arg>
  60     <arg direction="out" type="s" name="value">
  61       <doc:doc>
  62         <doc:summary>
  63           The content of the queried field.
  64         </doc:summary>
  65       </doc:doc>
  66     </arg>
  67   </method>
  68
  69   <method name="Query">
  70     <annotation name="org.freedesktop.DBus.GLib.Async" value="true" />
  71     <doc:doc>
  72       <doc:description>
  73         Start a query for tasks.
  74       </doc:description>
  75     </doc:doc>
  76     <arg direction="in" type="a{sv}" name="query">
  77       <doc:doc>
  78         <doc:summary>
  79           The query.
  80         </doc:summary>
  81       </doc:doc>
  82     </arg>
  83     <arg direction="out" type="s" name="query_path">
  84       <doc:doc>
  85         <doc:summary>
  86           The path for the started query.
  87         </doc:summary>
  88       </doc:doc>
  89     </arg>
  90   </method>
  91
  92   <signal name="NewTask">
  93     <doc:doc>
  94       <doc:description>
  95         Sent when a new task is loaded.
  96       </doc:description>
  97     </doc:doc>
  98     <arg type="s" name="task_path">
  99       <doc:doc>
 100         <doc:summary>
 101           The path of the newly loaded task.
 102         </doc:summary>
 103       </doc:doc>
 104     </arg>
 105   </signal>
 106
 107   <signal name="UnfinishedTasks">
 108     <doc:doc>
 109       <doc:description>
 110         Sent when amount of unfinished tasks changes.
 111       </doc:description>
 112     </doc:doc>
 113     <arg type="i" name="amount">
 114       <doc:doc>
 115         <doc:summary>
 116           Amount of unfinished tasks.
 117         </doc:summary>
 118       </doc:doc>
 119     </arg>
 120   </signal>
 121
 122
 123 </interface>
 124
 125 </node>
 126