diff options
Diffstat (limited to 'kio/kfile/kcombiview.h')
-rw-r--r-- | kio/kfile/kcombiview.h | 133 |
1 files changed, 133 insertions, 0 deletions
diff --git a/kio/kfile/kcombiview.h b/kio/kfile/kcombiview.h new file mode 100644 index 000000000..b38876d71 --- /dev/null +++ b/kio/kfile/kcombiview.h @@ -0,0 +1,133 @@ +/* -*- c++ -*- + This file is part of the KDE libraries + Copyright (C) 1998 Stephan Kulow <coolo@kde.org> + 1998 Daniel Grana <grana@ie.iwi.unibe.ch> + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + 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 _KCOMBIVIEW_H +#define _KCOMBIVIEW_H + +#include <qsplitter.h> +#include <klocale.h> + +#include <kfile.h> +#include <kfileview.h> + +class KFileIconView; +class QEvent; +class QIconViewItem; + +/** + * This view is designed to combine two KFileViews into one widget, to show + * directories on the left side and files on the right side. + * + * Methods like selectedItems() to query status _only_ work on the right side, + * i.e. on the files. + * + * After creating the KCombiView, you need to supply the view shown in the + * right, (see setRight()). Available KFileView implementations are + * KFileIconView and KFileDetailView. + * + * Most of the below methods are just implementations of the baseclass + * KFileView, so look there for documentation. + * + * @see KFileView + * @see KFileIconView + * @see KFileDetailView + * @see KDirOperator + */ +class KIO_EXPORT KCombiView : public QSplitter, + public KFileView +{ + Q_OBJECT + +public: + KCombiView( QWidget *parent, const char *name); + virtual ~KCombiView(); + + virtual QWidget *widget() { return this; } + virtual void clearView(); + + virtual void updateView( bool ); + virtual void updateView(const KFileItem*); + virtual void removeItem( const KFileItem * ); + virtual void listingCompleted(); + + /** + * Sets the view to be shown in the right. You need to call this before + * doing anything else with this widget. + */ + void setRight(KFileView *view); + + virtual void setSelectionMode( KFile::SelectionMode sm ); + + virtual void setSelected(const KFileItem *, bool); + virtual bool isSelected( const KFileItem * ) const; + virtual void clearSelection(); + virtual void selectAll(); + virtual void invertSelection(); + + virtual void setCurrentItem( const KFileItem * ); + virtual KFileItem * currentFileItem() const; + virtual KFileItem * firstFileItem() const; + virtual KFileItem * nextItem( const KFileItem * ) const; + virtual KFileItem * prevItem( const KFileItem * ) const; + + virtual void insertItem( KFileItem *i ); + virtual void clear(); + + virtual void setSorting( QDir::SortSpec sort ); + + virtual void readConfig( KConfig *, const QString& group = QString::null ); + virtual void writeConfig( KConfig *, const QString& group = QString::null); + + void ensureItemVisible( const KFileItem * ); + + virtual KActionCollection * actionCollection() const; + + virtual void setAcceptDrops(bool b); + +protected: + KFileIconView *left; + KFileView *right; + +protected slots: + void slotSortingChanged( QDir::SortSpec ); + +private: + KFileView *focusView( KFileView *preferred ) const; + + // in nextItem() and prevItem(), we have to switch views, when the first + // view returns 0L. So we need to remember which view was used in the + // previous call to next/prevItem(). Yes, it's a hack, but it works for + // some cases at least. + mutable KFileView *m_lastViewForNextItem; + mutable KFileView *m_lastViewForPrevItem; + +protected: + virtual bool eventFilter( QObject *o, QEvent *e ); + void setDropOptions_impl(int options); + + virtual void virtual_hook( int id, void* data ); +private: + class KCombiViewPrivate; + KCombiViewPrivate *d; + +}; + +#endif |