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
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
|
/*
chatmessagepart.h - Chat Message KPart
Copyright (c) 2004 by Richard Smith <kde@metafoo.co.uk>
Copyright (c) 2005 by Michaël Larouche <michael.larouche@kdemail.net>
Kopete (c) 2002-2005 by the Kopete developers <kopete-devel@kde.org>
*************************************************************************
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
* the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. *
* *
*************************************************************************
*/
#ifndef CHATMESSAGEPART_H
#define CHATMESSAGEPART_H
#include <tdehtml_part.h>
#include <dom/html_element.h>
#include <tqvaluelist.h>
namespace Kopete
{
class Message;
class ChatSession;
class Contact;
}
class KPopupMenu;
class ChatWindowStyle;
/**
* @author Richard Smith
*/
class ChatMessagePart : public TDEHTMLPart
{
Q_OBJECT
public:
/**
* Create a new ChatMessage Part.
*/
ChatMessagePart( Kopete::ChatSession *manager, TQWidget *parent, const char *name = 0);
~ChatMessagePart();
/**
* Clear the message window
*/
void clear();
/**
* Immediately scroll the chat to the bottom, as long as it has not been intentionally scrolled away from the bottom
* use
*/
void keepScrolledDown();
public slots:
/**
* Initiates a copy action
* If there is text selected in the HTML view, that text is copied
* Otherwise if @p justselection is false, the entire edit area is copied.
*
* @param justselection If this is true, then the text will be only copied to the selection buffer only.
* In this mode, if nothing is selected, then nothing is copied.
*/
void copy(bool justselection = false);
/**
* Print out the contents of the chatwindow
*/
void print();
/**
* Save the contents of the chat to a file
*/
void save();
/**
* Scroll the view up a page
*/
void pageUp();
/**
* Scroll the view down a page
*/
void pageDown();
/**
* Appends a message to the messave view
* @param message The message to be appended
* @param restoring This flag is used to not re-append message when changing style. By default false.
*/
void appendMessage( Kopete::Message &message, bool restoring = false);
/**
* Change the current style.
* This method override is used when preferences change.
* This method create a new ChatWindowStyle object.
*
* Need to rebuild all the XHTML content.
*
* @param stylePath absolute path to the style.
*/
void setStyle( const TQString &stylePath );
/**
* Change the current style
* This method override is used on preview and unit tests.
* Use a already existing ChatWindowStyle object.
*
* Need to rebuild all the XHTML content.
*
* @param chatWindowStyle ChatWindowStyle object.
*/
void setStyle( ChatWindowStyle *style );
/**
* Change the current variant for the current style
* @param variantPath relative path to the style variant.
*/
void setStyleVariant( const TQString &variantPath );
signals:
/**
* Emits before the context menu is about to show
*/
void contextMenuEvent( const TQString &textUnderMouse, KPopupMenu *popupMenu );
/**
* Emits before the tooltip is about to show
*/
void tooltipEvent( const TQString &textUnderMouse, TQString &toolTip );
private slots:
void slotOpenURLRequest( const KURL &url, const KParts::URLArgs &args );
void slotScrollView();
void slotAppearanceChanged();
void slotScrollingTo( int x, int y );
void slotRefreshView();
void slotRightClick( const TQString &, const TQPoint &point );
void slotCopyURL();
void slotCloseView( bool force = false );
void slotImportEmoticon();
/**
* Do the actual style change.
*/
void changeStyle();
/**
* Update the display in the header template if any.
*/
void slotUpdateHeaderDisplayName();
/**
* Upda the photo in the header.
*/
void slotUpdateHeaderPhoto();
protected:
virtual void tdehtmlDrawContentsEvent( tdehtml::DrawContentsEvent * );
private:
void readOverrides();
const TQString styleHTML() const;
Kopete::Contact *contactFromNode( const DOM::Node &n ) const;
/**
* Emits before the tooltip is about to show
*/
void emitTooltipEvent( const TQString &textUnderMouse, TQString &toolTipString );
/**
* Returns the text currently under the mouse
*/
TQString textUnderMouse();
/**
* Format(replace) style keywords for messages (incoming, outgoing, internal)
* Use formatStyleKeywords(const TQString &sourceHTML) for header and footer.
*
* @param sourceHTML the source html which contains the keywords
* @param message the current Message.
*
* @return the resulting HTML with replaced keywords.
*/
TQString formatStyleKeywords( const TQString &sourceHTML, const Kopete::Message &message );
/**
* Format(replace) style keywords for header and footers.
* For messages, use formatStyleKeywords(const TQString &sourceHTML, Kopete::Message &message) instead.
*
* @param sourceHTML HTML source needed to be replaced.
*
* @return the resulting HTML with replaced keywords.
*/
TQString formatStyleKeywords( const TQString &sourceHTML );
/**
* Helper function to parse time in correct format.
* Use glibc strftime function.
*
* @param timeFormat the time format to parse.
* @param dateTime the TQDateTime which contains the datetime to format.
* @return the formatted time string.
*/
TQString formatTime(const TQString &timeFormat, const TQDateTime &dateTime);
/**
* Format a nickname/displayname according to preferences.
*
* @param sourceName Source name to format.
* @return the formatted name.
*/
TQString formatName( const TQString &sourceName );
/**
* Format a message body according to the style included
* in the message.
*
* @param message Kopete::Message to format.
* @return a span tag with a style attribute.
*/
TQString formatMessageBody( const Kopete::Message &message );
/**
* Write the template file to TDEHTMLPart
*/
void writeTemplate();
class ToolTip;
friend class ToolTip;
class Private;
Private *d;
};
#endif
// vim: set noet ts=4 sts=4 sw=4:
|
