knewsticker/itemviews.h

   1 /*
   2  * itemviews.h
   3  *
   4  * Copyright (c) 2007 Frerich Raabe <raabe@kde.org>
   5  *
   6  * This program is distributed in the hope that it will be useful, but WITHOUT
   7  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
   8  * FOR A PARTICULAR PURPOSE. For licensing and distribution details, check the
   9  * accompanying file 'COPYING'.
  10  */
  11 #ifndef ITEMVIEWS_H
  12 #define ITEMVIEWS_H
  13
  14 #include <QGraphicsItemAnimation>
  15 #include <QGraphicsRectItem>
  16 #include <QList>
  17 #include <QUrl>
  18 #include <QObject>
  19
  20 struct NewsItem
  21 {
  22     QString text;
  23     QString url;
  24     QString description;
  25 };
  26
  27 class KNewsTicker;
  28
  29 class NewsItemView : public QObject, public QGraphicsRectItem
  30 {
  31     Q_OBJECT
  32 public:
  33     NewsItemView( KNewsTicker *parent );
  34
  35     const QList<NewsItem> &items() const;
  36     virtual void setItems( const QList<NewsItem> &items );
  37     virtual void reloadSettings();
  38
  39 Q_SIGNALS:
  40     void itemActivated( const QString &url );
  41
  42 protected:
  43     KNewsTicker *newsTicker() { return m_newsTicker; }
  44
  45 private:
  46     QList<NewsItem> m_items;
  47     KNewsTicker *m_newsTicker;
  48 };
  49
  50 class HyperlinkItem : public QObject, public QGraphicsSimpleTextItem
  51 {
  52     Q_OBJECT
  53 public:
  54     static const int Type = UserType + 10;
  55
  56     HyperlinkItem( const QString &text, const QUrl &url,
  57                   QGraphicsItem *parentItem );
  58
  59     virtual int type() const { return Type; }
  60
  61     const QUrl &url() const { return m_url; }
  62     void setUrl( const QUrl &url ) { m_url = url; }
  63
  64 Q_SIGNALS:
  65     void activated( const QString &url );
  66
  67 protected:
  68     virtual void hoverEnterEvent( QGraphicsSceneHoverEvent *e );
  69     virtual void hoverLeaveEvent( QGraphicsSceneHoverEvent *e );
  70
  71     // empty reimplementation so that we get release events
  72     virtual void mousePressEvent( QGraphicsSceneMouseEvent * ) { }
  73
  74     virtual void mouseReleaseEvent( QGraphicsSceneMouseEvent *e );
  75
  76 private:
  77     QUrl m_url;
  78 };
  79
  80 class SeparatorItem : public QGraphicsSimpleTextItem
  81 {
  82 public:
  83     static const int Type = UserType + 11;
  84
  85     SeparatorItem( QGraphicsItem *parentItem );
  86
  87     virtual int type() const { return Type; }
  88 };
  89
  90 class NewsTickerItem : public QGraphicsItemGroup
  91 {
  92 public:
  93     static const int Type = UserType + 12;
  94
  95     NewsTickerItem( const QString &text, const QUrl &url,
  96                     const QString &description,
  97                     QGraphicsItem *parentItem );
  98
  99     virtual int type() const { return Type; }
 100
 101     const HyperlinkItem *headlineItem() const { return m_headlineItem; }
 102     HyperlinkItem *headlineItem() { return m_headlineItem; }
 103
 104     const SeparatorItem *separatorItem() const { return m_separatorItem; }
 105     SeparatorItem *separatorItem() { return m_separatorItem; }
 106
 107 private:
 108     HyperlinkItem *m_headlineItem;
 109     SeparatorItem *m_separatorItem;
 110 };
 111
 112 class ScrollingItemView : public NewsItemView
 113 {
 114     Q_OBJECT
 115     using NewsItemView::advance;
 116 public:
 117     ScrollingItemView( KNewsTicker *parent );
 118
 119     virtual void setItems( const QList<NewsItem> &items );
 120     virtual void reloadSettings();
 121
 122 private Q_SLOTS:
 123     void advance();
 124
 125 private:
 126     void relayoutItems();
 127     void addItemToLayout( const NewsItem &item, qreal *xpos, qreal *ypos );
 128     void configureScrollTimer();
 129
 130     QTimer *m_scrollTimer;
 131     QList<NewsTickerItem *> m_graphicsItems;
 132     qreal m_steppingWidth;
 133 };
 134
 135 class PagingItemView : public NewsItemView
 136 {
 137     Q_OBJECT
 138 public:
 139     PagingItemView( KNewsTicker *parent = 0 );
 140     virtual ~PagingItemView();
 141
 142     virtual void setItems( const QList<NewsItem> &items );
 143     virtual void reloadSettings();
 144
 145 private Q_SLOTS:
 146     void moveItemIn();
 147     void itemMovedIn();
 148     void moveItemOut();
 149     void itemMovedOut();
 150
 151 private:
 152     void updateMoveAnimations();
 153     void updateLinkItem();
 154
 155     QList<NewsItem>::ConstIterator m_currentItem;
 156     HyperlinkItem *m_linkItem;
 157     QGraphicsItemAnimation *m_moveInAnimation;
 158     QGraphicsItemAnimation *m_moveOutAnimation;
 159     bool m_needToReloadSettings;
 160 };
 161
 162 #endif // !defined(ITEMVIEWS_H)
 163