kio Library API Documentation

kfileiconview.h

00001 // -*- c++ -*-
00002 /* This file is part of the KDE libraries
00003     Copyright (C) 1997 Stephan Kulow <coolo@kde.org>
00004 
00005     This library is free software; you can redistribute it and/or
00006     modify it under the terms of the GNU Library General Public
00007     License as published by the Free Software Foundation; either
00008     version 2 of the License, or (at your option) any later version.
00009 
00010     This library is distributed in the hope that it will be useful,
00011     but WITHOUT ANY WARRANTY; without even the implied warranty of
00012     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00013     Library General Public License for more details.
00014 
00015     You should have received a copy of the GNU Library General Public License
00016     along with this library; see the file COPYING.LIB.  If not, write to
00017     the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
00018     Boston, MA 02111-1307, USA.
00019 */
00020 
00021 #ifndef KFILEICONVIEW_H
00022 #define KFILEICONVIEW_H
00023 
00024 class KFileItem;
00025 class QWidget;
00026 class QLabel;
00027 
00028 #include <kiconview.h>
00029 #include <kiconloader.h>
00030 #include <kfileview.h>
00031 #include <kmimetyperesolver.h>
00032 
00033 #include <kfile.h>
00034 
00039 class KFileIconViewItem : public KIconViewItem
00040 {
00041 public:
00042     KFileIconViewItem( QIconView *parent, const QString &text,
00043                const QPixmap &pixmap,
00044                KFileItem *fi )
00045     : KIconViewItem( parent, text, pixmap ), inf( fi ) {}
00049     KFileIconViewItem( QIconView *parent, KFileItem *fi )
00050     : KIconViewItem( parent ), inf( fi ) {}
00051 
00052     virtual ~KFileIconViewItem();
00053 
00057     KFileItem *fileInfo() const {
00058     return inf;
00059     }
00060 
00061 private:
00062     KFileItem *inf;
00063 
00064 private:
00065     class KFileIconViewItemPrivate;
00066     KFileIconViewItemPrivate *d;
00067 
00068 };
00069 
00070 namespace KIO {
00071     class Job;
00072 }
00073 
00082 class KFileIconView : public KIconView, public KFileView
00083 {
00084     Q_OBJECT
00085 
00086 public:
00087     KFileIconView(QWidget *parent, const char *name);
00088     virtual ~KFileIconView();
00089 
00090     virtual QWidget *widget() { return this; }
00091     virtual void clearView();
00092     virtual void setAutoUpdate( bool ) {}
00093 
00094     virtual void updateView( bool );
00095     virtual void updateView(const KFileItem*);
00096     virtual void removeItem(const KFileItem*);
00097 
00098     virtual void listingCompleted();
00099 
00100     virtual void insertItem( KFileItem *i );
00101     virtual void setSelectionMode( KFile::SelectionMode sm );
00102 
00103     virtual void setSelected(const KFileItem *, bool);
00104     virtual bool isSelected(const KFileItem *i) const;
00105     virtual void clearSelection();
00106     virtual void selectAll();
00107     virtual void invertSelection();
00108 
00109     virtual void setCurrentItem( const KFileItem * );
00110     virtual KFileItem * currentFileItem() const;
00111     virtual KFileItem * firstFileItem() const;
00112     virtual KFileItem * nextItem( const KFileItem * ) const;
00113     virtual KFileItem * prevItem( const KFileItem * ) const;
00114 
00118     void setIconSize( int size );
00119 
00123     void setPreviewSize( int size );
00124 
00128     int iconSize() const { return myIconSize; }
00129 
00130     void ensureItemVisible( const KFileItem * );
00131 
00132     virtual void setSorting(QDir::SortSpec sort);
00133 
00134     virtual void readConfig( KConfig *, const QString& group = QString::null );
00135     virtual void writeConfig( KConfig *, const QString& group = QString::null);
00136 
00137     // for KMimeTypeResolver
00138     void mimeTypeDeterminationFinished();
00139     void determineIcon( KFileIconViewItem *item );
00140     QScrollView *scrollWidget() const { return (QScrollView*) this; }
00141 
00142 public slots:
00147     void showPreviews();
00148     
00153     virtual void arrangeItemsInGrid( bool updated = true );
00154 
00155 protected:
00159     virtual void keyPressEvent( QKeyEvent * );
00160 
00164     virtual void hideEvent( QHideEvent * );
00165 
00166     // ### workaround for Qt3 bug (see #35080)
00167     virtual void showEvent( QShowEvent * );
00168 
00169     virtual bool eventFilter( QObject *o, QEvent *e );
00170 
00171 private slots:
00172     void selected( QIconViewItem *item );
00173     void slotActivate( QIconViewItem * );
00174     void highlighted( QIconViewItem *item );
00175     void showToolTip( QIconViewItem *item );
00176     void removeToolTip();
00177     void slotActivateMenu( QIconViewItem *, const QPoint& );
00178     void slotSelectionChanged();
00179 
00180     void slotSmallColumns();
00181     void slotLargeRows();
00182     void slotPreviewsToggled( bool );
00183 
00184     void slotPreviewResult( KIO::Job * );
00185     void gotPreview( const KFileItem *item, const QPixmap& pix );
00186 
00187 private:
00188     KMimeTypeResolver<KFileIconViewItem,KFileIconView> *m_resolver;
00189 
00190     QLabel *toolTip;
00191     int th;
00192     int myIconSize;
00193 
00194     virtual void insertItem(QIconViewItem *a, QIconViewItem *b) { KIconView::insertItem(a, b); }
00195     virtual void setSelectionMode(QIconView::SelectionMode m) { KIconView::setSelectionMode(m); }
00196     virtual void setSelected(QIconViewItem *i, bool a, bool b) { KIconView::setSelected(i, a, b); }
00197 
00198     bool canPreview( const KFileItem * ) const;
00199     int iconSizeFor( const KFileItem * ) const;
00200     void stopPreview();
00201 
00202     void updateIcons();
00203 
00204     inline KFileIconViewItem * viewItem( const KFileItem *item ) const {
00205         if ( item )
00206             return (KFileIconViewItem *) item->extraData( this );
00207         return 0L;
00208     }
00209 
00210     void initItem(KFileIconViewItem *item, const KFileItem *i,
00211                   bool updateTextAndPixmap );
00212 
00213 protected:
00214     virtual void virtual_hook( int id, void* data );
00215 private:
00216     class KFileIconViewPrivate;
00217     KFileIconViewPrivate *d;
00218 };
00219 
00220 #endif // KFILESIMPLEVIEW_H
KDE Logo
This file is part of the documentation for kdelibs Version 3.1.0.
Documentation copyright © 1996-2002 the KDE developers.
Generated on Wed Oct 8 12:21:29 2003 by doxygen 1.2.18 written by Dimitri van Heesch, © 1997-2001