summaryrefslogtreecommitdiff
path: root/libpurple/purplenotification.h
diff options
context:
space:
mode:
authorGary Kramlich <grim@reaperworld.com>2022-06-30 20:24:09 -0500
committerGary Kramlich <grim@reaperworld.com>2022-06-30 20:24:09 -0500
commitd4a16d165a9def887afc904de644249d15126877 (patch)
treef28aa7a7217bc8066a752c971a1dd7ca17f369c7 /libpurple/purplenotification.h
parentd5ab801a360aad629ab52aacb516bfea5b54346d (diff)
downloadpidgin-d4a16d165a9def887afc904de644249d15126877.tar.gz
Create and add notifications for account errors.
Adjust the NotificationManager API a bit to be easier to use and map better to GListStore which the manager is now using internally. Testing Done: Ran the unit tests and forced a connection error and verified no issues (used gdb to verify that item was added). Bugs closed: PIDGIN-17639 Reviewed at https://reviews.imfreedom.org/r/1509/
Diffstat (limited to 'libpurple/purplenotification.h')
-rw-r--r--libpurple/purplenotification.h17
1 files changed, 17 insertions, 0 deletions
diff --git a/libpurple/purplenotification.h b/libpurple/purplenotification.h
index b0ba49b2b7..3ec0bdc6f1 100644
--- a/libpurple/purplenotification.h
+++ b/libpurple/purplenotification.h
@@ -135,6 +135,8 @@ GDateTime *purple_notification_get_created_timestamp(PurpleNotification *notific
* Timestamp is internally converted to UTC so you don't need to do that ahead
* of time.
*
+ * If @timestamp is %NULL, the current time will be used.
+ *
* Since: 3.0.0
*/
void purple_notification_set_created_timestamp(PurpleNotification *notification, GDateTime *timestamp);
@@ -243,6 +245,21 @@ void purple_notification_set_interactive(PurpleNotification *notification, gbool
*/
gpointer purple_notification_get_data(PurpleNotification *notification);
+/**
+ * purple_notification_compare:
+ * @a: The first notification to compare.
+ * @b: The second notification to compare.
+ *
+ * A comparison function for PurpleNotification that is suitable as a
+ * GCompareFunc.
+ *
+ * Returns: -1 if @a's created timestamp occurred before @b, 0 if they were
+ * created at the same time, or 1 if @b was created before @a.
+ *
+ * Since: 3.0.0
+ */
+gint purple_notification_compare(gconstpointer a, gconstpointer b);
+
G_END_DECLS
#endif /* PURPLE_NOTIFICATION */