kfileiconview.h
// -*- c++ -*-
/* This file is part of the KDE libraries
Copyright (C) 1997 Stephan Kulow <coolo@kde.org>
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 KFILEICONVIEW_H
#define KFILEICONVIEW_H
class KFileItem;
class QWidget;
class QLabel;
#include <kiconview.h>
#include <kiconloader.h>
#include <kfileview.h>
#include <kmimetyperesolver.h>
#include <kfile.h>
class KIO_EXPORT KFileIconViewItem : public KIconViewItem
{
public:
KFileIconViewItem( QIconView *parent, const QString &text,
const QPixmap &pixmap,
KFileItem *fi )
: KIconViewItem( parent, text, pixmap ), inf( fi ) {}
KFileIconViewItem( QIconView *parent, KFileItem *fi )
: KIconViewItem( parent ), inf( fi ) {}
virtual ~KFileIconViewItem();
KFileItem *fileInfo() const {
return inf;
}
private:
KFileItem *inf;
private:
class KFileIconViewItemPrivate;
KFileIconViewItemPrivate *d;
};
namespace KIO {
class Job;
}
class KIO_EXPORT KFileIconView : public KIconView, public KFileView
{
Q_OBJECT
public:
KFileIconView(QWidget *parent, const char *name);
virtual ~KFileIconView();
virtual QWidget *widget() { return this; }
virtual void clearView();
virtual void setAutoUpdate( bool ) {} // ### unused. remove in KDE4
virtual void updateView( bool );
virtual void updateView(const KFileItem*);
virtual void removeItem(const KFileItem*);
virtual void listingCompleted();
virtual void insertItem( KFileItem *i );
virtual void setSelectionMode( KFile::SelectionMode sm );
virtual void setSelected(const KFileItem *, bool);
virtual bool isSelected(const KFileItem *i) 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;
void setIconSize( int size );
void setPreviewSize( int size );
void setIgnoreMaximumSize(bool ignoreSize=true);
int iconSize() const { return myIconSize; }
void ensureItemVisible( const KFileItem * );
virtual void setSorting(QDir::SortSpec sort);
virtual void readConfig( KConfig *, const QString& group = QString::null );
virtual void writeConfig( KConfig *, const QString& group = QString::null);
// for KMimeTypeResolver
void mimeTypeDeterminationFinished();
void determineIcon( KFileIconViewItem *item );
QScrollView *scrollWidget() const { return (QScrollView*) this; }
void setAcceptDrops(bool b)
{
KIconView::setAcceptDrops(b);
viewport()->setAcceptDrops(b);
}
public slots:
void showPreviews();
void zoomIn();
void zoomOut();
virtual void arrangeItemsInGrid( bool updated = true );
protected:
virtual void keyPressEvent( QKeyEvent * );
virtual void hideEvent( QHideEvent * );
// ### workaround for Qt3 bug (see #35080)
virtual void showEvent( QShowEvent * );
virtual bool eventFilter( QObject *o, QEvent *e );
// DND support
virtual QDragObject *dragObject();
virtual void contentsDragEnterEvent( QDragEnterEvent *e );
virtual void contentsDragMoveEvent( QDragMoveEvent *e );
virtual void contentsDragLeaveEvent( QDragLeaveEvent *e );
virtual void contentsDropEvent( QDropEvent *ev );
// KDE4: Make virtual
bool acceptDrag(QDropEvent* e ) const;
private slots:
void selected( QIconViewItem *item );
void slotActivate( QIconViewItem * );
void highlighted( QIconViewItem *item );
void showToolTip( QIconViewItem *item );
void removeToolTip();
void slotActivateMenu( QIconViewItem *, const QPoint& );
void slotSelectionChanged();
void slotSmallColumns();
void slotLargeRows();
void slotPreviewsToggled( bool );
void slotPreviewResult( KIO::Job * );
void gotPreview( const KFileItem *item, const QPixmap& pix );
void slotAutoOpen();
signals:
void dropped(QDropEvent *event, KFileItem *fileItem);
void dropped(QDropEvent *event, const KURL::List &urls, const KURL &url);
private:
KMimeTypeResolver<KFileIconViewItem,KFileIconView> *m_resolver;
QLabel *toolTip;
int th;
int myIconSize;
virtual void insertItem(QIconViewItem *a, QIconViewItem *b) { KIconView::insertItem(a, b); }
virtual void setSelectionMode(QIconView::SelectionMode m) { KIconView::setSelectionMode(m); }
virtual void setSelected(QIconViewItem *i, bool a, bool b) { KIconView::setSelected(i, a, b); }
bool canPreview( const KFileItem * ) const;
void stopPreview();
void updateIcons();
inline KFileIconViewItem * viewItem( const KFileItem *item ) const {
if ( item )
return (KFileIconViewItem *) item->extraData( this );
return 0L;
}
void initItem(KFileIconViewItem *item, const KFileItem *i,
bool updateTextAndPixmap );
protected:
virtual void virtual_hook( int id, void* data );
private:
class KFileIconViewPrivate;
KFileIconViewPrivate *d;
};
#endif // KFILESIMPLEVIEW_H
KFileIconViewItem
An item for the iconview, that has a reference to its corresponding KFileItem.
Definition: kfileiconview.h:38
KFileView::insertItem
virtual void insertItem(KFileItem *i)
The derived view must implement this function to add the file in the widget.
Definition: kfileview.cpp:147
KFileView
This class defines an interface to all file views.
Definition: kfileview.h:98
KFileIconView::widget
virtual QWidget * widget()
a pure virtual function to get a QWidget, that can be added to other widgets.
Definition: kfileiconview.h:89
KFileView::clearSelection
virtual void clearSelection()=0
Clears any selection, unhighlights everything.
KFileView::selectAll
virtual void selectAll()
Selects all items.
Definition: kfileview.cpp:312
KFileView::currentFileItem
virtual KFileItem * currentFileItem() const =0
KFileView::setSelected
virtual void setSelected(const KFileItem *, bool enable)=0
Tells the view that it should highlight the item.
KFileView::setSorting
virtual void setSorting(QDir::SortSpec sort)
Sets the sorting order of the view.
Definition: kfileview.cpp:151
KFileIconView::iconSize
int iconSize() const
Definition: kfileiconview.h:136
KFileView::isSelected
virtual bool isSelected(const KFileItem *) const =0
KFileView::removeItem
virtual void removeItem(const KFileItem *item)
Removes an item from the list; has to be implemented by the view.
Definition: kfileview.cpp:346
KFileView::invertSelection
virtual void invertSelection()
Inverts the current selection, i.e.
Definition: kfileview.cpp:323
KFileIconViewItem::fileInfo
KFileItem * fileInfo() const
Definition: kfileiconview.h:56
KFileView::updateView
virtual void updateView(bool f=true)
does a repaint of the view.
Definition: kfileview.cpp:259
KFileView::ensureItemVisible
virtual void ensureItemVisible(const KFileItem *i)=0
pure virtual function, that should be implemented to make item i visible, i.e.
KFileView::clearView
virtual void clearView()=0
pure virtual function, that should be implemented to clear the view.
KFileIconView
An icon-view capable of showing KFileItem's.
Definition: kfileiconview.h:81
KFileView::listingCompleted
virtual void listingCompleted()
This hook is called when all items of the currently listed directory are listed and inserted into the...
Definition: kfileview.cpp:360
KFileView::setCurrentItem
void setCurrentItem(const QString &filename)
Sets filename the current item in the view, if available.
Definition: kfileview.cpp:268
KFileIconViewItem::KFileIconViewItem
KFileIconViewItem(QIconView *parent, KFileItem *fi)
Definition: kfileiconview.h:48

KDE Home | KDE Accessibility Home | Description of Access Keys