File: notecontent.h

package info (click to toggle)
basket 1.0.2-5
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 14,272 kB
  • ctags: 3,211
  • sloc: cpp: 28,424; sh: 9,518; perl: 2,730; makefile: 235
file content (603 lines) | stat: -rw-r--r-- 29,547 bytes parent folder | download
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
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
/***************************************************************************
 *   Copyright (C) 2003 by Sébastien Laoût                                 *
 *   slaout@linux62.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.                                   *
 *                                                                         *
 *   This program 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 General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program; if not, write to the                         *
 *   Free Software Foundation, Inc.,                                       *
 *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
 ***************************************************************************/

#ifndef NOTECONTENT_H
#define NOTECONTENT_H

#include <qobject.h>
#include <qstring.h>
#include <qsimplerichtext.h>
#include <qpixmap.h>
#include <qmovie.h>
#include <qcolor.h>
#include <kurl.h>

#include "linklabel.h"

class QDomDocument;
class QDomElement;
class QPainter;
class QWidget;
class QPoint;
class QRect;
class QStringList;
class KMultipleDrag;

class KFileItem;
namespace KIO { class PreviewJob; }

class Note;
class Basket;
class FilterData;
class HtmlExporter;

/** A list of numeric identifier for each note type.
  * Declare a varible with the type NoteType::Id and assign a value like NoteType::Text...
  * @author S�astien Laot
  */
namespace NoteType
{
	enum Id { Group = 255, Text = 1, Html, Image, Animation, Sound, File, Link, Launcher, Color, Unknown }; // Always positive
}

/** Abstract base class for every content type of basket note.
 * It's a base class to represent those types: Text, Html, Image, Animation, Sound, File, Link, Launcher, Color, Unknown.
 * @author S�astien Laot
 */
class NoteContent // TODO: Mark some methods as const!             and some (like typeName() as static!
{
  public:
	// Constructor and destructor:
	NoteContent(Note *parent, const QString &fileName = "");              /// << Constructor. Inherited notes should call it to initialize the parent note.
	virtual ~NoteContent()                                             {} /// << Virtual destructor. Reimplement it if you should destroy some data your custom types.
	// Simple Abstract Generic Methods:
	virtual NoteType::Id type()                                      = 0; /// << @return the internal number that identify that note type.
	virtual QString typeName()                                       = 0; /// << @return the translated type name to display in the user interface.
	virtual QString lowerTypeName()                                  = 0; /// << @return the type name in lowercase without space, for eg. saving.
	virtual QString toText(const QString &cuttedFullPath);                /// << @return a plain text equivalent of the content.
	virtual QString toHtml(const QString &imageName, const QString &cuttedFullPath) = 0; /// << @return an HTML text equivalent of the content. @param imageName Save image in this Qt ressource.
	virtual QPixmap toPixmap()                      { return QPixmap(); } /// << @return an image equivalent of the content.
	virtual void    toLink(KURL *url, QString *title, const QString &cuttedFullPath); /// << Set the link to the content. By default, it set them to fullPath() if useFile().
	virtual bool    useFile()                                        = 0; /// << @return true if it use a file to store the content.
	virtual bool    canBeSavedAs()                                   = 0; /// << @return true if the content can be saved as a file by the user.
	virtual QString saveAsFilters()                                  = 0; /// << @return the filters for the user to choose a file destination to save the note as.
	virtual bool    match(const FilterData &data)                    = 0; /// << @return true if the content match the filter criterias.
	// Complexe Abstract Generic Methods:
	virtual void exportToHTML(HTMLExporter *exporter, int indent)    = 0; /// << Export the note in an HTML file.
	virtual QString cssClass()                                       = 0; /// << @return the CSS class of the note when exported to HTML
	virtual int     setWidthAndGetHeight(int width)                  = 0; /// << Relayout content with @p width (never less than minWidth()). @return its new height.
	virtual void    paint(QPainter *painter, int width, int height, const QColorGroup &colorGroup, bool isDefaultColor, bool isSelected, bool isHovered) = 0; /// << Paint the content on @p painter, at coordinate (0, 0) and with the size (@p width, @p height).
	virtual bool    loadFromFile(bool /*lazyLoad*/)     { return false; } /// << Load the content from the file. The default implementation does nothing. @see fileName().
	virtual bool    finishLazyLoad()                    { return false; } /// << Load what was not loaded by loadFromFile() if it was lazy-loaded
	virtual bool    saveToFile()                        { return false; } /// << Save the content to the file. The default implementation does nothing. @see fileName().
	virtual QString linkAt(const QPoint &/*pos*/)          { return ""; } /// << @return the link anchor at position @p pos or "" if there is no link.
	virtual void    saveToNode(QDomDocument &doc, QDomElement &content);  /// << Save the note in the basket XML file. By default it store the filename if a file is used.
	virtual void    fontChanged()                                    = 0; /// << If your content display textual data, called when the font have changed (from tags or basket font)
	virtual void    linkLookChanged()                                  {} /// << If your content use LinkDisplay with preview enabled, reload the preview (can have changed size)
	virtual QString editToolTipText()                                = 0; /// << @return "Edit this [text|image|...]" to put in the tooltip for the note's content zone.
	virtual void    toolTipInfos(QStringList */*keys*/, QStringList */*values*/) {} /// << Get "key: value" couples to put in the tooltip for the note's content zone.
	// Custom Zones:                                                      ///    Implement this if you want to store custom data.
	virtual int     zoneAt(const QPoint &/*pos*/)           { return 0; } /// << If your note-type have custom zones, @return the zone at @p pos or 0 if it's not a custom zone!
	virtual QRect   zoneRect(int zone, const QPoint &/*pos*/);            /// << Idem, @return the rect of the custom zone
	virtual QString zoneTip(int /*zone*/)                  { return ""; } /// << Idem, @return the toolTip of the custom zone
	virtual void    setCursor(QWidget */*widget*/, int /*zone*/)       {} /// << Idem, set the mouse cursor for widget @p widget when it is over zone @p zone!
	virtual void    setHoveredZone(int /*oldZone*/, int /*newZone*/)   {} /// << If your note type need some feedback, you get notified of hovering changes here.
	virtual QString statusBarMessage(int /*zone*/)         { return ""; } /// << @return the statusBar message to show for zone @p zone, or "" if nothing special have to be said.
	// Drag and Drop Content:
	virtual void    serialize(QDataStream &/*stream*/)                 {} /// << Serialize the content in a QDragObject. If it consists of a file, it can be serialized for you.
	virtual bool    shouldSerializeFile()           { return useFile(); } /// << @return true if the dragging process should serialize the filename (and move the file if cutting).
	virtual void    addAlternateDragObjects(KMultipleDrag*/*dragObj*/) {} /// << If you offer more than toText/Html/Image/Link(), this will be called if this is the only selected.
	virtual QPixmap feedbackPixmap(int width, int height)            = 0; /// << @return the pixmap to put under the cursor while dragging this object.
	virtual bool    needSpaceForFeedbackPixmap()        { return false; } /// << @return true if a space must be inserted before and after the DND feedback pixmap.
	// Content Edition:
	virtual int      xEditorIndent()                        { return 0; } /// << If the editor should be indented (eg. to not cover an icon), return the number of pixels.
	// Open Content or File:
	virtual KURL urlToOpen(bool /*with*/); /// << @return the URL to open the note, or an invalid KURL if it's not openable. If @p with if false, it's a normal "Open". If it's true, it's for an "Open with..." action. The default implementation return the fullPath() if the note useFile() and nothing if not.
	enum OpenMessage {
		OpenOne,              /// << Message to send to the statusbar when opening this note.
		OpenSeveral,          /// << Message to send to the statusbar when opening several notes of this type.
		OpenOneWith,          /// << Message to send to the statusbar when doing "Open With..." on this note.
		OpenSeveralWith,      /// << Message to send to the statusbar when doing "Open With..." several notes of this type.
		OpenOneWithDialog,    /// << Prompt-message of the "Open With..." dialog for this note.
		OpenSeveralWithDialog /// << Prompt-message of the "Open With..." dialog for several notes of this type.
	};
	virtual QString messageWhenOpenning(OpenMessage /*where*/) { return QString(); } /// << @return the message to display according to @p where or nothing if it can't be done. @see OpenMessage describing the nature of the message that should be returned... The default implementation return an empty string. NOTE: If urlToOpen() is invalid and messageWhenOpenning() is not empty, then the user will be prompted to edit the note (with the message returned by messageWhenOpenning()) for eg. being able to edit URL of a link if it's empty when opening it...
	virtual QString customOpenCommand() { return QString(); }  /// << Reimplement this if your urlToOpen() should be opened with another application instead of the default KDE one. This choice should be left to the users in the setting (choice to use a custom app or not, and which app).
	// Common File Management:                                            ///    (and do save changes) and optionnaly hide the toolbar.
	virtual void setFileName(const QString &fileName); /// << Set the filename. Reimplement it if you eg. want to update the view when the filename is changed.
	bool trySetFileName(const QString &fileName);      /// << Set the new filename and return true. Can fail and return false if a file with this fileName already exists.
	QString  fullPath();                               /// << Get the absolute path of the file where this content is stored on disk.
	QString  fileName() { return m_fileName; }         /// << Get the file name where this content is stored (relative to the basket folder). @see fullPath().
	int      minWidth() { return m_minWidth; }         /// << Get the minimum width for this content.
	Note    *note()     { return m_note;     }         /// << Get the note managing this content.
	Basket  *basket();                                 /// << Get the basket containing the note managing this content.
  public:
	void setEdited(); /// << Mark the note as edited NOW: change the "last modification time and time" AND save the basket to XML file.
  protected:
	void contentChanged(int newMinWidth); /// << When the content has changed, inherited classes should call this to specify its new minimum size and trigger a basket relayout.
  private:
	Note    *m_note;
	QString  m_fileName;
	int      m_minWidth;
  public:
	static const int FEEDBACK_DARKING;
};

/** Real implementation of plain text notes:
 * @author S�astien Laot
 */
class TextContent : public NoteContent
{
  public:
	// Constructor and destructor:
	TextContent(Note *parent, const QString &fileName, bool lazyLoad = false);
	~TextContent();
	// Simple Generic Methods:
	NoteType::Id type();
	QString typeName();
	QString lowerTypeName();
	QString toText(const QString &/*cuttedFullPath*/);
	QString toHtml(const QString &imageName, const QString &cuttedFullPath);
	bool    useFile();
	bool    canBeSavedAs();
	QString saveAsFilters();
	bool    match(const FilterData &data);
	// Complexe Generic Methods:
	void    exportToHTML(HTMLExporter *exporter, int indent);
	QString cssClass();
	int     setWidthAndGetHeight(int width);
	void    paint(QPainter *painter, int width, int height, const QColorGroup &colorGroup, bool isDefaultColor, bool isSelected, bool isHovered);
	bool    loadFromFile(bool lazyLoad);
	bool    finishLazyLoad();
	bool    saveToFile();
	QString linkAt(const QPoint &pos);
	void    fontChanged();
	QString editToolTipText();
	// Drag and Drop Content:
	QPixmap feedbackPixmap(int width, int height);
	// Open Content or File:
	QString messageWhenOpenning(OpenMessage where);
//	QString customOpenCommand();
	// Content-Specific Methods:
	void    setText(const QString &text, bool lazyLoad = false); /// << Change the text note-content and relayout the note.
	QString text() { return m_text; }     /// << @return the text note-content.
  protected:
	QString          m_text;
	QSimpleRichText *m_simpleRichText;
};

/** Real implementation of rich text (HTML) notes:
 * @author S�astien Laot
 */
class HtmlContent : public NoteContent
{
  public:
	// Constructor and destructor:
	HtmlContent(Note *parent, const QString &fileName, bool lazyLoad = false);
	~HtmlContent();
	// Simple Generic Methods:
	NoteType::Id type();
	QString typeName();
	QString lowerTypeName();
	QString toText(const QString &/*cuttedFullPath*/);
	QString toHtml(const QString &imageName, const QString &cuttedFullPath);
	bool    useFile();
	bool    canBeSavedAs();
	QString saveAsFilters();
	bool    match(const FilterData &data);
	// Complexe Generic Methods:
	void    exportToHTML(HTMLExporter *exporter, int indent);
	QString cssClass();
	int     setWidthAndGetHeight(int width);
	void    paint(QPainter *painter, int width, int height, const QColorGroup &colorGroup, bool isDefaultColor, bool isSelected, bool isHovered);
	bool    loadFromFile(bool lazyLoad);
	bool    finishLazyLoad();
	bool    saveToFile();
	QString linkAt(const QPoint &pos);
	void    fontChanged();
	QString editToolTipText();
	// Drag and Drop Content:
	QPixmap feedbackPixmap(int width, int height);
	// Open Content or File:
	QString messageWhenOpenning(OpenMessage where);
	QString customOpenCommand();
	// Content-Specific Methods:
	void    setHtml(const QString &html, bool lazyLoad = false); /// << Change the HTML note-content and relayout the note.
	QString html() { return m_html; }     /// << @return the HTML note-content.
  protected:
	QString          m_html;
	QString          m_textEquivalent; //OPTIM_FILTER
	QSimpleRichText *m_simpleRichText;
};

/** Real implementation of image notes:
 * @author S�astien Laot
 */
class ImageContent : public NoteContent
{
  public:
	// Constructor and destructor:
	ImageContent(Note *parent, const QString &fileName, bool lazyLoad = false);
	// Simple Generic Methods:
	NoteType::Id type();
	QString typeName();
	QString lowerTypeName();
	QString toHtml(const QString &imageName, const QString &cuttedFullPath);
	QPixmap toPixmap();
	bool    useFile();
	bool    canBeSavedAs();
	QString saveAsFilters();
	bool    match(const FilterData &data);
	// Complexe Generic Methods:
	void    exportToHTML(HTMLExporter *exporter, int indent);
	QString cssClass();
	int     setWidthAndGetHeight(int width);
	void    paint(QPainter *painter, int width, int height, const QColorGroup &colorGroup, bool isDefaultColor, bool isSelected, bool isHovered);
	bool    loadFromFile(bool lazyLoad);
	bool    finishLazyLoad();
	bool    saveToFile();
	void    fontChanged();
	QString editToolTipText();
	void    toolTipInfos(QStringList *keys, QStringList *values);
	// Drag and Drop Content:
	QPixmap feedbackPixmap(int width, int height);
	bool    needSpaceForFeedbackPixmap() { return true; }
	// Open Content or File:
	QString messageWhenOpenning(OpenMessage where);
	QString customOpenCommand();
	// Content-Specific Methods:
	void    setPixmap(const QPixmap &pixmap); /// << Change the pixmap note-content and relayout the note.
	QPixmap pixmap() { return m_pixmap; }     /// << @return the pixmap note-content.
  protected:
	QPixmap  m_pixmap;
	char    *m_format;
};

/** Real implementation of animated image (GIF, MNG) notes:
 * @author S�astien Laot
 */
class AnimationContent : public QObject, public NoteContent // QObject to be able to receive QMovie signals
{
  Q_OBJECT
  public:
	// Constructor and destructor:
	AnimationContent(Note *parent, const QString &fileName, bool lazyLoad = false);
	// Simple Generic Methods:
	NoteType::Id type();
	QString typeName();
	QString lowerTypeName();
	QString toHtml(const QString &imageName, const QString &cuttedFullPath);
	QPixmap toPixmap();
	bool    useFile();
	bool    canBeSavedAs();
	QString saveAsFilters();
	bool    match(const FilterData &data);
	void    fontChanged();
	QString editToolTipText();
	// Drag and Drop Content:
	QPixmap feedbackPixmap(int width, int height);
	bool    needSpaceForFeedbackPixmap() { return true; }
	// Complexe Generic Methods:
	void    exportToHTML(HTMLExporter *exporter, int indent);
	QString cssClass();
	int     setWidthAndGetHeight(int width);
	void    paint(QPainter *painter, int width, int height, const QColorGroup &colorGroup, bool isDefaultColor, bool isSelected, bool isHovered);
	bool    loadFromFile(bool lazyLoad);
	bool    finishLazyLoad();
	bool    saveToFile();
	// Open Content or File:
	QString messageWhenOpenning(OpenMessage where);
	QString customOpenCommand();
	// Content-Specific Methods:
	bool    setMovie(const QMovie &movie); /// << Change the movie note-content and relayout the note.
	QMovie  movie() { return m_movie; }    /// << @return the movie note-content.
  protected slots:
	void movieUpdated(const QRect&);
	void movieResized(const QSize&);
	void movieStatus(int status);
  protected:
	QMovie  m_movie;
	int     m_oldStatus;
	static int INVALID_STATUS;
};

/** Real implementation of file notes:
 * @author S�astien Laot
 */
class FileContent : public QObject, public NoteContent
{
  Q_OBJECT
  public:
	// Constructor and destructor:
	FileContent(Note *parent, const QString &fileName);
	// Simple Generic Methods:
	NoteType::Id type();
	QString typeName();
	QString lowerTypeName();
	QString toHtml(const QString &imageName, const QString &cuttedFullPath);
	bool    useFile();
	bool    canBeSavedAs();
	QString saveAsFilters();
	bool    match(const FilterData &data);
	// Complexe Generic Methods:
	void    exportToHTML(HTMLExporter *exporter, int indent);
	QString cssClass();
	int     setWidthAndGetHeight(int width);
	void    paint(QPainter *painter, int width, int height, const QColorGroup &colorGroup, bool isDefaultColor, bool isSelected, bool isHovered);
	bool    loadFromFile(bool /*lazyLoad*/);
	void    fontChanged();
	void    linkLookChanged();
	QString editToolTipText();
	void    toolTipInfos(QStringList *keys, QStringList *values);
	// Drag and Drop Content:
	QPixmap feedbackPixmap(int width, int height);
	// Custom Zones:
	int     zoneAt(const QPoint &pos);
	QRect   zoneRect(int zone, const QPoint &/*pos*/);
	QString zoneTip(int zone);
	void    setCursor(QWidget *widget, int zone);
	// Content Edition:
	int      xEditorIndent();
	// Open Content or File:
	QString messageWhenOpenning(OpenMessage where);
	// Content-Specific Methods:
	void    setFileName(const QString &fileName); /// << Reimplemented to be able to relayout the note.
	virtual LinkLook* linkLook() { return LinkLook::fileLook; }
  protected:
	LinkDisplay m_linkDisplay;
	// File Preview Management:
  protected slots:
	void newPreview(const KFileItem*, const QPixmap &preview);
	void removePreview(const KFileItem*);
	void startFetchingUrlPreview();
  protected:
	KIO::PreviewJob *m_previewJob;
};

/** Real implementation of sound notes:
 * @author S�astien Laot
 */
class SoundContent : public FileContent // A sound is a file with just a bit different user interaction
{
  Q_OBJECT
  public:
	// Constructor and destructor:
	SoundContent(Note *parent, const QString &fileName);
	// Simple Generic Methods:
	NoteType::Id type();
	QString typeName();
	QString lowerTypeName();
	QString toHtml(const QString &imageName, const QString &cuttedFullPath);
	bool    useFile();
	bool    canBeSavedAs();
	QString saveAsFilters();
	bool    match(const FilterData &data);
	QString editToolTipText();
	// Complexe Generic Methods:
	QString cssClass();
	// Custom Zones:
	QString zoneTip(int zone);
	void    setHoveredZone(int oldZone, int newZone);
	// Open Content or File:
	QString messageWhenOpenning(OpenMessage where);
	QString customOpenCommand();
	// Content-Specific Methods:
	LinkLook* linkLook() { return LinkLook::soundLook; }
};

/** Real implementation of link notes:
 * @author S�astien Laot
 */
class LinkContent : public QObject, public NoteContent
{
  Q_OBJECT
  public:
	// Constructor and destructor:
	LinkContent(Note *parent, const KURL &url, const QString &title, const QString &icon, bool autoTitle, bool autoIcon);
	// Simple Generic Methods:
	NoteType::Id type();
	QString typeName();
	QString lowerTypeName();
	QString toText(const QString &/*cuttedFullPath*/);
	QString toHtml(const QString &imageName, const QString &cuttedFullPath);
	void    toLink(KURL *url, QString *title, const QString &cuttedFullPath);
	bool    useFile();
	bool    canBeSavedAs();
	QString saveAsFilters();
	bool    match(const FilterData &data);
	// Complexe Generic Methods:
	void    exportToHTML(HTMLExporter *exporter, int indent);
	QString cssClass();
	int     setWidthAndGetHeight(int width);
	void    paint(QPainter *painter, int width, int height, const QColorGroup &colorGroup, bool isDefaultColor, bool isSelected, bool isHovered);
	void    saveToNode(QDomDocument &doc, QDomElement &content);
	void    fontChanged();
	void    linkLookChanged();
	QString editToolTipText();
	void    toolTipInfos(QStringList *keys, QStringList *values);
	// Drag and Drop Content:
	void    serialize(QDataStream &stream);
	QPixmap feedbackPixmap(int width, int height);
	// Custom Zones:
	int     zoneAt(const QPoint &pos);
	QRect   zoneRect(int zone, const QPoint &/*pos*/);
	QString zoneTip(int zone);
	void    setCursor(QWidget *widget, int zone);
	QString statusBarMessage(int zone);
	// Open Content or File:
	KURL urlToOpen(bool /*with*/);
	QString messageWhenOpenning(OpenMessage where);
	// Content-Specific Methods:
	void    setLink(const KURL &url, const QString &title, const QString &icon, bool autoTitle, bool autoIcon); /// << Change the link and relayout the note.
	KURL    url()       { return m_url;       } /// << @return the URL of the link note-content.
	QString title()     { return m_title;     } /// << @return the displayed title of the link note-content.
	QString icon()      { return m_icon;      } /// << @return the displayed icon of the link note-content.
	bool    autoTitle() { return m_autoTitle; } /// << @return if the title is auto-computed from the URL.
	bool    autoIcon()  { return m_autoIcon;  } /// << @return if the icon is auto-computed from the URL.
  protected:
	KURL        m_url;
	QString     m_title;
	QString     m_icon;
	bool        m_autoTitle;
	bool        m_autoIcon;
	LinkDisplay m_linkDisplay;
	// File Preview Management:
  protected slots:
	void newPreview(const KFileItem*, const QPixmap &preview);
	void removePreview(const KFileItem*);
	void startFetchingUrlPreview();
  protected:
	KIO::PreviewJob *m_previewJob;
};

/** Real implementation of launcher notes:
 * @author S�astien Laot
 */
class LauncherContent : public NoteContent
{
  public:
	// Constructor and destructor:
	LauncherContent(Note *parent, const QString &fileName);
	// Simple Generic Methods:
	NoteType::Id type();
	QString typeName();
	QString lowerTypeName();
	QString toHtml(const QString &imageName, const QString &cuttedFullPath);
	void    toLink(KURL *url, QString *title, const QString &cuttedFullPath);
	bool    useFile();
	bool    canBeSavedAs();
	QString saveAsFilters();
	bool    match(const FilterData &data);
	// Complexe Generic Methods:
	void    exportToHTML(HTMLExporter *exporter, int indent);
	QString cssClass();
	int     setWidthAndGetHeight(int width);
	void    paint(QPainter *painter, int width, int height, const QColorGroup &colorGroup, bool isDefaultColor, bool isSelected, bool isHovered);
	bool    loadFromFile(bool /*lazyLoad*/);
	void    fontChanged();
	QString editToolTipText();
	void    toolTipInfos(QStringList *keys, QStringList *values);
	// Drag and Drop Content:
	QPixmap feedbackPixmap(int width, int height);
	// Custom Zones:
	int     zoneAt(const QPoint &pos);
	QRect   zoneRect(int zone, const QPoint &/*pos*/);
	QString zoneTip(int zone);
	void    setCursor(QWidget *widget, int zone);
	// Open Content or File:
	KURL urlToOpen(bool with);
	QString messageWhenOpenning(OpenMessage where);
	// Content-Specific Methods:
	void    setLauncher(const QString &name, const QString &icon, const QString &exec); /// << Change the launcher note-content and relayout the note. Normally called by loadFromFile (no save done).
	QString name() { return m_name; }                              /// << @return the URL of the launcher note-content.
	QString icon() { return m_icon; }                              /// << @return the displayed icon of the launcher note-content.
	QString exec() { return m_exec; }                              /// << @return the execute command line of the launcher note-content.
	// TODO: KService *service() ??? And store everything in thta service ?
  protected:
	QString     m_name; // TODO: Store them in linkDisplay to gain place (idem for Link notes)
	QString     m_icon;
	QString     m_exec;
	LinkDisplay m_linkDisplay;
};

/** Real implementation of color notes:
 * @author S�astien Laot
 */
class ColorContent : public NoteContent
{
  public:
	// Constructor and destructor:
	ColorContent(Note *parent, const QColor &color);
	// Simple Generic Methods:
	NoteType::Id type();
	QString typeName();
	QString lowerTypeName();
	QString toText(const QString &/*cuttedFullPath*/);
	QString toHtml(const QString &imageName, const QString &cuttedFullPath);
	bool    useFile();
	bool    canBeSavedAs();
	QString saveAsFilters();
	bool    match(const FilterData &data);
	// Complexe Generic Methods:
	void    exportToHTML(HTMLExporter *exporter, int indent);
	QString cssClass();
	int     setWidthAndGetHeight(int width);
	void    paint(QPainter *painter, int width, int height, const QColorGroup &colorGroup, bool isDefaultColor, bool isSelected, bool isHovered);
	void    saveToNode(QDomDocument &doc, QDomElement &content);
	void    fontChanged();
	QString editToolTipText();
	void    toolTipInfos(QStringList *keys, QStringList *values);
	// Drag and Drop Content:
	void    serialize(QDataStream &stream);
	QPixmap feedbackPixmap(int width, int height);
	bool    needSpaceForFeedbackPixmap() { return true; }
	void    addAlternateDragObjects(KMultipleDrag *dragObject);
	// Content-Specific Methods:
	void    setColor(const QColor &color); /// << Change the color note-content and relayout the note.
	QColor  color() { return m_color; }    /// << @return the color note-content.
  protected:
	QColor  m_color;
	static const int RECT_MARGIN;
};

/** Real implementation of unknown MIME-types dropped notes:
 * @author S�astien Laot
 */
class UnknownContent : public NoteContent
{
  public:
	// Constructor and destructor:
	UnknownContent(Note *parent, const QString &fileName);
	// Simple Generic Methods:
	NoteType::Id type();
	QString typeName();
	QString lowerTypeName();
	QString toText(const QString &/*cuttedFullPath*/);
	QString toHtml(const QString &imageName, const QString &cuttedFullPath);
	void    toLink(KURL *url, QString *title, const QString &cuttedFullPath);
	bool    useFile();
	bool    canBeSavedAs();
	QString saveAsFilters();
	bool    match(const FilterData &data);
	// Complexe Generic Methods:
	void    exportToHTML(HTMLExporter *exporter, int indent);
	QString cssClass();
	int     setWidthAndGetHeight(int width);
	void    paint(QPainter *painter, int width, int height, const QColorGroup &colorGroup, bool isDefaultColor, bool isSelected, bool isHovered);
	bool    loadFromFile(bool /*lazyLoad*/);
	void    fontChanged();
	QString editToolTipText();
	// Drag and Drop Content:
	bool    shouldSerializeFile() { return false; }
	void    addAlternateDragObjects(KMultipleDrag *dragObject);
	QPixmap feedbackPixmap(int width, int height);
	bool    needSpaceForFeedbackPixmap() { return true; }
	// Open Content or File:
	KURL urlToOpen(bool /*with*/) { return KURL(); }
	// Content-Specific Methods:
	QString mimeTypes() { return m_mimeTypes; } /// << @return the list of MIME types this note-content contains.
  protected:
	QString m_mimeTypes;
	static const int DECORATION_MARGIN;
};

void NoteFactory__loadNode(const QDomElement &content, const QString &lowerTypeName, Note *parent, bool lazyLoad);

#endif // NOTECONTENT_H