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 Methods

 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 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 QStringListpreviewSettings ()
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 Methods

virtual QDragObjectdragObject ()
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 ()


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 QString::fromLatin1(), setItemTextPos(), and slotSelectionChanged().


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 QToolTip::isGloballyEnabled(), QColor::isValid(), KonqFMSettings::itemTextBackground(), KonqFMSettings::normalTextColor(), KonqFMSettings::numFileTips(), KonqFMSettings::settings(), QFont::setUnderline(), KonqFMSettings::showFileTips(), KonqFMSettings::showPreviewsInFileTips(), KonqFMSettings::standardFont(), KonqFMSettings::underlineLink(), and KonqFMSettings::wordWrapText().

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.

void KonqIconViewWidget::focusOutEvent QFocusEvent   [virtual]
 

Reimplemented to make the slotOnItem highlighting work.

Definition at line 445 of file konq_iconviewwidget.cc.

QRect KonqIconViewWidget::iconArea   const
 

Returns the icon area.

Definition at line 1295 of file konq_iconviewwidget.cc.

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.

int KonqIconViewWidget::lineupMode   const
 

Returns the lineup mode.

Definition at line 1305 of file konq_iconviewwidget.cc.

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 QValueList::append(), QValueList::begin(), QRect::bottom(), QValueList::count(), QValueList::end(), gridXValue(), QIconViewItem::height(), QRect::isValid(), QRect::left(), QIconViewItem::move(), QIconViewItem::nextItem(), QIconViewItem::pos(), QValueList::remove(), QRect::right(), QIconViewItem::text(), QRect::top(), QIconViewItem::width(), QIconViewItem::x(), and QIconViewItem::y().

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(), QIconViewItem::nextItem(), KFileIVI::setIcon(), and KFileIVI::state().

Referenced by refreshMimeTypes().

void KonqIconViewWidget::refreshMimeTypes  
 

Called on databaseChanged.

Definition at line 960 of file konq_iconviewwidget.cc.

References QIconViewItem::nextItem(), and 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 QPtrList< KFileItem >::append(), QPtrList< KFileItem >::isEmpty(), QIconViewItem::nextItem(), and KonqFMSettings::textPreviewIconTransparency().

KFileItemList KonqIconViewWidget::selectedFileItems  
 

Get list of selected KFileItems.

Definition at line 1062 of file konq_iconviewwidget.cc.

References QPtrList< KFileItem >::append(), QIconViewItem::isSelected(), and QIconViewItem::nextItem().

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.

void KonqIconViewWidget::insertInGrid QIconViewItem   item [virtual]
 

Reimplemented from QIconView to take into account iconArea.

Definition at line 1537 of file konq_iconviewwidget.cc.

References QMemArray::begin(), QMemArray::end(), QRect::height(), QIconViewItem::height(), QIconView::insertInGrid(), QRect::isValid(), QIconViewItem::move(), QIconViewItem::nextItem(), QIconViewItem::rect(), QRegion::rects(), QRegion::subtract(), QRect::topLeft(), QIconViewItem::width(), QRect::width(), QRect::x(), QRect::y(), and QIconViewItem::y().

void KonqIconViewWidget::setItemTextPos ItemTextPos    pos [virtual]
 

Reimplemented from QIconView to update the gridX.

Definition at line 929 of file konq_iconviewwidget.cc.

Referenced by KonqIconViewWidget().

void KonqIconViewWidget::visualActivate QIconViewItem   [virtual]
 

Give feedback when item is activated.

Definition at line 1974 of file konq_iconviewwidget.cc.

References QRect::moveBy(), QIconViewItem::pixmapRect(), QIconViewItem::rect(), QRect::x(), and QRect::y().

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

Provided for KDesktop.

Definition at line 206 of file konq_iconviewwidget.h.

void KonqIconViewWidget::slotSelectionChanged   [virtual, slot]
 

Checks the new selection and emits enableAction() signals.

Definition at line 1209 of file konq_iconviewwidget.cc.

References enableAction(), QIconViewItem::isSelected(), QIconViewItem::nextItem(), 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.

References QPainter::drawTiledPixmap(), QPainter::fillRect(), QPixmap::height(), QPixmap::isNull(), QRect::moveTopLeft(), QPixmap::width(), QRect::x(), and QRect::y().


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 Apr 29 21:20:30 2004 by doxygen 1.2.15 written by Dimitri van Heesch, © 1997-2003