cairo-dock-launcher-manager.h File Reference

Functions
Icon *	cairo_dock_create_icon_from_desktop_file (const gchar *cDesktopFileName)
Icon *	cairo_dock_create_dummy_launcher (gchar *cName, gchar *cFileName, gchar *cCommand, gchar *cQuickInfo, double fOrder)
void	cairo_dock_build_docks_tree_with_desktop_files (const gchar *cDirectory)
void	cairo_dock_reload_launcher (Icon *icon)

---

Detailed Description

* This class handles the creation, load and reload of launcher icons, from the desktop files contained inside the 'launchers' folder. The files holding the information are common desktop files, with additionnal keys added by the dock on the launcher creation.

---

Function Documentation

Icon* cairo_dock_create_icon_from_desktop_file

(

const gchar *

cDesktopFileName

)

Create an Icon from a given desktop file, and fill its buffers. The resulting icon can directly be used inside a container. Class inhibiting is handled.

Parameters:

cDesktopFileName

name of the desktop file, present in the "launchers" folder of the current theme.

Returns:

the newly created icon.

Icon* cairo_dock_create_dummy_launcher	(	gchar *	cName,
		gchar *	cFileName,
		gchar *	cCommand,
		gchar *	cQuickInfo,
		double	fOrder
	)

Create an Icon that will behave like a launcher. It's especially useful for applets that want to fill a sub-dock or a desklet (the icon is not loaded by the function). Be careful that the strings are not duplicated. Therefore, you must use g_strdup() if you want to set a constant string; and must not free the strings after calling this function.

Parameters:

cName	label of the icon
cFileName	name of an image
cCommand	a command, or NULL
cQuickInfo	a quick-info, or NULL
fOrder	order of the icon in its container.

Returns:

the newly created icon.

void cairo_dock_build_docks_tree_with_desktop_files

(

const gchar *

cDirectory

)

Load a set of .desktop files that define icons, and build the corresponding tree of docks. All the icons are created and placed inside their dock, which is created if necessary.

Parameters:

cDirectory

a folder containing some .desktop files.

void cairo_dock_reload_launcher

(

Icon *

icon

)

Reload completely a launcher. It handles all the side-effects like modifying the class, the sub-dock's view, the container, etc.

Parameters:

icon	the launcher Icon to reload.