<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="gnome-desktop-GnomeDesktopItem">
<refmeta>
<refentrytitle role="top_of_page" id="gnome-desktop-GnomeDesktopItem.top_of_page">GnomeDesktopItem</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GNOME-DESKTOP Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GnomeDesktopItem</refname>
<refpurpose></refpurpose>
</refnamediv>

<refsynopsisdiv id="gnome-desktop-GnomeDesktopItem.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>
#include &lt;libgnome/gnome-desktop-item.h&gt;

enum                <link linkend="GnomeDesktopItemType">GnomeDesktopItemType</link>;
enum                <link linkend="GnomeDesktopItemStatus">GnomeDesktopItemStatus</link>;
                    <link linkend="GnomeDesktopItem">GnomeDesktopItem</link>;
#define             <link linkend="GNOME-DESKTOP-ITEM-ENCODING:CAPS">GNOME_DESKTOP_ITEM_ENCODING</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-VERSION:CAPS">GNOME_DESKTOP_ITEM_VERSION</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-NAME:CAPS">GNOME_DESKTOP_ITEM_NAME</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-GENERIC-NAME:CAPS">GNOME_DESKTOP_ITEM_GENERIC_NAME</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-TYPE:CAPS">GNOME_DESKTOP_ITEM_TYPE</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-FILE-PATTERN:CAPS">GNOME_DESKTOP_ITEM_FILE_PATTERN</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-TRY-EXEC:CAPS">GNOME_DESKTOP_ITEM_TRY_EXEC</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-NO-DISPLAY:CAPS">GNOME_DESKTOP_ITEM_NO_DISPLAY</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-COMMENT:CAPS">GNOME_DESKTOP_ITEM_COMMENT</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-EXEC:CAPS">GNOME_DESKTOP_ITEM_EXEC</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-ACTIONS:CAPS">GNOME_DESKTOP_ITEM_ACTIONS</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-ICON:CAPS">GNOME_DESKTOP_ITEM_ICON</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-MINI-ICON:CAPS">GNOME_DESKTOP_ITEM_MINI_ICON</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-HIDDEN:CAPS">GNOME_DESKTOP_ITEM_HIDDEN</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-PATH:CAPS">GNOME_DESKTOP_ITEM_PATH</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-TERMINAL:CAPS">GNOME_DESKTOP_ITEM_TERMINAL</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-TERMINAL-OPTIONS:CAPS">GNOME_DESKTOP_ITEM_TERMINAL_OPTIONS</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-SWALLOW-TITLE:CAPS">GNOME_DESKTOP_ITEM_SWALLOW_TITLE</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-SWALLOW-EXEC:CAPS">GNOME_DESKTOP_ITEM_SWALLOW_EXEC</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-MIME-TYPE:CAPS">GNOME_DESKTOP_ITEM_MIME_TYPE</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-PATTERNS:CAPS">GNOME_DESKTOP_ITEM_PATTERNS</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-DEFAULT-APP:CAPS">GNOME_DESKTOP_ITEM_DEFAULT_APP</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-DEV:CAPS">GNOME_DESKTOP_ITEM_DEV</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-FS-TYPE:CAPS">GNOME_DESKTOP_ITEM_FS_TYPE</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-MOUNT-POINT:CAPS">GNOME_DESKTOP_ITEM_MOUNT_POINT</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-READ-ONLY:CAPS">GNOME_DESKTOP_ITEM_READ_ONLY</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-UNMOUNT-ICON:CAPS">GNOME_DESKTOP_ITEM_UNMOUNT_ICON</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-SORT-ORDER:CAPS">GNOME_DESKTOP_ITEM_SORT_ORDER</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-URL:CAPS">GNOME_DESKTOP_ITEM_URL</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-DOC-PATH:CAPS">GNOME_DESKTOP_ITEM_DOC_PATH</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-CATEGORIES:CAPS">GNOME_DESKTOP_ITEM_CATEGORIES</link>
#define             <link linkend="GNOME-DESKTOP-ITEM-ONLY-SHOW-IN:CAPS">GNOME_DESKTOP_ITEM_ONLY_SHOW_IN</link>
enum                <link linkend="GnomeDesktopItemLoadFlags">GnomeDesktopItemLoadFlags</link>;
enum                <link linkend="GnomeDesktopItemLaunchFlags">GnomeDesktopItemLaunchFlags</link>;
enum                <link linkend="GnomeDesktopItemIconFlags">GnomeDesktopItemIconFlags</link>;
enum                <link linkend="GnomeDesktopItemError">GnomeDesktopItemError</link>;
#define             <link linkend="GNOME-DESKTOP-ITEM-ERROR:CAPS">GNOME_DESKTOP_ITEM_ERROR</link>
<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *  <link linkend="gnome-desktop-item-new">gnome_desktop_item_new</link>              (void);
<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *  <link linkend="gnome-desktop-item-new-from-file">gnome_desktop_item_new_from_file</link>    (const <link linkend="char">char</link> *file,
                                                         <link linkend="GnomeDesktopItemLoadFlags">GnomeDesktopItemLoadFlags</link> flags,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *  <link linkend="gnome-desktop-item-new-from-uri">gnome_desktop_item_new_from_uri</link>     (const <link linkend="char">char</link> *uri,
                                                         <link linkend="GnomeDesktopItemLoadFlags">GnomeDesktopItemLoadFlags</link> flags,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *  <link linkend="gnome-desktop-item-new-from-string">gnome_desktop_item_new_from_string</link>  (const <link linkend="char">char</link> *uri,
                                                         const <link linkend="char">char</link> *string,
                                                         <link linkend="gssize">gssize</link> length,
                                                         <link linkend="GnomeDesktopItemLoadFlags">GnomeDesktopItemLoadFlags</link> flags,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *  <link linkend="gnome-desktop-item-new-from-basename">gnome_desktop_item_new_from_basename</link>
                                                        (const <link linkend="char">char</link> *basename,
                                                         <link linkend="GnomeDesktopItemLoadFlags">GnomeDesktopItemLoadFlags</link> flags,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *  <link linkend="gnome-desktop-item-copy">gnome_desktop_item_copy</link>             (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item);
<link linkend="gboolean">gboolean</link>            <link linkend="gnome-desktop-item-save">gnome_desktop_item_save</link>             (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *under,
                                                         <link linkend="gboolean">gboolean</link> force,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *  <link linkend="gnome-desktop-item-ref">gnome_desktop_item_ref</link>              (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item);
<link linkend="void">void</link>                <link linkend="gnome-desktop-item-unref">gnome_desktop_item_unref</link>            (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item);
<link linkend="int">int</link>                 <link linkend="gnome-desktop-item-launch">gnome_desktop_item_launch</link>           (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         <link linkend="GList">GList</link> *file_list,
                                                         <link linkend="GnomeDesktopItemLaunchFlags">GnomeDesktopItemLaunchFlags</link> flags,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="int">int</link>                 <link linkend="gnome-desktop-item-launch-with-env">gnome_desktop_item_launch_with_env</link>  (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         <link linkend="GList">GList</link> *file_list,
                                                         <link linkend="GnomeDesktopItemLaunchFlags">GnomeDesktopItemLaunchFlags</link> flags,
                                                         <link linkend="char">char</link> **envp,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="int">int</link>                 <link linkend="gnome-desktop-item-launch-on-screen">gnome_desktop_item_launch_on_screen</link> (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         <link linkend="GList">GList</link> *file_list,
                                                         <link linkend="GnomeDesktopItemLaunchFlags">GnomeDesktopItemLaunchFlags</link> flags,
                                                         <link linkend="GdkScreen">GdkScreen</link> *screen,
                                                         <link linkend="int">int</link> workspace,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="int">int</link>                 <link linkend="gnome-desktop-item-drop-uri-list">gnome_desktop_item_drop_uri_list</link>    (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *uri_list,
                                                         <link linkend="GnomeDesktopItemLaunchFlags">GnomeDesktopItemLaunchFlags</link> flags,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="int">int</link>                 <link linkend="gnome-desktop-item-drop-uri-list-with-env">gnome_desktop_item_drop_uri_list_with_env</link>
                                                        (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *uri_list,
                                                         <link linkend="GnomeDesktopItemLaunchFlags">GnomeDesktopItemLaunchFlags</link> flags,
                                                         <link linkend="char">char</link> **envp,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="gboolean">gboolean</link>            <link linkend="gnome-desktop-item-exists">gnome_desktop_item_exists</link>           (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item);
<link linkend="GnomeDesktopItemType">GnomeDesktopItemType</link>  <link linkend="gnome-desktop-item-get-entry-type">gnome_desktop_item_get_entry_type</link> (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item);
<link linkend="void">void</link>                <link linkend="gnome-desktop-item-set-entry-type">gnome_desktop_item_set_entry_type</link>   (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         <link linkend="GnomeDesktopItemType">GnomeDesktopItemType</link> type);
const <link linkend="char">char</link> *        <link linkend="gnome-desktop-item-get-location">gnome_desktop_item_get_location</link>     (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item);
<link linkend="void">void</link>                <link linkend="gnome-desktop-item-set-location">gnome_desktop_item_set_location</link>     (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *location);
<link linkend="void">void</link>                <link linkend="gnome-desktop-item-set-location-file">gnome_desktop_item_set_location_file</link>
                                                        (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *file);
<link linkend="GnomeDesktopItemStatus">GnomeDesktopItemStatus</link>  <link linkend="gnome-desktop-item-get-file-status">gnome_desktop_item_get_file_status</link>
                                                        (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item);
<link linkend="char">char</link> *              <link linkend="gnome-desktop-item-get-icon">gnome_desktop_item_get_icon</link>         (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         <link linkend="GtkIconTheme">GtkIconTheme</link> *icon_theme);
<link linkend="char">char</link> *              <link linkend="gnome-desktop-item-find-icon">gnome_desktop_item_find_icon</link>        (<link linkend="GtkIconTheme">GtkIconTheme</link> *icon_theme,
                                                         const <link linkend="char">char</link> *icon,
                                                         <link linkend="int">int</link> desired_size,
                                                         <link linkend="int">int</link> flags);
<link linkend="gboolean">gboolean</link>            <link linkend="gnome-desktop-item-attr-exists">gnome_desktop_item_attr_exists</link>      (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr);
const <link linkend="char">char</link> *        <link linkend="gnome-desktop-item-get-string">gnome_desktop_item_get_string</link>       (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr);
<link linkend="void">void</link>                <link linkend="gnome-desktop-item-set-string">gnome_desktop_item_set_string</link>       (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr,
                                                         const <link linkend="char">char</link> *value);
const <link linkend="char">char</link> *        <link linkend="gnome-desktop-item-get-attr-locale">gnome_desktop_item_get_attr_locale</link>  (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr);
const <link linkend="char">char</link> *        <link linkend="gnome-desktop-item-get-localestring">gnome_desktop_item_get_localestring</link> (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr);
const <link linkend="char">char</link> *        <link linkend="gnome-desktop-item-get-localestring-lang">gnome_desktop_item_get_localestring_lang</link>
                                                        (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr,
                                                         const <link linkend="char">char</link> *language);
<link linkend="GList">GList</link> *             <link linkend="gnome-desktop-item-get-languages">gnome_desktop_item_get_languages</link>    (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr);
<link linkend="void">void</link>                <link linkend="gnome-desktop-item-set-localestring">gnome_desktop_item_set_localestring</link> (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr,
                                                         const <link linkend="char">char</link> *value);
<link linkend="void">void</link>                <link linkend="gnome-desktop-item-set-localestring-lang">gnome_desktop_item_set_localestring_lang</link>
                                                        (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr,
                                                         const <link linkend="char">char</link> *language,
                                                         const <link linkend="char">char</link> *value);
<link linkend="void">void</link>                <link linkend="gnome-desktop-item-clear-localestring">gnome_desktop_item_clear_localestring</link>
                                                        (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr);
<link linkend="char">char</link> **             <link linkend="gnome-desktop-item-get-strings">gnome_desktop_item_get_strings</link>      (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr);
<link linkend="void">void</link>                <link linkend="gnome-desktop-item-set-strings">gnome_desktop_item_set_strings</link>      (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr,
                                                         <link linkend="char">char</link> **strings);
<link linkend="gboolean">gboolean</link>            <link linkend="gnome-desktop-item-get-boolean">gnome_desktop_item_get_boolean</link>      (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr);
<link linkend="void">void</link>                <link linkend="gnome-desktop-item-set-boolean">gnome_desktop_item_set_boolean</link>      (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr,
                                                         <link linkend="gboolean">gboolean</link> value);
<link linkend="void">void</link>                <link linkend="gnome-desktop-item-set-launch-time">gnome_desktop_item_set_launch_time</link>  (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         <link linkend="guint32">guint32</link> timestamp);
#define             <link linkend="gnome-desktop-item-clear-attr">gnome_desktop_item_clear_attr</link>       (item,attr)
<link linkend="void">void</link>                <link linkend="gnome-desktop-item-clear-section">gnome_desktop_item_clear_section</link>    (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *section);
</synopsis>
</refsynopsisdiv>

<refsect1 id="gnome-desktop-GnomeDesktopItem.description" role="desc">
<title role="desc.title">Description</title>
<para>
</para>
</refsect1>
<refsect1 id="gnome-desktop-GnomeDesktopItem.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GnomeDesktopItemType" role="enum">
<title>enum GnomeDesktopItemType</title>
<indexterm zone="GnomeDesktopItemType"><primary>GnomeDesktopItemType</primary></indexterm>
<programlisting>typedef enum {
	GNOME_DESKTOP_ITEM_TYPE_NULL = 0 /* This means its NULL, that is, not
					   * set */,
	GNOME_DESKTOP_ITEM_TYPE_OTHER /* This means it's not one of the below
					      strings types, and you must get the
					      Type attribute. */,

	/* These are the standard compliant types: */
	GNOME_DESKTOP_ITEM_TYPE_APPLICATION,
	GNOME_DESKTOP_ITEM_TYPE_LINK,
	GNOME_DESKTOP_ITEM_TYPE_FSDEVICE,
	GNOME_DESKTOP_ITEM_TYPE_MIME_TYPE,
	GNOME_DESKTOP_ITEM_TYPE_DIRECTORY,
	GNOME_DESKTOP_ITEM_TYPE_SERVICE,
	GNOME_DESKTOP_ITEM_TYPE_SERVICE_TYPE
} GnomeDesktopItemType;
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GnomeDesktopItemStatus" role="enum">
<title>enum GnomeDesktopItemStatus</title>
<indexterm zone="GnomeDesktopItemStatus"><primary>GnomeDesktopItemStatus</primary></indexterm>
<programlisting>typedef enum {
        GNOME_DESKTOP_ITEM_UNCHANGED = 0,
        GNOME_DESKTOP_ITEM_CHANGED = 1,
        GNOME_DESKTOP_ITEM_DISAPPEARED = 2
} GnomeDesktopItemStatus;
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GnomeDesktopItem" role="struct">
<title>GnomeDesktopItem</title>
<indexterm zone="GnomeDesktopItem"><primary>GnomeDesktopItem</primary></indexterm>
<programlisting>typedef struct _GnomeDesktopItem GnomeDesktopItem;</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-ENCODING:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_ENCODING</title>
<indexterm zone="GNOME-DESKTOP-ITEM-ENCODING:CAPS"><primary>GNOME_DESKTOP_ITEM_ENCODING</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_ENCODING&#160;"Encoding" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-VERSION:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_VERSION</title>
<indexterm zone="GNOME-DESKTOP-ITEM-VERSION:CAPS"><primary>GNOME_DESKTOP_ITEM_VERSION</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_VERSION&#160;"Version"  /* numeric */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-NAME:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_NAME</title>
<indexterm zone="GNOME-DESKTOP-ITEM-NAME:CAPS"><primary>GNOME_DESKTOP_ITEM_NAME</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_NAME		"Name" /* localestring */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-GENERIC-NAME:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_GENERIC_NAME</title>
<indexterm zone="GNOME-DESKTOP-ITEM-GENERIC-NAME:CAPS"><primary>GNOME_DESKTOP_ITEM_GENERIC_NAME</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_GENERIC_NAME&#160;"GenericName" /* localestring */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-TYPE:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_TYPE</title>
<indexterm zone="GNOME-DESKTOP-ITEM-TYPE:CAPS"><primary>GNOME_DESKTOP_ITEM_TYPE</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_TYPE		"Type" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-FILE-PATTERN:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_FILE_PATTERN</title>
<indexterm zone="GNOME-DESKTOP-ITEM-FILE-PATTERN:CAPS"><primary>GNOME_DESKTOP_ITEM_FILE_PATTERN</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_FILE_PATTERN "FilePattern" /* regexp(s) */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-TRY-EXEC:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_TRY_EXEC</title>
<indexterm zone="GNOME-DESKTOP-ITEM-TRY-EXEC:CAPS"><primary>GNOME_DESKTOP_ITEM_TRY_EXEC</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_TRY_EXEC&#160;"TryExec" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-NO-DISPLAY:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_NO_DISPLAY</title>
<indexterm zone="GNOME-DESKTOP-ITEM-NO-DISPLAY:CAPS"><primary>GNOME_DESKTOP_ITEM_NO_DISPLAY</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_NO_DISPLAY&#160;"NoDisplay" /* boolean */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-COMMENT:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_COMMENT</title>
<indexterm zone="GNOME-DESKTOP-ITEM-COMMENT:CAPS"><primary>GNOME_DESKTOP_ITEM_COMMENT</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_COMMENT&#160;"Comment" /* localestring */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-EXEC:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_EXEC</title>
<indexterm zone="GNOME-DESKTOP-ITEM-EXEC:CAPS"><primary>GNOME_DESKTOP_ITEM_EXEC</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_EXEC		"Exec" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-ACTIONS:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_ACTIONS</title>
<indexterm zone="GNOME-DESKTOP-ITEM-ACTIONS:CAPS"><primary>GNOME_DESKTOP_ITEM_ACTIONS</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_ACTIONS&#160;"Actions" /* strings */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-ICON:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_ICON</title>
<indexterm zone="GNOME-DESKTOP-ITEM-ICON:CAPS"><primary>GNOME_DESKTOP_ITEM_ICON</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_ICON		"Icon" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-MINI-ICON:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_MINI_ICON</title>
<indexterm zone="GNOME-DESKTOP-ITEM-MINI-ICON:CAPS"><primary>GNOME_DESKTOP_ITEM_MINI_ICON</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_MINI_ICON&#160;"MiniIcon" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-HIDDEN:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_HIDDEN</title>
<indexterm zone="GNOME-DESKTOP-ITEM-HIDDEN:CAPS"><primary>GNOME_DESKTOP_ITEM_HIDDEN</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_HIDDEN&#160;"Hidden" /* boolean */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-PATH:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_PATH</title>
<indexterm zone="GNOME-DESKTOP-ITEM-PATH:CAPS"><primary>GNOME_DESKTOP_ITEM_PATH</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_PATH		"Path" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-TERMINAL:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_TERMINAL</title>
<indexterm zone="GNOME-DESKTOP-ITEM-TERMINAL:CAPS"><primary>GNOME_DESKTOP_ITEM_TERMINAL</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_TERMINAL&#160;"Terminal" /* boolean */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-TERMINAL-OPTIONS:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_TERMINAL_OPTIONS</title>
<indexterm zone="GNOME-DESKTOP-ITEM-TERMINAL-OPTIONS:CAPS"><primary>GNOME_DESKTOP_ITEM_TERMINAL_OPTIONS</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_TERMINAL_OPTIONS "TerminalOptions" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-SWALLOW-TITLE:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_SWALLOW_TITLE</title>
<indexterm zone="GNOME-DESKTOP-ITEM-SWALLOW-TITLE:CAPS"><primary>GNOME_DESKTOP_ITEM_SWALLOW_TITLE</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_SWALLOW_TITLE "SwallowTitle" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-SWALLOW-EXEC:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_SWALLOW_EXEC</title>
<indexterm zone="GNOME-DESKTOP-ITEM-SWALLOW-EXEC:CAPS"><primary>GNOME_DESKTOP_ITEM_SWALLOW_EXEC</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_SWALLOW_EXEC&#160;"SwallowExec" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-MIME-TYPE:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_MIME_TYPE</title>
<indexterm zone="GNOME-DESKTOP-ITEM-MIME-TYPE:CAPS"><primary>GNOME_DESKTOP_ITEM_MIME_TYPE</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_MIME_TYPE&#160;"MimeType" /* regexp(s) */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-PATTERNS:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_PATTERNS</title>
<indexterm zone="GNOME-DESKTOP-ITEM-PATTERNS:CAPS"><primary>GNOME_DESKTOP_ITEM_PATTERNS</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_PATTERNS&#160;"Patterns" /* regexp(s) */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-DEFAULT-APP:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_DEFAULT_APP</title>
<indexterm zone="GNOME-DESKTOP-ITEM-DEFAULT-APP:CAPS"><primary>GNOME_DESKTOP_ITEM_DEFAULT_APP</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_DEFAULT_APP&#160;"DefaultApp" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-DEV:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_DEV</title>
<indexterm zone="GNOME-DESKTOP-ITEM-DEV:CAPS"><primary>GNOME_DESKTOP_ITEM_DEV</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_DEV		"Dev" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-FS-TYPE:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_FS_TYPE</title>
<indexterm zone="GNOME-DESKTOP-ITEM-FS-TYPE:CAPS"><primary>GNOME_DESKTOP_ITEM_FS_TYPE</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_FS_TYPE&#160;"FSType" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-MOUNT-POINT:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_MOUNT_POINT</title>
<indexterm zone="GNOME-DESKTOP-ITEM-MOUNT-POINT:CAPS"><primary>GNOME_DESKTOP_ITEM_MOUNT_POINT</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_MOUNT_POINT&#160;"MountPoint" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-READ-ONLY:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_READ_ONLY</title>
<indexterm zone="GNOME-DESKTOP-ITEM-READ-ONLY:CAPS"><primary>GNOME_DESKTOP_ITEM_READ_ONLY</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_READ_ONLY&#160;"ReadOnly" /* boolean */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-UNMOUNT-ICON:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_UNMOUNT_ICON</title>
<indexterm zone="GNOME-DESKTOP-ITEM-UNMOUNT-ICON:CAPS"><primary>GNOME_DESKTOP_ITEM_UNMOUNT_ICON</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_UNMOUNT_ICON "UnmountIcon" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-SORT-ORDER:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_SORT_ORDER</title>
<indexterm zone="GNOME-DESKTOP-ITEM-SORT-ORDER:CAPS"><primary>GNOME_DESKTOP_ITEM_SORT_ORDER</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_SORT_ORDER&#160;"SortOrder" /* strings */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-URL:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_URL</title>
<indexterm zone="GNOME-DESKTOP-ITEM-URL:CAPS"><primary>GNOME_DESKTOP_ITEM_URL</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_URL		"URL" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-DOC-PATH:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_DOC_PATH</title>
<indexterm zone="GNOME-DESKTOP-ITEM-DOC-PATH:CAPS"><primary>GNOME_DESKTOP_ITEM_DOC_PATH</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_DOC_PATH&#160;"X-GNOME-DocPath" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-CATEGORIES:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_CATEGORIES</title>
<indexterm zone="GNOME-DESKTOP-ITEM-CATEGORIES:CAPS"><primary>GNOME_DESKTOP_ITEM_CATEGORIES</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_CATEGORIES&#160;"Categories" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-ONLY-SHOW-IN:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_ONLY_SHOW_IN</title>
<indexterm zone="GNOME-DESKTOP-ITEM-ONLY-SHOW-IN:CAPS"><primary>GNOME_DESKTOP_ITEM_ONLY_SHOW_IN</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_ONLY_SHOW_IN&#160;"OnlyShowIn" /* string */
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GnomeDesktopItemLoadFlags" role="enum">
<title>enum GnomeDesktopItemLoadFlags</title>
<indexterm zone="GnomeDesktopItemLoadFlags"><primary>GnomeDesktopItemLoadFlags</primary></indexterm>
<programlisting>typedef enum {
	/* Use the TryExec field to determine if this should be loaded */
        GNOME_DESKTOP_ITEM_LOAD_ONLY_IF_EXISTS = 1&lt;&lt;0,
        GNOME_DESKTOP_ITEM_LOAD_NO_TRANSLATIONS = 1&lt;&lt;1
} GnomeDesktopItemLoadFlags;
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GnomeDesktopItemLaunchFlags" role="enum">
<title>enum GnomeDesktopItemLaunchFlags</title>
<indexterm zone="GnomeDesktopItemLaunchFlags"><primary>GnomeDesktopItemLaunchFlags</primary></indexterm>
<programlisting>typedef enum {
	/* Never launch more instances even if the app can only
	 * handle one file and we have passed many */
        GNOME_DESKTOP_ITEM_LAUNCH_ONLY_ONE = 1&lt;&lt;0,
	/* Use current directory instead of home directory */
        GNOME_DESKTOP_ITEM_LAUNCH_USE_CURRENT_DIR = 1&lt;&lt;1,
	/* Append the list of URIs to the command if no Exec
	 * parameter is specified, instead of launching the 
	 * app without parameters. */
	GNOME_DESKTOP_ITEM_LAUNCH_APPEND_URIS = 1&lt;&lt;2,
	/* Same as above but instead append local paths */
	GNOME_DESKTOP_ITEM_LAUNCH_APPEND_PATHS = 1&lt;&lt;3,
	/* Don't automatically reap child process.  */
	GNOME_DESKTOP_ITEM_LAUNCH_DO_NOT_REAP_CHILD = 1&lt;&lt;4
} GnomeDesktopItemLaunchFlags;
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GnomeDesktopItemIconFlags" role="enum">
<title>enum GnomeDesktopItemIconFlags</title>
<indexterm zone="GnomeDesktopItemIconFlags"><primary>GnomeDesktopItemIconFlags</primary></indexterm>
<programlisting>typedef enum {
	/* Don't check the kde directories */
        GNOME_DESKTOP_ITEM_ICON_NO_KDE = 1&lt;&lt;0
} GnomeDesktopItemIconFlags;
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GnomeDesktopItemError" role="enum">
<title>enum GnomeDesktopItemError</title>
<indexterm zone="GnomeDesktopItemError"><primary>GnomeDesktopItemError</primary></indexterm>
<programlisting>typedef enum {
	GNOME_DESKTOP_ITEM_ERROR_NO_FILENAME /* No filename set or given on save */,
	GNOME_DESKTOP_ITEM_ERROR_UNKNOWN_ENCODING /* Unknown encoding of the file */,
	GNOME_DESKTOP_ITEM_ERROR_CANNOT_OPEN /* Cannot open file */,
	GNOME_DESKTOP_ITEM_ERROR_NO_EXEC_STRING /* Cannot launch due to no execute string */,
	GNOME_DESKTOP_ITEM_ERROR_BAD_EXEC_STRING /* Cannot launch due to bad execute string */,
	GNOME_DESKTOP_ITEM_ERROR_NO_URL /* No URL on a url entry*/,
	GNOME_DESKTOP_ITEM_ERROR_NOT_LAUNCHABLE /* Not a launchable type of item */,
	GNOME_DESKTOP_ITEM_ERROR_INVALID_TYPE /* Not of type application/x-gnome-app-info */
} GnomeDesktopItemError;
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GNOME-DESKTOP-ITEM-ERROR:CAPS" role="macro">
<title>GNOME_DESKTOP_ITEM_ERROR</title>
<indexterm zone="GNOME-DESKTOP-ITEM-ERROR:CAPS"><primary>GNOME_DESKTOP_ITEM_ERROR</primary></indexterm>
<programlisting>#define GNOME_DESKTOP_ITEM_ERROR gnome_desktop_item_error_quark ()
</programlisting>
<para>
</para></refsect2>
<refsect2 id="gnome-desktop-item-new" role="function">
<title>gnome_desktop_item_new ()</title>
<indexterm zone="gnome-desktop-item-new"><primary>gnome_desktop_item_new</primary></indexterm>
<programlisting><link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *  gnome_desktop_item_new              (void);</programlisting>
<para>
Creates a GnomeDesktopItem object. The reference count on the returned value is set to '1'.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The new GnomeDesktopItem
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-new-from-file" role="function">
<title>gnome_desktop_item_new_from_file ()</title>
<indexterm zone="gnome-desktop-item-new-from-file"><primary>gnome_desktop_item_new_from_file</primary></indexterm>
<programlisting><link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *  gnome_desktop_item_new_from_file    (const <link linkend="char">char</link> *file,
                                                         <link linkend="GnomeDesktopItemLoadFlags">GnomeDesktopItemLoadFlags</link> flags,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
This function loads 'file' and turns it into a GnomeDesktopItem.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>file</parameter>&#160;:</term>
<listitem><simpara> The filename or directory path to load the GnomeDesktopItem from
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>flags</parameter>&#160;:</term>
<listitem><simpara> Flags to influence the loading process
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The newly loaded item.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-new-from-uri" role="function">
<title>gnome_desktop_item_new_from_uri ()</title>
<indexterm zone="gnome-desktop-item-new-from-uri"><primary>gnome_desktop_item_new_from_uri</primary></indexterm>
<programlisting><link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *  gnome_desktop_item_new_from_uri     (const <link linkend="char">char</link> *uri,
                                                         <link linkend="GnomeDesktopItemLoadFlags">GnomeDesktopItemLoadFlags</link> flags,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
This function loads 'uri' and turns it into a GnomeDesktopItem.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>uri</parameter>&#160;:</term>
<listitem><simpara> URI to load the GnomeDesktopItem from
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>flags</parameter>&#160;:</term>
<listitem><simpara> Flags to influence the loading process
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The newly loaded item.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-new-from-string" role="function">
<title>gnome_desktop_item_new_from_string ()</title>
<indexterm zone="gnome-desktop-item-new-from-string"><primary>gnome_desktop_item_new_from_string</primary></indexterm>
<programlisting><link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *  gnome_desktop_item_new_from_string  (const <link linkend="char">char</link> *uri,
                                                         const <link linkend="char">char</link> *string,
                                                         <link linkend="gssize">gssize</link> length,
                                                         <link linkend="GnomeDesktopItemLoadFlags">GnomeDesktopItemLoadFlags</link> flags,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
This function turns the contents of the string into a GnomeDesktopItem.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>uri</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>string</parameter>&#160;:</term>
<listitem><simpara> string to load the GnomeDesktopItem from
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>length</parameter>&#160;:</term>
<listitem><simpara> length of string, or -1 to use strlen
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>flags</parameter>&#160;:</term>
<listitem><simpara> Flags to influence the loading process
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> place to put errors
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The newly loaded item.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-new-from-basename" role="function">
<title>gnome_desktop_item_new_from_basename ()</title>
<indexterm zone="gnome-desktop-item-new-from-basename"><primary>gnome_desktop_item_new_from_basename</primary></indexterm>
<programlisting><link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *  gnome_desktop_item_new_from_basename
                                                        (const <link linkend="char">char</link> *basename,
                                                         <link linkend="GnomeDesktopItemLoadFlags">GnomeDesktopItemLoadFlags</link> flags,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
This function loads 'basename' from a system data directory and 
returns its GnomeDesktopItem.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>basename</parameter>&#160;:</term>
<listitem><simpara> The basename of the GnomeDesktopItem to load.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>flags</parameter>&#160;:</term>
<listitem><simpara> Flags to influence the loading process
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The newly loaded item.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-copy" role="function">
<title>gnome_desktop_item_copy ()</title>
<indexterm zone="gnome-desktop-item-copy"><primary>gnome_desktop_item_copy</primary></indexterm>
<programlisting><link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *  gnome_desktop_item_copy             (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item);</programlisting>
<para>
Creates a copy of a GnomeDesktopItem.  The new copy has a refcount of 1.
Note: Section stack is NOT copied.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> The item to be copied
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The new copy 
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-save" role="function">
<title>gnome_desktop_item_save ()</title>
<indexterm zone="gnome-desktop-item-save"><primary>gnome_desktop_item_save</primary></indexterm>
<programlisting><link linkend="gboolean">gboolean</link>            gnome_desktop_item_save             (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *under,
                                                         <link linkend="gboolean">gboolean</link> force,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
Writes the specified item to disk.  If the 'under' is NULL, the original
location is used.  It sets the location of this entry to point to the
new location.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> A desktop item
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>under</parameter>&#160;:</term>
<listitem><simpara> A new uri (location) for this <link linkend="GnomeDesktopItem"><type>GnomeDesktopItem</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>force</parameter>&#160;:</term>
<listitem><simpara> Save even if it wasn't modified
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GError"><type>GError</type></link> return
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> boolean. <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the file was saved, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-ref" role="function">
<title>gnome_desktop_item_ref ()</title>
<indexterm zone="gnome-desktop-item-ref"><primary>gnome_desktop_item_ref</primary></indexterm>
<programlisting><link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *  gnome_desktop_item_ref              (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item);</programlisting>
<para>
Increases the reference count of the specified item.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> A desktop item
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the newly referenced <parameter>item</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-unref" role="function">
<title>gnome_desktop_item_unref ()</title>
<indexterm zone="gnome-desktop-item-unref"><primary>gnome_desktop_item_unref</primary></indexterm>
<programlisting><link linkend="void">void</link>                gnome_desktop_item_unref            (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item);</programlisting>
<para>
Decreases the reference count of the specified item, and destroys the item if there are no more references left.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> A desktop item
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-launch" role="function">
<title>gnome_desktop_item_launch ()</title>
<indexterm zone="gnome-desktop-item-launch"><primary>gnome_desktop_item_launch</primary></indexterm>
<programlisting><link linkend="int">int</link>                 gnome_desktop_item_launch           (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         <link linkend="GList">GList</link> *file_list,
                                                         <link linkend="GnomeDesktopItemLaunchFlags">GnomeDesktopItemLaunchFlags</link> flags,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
This function runs the program listed in the specified 'item',
optionally appending additional arguments to its command line.  It uses
<link linkend="g-shell-parse-argv"><type>g_shell_parse_argv</type></link> to parse the the exec string into a vector which is
then passed to <link linkend="g-spawn-async"><type>g_spawn_async</type></link> for execution. This can return all
the errors from GnomeURL, <link linkend="g-shell-parse-argv"><type>g_shell_parse_argv</type></link> and <link linkend="g-spawn-async"><type>g_spawn_async</type></link>,
in addition to it's own.  The files are
only added if the entry defines one of the standard % strings in it's
Exec field.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> A desktop item
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>file_list</parameter>&#160;:</term>
<listitem><simpara>  Files/URIs to launch this item with, can be <link linkend="NULL:CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>flags</parameter>&#160;:</term>
<listitem><simpara> FIXME
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> FIXME
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The the pid of the process spawned.  If more then one
process was spawned the last pid is returned.  On error -1
is returned and <parameter>error</parameter> is set.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-launch-with-env" role="function">
<title>gnome_desktop_item_launch_with_env ()</title>
<indexterm zone="gnome-desktop-item-launch-with-env"><primary>gnome_desktop_item_launch_with_env</primary></indexterm>
<programlisting><link linkend="int">int</link>                 gnome_desktop_item_launch_with_env  (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         <link linkend="GList">GList</link> *file_list,
                                                         <link linkend="GnomeDesktopItemLaunchFlags">GnomeDesktopItemLaunchFlags</link> flags,
                                                         <link linkend="char">char</link> **envp,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
See gnome_desktop_item_launch for a full description. This function
additionally passes an environment vector for the child process
which is to be launched.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> A desktop item
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>file_list</parameter>&#160;:</term>
<listitem><simpara>  Files/URIs to launch this item with, can be <link linkend="NULL:CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>flags</parameter>&#160;:</term>
<listitem><simpara> FIXME
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>envp</parameter>&#160;:</term>
<listitem><simpara> child's environment, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to inherit parent's
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> FIXME
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The the pid of the process spawned.  If more then one
process was spawned the last pid is returned.  On error -1
is returned and <parameter>error</parameter> is set.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-launch-on-screen" role="function">
<title>gnome_desktop_item_launch_on_screen ()</title>
<indexterm zone="gnome-desktop-item-launch-on-screen"><primary>gnome_desktop_item_launch_on_screen</primary></indexterm>
<programlisting><link linkend="int">int</link>                 gnome_desktop_item_launch_on_screen (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         <link linkend="GList">GList</link> *file_list,
                                                         <link linkend="GnomeDesktopItemLaunchFlags">GnomeDesktopItemLaunchFlags</link> flags,
                                                         <link linkend="GdkScreen">GdkScreen</link> *screen,
                                                         <link linkend="int">int</link> workspace,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
See gnome_desktop_item_launch for a full description. This function
additionally attempts to launch the application on a given screen
and workspace.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> A desktop item
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>file_list</parameter>&#160;:</term>
<listitem><simpara>  Files/URIs to launch this item with, can be <link linkend="NULL:CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>flags</parameter>&#160;:</term>
<listitem><simpara> FIXME
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>screen</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GdkScreen"><literal>GdkScreen</literal></link> on which the application should be launched
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>workspace</parameter>&#160;:</term>
<listitem><simpara> the workspace on which the app should be launched (-1 for current)
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> FIXME
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The the pid of the process spawned.  If more then one
process was spawned the last pid is returned.  On error -1
is returned and <parameter>error</parameter> is set.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-drop-uri-list" role="function">
<title>gnome_desktop_item_drop_uri_list ()</title>
<indexterm zone="gnome-desktop-item-drop-uri-list"><primary>gnome_desktop_item_drop_uri_list</primary></indexterm>
<programlisting><link linkend="int">int</link>                 gnome_desktop_item_drop_uri_list    (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *uri_list,
                                                         <link linkend="GnomeDesktopItemLaunchFlags">GnomeDesktopItemLaunchFlags</link> flags,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
A list of files or urls dropped onto an icon, the proper (Url or File)
exec is run you can pass directly string that you got as the
text/uri-list.  This just parses the list and calls</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> A desktop item
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>uri_list</parameter>&#160;:</term>
<listitem><simpara> text as gotten from a text/uri-list
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>flags</parameter>&#160;:</term>
<listitem><simpara> FIXME
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> FIXME
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The value returned by #<link linkend="gnome-execute-async"><function>gnome_execute_async()</function></link> upon execution of
the specified item or -1 on error.  If multiple instances are run, the
return of the last one is returned.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-drop-uri-list-with-env" role="function">
<title>gnome_desktop_item_drop_uri_list_with_env ()</title>
<indexterm zone="gnome-desktop-item-drop-uri-list-with-env"><primary>gnome_desktop_item_drop_uri_list_with_env</primary></indexterm>
<programlisting><link linkend="int">int</link>                 gnome_desktop_item_drop_uri_list_with_env
                                                        (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *uri_list,
                                                         <link linkend="GnomeDesktopItemLaunchFlags">GnomeDesktopItemLaunchFlags</link> flags,
                                                         <link linkend="char">char</link> **envp,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
See gnome_desktop_item_drop_uri_list for a full description. This function
additionally passes an environment vector for the child process
which is to be launched.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> A desktop item
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>uri_list</parameter>&#160;:</term>
<listitem><simpara> text as gotten from a text/uri-list
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>flags</parameter>&#160;:</term>
<listitem><simpara> FIXME
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>envp</parameter>&#160;:</term>
<listitem><simpara> child's environment
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> FIXME
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The value returned by #<link linkend="gnome-execute-async"><function>gnome_execute_async()</function></link> upon execution of
the specified item or -1 on error.  If multiple instances are run, the
return of the last one is returned.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-exists" role="function">
<title>gnome_desktop_item_exists ()</title>
<indexterm zone="gnome-desktop-item-exists"><primary>gnome_desktop_item_exists</primary></indexterm>
<programlisting><link linkend="gboolean">gboolean</link>            gnome_desktop_item_exists           (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item);</programlisting>
<para>
Attempt to figure out if the program that can be executed by this item
actually exists.  First it tries the TryExec attribute to see if that
contains a program that is in the path.  Then if there is no such
attribute, it tries the first word of the Exec attribute.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> A desktop item
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A boolean, <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if it exists, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-get-entry-type" role="function">
<title>gnome_desktop_item_get_entry_type ()</title>
<indexterm zone="gnome-desktop-item-get-entry-type"><primary>gnome_desktop_item_get_entry_type</primary></indexterm>
<programlisting><link linkend="GnomeDesktopItemType">GnomeDesktopItemType</link>  gnome_desktop_item_get_entry_type (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item);</programlisting>
<para>
Gets the type attribute (the 'Type' field) of the item.  This should
usually be 'Application' for an application, but it can be 'Directory'
for a directory description.  There are other types available as well.
The type usually indicates how the desktop item should be handeled and
how the 'Exec' field should be handeled.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> A desktop item
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The type of the specified 'item'. The returned
memory remains owned by the GnomeDesktopItem and should not be freed.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-set-entry-type" role="function">
<title>gnome_desktop_item_set_entry_type ()</title>
<indexterm zone="gnome-desktop-item-set-entry-type"><primary>gnome_desktop_item_set_entry_type</primary></indexterm>
<programlisting><link linkend="void">void</link>                gnome_desktop_item_set_entry_type   (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         <link linkend="GnomeDesktopItemType">GnomeDesktopItemType</link> type);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>type</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-get-location" role="function">
<title>gnome_desktop_item_get_location ()</title>
<indexterm zone="gnome-desktop-item-get-location"><primary>gnome_desktop_item_get_location</primary></indexterm>
<programlisting>const <link linkend="char">char</link> *        gnome_desktop_item_get_location     (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> A desktop item
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The file location associated with 'item'.

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-set-location" role="function">
<title>gnome_desktop_item_set_location ()</title>
<indexterm zone="gnome-desktop-item-set-location"><primary>gnome_desktop_item_set_location</primary></indexterm>
<programlisting><link linkend="void">void</link>                gnome_desktop_item_set_location     (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *location);</programlisting>
<para>
Set's the 'location' uri of this item.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> A desktop item
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>location</parameter>&#160;:</term>
<listitem><simpara> A uri string specifying the file location of this particular item.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-set-location-file" role="function">
<title>gnome_desktop_item_set_location_file ()</title>
<indexterm zone="gnome-desktop-item-set-location-file"><primary>gnome_desktop_item_set_location_file</primary></indexterm>
<programlisting><link linkend="void">void</link>                gnome_desktop_item_set_location_file
                                                        (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *file);</programlisting>
<para>
Set's the 'location' uri of this item to the given <parameter>file</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> A desktop item
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>file</parameter>&#160;:</term>
<listitem><simpara> A local filename specifying the file location of this particular item.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-get-file-status" role="function">
<title>gnome_desktop_item_get_file_status ()</title>
<indexterm zone="gnome-desktop-item-get-file-status"><primary>gnome_desktop_item_get_file_status</primary></indexterm>
<programlisting><link linkend="GnomeDesktopItemStatus">GnomeDesktopItemStatus</link>  gnome_desktop_item_get_file_status
                                                        (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item);</programlisting>
<para>
This function checks the modification time of the on-disk file to
see if it is more recent than the in-memory data.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> A desktop item
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> An enum value that specifies whether the item has changed since being loaded.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-get-icon" role="function">
<title>gnome_desktop_item_get_icon ()</title>
<indexterm zone="gnome-desktop-item-get-icon"><primary>gnome_desktop_item_get_icon</primary></indexterm>
<programlisting><link linkend="char">char</link> *              gnome_desktop_item_get_icon         (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         <link linkend="GtkIconTheme">GtkIconTheme</link> *icon_theme);</programlisting>
<para>
This function goes and looks for the icon file.  If the icon
is not set as an absolute filename, this will look for it in the standard places.
If it can't find the icon, it will return <link linkend="NULL:CAPS"><literal>NULL</literal></link></para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> A desktop item
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>icon_theme</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconTheme"><type>GtkIconTheme</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A newly allocated string
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-find-icon" role="function">
<title>gnome_desktop_item_find_icon ()</title>
<indexterm zone="gnome-desktop-item-find-icon"><primary>gnome_desktop_item_find_icon</primary></indexterm>
<programlisting><link linkend="char">char</link> *              gnome_desktop_item_find_icon        (<link linkend="GtkIconTheme">GtkIconTheme</link> *icon_theme,
                                                         const <link linkend="char">char</link> *icon,
                                                         <link linkend="int">int</link> desired_size,
                                                         <link linkend="int">int</link> flags);</programlisting>
<para>
This function goes and looks for the icon file.  If the icon
is not an absolute filename, this will look for it in the standard places.
If it can't find the icon, it will return <link linkend="NULL:CAPS"><literal>NULL</literal></link></para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_theme</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconTheme"><type>GtkIconTheme</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>icon</parameter>&#160;:</term>
<listitem><simpara> icon name, something you'd get out of the Icon key
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>desired_size</parameter>&#160;:</term>
<listitem><simpara> FIXME
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>flags</parameter>&#160;:</term>
<listitem><simpara> FIXME
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A newly allocated string
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-attr-exists" role="function">
<title>gnome_desktop_item_attr_exists ()</title>
<indexterm zone="gnome-desktop-item-attr-exists"><primary>gnome_desktop_item_attr_exists</primary></indexterm>
<programlisting><link linkend="gboolean">gboolean</link>            gnome_desktop_item_attr_exists      (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attr</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-get-string" role="function">
<title>gnome_desktop_item_get_string ()</title>
<indexterm zone="gnome-desktop-item-get-string"><primary>gnome_desktop_item_get_string</primary></indexterm>
<programlisting>const <link linkend="char">char</link> *        gnome_desktop_item_get_string       (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attr</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-set-string" role="function">
<title>gnome_desktop_item_set_string ()</title>
<indexterm zone="gnome-desktop-item-set-string"><primary>gnome_desktop_item_set_string</primary></indexterm>
<programlisting><link linkend="void">void</link>                gnome_desktop_item_set_string       (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr,
                                                         const <link linkend="char">char</link> *value);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attr</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-get-attr-locale" role="function">
<title>gnome_desktop_item_get_attr_locale ()</title>
<indexterm zone="gnome-desktop-item-get-attr-locale"><primary>gnome_desktop_item_get_attr_locale</primary></indexterm>
<programlisting>const <link linkend="char">char</link> *        gnome_desktop_item_get_attr_locale  (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attr</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-get-localestring" role="function">
<title>gnome_desktop_item_get_localestring ()</title>
<indexterm zone="gnome-desktop-item-get-localestring"><primary>gnome_desktop_item_get_localestring</primary></indexterm>
<programlisting>const <link linkend="char">char</link> *        gnome_desktop_item_get_localestring (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attr</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-get-localestring-lang" role="function">
<title>gnome_desktop_item_get_localestring_lang ()</title>
<indexterm zone="gnome-desktop-item-get-localestring-lang"><primary>gnome_desktop_item_get_localestring_lang</primary></indexterm>
<programlisting>const <link linkend="char">char</link> *        gnome_desktop_item_get_localestring_lang
                                                        (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr,
                                                         const <link linkend="char">char</link> *language);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attr</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>language</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-get-languages" role="function">
<title>gnome_desktop_item_get_languages ()</title>
<indexterm zone="gnome-desktop-item-get-languages"><primary>gnome_desktop_item_get_languages</primary></indexterm>
<programlisting><link linkend="GList">GList</link> *             gnome_desktop_item_get_languages    (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attr</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-set-localestring" role="function">
<title>gnome_desktop_item_set_localestring ()</title>
<indexterm zone="gnome-desktop-item-set-localestring"><primary>gnome_desktop_item_set_localestring</primary></indexterm>
<programlisting><link linkend="void">void</link>                gnome_desktop_item_set_localestring (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr,
                                                         const <link linkend="char">char</link> *value);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attr</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-set-localestring-lang" role="function">
<title>gnome_desktop_item_set_localestring_lang ()</title>
<indexterm zone="gnome-desktop-item-set-localestring-lang"><primary>gnome_desktop_item_set_localestring_lang</primary></indexterm>
<programlisting><link linkend="void">void</link>                gnome_desktop_item_set_localestring_lang
                                                        (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr,
                                                         const <link linkend="char">char</link> *language,
                                                         const <link linkend="char">char</link> *value);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attr</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>language</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-clear-localestring" role="function">
<title>gnome_desktop_item_clear_localestring ()</title>
<indexterm zone="gnome-desktop-item-clear-localestring"><primary>gnome_desktop_item_clear_localestring</primary></indexterm>
<programlisting><link linkend="void">void</link>                gnome_desktop_item_clear_localestring
                                                        (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attr</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-get-strings" role="function">
<title>gnome_desktop_item_get_strings ()</title>
<indexterm zone="gnome-desktop-item-get-strings"><primary>gnome_desktop_item_get_strings</primary></indexterm>
<programlisting><link linkend="char">char</link> **             gnome_desktop_item_get_strings      (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attr</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-set-strings" role="function">
<title>gnome_desktop_item_set_strings ()</title>
<indexterm zone="gnome-desktop-item-set-strings"><primary>gnome_desktop_item_set_strings</primary></indexterm>
<programlisting><link linkend="void">void</link>                gnome_desktop_item_set_strings      (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr,
                                                         <link linkend="char">char</link> **strings);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attr</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>strings</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-get-boolean" role="function">
<title>gnome_desktop_item_get_boolean ()</title>
<indexterm zone="gnome-desktop-item-get-boolean"><primary>gnome_desktop_item_get_boolean</primary></indexterm>
<programlisting><link linkend="gboolean">gboolean</link>            gnome_desktop_item_get_boolean      (const <link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attr</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-set-boolean" role="function">
<title>gnome_desktop_item_set_boolean ()</title>
<indexterm zone="gnome-desktop-item-set-boolean"><primary>gnome_desktop_item_set_boolean</primary></indexterm>
<programlisting><link linkend="void">void</link>                gnome_desktop_item_set_boolean      (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *attr,
                                                         <link linkend="gboolean">gboolean</link> value);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attr</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-set-launch-time" role="function">
<title>gnome_desktop_item_set_launch_time ()</title>
<indexterm zone="gnome-desktop-item-set-launch-time"><primary>gnome_desktop_item_set_launch_time</primary></indexterm>
<programlisting><link linkend="void">void</link>                gnome_desktop_item_set_launch_time  (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         <link linkend="guint32">guint32</link> timestamp);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>timestamp</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-clear-attr" role="macro">
<title>gnome_desktop_item_clear_attr()</title>
<indexterm zone="gnome-desktop-item-clear-attr"><primary>gnome_desktop_item_clear_attr</primary></indexterm>
<programlisting>#define             gnome_desktop_item_clear_attr(item,attr)</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attr</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-desktop-item-clear-section" role="function">
<title>gnome_desktop_item_clear_section ()</title>
<indexterm zone="gnome-desktop-item-clear-section"><primary>gnome_desktop_item_clear_section</primary></indexterm>
<programlisting><link linkend="void">void</link>                gnome_desktop_item_clear_section    (<link linkend="GnomeDesktopItem">GnomeDesktopItem</link> *item,
                                                         const <link linkend="char">char</link> *section);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>section</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>

</refentry>
