<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>glibmm: Gio::AppInfo Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.2 -->
<div class="navigation" id="top">
<div class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="examples.html"><span>Examples</span></a></li>
</ul>
</div>
<div class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="classes.html"><span>Class Index</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div class="navpath">
<ul>
<li><a class="el" href="namespaceGio.html">Gio</a> </li>
<li><a class="el" href="classGio_1_1AppInfo.html">AppInfo</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pub-static-methods">Static Public Member Functions</a> |
<a href="#related">Related Functions</a> </div>
<div class="headertitle">
<h1>Gio::AppInfo Class Reference</h1> </div>
</div>
<div class="contents">
<!-- doxytag: class="Gio::AppInfo" --><!-- doxytag: inherits="Glib::Interface" -->
<p>Application information, to describe applications installed on the system, and launch them. <a href="#_details">More...</a></p>
<p><code>#include <giomm/appinfo.h></code></p>
<!-- startSectionHeader --><div class="dynheader">
Inheritance diagram for Gio::AppInfo:<!-- endSectionHeader --></div>
<!-- startSectionSummary --><!-- endSectionSummary --><!-- startSectionContent --><div class="dyncontent">
<div class="center"><img src="classGio_1_1AppInfo__inherit__graph.png" border="0" usemap="#Gio_1_1AppInfo_inherit__map" alt="Inheritance graph"/></div>
<map name="Gio_1_1AppInfo_inherit__map" id="Gio_1_1AppInfo_inherit__map">
<area shape="rect" id="node9" href="classGio_1_1DesktopAppInfo.html" title="DesktopAppInfo is an implementation of AppInfo based on desktop files." alt="" coords="5,315,157,344"/><area shape="rect" id="node2" href="classGlib_1_1Interface.html" title="Glib::Interface" alt="" coords="27,160,136,189"/><area shape="rect" id="node4" href="classGlib_1_1ObjectBase.html" title="Glib::ObjectBase is a common base class for Objects and Interfaces." alt="" coords="19,83,144,112"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="24,5,139,35"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center><!-- endSectionContent --></div>
<p><a href="classGio_1_1AppInfo-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#acf86d510216c430be4735d1f7b13113e">~AppInfo</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GAppInfo* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#ab31e9bca0208159f0be42227397b8a94">gobj</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#ab31e9bca0208159f0be42227397b8a94"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const GAppInfo* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a5e52c62432a61c5380bd5dc553898251">gobj</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a5e52c62432a61c5380bd5dc553898251"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a1803e87dccb051f4fe69cb10277c6c2e">equal</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AppInfo.html">AppInfo</a> >& other) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Checks if two AppInfos are equal. <a href="#a1803e87dccb051f4fe69cb10277c6c2e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a3d929d82e4d7ae91f4d8904f91e7a1c4">get_id</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the ID of an application. <a href="#a3d929d82e4d7ae91f4d8904f91e7a1c4"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a450c7e5a59919a66f73133749c318987">get_name</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the installed name of the application. <a href="#a450c7e5a59919a66f73133749c318987"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#af7d89372dcf32cc6c25a9545a4ccffa0">get_description</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets a human-readable description of an installed application. <a href="#af7d89372dcf32cc6c25a9545a4ccffa0"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a06a665d4d812adb2eeb5c05d4c91c266">get_executable</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the executable's name for the installed application. <a href="#a06a665d4d812adb2eeb5c05d4c91c266"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#ad389c830c25f58b5ec99d247a3517939">get_commandline</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the commandline with which the application will be started. <a href="#ad389c830c25f58b5ec99d247a3517939"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1Icon.html">Icon</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a35a0c2c10ee787cc5d1d4ac7773bab0d">get_icon</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the icon for the application. <a href="#a35a0c2c10ee787cc5d1d4ac7773bab0d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< const <a class="el" href="classGio_1_1Icon.html">Icon</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a16fe789da6c7f5c8c023255b2faff226">get_icon</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the icon for the application. <a href="#a16fe789da6c7f5c8c023255b2faff226"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a4d5096988eea54e06832325276a78f2a">launch</a> (const <a class="el" href="classGlib_1_1ListHandle.html">Glib::ListHandle</a>< <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> >& files, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AppLaunchContext.html">AppLaunchContext</a> >& launch_context)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Launches the application. <a href="#a4d5096988eea54e06832325276a78f2a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a8bb534c3834b17ff80edb046ba78250e">supports_uris</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Checks if the application supports reading files and directories from URIs. <a href="#a8bb534c3834b17ff80edb046ba78250e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a6ba8d06c3f3d99f907ae1aadbd8b24da">supports_files</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Checks if the application accepts files as arguments. <a href="#a6ba8d06c3f3d99f907ae1aadbd8b24da"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a23a6ee89635a2b24468c73f137ad8de4">launch_uris</a> (const <a class="el" href="classGlib_1_1ListHandle.html">Glib::ListHandle</a>< <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> >& uris, GAppLaunchContext* launch_context)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Launches the application. <a href="#a23a6ee89635a2b24468c73f137ad8de4"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a7b374a9120926615fc7454afab6452e4">should_show</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Checks if the application info should be shown in menus that list available applications. <a href="#a7b374a9120926615fc7454afab6452e4"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#ae9c4b3e178815a1fbbd60abe69d9e0f9">can_delete</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Obtains the information whether the <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch them...">AppInfo</a> can be deleted. <a href="#ae9c4b3e178815a1fbbd60abe69d9e0f9"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a634d024dee3e412df7dc794a280a438e">do_delete</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Tries to delete a <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch them...">AppInfo</a>. <a href="#a634d024dee3e412df7dc794a280a438e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a59cefa47ef35940d5c0b74a396728808">set_as_default_for_type</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& content_type)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the application as the default handler for a given type. <a href="#a59cefa47ef35940d5c0b74a396728808"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a33b6e19f73a30f1dde7913282aa20aeb">set_as_default_for_extension</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& extension)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the application as the default handler for the given file extension. <a href="#a33b6e19f73a30f1dde7913282aa20aeb"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a0dedbcba19457176114948c80efdfbe4">add_supports_type</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& content_type)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds a content type to the application information to indicate the application is capable of opening files with the given content type. <a href="#a0dedbcba19457176114948c80efdfbe4"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a150146aaba23bfa208d5c7100d986ee9">can_remove_supports_type</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Checks if a supported content type can be removed from an application. <a href="#a150146aaba23bfa208d5c7100d986ee9"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#aa1e9856c39e12c5ad1770299e391b6c0">remove_supports_type</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& content_type)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Removes a supported type from an application, if possible. <a href="#aa1e9856c39e12c5ad1770299e391b6c0"></a><br/></td></tr>
<tr><td colspan="2"><h2><a name="pub-static-methods"></a>
Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a12bbf2ad90f8915f46c3a49b6354e8ec">add_interface</a> (GType gtype_implementer)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AppInfo.html">AppInfo</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#ac77db461b3142c9459c8c1a211672bf9">create_from_commandline</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& commandline, const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& application_name, <a class="el" href="group__giommEnums.html#gae39c1e25f40a070e1720470758a55344">AppInfoCreateFlags</a> flags)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classGlib_1_1ListHandle.html">Glib::ListHandle</a><br class="typebreak"/>
< <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AppInfo.html">AppInfo</a> > > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a21c3fa9bf0f708f3cf52ec38eb837c2e">get_all</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets a list of all of the applications currently registered on this system. <a href="#a21c3fa9bf0f708f3cf52ec38eb837c2e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classGlib_1_1ListHandle.html">Glib::ListHandle</a><br class="typebreak"/>
< <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AppInfo.html">AppInfo</a> > > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a05bb9f05067d8469f2de981794a31302">get_all_for_type</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& content_type)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets a list of all AppInfos for a given content type. <a href="#a05bb9f05067d8469f2de981794a31302"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AppInfo.html">AppInfo</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a42907d07abfa7e35e2f220436d3fcb72">get_default_for_type</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& content_type, bool must_support_uris=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch them...">AppInfo</a> that corresponds to a given content type. <a href="#a42907d07abfa7e35e2f220436d3fcb72"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AppInfo.html">AppInfo</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#ac278c0e445faed4288c6a719e059e0da">get_default_for_uri_scheme</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& uri_scheme)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the default application for launching applications using this URI scheme. <a href="#ac278c0e445faed4288c6a719e059e0da"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a01913be6448947643c9de26bddd0659c">reset_type_associations</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& content_type)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Removes all changes to the type associations done by g_app_info_set_as_default_for_type(), g_app_info_set_as_default_for_extension(), g_app_info_add_supports_type() or g_app_info_remove_supports_type(). <a href="#a01913be6448947643c9de26bddd0659c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#acf9d831fcddbf5626b1e1b9ff70c8598">launch_default_for_uri</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& uri, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AppLaunchContext.html">AppLaunchContext</a> >& context)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Utility function that launches the default application registered to handle the specified uri. <a href="#acf9d831fcddbf5626b1e1b9ff70c8598"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a164a90bd2c00e9c4acb1194c475dd5d5">launch_default_for_uri</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& uri)</td></tr>
<tr><td colspan="2"><h2><a name="related"></a>
Related Functions</h2></td></tr>
<tr><td colspan="2"><p>(Note that these are not member functions.) </p>
<br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AppInfo.html">Gio::AppInfo</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1AppInfo.html#a074ab0526fd01e5ee2daf2c81c17f552">wrap</a> (GAppInfo* object, bool take_copy=false)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="el" href="namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#a074ab0526fd01e5ee2daf2c81c17f552"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Application information, to describe applications installed on the system, and launch them. </p>
<p>See also <a class="el" href="classGio_1_1AppLaunchContext.html" title="This is used to handle, for instance, startup notification and launching of the new application on th...">AppLaunchContext</a>.</p>
<dl class="since_2_16"><dt><b><a class="el" href="since_2_16.html#_since_2_16000014">Since glibmm 2.16:</a></b></dt><dd></dd></dl>
<hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="acf86d510216c430be4735d1f7b13113e"></a><!-- doxytag: member="Gio::AppInfo::~AppInfo" ref="acf86d510216c430be4735d1f7b13113e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual Gio::AppInfo::~AppInfo </td>
<td>(</td>
<td class="paramname"> )</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a12bbf2ad90f8915f46c3a49b6354e8ec"></a><!-- doxytag: member="Gio::AppInfo::add_interface" ref="a12bbf2ad90f8915f46c3a49b6354e8ec" args="(GType gtype_implementer)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void Gio::AppInfo::add_interface </td>
<td>(</td>
<td class="paramtype">GType </td>
<td class="paramname"> <em>gtype_implementer</em> )</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a0dedbcba19457176114948c80efdfbe4"></a><!-- doxytag: member="Gio::AppInfo::add_supports_type" ref="a0dedbcba19457176114948c80efdfbe4" args="(const std::string &content_type)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::AppInfo::add_supports_type </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>content_type</em> )</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Adds a content type to the application information to indicate the application is capable of opening files with the given content type. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">content_type</td><td>A string. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> on success, <code>false</code> on error. </dd></dl>
</div>
</div>
<a class="anchor" id="ae9c4b3e178815a1fbbd60abe69d9e0f9"></a><!-- doxytag: member="Gio::AppInfo::can_delete" ref="ae9c4b3e178815a1fbbd60abe69d9e0f9" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::AppInfo::can_delete </td>
<td>(</td>
<td class="paramname"> )</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtains the information whether the <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch them...">AppInfo</a> can be deleted. </p>
<p>See g_app_info_delete().</p>
<dl class="since_2_20"><dt><b><a class="el" href="since_2_20.html#_since_2_20000002">Since glibmm 2.20:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if <em>appinfo</em> can be deleted. </dd></dl>
</div>
</div>
<a class="anchor" id="a150146aaba23bfa208d5c7100d986ee9"></a><!-- doxytag: member="Gio::AppInfo::can_remove_supports_type" ref="a150146aaba23bfa208d5c7100d986ee9" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::AppInfo::can_remove_supports_type </td>
<td>(</td>
<td class="paramname"> )</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Checks if a supported content type can be removed from an application. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if it is possible to remove supported content types from a given <em>appinfo</em>, <code>false</code> if not. </dd></dl>
</div>
</div>
<a class="anchor" id="ac77db461b3142c9459c8c1a211672bf9"></a><!-- doxytag: member="Gio::AppInfo::create_from_commandline" ref="ac77db461b3142c9459c8c1a211672bf9" args="(const std::string &commandline, const std::string &application_name, AppInfoCreateFlags flags)" -->
<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_1AppInfo.html">AppInfo</a>> Gio::AppInfo::create_from_commandline </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>commandline</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>application_name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__giommEnums.html#gae39c1e25f40a070e1720470758a55344">AppInfoCreateFlags</a> </td>
<td class="paramname"> <em>flags</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a634d024dee3e412df7dc794a280a438e"></a><!-- doxytag: member="Gio::AppInfo::do_delete" ref="a634d024dee3e412df7dc794a280a438e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::AppInfo::do_delete </td>
<td>(</td>
<td class="paramname"> )</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Tries to delete a <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch them...">AppInfo</a>. </p>
<p>On some platforms, there may be a difference between user-defined AppInfos which can be deleted, and system-wide ones which cannot. See g_app_info_can_delete().</p>
<p>Virtual: do_delete </p>
<dl class="since_2_20"><dt><b><a class="el" href="since_2_20.html#_since_2_20000003">Since glibmm 2.20:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if <em>appinfo</em> has been deleted. </dd></dl>
</div>
</div>
<a class="anchor" id="a1803e87dccb051f4fe69cb10277c6c2e"></a><!-- doxytag: member="Gio::AppInfo::equal" ref="a1803e87dccb051f4fe69cb10277c6c2e" args="(const Glib::RefPtr< AppInfo > &other) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::AppInfo::equal </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AppInfo.html">AppInfo</a> >& </td>
<td class="paramname"> <em>other</em> )</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Checks if two AppInfos are equal. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">appinfo2</td><td>The second <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch them...">AppInfo</a>. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if <em>appinfo1</em> is equal to <em>appinfo2</em>. <code>false</code> otherwise. </dd></dl>
</div>
</div>
<a class="anchor" id="a21c3fa9bf0f708f3cf52ec38eb837c2e"></a><!-- doxytag: member="Gio::AppInfo::get_all" ref="a21c3fa9bf0f708f3cf52ec38eb837c2e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classGlib_1_1ListHandle.html">Glib::ListHandle</a><<a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGio_1_1AppInfo.html">AppInfo</a>> > Gio::AppInfo::get_all </td>
<td>(</td>
<td class="paramname"> )</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets a list of all of the applications currently registered on this system. </p>
<p>For desktop files, this includes applications that have <code>NoDisplay=true</code> set or are excluded from display by means of <code>OnlyShowIn</code> or <code>NotShowIn</code>. See g_app_info_should_show(). The returned list does not include applications which have the <code>Hidden</code> key set. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A newly allocated List of references to AppInfos. </dd></dl>
</div>
</div>
<a class="anchor" id="a05bb9f05067d8469f2de981794a31302"></a><!-- doxytag: member="Gio::AppInfo::get_all_for_type" ref="a05bb9f05067d8469f2de981794a31302" args="(const std::string &content_type)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classGlib_1_1ListHandle.html">Glib::ListHandle</a><<a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGio_1_1AppInfo.html">AppInfo</a>> > Gio::AppInfo::get_all_for_type </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>content_type</em> )</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets a list of all AppInfos for a given content type. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">content_type</td><td>The content type to find a <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch them...">AppInfo</a> for. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>List of AppInfos for given <em>content_type</em> or <code>0</code> on error. </dd></dl>
</div>
</div>
<a class="anchor" id="ad389c830c25f58b5ec99d247a3517939"></a><!-- doxytag: member="Gio::AppInfo::get_commandline" ref="ad389c830c25f58b5ec99d247a3517939" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> Gio::AppInfo::get_commandline </td>
<td>(</td>
<td class="paramname"> )</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the commandline with which the application will be started. </p>
<dl class="since_2_20"><dt><b><a class="el" href="since_2_20.html#_since_2_20000001">Since glibmm 2.20:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A string containing the <em>appinfo's</em> commandline, or <code>0</code> if this information is not available. </dd></dl>
</div>
</div>
<a class="anchor" id="a42907d07abfa7e35e2f220436d3fcb72"></a><!-- doxytag: member="Gio::AppInfo::get_default_for_type" ref="a42907d07abfa7e35e2f220436d3fcb72" args="(const std::string &content_type, bool must_support_uris=true)" -->
<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_1AppInfo.html">AppInfo</a>> Gio::AppInfo::get_default_for_type </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>content_type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>must_support_uris</em> = <code>true</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch them...">AppInfo</a> that corresponds to a given content type. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">content_type</td><td>The content type to find a <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch them...">AppInfo</a> for. </td></tr>
<tr><td class="paramname">must_support_uris</td><td>If <code>true</code>, the <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch them...">AppInfo</a> is expected to support URIs. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch them...">AppInfo</a> for given <em>content_type</em> or <code>0</code> on error. </dd></dl>
</div>
</div>
<a class="anchor" id="ac278c0e445faed4288c6a719e059e0da"></a><!-- doxytag: member="Gio::AppInfo::get_default_for_uri_scheme" ref="ac278c0e445faed4288c6a719e059e0da" args="(const std::string &uri_scheme)" -->
<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_1AppInfo.html">AppInfo</a>> Gio::AppInfo::get_default_for_uri_scheme </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>uri_scheme</em> )</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the default application for launching applications using this URI scheme. </p>
<p>A URI scheme is the initial part of the URI, up to but not including the ':', e.g. "http", "ftp" or "sip". </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">uri_scheme</td><td>A string containing a URI scheme. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch them...">AppInfo</a> for given <em>uri_scheme</em> or <code>0</code> on error. </dd></dl>
</div>
</div>
<a class="anchor" id="af7d89372dcf32cc6c25a9545a4ccffa0"></a><!-- doxytag: member="Gio::AppInfo::get_description" ref="af7d89372dcf32cc6c25a9545a4ccffa0" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> Gio::AppInfo::get_description </td>
<td>(</td>
<td class="paramname"> )</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets a human-readable description of an installed application. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A string containing a description of the application <em>appinfo</em>, or <code>0</code> if none. </dd></dl>
</div>
</div>
<a class="anchor" id="a06a665d4d812adb2eeb5c05d4c91c266"></a><!-- doxytag: member="Gio::AppInfo::get_executable" ref="a06a665d4d812adb2eeb5c05d4c91c266" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> Gio::AppInfo::get_executable </td>
<td>(</td>
<td class="paramname"> )</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the executable's name for the installed application. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A string containing the <em>appinfo's</em> application binaries name. </dd></dl>
</div>
</div>
<a class="anchor" id="a16fe789da6c7f5c8c023255b2faff226"></a><!-- doxytag: member="Gio::AppInfo::get_icon" ref="a16fe789da6c7f5c8c023255b2faff226" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><const <a class="el" href="classGio_1_1Icon.html">Icon</a>> Gio::AppInfo::get_icon </td>
<td>(</td>
<td class="paramname"> )</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the icon for the application. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The default <a class="el" href="classGio_1_1Icon.html" title="This is a very minimal interface for icons.">Icon</a> for <em>appinfo</em>. </dd></dl>
</div>
</div>
<a class="anchor" id="a35a0c2c10ee787cc5d1d4ac7773bab0d"></a><!-- doxytag: member="Gio::AppInfo::get_icon" ref="a35a0c2c10ee787cc5d1d4ac7773bab0d" args="()" -->
<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_1Icon.html">Icon</a>> Gio::AppInfo::get_icon </td>
<td>(</td>
<td class="paramname"> )</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the icon for the application. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The default <a class="el" href="classGio_1_1Icon.html" title="This is a very minimal interface for icons.">Icon</a> for <em>appinfo</em>. </dd></dl>
</div>
</div>
<a class="anchor" id="a3d929d82e4d7ae91f4d8904f91e7a1c4"></a><!-- doxytag: member="Gio::AppInfo::get_id" ref="a3d929d82e4d7ae91f4d8904f91e7a1c4" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> Gio::AppInfo::get_id </td>
<td>(</td>
<td class="paramname"> )</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the ID of an application. </p>
<p>An id is a string that identifies the application. The exact format of the id is platform dependent. For instance, on Unix this is the desktop file id from the xdg menu specification.</p>
<p>Note that the returned ID may be <code>0</code>, depending on how the <em>appinfo</em> has been constructed. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A string containing the application's ID. </dd></dl>
</div>
</div>
<a class="anchor" id="a450c7e5a59919a66f73133749c318987"></a><!-- doxytag: member="Gio::AppInfo::get_name" ref="a450c7e5a59919a66f73133749c318987" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> Gio::AppInfo::get_name </td>
<td>(</td>
<td class="paramname"> )</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the installed name of the application. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The name of the application for <em>appinfo</em>. </dd></dl>
</div>
</div>
<a class="anchor" id="ab31e9bca0208159f0be42227397b8a94"></a><!-- doxytag: member="Gio::AppInfo::gobj" ref="ab31e9bca0208159f0be42227397b8a94" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GAppInfo* Gio::AppInfo::gobj </td>
<td>(</td>
<td class="paramname"> )</td>
<td><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="classGlib_1_1Interface.html#a969e9396f75132a9577428f4fa932d42">Glib::Interface</a>.</p>
<p>Reimplemented in <a class="el" href="classGio_1_1DesktopAppInfo.html#a3098e225a5b79ac496941ae2ab804c0c">Gio::DesktopAppInfo</a>.</p>
</div>
</div>
<a class="anchor" id="a5e52c62432a61c5380bd5dc553898251"></a><!-- doxytag: member="Gio::AppInfo::gobj" ref="a5e52c62432a61c5380bd5dc553898251" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const GAppInfo* Gio::AppInfo::gobj </td>
<td>(</td>
<td class="paramname"> )</td>
<td> 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="classGlib_1_1Interface.html#a70a443071a69d3372c2cdd7128a91ed1">Glib::Interface</a>.</p>
<p>Reimplemented in <a class="el" href="classGio_1_1DesktopAppInfo.html#af6f5698a7fd78187bac77556ac54622f">Gio::DesktopAppInfo</a>.</p>
</div>
</div>
<a class="anchor" id="a4d5096988eea54e06832325276a78f2a"></a><!-- doxytag: member="Gio::AppInfo::launch" ref="a4d5096988eea54e06832325276a78f2a" args="(const Glib::ListHandle< std::string > &files, const Glib::RefPtr< AppLaunchContext > &launch_context)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::AppInfo::launch </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1ListHandle.html">Glib::ListHandle</a>< <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> >& </td>
<td class="paramname"> <em>files</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AppLaunchContext.html">AppLaunchContext</a> >& </td>
<td class="paramname"> <em>launch_context</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Launches the application. </p>
<p>Passes <em>files</em> to the launched application as arguments, using the optional <em>launch_context</em> to get information about the details of the launcher (like what screen it is on). On error, <em>error</em> will be set accordingly.</p>
<p>To launch the application without arguments pass a <code>0</code> <em>files</em> list.</p>
<p>Note that even if the launch is successful the application launched can fail to start if it runs into problems during startup. There is no way to detect this.</p>
<p>Some URIs can be changed when passed through a GFile (for instance unsupported uris with strange formats like mailto:), so if you have a textual uri you want to pass in as argument, consider using g_app_info_launch_uris() instead.</p>
<p>On UNIX, this function sets the <envar>GIO_LAUNCHED_DESKTOP_FILE</envar> environment variable with the path of the launched desktop file and <envar>GIO_LAUNCHED_DESKTOP_FILE_PID</envar> to the process id of the launched process. This can be used to ignore <envar>GIO_LAUNCHED_DESKTOP_FILE</envar>, should it be inherited by further processes. The <envar>DISPLAY</envar> and <envar>DESKTOP_STARTUP_ID</envar> environment variables are also set, based on information provided in <em>launch_context</em>. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">files</td><td>A List of <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> objects. </td></tr>
<tr><td class="paramname">launch_context</td><td>A <a class="el" href="classGio_1_1AppLaunchContext.html" title="This is used to handle, for instance, startup notification and launching of the new application on th...">AppLaunchContext</a> or <code>0</code>. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> on successful launch, <code>false</code> otherwise. </dd></dl>
</div>
</div>
<a class="anchor" id="a164a90bd2c00e9c4acb1194c475dd5d5"></a><!-- doxytag: member="Gio::AppInfo::launch_default_for_uri" ref="a164a90bd2c00e9c4acb1194c475dd5d5" args="(const std::string &uri)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static bool Gio::AppInfo::launch_default_for_uri </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>uri</em> )</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="acf9d831fcddbf5626b1e1b9ff70c8598"></a><!-- doxytag: member="Gio::AppInfo::launch_default_for_uri" ref="acf9d831fcddbf5626b1e1b9ff70c8598" args="(const std::string &uri, const Glib::RefPtr< AppLaunchContext > &context)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static bool Gio::AppInfo::launch_default_for_uri </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>uri</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AppLaunchContext.html">AppLaunchContext</a> >& </td>
<td class="paramname"> <em>context</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Utility function that launches the default application registered to handle the specified uri. </p>
<p>Synchronous I/O is done on the uri to detect the type of the file if required. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">uri</td><td>The uri to show. </td></tr>
<tr><td class="paramname">launch_context</td><td>An optional <a class="el" href="classGio_1_1AppLaunchContext.html" title="This is used to handle, for instance, startup notification and launching of the new application on th...">AppLaunchContext</a>. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> on success, <code>false</code> on error. </dd></dl>
</div>
</div>
<a class="anchor" id="a23a6ee89635a2b24468c73f137ad8de4"></a><!-- doxytag: member="Gio::AppInfo::launch_uris" ref="a23a6ee89635a2b24468c73f137ad8de4" args="(const Glib::ListHandle< std::string > &uris, GAppLaunchContext *launch_context)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::AppInfo::launch_uris </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1ListHandle.html">Glib::ListHandle</a>< <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> >& </td>
<td class="paramname"> <em>uris</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">GAppLaunchContext * </td>
<td class="paramname"> <em>launch_context</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Launches the application. </p>
<p>Passes <em>uris</em> to the launched application as arguments, using the optional <em>launch_context</em> to get information about the details of the launcher (like what screen it is on). On error, <em>error</em> will be set accordingly.</p>
<p>To lauch the application without arguments pass a <code>0</code> <em>uris</em> list.</p>
<p>Note that even if the launch is successful the application launched can fail to start if it runs into problems during startup. There is no way to detect this. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">uris</td><td>A List containing URIs to launch. </td></tr>
<tr><td class="paramname">launch_context</td><td>A <a class="el" href="classGio_1_1AppLaunchContext.html" title="This is used to handle, for instance, startup notification and launching of the new application on th...">AppLaunchContext</a> or <code>0</code>. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> on successful launch, <code>false</code> otherwise. </dd></dl>
</div>
</div>
<a class="anchor" id="aa1e9856c39e12c5ad1770299e391b6c0"></a><!-- doxytag: member="Gio::AppInfo::remove_supports_type" ref="aa1e9856c39e12c5ad1770299e391b6c0" args="(const std::string &content_type)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::AppInfo::remove_supports_type </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>content_type</em> )</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Removes a supported type from an application, if possible. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">content_type</td><td>A string. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> on success, <code>false</code> on error. </dd></dl>
</div>
</div>
<a class="anchor" id="a01913be6448947643c9de26bddd0659c"></a><!-- doxytag: member="Gio::AppInfo::reset_type_associations" ref="a01913be6448947643c9de26bddd0659c" args="(const std::string &content_type)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void Gio::AppInfo::reset_type_associations </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>content_type</em> )</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Removes all changes to the type associations done by g_app_info_set_as_default_for_type(), g_app_info_set_as_default_for_extension(), g_app_info_add_supports_type() or g_app_info_remove_supports_type(). </p>
<dl class="since_2_20"><dt><b><a class="el" href="since_2_20.html#_since_2_20000004">Since glibmm 2.20:</a></b></dt><dd></dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">content_type</td><td>A content type. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a33b6e19f73a30f1dde7913282aa20aeb"></a><!-- doxytag: member="Gio::AppInfo::set_as_default_for_extension" ref="a33b6e19f73a30f1dde7913282aa20aeb" args="(const std::string &extension)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::AppInfo::set_as_default_for_extension </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>extension</em> )</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the application as the default handler for the given file extension. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">extension</td><td>A string containing the file extension (without the dot). </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> on success, <code>false</code> on error. </dd></dl>
</div>
</div>
<a class="anchor" id="a59cefa47ef35940d5c0b74a396728808"></a><!-- doxytag: member="Gio::AppInfo::set_as_default_for_type" ref="a59cefa47ef35940d5c0b74a396728808" args="(const std::string &content_type)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::AppInfo::set_as_default_for_type </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>content_type</em> )</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the application as the default handler for a given type. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">content_type</td><td>The content type. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> on success, <code>false</code> on error. </dd></dl>
</div>
</div>
<a class="anchor" id="a7b374a9120926615fc7454afab6452e4"></a><!-- doxytag: member="Gio::AppInfo::should_show" ref="a7b374a9120926615fc7454afab6452e4" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::AppInfo::should_show </td>
<td>(</td>
<td class="paramname"> )</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Checks if the application info should be shown in menus that list available applications. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>appinfo</em> should be shown, <code>false</code> otherwise. </dd></dl>
</div>
</div>
<a class="anchor" id="a6ba8d06c3f3d99f907ae1aadbd8b24da"></a><!-- doxytag: member="Gio::AppInfo::supports_files" ref="a6ba8d06c3f3d99f907ae1aadbd8b24da" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::AppInfo::supports_files </td>
<td>(</td>
<td class="paramname"> )</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Checks if the application accepts files as arguments. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>appinfo</em> supports files. </dd></dl>
</div>
</div>
<a class="anchor" id="a8bb534c3834b17ff80edb046ba78250e"></a><!-- doxytag: member="Gio::AppInfo::supports_uris" ref="a8bb534c3834b17ff80edb046ba78250e" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::AppInfo::supports_uris </td>
<td>(</td>
<td class="paramname"> )</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Checks if the application supports reading files and directories from URIs. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>appinfo</em> supports URIs. </dd></dl>
</div>
</div>
<hr/><h2>Friends And Related Function Documentation</h2>
<a class="anchor" id="a074ab0526fd01e5ee2daf2c81c17f552"></a><!-- doxytag: member="Gio::AppInfo::wrap" ref="a074ab0526fd01e5ee2daf2c81c17f552" args="(GAppInfo *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_1AppInfo.html">Gio::AppInfo</a> > wrap </td>
<td>(</td>
<td class="paramtype">GAppInfo * </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>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [related]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>A <a class="el" href="namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">object</td><td>The C instance. </td></tr>
<tr><td class="paramname">take_copy</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>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
</div>
</div>
</div>
<hr class="footer"/><address class="footer"><small>Generated on Tue Apr 5 2011 16:07:12 for glibmm by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.2 </small></address>
</body>
</html>
