blob: 20f8fc609dfa262d96700cbc6a28e00717aa87d4 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
/*
This file is part of GNUnet.
Copyright (C) 2021--2024 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
by the Free Software Foundation, either version 3 of the License,
or (at your option) any later version.
GNUnet is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
SPDX-License-Identifier: AGPL3.0-or-later
*/
/*
* @author Tobias Frisch
* @file contact.h
*/
#ifndef CONTACT_H_
#define CONTACT_H_
#include "application.h"
typedef struct MESSENGER_ContactInfo
{
void *last_message;
GList *name_labels;
GList *name_avatars;
GList *visible_widgets;
} MESSENGER_ContactInfo;
/**
* Creates a contact information struct to potentially
* update all GUI appearances of a specific contact at
* once.
*
* @param contact Chat contact
*/
void
contact_create_info(struct GNUNET_CHAT_Contact *contact);
/**
* Destroys and frees resources allocated for a given
* contact information struct.
*
* @param contact Chat contact
*/
void
contact_destroy_info(struct GNUNET_CHAT_Contact *contact);
/**
* Sets the latest join/leave UI message handle so that
* the application can check whether a contact is available.
*
* @param contact Chat contact
* @param message Pointer to UI message handle
*/
void
contact_set_last_message_to_info(const struct GNUNET_CHAT_Contact *contact,
void *message);
/**
* Returns the latest join/leave UI message handle of
* a specific contact.
*
* @param contact Chat contact
*/
void*
contact_get_last_message_from_info(const struct GNUNET_CHAT_Contact *contact);
/**
* Adds a GtkLabel to the list of labels
* which get updated by state changes.
*
* @param contact Chat contact
* @param label Label
*/
void
contact_add_name_label_to_info(const struct GNUNET_CHAT_Contact *contact,
GtkLabel *label);
/**
* Removes a GtkLabel from the list of labels
* which get updated by state changes.
*
* @param contact Chat contact
* @param label Label
*/
void
contact_remove_name_label_from_info(const struct GNUNET_CHAT_Contact *contact,
GtkLabel *label);
/**
* Adds a HdyAvatar to the list of avatars
* which get updated by state changes.
*
* @param contact Chat contact
* @param avatar Avatar
*/
void
contact_add_name_avatar_to_info(const struct GNUNET_CHAT_Contact *contact,
HdyAvatar *avatar);
/**
* Removes a HdyAvatar from the list of avatars
* which get updated by state changes.
*
* @param contact Chat contact
* @param avatar Avatar
*/
void
contact_remove_name_avatar_from_info(const struct GNUNET_CHAT_Contact *contact,
HdyAvatar *avatar);
/**
* Adds a GtkWidget to the list of widgets
* which get visibility updated by state changes.
*
* @param contact Chat contact
* @param widget Widget
*/
void
contact_add_visible_widget_to_info(const struct GNUNET_CHAT_Contact *contact,
GtkWidget *widget);
/**
* Removes a GtkWidget from the list of widgets
* which get visibility updated by state changes.
*
* @param contact Chat contact
* @param widget Widget
*/
void
contact_remove_visible_widget_to_info(const struct GNUNET_CHAT_Contact *contact,
GtkWidget *widget);
/**
* Updates the connected UI elements for a given
* contact depending on the current state.
*
* @param contact Chat contact
*/
void
contact_update_info(const struct GNUNET_CHAT_Contact *contact);
#endif /* CONTACT_H_ */
|
