 |
 |
 |
Libnotify Reference Manual |  |
|---|---|---|---|---|
| Top | Description | ||||
Synopsis
gboolean notify_init (const char *app_name); void notify_uninit (void); gboolean notify_is_initted (void); const char * notify_get_app_name (void); void notify_set_app_name (const char *app_name); GList * notify_get_server_caps (void); gboolean notify_get_server_info (char **ret_name,char **ret_vendor,char **ret_version,char **ret_spec_version);
Details
notify_init ()
gboolean notify_init (const char *app_name);
Initialized libnotify. This must be called before any other functions.
notify_uninit ()
void notify_uninit (void);
Uninitialized libnotify.
This should be called when the program no longer needs libnotify for the rest of its lifecycle, typically just before exitting.
notify_is_initted ()
gboolean notify_is_initted (void);
Gets whether or not libnotify is initialized.
notify_get_app_name ()
const char * notify_get_app_name (void);
Gets the application name registered.
Returns : |
The registered application name, passed to notify_init(). |
notify_set_app_name ()
void notify_set_app_name (const char *app_name);
Sets the application name.
|
The name of the application |
notify_get_server_caps ()
GList * notify_get_server_caps (void);
Synchronously queries the server for its capabilities and returns them in a GList.
Returns : |
a GList of server capability strings. Free
the list elements with g_free() and the list itself with g_list_free(). [transfer full][element-type utf8]
|
notify_get_server_info ()
gboolean notify_get_server_info (char **ret_name,char **ret_vendor,char **ret_version,char **ret_spec_version);
Synchronously queries the server for its information, specifically, the name, vendor, server version, and the version of the notifications specification that it is compliant with.
|
a location to store the server name, or NULL. [out][allow-none][transfer full]
|
|
a location to store the server vendor, or NULL. [out][allow-none][transfer full]
|
|
a location to store the server version, or NULL. [out][allow-none][transfer full]
|
|
a location to store the version the service is compliant with, or NULL. [out][allow-none][transfer full]
|
Returns : |
TRUE if successful, and the variables passed will be set, FALSE
on error. The returned strings must be freed with g_free |