You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdelibs/kio/kfile/kfileiconview.h

266 lines
7.4 KiB

// -*- 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>
/**
* An item for the iconview, that has a reference to its corresponding
* KFileItem.
*/
class KIO_EXPORT KFileIconViewItem : public KIconViewItem
{
public:
KFileIconViewItem( QIconView *parent, const QString &text,
const QPixmap &pixmap,
KFileItem *fi )
: KIconViewItem( parent, text, pixmap ), inf( fi ) {}
/**
* @since 3.1
*/
KFileIconViewItem( QIconView *parent, KFileItem *fi )
: KIconViewItem( parent ), inf( fi ) {}
virtual ~KFileIconViewItem();
/**
* @returns the corresponding KFileItem
*/
KFileItem *fileInfo() const {
return inf;
}
private:
KFileItem *inf;
private:
class KFileIconViewItemPrivate;
KFileIconViewItemPrivate *d;
};
namespace KIO {
class Job;
}
/**
* An icon-view capable of showing KFileItem's. Used in the filedialog
* for example. Most of the documentation is in KFileView class.
*
* @see KDirOperator
* @see KCombiView
* @see KFileDetailView
*/
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;
/**
* Sets the size of the icons to show. Defaults to KIcon::SizeSmall.
*/
void setIconSize( int size );
/**
* Sets the size of the previews. Defaults to KIcon::SizeLarge.
*/
void setPreviewSize( int size );
/**
* Disables the "Maximum file size" configuration option for previews
*
* Set this before calling showPreviews()
*
* @since 3.4
**/
void setIgnoreMaximumSize(bool ignoreSize=true);
/**
* @returns the current size used for icons.
*/
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:
/**
* Starts loading previews for all files shown and shows them. Switches
* into 'large rows' mode, if that isn't the current mode yet.
*
* @sa setIgnoreMaximumSize
*/
void showPreviews();
void zoomIn();
void zoomOut();
/**
* Reimplemented for performance reasons.
* @since 3.1
*/
virtual void arrangeItemsInGrid( bool updated = true );
protected:
/**
* Reimplemented to not let QIconView eat return-key events
*/
virtual void keyPressEvent( QKeyEvent * );
/**
* Reimplemented to remove an eventual tooltip
*/
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:
/**
* The user dropped something.
* @p fileItem points to the item dropped on or can be 0 if the
* user dropped on empty space.
* @since 3.2
*/
void dropped(QDropEvent *event, KFileItem *fileItem);
/**
* The user dropped the URLs @p urls.
* @p url points to the item dropped on or can be empty if the
* user dropped on empty space.
* @since 3.2
*/
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