diff options
Diffstat (limited to 'src/ui/contact_entry.h')
-rw-r--r-- | src/ui/contact_entry.h | 24 |
1 files changed, 23 insertions, 1 deletions
diff --git a/src/ui/contact_entry.h b/src/ui/contact_entry.h index a9ff9dd..dc692de 100644 --- a/src/ui/contact_entry.h +++ b/src/ui/contact_entry.h @@ -1,6 +1,6 @@ /* This file is part of GNUnet. - Copyright (C) 2021 GNUnet e.V. + Copyright (C) 2021--2022 GNUnet e.V. GNUnet is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published @@ -39,13 +39,35 @@ typedef struct UI_CONTACT_ENTRY_Handle GtkLabel *subtitle_label; } UI_CONTACT_ENTRY_Handle; +/** + * Allocates and creates a new contact entry + * handle to manage a contact in a list for + * a given messenger application. + * + * @param app Messenger application + * @return New contact entry handle + */ UI_CONTACT_ENTRY_Handle* ui_contact_entry_new(MESSENGER_Application *app); +/** + * Sets the content of the given contact entry + * handle respectively to visually represent a + * selected chat contact. + * + * @param handle Contact entry handle + * @param contact Chat contact + */ void ui_contact_entry_set_contact(UI_CONTACT_ENTRY_Handle* handle, const struct GNUNET_CHAT_Contact *contact); +/** + * Frees its resources and destroys a given + * contact entry handle. + * + * @param handle Contact entry handle + */ void ui_contact_entry_delete(UI_CONTACT_ENTRY_Handle *handle); |