Move Clickable out of ContentsChatItem
[quassel.git] / src / qtui / chatitem.h
index 340050a..e94bda1 100644 (file)
@@ -1,5 +1,5 @@
 /***************************************************************************
- *   Copyright (C) 2005-08 by the Quassel Project                          *
+ *   Copyright (C) 2005-09 by the Quassel Project                          *
  *   devel@quassel-irc.org                                                 *
  *                                                                         *
  *   This program is free software; you can redistribute it and/or modify  *
 #ifndef CHATITEM_H_
 #define CHATITEM_H_
 
+#include <QAction>
 #include <QGraphicsItem>
 #include <QObject>
 
 #include "chatlinemodel.h"
 #include "chatscene.h"
+#include "clickable.h"
 #include "uistyle.h"
 #include "qtui.h"
 
-class QTextLayout;
+#include <QTextLayout>
 
 class ChatItem : public QGraphicsItem {
-
 protected:
-  ChatItem(ChatLineModel::ColumnType column, QAbstractItemModel *, QGraphicsItem *parent);
-  virtual ~ChatItem();
+  ChatItem(const qreal &width, const qreal &height, const QPointF &pos, QGraphicsItem *parent);
 
 public:
-  inline const QAbstractItemModel *model() const { return chatScene() ? chatScene()->model() : 0; }
+  inline const QAbstractItemModel *model() const;
   inline int row() const;
   virtual ChatLineModel::ColumnType column() const = 0;
   inline ChatScene *chatScene() const { return qobject_cast<ChatScene *>(scene()); }
 
-  inline QFontMetricsF *fontMetrics() const { return _fontMetrics; }
   inline QRectF boundingRect() const { return _boundingRect; }
   inline qreal width() const { return _boundingRect.width(); }
   inline qreal height() const { return _boundingRect.height(); }
 
-  virtual inline bool haveLayout() const { return layout() != 0; }
-  virtual void clearLayout();
-  virtual QTextLayout *createLayout(QTextOption::WrapMode, Qt::Alignment = Qt::AlignLeft);
-  virtual void updateLayout();
-  virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = 0);
+  void initLayoutHelper(QTextLayout *layout, QTextOption::WrapMode, Qt::Alignment = Qt::AlignLeft) const;
+  virtual inline void initLayout(QTextLayout *layout) const {
+    initLayoutHelper(layout, QTextOption::NoWrap);
+    doLayout(layout);
+  }
+  virtual void doLayout(QTextLayout *) const;
+  virtual UiStyle::FormatList formatList() const;
 
-  virtual QVariant data(int role) const;
+  virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = 0);
+  enum { Type = ChatScene::ChatItemType };
+  virtual inline int type() const { return Type; }
 
-  // returns height
-  qreal setGeometry(qreal width, qreal height = -1);
+  QVariant data(int role) const;
 
   // selection stuff, to be called by the scene
+  QString selection() const;
   void clearSelection();
   void setFullSelection();
   void continueSelecting(const QPointF &pos);
+  bool hasSelection() const;
+  bool isPosOverSelection(const QPointF &pos) const;
 
   QList<QRectF> findWords(const QString &searchWord, Qt::CaseSensitivity caseSensitive);
 
+  virtual void addActionsToMenu(QMenu *menu, const QPointF &itemPos);
+  virtual void handleClick(const QPointF &pos, ChatScene::ClickMode);
+
 protected:
+  enum SelectionMode {
+    NoSelection,
+    PartialSelection,
+    FullSelection
+  };
+
   virtual void mouseMoveEvent(QGraphicsSceneMouseEvent *event);
   virtual void mousePressEvent(QGraphicsSceneMouseEvent *event);
   virtual void mouseReleaseEvent(QGraphicsSceneMouseEvent *event);
 
-  virtual inline QTextLayout *layout() const { return _layout; }
-  virtual inline void setLayout(QTextLayout *l) { _layout = l; }
-  virtual inline QVector<QTextLayout::FormatRange> additionalFormats() const { return QVector<QTextLayout::FormatRange>(); }
-  qint16 posToCursor(const QPointF &pos);
-
-  virtual qreal computeHeight();
-
-  QRectF _boundingRect;
+  void paintBackground(QPainter *);
+  QVector<QTextLayout::FormatRange> selectionFormats() const;
+  virtual QVector<QTextLayout::FormatRange> additionalFormats() const;
+  void overlayFormat(UiStyle::FormatList &fmtList, int start, int end, quint32 overlayFmt) const;
+
+  inline qint16 selectionStart() const { return _selectionStart; }
+  inline void setSelectionStart(qint16 start) { _selectionStart = start; }
+  inline qint16 selectionEnd() const { return _selectionEnd; }
+  inline void setSelectionEnd(qint16 end) { _selectionEnd = end; }
+  inline SelectionMode selectionMode() const { return _selectionMode; }
+  inline void setSelectionMode(SelectionMode mode) { _selectionMode = mode; }
+  void setSelection(SelectionMode mode, qint16 selectionStart, qint16 selectionEnd);
+
+  qint16 posToCursor(const QPointF &pos) const;
+
+  // WARNING: setGeometry and setHeight should not be used without either:
+  //  a) calling prepareGeometryChange() immediately before setColumns()
+  //  b) calling Chatline::setPos() immediately afterwards
+  inline void setGeometry(qreal width, qreal height) {
+    _boundingRect.setWidth(width);
+    _boundingRect.setHeight(height);
+  }
+  inline void setHeight(const qreal &height) {
+    _boundingRect.setHeight(height);
+  }
+  inline void setWidth(const qreal &width) {
+    _boundingRect.setWidth(width);
+  }
 
 private:
   // internal selection stuff
   void setSelection(int start, int length);
 
-  QFontMetricsF *_fontMetrics;
+  QRectF _boundingRect;
 
-  enum SelectionMode { NoSelection, PartialSelection, FullSelection };
   SelectionMode _selectionMode;
   qint16 _selectionStart, _selectionEnd;
 
-  QTextLayout *_layout;
+  friend class ChatLine;
 };
 
-/*************************************************************************************************/
+// ************************************************************
+// TimestampChatItem
+// ************************************************************
 
 //! A ChatItem for the timestamp column
 class TimestampChatItem : public ChatItem {
-
 public:
-  TimestampChatItem(QAbstractItemModel *model, QGraphicsItem *parent) : ChatItem(column(), model, parent) {}
-  inline ChatLineModel::ColumnType column() const { return ChatLineModel::TimestampColumn; }
-
+  TimestampChatItem(const qreal &width, const qreal &height, QGraphicsItem *parent) : ChatItem(width, height, QPointF(0, 0), parent) {}
+  enum { Type = ChatScene::TimestampChatItemType };
+  virtual inline int type() const { return Type; }
+  virtual inline ChatLineModel::ColumnType column() const { return ChatLineModel::TimestampColumn; }
 };
 
-/*************************************************************************************************/
-
+// ************************************************************
+// SenderChatItem
+// ************************************************************
 //! A ChatItem for the sender column
 class SenderChatItem : public ChatItem {
-
 public:
-  SenderChatItem(QAbstractItemModel *model, QGraphicsItem *parent) : ChatItem(column(), model, parent) {}
-  inline ChatLineModel::ColumnType column() const { return ChatLineModel::SenderColumn; }
+  SenderChatItem(const qreal &width, const qreal &height, const QPointF &pos, QGraphicsItem *parent) : ChatItem(width, height, pos, parent) {}
+  virtual inline ChatLineModel::ColumnType column() const { return ChatLineModel::SenderColumn; }
 
-  virtual void updateLayout();
+protected:
+  virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = 0);
+  enum { Type = ChatScene::SenderChatItemType };
+  virtual inline int type() const { return Type; }
+  virtual inline void initLayout(QTextLayout *layout) const {
+    initLayoutHelper(layout, QTextOption::ManualWrap, Qt::AlignRight);
+    doLayout(layout);
+  }
 };
 
-/*************************************************************************************************/
+// ************************************************************
+// ContentsChatItem
+// ************************************************************
+struct ContentsChatItemPrivate;
 
 //! A ChatItem for the contents column
 class ContentsChatItem : public ChatItem {
+  Q_DECLARE_TR_FUNCTIONS(ContentsChatItem);
 
 public:
-  ContentsChatItem(QAbstractItemModel *model, QGraphicsItem *parent);
-  virtual ~ContentsChatItem();
+  ContentsChatItem(const qreal &width, const QPointF &pos, QGraphicsItem *parent);
+  ~ContentsChatItem();
 
-  inline ChatLineModel::ColumnType column() const { return ChatLineModel::ContentsColumn; }
+  enum { Type = ChatScene::ContentsChatItemType };
+  virtual inline int type() const { return Type; }
 
-  virtual void clearLayout();
-  virtual void updateLayout();
-  virtual inline bool haveLayout() const { return _layoutData != 0 && layout() != 0; }
+  inline ChatLineModel::ColumnType column() const { return ChatLineModel::ContentsColumn; }
+  QFontMetricsF *fontMetrics() const;
 
 protected:
-  virtual void mouseDoubleClickEvent(QGraphicsSceneMouseEvent *event);
   virtual void mouseMoveEvent(QGraphicsSceneMouseEvent *event);
-  virtual void hoverEnterEvent(QGraphicsSceneHoverEvent *event);
   virtual void hoverLeaveEvent(QGraphicsSceneHoverEvent *event);
   virtual void hoverMoveEvent(QGraphicsSceneHoverEvent *event);
+  virtual void handleClick(const QPointF &pos, ChatScene::ClickMode clickMode);
+
+  virtual void addActionsToMenu(QMenu *menu, const QPointF &itemPos);
+  virtual void copyLinkToClipboard();
 
-  virtual inline QTextLayout *layout() const;
-  virtual void setLayout(QTextLayout *l);
   virtual QVector<QTextLayout::FormatRange> additionalFormats() const;
 
+  virtual inline void initLayout(QTextLayout *layout) const {
+    initLayoutHelper(layout, QTextOption::WrapAnywhere);
+    doLayout(layout);
+  }
+  virtual void doLayout(QTextLayout *layout) const;
+  virtual UiStyle::FormatList formatList() const;
+
 private:
-  struct LayoutData;
-  struct Clickable;
+  class ActionProxy;
   class WrapColumnFinder;
 
-  inline LayoutData *layoutData() const;
+  ContentsChatItemPrivate *_data;
+  ContentsChatItemPrivate *privateData() const;
 
-  qreal computeHeight();
-  QList<Clickable> findClickables();
+  Clickable clickableAt(const QPointF &pos) const;
 
-  LayoutData *_layoutData;
-};
+  void endHoverMode();
+  void showWebPreview(const Clickable &click);
+  void clearWebPreview();
 
-struct ContentsChatItem::Clickable {
-  // Don't change these enums without also changing the regexps in analyze()!
-  enum Type {
-    Invalid = -1,
-    Url = 0,
-    Channel = 1,
-    Nick = 2
-  };
+  qreal setGeometryByWidth(qreal w);
+  friend class ChatLine;
+  friend struct ContentsChatItemPrivate;
 
-  Type type;
-  quint16 start;
-  quint16 length;
+  QFontMetricsF *_fontMetrics;
 
-  inline Clickable() : type(Invalid) {};
-  inline Clickable(Type type_, quint16 start_, quint16 length_) : type(type_), start(start_), length(length_) {};
-  inline bool isValid() const { return type != Invalid; }
+  // we need a receiver for Action signals
+  static ActionProxy _actionProxy;
 };
 
-struct ContentsChatItem::LayoutData {
-  QTextLayout *layout;
-  QList<Clickable> clickables;
+struct ContentsChatItemPrivate {
+  ContentsChatItem *contentsItem;
+  ClickableList clickables;
   Clickable currentClickable;
+  Clickable activeClickable;
 
-  LayoutData() { layout = 0; }
-  ~LayoutData() { delete layout; }
+  ContentsChatItemPrivate(const ClickableList &c, ContentsChatItem *parent) : contentsItem(parent), clickables(c) {}
 };
 
 class ContentsChatItem::WrapColumnFinder {
 public:
-  WrapColumnFinder(ChatItem *parent);
+  WrapColumnFinder(const ChatItem *parent);
   ~WrapColumnFinder();
 
-  qint16 nextWrapColumn();
+  qint16 nextWrapColumn(qreal width);
 
 private:
-  ChatItem *item;
-  QTextLayout *layout;
+  const ChatItem *item;
+  QTextLayout layout;
   QTextLine line;
   ChatLineModel::WrapList wrapList;
   qint16 wordidx;
-  qint16 lastwrapcol;
-  qreal lastwrappos;
-  qreal w;
+  qint16 lineCount;
+  qreal choppedTrailing;
+};
+
+//! Acts as a proxy for Action signals targetted at a ContentsChatItem
+/** Since a ChatItem is not a QObject, hence cannot receive signals, we use a static ActionProxy
+ *  as a receiver instead. This avoids having to handle ChatItem actions (e.g. context menu entries)
+ *  outside the ChatItem.
+ */
+class ContentsChatItem::ActionProxy : public QObject {
+  Q_OBJECT
+
+public slots:
+  inline void copyLinkToClipboard() { item()->copyLinkToClipboard(); }
+
+private:
+  /// Returns the ContentsChatItem that should receive the action event.
+  /** For efficiency reasons, values are not checked for validity. You gotta make sure that you set the data() member
+   *  in the Action correctly.
+   *  @return The ChatItem from which the sending Action originated
+   */
+  inline ContentsChatItem *item() const {
+    return static_cast<ContentsChatItem *>(qobject_cast<QAction *>(sender())->data().value<void *>());
+  }
 };
 
 /*************************************************************************************************/
 
 // Avoid circular include deps
 #include "chatline.h"
+const QAbstractItemModel *ChatItem::model() const { return static_cast<ChatLine *>(parentItem())->model(); }
 int ChatItem::row() const { return static_cast<ChatLine *>(parentItem())->row(); }
 
-QTextLayout *ContentsChatItem::layout() const { return _layoutData->layout; }
-ContentsChatItem::LayoutData *ContentsChatItem::layoutData() const { Q_ASSERT(_layoutData); return _layoutData; }
-
 #endif