k3filetreeview.h

Go to the documentation of this file.

/* This file is part of the KDE project
   Copyright (C) 2000 David Faure <faure@kde.org>
                 2000 Carsten Pfeiffer <pfeiffer@kde.org>
         2002 Klaas Freitag <freitag@suse.de>

   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 kfile_tree_view_h
#define kfile_tree_view_h

#include <QtCore/QMap>
#include <QtCore/QPoint>
#include <QtGui/QPixmap>



#include <k3listview.h>
#include <kdirnotify.h>
#include <kio/job.h>
#include <k3filetreeviewitem.h>
#include <kfiletreebranch.h>

class QTimer;



class KDE3SUPPORT_EXPORT K3FileTreeView : public K3ListView
{
    Q_OBJECT
public:
    K3FileTreeView( QWidget *parent );
    virtual ~K3FileTreeView();

    K3FileTreeViewItem * currentKFileTreeViewItem() const;

    KUrl currentUrl() const;

   KFileTreeBranch* addBranch( const KUrl &path, const QString& name, bool showHidden = false );

   virtual KFileTreeBranch* addBranch( const KUrl &path, const QString& name ,
                       const QPixmap& pix, bool showHidden = false  );

   virtual KFileTreeBranch* addBranch( KFileTreeBranch * );

   virtual bool removeBranch( KFileTreeBranch *branch );

   KFileTreeBranch *branch( const QString& searchName );


   KFileTreeBranchList& branches();

   virtual void setDirOnlyMode( KFileTreeBranch *branch, bool );

   K3FileTreeViewItem *findItem( KFileTreeBranch* brnch, const QString& relUrl );

   K3FileTreeViewItem *findItem( const QString& branchName, const QString& relUrl );

   bool showFolderOpenPixmap() const;

public Q_SLOTS:

   virtual void setShowFolderOpenPixmap( bool showIt = true );

protected:
    virtual bool acceptDrag(QDropEvent* event) const;
    virtual Q3DragObject * dragObject();

    virtual void startAnimation( K3FileTreeViewItem* item, const char * iconBaseName = "kde", uint iconCount = 6 );
    virtual void stopAnimation( K3FileTreeViewItem* item );
    virtual void contentsDragEnterEvent( QDragEnterEvent *e );
    virtual void contentsDragMoveEvent( QDragMoveEvent *e );
    virtual void contentsDragLeaveEvent( QDragLeaveEvent *e );
    virtual void contentsDropEvent( QDropEvent *ev );

protected Q_SLOTS:
    virtual void slotNewTreeViewItems( KFileTreeBranch*,
                       const K3FileTreeViewItemList& );

    virtual void slotSetNextUrlToSelect( const KUrl &url );

    virtual QPixmap itemIcon( K3FileTreeViewItem*, int gap = 0 ) const;

private Q_SLOTS:
    void slotExecuted( Q3ListViewItem * );
    void slotExpanded( Q3ListViewItem * );
    void slotCollapsed( Q3ListViewItem *item );

    void slotSelectionChanged();

    void slotAnimation();

    void slotAutoOpenFolder();

    void slotOnItem( Q3ListViewItem * );
    void slotItemRenamed(Q3ListViewItem*, const QString &, int);

   void slotPopulateFinished( K3FileTreeViewItem* );


Q_SIGNALS:

   void onItem( const QString& );
   /* New signals if you like it ? */
   void dropped( QWidget*, QDropEvent* );
   void dropped( QWidget*, QDropEvent*, KUrl::List& );
   void dropped( KUrl::List&, KUrl& );
   // The drop event allows to differentiate between move and copy
   void dropped( QWidget*, QDropEvent*, KUrl::List&, KUrl& );

   void dropped( QDropEvent *, Q3ListViewItem * );
   void dropped(K3FileTreeView *, QDropEvent *, Q3ListViewItem *);
   void dropped(QDropEvent *, Q3ListViewItem *, Q3ListViewItem *);
   void dropped(K3FileTreeView *, QDropEvent *, Q3ListViewItem *, Q3ListViewItem *);

protected:
   KUrl m_nextUrlToSelect;


private:
    // Returns whether item is still a valid item in the tree
    bool isValidItem( Q3ListViewItem *item);
    void clearTree();


   /* List that holds the branches */
    KFileTreeBranchList m_branches;


    struct AnimationInfo
    {
        AnimationInfo( const char * _iconBaseName, uint _iconCount, const QPixmap & _originalPixmap )
            : iconBaseName(_iconBaseName), iconCount(_iconCount), iconNumber(1), originalPixmap(_originalPixmap) {}
        AnimationInfo() : iconCount(0) {}
        QByteArray iconBaseName;
        uint iconCount;
        uint iconNumber;
        QPixmap originalPixmap;
    };
    typedef QMap<K3FileTreeViewItem *, AnimationInfo> MapCurrentOpeningFolders;
    MapCurrentOpeningFolders m_mapCurrentOpeningFolders;


    QTimer *m_animationTimer;

    QPoint m_dragPos;
    bool m_bDrag;

    bool m_wantOpenFolderPixmaps; // Flag weather the folder should have open-folder pixmaps

    Q3ListViewItem *m_currentBeforeDropItem; // The item that was current before the drag-enter event happened
    Q3ListViewItem *m_dropItem; // The item we are moving the mouse over (during a drag)
    QPixmap  m_openFolderPixmap;
    QTimer *m_autoOpenTimer;

private:
   class K3FileTreeViewPrivate;
   K3FileTreeViewPrivate *d;
};

#endif