libkonq Library API Documentation
	Overview Class Hierarchy Classes Classes (annotated) Members Source Files

konq_dirpart.h

/* This file is part of the KDE projects
   Copyright (C) 2000 David Faure <faure@kde.org>

   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.

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

   You should have received a copy of the GNU General Public License
   along with this program; see the file COPYING.  If not, write to
   the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
   Boston, MA 02111-1307, USA.
*/

#ifndef __konqdirpart_h
#define __konqdirpart_h

#include <qstring.h>
#include <kparts/part.h>
#include <kparts/browserextension.h>
#include <kfileitem.h>

namespace KParts { class BrowserExtension; }
class KonqPropsView;
class QScrollView;
class KAction;
class KToggleAction;
class KonqDirPartBrowserExtension;

class KonqDirPart: public KParts::ReadOnlyPart
{
    Q_OBJECT
    
    friend class KonqDirPartBrowserExtension;
    
public:
    KonqDirPart( QObject *parent, const char *name );

    virtual ~KonqDirPart();

    void setBrowserExtension( KonqDirPartBrowserExtension * extension )
      { m_extension = extension; }

    KonqDirPartBrowserExtension * extension()
      { return m_extension; }

    QScrollView * scrollWidget();

    virtual void saveState( QDataStream &stream );
    virtual void restoreState( QDataStream &stream );

    void lmbClicked( KFileItem * fileItem );

    void mmbClicked( KFileItem * fileItem );

    void setNameFilter( const QString & nameFilter ) { m_nameFilter = nameFilter; }

    QString nameFilter() const { return m_nameFilter; }

    void setMimeFilter (const QStringList& filters);

    QStringList mimeFilter() const;


    KonqPropsView * props() const { return m_pProps; }

    virtual void disableIcons( const KURL::List & lst ) = 0;

    void resetCount()
    {
        m_lDirSize = 0;
        m_lFileCount = 0;
        m_lDirCount = 0;
    }

    void newItems( const KFileItemList & entries );

    void deleteItem( KFileItem * fileItem );

    void emitTotalCount();

    void emitCounts( const KFileItemList & lst, bool selectionChanged );

    void emitMouseOver( const KFileItem * item );

    void updatePasteAction();

    virtual void newIconSize( int size );

    void setIconSize( int size );

    void setFindPart( KParts::ReadOnlyPart * part );

    KParts::ReadOnlyPart * findPart() const { return m_findPart; }

    virtual const KFileItem * currentItem() = 0; // { return 0L; }

    virtual KFileItemList selectedFileItems() { return KFileItemList(); }

    bool closeURL ();

signals:

    void aboutToOpenURL();

    void findOpen( KonqDirPart * );

    void findOpened( KonqDirPart * );

    void findClosed( KonqDirPart * );

    void itemsAdded( const KFileItemList& );

    void itemRemoved( const KFileItem* );

    void itemsFilteredByMime( const KFileItemList& );

public slots:

     bool openURL (const KURL&);

    void slotFindClosed();

    void slotStartAnimationSearching();

    void slotStopAnimationSearching();

    void slotBackgroundColor();

    void slotBackgroundImage();

    void slotClipboardDataChanged();

    void slotIncIconSize();
    void slotDecIconSize();

    void slotIconSizeToggled( bool );

    // slots connected to the directory lister - or to the kfind interface
    virtual void slotStarted() = 0;
    virtual void slotCanceled() = 0;
    virtual void slotCompleted() = 0;
    virtual void slotNewItems( const KFileItemList& ) = 0;
    virtual void slotDeleteItem( KFileItem * ) = 0;
    virtual void slotRefreshItems( const KFileItemList& ) = 0;
    virtual void slotClear() = 0;
    virtual void slotRedirection( const KURL & ) = 0;

protected:
    virtual bool doOpenURL( const KURL& ) = 0;
    virtual bool doCloseURL () = 0;

protected:

    QString m_nameFilter;

    KonqPropsView * m_pProps;

    KAction *m_paIncIconSize;
    KAction *m_paDecIconSize;
    KToggleAction *m_paDefaultIcons;
    KToggleAction *m_paHugeIcons;
    KToggleAction *m_paLargeIcons;
    KToggleAction *m_paMediumIcons;
    KToggleAction *m_paSmallIcons;

    KParts::ReadOnlyPart * m_findPart;
    KonqDirPartBrowserExtension * m_extension;

    int m_iIconSize[5];

    long long m_lDirSize;
    uint m_lFileCount;
    uint m_lDirCount;
    //bool m_bMultipleItemsSelected;

private:
    void saveFindState( QDataStream& );
    void restoreFindState( QDataStream& );
    
    class KonqDirPartPrivate;
    KonqDirPartPrivate* d;
};

class KonqDirPartBrowserExtension : public KParts::BrowserExtension
{
public:
    KonqDirPartBrowserExtension( KonqDirPart* dirPart )
        : KParts::BrowserExtension( dirPart )
        , m_dirPart( dirPart )
    {}
    
    // For restoration of the find part to work correctly, we need
    // the state to be saved and restored in the following order:
    // 1. KonqDirPart (and derived classes)
    // 2. BrowserExtension (which calls openURL())
    // 3. Find part
    //
    // This is handled below. If your KonqDirPart-derived class needs
    // to save and restore state, you should override KonqDirPart::saveState
    // and KonqDirPart::restoreState, not the following methods.
    virtual void saveState( QDataStream &stream )
    {
        m_dirPart->saveState( stream );
        KParts::BrowserExtension::saveState( stream );
        m_dirPart->saveFindState( stream );
    }

    virtual void restoreState( QDataStream &stream )
    {
        m_dirPart->restoreState( stream );
        KParts::BrowserExtension::restoreState( stream );
        m_dirPart->restoreFindState( stream );
    }

private:
    KonqDirPart* m_dirPart;
};

#endif

This file is part of the documentation for kdelibs Version 3.1.5.

Documentation copyright © 1996-2002 the KDE developers.
Generated on Thu Jan 29 23:03:28 2004 by doxygen 1.3.4 written by Dimitri van Heesch, © 1997-2001