callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Move documentation to inline comments: GtkRecentChooserMenu

Browse Source
This commit is contained in:
Javier Jardón
2010-05-21 03:19:02 +02:00
parent 2f28e88dea
commit 98cee5e6e2
3 changed files with 29 additions and 92 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
docs/reference/gtk/tmpl/.gitignore vendored
View File

@ -12,6 +12,7 @@ gtkradiobutton.sgml
gtkrange.sgml gtkrange.sgml
gtkrecentaction.sgml gtkrecentaction.sgml
gtkrecentchooser.sgml gtkrecentchooser.sgml
gtkrecentchoosermenu.sgml
gtkrecentchooserwidget.sgml gtkrecentchooserwidget.sgml
gtkscalebutton.sgml gtkscalebutton.sgml
gtkseparator.sgml gtkseparator.sgml

92
docs/reference/gtk/tmpl/gtkrecentchoosermenu.sgml
View File

@ -1,92 +0,0 @@
<!-- ##### SECTION Title ##### -->
GtkRecentChooserMenu
<!-- ##### SECTION Short_Description ##### -->
Displays recently used files in a menu
<!-- ##### SECTION Long_Description ##### -->
<para>
#GtkRecentChooserMenu is a widget suitable for displaying recently used files
inside a menu. It can be used to set a sub-menu of a #GtkMenuItem using
gtk_menu_item_set_submenu(), or as the menu of a #GtkMenuToolButton.
</para>
<para>
Note that #GtkRecentChooserMenu does not have any methods of its own. Instead,
you should use the functions that work on a #GtkRecentChooser.
</para>
<para>
Note also that #GtkRecentChooserMenu does not support multiple filters, as it
has no way to let the user choose between them as the #GtkRecentChooserWidget
and #GtkRecentChooserDialog widgets do. Thus using gtk_recent_chooser_add_filter()
on a #GtkRecentChooserMenu widget will yield the same effects as using
gtk_recent_chooser_set_filter(), replacing any currently set filter
with the supplied filter; gtk_recent_chooser_remove_filter() will remove
any currently set #GtkRecentFilter object and will unset the current filter;
gtk_recent_chooser_list_filters() will return a list containing a single
#GtkRecentFilter object.
</para>
<para>
Recently used files are supported since GTK+ 2.10.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
#GtkRecentChooser
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### SECTION Image ##### -->
<!-- ##### STRUCT GtkRecentChooserMenu ##### -->
<para>
</para>
<!-- ##### ARG GtkRecentChooserMenu:show-numbers ##### -->
<para>
</para>
<!-- ##### FUNCTION gtk_recent_chooser_menu_new ##### -->
<para>
</para>
@void:
@Returns:
<!-- ##### FUNCTION gtk_recent_chooser_menu_new_for_manager ##### -->
<para>
</para>
@manager:
@Returns:
<!-- ##### FUNCTION gtk_recent_chooser_menu_get_show_numbers ##### -->
<para>
</para>
@menu:
@Returns:
<!-- ##### FUNCTION gtk_recent_chooser_menu_set_show_numbers ##### -->
<para>
</para>
@menu:
@show_numbers:

28
gtk/gtkrecentchoosermenu.c
View File

@ -47,6 +47,34 @@
#include "gtkprivate.h" #include "gtkprivate.h"
#include "gtkalias.h" #include "gtkalias.h"
/**
* SECTION:gtkrecentchoosermenu
* @Short_description: Displays recently used files in a menu
* @Title: GtkRecentChooserMenu
* @See_also:#GtkRecentChooser
*
* #GtkRecentChooserMenu is a widget suitable for displaying recently used files
* inside a menu. It can be used to set a sub-menu of a #GtkMenuItem using
* gtk_menu_item_set_submenu(), or as the menu of a #GtkMenuToolButton.
*
* Note that #GtkRecentChooserMenu does not have any methods of its own. Instead,
* you should use the functions that work on a #GtkRecentChooser.
*
* Note also that #GtkRecentChooserMenu does not support multiple filters, as it
* has no way to let the user choose between them as the #GtkRecentChooserWidget
* and #GtkRecentChooserDialog widgets do. Thus using gtk_recent_chooser_add_filter()
* on a #GtkRecentChooserMenu widget will yield the same effects as using
* gtk_recent_chooser_set_filter(), replacing any currently set filter
* with the supplied filter; gtk_recent_chooser_remove_filter() will remove
* any currently set #GtkRecentFilter object and will unset the current filter;
* gtk_recent_chooser_list_filters() will return a list containing a single
* #GtkRecentFilter object.
*
* Recently used files are supported since GTK+ 2.10.
*/
struct _GtkRecentChooserMenuPrivate struct _GtkRecentChooserMenuPrivate
{ {
/* the recent manager object */ /* the recent manager object */