KonqIconViewWidget Class Reference

#include <konq_iconviewwidget.h>

List of all members.


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 42 of file konq_iconviewwidget.h.


Public Types

enum  LineupMode { LineupHorizontal = 1, LineupVertical, LineupBoth }
enum  UrlFlags { UserVisibleUrls = 0, MostLocalUrls = 1 }

Public Slots

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

Signals

void enableAction (const char *name, bool enabled)
void dropped ()
void imagePreviewFinished ()
void incIconSize ()
void decIconSize ()
void dragEntered (bool accepted)
void dragLeft ()
void dragMove (bool accepted)
void dragFinished ()

Public Member Functions

 KonqIconViewWidget (QWidget *parent=0L, const char *name=0L, WFlags f=0, bool kdesktop=FALSE)
virtual ~KonqIconViewWidget ()
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 lineupIcons (QIconView::Arrangement arrangement)
void setIcons (int size, const QStringList &stopImagePreviewFor=QStringList())
void refreshMimeTypes ()
int iconSize ()
void calculateGridX ()
int gridXValue () const
void gridValues (int *x, int *y, int *dx, int *dy, int *nx, int *ny)
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 ()
KURL::List selectedUrls (UrlFlags flags) const
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 ()
KonqIconDragkonqDragObject (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 contentsDragLeaveEvent (QDragLeaveEvent *e)
virtual void contentsDragMoveEvent (QDragMoveEvent *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 *)
virtual void leaveEvent (QEvent *e)
void readAnimatedIconsConfig ()
void mousePressChangeValue ()
bool boostPreview () const
int previewIconSize (int size) const
int largestPreviewIconSize (int size) const
bool canPreview (KFileItem *item)
void updatePreviewMimeTypes ()

Properties

bool sortDirectoriesFirst []
QRect iconArea []
int lineupMode []
QString url []

Friends

class KFileIVI

Constructor & Destructor Documentation

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

Constructor.

Definition at line 117 of file konq_iconviewwidget.cc.


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 550 of file konq_iconviewwidget.cc.

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 1196 of file konq_iconviewwidget.cc.

void KonqIconViewWidget::focusOutEvent ( QFocusEvent *   )  [virtual]

Reimplemented to make the slotOnItem highlighting work.

Definition at line 175 of file konq_iconviewwidget.cc.

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 1206 of file konq_iconviewwidget.cc.

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 1549 of file konq_iconviewwidget.cc.

void KonqIconViewWidget::lineupIcons ( QIconView::Arrangement  arrangement  ) 

Line up the icons to a regular grid horizontally or vertically.

Parameters:
arrangement the arrangement to use (QIconView::LeftToRight for a horizontal arrangement and QIconView::TopToBottom for vertical)

Definition at line 1761 of file konq_iconviewwidget.cc.

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:
size size to use for the icons
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 625 of file konq_iconviewwidget.cc.

void KonqIconViewWidget::refreshMimeTypes (  ) 

Called on databaseChanged.

Definition at line 805 of file konq_iconviewwidget.cc.

int KonqIconViewWidget::gridXValue (  )  const

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

Definition at line 790 of file konq_iconviewwidget.cc.

void KonqIconViewWidget::gridValues ( int *  x,
int *  y,
int *  dx,
int *  dy,
int *  nx,
int *  ny 
)

Calculate the geometry of the fixed grid that is used to line up the icons, for example when using the lineupIcons() method.

Parameters:
x 
y 
dx Cell width
dy Cell height
nx Number of columns
ny Number of rows

Definition at line 724 of file konq_iconviewwidget.cc.

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

Start generating the previews.

Parameters:
ignored this parameter is probably ignored
force if true, all files are looked at. Otherwise, only those which are not a thumbnail already.
Todo:
figure out the parameter meanings again

Definition at line 826 of file konq_iconviewwidget.cc.

KFileItemList KonqIconViewWidget::selectedFileItems (  ) 

Get list of selected KFileItems.

Definition at line 899 of file konq_iconviewwidget.cc.

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

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

Definition at line 201 of file konq_iconviewwidget.h.

void KonqIconViewWidget::clear (  )  [virtual]

Reimplemented from QIconView.

Definition at line 508 of file konq_iconviewwidget.cc.

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

Reimplemented from QIconView.

Definition at line 516 of file konq_iconviewwidget.cc.

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

Reimplemented from QIconView to take into account iconArea.

Definition at line 1475 of file konq_iconviewwidget.cc.

void KonqIconViewWidget::setItemTextPos ( ItemTextPos  pos  )  [virtual]

Reimplemented from QIconView to update the gridX.

Definition at line 707 of file konq_iconviewwidget.cc.

void KonqIconViewWidget::visualActivate ( QIconViewItem *   )  [virtual]

Give feedback when item is activated.

Definition at line 1840 of file konq_iconviewwidget.cc.

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

Provided for KDesktop.

Definition at line 233 of file konq_iconviewwidget.h.

void KonqIconViewWidget::slotSelectionChanged (  )  [virtual, slot]

Checks the new selection and emits enableAction() signals.

Definition at line 1086 of file konq_iconviewwidget.cc.

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

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

void KonqIconViewWidget::dragEntered ( bool  accepted  )  [signal]

We need to track drag in icon views for the spring loading folders.

void KonqIconViewWidget::dragFinished (  )  [signal]

Emited after the dropped() event.

This way we know when the drag'n'drop is really finished.

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 933 of file konq_iconviewwidget.cc.


The documentation for this class was generated from the following files:
KDE Home | KDE Accessibility Home | Description of Access Keys