Gnome Gtd

Posted on  by admin

I’ve been wanting a good GTD app on Linux for a while now. GNOME To Do doesn’t cut it for me, and Getting Things GNOME is too outdated and lacking in features. I enjoy Everdo quite a lot, but it’s sadly not FOSS, so I’ve been planning to write a GTK-based alternative to Everdo at some point in the future. 'In the spirit of GTD, GTG is a simple application with a straightforward interface that allows you to spend more time working than fiddling with an application that's purpose is to make you work more efficiently. Unlike some applications that have cumbersome or complicated interfaces, GTG is easy to use and easy to get up and running with.'

GtdNotification

GtdNotification — a notification with actions

Functions

GTG is an application made and tested on Linux-based OSes (like Fedora and Ubuntu). Some rumors say it works on.BSD, but we're pretty sure it does not work on Windows (because none of us run that). We're developing GTG to make our lives more pleasant and productive on Linux, not to compete with the plethora of proprietary GTD apps out there.

void(*GtdNotificationActionFunc)()
GtdNotification *gtd_notification_new()
voidgtd_notification_execute_primary_action()
voidgtd_notification_execute_secondary_action()
voidgtd_notification_start()
voidgtd_notification_stop()
voidgtd_notification_set_primary_action()
voidgtd_notification_set_secondary_action()
const gchar *gtd_notification_get_text()
voidgtd_notification_set_text()
gdoublegtd_notification_get_timeout()
voidgtd_notification_set_timeout()

Properties

gbooleanhas-primary-actionRead
gbooleanhas-secondary-actionRead
gchar *secondary-action-nameRead / Write
gchar *textRead / Write
gdoubletimeoutRead / Write

Signals

Types and Values

Object Hierarchy

Description

The GtdNotification represents a notification shown at the top ofthe window. The action can have a primary action that is called whenthe notification is gone.

Optionally, the notification may have a secondary action (see gtd_notification_set_secondary_action())shown as a button.

The notification may also have a timeout, which is how long the notificationis displayed. By default, the timeout is 7.5 seconds.

Example:

Gnome

Functions

GtdNotificationActionFunc ()

Will be called when the primary or secondary action of notificationis executed.

Parameters

notification

the GtdNotification running the function

user_data

user data.

[closure]

gtd_notification_new ()

Creates a new notification with text and timeout. If timeout is0, the notification is indefinitely displayed.

Parameters

text

text of the notification.

[nullable]

timeout

time for the notification to stay visible

gtd_notification_execute_primary_action ()

Executes the primary action of notification if set.

Parameters

gtd_notification_execute_secondary_action ()

Executes the secondary action of notification if any.

Parameters

gtd_notification_start ()

Starts the timeout of notification. Use gtd_notification_stop()to stop it.

Parameters

gtd_notification_stop ()

Stops the timeout of notification. Use gtd_notification_start()to start it.

Parameters

gtd_notification_set_primary_action ()

Sets the primary action of notification, which is triggeredon dismiss or timeout.

Parameters

notification

a GtdNotification

func

the primary action function.

[closure user_data][scope call][nullable]

user_data

data passed to func

gtd_notification_set_secondary_action ()

Sets the secondary action of notification, which is triggeredonly on user explicit input.

Parameters

notification

a GtdNotification

name

the name of the secondary action

func

the secondary action function.

[closure user_data][scope call][nullable]

user_data

data passed to func

gtd_notification_get_text ()

Gets the text of notification.

Parameters

Returns

the text of notification.

[transfer none]

gtd_notification_set_text ()

Sets the text of notification to text.

Parameters

notification

a GtdNotification

text

the user-visible text of notification

gtd_notification_get_timeout ()

Retrieves the timeout of notification.

gtd_notification_set_timeout ()

Sets the timeout of notification to timeout. Set it to 0 to disablethe timeout.

Parameters

Gnome Gtd

notification

a GtdNotification

timeout

the time to wait before running notification, in miliseconds

Types and Values

GtdNotification

Property Details

The “has-primary-action” property

Whether the notification has the primary action, activated on timeout or dismiss.

Flags: Read

Default value: FALSE

The “has-secondary-action” property

Whether the notification has the secondary action, activated by the user.

Flags: Read

Default value: FALSE

The “secondary-action-name” property

The text of the secondary action button.

Flags: Read / Write

Default value: '

The “text” property

The main message of the notification.

Flags: Read / Write

Default value: '

The “timeout” property

The time the notification is displayed.

Flags: Read / Write

Allowed values: [0,30000]

Default value: 7500

Signal Details

The “executed” signal

The ::executed signal is emmited after the primary or secondaryGtdNotification action is executed.

Parameters

user_data

user data set when the signal handler was connected.

Flags: Run First

GtdTaskList

GtdTaskList — a list of tasks

Stability Level

Unstable, unless otherwise indicated

Gnome Gdm Theme

Functions

GtdTaskList *gtd_task_list_new()
GdkRGBA *gtd_task_list_get_color()
voidgtd_task_list_set_color()
gbooleangtd_task_list_is_removable()
voidgtd_task_list_set_is_removable()
const gchar *gtd_task_list_get_name()
voidgtd_task_list_set_name()
GtdProvider *gtd_task_list_get_provider()
voidgtd_task_list_set_provider()
GList *gtd_task_list_get_tasks()
voidgtd_task_list_save_task()
voidgtd_task_list_remove_task()
gbooleangtd_task_list_contains()

Properties

GdkRGBA *colorRead / Write
gbooleanis-removableRead / Write
gchar *nameRead / Write
GtdProvider *providerRead / Write

Signals

voidtask-addedRun Last
voidtask-removedRun Last
voidtask-updatedRun Last

Types and Values

#defineGTD_TYPE_TASK_LIST
structGtdTaskListClass
GtdTaskList

Description

Gnome Gtk3

A GtdTaskList represents a task list, and contains a list of tasks, a color,a name and the provider who generated it.

Functions

gtd_task_list_new ()

Creates a new list.

Parameters

Returns

the new GtdTaskList.

[transfer full]

gtd_task_list_get_color ()

Retrieves the color of list. It is guarantee that it always returns acolor, given a valid GtdTaskList.

Parameters

Returns

the color of list. Free with gdk_rgba_free after use.

[transfer full]

gtd_task_list_set_color ()

sets the color of list.

Parameters

gtd_task_list_is_removable ()

gtd_task_list_set_is_removable ()

Sets whether list can be deleted or not.

Parameters

list

a GtdTaskList

is_removable

TRUE if listcan be deleted, FALSE otherwise

gtd_task_list_get_name ()

Retrieves the user-visible name of list, or NULL.

Parameters

Returns

the internal name of list. Do not freeafter use.

[transfer none]

gtd_task_list_set_name ()

Sets the list name to name.

Parameters

list

a GtdTaskList

name

the name of list.

[nullable]

gtd_task_list_get_provider ()

Retrieves the GtdProvider who owns this list.

Parameters

Returns

a GtdProvider.

[transfer none]

gtd_task_list_set_provider ()

Sets the provider of this tasklist.

Parameters

self

a GtdTaskList

provider

a GtdProvider, or NULL.

[nullable]

gtd_task_list_get_tasks ()

Returns the list's tasks.

Parameters

Returns

a newly-allocated list of the list's tasks.

[element-type GtdTask][transfer container]

gtd_task_list_save_task ()

Adds or updates task to list if it's not already present.

Gnome

Parameters

gtd_task_list_remove_task ()

Removes task from list if it's inside the list.

Parameters

gtd_task_list_contains ()

Checks if task is inside list.

Parameters

Returns

TRUE if listcontains task, FALSE otherwise

Types and Values

struct GtdTaskListClass

Property Details

The “color” property

The color of the list.

Flags: Read / Write

The “is-removable” property

Whether the task list can be removed from the system.

Flags: Read / Write

Default value: FALSE

The “name” property

The name of the list.

Flags: Read / Write

Default value: NULL

The “provider” property

The provider that handles the list.

Flags: Read / Write

Signal Details

The “task-added” signal

The ::task-added signal is emmited after a GtdTaskis added to the list.

Parameters

Gnome Gtd

list

a GtdTaskList

task

a GtdTask

user_data

user data set when the signal handler was connected.

Flags: Run Last

The “task-removed” signal

The ::task-removed signal is emmited after a GtdTaskis removed from the list.

Parameters

list

a GtdTaskList

task

a GtdTask

user_data

user data set when the signal handler was connected.

Flags: Run Last

The “task-updated” signal

The ::task-updated signal is emmited after a GtdTaskin the list is updated.

Parameters

list

a GtdTaskList

task

a GtdTask

user_data

user data set when the signal handler was connected.

Flags: Run Last

Generated by GTK-Doc V1.25.1