Add author-abandoned basket application

git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/basket@1072339 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 208 insertions, 0 deletions

diff --git a/src/linklabel.h b/src/linklabel.h
new file mode 100644
index 0000000..3e964c1
--- /dev/null
+++ b/src/linklabel.h
@@ -0,0 +1,208 @@
+/***************************************************************************
+ *   Copyright (C) 2003 by S�astien Laot                                 *
+ *   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.,                                       *
+ *   51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.             *
+ ***************************************************************************/
+
+#ifndef LINKLABEL_H
+#define LINKLABEL_H
+
+#include <qframe.h>
+
+class QString;
+class KURL;
+class QColor;
+class QLabel;
+class QBoxLayout;
+class QSpacerItem;
+class QPushButton;
+class QCheckBox;
+class QComboBox;
+
+class KColorCombo2;
+class IconSizeCombo;
+
+class HTMLExporter;
+class HelpLabel;
+class KCModule;
+
+/** Store the style of links
+  * @author S�astien Laot
+  */
+class LinkLook
+{
+  public:
+	enum Underlining { Always = 0, Never, OnMouseHover, OnMouseOutside };
+	enum Preview { None = 0, IconSize, TwiceIconSize, ThreeIconSize };
+	LinkLook(bool useLinkColor = true, bool canPreview = true);
+	LinkLook(const LinkLook &other);
+	void setLook( bool italic, bool bold, int underlining,
+	              QColor color, QColor hoverColor,
+	              int iconSize, int preview /*= None*/ );
+	inline bool   italic()       const { return m_italic;       }
+	inline bool   bold()         const { return m_bold;         }
+	inline int    underlining()  const { return m_underlining;  }
+	inline QColor color()        const { return m_color;        }
+	inline QColor hoverColor()   const { return m_hoverColor;   }
+	inline int    iconSize()     const { return m_iconSize;     }
+	inline int    preview()      const { return m_preview;      }
+	inline bool   useLinkColor() const { return m_useLinkColor; }
+	inline bool   canPreview()   const { return m_canPreview;   }
+	/* Helpping Functions */
+	bool underlineOutside() const { return underlining() == Always || underlining() == OnMouseOutside; }
+	bool underlineInside()  const { return underlining() == Always || underlining() == OnMouseHover;   }
+	bool previewEnabled()   const { return canPreview() && preview() > None;                           }
+	int  previewSize() const;
+	QColor effectiveColor() const;
+	QColor effectiveHoverColor() const;
+	QColor defaultColor() const;
+	QColor defaultHoverColor() const;
+	QString toCSS(const QString &cssClass, const QColor &defaultTextColor) const;
+  private:
+	bool   m_italic;
+	bool   m_bold;
+	int    m_underlining;
+	QColor m_color;
+	QColor m_hoverColor;
+	int    m_iconSize;
+	int    m_preview;
+	bool   m_useLinkColor;
+	bool   m_canPreview;
+  public:
+	/* Global Looks */
+	static LinkLook *soundLook;
+	static LinkLook *fileLook;
+	static LinkLook *localLinkLook;
+	static LinkLook *networkLinkLook;
+	static LinkLook *launcherLook;
+	/* Static method to get a LinkLook from an URL */
+	static LinkLook* lookForURL(const KURL &url);
+};
+
+/** Used to represent links with icon and specific look
+  * Note : This label will appear blank while LinkLook willn't be set
+  * @author S�astien Laot
+  */
+class LinkLabel : public QFrame
+{
+  Q_OBJECT
+  public:
+	LinkLabel(int hAlign, int vAlign, QWidget *parent = 0, const char *name = 0, WFlags f = 0);
+	LinkLabel(const QString &title, const QString &icon, LinkLook *look, int hAlign, int vAlign,
+	          QWidget *parent = 0, const char *name = 0, WFlags f = 0);
+	~LinkLabel();
+  public:
+	void setLink(const QString &title, const QString &icon, LinkLook *look = 0);
+	void setLook(LinkLook *look);
+	void setAlign(int hAlign, int vAlign);
+	void setSelected(bool selected);
+	void setPaletteBackgroundColor(const QColor &color);
+	int  heightForWidth(int w = -1) const;
+	QString toHtml(const QString &imageName);
+  protected:
+	void initLabel(int hAlign, int vAlign);
+	void enterEvent(QEvent*);
+	void leaveEvent(QEvent*);
+  private:
+	QBoxLayout  *m_layout;
+	QLabel      *m_icon;
+	QLabel      *m_title;
+	QSpacerItem *m_spacer1;
+	QSpacerItem *m_spacer2;
+
+	bool         m_isSelected;
+	bool         m_isHovered;
+
+	LinkLook    *m_look;
+	int          m_hAlign;
+	int          m_vAlign;
+};
+
+/** THE NEW CLASS TO DISPLAY Links FOR THE NEW BASKET ENGINE.
+ * We should get ride of class LinkLabel soon.
+ * And LinkLabel will be entirely rewritten to use this LinkDisplay as the drawing primitives.
+ * @author S�astien Laot
+ */
+class LinkDisplay
+{
+  public:
+	LinkDisplay();                                                               /// << Create a new empty unselected LinkDisplay. Please then call setLink() to make sense.
+	// Configure the link displayer:
+	void    setLink(const QString &title, const QString &icon, LinkLook *look, const QFont &font);  /// << Change the content and disposition. minWidth(), width() & height() can have changed. Keep the old preview (if any)
+	void    setLink(const QString &title, const QString &icon, const QPixmap &preview, LinkLook *look, const QFont &font);  /// << Idem but change the preview too (or remove it if it is invalid)
+	void    setWidth(int width);                                                 /// << Set a new width. @see height() that will be computed.
+	// Get its properties:
+	int     minWidth() const { return m_minWidth; }                              /// << @return the minimum width to display this link.
+	int     maxWidth() const { return m_maxWidth; }                              /// << @return the maximum width to display this link.
+	int     width()    const { return m_width;    }                              /// << @return the width of the link. It is never less than minWidth()!
+	int     height()   const { return m_height;   }                              /// << @return the height if the link after having set it a width.
+	// And finaly, use it:
+	void    paint(QPainter *painter, int x, int y, int width, int height, const QColorGroup &colorGroup, bool isDefaultColor, bool isSelected, bool isHovered, bool isIconButtonHovered) const; /// << Draw the link on a painter. Set textColor to be !isValid() to use the LinkLook color. Otherwise it will use this color!
+	QPixmap feedbackPixmap(int width, int height, const QColorGroup &colorGroup, bool isDefaultColor); /// << @return the pixmap to put under the cursor while dragging this object.
+	// Eventually get some information about the link display:
+	bool    iconButtonAt(const QPoint &pos) const;                               /// << @return true if the icon button is under point @p pos.
+	QRect   iconButtonRect() const;                                              /// << @return the rectangle of the icon button.
+	// Utility function:
+	QFont   labelFont(QFont font, bool isIconButtonHovered) const;               /// << @return the font for this link, according to parent font AND LinkLook!
+	int     heightForWidth(int width) const;                                     /// << @return the needed height to display the link in function of a width.
+	QString toHtml(const QString &imageName) const;                              /// << Convert the link to HTML code, using the LinkLook to style it.
+	QString toHtml(HTMLExporter *exporter, const KURL &url, const QString &title = "");
+  private:
+	QString   m_title;
+	QString   m_icon;
+	QPixmap   m_preview;
+	LinkLook *m_look;
+	QFont     m_font;
+	int       m_minWidth;
+	int       m_maxWidth;
+	int       m_width;
+	int       m_height;
+};
+
+/** A widget to edit a LinkLook, showing a live example to the user.
+  * @author S�astien Laot
+  */
+class LinkLookEditWidget : public QWidget
+{
+  Q_OBJECT
+  public:
+	LinkLookEditWidget(KCModule* module, const QString exTitle, const QString exIcon,
+					   QWidget *parent = 0, const char *name = 0, WFlags fl = 0);
+	~LinkLookEditWidget();
+	void saveChanges();
+	void saveToLook(LinkLook *look);
+	void set(LinkLook *look);
+  private slots:
+	void slotChangeLook();
+  protected:
+	LinkLook      *m_look;
+	QCheckBox     *m_italic;
+	QCheckBox     *m_bold;
+	QComboBox     *m_underlining;
+	KColorCombo2  *m_color;
+	KColorCombo2  *m_hoverColor;
+	IconSizeCombo *m_iconSize;
+	QComboBox     *m_preview;
+	LinkLook      *m_exLook;
+	LinkLabel     *m_example;
+	QString        m_exTitle;
+	QString        m_exIcon;
+	HelpLabel     *m_hLabel;
+	QLabel        *m_label;
+};
+
+#endif // LINKLABEL_H