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 #include <kfile.h> 00033 00038 class KIO_EXPORT KFileIconViewItem : public KIconViewItem 00039 { 00040 public: 00041 KFileIconViewItem( QIconView *parent, const QString &text, 00042 const QPixmap &pixmap, 00043 KFileItem *fi ) 00044 : KIconViewItem( parent, text, pixmap ), inf( fi ) {} 00048 KFileIconViewItem( QIconView *parent, KFileItem *fi ) 00049 : KIconViewItem( parent ), inf( fi ) {} 00050 00051 virtual ~KFileIconViewItem(); 00052 00056 KFileItem *fileInfo() const { 00057 return inf; 00058 } 00059 00060 private: 00061 KFileItem *inf; 00062 00063 private: 00064 class KFileIconViewItemPrivate; 00065 KFileIconViewItemPrivate *d; 00066 00067 }; 00068 00069 namespace KIO { 00070 class Job; 00071 } 00072 00081 class KIO_EXPORT KFileIconView : public KIconView, public KFileView 00082 { 00083 Q_OBJECT 00084 00085 public: 00086 KFileIconView(QWidget *parent, const char *name); 00087 virtual ~KFileIconView(); 00088 00089 virtual QWidget *widget() { return this; } 00090 virtual void clearView(); 00091 virtual void setAutoUpdate( bool ) {} // ### unused. remove in KDE4 00092 00093 virtual void updateView( bool ); 00094 virtual void updateView(const KFileItem*); 00095 virtual void removeItem(const KFileItem*); 00096 00097 virtual void listingCompleted(); 00098 00099 virtual void insertItem( KFileItem *i ); 00100 virtual void setSelectionMode( KFile::SelectionMode sm ); 00101 00102 virtual void setSelected(const KFileItem *, bool); 00103 virtual bool isSelected(const KFileItem *i) const; 00104 virtual void clearSelection(); 00105 virtual void selectAll(); 00106 virtual void invertSelection(); 00107 00108 virtual void setCurrentItem( const KFileItem * ); 00109 virtual KFileItem * currentFileItem() const; 00110 virtual KFileItem * firstFileItem() const; 00111 virtual KFileItem * nextItem( const KFileItem * ) const; 00112 virtual KFileItem * prevItem( const KFileItem * ) const; 00113 00117 void setIconSize( int size ); 00118 00122 void setPreviewSize( int size ); 00123 00131 void setIgnoreMaximumSize(bool ignoreSize=true); 00132 00136 int iconSize() const { return myIconSize; } 00137 00138 void ensureItemVisible( const KFileItem * ); 00139 00140 virtual void setSorting(QDir::SortSpec sort); 00141 00142 virtual void readConfig( KConfig *, const QString& group = QString::null ); 00143 virtual void writeConfig( KConfig *, const QString& group = QString::null); 00144 00145 // for KMimeTypeResolver 00146 void mimeTypeDeterminationFinished(); 00147 void determineIcon( KFileIconViewItem *item ); 00148 QScrollView *scrollWidget() const { return (QScrollView*) this; } 00149 void setAcceptDrops(bool b) 00150 { 00151 KIconView::setAcceptDrops(b); 00152 viewport()->setAcceptDrops(b); 00153 } 00154 00155 public slots: 00162 void showPreviews(); 00163 00164 void zoomIn(); 00165 00166 void zoomOut(); 00167 00172 virtual void arrangeItemsInGrid( bool updated = true ); 00173 00174 protected: 00178 virtual void keyPressEvent( QKeyEvent * ); 00179 00183 virtual void hideEvent( QHideEvent * ); 00184 00185 // ### workaround for Qt3 bug (see #35080) 00186 virtual void showEvent( QShowEvent * ); 00187 00188 virtual bool eventFilter( QObject *o, QEvent *e ); 00189 00190 // DND support 00191 virtual QDragObject *dragObject(); 00192 virtual void contentsDragEnterEvent( QDragEnterEvent *e ); 00193 virtual void contentsDragMoveEvent( QDragMoveEvent *e ); 00194 virtual void contentsDragLeaveEvent( QDragLeaveEvent *e ); 00195 virtual void contentsDropEvent( QDropEvent *ev ); 00196 00197 // KDE4: Make virtual 00198 bool acceptDrag(QDropEvent* e ) const; 00199 00200 private slots: 00201 void selected( QIconViewItem *item ); 00202 void slotActivate( QIconViewItem * ); 00203 void highlighted( QIconViewItem *item ); 00204 void showToolTip( QIconViewItem *item ); 00205 void removeToolTip(); 00206 void slotActivateMenu( QIconViewItem *, const QPoint& ); 00207 void slotSelectionChanged(); 00208 00209 void slotSmallColumns(); 00210 void slotLargeRows(); 00211 void slotPreviewsToggled( bool ); 00212 00213 void slotPreviewResult( KIO::Job * ); 00214 void gotPreview( const KFileItem *item, const QPixmap& pix ); 00215 void slotAutoOpen(); 00216 00217 signals: 00224 void dropped(QDropEvent *event, KFileItem *fileItem); 00231 void dropped(QDropEvent *event, const KURL::List &urls, const KURL &url); 00232 00233 private: 00234 KMimeTypeResolver<KFileIconViewItem,KFileIconView> *m_resolver; 00235 00236 QLabel *toolTip; 00237 int th; 00238 int myIconSize; 00239 00240 virtual void insertItem(QIconViewItem *a, QIconViewItem *b) { KIconView::insertItem(a, b); } 00241 virtual void setSelectionMode(QIconView::SelectionMode m) { KIconView::setSelectionMode(m); } 00242 virtual void setSelected(QIconViewItem *i, bool a, bool b) { KIconView::setSelected(i, a, b); } 00243 00244 bool canPreview( const KFileItem * ) const; 00245 void stopPreview(); 00246 00247 void updateIcons(); 00248 00249 inline KFileIconViewItem * viewItem( const KFileItem *item ) const { 00250 if ( item ) 00251 return (KFileIconViewItem *) item->extraData( this ); 00252 return 0L; 00253 } 00254 00255 void initItem(KFileIconViewItem *item, const KFileItem *i, 00256 bool updateTextAndPixmap ); 00257 00258 protected: 00259 virtual void virtual_hook( int id, void* data ); 00260 private: 00261 class KFileIconViewPrivate; 00262 KFileIconViewPrivate *d; 00263 }; 00264 00265 #endif // KFILESIMPLEVIEW_H
KDE Logo
This file is part of the documentation for kio Library Version 3.4.0.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Tue Apr 12 23:09:12 2005 by doxygen 1.3.7 written by Dimitri van Heesch, © 1997-2003