gtkrecentchooser.html

最新gtk中文资料集

<pre class="synopsis">

  "<a class="link" href="GtkRecentChooser.html#GtkRecentChooser--filter">filter</a>"                   <a class="link" href="GtkRecentFilter.html" title="GtkRecentFilter">GtkRecentFilter</a>       : Read / Write
  "<a class="link" href="GtkRecentChooser.html#GtkRecentChooser--limit">limit</a>"                    <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read / Write
  "<a class="link" href="GtkRecentChooser.html#GtkRecentChooser--local-only">local-only</a>"               <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write
  "<a class="link" href="GtkRecentChooser.html#GtkRecentChooser--recent-manager">recent-manager</a>"           <a class="link" href="GtkRecentManager.html" title="GtkRecentManager">GtkRecentManager</a>      : Write / Construct Only
  "<a class="link" href="GtkRecentChooser.html#GtkRecentChooser--select-multiple">select-multiple</a>"          <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write
  "<a class="link" href="GtkRecentChooser.html#GtkRecentChooser--show-icons">show-icons</a>"               <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write
  "<a class="link" href="GtkRecentChooser.html#GtkRecentChooser--show-not-found">show-not-found</a>"           <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write
  "<a class="link" href="GtkRecentChooser.html#GtkRecentChooser--show-private">show-private</a>"             <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write
  "<a class="link" href="GtkRecentChooser.html#GtkRecentChooser--show-tips">show-tips</a>"                <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write
  "<a class="link" href="GtkRecentChooser.html#GtkRecentChooser--sort-type">sort-type</a>"                <a class="link" href="GtkRecentChooser.html#GtkRecentSortType">GtkRecentSortType</a>     : Read / Write
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id4425288"></a><h2>Signals</h2>
<pre class="synopsis">

  "<a class="link" href="GtkRecentChooser.html#GtkRecentChooser-item-activated">item-activated</a>"                                 : Run Last
  "<a class="link" href="GtkRecentChooser.html#GtkRecentChooser-selection-changed">selection-changed</a>"                              : Run Last
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id4425327"></a><h2>Description</h2>
<p>
<a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a> is an interface that can be implemented by widgets
displaying the list of recently used files.  In GTK+, the main objects
that implement this interface are <a class="link" href="GtkRecentChooserWidget.html" title="GtkRecentChooserWidget"><span class="type">GtkRecentChooserWidget</span></a>,
<a class="link" href="GtkRecentChooserDialog.html" title="GtkRecentChooserDialog"><span class="type">GtkRecentChooserDialog</span></a> and <a class="link" href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu"><span class="type">GtkRecentChooserMenu</span></a>.
</p>
<p>
Recently used files are supported since GTK+ 2.10.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id4425383"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id4425393"></a><h3>
<a name="GtkRecentChooser-struct"></a>GtkRecentChooser</h3>
<a class="indexterm" name="id4425407"></a><pre class="programlisting">typedef struct _GtkRecentChooser GtkRecentChooser;</pre>
<p>

</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4425422"></a><h3>
<a name="GtkRecentChooserIface"></a>GtkRecentChooserIface</h3>
<a class="indexterm" name="id4425435"></a><pre class="programlisting">typedef struct {
  GTypeInterface base_iface;
  
  /*
   * Methods
   */
  gboolean          (* set_current_uri)    (GtkRecentChooser  *chooser,
  					    const gchar       *uri,
  					    GError           **error);
  gchar *           (* get_current_uri)    (GtkRecentChooser  *chooser);
  gboolean          (* select_uri)         (GtkRecentChooser  *chooser,
  					    const gchar       *uri,
  					    GError           **error);
  void              (* unselect_uri)       (GtkRecentChooser  *chooser,
                                            const gchar       *uri);
  void              (* select_all)         (GtkRecentChooser  *chooser);
  void              (* unselect_all)       (GtkRecentChooser  *chooser);
  GList *           (* get_items)          (GtkRecentChooser  *chooser);
  GtkRecentManager *(* get_recent_manager) (GtkRecentChooser  *chooser);
  void              (* add_filter)         (GtkRecentChooser  *chooser,
  					    GtkRecentFilter   *filter);
  void              (* remove_filter)      (GtkRecentChooser  *chooser,
  					    GtkRecentFilter   *filter);
  GSList *          (* list_filters)       (GtkRecentChooser  *chooser);
  void              (* set_sort_func)      (GtkRecentChooser  *chooser,
  					    GtkRecentSortFunc  sort_func,
  					    gpointer           data,
  					    GDestroyNotify     destroy);
  
  /*
   * Signals
   */
  void		    (* item_activated)     (GtkRecentChooser  *chooser);
  void		    (* selection_changed)  (GtkRecentChooser  *chooser);
} GtkRecentChooserIface;
</pre>
<p>

</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4425501"></a><h3>
<a name="GTK-RECENT-CHOOSER-ERROR:CAPS"></a>GTK_RECENT_CHOOSER_ERROR</h3>
<a class="indexterm" name="id4425514"></a><pre class="programlisting">#define GTK_RECENT_CHOOSER_ERROR	(gtk_recent_chooser_error_quark ())
</pre>
<p>
Used to get the <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
><span class="type">GError</span></a> quark for <a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a> errors.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4425547"></a><h3>
<a name="GtkRecentChooserError"></a>enum GtkRecentChooserError</h3>
<a class="indexterm" name="id4425560"></a><pre class="programlisting">typedef enum
{
  GTK_RECENT_CHOOSER_ERROR_NOT_FOUND,
  GTK_RECENT_CHOOSER_ERROR_INVALID_URI
} GtkRecentChooserError;
</pre>
<p>
These identify the various errors that can occur while calling
<a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a> functions.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a name="GTK-RECENT-CHOOSER-ERROR-NOT-FOUND:CAPS"></a><code class="literal">GTK_RECENT_CHOOSER_ERROR_NOT_FOUND</code></span></p></td>
<td>Indicates that a file does not exist
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-RECENT-CHOOSER-ERROR-INVALID-URI:CAPS"></a><code class="literal">GTK_RECENT_CHOOSER_ERROR_INVALID_URI</code></span></p></td>
<td>Indicates a malformed URI

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4425638"></a><h3>
<a name="gtk-recent-chooser-set-show-private"></a>gtk_recent_chooser_set_show_private ()</h3>
<a class="indexterm" name="id4425655"></a><pre class="programlisting">void                gtk_recent_chooser_set_show_private (<a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser">GtkRecentChooser</a> *chooser,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> show_private);</pre>
<p>
Whether to show recently used resources marked registered as private.</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>chooser</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>show_private</code></em>&#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> to show private items, <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="id4425764"></a><h3>
<a name="gtk-recent-chooser-get-show-private"></a>gtk_recent_chooser_get_show_private ()</h3>
<a class="indexterm" name="id4425780"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_recent_chooser_get_show_private (<a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser">GtkRecentChooser</a> *chooser);</pre>
<p>
Returns whether <em class="parameter"><code>chooser</code></em> should display recently used resources
registered as private.</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>chooser</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a>
</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 recent chooser should show private items,
  <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="id4425883"></a><h3>
<a name="gtk-recent-chooser-set-show-not-found"></a>gtk_recent_chooser_set_show_not_found ()</h3>
<a class="indexterm" name="id4425900"></a><pre class="programlisting">void                gtk_recent_chooser_set_show_not_found
                                                        (<a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser">GtkRecentChooser</a> *chooser,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> show_not_found);</pre>
<p>
Sets whether <em class="parameter"><code>chooser</code></em> should display the recently used resources that
it didn't find.  This only applies to local resources.</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>chooser</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>show_not_found</code></em>&#160;:</span></p></td>
<td> whether to show the local items we didn't find
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4425997"></a><h3>
<a name="gtk-recent-chooser-get-show-not-found"></a>gtk_recent_chooser_get_show_not_found ()</h3>
<a class="indexterm" name="id4426012"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_recent_chooser_get_show_not_found
                                                        (<a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser">GtkRecentChooser</a> *chooser);</pre>
<p>
Retrieves whether <em class="parameter"><code>chooser</code></em> should show the recently used resources that