libkonq Library API Documentation

KonqIconViewWidget Class Reference

A file-aware icon view, implementing drag'n'drop, KDE icon sizes, user settings, animated icons... More...

#include <konq_iconviewwidget.h>

List of all members.

Public Types

enum  LineupMode { LineupHorizontal = 1, LineupVertical, LineupBoth }

Public Slots

virtual void slotSelectionChanged ()
void slotSaveIconPositions ()
void renameSelectedItem ()
void slotToolTipPreview (const KFileItem *, const QPixmap &)
void slotToolTipPreviewResult ()

Signals

void enableAction (const char *name, bool enabled)
void dropped ()
void imagePreviewFinished ()
void incIconSize ()
void decIconSize ()

Public Member Functions

 KonqIconViewWidget (QWidget *parent=0L, const char *name=0L, WFlags f=0, bool kdesktop=FALSE)
bool initConfig (bool bInit)
void setIconArea (const QRect &rect)
virtual void focusOutEvent (QFocusEvent *)
QRect iconArea () const
void setLineupMode (int mode)
int lineupMode () const
void lineupIcons ()
void setIcons (int size, const QStringList &stopImagePreviewFor=QStringList())
void refreshMimeTypes ()
int iconSize ()
void calculateGridX ()
int gridXValue () const
void startImagePreview (const QStringList &ignored, bool force)
void stopImagePreview ()
bool isPreviewRunning () const
void setThumbnailPixmap (KFileIVI *item, const QPixmap &pixmap)
void disableSoundPreviews ()
void setURL (const KURL &kurl)
const KURL & url ()
QString urlString () const
void setRootItem (const KFileItem *item)
KFileItemList selectedFileItems ()
void setItemColor (const QColor &c)
QColor itemColor () const
virtual void cutSelection ()
virtual void copySelection ()
virtual void pasteSelection ()
virtual KURL::List selectedUrls ()
void paste (const KURL &url)
bool sortDirectoriesFirst () const
void setSortDirectoriesFirst (bool b)
void setCaseInsensitiveSort (bool b)
bool caseInsensitiveSort () const
const KURL::List & dragURLs ()
virtual void clear ()
virtual void takeItem (QIconViewItem *item)
virtual void insertInGrid (QIconViewItem *item)
virtual void setItemTextPos (ItemTextPos pos)
virtual void visualActivate (QIconViewItem *)
bool isDesktop () const
virtual void setWallpaper (const KURL &)
bool maySetWallpaper ()
void setMaySetWallpaper (bool b)
void disableIcons (const KURL::List &lst)
QString iconPositionGroupPrefix () const
QString dotDirectoryPath () const
void setPreviewSettings (const QStringList &mimeTypes)
const QStringList & previewSettings ()
void setNewURL (const QString &url)

Protected Slots

virtual void slotDropped (QDropEvent *e, const QValueList< QIconDragItem > &)
void slotItemRenamed (QIconViewItem *item, const QString &name)
void slotIconChanged (int)
void slotOnItem (QIconViewItem *)
void slotOnViewport ()
void slotStartSoundPreview ()
void slotPreview (const KFileItem *, const QPixmap &)
void slotPreviewResult ()
void slotMovieUpdate (const QRect &rect)
void slotMovieStatus (int status)
void slotReenableAnimation ()
void slotAboutToCreate (const QPoint &pos, const QValueList< KIO::CopyInfo > &files)
void doubleClickTimeout ()

Protected Member Functions

virtual QDragObject * dragObject ()
KonqIconDrag * konqDragObject (QWidget *dragSource=0L)
bool mimeTypeMatch (const QString &mimeType, const QStringList &mimeList) const
virtual void drawBackground (QPainter *p, const QRect &r)
virtual void drawBackground (QPainter *p, const QRect &r, const QPoint &pt)
virtual void contentsDragEnterEvent (QDragEnterEvent *e)
virtual void contentsDropEvent (QDropEvent *e)
virtual void contentsMousePressEvent (QMouseEvent *e)
virtual void contentsMouseReleaseEvent (QMouseEvent *e)
virtual void contentsMouseMoveEvent (QMouseEvent *e)
virtual void backgroundPixmapChange (const QPixmap &)
virtual void wheelEvent (QWheelEvent *)
void readAnimatedIconsConfig ()
void mousePressChangeValue ()

Properties

bool sortDirectoriesFirst
QRect iconArea
int lineupMode
QString url


Detailed Description

A file-aware icon view, implementing drag'n'drop, KDE icon sizes, user settings, animated icons...

Used by kdesktop and konq_iconview.

Definition at line 41 of file konq_iconviewwidget.h.


Constructor & Destructor Documentation

KonqIconViewWidget::KonqIconViewWidget QWidget *  parent = 0L,
const char *  name = 0L,
WFlags  f = 0,
bool  kdesktop = FALSE
 

Constructor.

Parameters:
settings An instance of KonqFMSettings, see static methods in konq_settings.h

Definition at line 387 of file konq_iconviewwidget.cc.

References KonqIconViewWidget(), setItemTextPos(), and slotSelectionChanged().

Referenced by KonqIconViewWidget().


Member Function Documentation

bool KonqIconViewWidget::initConfig bool  bInit  ) 
 

Read the configuration and apply it.

Call this in the inherited constructor with bInit=true, and in some reparseConfiguration() slot with bInit=false. Returns true if the font was changed (which means something has to be done so that the icon's texts don't run into each other). However Konq and KDesktop handle this differently.

Definition at line 821 of file konq_iconviewwidget.cc.

References initConfig(), KonqFMSettings::itemTextBackground(), KonqFMSettings::normalTextColor(), KonqFMSettings::numFileTips(), KonqFMSettings::settings(), KonqFMSettings::showFileTips(), KonqFMSettings::showPreviewsInFileTips(), KonqFMSettings::standardFont(), KonqFMSettings::underlineLink(), and KonqFMSettings::wordWrapText().

Referenced by initConfig().

void KonqIconViewWidget::setIconArea const QRect &  rect  ) 
 

Set the area that will be occupied by icons.

It is still possible to drag icons outside this area; this only applies to automatically placed icons.

Definition at line 1300 of file konq_iconviewwidget.cc.

References setIconArea().

Referenced by setIconArea().

void KonqIconViewWidget::focusOutEvent QFocusEvent *   )  [virtual]
 

Reimplemented to make the slotOnItem highlighting work.

Definition at line 445 of file konq_iconviewwidget.cc.

References focusOutEvent().

Referenced by focusOutEvent().

QRect KonqIconViewWidget::iconArea  )  const
 

Returns the icon area.

void KonqIconViewWidget::setLineupMode int  mode  ) 
 

Set the lineup mode.

This determines in which direction(s) icons are moved when lineing them up.

Definition at line 1310 of file konq_iconviewwidget.cc.

References setLineupMode().

Referenced by setLineupMode().

int KonqIconViewWidget::lineupMode  )  const
 

Returns the lineup mode.

void KonqIconViewWidget::lineupIcons  ) 
 

Line up the icons to a regular grid.

The outline of the grid is specified by iconArea. The two length parameters are gridX and gridY.

Definition at line 1716 of file konq_iconviewwidget.cc.

References gridXValue().

void KonqIconViewWidget::setIcons int  size,
const QStringList &  stopImagePreviewFor = QStringList()
 

Sets the icons of all items, and stores the size This doesn't touch thumbnails, except if stopImagePreviewFor is set.

Takes care of the grid, when changing the size.

Parameters:
stopImagePreviewFor set to a list of mimetypes which should be made normal again. For instance "text/plain,image/wmf". Can be set to "*" for "all mimetypes" and to "image/"+"*" for "all images".

Definition at line 877 of file konq_iconviewwidget.cc.

References KFileIVI::invalidateThumb(), KFileIVI::isThumbnail(), KFileIVI::item(), KFileIVI::setIcon(), setIcons(), and KFileIVI::state().

Referenced by refreshMimeTypes(), and setIcons().

void KonqIconViewWidget::refreshMimeTypes  ) 
 

Called on databaseChanged.

Definition at line 960 of file konq_iconviewwidget.cc.

References setIcons().

int KonqIconViewWidget::gridXValue  )  const
 

The horizontal distance between two icons (whether or not a grid has been given to QIconView).

Definition at line 952 of file konq_iconviewwidget.cc.

Referenced by lineupIcons().

void KonqIconViewWidget::startImagePreview const QStringList &  ignored,
bool  force
 

Start generating the previews.

Parameters:
previewSettings 
force if true, all files are looked at. Otherwise, only those which are not a thumbnail already.

Definition at line 980 of file konq_iconviewwidget.cc.

References startImagePreview(), and KonqFMSettings::textPreviewIconTransparency().

Referenced by startImagePreview().

KFileItemList KonqIconViewWidget::selectedFileItems  ) 
 

Get list of selected KFileItems.

Definition at line 1062 of file konq_iconviewwidget.cc.

Referenced by slotSelectionChanged().

const KURL::List& KonqIconViewWidget::dragURLs  )  [inline]
 

Cache of the dragged URLs over the icon view, used by KFileIVI.

Definition at line 174 of file konq_iconviewwidget.h.

void KonqIconViewWidget::clear  )  [virtual]
 

Reimplemented from QIconView.

Definition at line 779 of file konq_iconviewwidget.cc.

void KonqIconViewWidget::takeItem QIconViewItem *  item  )  [virtual]
 

Reimplemented from QIconView.

Definition at line 787 of file konq_iconviewwidget.cc.

References takeItem().

Referenced by takeItem().

void KonqIconViewWidget::insertInGrid QIconViewItem *  item  )  [virtual]
 

Reimplemented from QIconView to take into account iconArea.

Definition at line 1537 of file konq_iconviewwidget.cc.

References insertInGrid().

Referenced by insertInGrid().

void KonqIconViewWidget::setItemTextPos ItemTextPos  pos  )  [virtual]
 

Reimplemented from QIconView to update the gridX.

Definition at line 929 of file konq_iconviewwidget.cc.

References setItemTextPos().

Referenced by KonqIconViewWidget(), and setItemTextPos().

void KonqIconViewWidget::visualActivate QIconViewItem *   )  [virtual]
 

Give feedback when item is activated.

Definition at line 1974 of file konq_iconviewwidget.cc.

References visualActivate().

Referenced by visualActivate().

virtual void KonqIconViewWidget::setWallpaper const KURL &   )  [inline, virtual]
 

Provided for KDesktop.

Definition at line 206 of file konq_iconviewwidget.h.

References setWallpaper().

Referenced by setWallpaper().

void KonqIconViewWidget::slotSelectionChanged  )  [virtual, slot]
 

Checks the new selection and emits enableAction() signals.

Definition at line 1209 of file konq_iconviewwidget.cc.

References enableAction(), and selectedFileItems().

Referenced by KonqIconViewWidget().

void KonqIconViewWidget::enableAction const char *  name,
bool  enabled
[signal]
 

For cut/copy/paste/move/delete (see kparts/browserextension.h).

Referenced by slotSelectionChanged().

void KonqIconViewWidget::drawBackground QPainter *  p,
const QRect &  r,
const QPoint &  pt
[protected, virtual]
 

r is the rectangle which you want to paint from the background.

pt is the upper left point in the painter device where you want to paint the rectangle r.

Definition at line 1098 of file konq_iconviewwidget.cc.


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for libkonq Library Version 3.2.2.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Thu Dec 16 19:08:35 2004 by doxygen 1.3.7 written by Dimitri van Heesch, © 1997-2003