k3iconview.h

Go to the documentation of this file.

/* This file is part of the KDE libraries
   Copyright (C) 1999 Torben Weis <weis@kde.org>

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License version 2 as published by the Free Software Foundation.

   This library 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
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public License
   along with this library; see the file COPYING.LIB.  If not, write to
   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
   Boston, MA 02110-1301, USA.
*/
#ifndef KICONVIEW_H
#define KICONVIEW_H

#include <kde3support_export.h>

#include <Qt3Support/Q3IconView>

class KDE3SUPPORT_EXPORT K3IconView : public Q3IconView
{
  friend class K3IconViewItem;
  Q_OBJECT
  Q_ENUMS( Mode )
  Q_PROPERTY( Mode mode READ mode WRITE setMode )

public:
  K3IconView( QWidget *parent = 0, const char *name = 0, Qt::WFlags f = 0 );

  ~K3IconView();

  enum Mode { Execute, Select };

  void setMode( Mode m );

  Mode mode() const;

  virtual void setFont( const QFont & );

  void setIconTextHeight( int n );

  int iconTextHeight() const;

  virtual void takeItem( Q3IconViewItem * item );

Q_SIGNALS:

  void executed( Q3IconViewItem *item );

  void executed( Q3IconViewItem *item, const QPoint &pos );

  void held( Q3IconViewItem *item );

  void doubleClicked( Q3IconViewItem *item, const QPoint &pos );

protected Q_SLOTS:
  void slotOnItem( Q3IconViewItem *item );
  void slotOnViewport();
  void slotSettingsChanged(int);

  void slotAutoSelect();

protected:
  void emitExecute( Q3IconViewItem *item, const QPoint &pos );
  void updateDragHoldItem( QDropEvent *e );

  virtual void focusOutEvent( QFocusEvent *fe );
  virtual void leaveEvent( QEvent *e );
  virtual void contentsMousePressEvent( QMouseEvent *e );
  virtual void contentsMouseDoubleClickEvent ( QMouseEvent * e );
  virtual void contentsMouseReleaseEvent( QMouseEvent *e );
  virtual void contentsDragEnterEvent( QDragEnterEvent *e );
  virtual void contentsDragLeaveEvent( QDragLeaveEvent *e );
  virtual void contentsDragMoveEvent( QDragMoveEvent *e );
  virtual void contentsDropEvent( QDropEvent* e );
  virtual void wheelEvent( QWheelEvent *e );

  void cancelPendingHeldSignal();
  
private Q_SLOTS:
  void slotMouseButtonClicked( int btn, Q3IconViewItem *item, const QPoint &pos );
  void slotDragHoldTimeout();

private:
  QFontMetrics *itemFontMetrics() const;
  QPixmap selectedIconPixmap( QPixmap *pix, const QColor &col ) const;

  bool m_bUseSingle;
  bool m_bChangeCursorOverItem;

  Q3IconViewItem* m_pCurrentItem;

  QTimer* m_pAutoSelect;
  int m_autoSelectDelay;

private:
  class K3IconViewPrivate;
  K3IconViewPrivate *d;
};

class KWordWrap;
class KDE3SUPPORT_EXPORT K3IconViewItem : public Q3IconViewItem
{
public:
    // Need to redefine all the constructors - I want Java !
    K3IconViewItem( Q3IconView *parent )
        : Q3IconViewItem( parent ) { init(); } // We need to call it because the parent ctor won't call our reimplementation :(((
    K3IconViewItem( Q3IconView *parent, Q3IconViewItem *after )
        : Q3IconViewItem( parent, after ) { init(); }
    K3IconViewItem( Q3IconView *parent, const QString &text )
        : Q3IconViewItem( parent, text ) { init(); }
    K3IconViewItem( Q3IconView *parent, Q3IconViewItem *after, const QString &text )
        : Q3IconViewItem( parent, after, text ) { init(); }
    K3IconViewItem( Q3IconView *parent, const QString &text, const QPixmap &icon )
        : Q3IconViewItem( parent, text, icon ) { init(); }
    K3IconViewItem( Q3IconView *parent, Q3IconViewItem *after, const QString &text, const QPixmap &icon )
        : Q3IconViewItem( parent, after, text, icon ) { init(); }
    K3IconViewItem( Q3IconView *parent, const QString &text, const QPicture &picture )
        : Q3IconViewItem( parent, text, picture ) { init(); }
    K3IconViewItem( Q3IconView *parent, Q3IconViewItem *after, const QString &text, const QPicture &picture )
        : Q3IconViewItem( parent, after, text, picture ) { init(); }
    virtual ~K3IconViewItem();

    void setPixmapSize( const QSize& size );

    QSize pixmapSize() const;

protected:
    void init();
    virtual void calcRect( const QString& text_ = QString() );
    virtual void paintItem( QPainter *p, const QColorGroup &c );
    KWordWrap *wordWrap();
    void paintPixmap( QPainter *p, const QColorGroup &c );
    void paintText( QPainter *p, const QColorGroup &c );

private:
    KWordWrap* m_wordWrap;
    struct K3IconViewItemPrivate;
    K3IconViewItemPrivate *d;
};

#endif