kiconview.h

/* 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 <tqcursor.h>
#include <tqiconview.h>
 
#include <tdelibs_export.h>
 
class TDEUI_EXPORT TDEIconView : public TQIconView
{
  friend class TDEIconViewItem;
  TQ_OBJECT
  TQ_ENUMS( Mode )
  TQ_PROPERTY( Mode mode READ mode WRITE setMode )
 
public:
  TDEIconView( TQWidget *parent = 0, const char *name = 0, WFlags f = 0 );
 
  ~TDEIconView();
 
  enum Mode { Execute, Select };
 
  void setMode( Mode m );
 
  Mode mode() const;
 
  virtual void setFont( const TQFont & );
 
  void setIconTextHeight( int n );
 
  int iconTextHeight() const;
 
  virtual void takeItem( TQIconViewItem * item );
 
signals:
 
  void executed( TQIconViewItem *item );
 
  void executed( TQIconViewItem *item, const TQPoint &pos );
 
  void held( TQIconViewItem *item );
 
  void doubleClicked( TQIconViewItem *item, const TQPoint &pos );
 
protected slots:
  void slotOnItem( TQIconViewItem *item );
  void slotOnViewport();
  void slotSettingsChanged(int);
 
  void slotAutoSelect();
 
protected:
  void emitExecute( TQIconViewItem *item, const TQPoint &pos );
  void updateDragHoldItem( TQDropEvent *e );
 
  virtual void focusOutEvent( TQFocusEvent *fe );
  virtual void leaveEvent( TQEvent *e );
  virtual void contentsMousePressEvent( TQMouseEvent *e );
  virtual void contentsMouseDoubleClickEvent ( TQMouseEvent * e );
  virtual void contentsMouseReleaseEvent( TQMouseEvent *e );
  virtual void contentsDragEnterEvent( TQDragEnterEvent *e );
  virtual void contentsDragLeaveEvent( TQDragLeaveEvent *e );
  virtual void contentsDragMoveEvent( TQDragMoveEvent *e );
  virtual void contentsDropEvent( TQDropEvent* e );
  virtual void wheelEvent( TQWheelEvent *e );
 
  void cancelPendingHeldSignal();
  
private slots:
  void slotMouseButtonClicked( int btn, TQIconViewItem *item, const TQPoint &pos );
  void slotDragHoldTimeout();
 
private:
  TQFontMetrics *itemFontMetrics() const;
  TQPixmap selectedIconPixmap( TQPixmap *pix, const TQColor &col ) const;
 
  bool m_bUseSingle;
  bool m_bChangeCursorOverItem;
 
  TQIconViewItem* m_pCurrentItem;
 
  TQTimer* m_pAutoSelect;
  int m_autoSelectDelay;
 
protected:
  virtual void virtual_hook( int id, void* data );
private:
  class TDEIconViewPrivate;
  TDEIconViewPrivate *d;
};
 
class KWordWrap;
class TDEUI_EXPORT TDEIconViewItem : public TQIconViewItem
{
public:
    // Need to redefine all the constructors - I want Java !
    TDEIconViewItem( TQIconView *parent )
        : TQIconViewItem( parent ) { init(); } // We need to call it because the parent ctor won't call our reimplementation :(((
    TDEIconViewItem( TQIconView *parent, TQIconViewItem *after )
        : TQIconViewItem( parent, after ) { init(); }
    TDEIconViewItem( TQIconView *parent, const TQString &text )
        : TQIconViewItem( parent, text ) { init(); }
    TDEIconViewItem( TQIconView *parent, TQIconViewItem *after, const TQString &text )
        : TQIconViewItem( parent, after, text ) { init(); }
    TDEIconViewItem( TQIconView *parent, const TQString &text, const TQPixmap &icon )
        : TQIconViewItem( parent, text, icon ) { init(); }
    TDEIconViewItem( TQIconView *parent, TQIconViewItem *after, const TQString &text, const TQPixmap &icon )
        : TQIconViewItem( parent, after, text, icon ) { init(); }
    TDEIconViewItem( TQIconView *parent, const TQString &text, const TQPicture &picture )
        : TQIconViewItem( parent, text, picture ) { init(); }
    TDEIconViewItem( TQIconView *parent, TQIconViewItem *after, const TQString &text, const TQPicture &picture )
        : TQIconViewItem( parent, after, text, picture ) { init(); }
    virtual ~TDEIconViewItem();
 
    void setPixmapSize( const TQSize& size );
 
    TQSize pixmapSize() const;
 
protected:
    void init();
    virtual void calcRect( const TQString& text_ = TQString::null );
    virtual void paintItem( TQPainter *p, const TQColorGroup &c );
    KWordWrap *wordWrap();
    void paintPixmap( TQPainter *p, const TQColorGroup &c );
    void paintText( TQPainter *p, const TQColorGroup &c );
 
private:
    KWordWrap* m_wordWrap;
    struct TDEIconViewItemPrivate;
    TDEIconViewItemPrivate *d;
};
 
#endif