summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPhilip Withnall <philip@tecnocode.co.uk>2014-08-31 00:04:28 +0100
committerPhilip Withnall <philip@tecnocode.co.uk>2014-09-15 18:42:52 +0100
commit4b96f5b68c0bc70bf7b0d76fc3c36ff9f9dbe5fd (patch)
tree1fb6fc0d0bd380b6ae76486dc98f5d663884138a
parentaf3498df1429182b85bec3e5cbfaeae8acebfe35 (diff)
downloadlibgdata-4b96f5b68c0bc70bf7b0d76fc3c36ff9f9dbe5fd.tar.gz
tasks: Add helper constants for GDataTasksTask:status
So the user doesn’t need to keep typing out the well-known strings which form the accepted values of GDataTasksTask:status. This adds new API: • GDATA_TASKS_STATUS_NEEDS_ACTION • GDATA_TASKS_STATUS_COMPLETED
-rw-r--r--docs/reference/gdata-sections.txt2
-rw-r--r--gdata/services/tasks/gdata-tasks-task.c5
-rw-r--r--gdata/services/tasks/gdata-tasks-task.h27
3 files changed, 32 insertions, 2 deletions
diff --git a/docs/reference/gdata-sections.txt b/docs/reference/gdata-sections.txt
index fdcac2fb..7f935c80 100644
--- a/docs/reference/gdata-sections.txt
+++ b/docs/reference/gdata-sections.txt
@@ -2523,6 +2523,8 @@ GDataTasksQueryPrivate
<SECTION>
<FILE>gdata-tasks-task</FILE>
<TITLE>GDataTasksTask</TITLE>
+GDATA_TASKS_STATUS_NEEDS_ACTION
+GDATA_TASKS_STATUS_COMPLETED
GDataTasksTask
GDataTasksTaskClass
gdata_tasks_task_new
diff --git a/gdata/services/tasks/gdata-tasks-task.c b/gdata/services/tasks/gdata-tasks-task.c
index 6f00fcfb..202a9a24 100644
--- a/gdata/services/tasks/gdata-tasks-task.c
+++ b/gdata/services/tasks/gdata-tasks-task.c
@@ -135,13 +135,14 @@ gdata_tasks_task_class_init (GDataTasksTaskClass *klass)
/**
* GDataTasksTask:status:
*
- * Status of the task. This is either "needsAction" or "completed".
+ * Status of the task. This is either %GDATA_TASKS_STATUS_NEEDS_ACTION
+ * or %GDATA_TASKS_STATUS_COMPLETED.
*
* Since: 0.15.0
*/
g_object_class_install_property (gobject_class, PROP_STATUS,
g_param_spec_string ("status",
- "Status of task", "Status of the task. This is either \"needsAction\" or \"completed\".",
+ "Status of task", "Status of the task.",
NULL,
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
diff --git a/gdata/services/tasks/gdata-tasks-task.h b/gdata/services/tasks/gdata-tasks-task.h
index e1f7d717..b887a1a9 100644
--- a/gdata/services/tasks/gdata-tasks-task.h
+++ b/gdata/services/tasks/gdata-tasks-task.h
@@ -28,6 +28,33 @@
G_BEGIN_DECLS
+/**
+ * GDATA_TASKS_STATUS_NEEDS_ACTION:
+ *
+ * A value for #GDataTasksTask:status indicating the task still needs action
+ * before it is complete.
+ *
+ * Reference:
+ * <ulink type="http" url="https://developers.google.com/google-apps/tasks/v1/reference/tasks#status">
+ * Google Tasks documentation</ulink>.
+ *
+ * Since: UNRELEASED
+ */
+#define GDATA_TASKS_STATUS_NEEDS_ACTION "needsAction"
+
+/**
+ * GDATA_TASKS_STATUS_COMPLETED:
+ *
+ * A value for #GDataTasksTask:status indicating the task has been completed.
+ *
+ * Reference:
+ * <ulink type="http" url="https://developers.google.com/google-apps/tasks/v1/reference/tasks#status">
+ * Google Tasks documentation</ulink>.
+ *
+ * Since: UNRELEASED
+ */
+#define GDATA_TASKS_STATUS_COMPLETED "completed"
+
#define GDATA_TYPE_TASKS_TASK (gdata_tasks_task_get_type ())
#define GDATA_TASKS_TASK(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), GDATA_TYPE_TASKS_TASK, GDataTasksTask))
#define GDATA_TASKS_TASK_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), GDATA_TYPE_TASKS_TASK, GDataTasksTaskClass))