<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>glibmm 2.4: Gio::DesktopAppInfo Class Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head>
<body bgcolor="#ffffff">
<table border="0" width="100%">
<tr>
<td width="10%" height="40"><img src="../../images/gtkmm_logo.gif" alt="logo" border="0" width="100%" height="100%"/></td>
<td width="90%" height="40"><img src="../../images/top.gif" alt="top" width="100%" height="40"/></td>
</tr>
</table>
<center>
<a class="qindex" href="../../../../gtkmm-2.4/docs/index.html">Main Page</a>
<a href="../../../../gtkmm-2.4/docs/reference/html/group__Widgets.html">Widgets</a>
<a class="qindex" href="namespaces.html">glibmm Namespaces</a>
<a href="../../../../gtkmm-2.4/docs/tutorial/html/index.html"> Book</a>
</center>
<hr width="100%"/>
<!-- begin main content -->
<div id="content">
<!-- Generated by Doxygen 1.5.3 -->
<div class="nav">
<a class="el" href="namespaceGio.html">Gio</a>::<a class="el" href="classGio_1_1DesktopAppInfo.html">DesktopAppInfo</a></div>
<h1>Gio::DesktopAppInfo Class Reference</h1><!-- doxytag: class="Gio::DesktopAppInfo" --><!-- doxytag: inherits="Glib::Object,Gio::AppInfo" --><a class="el" href="classGio_1_1DesktopAppInfo.html" title="DesktopAppInfo is an implementation of AppInfo based on desktop files.">DesktopAppInfo</a> is an implementation of <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch...">AppInfo</a> based on desktop files.
<a href="#_details">More...</a>
<p>
<div class="dynheader">
Inheritance diagram for Gio::DesktopAppInfo:</div>
<div class="dynsection">
<p><center><img src="classGio_1_1DesktopAppInfo__inherit__graph.png" border="0" usemap="#Gio_1_1DesktopAppInfo__inherit__map" alt="Inheritance graph"></center>
<map name="Gio_1_1DesktopAppInfo__inherit__map">
<area shape="rect" href="classGlib_1_1Object.html" title="Glib::Object" alt="" coords="5,239,99,265"><area shape="rect" href="classGlib_1_1ObjectBase.html" title="Glib::ObjectBase is a common base class for Objects and Interfaces." alt="" coords="43,84,168,111"><area shape="rect" href="classGlib_1_1Interface.html" title="Glib::Interface" alt="" coords="109,161,221,188"><area shape="rect" href="classsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="49,7,161,33"><area shape="rect" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch..." alt="" coords="123,239,224,265"></map>
<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center></div>
<p>
<a href="classGio_1_1DesktopAppInfo-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DesktopAppInfo.html#8dbb1f225b0f9512c0cef546b7d32012">~DesktopAppInfo</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">GDesktopAppInfo* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DesktopAppInfo.html#3098e225a5b79ac496941ae2ab804c0c">gobj</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#3098e225a5b79ac496941ae2ab804c0c"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const GDesktopAppInfo* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DesktopAppInfo.html#f6f5698a7fd78187bac77556ac54622f">gobj</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#f6f5698a7fd78187bac77556ac54622f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">GDesktopAppInfo* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DesktopAppInfo.html#60fe723570666ef15c3b024bdfaf6165">gobj_copy</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. <a href="#60fe723570666ef15c3b024bdfaf6165"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DesktopAppInfo.html#23113d028a906d5b3e2626dc558f36e6">is_hidden</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A desktop file is hidden if the Hidden key in it is set to True. <a href="#23113d028a906d5b3e2626dc558f36e6"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br>
<<a class="el" href="classGio_1_1DesktopAppInfo.html">DesktopAppInfo</a>> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DesktopAppInfo.html#b6d9c00e00745f57d2e5b35f83060aad">create</a> (const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/classstd_1_1basic__string.html">std::string</a>& desktop_id)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br>
<<a class="el" href="classGio_1_1DesktopAppInfo.html">DesktopAppInfo</a>> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DesktopAppInfo.html#42dca267f3ad09aaacd4937d20e4ed1d">create_from_filename</a> (const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/classstd_1_1basic__string.html">std::string</a>& filename)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new <a class="el" href="classGio_1_1DesktopAppInfo.html" title="DesktopAppInfo is an implementation of AppInfo based on desktop files.">DesktopAppInfo</a>. <a href="#42dca267f3ad09aaacd4937d20e4ed1d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DesktopAppInfo.html#d3d07eea529c72d51aa868fe30d63392">set_desktop_env</a> (const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/classstd_1_1basic__string.html">std::string</a>& desktop_env)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the name of the desktop that the application is running in. <a href="#d3d07eea529c72d51aa868fe30d63392"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DesktopAppInfo.html#8eb1db15dace05e2f83d6f55e451105b">DesktopAppInfo</a> (const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/classstd_1_1basic__string.html">std::string</a>& desktop_id)</td></tr>
<tr><td colspan="2"><br><h2>Related Functions</h2></td></tr>
<tr><td colspan="2">(Note that these are not member functions.) <br><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br>
<<a class="el" href="classGio_1_1DesktopAppInfo.html">Gio::DesktopAppInfo</a>> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DesktopAppInfo.html#c075226810f278017e3a0fbcc372e739">wrap</a> (GDesktopAppInfo* object, bool take_copy=false)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="el" href="namespaceGlib.html#671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#c075226810f278017e3a0fbcc372e739"></a><br></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
<a class="el" href="classGio_1_1DesktopAppInfo.html" title="DesktopAppInfo is an implementation of AppInfo based on desktop files.">DesktopAppInfo</a> is an implementation of <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch...">AppInfo</a> based on desktop files.
<p>
<dl compact><dt><b><a class="el" href="newin2p16s.html#_newin2p16s000018">Since glibmm 2.16:</a></b></dt><dd></dd></dl>
<hr><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" name="8dbb1f225b0f9512c0cef546b7d32012"></a><!-- doxytag: member="Gio::DesktopAppInfo::~DesktopAppInfo" ref="8dbb1f225b0f9512c0cef546b7d32012" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual Gio::DesktopAppInfo::~DesktopAppInfo </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="8eb1db15dace05e2f83d6f55e451105b"></a><!-- doxytag: member="Gio::DesktopAppInfo::DesktopAppInfo" ref="8eb1db15dace05e2f83d6f55e451105b" args="(const std::string &desktop_id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gio::DesktopAppInfo::DesktopAppInfo </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/classstd_1_1basic__string.html">std::string</a> & </td>
<td class="paramname"> <em>desktop_id</em> </td>
<td> ) </td>
<td width="100%"><code> [explicit, protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="3098e225a5b79ac496941ae2ab804c0c"></a><!-- doxytag: member="Gio::DesktopAppInfo::gobj" ref="3098e225a5b79ac496941ae2ab804c0c" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GDesktopAppInfo* Gio::DesktopAppInfo::gobj </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Provides access to the underlying C GObject.
<p>
<p>Reimplemented from <a class="el" href="classGio_1_1AppInfo.html#b31e9bca0208159f0be42227397b8a94">Gio::AppInfo</a>.</p>
</div>
</div><p>
<a class="anchor" name="f6f5698a7fd78187bac77556ac54622f"></a><!-- doxytag: member="Gio::DesktopAppInfo::gobj" ref="f6f5698a7fd78187bac77556ac54622f" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const GDesktopAppInfo* Gio::DesktopAppInfo::gobj </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Provides access to the underlying C GObject.
<p>
<p>Reimplemented from <a class="el" href="classGio_1_1AppInfo.html#5e52c62432a61c5380bd5dc553898251">Gio::AppInfo</a>.</p>
</div>
</div><p>
<a class="anchor" name="60fe723570666ef15c3b024bdfaf6165"></a><!-- doxytag: member="Gio::DesktopAppInfo::gobj_copy" ref="60fe723570666ef15c3b024bdfaf6165" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GDesktopAppInfo* Gio::DesktopAppInfo::gobj_copy </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
<p>
</div>
</div><p>
<a class="anchor" name="b6d9c00e00745f57d2e5b35f83060aad"></a><!-- doxytag: member="Gio::DesktopAppInfo::create" ref="b6d9c00e00745f57d2e5b35f83060aad" args="(const std::string &desktop_id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGio_1_1DesktopAppInfo.html">DesktopAppInfo</a>> Gio::DesktopAppInfo::create </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/classstd_1_1basic__string.html">std::string</a> & </td>
<td class="paramname"> <em>desktop_id</em> </td>
<td> ) </td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="42dca267f3ad09aaacd4937d20e4ed1d"></a><!-- doxytag: member="Gio::DesktopAppInfo::create_from_filename" ref="42dca267f3ad09aaacd4937d20e4ed1d" args="(const std::string &filename)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGio_1_1DesktopAppInfo.html">DesktopAppInfo</a>> Gio::DesktopAppInfo::create_from_filename </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/classstd_1_1basic__string.html">std::string</a> & </td>
<td class="paramname"> <em>filename</em> </td>
<td> ) </td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Creates a new <a class="el" href="classGio_1_1DesktopAppInfo.html" title="DesktopAppInfo is an implementation of AppInfo based on desktop files.">DesktopAppInfo</a>.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>filename</em> </td><td>A string containing a file name. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A new <a class="el" href="classGio_1_1DesktopAppInfo.html" title="DesktopAppInfo is an implementation of AppInfo based on desktop files.">DesktopAppInfo</a> or <code>0</code> on error. </dd></dl>
</div>
</div><p>
<a class="anchor" name="23113d028a906d5b3e2626dc558f36e6"></a><!-- doxytag: member="Gio::DesktopAppInfo::is_hidden" ref="23113d028a906d5b3e2626dc558f36e6" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::DesktopAppInfo::is_hidden </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
A desktop file is hidden if the Hidden key in it is set to True.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if hidden, <code>false</code> otherwise. </dd></dl>
</div>
</div><p>
<a class="anchor" name="d3d07eea529c72d51aa868fe30d63392"></a><!-- doxytag: member="Gio::DesktopAppInfo::set_desktop_env" ref="d3d07eea529c72d51aa868fe30d63392" args="(const std::string &desktop_env)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void Gio::DesktopAppInfo::set_desktop_env </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/classstd_1_1basic__string.html">std::string</a> & </td>
<td class="paramname"> <em>desktop_env</em> </td>
<td> ) </td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the name of the desktop that the application is running in.
<p>
This is used by g_app_info_should_show() to evaluate the <code>OnlyShowIn</code> and <code>NotShowIn</code> desktop entry fields.<p>
The Desktop Menu specification recognizes the following: <simplelist> <member>GNOME</member> <member>KDE</member> <member>ROX</member> <member>XFCE</member> <member>Old</member> </simplelist><p>
Should be called only once; subsequent calls are ignored. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>desktop_env</em> </td><td>A string specifying what desktop this is. </td></tr>
</table>
</dl>
</div>
</div><p>
<hr><h2>Friends And Related Function Documentation</h2>
<a class="anchor" name="c075226810f278017e3a0fbcc372e739"></a><!-- doxytag: member="Gio::DesktopAppInfo::wrap" ref="c075226810f278017e3a0fbcc372e739" args="(GDesktopAppInfo *object, bool take_copy=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGio_1_1DesktopAppInfo.html">Gio::DesktopAppInfo</a>> wrap </td>
<td>(</td>
<td class="paramtype">GDesktopAppInfo * </td>
<td class="paramname"> <em>object</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>take_copy</em> = <code>false</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [related]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
A <a class="el" href="namespaceGlib.html#671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>object</em> </td><td>The C instance. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>take_copy</em> </td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
</div>
</div><p>
<hr>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="desktopappinfo_8h.html">desktopappinfo.h</a></ul>
</div> <!-- end main content -->
<hr><address><small>
Generated for glibmm 2.4 by <a href="http://www.doxygen.org/index.html">
Doxygen</a> 1.5.3 © 1997-2001</small></address>
</body>
</html>
