Nepomuk::Utils Namespace Reference

Classes
class	DateFacet
class	DynamicResourceFacet
class	Facet
class	FacetModel
class	FacetWidget
class	ProxyFacet
class	ResourceModel
class	SearchWidget
class	SimpleFacet
class	SimpleResourceModel
class	TypeFacet

Enumerations
enum	PropertyFormatFlag { NoPropertyFormatFlags = 0x0, WithKioLinks = 0x1 }

Functions
NEPOMUKUTILS_EXPORT Nepomuk::Resource	createCopyEvent (const KUrl &src, const KUrl &dest, const QDateTime &startTime=QDateTime(), const KUrl &referrer=KUrl())
NEPOMUKUTILS_EXPORT void	finishCopyEvent (Nepomuk::Resource &eventResource, const QDateTime &endTime)
NEPOMUKUTILS_EXPORT QString	formatPropertyValue (const Nepomuk::Types::Property &property, const Nepomuk::Variant &value, const QList< Nepomuk::Resource > &resources=QList< Nepomuk::Resource >(), PropertyFormatFlags flags=NoPropertyFormatFlags)

Detailed Description

The Utils namespace contains utility and convenience methods and classes that help the application developer with using Nepomuk.

An essential part of the Utils is the The Facet API which allows developers to easily integrate a filter-based search interface into their applications.

Enumeration Type Documentation

enum Nepomuk::Utils::PropertyFormatFlag

Flags to change the behaviour of formatPropertyValue().

Since

4.6

Enumerator
NoPropertyFormatFlags	No flags, ie. default behaviour.
WithKioLinks	Include html links to Nepomuk resources, files, and Nepomuk queries.

Definition at line 47 of file utils.h.

Function Documentation

NEPOMUKUTILS_EXPORT Nepomuk::Resource Nepomuk::Utils::createCopyEvent	(	const KUrl &	src,
		const KUrl &	dest,
		const QDateTime &	startTime = QDateTime(),
		const KUrl &	referrer = KUrl()
	)

Save a copy event in Nepomuk stating that src has been copied to dest with an optional download startTime and an optional referrer URL that indicates from which webpage a download was initiated.

Returns

The download event resource. Use finishCopyEvent() to store the event's end time.

Since

4.6

NEPOMUKUTILS_EXPORT void Nepomuk::Utils::finishCopyEvent	(	Nepomuk::Resource &	eventResource,
		const QDateTime &	endTime
	)

Save the end time of a copy event created via createCopyEvent().

Parameters

eventResource	The resource returned by createCopyEvent().
endTime	The time the copy event ended to the saved.

Since

4.6

NEPOMUKUTILS_EXPORT QString Nepomuk::Utils::formatPropertyValue	(	const Nepomuk::Types::Property &	property,
		const Nepomuk::Variant &	value,
		const QList< Nepomuk::Resource > &	resources = QList< Nepomuk::Resource >(),
		PropertyFormatFlags	flags = NoPropertyFormatFlags
	)

Format a property to be displayed to the user.

Parameters

property	The actual property to which the value applies to.
value	The actual value to be formatted.
flags	Optional flags to change the resulting string.
resources	The resources which the property applies to. Depending on the property the user readable representation might differ based on the resources' types. Using an empty list is perfectly valid.

Returns

A user readable representation of the value which corresponds to resource and property. This string may contain Qt-style HTML tags for links and special formatting.

Since

4.6