KFileIVI Class Reference

#include <tdefileivi.h>

Inherits TDEIconViewItem.

Public Member Functions
	KFileIVI (KonqIconViewWidget *iconview, KFileItem *fileitem, int size)
virtual void	returnPressed ()
KFileItem *	item () const
virtual bool	acceptDrop (const TQMimeSource *mime) const
virtual void	setIcon (int size, int state=TDEIcon::DefaultState, bool recalc=false, bool redraw=false)
void	setPixmapDirect (const TQPixmap &pixmap, bool recalc=false, bool redraw=false)
void	invalidateThumb (int state, bool redraw=false)
void	invalidateThumbnail ()
bool	isThumbnailInvalid () const
bool	hasValidThumbnail () const
int	state () const
int	iconSize () const
void	setDisabled (bool disabled)
void	setThumbnailPixmap (const TQPixmap &pixmap)
void	setEffect (int state)
bool	isThumbnail () const
void	setOverlay (const TQString &iconName)
void	setOverlayProgressBar (const int progress)
virtual void	refreshIcon (bool redraw)
virtual void	setKey (const TQString &key)
virtual void	paintItem (TQPainter *p, const TQColorGroup &cg)
virtual bool	move (int x, int y)
void	setMouseOverAnimation (const TQString &movieFileName)
TQString	mouseOverAnimation () const
bool	hasAnimation () const
bool	isAnimated () const
void	setAnimated (bool)
void	setActive (bool active)
KIVDirectoryOverlay *	setShowDirectoryOverlay (bool)
bool	showDirectoryOverlay ()
KIVFreeSpaceOverlay *	setShowFreeSpaceOverlay (bool)
bool	showFreeSpaceOverlay ()
virtual int	compare (TQIconViewItem *i) const
void	mimeTypeAndIconDetermined ()

Protected Member Functions
virtual void	dropped (TQDropEvent *e, const TQValueList< TQIconDragItem > &)
void	paintOverlay (TQPainter *p) const
void	paintOverlayProgressBar (TQPainter *p) const
TQColorGroup	updateColors (const TQColorGroup &c) const
void	paintFontUpdate (TQPainter *p) const

Detailed Description

KFileIVI (short form of "Konq - File - IconViewItem") is, as expected, an improved TDEIconViewItem, because it represents a file.

All the information about the file is contained in the KFileItem pointer.

Definition at line 39 of file tdefileivi.h.

Constructor & Destructor Documentation

KFileIVI()

KFileIVI::KFileIVI	(	KonqIconViewWidget *	iconview,
		KFileItem *	fileitem,
		int	size
	)

Create an icon, within a qlistview, representing a file.

Parameters

iconview	the parent widget
fileitem	the file item created by KDirLister
size	the icon size

Definition at line 57 of file tdefileivi.cpp.

~KFileIVI()

KFileIVI::~KFileIVI ( )

virtual

Definition at line 86 of file tdefileivi.cpp.

Member Function Documentation

acceptDrop()

bool KFileIVI::acceptDrop ( const TQMimeSource *  mime ) const

virtual

Returns

true if dropping on this file is allowed Overloads TQIconView::acceptDrop()

Definition at line 338 of file tdefileivi.cpp.

compare()

int KFileIVI::compare ( TQIconViewItem *  i ) const

virtual

Definition at line 569 of file tdefileivi.cpp.

dropped()

void KFileIVI::dropped ( TQDropEvent *  e, const TQValueList< TQIconDragItem > &    )

protectedvirtual

Definition at line 381 of file tdefileivi.cpp.

hasAnimation()

bool KFileIVI::hasAnimation

(

)

const

Return true if the icon might have an animation available.

This doesn't mean the .mng exists (only determined when hovering on the icon - and if it doesn't exist setMouseOverAnimation(TQString::null) is called), and it doesn't mean that it's currently running either.

Definition at line 540 of file tdefileivi.cpp.

hasValidThumbnail()

bool KFileIVI::hasValidThumbnail ( ) const

inline

Definition at line 108 of file tdefileivi.h.

iconSize()

int KFileIVI::iconSize ( ) const

inline

Return the theorical size of the icon.

Definition at line 119 of file tdefileivi.h.

invalidateThumb()

void KFileIVI::invalidateThumb	(	int	state,
		bool	redraw = false
	)

Notifies that all icon effects on thumbs should be invalidated, e.g.

because the effect settings have been changed. The thumb itself is assumed to be still valid (use setThumbnailPixmap() instead otherwise).

Parameters

state	the state of the icon (enum in TDEIcon)
redraw	whether to redraw the item after setting the icon

Definition at line 93 of file tdefileivi.cpp.

invalidateThumbnail()

void KFileIVI::invalidateThumbnail

(

)

Our current thumbnail is not longer "current".

Called when the file contents have changed.

Definition at line 328 of file tdefileivi.cpp.

isAnimated()

bool KFileIVI::isAnimated

(

)

const

Return true if we are currently animating this icon.

Definition at line 559 of file tdefileivi.cpp.

isThumbnail()

bool KFileIVI::isThumbnail ( ) const

inline

Returns

true if this item is a thumbnail

Definition at line 140 of file tdefileivi.h.

isThumbnailInvalid()

bool KFileIVI::isThumbnailInvalid

(

)

const

Definition at line 333 of file tdefileivi.cpp.

item()

KFileItem * KFileIVI::item ( ) const

inline

Returns

the file item held by this instance

Definition at line 60 of file tdefileivi.h.

mimeTypeAndIconDetermined()

void KFileIVI::mimeTypeAndIconDetermined

(

)

Definition at line 618 of file tdefileivi.cpp.

mouseOverAnimation()

TQString KFileIVI::mouseOverAnimation

(

)

const

Definition at line 554 of file tdefileivi.cpp.

move()

bool KFileIVI::move ( int  x, int  y  )

virtual

Definition at line 525 of file tdefileivi.cpp.

paintFontUpdate()

void KFileIVI::paintFontUpdate ( TQPainter *  p ) const

protected

Contains the logic and code for painting links.

Definition at line 508 of file tdefileivi.cpp.

paintItem()

void KFileIVI::paintItem ( TQPainter *  p, const TQColorGroup &  cg  )

virtual

Paints this item.

Takes care of using the normal or alpha blending methods depending on the configuration.

Definition at line 430 of file tdefileivi.cpp.

paintOverlay()

void KFileIVI::paintOverlay ( TQPainter *  p ) const

protected

Contains the logic and code for painting the overlay pixmap.

Definition at line 450 of file tdefileivi.cpp.

paintOverlayProgressBar()

void KFileIVI::paintOverlayProgressBar ( TQPainter *  p ) const

protected

Contains the logic and code for painting the overlay progress bar.

Definition at line 458 of file tdefileivi.cpp.

refreshIcon()

void KFileIVI::refreshIcon ( bool  redraw )

virtual

Redetermines the icon (useful if KFileItem might return another icon).

Does nothing with thumbnails

Definition at line 321 of file tdefileivi.cpp.

returnPressed()

void KFileIVI::returnPressed ( )

virtual

Handler for return (or single/double click) on ONE icon.

Runs the file through KRun.

Definition at line 386 of file tdefileivi.cpp.

setActive()

void KFileIVI::setActive

(

bool

active

)

Called when the mouse is over the icon.

Definition at line 260 of file tdefileivi.cpp.

setAnimated()

void KFileIVI::setAnimated

(

bool

a

)

Definition at line 564 of file tdefileivi.cpp.

setDisabled()

void KFileIVI::setDisabled

(

bool

disabled

)

Set to true when this icon is 'cut'.

Definition at line 230 of file tdefileivi.cpp.

setEffect()

void KFileIVI::setEffect

(

int

state

)

Set the icon to use the specified TDEIconEffect See the docs for TDEIconEffect for details.

Definition at line 268 of file tdefileivi.cpp.

setIcon()

void KFileIVI::setIcon ( int  size, int  state = TDEIcon::DefaultState, bool  recalc = false, bool  redraw = false  )

virtual

Changes the icon for this item.

Parameters

size	the icon size (0 for default, otherwise size in pixels)
state	the state of the icon (enum in TDEIcon)
recalc	whether to update the layout of the icon view when setting the icon
redraw	whether to redraw the item after setting the icon

Definition at line 119 of file tdefileivi.cpp.

setKey()

void KFileIVI::setKey ( const TQString &  key )

virtual

Definition at line 360 of file tdefileivi.cpp.

setMouseOverAnimation()

void KFileIVI::setMouseOverAnimation

(

const TQString &

movieFileName

)

Enable an animation on mouseover, if there is an available mng.

Parameters

movieFileName

the base name for the mng, e.g. "folder". Nothing happens if there is no animation available.

Definition at line 545 of file tdefileivi.cpp.

setOverlay()

void KFileIVI::setOverlay

(

const TQString &

iconName

)

Sets an icon to be shown over the bottom left corner of the icon.

Currently used for directory overlays. setOverlay(TQString::null) to remove icon.

Definition at line 143 of file tdefileivi.cpp.

setOverlayProgressBar()

void KFileIVI::setOverlayProgressBar

(

const int

progress

)

Sets a progress bar to be shown on the right side of the icon.

Currently used for disk space overlays. setOverlayProgressBar(-1) to remove progress bar.

Definition at line 150 of file tdefileivi.cpp.

setPixmapDirect()

void KFileIVI::setPixmapDirect	(	const TQPixmap &	pixmap,
		bool	recalc = false,
		bool	redraw = false
	)

Bypass setIcon.

This is for animated icons, you should use setIcon in all other cases.

Parameters

pixmap	the pixmap to set - it SHOULD really have the right icon size!
recalc	whether to update the layout of the icon view when setting the icon
redraw	whether to redraw the item after setting the icon

Definition at line 202 of file tdefileivi.cpp.

setShowDirectoryOverlay()

KIVDirectoryOverlay * KFileIVI::setShowDirectoryOverlay

(

bool

show

)

Sets showing of directory overlays.

Does nothing if this does not represent a folder.

Definition at line 157 of file tdefileivi.cpp.

setShowFreeSpaceOverlay()

KIVFreeSpaceOverlay * KFileIVI::setShowFreeSpaceOverlay

(

bool

show

)

Sets showing of free space overlays.

Does nothing if this does not represent a media device.

Definition at line 179 of file tdefileivi.cpp.

setThumbnailPixmap()

void KFileIVI::setThumbnailPixmap

(

const TQPixmap &

pixmap

)

Set this when the thumbnail was loaded.

Definition at line 241 of file tdefileivi.cpp.

showDirectoryOverlay()

bool KFileIVI::showDirectoryOverlay

(

)

Definition at line 174 of file tdefileivi.cpp.

showFreeSpaceOverlay()

bool KFileIVI::showFreeSpaceOverlay

(

)

Definition at line 197 of file tdefileivi.cpp.

state()

int KFileIVI::state ( ) const

inline

Return the current state of the icon (TDEIcon::DefaultState, TDEIcon::ActiveState etc.)

Definition at line 114 of file tdefileivi.h.

updateColors()

TQColorGroup KFileIVI::updateColors ( const TQColorGroup &  c ) const

protected

Updates the colorgroup.

Definition at line 518 of file tdefileivi.cpp.

---

The documentation for this class was generated from the following files:

• tdefileivi.h
• tdefileivi.cpp