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 ) {} // ### unused. remove in KDE4 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 void setAcceptDrops(bool b) 00142 { 00143 KIconView::setAcceptDrops(b); 00144 viewport()->setAcceptDrops(b); 00145 } 00146 00147 public slots: 00152 void showPreviews(); 00153 00154 void zoomIn(); 00155 00156 void zoomOut(); 00157 00162 virtual void arrangeItemsInGrid( bool updated = true ); 00163 00164 protected: 00168 virtual void keyPressEvent( QKeyEvent * ); 00169 00173 virtual void hideEvent( QHideEvent * ); 00174 00175 // ### workaround for Qt3 bug (see #35080) 00176 virtual void showEvent( QShowEvent * ); 00177 00178 virtual bool eventFilter( QObject *o, QEvent *e ); 00179 00180 // DND support 00181 virtual QDragObject *dragObject(); 00182 virtual void contentsDragEnterEvent( QDragEnterEvent *e ); 00183 virtual void contentsDragMoveEvent( QDragMoveEvent *e ); 00184 virtual void contentsDragLeaveEvent( QDragLeaveEvent *e ); 00185 virtual void contentsDropEvent( QDropEvent *ev ); 00186 00187 // KDE4: Make virtual 00188 bool acceptDrag(QDropEvent* e ) const; 00189 00190 private slots: 00191 void selected( QIconViewItem *item ); 00192 void slotActivate( QIconViewItem * ); 00193 void highlighted( QIconViewItem *item ); 00194 void showToolTip( QIconViewItem *item ); 00195 void removeToolTip(); 00196 void slotActivateMenu( QIconViewItem *, const QPoint& ); 00197 void slotSelectionChanged(); 00198 00199 void slotSmallColumns(); 00200 void slotLargeRows(); 00201 void slotPreviewsToggled( bool ); 00202 00203 void slotPreviewResult( KIO::Job * ); 00204 void gotPreview( const KFileItem *item, const QPixmap& pix ); 00205 void slotAutoOpen(); 00206 00207 signals: 00214 void dropped(QDropEvent *event, KFileItem *fileItem); 00221 void dropped(QDropEvent *event, const KURL::List &urls, const KURL &url); 00222 00223 private: 00224 KMimeTypeResolver<KFileIconViewItem,KFileIconView> *m_resolver; 00225 00226 QLabel *toolTip; 00227 int th; 00228 int myIconSize; 00229 00230 virtual void insertItem(QIconViewItem *a, QIconViewItem *b) { KIconView::insertItem(a, b); } 00231 virtual void setSelectionMode(QIconView::SelectionMode m) { KIconView::setSelectionMode(m); } 00232 virtual void setSelected(QIconViewItem *i, bool a, bool b) { KIconView::setSelected(i, a, b); } 00233 00234 bool canPreview( const KFileItem * ) const; 00235 int iconSizeFor( const KFileItem * ) const; 00236 void stopPreview(); 00237 00238 void updateIcons(); 00239 00240 inline KFileIconViewItem * viewItem( const KFileItem *item ) const { 00241 if ( item ) 00242 return (KFileIconViewItem *) item->extraData( this ); 00243 return 0L; 00244 } 00245 00246 void initItem(KFileIconViewItem *item, const KFileItem *i, 00247 bool updateTextAndPixmap ); 00248 00249 protected: 00250 virtual void virtual_hook( int id, void* data ); 00251 private: 00252 class KFileIconViewPrivate; 00253 KFileIconViewPrivate *d; 00254 }; 00255 00256 #endif // KFILESIMPLEVIEW_H
KDE Logo
This file is part of the documentation for kio Library Version 3.2.3.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Fri Oct 8 11:14:57 2004 by doxygen 1.3.7 written by Dimitri van Heesch, © 1997-2003