/***************************************************************************
 *   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 LINKLABEL_H
#define LINKLABEL_H

#include <QFrame>
#include <QBoxLayout>
#include <QPixmap>
#include <QLabel>
#include <QEvent>

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ébastien Laoût
  */
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 LinkLook *crossReferenceLook;
    /* 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ébastien Laoût
  */
class LinkLabel : public QFrame
{
    Q_OBJECT
public:
    LinkLabel(int hAlign, int vAlign, QWidget *parent = 0, Qt::WFlags f = 0);
    LinkLabel(const QString &title, const QString &icon, LinkLook *look, int hAlign, int vAlign,
              QWidget *parent = 0, Qt::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;
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ébastien Laoût
 */
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 QPalette &palette, 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 QPalette &palette, 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ébastien Laoût
  */
class LinkLookEditWidget : public QWidget
{
    Q_OBJECT
public:
    LinkLookEditWidget(KCModule* module, const QString exTitle, const QString exIcon,
                       QWidget *parent = 0, Qt::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
