diff options
Diffstat (limited to 'src/event.h')
| -rw-r--r-- | src/event.h | 72 |
1 files changed, 72 insertions, 0 deletions
diff --git a/src/event.h b/src/event.h index 505309c..d89e453 100644 --- a/src/event.h +++ b/src/event.h @@ -27,42 +27,114 @@ #include "application.h" +/** + * Event for the UI to be called whenever the application + * causes any issue in back-end throwing a warning. This + * might be specific to a given context or none if its + * a general warning. + * + * @param app Messenger application + * @param context Chat context or NULL + * @param msg Warning message + */ void event_handle_warning(MESSENGER_Application *app, struct GNUNET_CHAT_Context *context, const struct GNUNET_CHAT_Message *msg); +/** + * Event for the UI to be called whenever the accounts + * might add or remove an account from their list. + * + * @param app Messenger application + */ void event_refresh_accounts(MESSENGER_Application *app); +/** + * Event for the UI to be called whenever the user + * updates their information. + * + * @param app Messenger application + */ void event_update_profile(MESSENGER_Application *app); +/** + * Event for the UI to be called whenever a the user + * joins or leaves a chat (context) via message. + * + * @param app Messenger application + * @param context Chat context + * @param msg Join/Leave message + */ void event_update_chats(MESSENGER_Application *app, struct GNUNET_CHAT_Context *context, const struct GNUNET_CHAT_Message *msg); +/** + * Event for the UI to be called whenever a contact + * joins or leaves a given context via message. + * + * @param app Messenger application + * @param context Chat context + * @param msg Join/Leave message + */ void event_presence_contact(MESSENGER_Application *app, struct GNUNET_CHAT_Context *context, const struct GNUNET_CHAT_Message *msg); +/** + * Event for the UI to be called whenever a contact + * updates their information with a message in a + * given context. + * + * @param app Messenger application + * @param context Chat context + * @param msg Update message + */ void event_update_contacts(MESSENGER_Application *app, struct GNUNET_CHAT_Context *context, const struct GNUNET_CHAT_Message *msg); +/** + * Event for the UI to be called whenever an invitation + * message gets received in a given context. + * + * @param app Messenger application + * @param context Chat context + * @param msg Invitation message + */ void event_invitation(MESSENGER_Application *app, struct GNUNET_CHAT_Context *context, const struct GNUNET_CHAT_Message *msg); +/** + * Event for the UI to be called whenever a content + * message (text or file) gets received in a given + * context. + * + * @param app Messenger application + * @param context Chat context + * @param msg Message + */ void event_receive_message(MESSENGER_Application *app, struct GNUNET_CHAT_Context *context, const struct GNUNET_CHAT_Message *msg); +/** + * Event for the UI to be called whenever a message + * gets deleted in a given context. + * + * @param app Messenger application + * @param context Chat context + * @param msg Delete message + */ void event_delete_message(MESSENGER_Application *app, struct GNUNET_CHAT_Context *context, |