KDesktopFileActions Namespace Reference

Functions
QList< KServiceAction >	builtinServices (const KUrl &url)
void	executeService (const KUrl::List &urls, const KServiceAction &service)
bool	run (const KUrl &_url, bool _is_local)
QList< KServiceAction >	userDefinedServices (const QString &path, bool bLocalFiles)
QList< KServiceAction >	userDefinedServices (const QString &path, const KDesktopFile &desktopFile, bool bLocalFiles, const KUrl::List &file_list=KUrl::List())
QList< KServiceAction >	userDefinedServices (const KService &service, bool bLocalFiles, const KUrl::List &file_list=KUrl::List())

Detailed Description

KDesktopFileActions provides a number of methods related to actions in desktop files.

Function Documentation

QList< KServiceAction > KDesktopFileActions::builtinServices

(

const KUrl &

url

)

Returns a list of services for the given .desktop file that are handled by kio itself.

Namely mount/unmount for FSDevice files.

Returns

the list of services

Definition at line 156 of file kdesktopfileactions.cpp.

void KDesktopFileActions::executeService	(	const KUrl::List &	urls,
		const KServiceAction &	service
	)

Execute service on the list of urls.

Parameters

urls	the list of urls
service	the service to execute

Definition at line 288 of file kdesktopfileactions.cpp.

bool KDesktopFileActions::run	(	const KUrl &	_url,
		bool	_is_local
	)

Invokes the default action for the desktop entry.

If the desktop entry is not local, then only false is returned. Otherwise we would create a security problem. Only types Link and Mimetype could be followed.

Parameters

_url	the url to run
_is_local	true if the URL is local, false otherwise

Returns

true on success and false on failure.

See also

KRun::runUrl

Definition at line 54 of file kdesktopfileactions.cpp.

QList< KServiceAction > KDesktopFileActions::userDefinedServices	(	const QString &	path,
		bool	bLocalFiles
	)

Returns a list of services defined by the user as possible actions on the given .desktop file.

May include separators (see KServiceAction::isSeparator) which should appear in user-visible representations of those actions, such as separators in a menu.

Parameters

path	the path to the desktop file describing the services
bLocalFiles	true if those services are to be applied to local files only (if false, services that don't have u or U in the Exec line won't be taken into account).

Returns

the list of user defined actions

Definition at line 230 of file kdesktopfileactions.cpp.

QList< KServiceAction > KDesktopFileActions::userDefinedServices	(	const QString &	path,
		const KDesktopFile &	desktopFile,
		bool	bLocalFiles,
		const KUrl::List &	file_list = KUrl::List()
	)

Overload of userDefinedServices but also allows you to pass a list of urls for this file.

This allows for the menu to be changed depending on the exact files via the X-KDE-GetActionMenu extension.

Definition at line 236 of file kdesktopfileactions.cpp.

QList< KServiceAction > KDesktopFileActions::userDefinedServices	(	const KService &	service,
		bool	bLocalFiles,
		const KUrl::List &	file_list = KUrl::List()
	)

Returns a list of services defined by the user as possible actions on the given .desktop file represented by the KService instance.

May include separators (see KServiceAction::isSeparator) which should appear in user-visible representations of those actions, such as separators in a menu.

Parameters

path	the path to the desktop file describing the services
bLocalFiles	true if those services are to be applied to local files only (if false, services that don't have u or U in the Exec line won't be taken into account).
file_list	list of urls; this allows for the menu to be changed depending on the exact files via the X-KDE-GetActionMenu extension.

Returns

the list of user defined actions

Definition at line 243 of file kdesktopfileactions.cpp.