~ubuntu-branches/ubuntu/vivid/glib2.0/vivid-proposed

</tr>

<tr>

<td class="function_type">

</td>

<td class="function_name">

<a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-get-is-hidden" title="g_desktop_app_info_get_is_hidden ()">g_desktop_app_info_get_is_hidden</a> <span class="c_punctuation">()</span>

</tr>

<tr>

<td class="function_type">

</td>

<td class="function_name">

<a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-get-nodisplay" title="g_desktop_app_info_get_nodisplay ()">g_desktop_app_info_get_nodisplay</a> <span class="c_punctuation">()</span>

</tr>

<tr>

<td class="function_type">

</td>

<td class="function_name">

<a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-get-show-in" title="g_desktop_app_info_get_show_in ()">g_desktop_app_info_get_show_in</a> <span class="c_punctuation">()</span>

</tr>

<tr>

<td class="function_type">

</td>

<td class="function_name">

<a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-get-boolean" title="g_desktop_app_info_get_boolean ()">g_desktop_app_info_get_boolean</a> <span class="c_punctuation">()</span>

</tr>

<tr>

<td class="function_type">

</td>

<td class="function_name">

<a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-has-key" title="g_desktop_app_info_has_key ()">g_desktop_app_info_has_key</a> <span class="c_punctuation">()</span>

</tr>

<tr>

<td class="function_type">

</td>

<td class="function_name">

<a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-launch-uris-as-manager" title="g_desktop_app_info_launch_uris_as_manager ()">g_desktop_app_info_launch_uris_as_manager</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

</td>

<td class="function_name">

<a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-list-actions" title="g_desktop_app_info_list_actions ()">g_desktop_app_info_list_actions</a> <span class="c_punctuation">()</span>

</tr>

<tr>

<td class="function_type">

</td>

<td class="function_name">

<a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-get-action-name" title="g_desktop_app_info_get_action_name ()">g_desktop_app_info_get_action_name</a> <span class="c_punctuation">()</span>

</colgroup>

<tbody><tr>

<td class="property_type">

<td class="property_name"><a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo--filename" title="The “filename” property">filename</a></td>

<td class="property_flags">Read / Write / Construct Only</td>

</tr></tbody>

</div>

<div class="refsect1">

<a name="gio-Desktop-file-based-GAppInfo.object-hierarchy"></a><h2>Object Hierarchy</h2>

    <span class="lineart">╰──</span> GDesktopAppInfo

</pre>

</div>

</div>

<div class="refsect3">

<a name="id-1.4.8.5.11.2.6"></a><h4>Returns</h4>

<p></p>

</div>

</div>

<div class="refsect2">

<a name="g-desktop-app-info-new-from-keyfile"></a><h3>g_desktop_app_info_new_from_keyfile ()</h3>

<pre class="programlisting"><a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="returnvalue">GDesktopAppInfo</span></a> *

<p>Creates a new <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a>.</p>

<div class="refsect3">

<a name="id-1.4.8.5.11.3.5"></a><h4>Parameters</h4>

</colgroup>

<tbody><tr>

<td class="parameter_name"><p>key_file</p></td>

<td class="parameter_annotations"> </td>

</tr></tbody>

</table></div>

</div>

<div class="refsect3">

<a name="id-1.4.8.5.11.3.6"></a><h4>Returns</h4>

<p></p>

</div>

<p class="since">Since 2.18</p>

</div>

<div class="refsect3">

<a name="id-1.4.8.5.11.4.7"></a><h4>Returns</h4>

<p></p>

</div>

</div>

<p>When <em class="parameter"><code>info</code></em>

 was created from a known filename, return it.  In some

situations such as the <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a> returned from

<div class="refsect3">

<a name="id-1.4.8.5.11.5.5"></a><h4>Parameters</h4>

<div class="informaltable"><table width="100%" border="0">

<div class="refsect3">

<a name="id-1.4.8.5.11.5.6"></a><h4>Returns</h4>

<p> The full path to the file for <em class="parameter"><code>info</code></em>

<p></p>

</div>

<p class="since">Since 2.24</p>

<hr>

<div class="refsect2">

<a name="g-desktop-app-info-get-is-hidden"></a><h3>g_desktop_app_info_get_is_hidden ()</h3>

g_desktop_app_info_get_is_hidden (<em class="parameter"><code><a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a> *info</code></em>);</pre>

<p>A desktop file is hidden if the Hidden key in it is

set to True.</p>

</div>

<div class="refsect3">

<a name="id-1.4.8.5.11.6.6"></a><h4>Returns</h4>

<p></p>

</div>

</div>

<hr>

<div class="refsect2">

<a name="g-desktop-app-info-get-nodisplay"></a><h3>g_desktop_app_info_get_nodisplay ()</h3>

g_desktop_app_info_get_nodisplay (<em class="parameter"><code><a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a> *info</code></em>);</pre>

<p>Gets the value of the NoDisplay key, which helps determine if the

application info should be shown in menus. See

<div class="refsect3">

<a name="id-1.4.8.5.11.7.5"></a><h4>Parameters</h4>

<div class="informaltable"><table width="100%" border="0">

<hr>

<div class="refsect2">

<a name="g-desktop-app-info-get-show-in"></a><h3>g_desktop_app_info_get_show_in ()</h3>

g_desktop_app_info_get_show_in (<em class="parameter"><code><a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a> *info</code></em>,

<p>Checks if the application info should be shown in menus that list available

applications for a specific name of the desktop, based on the

<code class="literal">OnlyShowIn</code> and <code class="literal">NotShowIn</code> keys.</p>

<p>If <em class="parameter"><code>desktop_env</code></em>

<a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-set-desktop-env" title="g_desktop_app_info_set_desktop_env ()"><code class="function">g_desktop_app_info_set_desktop_env()</code></a> is used.</p>

<p>Note that <a class="link" href="GAppInfo.html#g-app-info-should-show" title="g_app_info_should_show ()"><code class="function">g_app_info_should_show()</code></a> for <em class="parameter"><code>info</code></em>

 will include this check (with

) as well as additional checks.</p>

<div class="refsect3">

<a name="id-1.4.8.5.11.8.7"></a><h4>Parameters</h4>

</div>

<div class="refsect3">

<a name="id-1.4.8.5.11.8.8"></a><h4>Returns</h4>

should be shown in <em class="parameter"><code>desktop_env</code></em>

according to the

otherwise.</p>

<p></p>

</div>

</div>

<div class="refsect3">

<a name="id-1.4.8.5.11.12.6"></a><h4>Returns</h4>

in the desktop file. </p>

<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>

</div>

</div>

<div class="refsect3">

<a name="id-1.4.8.5.11.14.7"></a><h4>Returns</h4>

is not found</p>

<p></p>

</div>

<hr>

<div class="refsect2">

<a name="g-desktop-app-info-get-boolean"></a><h3>g_desktop_app_info_get_boolean ()</h3>

g_desktop_app_info_get_boolean (<em class="parameter"><code><a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a> *info</code></em>,

                                <em class="parameter"><code>const <span class="type">char</span> *key</code></em>);</pre>

<p>Looks up a boolean value in the keyfile backing <em class="parameter"><code>info</code></em>

</div>

<div class="refsect3">

<a name="id-1.4.8.5.11.15.7"></a><h4>Returns</h4>

is not found</p>

<p></p>

</div>

<hr>

<div class="refsect2">

<a name="g-desktop-app-info-has-key"></a><h3>g_desktop_app_info_has_key ()</h3>

g_desktop_app_info_has_key (<em class="parameter"><code><a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a> *info</code></em>,

                            <em class="parameter"><code>const <span class="type">char</span> *key</code></em>);</pre>

<p>Returns whether <em class="parameter"><code>key</code></em>

</div>

<div class="refsect3">

<a name="id-1.4.8.5.11.16.6"></a><h4>Returns</h4>

exists</p>

<p></p>

</div>

<a name="GDesktopAppLaunchCallback"></a><h3>GDesktopAppLaunchCallback ()</h3>

<pre class="programlisting"><span class="returnvalue">void</span>

<span class="c_punctuation">(</span>*GDesktopAppLaunchCallback<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a> *appinfo</code></em>,

<p>During invocation, <a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-launch-uris-as-manager" title="g_desktop_app_info_launch_uris_as_manager ()"><code class="function">g_desktop_app_info_launch_uris_as_manager()</code></a> may

create one or more child processes.  This callback is invoked once

for each, providing the process ID.</p>

<hr>

<div class="refsect2">

<a name="g-desktop-app-info-launch-uris-as-manager"></a><h3>g_desktop_app_info_launch_uris_as_manager ()</h3>

g_desktop_app_info_launch_uris_as_manager

                               (<em class="parameter"><code><a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a> *appinfo</code></em>,

                                <em class="parameter"><code><a class="link" href="GAppInfo.html#GAppLaunchContext"><span class="type">GAppLaunchContext</span></a> *launch_context</code></em>,

                                <em class="parameter"><code><a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppLaunchCallback" title="GDesktopAppLaunchCallback ()"><span class="type">GDesktopAppLaunchCallback</span></a> pid_callback</code></em>,

<p>This function performs the equivalent of <a class="link" href="GAppInfo.html#g-app-info-launch-uris" title="g_app_info_launch_uris ()"><code class="function">g_app_info_launch_uris()</code></a>,

but is intended primarily for operating system components that

launch applications.  Ordinary applications should use

, <em class="parameter"><code>user_setup</code></em>

 and <em class="parameter"><code>user_setup_data</code></em>

 are used for the

 (with

<em class="parameter"><code>pid_callback_data</code></em>

) will be called to inform about the PID of the

</tr>

<tr>

<td class="parameter_name"><p>spawn_flags</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>user_setup</p></td>

for each process. </p></td>

<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>

</tr>

</tr>

<tr>

<td class="parameter_name"><p>error</p></td>

<td class="parameter_annotations"> </td>

</tr>

</tbody>

</div>

<div class="refsect3">

<a name="id-1.4.8.5.11.18.8"></a><h4>Returns</h4>

<p></p>

</div>

</div>

<hr>

<div class="refsect2">

<a name="g-desktop-app-info-list-actions"></a><h3>g_desktop_app_info_list_actions ()</h3>

g_desktop_app_info_list_actions (<em class="parameter"><code><a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a> *info</code></em>);</pre>

<p>Returns the list of "additional application actions" supported on the

desktop file, as per the desktop file specification.</p>

</div>

<div class="refsect3">

<a name="id-1.4.8.5.11.19.7"></a><h4>Returns</h4>

<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>

</div>

<p class="since">Since 2.38</p>

<hr>

<div class="refsect2">

<a name="g-desktop-app-info-get-action-name"></a><h3>g_desktop_app_info_get_action_name ()</h3>

g_desktop_app_info_get_action_name (<em class="parameter"><code><a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a> *info</code></em>,

<p>Gets the user-visible display name of the "additional application

action" specified by <em class="parameter"><code>action_name</code></em>

.</p>

<a name="g-desktop-app-info-launch-action"></a><h3>g_desktop_app_info_launch_action ()</h3>

<pre class="programlisting"><span class="returnvalue">void</span>

g_desktop_app_info_launch_action (<em class="parameter"><code><a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a> *info</code></em>,

                                  <em class="parameter"><code><a class="link" href="GAppInfo.html#GAppLaunchContext"><span class="type">GAppLaunchContext</span></a> *launch_context</code></em>);</pre>

<p>Activates the named application action.</p>

<p>You may only call this function on action names that were

<p>Note that if the main entry of the desktop file indicates that the

application supports startup notification, and <em class="parameter"><code>launch_context</code></em>

 is

action (and as such, invocation of the action on the receiving side

must signal the end of startup notification when it is completed).

This is the expected behaviour of applications declaring additional

<a name="gio-Desktop-file-based-GAppInfo.property-details"></a><h2>Property Details</h2>

<div class="refsect2">

<a name="GDesktopAppInfo--filename"></a><h3>The <code class="literal">“filename”</code> property</h3>

<p>The origin filename of this <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a></p>

<p>Flags: Read / Write / Construct Only</p>

<p>Default value: NULL</p>