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
|
/** @page gtkconv-signals GtkConv Signals
@signals
@signal conversation-dragging
@signal conversation-timestamp
@signal displaying-im-msg
@signal displayed-im-msg
@signal displaying-chat-msg
@signal displayed-chat-msg
@signal conversation-switched
@signal conversation-hiding
@signal conversation-displayed
@endsignals
@see gtkconv.h
<hr>
@signaldef conversation-dragging
@signalproto
void (*conversation_dragging)(PidginWindow *source, PidginWindow *destination);
@endsignalproto
@signaldesc
Emitted when a conversation is being drag and dropped between windows.
@param source The window where the conversation is.
@param destination The window where the conversation will be moved to.
@endsignaldef
@signaldef conversation-timestamp
@signalproto
char *(*conversation_timestamp)(PurpleConversation *conv, time_t when,
gboolean show_date);
@endsignalproto
@signaldesc
Emitted to allow plugins to customize the timestamp on a message.
@param conv The conversation the message belongs to.
@param when The time to be converted to a string.
@param show_date Whether the date should be displayed.
@return A textual representation of the time, or @c NULL to use a
default format.
@endsignaldef
@signaldef displaying-im-msg
@signalproto
gboolean (*displaying_im_msg)(PurpleAccount *account, const char *who,
char **message, PurpleConversation *conv,
PurpleMessageFlags flags);
@endsignalproto
@signaldesc
Emitted just before a message is displayed in an IM conversation.
@a message is a pointer to a string, so the plugin can replace the
message that will be displayed. This can also be used to cancel displaying
a message by returning @c TRUE.
@note
Make sure to free @a *message before you replace it!
@param account The account.
@param who The name of the user.
@param message A pointer to the message.
@param conv The conversation.
@param flags Flags for this message.
@return @c TRUE if the message should be canceled, or @c FALSE otherwise.
@endsignaldef
@signaldef displayed-im-msg
@signalproto
void (*displayed_im_msg)(PurpleAccount *account, const char *who,
char *message, PurpleConversation *conv,
PurpleMessageFlags flags);
@endsignalproto
@signaldesc
Emitted after a message is displayed in an IM conversation.
@param account The account.
@param who The name of the user.
@param message The message.
@param conv The conversation.
@param flags Flags for this message.
@endsignaldef
@signaldef displaying-chat-msg
@signalproto
gboolean (*displaying_chat_msg)(PurpleAccount *account, const char *who,
char **message, PurpleConversation *conv,
PurpleMessageFlags flags);
@endsignalproto
@signaldesc
Emitted just before a message is displayed in a chat.
@a message is a pointer to a string, so the plugin can replace the
message that will be displayed. This can also be used to cancel displaying
a message by returning @c TRUE.
@note
Make sure to free @a *message before you replace it!
@param account The account the message is being displayed and sent on.
@param who The name of the user.
@param message A pointer to the message that will be displayed and sent.
@param conv The conversation the message is being displayed and sent on.
@param flags Flags for this message.
@return @c TRUE if the message should be canceled, or @c FALSE otherwise.
@endsignaldef
@signaldef displayed-chat-msg
@signalproto
void (*displayed_chat_msg)(PurpleAccount *account, const char *who,
char *message, PurpleConversation *conv,
PurpleMessageFlags flags);
@endsignalproto
@signaldesc
Emitted after a message is displayed in a chat conversation.
@param account The account the message is being displayed and sent on.
@param who The name of the user.
@param message A pointer to the message that will be displayed and sent.
@param conv The conversation the message is being displayed and sent on.
@param flags Flags for this message.
@endsignaldef
@signaldef conversation-switched
@signalproto
void (*conversation_switched)(PurpleConversation *conv);
@endsignalproto
@signaldesc
Emitted when a window switched from one conversation to another.
@param new_conv The now active conversation.
@endsignaldef
@signaldef conversation-hiding
@signalproto
void (*conversation_hiding)(PidginConversation *gtkconv);
@endsignalproto
@signaldesc
Emitted immediately before an existing conversation is hidden.
@param gtkconv The PidginConversation
@since 2.2.0
@endsignaldef
@signaldef conversation-displayed
@signalproto
void (*conversation_displayed)(PidginConversation *gtkconv);
@endsignalproto
@signaldesc
Emitted right after the Pidgin UI is attached to a new or a hidden conversation.
@param gtkconv The PidginConversation
@since 2.2.0
@endsignaldef
*/
// vim: syntax=c.doxygen tw=75 et
|
