← Back to branch summary

~ubuntu-branches/ubuntu/trusty/gtk+2.0/trusty-proposed

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/GtkRecentManager.html

  • Committer: Package Import Robot
  • Author(s): Iain Lane
  • Date: 2013-11-22 14:19:02 UTC
  • mfrom: (1.14.23) (72.5.30 sid)
  • Revision ID: package-import@ubuntu.com-20131122141902-0a2lnsp8ltfute54
Tags: 2.24.22-1ubuntu1
https://launchpad.net/bugs/488857
* Merge with Debian, remaining changes:
  + debian/libgtk2.0-0.symbols:
    - Add Ubuntu specific symbols
  + debian/patches/012_ubuntu-set-grab-add.patch
    - Added ubuntu_gtk_widget_set_has_grab so we can grab sliders and 
      things in menus, needed by ido
  + debian/patches/062_dnd_menubar.patch:
    - Allow click on menubars for dnd
  + debian/patches/063_treeview_almost_fixed.patch:
    - Add an ubuntu-almost-fixed-height-mode property, (required for
      software-center)
  + debian/patches/071_no_offscreen_widgets_grabbing.patch:
    - Don't let offscreen widgets do grabbing
  + debian/patches/090_logging_file_saves.patch:
    - improve the logging of saved files
  + debian/patches/092_default_to_xdg_document_dir.patch:
    - Use $XDG_DOCUMENTS_DIR as default directory rather than the home
      directory for the 'Print to File' function.
  + debian/patches/093_gtk3_gtkimage_fallbacks_use.patch:
    - Backported gtk3 patch to add a "use-fallback" property to GtkImage,
      using it "icon-name and GIcon type of GtkImages can use automatic
      fallback names.", it will be useful for the indicator stack
  + debian/patches/095_git_menus_scrolling.patch:
    - backported gtk3 commit to fix menu scrolling issues
  + debian/patches/096_git_gtkprintsettings.patch:
    - upstream git commit backported from the gtk3 serie, don't ignore the 
      gtkprintsettings resolution settings 
  + debian/patches/097_statusicon_image_fallback.patch: Make GtkStatusIcon
    images use fallbacks by default if the property is available.
  + debian/patches/098_multiarch_module_path.patch:
    - Fallback to the pre-multiarch directory for compatibility
  + debian/patches/099_printer_filename_fix.patch
    - Fix to the print dialog for print to file, make sure a non-hidden filename 
      is the default (LP: #488857)
  + debian/patches/100_overlay_scrollbar_loading.patch
    - support for dynamically loading overlay scrollbars
  + debian/patches/gtk-shell-shows-menubar.patch:
    - list gtk-shell-shows-menubar setting, that's required to have the local
      menubars hidding under unity in favor of the unity ones,

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/GtkRecentManager.html
2
2
<html>
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
 
<title>GTK+ 2 Reference Manual: GtkRecentManager</title>
 
5
<title>GtkRecentManager</title>
6
6
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7
7
<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
8
8
<link rel="up" href="RecentDocuments.html" title="Recently Used Documents">
9
9
<link rel="prev" href="RecentDocuments.html" title="Recently Used Documents">
10
10
<link rel="next" href="GtkRecentChooser.html" title="GtkRecentChooser">
11
 
<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.19 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
 
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
 
<td width="100%" align="left">
17
 
<a href="#" class="shortcut">Top</a>
 
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
 
16
<tr valign="middle">
 
17
<td><a accesskey="p" href="RecentDocuments.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
18
<td><a accesskey="u" href="RecentDocuments.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
 
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
 
20
<th width="100%" align="center">GTK+ 2 Reference Manual</th>
 
21
<td><a accesskey="n" href="GtkRecentChooser.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
22
</tr>
 
23
<tr><td colspan="5" class="shortcuts">
 
24
<a href="#GtkRecentManager.synopsis" class="shortcut">Top</a>
18
25
                   | 
19
26
                  <a href="#GtkRecentManager.description" class="shortcut">Description</a>
20
27
                   | 
23
30
                  <a href="#GtkRecentManager.properties" class="shortcut">Properties</a>
24
31
                   | 
25
32
                  <a href="#GtkRecentManager.signals" class="shortcut">Signals</a>
26
 
</td>
27
 
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
28
 
<td><a accesskey="u" href="RecentDocuments.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
29
 
<td><a accesskey="p" href="RecentDocuments.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
30
 
<td><a accesskey="n" href="GtkRecentChooser.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
31
 
</tr></table>
 
33
</td></tr>
 
34
</table>
32
35
<div class="refentry">
33
36
<a name="GtkRecentManager"></a><div class="titlepage"></div>
34
37
<div class="refnamediv"><table width="100%"><tr>
50
53
enum                <a class="link" href="GtkRecentManager.html#GtkRecentManagerError" title="enum GtkRecentManagerError">GtkRecentManagerError</a>;
51
54
<a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="returnvalue">GtkRecentManager</span></a> *  <a class="link" href="GtkRecentManager.html#gtk-recent-manager-new" title="gtk_recent_manager_new ()">gtk_recent_manager_new</a>              (<em class="parameter"><code><span class="type">void</span></code></em>);
52
55
<a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="returnvalue">GtkRecentManager</span></a> *  <a class="link" href="GtkRecentManager.html#gtk-recent-manager-get-default" title="gtk_recent_manager_get_default ()">gtk_recent_manager_get_default</a>      (<em class="parameter"><code><span class="type">void</span></code></em>);
53
 
<a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="returnvalue">GtkRecentManager</span></a> *  <a class="link" href="GtkRecentManager.html#gtk-recent-manager-get-for-screen" title="gtk_recent_manager_get_for_screen ()">gtk_recent_manager_get_for_screen</a>   (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);
 
56
<a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="returnvalue">GtkRecentManager</span></a> *  <a class="link" href="GtkRecentManager.html#gtk-recent-manager-get-for-screen" title="gtk_recent_manager_get_for_screen ()">gtk_recent_manager_get_for_screen</a>   (<em class="parameter"><code><a href="../gdk2/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);
54
57
<span class="returnvalue">void</span>                <a class="link" href="GtkRecentManager.html#gtk-recent-manager-set-screen" title="gtk_recent_manager_set_screen ()">gtk_recent_manager_set_screen</a>       (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
55
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);
 
58
                                                         <em class="parameter"><code><a href="../gdk2/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);
56
59
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkRecentManager.html#gtk-recent-manager-add-item" title="gtk_recent_manager_add_item ()">gtk_recent_manager_add_item</a>         (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
57
60
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *uri</code></em>);
58
61
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkRecentManager.html#gtk-recent-manager-add-full" title="gtk_recent_manager_add_full ()">gtk_recent_manager_add_full</a>         (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
102
105
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *group_name</code></em>);
103
106
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkRecentManager.html#gtk-recent-info-has-application" title="gtk_recent_info_has_application ()">gtk_recent_info_has_application</a>     (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>,
104
107
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *app_name</code></em>);
105
 
<span class="returnvalue">GdkPixbuf</span> *         <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-icon" title="gtk_recent_info_get_icon ()">gtk_recent_info_get_icon</a>            (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>,
 
108
<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-icon" title="gtk_recent_info_get_icon ()">gtk_recent_info_get_icon</a>            (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>,
106
109
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>);
107
110
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-short-name" title="gtk_recent_info_get_short_name ()">gtk_recent_info_get_short_name</a>      (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
108
111
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-uri-display" title="gtk_recent_info_get_uri_display ()">gtk_recent_info_get_uri_display</a>     (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
150
153
The <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> acts like a database of all the recently
151
154
used files.  You can create new <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> objects, but
152
155
it is more efficient to use the standard recent manager for
153
 
the <a href="http://library.gnome.org/devel/gdk3/GdkScreen.html"><span class="type">GdkScreen</span></a> so that informations about the recently used
 
156
the <a href="../gdk2/GdkScreen.html"><span class="type">GdkScreen</span></a> so that informations about the recently used
154
157
files is shared with other people using them.  In case the
155
158
default screen is being used, adding a new recently used
156
159
file is as simple as:
425
428
<hr>
426
429
<div class="refsect2">
427
430
<a name="gtk-recent-manager-get-for-screen"></a><h3>gtk_recent_manager_get_for_screen ()</h3>
428
 
<pre class="programlisting"><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="returnvalue">GtkRecentManager</span></a> *  gtk_recent_manager_get_for_screen   (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
429
 
<div class="warning">
 
431
<pre class="programlisting"><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="returnvalue">GtkRecentManager</span></a> *  gtk_recent_manager_get_for_screen   (<em class="parameter"><code><a href="../gdk2/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
 
432
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
430
433
<h3 class="title">Warning</h3>
431
434
<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
432
435
  not be used in newly written code. Calling this function is
450
453
<tbody>
451
454
<tr>
452
455
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
453
 
<td>a <a href="http://library.gnome.org/devel/gdk3/GdkScreen.html"><span class="type">GdkScreen</span></a>
 
456
<td>a <a href="../gdk2/GdkScreen.html"><span class="type">GdkScreen</span></a>
454
457
</td>
455
458
</tr>
456
459
<tr>
468
471
<div class="refsect2">
469
472
<a name="gtk-recent-manager-set-screen"></a><h3>gtk_recent_manager_set_screen ()</h3>
470
473
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_recent_manager_set_screen       (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
471
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
472
 
<div class="warning">
 
474
                                                         <em class="parameter"><code><a href="../gdk2/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
 
475
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
473
476
<h3 class="title">Warning</h3>
474
477
<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
475
478
  not be used in newly written code. Calling this function has
493
496
</tr>
494
497
<tr>
495
498
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
496
 
<td>a <a href="http://library.gnome.org/devel/gdk3/GdkScreen.html"><span class="type">GdkScreen</span></a>
 
499
<td>a <a href="../gdk2/GdkScreen.html"><span class="type">GdkScreen</span></a>
497
500
</td>
498
501
</tr>
499
502
</tbody>
770
773
<div class="refsect2">
771
774
<a name="gtk-recent-manager-get-limit"></a><h3>gtk_recent_manager_get_limit ()</h3>
772
775
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_recent_manager_get_limit        (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>);</pre>
773
 
<div class="warning">
 
776
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
774
777
<h3 class="title">Warning</h3>
775
778
<p><code class="literal">gtk_recent_manager_get_limit</code> has been deprecated since version 2.22 and should not be used in newly-written code. The length of the list should be managed by the
776
779
  view (implementing <a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a>), and not by the model (the
804
807
<a name="gtk-recent-manager-set-limit"></a><h3>gtk_recent_manager_set_limit ()</h3>
805
808
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_recent_manager_set_limit        (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
806
809
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> limit</code></em>);</pre>
807
 
<div class="warning">
 
810
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
808
811
<h3 class="title">Warning</h3>
809
812
<p><code class="literal">gtk_recent_manager_set_limit</code> has been deprecated since version 2.22 and should not be used in newly-written code. The length of the list should be managed by the
810
813
  view (implementing <a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a>), and not by the model (the
1393
1396
<hr>
1394
1397
<div class="refsect2">
1395
1398
<a name="gtk-recent-info-get-icon"></a><h3>gtk_recent_info_get_icon ()</h3>
1396
 
<pre class="programlisting"><span class="returnvalue">GdkPixbuf</span> *         gtk_recent_info_get_icon            (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>,
 
1399
<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         gtk_recent_info_get_icon            (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>,
1397
1400
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>);</pre>
1398
1401
<p>
1399
1402
Retrieves the icon of size <em class="parameter"><code>size</code></em> associated to the resource MIME type.
1415
1418
</tr>
1416
1419
<tr>
1417
1420
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1418
 
<td>a <span class="type">GdkPixbuf</span> containing the icon,
 
1421
<td>a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> containing the icon,
1419
1422
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> when finished using the icon. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1420
1423
</td>
1421
1424
</tr>
1617
1620
<div class="refsect2">
1618
1621
<a name="GtkRecentManager--limit"></a><h3>The <code class="literal">"limit"</code> property</h3>
1619
1622
<pre class="programlisting">  "limit"                    <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
1620
 
<div class="warning">
 
1623
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1621
1624
<h3 class="title">Warning</h3>
1622
1625
<p><code class="literal">GtkRecentManager:limit</code> has been deprecated since version 2.22 and should not be used in newly-written code. Setting this property does not have any effect.
1623
1626
  The length of the list should be managed by the view (implementing
1676
1679
</div>
1677
1680
<div class="footer">
1678
1681
<hr>
1679
 
          Generated by GTK-Doc V1.19.1</div>
 
1682
          Generated by GTK-Doc V1.19</div>
1680
1683
</body>
1681
1684
</html>
 
 
b'\\ No newline at end of file'