gtkrecentmanager.html

最新gtk中文资料集

<p>
<a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> objects are expensive: be sure to create them only when
needed. You should use <a class="link" href="GtkRecentManager.html#gtk-recent-manager-get-default"><code class="function">gtk_recent_manager_get_default()</code></a> instead.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> A newly created <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> object.

</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4412057"></a><h3>
<a name="gtk-recent-manager-get-default"></a>gtk_recent_manager_get_default ()</h3>
<a class="indexterm" name="id4412073"></a><pre class="programlisting"><a class="link" href="GtkRecentManager.html" title="GtkRecentManager">GtkRecentManager</a>*   gtk_recent_manager_get_default      (void);</pre>
<p>
Gets a unique instance of <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>, that you can share
in your application without caring about memory management. The
returned instance will be freed when you application terminates.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> A unique <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>. Do not ref or unref it.

</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4412140"></a><h3>
<a name="gtk-recent-manager-get-for-screen"></a>gtk_recent_manager_get_for_screen ()</h3>
<a class="indexterm" name="id4412156"></a><a class="indexterm" name="id4412163"></a><pre class="programlisting"><a class="link" href="GtkRecentManager.html" title="GtkRecentManager">GtkRecentManager</a>*   gtk_recent_manager_get_for_screen   (<a
href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"
>GdkScreen</a> *screen);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_recent_manager_get_for_screen</code> has been deprecated since version 2.12 and should not be used in newly-written code. This function has been deprecated and should
  not be used in newly written code. Calling this function is
  equivalent to calling <a class="link" href="GtkRecentManager.html#gtk-recent-manager-get-default"><code class="function">gtk_recent_manager_get_default()</code></a>.</p>
</div>
<p>
Gets the recent manager object associated with <em class="parameter"><code>screen</code></em>; if this
function has not previously been called for the given screen,
a new recent manager object will be created and associated with
the screen. Recent manager objects are fairly expensive to create,
so using this function is usually a better choice than calling 
<a class="link" href="GtkRecentManager.html#gtk-recent-manager-new"><code class="function">gtk_recent_manager_new()</code></a> and setting the screen yourself; by using
this function a single recent manager object will be shared between
users.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>screen</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"
><span class="type">GdkScreen</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> A unique <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> associated with the given
  screen. This recent manager is associated to the with the screen
  and can be used as long as the screen is open. Do not ref or
  unref it.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4412298"></a><h3>
<a name="gtk-recent-manager-set-screen"></a>gtk_recent_manager_set_screen ()</h3>
<a class="indexterm" name="id4412314"></a><a class="indexterm" name="id4412322"></a><pre class="programlisting">void                gtk_recent_manager_set_screen       (<a class="link" href="GtkRecentManager.html" title="GtkRecentManager">GtkRecentManager</a> *manager,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"
>GdkScreen</a> *screen);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_recent_manager_set_screen</code> has been deprecated since version 2.12 and should not be used in newly-written code. This function has been deprecated and should
  not be used in newly written code. Calling this function has
  no effect.</p>
</div>
<p>
Sets the screen for a recent manager; the screen is used to
track the user's currently configured recently used documents
storage.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>manager</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>screen</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"
><span class="type">GdkScreen</span></a>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.10

</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4412430"></a><h3>
<a name="gtk-recent-manager-add-item"></a>gtk_recent_manager_add_item ()</h3>
<a class="indexterm" name="id4412447"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_recent_manager_add_item         (<a class="link" href="GtkRecentManager.html" title="GtkRecentManager">GtkRecentManager</a> *manager,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uri);</pre>
<p>
Adds a new resource, pointed by <em class="parameter"><code>uri</code></em>, into the recently used
resources list.
</p>
<p>
This function automatically retrieves some of the needed
metadata and setting other metadata to common default values; it
then feeds the data to <a class="link" href="GtkRecentManager.html#gtk-recent-manager-add-full"><code class="function">gtk_recent_manager_add_full()</code></a>.
</p>
<p>
See <a class="link" href="GtkRecentManager.html#gtk-recent-manager-add-full"><code class="function">gtk_recent_manager_add_full()</code></a> if you want to explicitly
define the metadata for the resource pointed by <em class="parameter"><code>uri</code></em>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>manager</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uri</code></em>&#160;:</span></p></td>
<td> a valid URI
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the new item was successfully added
  to the recently used resources list

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4412600"></a><h3>
<a name="gtk-recent-manager-add-full"></a>gtk_recent_manager_add_full ()</h3>
<a class="indexterm" name="id4412615"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_recent_manager_add_full         (<a class="link" href="GtkRecentManager.html" title="GtkRecentManager">GtkRecentManager</a> *manager,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uri,
                                                         const <a class="link" href="GtkRecentManager.html#GtkRecentData">GtkRecentData</a> *recent_data);</pre>
<p>
Adds a new resource, pointed by <em class="parameter"><code>uri</code></em>, into the recently used
resources list, using the metadata specified inside the <a class="link" href="GtkRecentManager.html#GtkRecentData"><span class="type">GtkRecentData</span></a>
structure passed in <em class="parameter"><code>recent_data</code></em>.
</p>
<p>
The passed URI will be used to identify this resource inside the
list.
</p>
<p>
In order to register the new recently used resource, metadata about
the resource must be passed as well as the URI; the metadata is
stored in a <a class="link" href="GtkRecentManager.html#GtkRecentData"><span class="type">GtkRecentData</span></a> structure, which must contain the MIME
type of the resource pointed by the URI; the name of the application
that is registering the item, and a command line to be used when
launching the item.
</p>
<p>
Optionally, a <a class="link" href="GtkRecentManager.html#GtkRecentData"><span class="type">GtkRecentData</span></a> structure might contain a UTF-8 string
to be used when viewing the item instead of the last component of the
URI; a short description of the item; whether the item should be
considered private - that is, should be displayed only by the
applications that have registered it.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>manager</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uri</code></em>&#160;:</span></p></td>
<td> a valid URI
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>recent_data</code></em>&#160;:</span></p></td>
<td> metadata of the resource
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the new item was successfully added to the
recently used resources list, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> otherwise.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4412816"></a><h3>
<a name="gtk-recent-manager-remove-item"></a>gtk_recent_manager_remove_item ()</h3>
<a class="indexterm" name="id4412831"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_recent_manager_remove_item      (<a class="link" href="GtkRecentManager.html" title="GtkRecentManager">GtkRecentManager</a> *manager,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *uri,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Removes a resource pointed by <em class="parameter"><code>uri</code></em> from the recently used resources
list handled by a recent manager.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">