/***************************************************************************
                          krecursivelister.h  -  description
                             -------------------
    begin                : Fri Aug 31 2001
    copyright            : (C) 2001 by Jonathon Sim
    email                : jonathonsim@iname.com
 ***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/

#ifndef KRECURSIVELISTER_H
#define KRECURSIVELISTER_H

#include <tqwidget.h>
#include <tqobject.h>
#include <kdirlister.h>
#include <tdefileitem.h>
#include <tqguardedptr.h>

/**A convienience class that recursively lists a directory
  *@author Jonathon Sim
  *
  * Modified by Dominik Seichter to support a name filter,
  * dir only mode, support for showing hidden files on demand
  * and support for listing directories along with files.
  */

class KRecursiveLister : public TQObject  {
   Q_OBJECT
  

public:
	KRecursiveLister(TQObject *parent=0, const char *name=0);
	~KRecursiveLister();

	/** Returns the list of fileitems found. */
	const KFileItemList & items();

        /** sets wether hidden files shall be listed */
        inline void setShowingDotFiles( bool dotfiles );
        
        /** filter to be used */
        inline void setNameFilter( const TQString & filter );

        /** list only directories */
        inline void setDirOnlyMode( bool dirsOnly );

        /** Starts listing the specified url */
	void openURL(const KURL& url);
	
        /** Stops the listing */
	void stop();
	
        /** Returns the subdirectories found by the listing */
	const KFileItemList& dirs();

        void cleanUp();

 signals: // Signals
	/** Listing is complete */
	void completed();

protected slots: // Protected slots
    
        /** handles completion of a listing. */
        void slotListingComplete();
        void listNextDirectory();

protected: // Protected methods
	/** Starts listing the specified url */
	void startListing(const KURL& url);
	
	//Protected variables
	KFileItemList	filelist; 	//Files found at  url
	KFileItemList	dirlist;	//Dirs remaining to list
	KFileItemList	dirtree;
	KFileItemList allItems;
	TQGuardedPtr<KDirLister>		lister;			//The current KDirLister

        bool m_hidden;
        bool m_dirs;
        TQString m_filter;
};

void KRecursiveLister::setShowingDotFiles( bool dotfiles ) 
{
    m_hidden = dotfiles; 
}
        
void KRecursiveLister::setNameFilter( const TQString & filter ) 
{ 
    m_filter = filter; 
}

void KRecursiveLister::setDirOnlyMode( bool dirsOnly ) 
{ 
    m_dirs = dirsOnly; 
}


#endif