summaryrefslogtreecommitdiffstats
path: root/kio/kfile/kcombiview.h
diff options
context:
space:
mode:
Diffstat (limited to 'kio/kfile/kcombiview.h')
-rw-r--r--kio/kfile/kcombiview.h133
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