diff options
Diffstat (limited to 'src/linklabel.h')
| -rw-r--r-- | src/linklabel.h | 208 |
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 |