KFilePreviewGenerator Class Reference

#include <kfilepreviewgenerator.h>

Inheritance diagram for KFilePreviewGenerator:

Public Member Functions
	KFilePreviewGenerator (QAbstractItemView *parent)
	KFilePreviewGenerator (KAbstractViewAdapter *parent, QAbstractProxyModel *model)
virtual	~KFilePreviewGenerator ()
void	cancelPreviews ()
QStringList	enabledPlugins () const
bool	isPreviewShown () const
void	setEnabledPlugins (const QStringList &list)
void	setPreviewShown (bool show)
void	updateIcons ()
void	updatePreviews ()
Public Member Functions inherited from QObject
	QObject (QObject *parent)
	QObject (QObject *parent, const char *name)
virtual	~QObject ()
bool	blockSignals (bool block)
QObject *	child (const char *objName, const char *inheritsClass, bool recursiveSearch) const
const QObjectList &	children () const
const char *	className () const
bool	connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const
void	deleteLater ()
void	destroyed (QObject *obj)
bool	disconnect (const QObject *receiver, const char *method)
bool	disconnect (const char *signal, const QObject *receiver, const char *method)
void	dumpObjectInfo ()
void	dumpObjectTree ()
QList< QByteArray >	dynamicPropertyNames () const
virtual bool	event (QEvent *e)
virtual bool	eventFilter (QObject *watched, QEvent *event)
T	findChild (const QString &name) const
QList< T >	findChildren (const QRegExp &regExp) const
QList< T >	findChildren (const QString &name) const
bool	inherits (const char *className) const
void	insertChild (QObject *object)
void	installEventFilter (QObject *filterObj)
bool	isA (const char *className) const
bool	isWidgetType () const
void	killTimer (int id)
virtual const QMetaObject *	metaObject () const
void	moveToThread (QThread *targetThread)
const char *	name () const
const char *	name (const char *defaultName) const
QString	objectName () const
QObject *	parent () const
QVariant	property (const char *name) const
void	removeChild (QObject *object)
void	removeEventFilter (QObject *obj)
void	setName (const char *name)
void	setObjectName (const QString &name)
void	setParent (QObject *parent)
bool	setProperty (const char *name, const QVariant &value)
bool	signalsBlocked () const
int	startTimer (int interval)
QThread *	thread () const

Additional Inherited Members
Static Public Member Functions inherited from QObject
bool	connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
bool	connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
bool	disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
bool	disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
QString	tr (const char *sourceText, const char *disambiguation, int n)
QString	trUtf8 (const char *sourceText, const char *disambiguation, int n)
Protected Member Functions inherited from QObject
bool	checkConnectArgs (const char *signal, const QObject *object, const char *method)
virtual void	childEvent (QChildEvent *event)
virtual void	connectNotify (const char *signal)
virtual void	customEvent (QEvent *event)
virtual void	disconnectNotify (const char *signal)
int	receivers (const char *signal) const
QObject *	sender () const
int	senderSignalIndex () const
virtual void	timerEvent (QTimerEvent *event)
Static Protected Member Functions inherited from QObject
QByteArray	normalizeSignalSlot (const char *signalSlot)
Properties inherited from QObject
	objectName

Detailed Description

Generates previews for files of an item view.

Per default a preview is generated for each item. Additionally the clipboard is checked for cut items. The icon state for cut items gets dimmed automatically.

The following strategy is used when creating previews:

• The previews for currently visible items are created before the previews for invisible items.
• If the user changes the visible area by using the scrollbars, all pending previews get paused. As soon as the user stays on the same position for a short delay, the previews are resumed. Also in this case the previews for the visible items are generated first.

Since

4.2

Definition at line 50 of file kfilepreviewgenerator.h.

Constructor & Destructor Documentation

KFilePreviewGenerator::KFilePreviewGenerator

(

QAbstractItemView *

parent

)

Parameters

parent

Item view containing the file items where previews should be generated. It is mandatory that the item view specifies an icon size by QAbstractItemView::setIconSize() and that the model of the view (or the source model of the proxy model) is an instance of KDirModel. Otherwise no previews will be generated.

Definition at line 1201 of file kfilepreviewgenerator.cpp.

KFilePreviewGenerator::KFilePreviewGenerator	(	KAbstractViewAdapter *	parent,
		QAbstractProxyModel *	model
	)

Definition at line 1208 of file kfilepreviewgenerator.cpp.

KFilePreviewGenerator::~KFilePreviewGenerator ( )

virtual

Definition at line 1214 of file kfilepreviewgenerator.cpp.

Member Function Documentation

void KFilePreviewGenerator::cancelPreviews

(

)

Cancels all pending previews.

Definition at line 1287 of file kfilepreviewgenerator.cpp.

QStringList KFilePreviewGenerator::enabledPlugins

(

)

const

Returns the list of enabled thumbnail plugins.

See also

setEnabledPlugins

Definition at line 1300 of file kfilepreviewgenerator.cpp.

bool KFilePreviewGenerator::isPreviewShown

(

)

const

Definition at line 1262 of file kfilepreviewgenerator.cpp.

void KFilePreviewGenerator::setEnabledPlugins

(

const QStringList &

list

)

Sets the list of enabled thumbnail plugins.

Per default all plugins enabled in the KConfigGroup "PreviewSettings" are used.

Note that this method doesn't cause already generated previews to be regenerated.

For a list of available plugins, call KServiceTypeTrader::self()->query("ThumbCreator").

See also

enabledPlugins

Definition at line 1295 of file kfilepreviewgenerator.cpp.

void KFilePreviewGenerator::setPreviewShown

(

bool

show

)

If show is set to true, a preview is generated for each item.

If show is false, the MIME type icon of the item is shown instead. Per default showing the preview is turned on. Note that it is mandatory that the item view specifies an icon size by QAbstractItemView::setIconSize(), otherwise KFilePreviewGenerator::isPreviewShown() will always return false.

Definition at line 1219 of file kfilepreviewgenerator.cpp.

void KFilePreviewGenerator::updateIcons

(

)

Updates the icons for all items.

Usually it is only necessary to invoke this method when the icon size of the abstract item view has been changed by QAbstractItemView::setIconSize(). Note that this method should also be invoked if previews have been turned off, as the icons for cut items must be updated when the icon size has changed.

Since

4.3

Definition at line 1273 of file kfilepreviewgenerator.cpp.

void KFilePreviewGenerator::updatePreviews

(

)

Deprecated:

Use KFilePreviewGenerator::updateIcons() instead.

Definition at line 1268 of file kfilepreviewgenerator.cpp.

---

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

• kfilepreviewgenerator.h
• kfilepreviewgenerator.cpp