AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-11-08 17:50:10 +00:00
Code Issues Projects Releases Wiki Activity

Document 2.2 API additions.

Browse Source
This commit is contained in:
Matthias Clasen 2002-11-28 00:33:17 +00:00
parent 7f26dbf30a
commit 7cb3f99fc7
61 changed files with 793 additions and 123 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

51
ChangeLog
View File

@ -1,3 +1,52 @@
2002-11-28 Matthias Clasen <maclas@gmx.de>
* gdk/gdkdisplay.c:
* gdk/gdkdisplaymanager.c:
* gdk/gdk.c:
* gdk/gdkdraw.c:
* gdk/gdkevents.c:
* gdk/gdkrgb.c:
* gdk/gdkscreen.c:
* gdk/gdkwindow.c:
* gdk/x11/gdkcolor-x11.c:
* gdk/x11/gdkcursor-x11.c:
* gdk/x11/gdkdisplay-x11.c:
* gdk/x11/gdkdnd-x11.c:
* gdk/x11/gdkevents-x11.c:
* gdk/x11/gdkfont-x11.c:
* gdk/x11/gdkgc-x11.c:
* gdk/x11/gdkinput.c:
* gdk/x11/gdkkeys-x11.c:
* gdk/x11/gdkpango-x11.c:
* gdk/x11/gdkpixmap-x11.c:
* gdk/x11/gdkproperty-x11.c:
* gdk/x11/gdkscreen-x11.c:
* gdk/x11/gdkselection-x11.c:
* gdk/x11/gdkvisual-x11.c:
* gdk/x11/gdkwindow-x11.c:
* gdk/x11/gdkxid.c:
* gtk/gtkclipboard.c:
* gtk/gtkcolorsel.c:
* gtk/gtkiconfactory.c:
* gtk/gtkinvisible.c:
* gtk/gtkliststore.c:
* gtk/gtkmenu.c:
* gtk/gtkmenushell.c:
* gtk/gtknotebook.c:
* gtk/gtkplug.c:
* gtk/gtkselection.c:
* gtk/gtksettings.c:
* gtk/gtktreemodel.c:
* gtk/gtktreemodelsort.c:
* gtk/gtktreeselection.c:
* gtk/gtktreestore.c:
* gtk/gtktreeview.c:
* gtk/gtktreeviewcolumn.c:
* gtk/gtkwidget.c:
* gtk/gtkwindow.c: Document 2.2 API additions. I'm not
going to list all individual functions here; if you want to see
the list, grep for "Since: 2.2".
Tue Nov 26 13:07:56 2002 HideToshi Tajima <hidetoshi.tajima@sun.com>
* modules/input/gtkimcontextxim.c
@ -147,7 +196,7 @@ Mon Nov 25 16:58:27 2002 Owen Taylor <otaylor@redhat.com>
2002-11-25 Matthias Clasen <maclas@gmx.de>
* docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
* docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
Mon Nov 25 19:10:54 2002 Soeren Sandmann <sandmann@daimi.au.dk>

51
ChangeLog.pre-2-10
View File

@ -1,3 +1,52 @@
2002-11-28 Matthias Clasen <maclas@gmx.de>
* gdk/gdkdisplay.c:
* gdk/gdkdisplaymanager.c:
* gdk/gdk.c:
* gdk/gdkdraw.c:
* gdk/gdkevents.c:
* gdk/gdkrgb.c:
* gdk/gdkscreen.c:
* gdk/gdkwindow.c:
* gdk/x11/gdkcolor-x11.c:
* gdk/x11/gdkcursor-x11.c:
* gdk/x11/gdkdisplay-x11.c:
* gdk/x11/gdkdnd-x11.c:
* gdk/x11/gdkevents-x11.c:
* gdk/x11/gdkfont-x11.c:
* gdk/x11/gdkgc-x11.c:
* gdk/x11/gdkinput.c:
* gdk/x11/gdkkeys-x11.c:
* gdk/x11/gdkpango-x11.c:
* gdk/x11/gdkpixmap-x11.c:
* gdk/x11/gdkproperty-x11.c:
* gdk/x11/gdkscreen-x11.c:
* gdk/x11/gdkselection-x11.c:
* gdk/x11/gdkvisual-x11.c:
* gdk/x11/gdkwindow-x11.c:
* gdk/x11/gdkxid.c:
* gtk/gtkclipboard.c:
* gtk/gtkcolorsel.c:
* gtk/gtkiconfactory.c:
* gtk/gtkinvisible.c:
* gtk/gtkliststore.c:
* gtk/gtkmenu.c:
* gtk/gtkmenushell.c:
* gtk/gtknotebook.c:
* gtk/gtkplug.c:
* gtk/gtkselection.c:
* gtk/gtksettings.c:
* gtk/gtktreemodel.c:
* gtk/gtktreemodelsort.c:
* gtk/gtktreeselection.c:
* gtk/gtktreestore.c:
* gtk/gtktreeview.c:
* gtk/gtktreeviewcolumn.c:
* gtk/gtkwidget.c:
* gtk/gtkwindow.c: Document 2.2 API additions. I'm not
going to list all individual functions here; if you want to see
the list, grep for "Since: 2.2".
Tue Nov 26 13:07:56 2002 HideToshi Tajima <hidetoshi.tajima@sun.com>
* modules/input/gtkimcontextxim.c
@ -147,7 +196,7 @@ Mon Nov 25 16:58:27 2002 Owen Taylor <otaylor@redhat.com>
2002-11-25 Matthias Clasen <maclas@gmx.de>
* docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
* docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
Mon Nov 25 19:10:54 2002 Soeren Sandmann <sandmann@daimi.au.dk>

51
ChangeLog.pre-2-2
View File

@ -1,3 +1,52 @@
2002-11-28 Matthias Clasen <maclas@gmx.de>
* gdk/gdkdisplay.c:
* gdk/gdkdisplaymanager.c:
* gdk/gdk.c:
* gdk/gdkdraw.c:
* gdk/gdkevents.c:
* gdk/gdkrgb.c:
* gdk/gdkscreen.c:
* gdk/gdkwindow.c:
* gdk/x11/gdkcolor-x11.c:
* gdk/x11/gdkcursor-x11.c:
* gdk/x11/gdkdisplay-x11.c:
* gdk/x11/gdkdnd-x11.c:
* gdk/x11/gdkevents-x11.c:
* gdk/x11/gdkfont-x11.c:
* gdk/x11/gdkgc-x11.c:
* gdk/x11/gdkinput.c:
* gdk/x11/gdkkeys-x11.c:
* gdk/x11/gdkpango-x11.c:
* gdk/x11/gdkpixmap-x11.c:
* gdk/x11/gdkproperty-x11.c:
* gdk/x11/gdkscreen-x11.c:
* gdk/x11/gdkselection-x11.c:
* gdk/x11/gdkvisual-x11.c:
* gdk/x11/gdkwindow-x11.c:
* gdk/x11/gdkxid.c:
* gtk/gtkclipboard.c:
* gtk/gtkcolorsel.c:
* gtk/gtkiconfactory.c:
* gtk/gtkinvisible.c:
* gtk/gtkliststore.c:
* gtk/gtkmenu.c:
* gtk/gtkmenushell.c:
* gtk/gtknotebook.c:
* gtk/gtkplug.c:
* gtk/gtkselection.c:
* gtk/gtksettings.c:
* gtk/gtktreemodel.c:
* gtk/gtktreemodelsort.c:
* gtk/gtktreeselection.c:
* gtk/gtktreestore.c:
* gtk/gtktreeview.c:
* gtk/gtktreeviewcolumn.c:
* gtk/gtkwidget.c:
* gtk/gtkwindow.c: Document 2.2 API additions. I'm not
going to list all individual functions here; if you want to see
the list, grep for "Since: 2.2".
Tue Nov 26 13:07:56 2002 HideToshi Tajima <hidetoshi.tajima@sun.com>
* modules/input/gtkimcontextxim.c
@ -147,7 +196,7 @@ Mon Nov 25 16:58:27 2002 Owen Taylor <otaylor@redhat.com>
2002-11-25 Matthias Clasen <maclas@gmx.de>
* docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
* docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
Mon Nov 25 19:10:54 2002 Soeren Sandmann <sandmann@daimi.au.dk>

51
ChangeLog.pre-2-4
View File

@ -1,3 +1,52 @@
2002-11-28 Matthias Clasen <maclas@gmx.de>
* gdk/gdkdisplay.c:
* gdk/gdkdisplaymanager.c:
* gdk/gdk.c:
* gdk/gdkdraw.c:
* gdk/gdkevents.c:
* gdk/gdkrgb.c:
* gdk/gdkscreen.c:
* gdk/gdkwindow.c:
* gdk/x11/gdkcolor-x11.c:
* gdk/x11/gdkcursor-x11.c:
* gdk/x11/gdkdisplay-x11.c:
* gdk/x11/gdkdnd-x11.c:
* gdk/x11/gdkevents-x11.c:
* gdk/x11/gdkfont-x11.c:
* gdk/x11/gdkgc-x11.c:
* gdk/x11/gdkinput.c:
* gdk/x11/gdkkeys-x11.c:
* gdk/x11/gdkpango-x11.c:
* gdk/x11/gdkpixmap-x11.c:
* gdk/x11/gdkproperty-x11.c:
* gdk/x11/gdkscreen-x11.c:
* gdk/x11/gdkselection-x11.c:
* gdk/x11/gdkvisual-x11.c:
* gdk/x11/gdkwindow-x11.c:
* gdk/x11/gdkxid.c:
* gtk/gtkclipboard.c:
* gtk/gtkcolorsel.c:
* gtk/gtkiconfactory.c:
* gtk/gtkinvisible.c:
* gtk/gtkliststore.c:
* gtk/gtkmenu.c:
* gtk/gtkmenushell.c:
* gtk/gtknotebook.c:
* gtk/gtkplug.c:
* gtk/gtkselection.c:
* gtk/gtksettings.c:
* gtk/gtktreemodel.c:
* gtk/gtktreemodelsort.c:
* gtk/gtktreeselection.c:
* gtk/gtktreestore.c:
* gtk/gtktreeview.c:
* gtk/gtktreeviewcolumn.c:
* gtk/gtkwidget.c:
* gtk/gtkwindow.c: Document 2.2 API additions. I'm not
going to list all individual functions here; if you want to see
the list, grep for "Since: 2.2".
Tue Nov 26 13:07:56 2002 HideToshi Tajima <hidetoshi.tajima@sun.com>
* modules/input/gtkimcontextxim.c
@ -147,7 +196,7 @@ Mon Nov 25 16:58:27 2002 Owen Taylor <otaylor@redhat.com>
2002-11-25 Matthias Clasen <maclas@gmx.de>
* docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
* docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
Mon Nov 25 19:10:54 2002 Soeren Sandmann <sandmann@daimi.au.dk>

51
ChangeLog.pre-2-6
View File

@ -1,3 +1,52 @@
2002-11-28 Matthias Clasen <maclas@gmx.de>
* gdk/gdkdisplay.c:
* gdk/gdkdisplaymanager.c:
* gdk/gdk.c:
* gdk/gdkdraw.c:
* gdk/gdkevents.c:
* gdk/gdkrgb.c:
* gdk/gdkscreen.c:
* gdk/gdkwindow.c:
* gdk/x11/gdkcolor-x11.c:
* gdk/x11/gdkcursor-x11.c:
* gdk/x11/gdkdisplay-x11.c:
* gdk/x11/gdkdnd-x11.c:
* gdk/x11/gdkevents-x11.c:
* gdk/x11/gdkfont-x11.c:
* gdk/x11/gdkgc-x11.c:
* gdk/x11/gdkinput.c:
* gdk/x11/gdkkeys-x11.c:
* gdk/x11/gdkpango-x11.c:
* gdk/x11/gdkpixmap-x11.c:
* gdk/x11/gdkproperty-x11.c:
* gdk/x11/gdkscreen-x11.c:
* gdk/x11/gdkselection-x11.c:
* gdk/x11/gdkvisual-x11.c:
* gdk/x11/gdkwindow-x11.c:
* gdk/x11/gdkxid.c:
* gtk/gtkclipboard.c:
* gtk/gtkcolorsel.c:
* gtk/gtkiconfactory.c:
* gtk/gtkinvisible.c:
* gtk/gtkliststore.c:
* gtk/gtkmenu.c:
* gtk/gtkmenushell.c:
* gtk/gtknotebook.c:
* gtk/gtkplug.c:
* gtk/gtkselection.c:
* gtk/gtksettings.c:
* gtk/gtktreemodel.c:
* gtk/gtktreemodelsort.c:
* gtk/gtktreeselection.c:
* gtk/gtktreestore.c:
* gtk/gtktreeview.c:
* gtk/gtktreeviewcolumn.c:
* gtk/gtkwidget.c:
* gtk/gtkwindow.c: Document 2.2 API additions. I'm not
going to list all individual functions here; if you want to see
the list, grep for "Since: 2.2".
Tue Nov 26 13:07:56 2002 HideToshi Tajima <hidetoshi.tajima@sun.com>
* modules/input/gtkimcontextxim.c
@ -147,7 +196,7 @@ Mon Nov 25 16:58:27 2002 Owen Taylor <otaylor@redhat.com>
2002-11-25 Matthias Clasen <maclas@gmx.de>
* docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
* docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
Mon Nov 25 19:10:54 2002 Soeren Sandmann <sandmann@daimi.au.dk>

51
ChangeLog.pre-2-8
View File

@ -1,3 +1,52 @@
2002-11-28 Matthias Clasen <maclas@gmx.de>
* gdk/gdkdisplay.c:
* gdk/gdkdisplaymanager.c:
* gdk/gdk.c:
* gdk/gdkdraw.c:
* gdk/gdkevents.c:
* gdk/gdkrgb.c:
* gdk/gdkscreen.c:
* gdk/gdkwindow.c:
* gdk/x11/gdkcolor-x11.c:
* gdk/x11/gdkcursor-x11.c:
* gdk/x11/gdkdisplay-x11.c:
* gdk/x11/gdkdnd-x11.c:
* gdk/x11/gdkevents-x11.c:
* gdk/x11/gdkfont-x11.c:
* gdk/x11/gdkgc-x11.c:
* gdk/x11/gdkinput.c:
* gdk/x11/gdkkeys-x11.c:
* gdk/x11/gdkpango-x11.c:
* gdk/x11/gdkpixmap-x11.c:
* gdk/x11/gdkproperty-x11.c:
* gdk/x11/gdkscreen-x11.c:
* gdk/x11/gdkselection-x11.c:
* gdk/x11/gdkvisual-x11.c:
* gdk/x11/gdkwindow-x11.c:
* gdk/x11/gdkxid.c:
* gtk/gtkclipboard.c:
* gtk/gtkcolorsel.c:
* gtk/gtkiconfactory.c:
* gtk/gtkinvisible.c:
* gtk/gtkliststore.c:
* gtk/gtkmenu.c:
* gtk/gtkmenushell.c:
* gtk/gtknotebook.c:
* gtk/gtkplug.c:
* gtk/gtkselection.c:
* gtk/gtksettings.c:
* gtk/gtktreemodel.c:
* gtk/gtktreemodelsort.c:
* gtk/gtktreeselection.c:
* gtk/gtktreestore.c:
* gtk/gtktreeview.c:
* gtk/gtktreeviewcolumn.c:
* gtk/gtkwidget.c:
* gtk/gtkwindow.c: Document 2.2 API additions. I'm not
going to list all individual functions here; if you want to see
the list, grep for "Since: 2.2".
Tue Nov 26 13:07:56 2002 HideToshi Tajima <hidetoshi.tajima@sun.com>
* modules/input/gtkimcontextxim.c
@ -147,7 +196,7 @@ Mon Nov 25 16:58:27 2002 Owen Taylor <otaylor@redhat.com>
2002-11-25 Matthias Clasen <maclas@gmx.de>
* docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
* docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
Mon Nov 25 19:10:54 2002 Soeren Sandmann <sandmann@daimi.au.dk>

18
docs/reference/gtk/tmpl/gtk-unused.sgml
View File

@ -2192,6 +2192,15 @@ Get the type of GtkIdentifier.
@str:
@Returns:
<!-- ##### FUNCTION gtk_list_store_move ##### -->
<para>
</para>
@store:
@iter:
@position:
<!-- ##### FUNCTION gtk_list_store_new_with_types ##### -->
<para>
@ -2968,6 +2977,15 @@ a gtk_object_unref().
@tree_model:
@iter:
<!-- ##### FUNCTION gtk_tree_store_move ##### -->
<para>
</para>
@tree_store:
@iter:
@position:
<!-- ##### FUNCTION gtk_tree_store_new_with_types ##### -->
<para>

1
docs/reference/gtk/tmpl/gtkcellrenderer.sgml
View File

@ -46,6 +46,7 @@ probably has a selection colored background to render to.
@GTK_CELL_RENDERER_PRELIT: The mouse is hovering over the cell.
@GTK_CELL_RENDERER_INSENSITIVE: The cell is drawn in an insensitive manner
@GTK_CELL_RENDERER_SORTED: The cell is in a sorted row
@GTK_CELL_RENDERER_FOCUSED:
<!-- ##### ENUM GtkCellRendererMode ##### -->
<para>

5
docs/reference/gtk/tmpl/gtkcellrenderertoggle.sgml
View File

@ -82,6 +82,11 @@ GtkCellRendererToggle
</para>
<!-- ##### ARG GtkCellRendererToggle:inconsistent ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRendererToggle:radio ##### -->
<para>

10
docs/reference/gtk/tmpl/gtkliststore.sgml
View File

@ -271,13 +271,3 @@ particular row is needed often, it is worth keeping the iter around.
@b:
<!-- ##### FUNCTION gtk_list_store_move ##### -->
<para>
</para>
@store:
@iter:
@position:

12
docs/reference/gtk/tmpl/gtktreestore.sgml
View File

@ -209,7 +209,17 @@ drop</link> interfaces.
@b:
<!-- ##### FUNCTION gtk_tree_store_move ##### -->
<!-- ##### FUNCTION gtk_tree_store_move_before ##### -->
<para>
</para>
@tree_store:
@iter:
@position:
<!-- ##### FUNCTION gtk_tree_store_move_after ##### -->
<para>
</para>

7
docs/reference/gtk/tmpl/gtktreeview.sgml
View File

@ -762,6 +762,7 @@ Function used for #gtk_tree_view_map_expanded_rows.
@arg1:
@arg2:
@arg3:
@Returns:
<!-- ##### SIGNAL GtkTreeView::move-cursor ##### -->
<para>
@ -806,6 +807,7 @@ Function used for #gtk_tree_view_map_expanded_rows.
</para>
@treeview: the object which received the signal.
@Returns:
<!-- ##### SIGNAL GtkTreeView::select-cursor-parent ##### -->
<para>
@ -813,6 +815,7 @@ Function used for #gtk_tree_view_map_expanded_rows.
</para>
@treeview: the object which received the signal.
@Returns:
<!-- ##### SIGNAL GtkTreeView::select-cursor-row ##### -->
<para>
@ -821,6 +824,7 @@ Function used for #gtk_tree_view_map_expanded_rows.
@treeview: the object which received the signal.
@arg1:
@Returns:
<!-- ##### SIGNAL GtkTreeView::set-scroll-adjustments ##### -->
<para>
@ -837,6 +841,7 @@ Function used for #gtk_tree_view_map_expanded_rows.
</para>
@treeview: the object which received the signal.
@Returns:
<!-- ##### SIGNAL GtkTreeView::test-collapse-row ##### -->
<para>
@ -864,6 +869,7 @@ Function used for #gtk_tree_view_map_expanded_rows.
</para>
@treeview: the object which received the signal.
@Returns:
<!-- ##### SIGNAL GtkTreeView::unselect-all ##### -->
<para>
@ -871,6 +877,7 @@ Function used for #gtk_tree_view_map_expanded_rows.
</para>
@treeview: the object which received the signal.
@Returns:
<!-- ##### ARG GtkTreeView:enable-search ##### -->
<para>

8
docs/reference/gtk/tmpl/gtkwindow.sgml
View File

@ -774,6 +774,14 @@ Deprecated alias for gtk_window_set_position().
@Returns:
<!-- ##### FUNCTION gtk_window_set_auto_startup_notification ##### -->
<para>
</para>
@setting:
<!-- ##### FUNCTION gtk_decorated_window_init ##### -->
<para>

8
gdk-pixbuf/ChangeLog
View File

@ -1,3 +1,11 @@
2002-11-28 Matthias Clasen <maclas@gmx.de>
* gdk-pixbuf/gdk-pixbuf-io.c:
* gdk-pixbuf/gdk-pixbuf-loader.c:
* gdk-pixbuf/gdk-pixbuf.c: Document 2.2 API additions. I'm not
going to list all individual functions here; if you want to see
the list, grep for "Since: 2.2".
Fri Nov 8 19:06:07 2002 Owen Taylor <otaylor@redhat.com>
* Makefile.am (gdk-pixbuf.loaders): Make gdk-pixbuf.loaders

15
gdk-pixbuf/gdk-pixbuf-io.c
View File

@ -1002,6 +1002,8 @@ gdk_pixbuf_savev (GdkPixbuf *pixbuf,
* Returns the name of the format.
*
* Return value: the name of the format.
*
* Since: 2.2
*/
gchar *
gdk_pixbuf_format_get_name (GdkPixbufFormat *format)
@ -1018,6 +1020,8 @@ gdk_pixbuf_format_get_name (GdkPixbufFormat *format)
* Returns a description of the format.
*
* Return value: a description of the format.
*
* Since: 2.2
*/
gchar *
gdk_pixbuf_format_get_description (GdkPixbufFormat *format)
@ -1042,6 +1046,8 @@ gdk_pixbuf_format_get_description (GdkPixbufFormat *format)
* Returns the mime types supported by the format.
*
* Return value: a %NULL-terminated array of mime types.
*
* Since: 2.2
*/
gchar **
gdk_pixbuf_format_get_mime_types (GdkPixbufFormat *format)
@ -1055,9 +1061,12 @@ gdk_pixbuf_format_get_mime_types (GdkPixbufFormat *format)
* gdk_pixbuf_format_get_extensions:
* @format: a #GdkPixbufFormat
*
* Returns the filename extensions typically used for files in the given format.
* Returns the filename extensions typically used for files in the
* given format.
*
* Return value: a %NULL-terminated array of filename extensions.
*
* Since: 2.2
*/
gchar **
gdk_pixbuf_format_get_extensions (GdkPixbufFormat *format)
@ -1074,6 +1083,8 @@ gdk_pixbuf_format_get_extensions (GdkPixbufFormat *format)
* Returns whether pixbufs can be saved in the given format.
*
* Return value: whether pixbufs can be saved in the given format.
*
* Since: 2.2
*/
gboolean
gdk_pixbuf_format_is_writable (GdkPixbufFormat *format)
@ -1101,6 +1112,8 @@ _gdk_pixbuf_get_format (GdkPixbufModule *module)
* image formats. The list should be freed when it is no longer needed,
* but the structures themselves are owned by #GdkPixbuf and should not be
* freed.
*
* Since: 2.2
*/
GSList *
gdk_pixbuf_get_formats (void)

4
gdk-pixbuf/gdk-pixbuf-loader.c
View File

@ -201,6 +201,8 @@ gdk_pixbuf_loader_finalize (GObject *object)
*
* Attempts to set the desired image size are ignored after the
* emission of the ::size_prepared signal.
*
* Since: 2.2
*/
void
gdk_pixbuf_loader_set_size (GdkPixbufLoader *loader,
@ -662,6 +664,8 @@ gdk_pixbuf_loader_close (GdkPixbufLoader *loader,
*
* Returns: A #GdkPixbufFormat or %NULL. The return value is owned
* by GdkPixbuf and should not be freed.
*
* Since: 2.2
*/
GdkPixbufFormat *
gdk_pixbuf_loader_get_format (GdkPixbufLoader *loader)

2
gdk-pixbuf/gdk-pixbuf.c
View File

@ -535,6 +535,8 @@ gdk_pixbuf_get_option (GdkPixbuf *pixbuf,
* ignored and %FALSE is returned.
*
* Return value: %TRUE on success.
*
* Since: 2.2
**/
gboolean
gdk_pixbuf_set_option (GdkPixbuf *pixbuf,

4
gdk/gdk.c
View File

@ -279,6 +279,8 @@ _gdk_get_command_line_args (int *argc,
*
* You shouldn't call this function explicitely if you are using
* gtk_init(), gtk_init_check(), gdk_init(), or gdk_init_check().
*
* Since: 2.2
**/
void
gdk_parse_args (int *argc,
@ -357,6 +359,8 @@ gdk_parse_args (int *argc,
*
* Returns: the display name, if specified explicitely, otherwise %NULL
* this string is owned by GTK+ and must not be modified or freed.
*
* Since: 2.2
*/
G_CONST_RETURN gchar *
gdk_get_display_arg_name (void)

24
gdk/gdkdisplay.c
View File

@ -175,6 +175,8 @@ gdk_display_finalize (GObject *object)
*
* Closes the connection windowing system for the given display,
* and cleans up associated resources.
*
* Since: 2.2
*/
void
gdk_display_close (GdkDisplay *display)
@ -201,6 +203,8 @@ gdk_display_close (GdkDisplay *display)
*
* Return value: the next #GdkEvent to be processed, or %NULL if no events
* are pending. The returned #GdkEvent should be freed with gdk_event_free().
*
* Since: 2.2
**/
GdkEvent*
gdk_display_get_event (GdkDisplay *display)
@ -220,9 +224,11 @@ gdk_display_get_event (GdkDisplay *display)
* not get more events from the windowing system. It only checks the events
* that have already been moved to the GDK event queue.)
*
* Return value: a copy of the first #GdkEvent on the event queue, or %NULL if no
* events are in the queue. The returned #GdkEvent should be freed with
* Return value: a copy of the first #GdkEvent on the event queue, or %NULL
* if no events are in the queue. The returned #GdkEvent should be freed with
* gdk_event_free().
*
* Since: 2.2
**/
GdkEvent*
gdk_display_peek_event (GdkDisplay *display)
@ -246,6 +252,8 @@ gdk_display_peek_event (GdkDisplay *display)
*
* Appends a copy of the given event onto the front of the event
* queue for @display.
*
* Since: 2.2
**/
void
gdk_display_put_event (GdkDisplay *display,
@ -259,8 +267,8 @@ gdk_display_put_event (GdkDisplay *display,
/**
* gdk_pointer_ungrab:
* @time_: a timestamp from a #GdkEvent, or %GDK_CURRENT_TIME if no timestamp is
* available.
* @time_: a timestamp from a #GdkEvent, or %GDK_CURRENT_TIME if no
* timestamp is available.
*
* Ungrabs the pointer, if it is grabbed by this application.
**/
@ -374,6 +382,8 @@ gdk_device_get_core_pointer (void)
*
* Return value: the core pointer device; this is owned by the
* display and should not be freed.
*
* Since: 2.2
**/
GdkDevice *
gdk_display_get_core_pointer (GdkDisplay *display)
@ -435,6 +445,8 @@ _gdk_get_sm_client_id (void)
*
* Gets the current location of the pointer and the current modifier
* mask for a given display.
*
* Since: 2.2
**/
void
gdk_display_get_pointer (GdkDisplay *display,
@ -473,6 +485,8 @@ gdk_display_get_pointer (GdkDisplay *display,
* another application).
*
* Returns: the window under the mouse pointer, or %NULL
*
* Since: 2.2
**/
GdkWindow *
gdk_display_get_window_at_pointer (GdkDisplay *display,
@ -505,6 +519,8 @@ gdk_display_get_window_at_pointer (GdkDisplay *display,
* reason to use this facility.
*
* Return value: the previous pointer hook table
*
* Since: 2.2
**/
GdkDisplayPointerHooks *
gdk_display_set_pointer_hooks (GdkDisplay *display,

12
gdk/gdkdisplaymanager.c
View File

@ -160,6 +160,8 @@ gdk_display_manager_get_property (GObject *object,
*
* Returns the global #GdkDisplayManager singleton; gdk_parse_pargs(),
* gdk_init(), or gdk_init_check() must have been called first.
*
* Since: 2.2
**/
GdkDisplayManager*
gdk_display_manager_get (void)
@ -180,6 +182,8 @@ gdk_display_manager_get (void)
*
* Returns: a #GdkDisplay, or %NULL if there is no default
* display.
*
* Since: 2.2
*/
GdkDisplay *
gdk_display_manager_get_default_display (GdkDisplayManager *display_manager)
@ -198,6 +202,8 @@ gdk_display_manager_get_default_display (GdkDisplayManager *display_manager)
*
* Returns: a #GdkDisplay, or %NULL if there is no default
* display.
*
* Since: 2.2
*/
GdkDisplay *
gdk_display_get_default (void)
@ -212,6 +218,8 @@ gdk_display_get_default (void)
* gdk_display_get_default ()).
*
* Returns: a #GdkScreen, or %NULL if there is no default display.
*
* Since: 2.2
*/
GdkScreen *
gdk_screen_get_default (void)
@ -228,6 +236,8 @@ gdk_screen_get_default (void)
* @display: a #GdkDisplay
*
* Sets @display as the default display.
*
* Since: 2.2
**/
void
gdk_display_manager_set_default_display (GdkDisplayManager *display_manager,
@ -248,6 +258,8 @@ gdk_display_manager_set_default_display (GdkDisplayManager *display_manager,
*
* Return value: a newly allocated #GSList of #GdkDisplay objects.
* Free this list with g_slist_free() when you are done with it.
*
* Since: 2.2
**/
GSList *
gdk_display_manager_list_displays (GdkDisplayManager *display_manager)

17
gdk/gdkdraw.c
View File

@ -211,6 +211,8 @@ gdk_drawable_get_depth (GdkDrawable *drawable)
* Gets the #GdkScreen associated with a #GdkDrawable.
*
* Return value: the #GdkScreen associated with @drawable
*
* Since: 2.2
**/
GdkScreen*
gdk_drawable_get_screen(GdkDrawable *drawable)
@ -227,6 +229,8 @@ gdk_drawable_get_screen(GdkDrawable *drawable)
* Gets the #GdkDisplay associated with a #GdkDrawable.
*
* Return value: the #GdkDisplay associated with @drawable
*
* Since: 2.2
**/
GdkDisplay*
gdk_drawable_get_display (GdkDrawable *drawable)
@ -723,17 +727,20 @@ gdk_draw_image (GdkDrawable *drawable,
* @dest_y: Destination Y coordinate within drawable.
* @width: Width of region to render, in pixels, or -1 to use pixbuf width.
* @height: Height of region to render, in pixels, or -1 to use pixbuf height.
* @dither: Dithering mode for GdkRGB.
* @dither: Dithering mode for #GdkRGB.
* @x_dither: X offset for dither.
* @y_dither: Y offset for dither.
*
* Renders a rectangular portion of a pixbuf to a drawable. The destination
* drawable must have a colormap. All windows have a colormap, however, pixmaps
* only have colormap by default if they were created with a non-NULL window argument.
* Otherwise a colormap must be set on them with gdk_drawable_set_colormap.
* only have colormap by default if they were created with a non-%NULL window
* argument. Otherwise a colormap must be set on them with
* gdk_drawable_set_colormap().
*
* On older X servers, rendering pixbufs with an alpha channel involves round trips
* to the X server, and may be somewhat slow.
* On older X servers, rendering pixbufs with an alpha channel involves round
* trips to the X server, and may be somewhat slow.
*
* Since: 2.2
**/
void
gdk_draw_pixbuf (GdkDrawable *drawable,

14
gdk/gdkevents.c
View File

@ -268,6 +268,8 @@ static GHashTable *event_hash = NULL;
*
* Return value: a newly-allocated #GdkEvent. The returned #GdkEvent
* should be freed with gdk_event_free().
*
* Since: 2.2
**/
GdkEvent*
gdk_event_new (GdkEventType type)
@ -828,6 +830,8 @@ gdk_event_get_axis (GdkEvent *event,
* Sets the screen for @event to @screen. The event must
* have been allocated by GTK+, for instance, by
* gdk_event_copy().
*
* Since: 2.2
**/
void
gdk_event_set_screen (GdkEvent *event,
@ -847,14 +851,16 @@ gdk_event_set_screen (GdkEvent *event,
* @event: a #GdkEvent
*
* Returns the screen for the event. The screen is
* typically the screen for event->any.window, but
* typically the screen for <literal>event->any.window</literal>, but
* for events such as mouse events, it is the screen
* where the the pointer was when the event occurs -
* that is, the screen which has the root window
* to which event->motion.x_root and
* event->motion.y_root are relative.
* to which <literal>event->motion.x_root</literal> and
* <literal>event->motion.y_root</literal> are relative.
*
* Return value: the screen for the event
*
* Since: 2.2
**/
GdkScreen *
gdk_event_get_screen (GdkEvent *event)
@ -1105,6 +1111,8 @@ gdk_synthesize_window_state (GdkWindow *window,
* Sets the double click time (two clicks within this time interval
* count as a double click and result in a #GDK_2BUTTON_PRESS event).
* Applications should NOT set this, it is a global user-configured setting.
*
* Since: 2.2
**/
void
gdk_display_set_double_click_time (GdkDisplay *display,

8
gdk/gdkrgb.c
View File

@ -3488,7 +3488,7 @@ gdk_rgb_get_colormap (void)
/**
* gdk_screen_get_rgb_colormap:
* @screen : a #GdkScreen.
* @screen: a #GdkScreen.
*
* Gets the preferred colormap for rendering image data on @screen.
* Not a very useful function; historically, GDK could only render RGB
@ -3497,6 +3497,8 @@ gdk_rgb_get_colormap (void)
* call this function.
*
* Return value: the preferred colormap
*
* Since: 2.2
**/
GdkColormap *
gdk_screen_get_rgb_colormap (GdkScreen *screen)
@ -3516,7 +3518,7 @@ gdk_screen_get_rgb_colormap (GdkScreen *screen)
/**
* gdk_screen_get_rgb_visual:
* @screen : a #GdkScreen
* @screen: a #GdkScreen
*
* Gets a "preferred visual" chosen by GdkRGB for rendering image data
* on @screen. In previous versions of
@ -3526,6 +3528,8 @@ gdk_screen_get_rgb_colormap (GdkScreen *screen)
* drawables with any visual.
*
* Return value: The #GdkVisual chosen by GdkRGB.
*
* Since: 2.2
**/
GdkVisual *
gdk_screen_get_rgb_visual (GdkScreen *screen)

16
gdk/gdkscreen.c
View File

@ -92,14 +92,16 @@ _gdk_screen_close (GdkScreen *screen)
/**
* gdk_screen_get_monitor_at_point:
* @screen : a #GdkScreen.
* @x : the x coordinate in the virtual screen.
* @y : the y coordinate in the virtual screen.
* @screen: a #GdkScreen.
* @x: the x coordinate in the virtual screen.
* @y: the y coordinate in the virtual screen.
*
* Returns the monitor number in which the point (@x,@y) is located.
*
* Returns: the monitor number in which the point (@x,@y) belong, or
* -1 if the point is not in any monitor.
*
* Since: 2.2
**/
gint
gdk_screen_get_monitor_at_point (GdkScreen *screen,
@ -134,8 +136,10 @@ gdk_screen_get_monitor_at_point (GdkScreen *screen,
* @window: a #GdkWindow
* @returns: the monitor number in which most of @window is located.
*
* Returns the number of the monitor in which the largest area of the bounding rectangle
* of @window resides.
* Returns the number of the monitor in which the largest area of the
* bounding rectangle of @window resides.
*
* Since: 2.2
**/
gint
gdk_screen_get_monitor_at_window (GdkScreen *screen,
@ -171,7 +175,7 @@ gdk_screen_get_monitor_at_window (GdkScreen *screen,
*
* Returns the width of the default screen in pixels.
*
* Return value: the width of the default screen in pixels.
* Return value: the width of the default screen in pixels.
**/
gint
gdk_screen_width (void)

4
gdk/gdkwindow.c
View File

@ -694,7 +694,7 @@ gdk_window_remove_filter (GdkWindow *window,
/**
* gdk_screen_get_toplevel_windows:
* @screen : The #GdkScreen where the toplevels are located.
* @screen: The #GdkScreen where the toplevels are located.
*
* Obtains a list of all toplevel windows known to GDK on the screen @screen.
* A toplevel window is a child of the root window (see
@ -704,6 +704,8 @@ gdk_window_remove_filter (GdkWindow *window,
* its elements need not be freed.
*
* Return value: list of toplevel windows, free with g_list_free()
*
* Since: 2.2
**/
GList *
gdk_screen_get_toplevel_windows (GdkScreen *screen)

6
gdk/x11/gdkcolor-x11.c
View File

@ -376,6 +376,8 @@ gdk_colormap_sync (GdkColormap *colormap,
* Gets the system's default colormap for @screen
*
* Returns: the default colormap for @screen.
*
* Since: 2.2
*/
GdkColormap *
gdk_screen_get_system_colormap (GdkScreen *screen)
@ -1263,6 +1265,8 @@ gdk_color_change (GdkColormap *colormap,
* with gdk_x11_colormap_foreign_new(), unref'ing the last
* reference to the object will only free the #GdkColoramp
* object and not call XFreeColormap()
*
* Since: 2.2
**/
GdkColormap *
gdk_x11_colormap_foreign_new (GdkVisual *visual,
@ -1499,6 +1503,8 @@ gdk_x11_colormap_get_xcolormap (GdkColormap *colormap)
* Gets the screen for which this colormap was created.
*
* Return value: the screen for which this colormap was created.
*
* Since: 2.2
**/
GdkScreen *
gdk_colormap_get_screen (GdkColormap *cmap)

10
gdk/x11/gdkcursor-x11.c
View File

@ -98,6 +98,8 @@
* a cursor with no pixels in it.
*
* Return value: a new #GdkCursor
*
* Since: 2.2
**/
GdkCursor*
gdk_cursor_new_for_display (GdkDisplay *display,
@ -276,11 +278,13 @@ gdk_x11_cursor_get_xcursor (GdkCursor *cursor)
/**
* gdk_cursor_get_display:
* @cursor : a #GdkCursor.
* @cursor: a #GdkCursor.
*
* Returns the display on which the GdkCursor is defined
* Returns the display on which the #GdkCursor is defined.
*
* Returns : the #GdkDisplay associated to @cursor
* Returns: the #GdkDisplay associated to @cursor
*
* Since: 2.2
*/
GdkDisplay *

55
gdk/x11/gdkdisplay-x11.c
View File

@ -99,6 +99,8 @@ gdk_display_x11_class_init (GdkDisplayX11Class * class)
* could not be opened.
*
* Opens a display.
*
* Since: 2.2
*/
GdkDisplay *
gdk_display_open (const gchar *display_name)
@ -302,6 +304,8 @@ gdk_internal_connection_watch (Display *display,
*
* Returns: a string representing the display name. This string is owned
* by GDK and should not be modified or freed.
*
* Since: 2.2
*/
G_CONST_RETURN gchar *
gdk_display_get_name (GdkDisplay * display)
@ -318,6 +322,8 @@ gdk_display_get_name (GdkDisplay * display)
* Gets the number of screen managed by the @display.
*
* Returns: number of screens.
*
* Since: 2.2
*/
gint
gdk_display_get_n_screens (GdkDisplay * display)
@ -333,8 +339,10 @@ gdk_display_get_n_screens (GdkDisplay * display)
* @screen_num: the screen number
*
* Returns a screen object for one of the screens of the display.
*
*
* Returns: the #GdkScreen object
*
* Since: 2.2
*/
GdkScreen *
gdk_display_get_screen (GdkDisplay * display, gint screen_num)
@ -352,6 +360,8 @@ gdk_display_get_screen (GdkDisplay * display, gint screen_num)
* Get the default #GdkScreen for @display.
*
* Returns: the default #GdkScreen object for @display
*
* Since: 2.2
*/
GdkScreen *
gdk_display_get_default_screen (GdkDisplay * display)
@ -382,10 +392,12 @@ _gdk_x11_display_is_root_window (GdkDisplay *display,
/**
* gdk_display_pointer_ungrab:
* @display : a #GdkDisplay.
* @display: a #GdkDisplay.
* @time_: a timestap (e.g. GDK_CURRENT_TIME).
*
* Release any pointer grab.
*
* Since: 2.2
*/
void
gdk_display_pointer_ungrab (GdkDisplay *display,
@ -399,12 +411,14 @@ gdk_display_pointer_ungrab (GdkDisplay *display,
}
/**
* gdk_display_pointer_is_grabbed :
* @display : a #GdkDisplay
* gdk_display_pointer_is_grabbed:
* @display: a #GdkDisplay
*
* Test if the pointer is grabbed.
*
* Returns : TRUE if an active X pointer grab is in effect
* Returns: %TRUE if an active X pointer grab is in effect
*
* Since: 2.2
*/
gboolean
gdk_display_pointer_is_grabbed (GdkDisplay * display)
@ -416,10 +430,12 @@ gdk_display_pointer_is_grabbed (GdkDisplay * display)
/**
* gdk_display_keyboard_ungrab:
* @display : a #GdkDisplay.
* @time_ : a timestap (e.g #GDK_CURRENT_TIME).
* @display: a #GdkDisplay.
* @time_: a timestap (e.g #GDK_CURRENT_TIME).
*
* Release any keyboard grab
*
* Since: 2.2
*/
void
gdk_display_keyboard_ungrab (GdkDisplay *display,
@ -437,6 +453,7 @@ gdk_display_keyboard_ungrab (GdkDisplay *display,
*
* Emits a short beep on @display
*
* Since: 2.2
*/
void
gdk_display_beep (GdkDisplay * display)
@ -447,17 +464,20 @@ gdk_display_beep (GdkDisplay * display)
}
/**
* gdk_display_sync :
* @display : a #GdkDisplay
* gdk_display_sync:
* @display: a #GdkDisplay
*
* Flushes any requests queued for the windowing system and waits until all
* requests have been handled. This is often used for making sure that the
* display is synchronized with the current state of the program. Calling
* gdk_display_sync() before gdk_error_trap_pop() makes sure that any errors
* generated from earlier requests are handled before the error trap is removed.
* generated from earlier requests are handled before the error trap is
* removed.
*
* This is most useful for X11. On windowing systems where requests are
* handled synchronously, this function will do nothing.
*
* Since: 2.2
*/
void
gdk_display_sync (GdkDisplay * display)
@ -475,6 +495,8 @@ gdk_display_sync (GdkDisplay * display)
* To ungrab the display again, use gdk_x11_display_ungrab().
*
* gdk_x11_display_grab()/gdk_x11_display_ungrab() calls can be nested.
*
* Since: 2.2
**/
void
gdk_x11_display_grab (GdkDisplay * display)
@ -496,6 +518,8 @@ gdk_x11_display_grab (GdkDisplay * display)
*
* Ungrab @display after it has been grabbed with
* gdk_x11_display_grab().
*
* Since: 2.2
**/
void
gdk_x11_display_ungrab (GdkDisplay * display)
@ -582,6 +606,8 @@ gdk_display_x11_finalize (GObject *object)
* Find the #GdkDisplay corresponding to @display, if any exists.
*
* Return value: the #GdkDisplay, if found, otherwise %NULL.
*
* Since: 2.2
**/
GdkDisplay *
gdk_x11_lookup_xdisplay (Display *xdisplay)
@ -630,6 +656,8 @@ _gdk_x11_display_screen_for_xrootwin (GdkDisplay *display,
* @returns: an X display.
*
* Returns the X display of a #GdkDisplay.
*
* Since: 2.2
*/
Display *
gdk_x11_display_get_xdisplay (GdkDisplay *display)
@ -794,9 +822,10 @@ broadcast_xmessage (GdkDisplay *display,
* windows.
*
* GTK+ will call this function automatically after opening the first
* #GtkWindow unless
* gtk_window_set_auto_startup_notification() is called to disable
* that feature.
* #GtkWindow unless gtk_window_set_auto_startup_notification() is called
* to disable that feature.
*
* Since: 2.2
**/
void
gdk_notify_startup_complete (void)

4
gdk/x11/gdkdnd-x11.c
View File

@ -2794,6 +2794,8 @@ gdk_drag_begin (GdkWindow *window,
* support Drag and Drop.
*
* Finds out the DND protocol supported by a window.
*
* Since: 2.2
*/
guint32
gdk_drag_get_protocol_for_display (GdkDisplay *display,
@ -2909,6 +2911,8 @@ drag_context_find_window_cache (GdkDragContext *context,
*
* This function is called by the drag source to obtain the
* @dest_window and @protocol parameters for gdk_drag_motion().
*
* Since: 2.2
**/
void
gdk_drag_find_window_for_screen (GdkDragContext *context,

32
gdk/x11/gdkevents-x11.c
View File

@ -315,6 +315,7 @@ gdk_event_apply_filters (XEvent *xevent,
*
* Adds a filter to be called when X ClientMessage events are received.
*
* Since: 2.2
**/
void
gdk_display_add_client_message_filter (GdkDisplay *display,
@ -1978,17 +1979,19 @@ gdk_event_dispatch (GSource *source,
}
/**
* gdk_event_send_client_message_for_display :
* @display : the #GdkDisplay for the window where the message is to be sent.
* @event : the #GdkEvent to send, which should be a #GdkEventClient.
* @winid : the window to send the X ClientMessage event to.
* gdk_event_send_client_message_for_display:
* @display: the #GdkDisplay for the window where the message is to be sent.
* @event: the #GdkEvent to send, which should be a #GdkEventClient.
* @winid: the window to send the X ClientMessage event to.
*
* Sends an X ClientMessage event to a given window.
*
* This could be used for communicating between different applications,
* though the amount of data is limited to 20 bytes.
*
* Returns : non-zero on success.
* Returns: non-zero on success.
*
* Since: 2.2
*/
gboolean
gdk_event_send_client_message_for_display (GdkDisplay *display,
@ -2074,8 +2077,8 @@ gdk_event_send_client_message_to_all_recurse (GdkDisplay *display,
/**
* gdk_screen_broadcast_client_message:
* @screen : the #GdkScreen where the event will be broadcasted.
* @event : the #GdkEvent.
* @screen: the #GdkScreen where the event will be broadcasted.
* @event: the #GdkEvent.
*
* Sends an X ClientMessage event to all toplevel windows on @screen.
*
@ -2083,6 +2086,8 @@ gdk_event_send_client_message_to_all_recurse (GdkDisplay *display,
* as described in the Inter-Client Communication Conventions Manual (ICCCM).
* If no windows are found with the WM_STATE property set, the message is
* sent to all children of the root window.
*
* Since: 2.2
*/
void
@ -2253,6 +2258,8 @@ fetch_net_wm_check_window (GdkScreen *screen)
* Return value: the name of the window manager screen @screen, or
* "unknown" if the window manager is unknown. The string is owned by GDK
* and should not be freed.
*
* Since: 2.2
**/
const char*
gdk_x11_screen_get_window_manager_name (GdkScreen *screen)
@ -2318,13 +2325,14 @@ struct _NetWmSupportedAtoms
/**
* gdk_x11_screen_supports_net_wm_hint:
* @screen : the relevant #GdkScreen.
* @screen: the relevant #GdkScreen.
* @property: a property atom.
*
* This function is specific to the X11 backend of GDK, and indicates
* whether the window manager supports a certain hint from the
* Extended Window Manager Hints Specification. You can find this
* specification on http://www.freedesktop.org.
* specification on
* <ulink url="http://www.freedesktop.org">http://www.freedesktop.org</ulink>.
*
* When using this function, keep in mind that the window manager
* can change over time; so you shouldn't use this function in
@ -2336,6 +2344,8 @@ struct _NetWmSupportedAtoms
* a window manager change.
*
* Return value: %TRUE if the window manager supports @property
*
* Since: 2.2
**/
gboolean
gdk_x11_screen_supports_net_wm_hint (GdkScreen *screen,
@ -2518,8 +2528,10 @@ check_transform (const gchar *xsettings_name,
* FIXME needs a list of valid settings here, or a link to
* more information.
*
* Returns : %TRUE if the setting existed and a value was stored
* Returns: %TRUE if the setting existed and a value was stored
* in @value, %FALSE otherwise.
*
* Since: 2.2
**/
gboolean
gdk_screen_get_setting (GdkScreen *screen,

10
gdk/x11/gdkfont-x11.c
View File

@ -98,7 +98,9 @@ gdk_fontset_name_hash_get (GdkDisplay *display)
*
* Returns the #GdkDisplay for @font.
*
* Returns : the corresponding #GdkDisplay.
* Returns: the corresponding #GdkDisplay.
*
* Since: 2.2
**/
GdkDisplay*
gdk_font_get_display (GdkFont* font)
@ -174,6 +176,8 @@ gdk_font_hash_lookup (GdkDisplay *display,
*
* The font may be newly loaded or looked up the font in a cache.
* You should make no assumptions about the initial reference count.
*
* Since: 2.2
*/
GdkFont *
gdk_font_load_for_display (GdkDisplay *display,
@ -274,6 +278,8 @@ gdk_font_charset_for_locale (void)
*
* Return value: the newly loaded font, or %NULL if the font
* cannot be loaded.
*
* Since: 2.2
*/
GdkFont *
gdk_font_from_description_for_display (GdkDisplay *display,
@ -328,6 +334,8 @@ gdk_font_from_description_for_display (GdkDisplay *display,
*
* The fontset may be newly loaded or looked up in a cache.
* You should make no assumptions about the initial reference count.
*
* Since: 2.2
*/
GdkFont *
gdk_fontset_load_for_display (GdkDisplay *display,

2
gdk/x11/gdkgc-x11.c
View File

@ -742,6 +742,8 @@ gdk_gc_copy (GdkGC *dst_gc, GdkGC *src_gc)
* Gets the #GdkScreen for which @gc was created
*
* Returns: the #GdkScreen for @gc.
*
* Since: 2.2
*/
GdkScreen *
gdk_gc_get_screen (GdkGC *gc)

4
gdk/x11/gdkinput.c
View File

@ -105,12 +105,14 @@ gdk_devices_list (void)
/**
* gdk_display_list_devices:
* @display : a #GdkDisplay
* @display: a #GdkDisplay
*
* Returns the list of available input devices attached to @display.
* The list is statically allocated and should not be freed.
*
* Return value: a list of #GdkDevice
*
* Since: 2.2
**/
GList *
gdk_display_list_devices (GdkDisplay *display)

2
gdk/x11/gdkkeys-x11.c
View File

@ -185,6 +185,8 @@ get_xkb (GdkKeymapX11 *keymap_x11)
* @returns: the #GdkKeymap attached to @display.
*
* Returns the #GdkKeymap attached to @display.
*
* Since: 2.2
**/
GdkKeymap*
gdk_keymap_get_for_display (GdkDisplay *display)

2
gdk/x11/gdkpango-x11.c
View File

@ -41,6 +41,8 @@
* the widget you intend to render text onto.
*
* Return value: a new #PangoContext for @screen
*
* Since: 2.2
**/
PangoContext *
gdk_pango_context_get_for_screen (GdkScreen *screen)

10
gdk/x11/gdkpixmap-x11.c
View File

@ -323,7 +323,7 @@ gdk_pixmap_create_from_data (GdkWindow *window,
* @display: The #GdkDisplay where @anid is located.
* @anid: a native pixmap handle.
*
* Wraps a native window in a #GdkPixmap.
* Wraps a native pixmap in a #GdkPixmap.
* This may fail if the pixmap has been destroyed.
*
* For example in the X backend, a native pixmap handle is an Xlib
@ -331,6 +331,8 @@ gdk_pixmap_create_from_data (GdkWindow *window,
*
* Return value: the newly-created #GdkPixmap wrapper for the
* native pixmap or %NULL if the pixmap has been destroyed.
*
* Since: 2.2
**/
GdkPixmap *
gdk_pixmap_foreign_new_for_display (GdkDisplay *display,
@ -417,7 +419,7 @@ gdk_pixmap_lookup (GdkNativeWindow anid)
/**
* gdk_pixmap_lookup_for_display:
* @display : the #GdkDisplay associated with @anid
* @display: the #GdkDisplay associated with @anid
* @anid: a native pixmap handle.
*
* Looks up the #GdkPixmap that wraps the given native pixmap handle.
@ -425,8 +427,10 @@ gdk_pixmap_lookup (GdkNativeWindow anid)
* For example in the X backend, a native pixmap handle is an Xlib
* <type>XID</type>.
*
* Return value: the #GdkWindow wrapper for the native window,
* Return value: the #GdkPixmap wrapper for the native pixmap,
* or %NULL if there is none.
*
* Since: 2.2
**/
GdkPixmap*
gdk_pixmap_lookup_for_display (GdkDisplay *display, GdkNativeWindow anid)

14
gdk/x11/gdkproperty-x11.c
View File

@ -151,6 +151,8 @@ insert_atom_pair (GdkDisplay *display,
* with the same string value.
*
* Return value: the X atom corresponding to @atom.
*
* Since: 2.2
**/
Atom
gdk_x11_atom_to_xatom_for_display (GdkDisplay *display,
@ -211,6 +213,8 @@ gdk_x11_atom_to_xatom (GdkAtom atom)
* #GdkAtom.
*
* Return value: the corresponding #GdkAtom.
*
* Since: 2.2
**/
GdkAtom
gdk_x11_xatom_to_atom_for_display (GdkDisplay *display,
@ -338,9 +342,11 @@ gdk_atom_name (GdkAtom atom)
*
* Returns the X atom for a #GdkDisplay corresponding to @atom_name.
* This function caches the result, so if called repeatedly it is much
* faster than XInternAtom, which is a round trip to the server each time.
* faster than XInternAtom(), which is a round trip to the server each time.
*
* Return value: a X atom for a #GdkDisplay
*
* Since: 2.2
**/
Atom
gdk_x11_get_xatom_by_name_for_display (GdkDisplay *display,
@ -371,7 +377,7 @@ gdk_x11_get_xatom_by_name (const gchar *atom_name)
/**
* gdk_x11_get_xatom_name_for_display:
* @display : the #GdkDisplay where @xatom is defined
* @display: the #GdkDisplay where @xatom is defined
* @xatom: an X atom
*
* Returns the name of an X atom for its display. This
@ -379,8 +385,10 @@ gdk_x11_get_xatom_by_name (const gchar *atom_name)
* XAtomName() and gdk_atom_name(), the result doesn't need to
* be freed.
*
* Return value: name of the X atom; this string is owned by GTK+,
* Return value: name of the X atom; this string is owned by GDK,
* so it shouldn't be modifed or freed.
*
* Since: 2.2
**/
G_CONST_RETURN gchar *
gdk_x11_get_xatom_name_for_display (GdkDisplay *display,

29
gdk/x11/gdkscreen-x11.c
View File

@ -110,6 +110,8 @@ gdk_screen_x11_class_init (GdkScreenX11Class *klass)
* Gets the display to which the @screen belongs.
*
* Returns: the display to which @screen belongs
*
* Since: 2.2
**/
GdkDisplay *
gdk_screen_get_display (GdkScreen *screen)
@ -125,6 +127,8 @@ gdk_screen_get_display (GdkScreen *screen)
* Gets the width of @screen in pixels
*
* Returns: the width of @screen in pixels.
*
* Since: 2.2
**/
gint
gdk_screen_get_width (GdkScreen *screen)
@ -141,6 +145,8 @@ gdk_screen_get_width (GdkScreen *screen)
* Gets the height of @screen in pixels
*
* Returns: the height of @screen in pixels.
*
* Since: 2.2
**/
gint
gdk_screen_get_height (GdkScreen *screen)
@ -158,6 +164,8 @@ gdk_screen_get_height (GdkScreen *screen)
* Note that on some X servers this value will not be correct.
*
* Returns: the width of @screen in pixels.
*
* Since: 2.2
**/
gint
gdk_screen_get_width_mm (GdkScreen *screen)
@ -175,6 +183,8 @@ gdk_screen_get_width_mm (GdkScreen *screen)
* Note that on some X servers this value will not be correct.
*
* Returns: the heigth of @screen in pixels.
*
* Since: 2.2
**/
gint
gdk_screen_get_height_mm (GdkScreen *screen)
@ -192,6 +202,8 @@ gdk_screen_get_height_mm (GdkScreen *screen)
* to which it belongs. (See gdk_screen_get_display())
*
* Returns: the index
*
* Since: 2.2
**/
gint
gdk_screen_get_number (GdkScreen *screen)
@ -208,6 +220,8 @@ gdk_screen_get_number (GdkScreen *screen)
* Gets the root window of @screen.
*
* Returns: the root window
*
* Since: 2.2
**/
GdkWindow *
gdk_screen_get_root_window (GdkScreen *screen)
@ -224,6 +238,8 @@ gdk_screen_get_root_window (GdkScreen *screen)
* Gets the default colormap for @screen.
*
* Returns: the default #GdkColormap.
*
* Since: 2.2
**/
GdkColormap *
gdk_screen_get_default_colormap (GdkScreen *screen)
@ -239,6 +255,8 @@ gdk_screen_get_default_colormap (GdkScreen *screen)
* @colormap: a #GdkColormap
*
* Sets the default @colormap for @screen.
*
* Since: 2.2
**/
void
gdk_screen_set_default_colormap (GdkScreen *screen,
@ -304,12 +322,14 @@ gdk_screen_x11_finalize (GObject *object)
/**
* gdk_screen_get_n_monitors:
* @screen : a #GdkScreen.
* @screen: a #GdkScreen.
*
* Returns the number of monitors being part of the virtual screen
*
* Returns: number of monitors part of the virtual screen or
* 0 if @screen is not in virtual screen mode.
*
* Since: 2.2
**/
gint
gdk_screen_get_n_monitors (GdkScreen *screen)
@ -332,6 +352,7 @@ gdk_screen_get_n_monitors (GdkScreen *screen)
* Note that the virtual screen coordinates can be retrieved via
* gdk_screen_get_width() and gdk_screen_get_height().
*
* Since: 2.2
**/
void
gdk_screen_get_monitor_geometry (GdkScreen *screen,
@ -351,6 +372,8 @@ gdk_screen_get_monitor_geometry (GdkScreen *screen,
* @returns: an Xlib <type>Screen*</type>
*
* Returns the screen of a #GdkScreen.
*
* Since: 2.2
*/
Screen *
gdk_x11_screen_get_xscreen (GdkScreen *screen)
@ -366,6 +389,8 @@ gdk_x11_screen_get_xscreen (GdkScreen *screen)
* its display.
*
* Returns the index of a #GdkScreen.
*
* Since: 2.2
*/
int
gdk_x11_screen_get_screen_number (GdkScreen *screen)
@ -608,6 +633,8 @@ _gdk_windowing_substitute_screen_number (const gchar *display_name,
* a #GdkDisplay with this screen as the default screen.
*
* Return value: a newly allocated string, free with g_free()
*
* Since: 2.2
**/
gchar *
gdk_screen_make_display_name (GdkScreen *screen)

85
gdk/x11/gdkselection-x11.c
View File

@ -101,20 +101,22 @@ _gdk_selection_filter_clear_event (XSelectionClearEvent *event)
}
/**
* gdk_selection_owner_set_for_display:
* @display : the #GdkDisplay.
* @owner : a GdkWindow or NULL to indicate that the the owner for
* the given should be unset.
* @selection : an atom identifying a selection.
* @time_ : timestamp to use when setting the selection.
* If this is older than the timestamp given last time the owner was
* set for the given selection, the request will be ignored.
* @send_event : if TRUE, and the new owner is different from the current
* owner, the current owner will be sent a SelectionClear event.
* @display: the #GdkDisplay.
* @owner: a #GdkWindow or %NULL to indicate that the the owner for
* the given should be unset.
* @selection: an atom identifying a selection.
* @time_: timestamp to use when setting the selection.
* If this is older than the timestamp given last time the owner was
* set for the given selection, the request will be ignored.
* @send_event: if %TRUE, and the new owner is different from the current
* owner, the current owner will be sent a SelectionClear event.
*
* Sets the #GdkWindow @owner as the current owner of the selection @selection.
*
* Returns : TRUE if the selection owner was succesfully changed to owner,
* otherwise FALSE.
* Returns: %TRUE if the selection owner was successfully changed to owner,
* otherwise %FALSE.
*
* Since: 2.2
*/
gboolean
gdk_selection_owner_set_for_display (GdkDisplay *display,
@ -179,9 +181,9 @@ gdk_selection_owner_set_for_display (GdkDisplay *display,
}
/**
* gdk_selection_owner_get_for_display :
* @display : a #GdkDisplay.
* @selection : an atom indentifying a selection.
* gdk_selection_owner_get_for_display:
* @display: a #GdkDisplay.
* @selection: an atom indentifying a selection.
*
* Determine the owner of the given selection.
*
@ -189,11 +191,12 @@ gdk_selection_owner_set_for_display (GdkDisplay *display,
* process if a foreign window was previously created for that
* window, but a new foreign window will never be created by this call.
*
* Returns :if there is a selection owner for this window,
* and it is a window known to the current process, the GdkWindow that owns
* the selection, otherwise NULL.
* Returns: if there is a selection owner for this window, and it is a
* window known to the current process, the #GdkWindow that owns the
* selection, otherwise %NULL.
*
* Since: 2.2
*/
GdkWindow *
gdk_selection_owner_get_for_display (GdkDisplay *display,
GdkAtom selection)
@ -364,15 +367,17 @@ gdk_selection_property_get (GdkWindow *requestor,
/**
* gdk_selection_send_notify_for_display:
* @display : the #GdkDisplay where @requestor is realized
* @requestor : window to which to deliver response.
* @selection : selection that was requested.
* @target : target that was selected.
* @property : property in which the selection owner stored the data,
* or GDK_NONE to indicate that the request was rejected.
* @time_ : timestamp.
* @display: the #GdkDisplay where @requestor is realized
* @requestor: window to which to deliver response.
* @selection: selection that was requested.
* @target: target that was selected.
* @property: property in which the selection owner stored the data,
* or %GDK_NONE to indicate that the request was rejected.
* @time_: timestamp.
*
* Send a response to SelectionRequest event.
*
* Since: 2.2
**/
void
gdk_selection_send_notify_for_display (GdkDisplay *display,
@ -402,22 +407,24 @@ gdk_selection_send_notify_for_display (GdkDisplay *display,
* gdk_text_property_to_text_list_for_display:
* @display: The #GdkDisplay where the encoding is defined.
* @encoding: an atom representing the encoding. The most
* common values for this are STRING, or COMPOUND_TEXT.
* This is value used as the type for the property.
* common values for this are STRING, or COMPOUND_TEXT.
* This is value used as the type for the property.
* @format: the format of the property.
* @text: The text data.
* @length: The number of items to transform.
* @list: location to store a terminated array of strings in
* the encoding of the current locale. This array should be
* freed using gdk_free_text_list().
* the encoding of the current locale. This array should be
* freed using gdk_free_text_list().
*
* Convert a text string from the encoding as it is stored
* in a property into an array of strings in the encoding of
* the current local. (The elements of the array represent the
* null-separated elements of the original text string.)
* the current locale. (The elements of the array represent the
* nul-separated elements of the original text string.)
*
* Returns : the number of strings stored in list, or 0,
* Returns: the number of strings stored in list, or 0,
* if the conversion failed.
*
* Since: 2.2
*/
gint
gdk_text_property_to_text_list_for_display (GdkDisplay *display,
@ -545,11 +552,13 @@ make_list (const gchar *text,
* @list: location to store the list of strings or %NULL. The
* list should be freed with g_strfreev().
*
* Converts a text property in the giving encoding to
* Converts a text property in the given encoding to
* a list of UTF-8 strings.
*
* Return value: the number of strings in the resulting
* list.
*
* Since: 2.2
**/
gint
gdk_text_property_to_utf8_list_for_display (GdkDisplay *display,
@ -634,8 +643,8 @@ gdk_text_property_to_utf8_list_for_display (GdkDisplay *display,
/**
* gdk_string_to_compound_text_for_display:
* @display : the #GdkDisplay where the encoding is defined.
* @str : a null-terminated string.
* @display: the #GdkDisplay where the encoding is defined.
* @str: a nul-terminated string.
* @encoding: location to store the encoding atom
* (to be used as the type for the property).
* @format: location to store the format of the property
@ -645,7 +654,9 @@ gdk_text_property_to_utf8_list_for_display (GdkDisplay *display,
* Convert a string from the encoding of the current
* locale into a form suitable for storing in a window property.
*
* Returns : 0 upon sucess, non-zero upon failure.
* Returns: 0 upon sucess, non-zero upon failure.
*
* Since: 2.2
**/
gint
gdk_string_to_compound_text_for_display (GdkDisplay *display,
@ -777,6 +788,8 @@ gdk_utf8_to_string_target (const gchar *str)
*
* Return value: %TRUE if the conversion succeeded, otherwise
* %FALSE.
*
* Since: 2.2
**/
gboolean
gdk_utf8_to_compound_text_for_display (GdkDisplay *display,

19
gdk/x11/gdkvisual-x11.c
View File

@ -341,13 +341,15 @@ gdk_visual_get_best_type (void)
/**
* gdk_screen_get_system_visual:
* @screen : a #GdkScreen.
* @screen: a #GdkScreen.
*
* Get the system's default visual for @screen.
* This is the visual for the root window of the display.
* The return value should not be freed.
*
* Return value: system visual
* Return value: the system visual
*
* Since: 2.2
**/
GdkVisual *
gdk_screen_get_system_visual (GdkScreen * screen)
@ -507,7 +509,7 @@ gdk_query_visual_types (GdkVisualType **visual_types,
/**
* gdk_screen_list_visuals:
* @screen : the relevant #GdkScreen.
* @screen: the relevant #GdkScreen.
*
* Lists the available visuals for the specified @screen.
* A visual describes a hardware image data format.
@ -516,7 +518,10 @@ gdk_query_visual_types (GdkVisualType **visual_types,
*
* Call g_list_free() on the return value when you're finished with it.
*
* Return value: a list of visuals; the list must be freed, but not its contents
* Return value: a list of visuals; the list must be freed, but not its
* contents
*
* Since: 2.2
**/
GList *
gdk_screen_list_visuals (GdkScreen *screen)
@ -537,7 +542,7 @@ gdk_screen_list_visuals (GdkScreen *screen)
}
/**
* gdk_x11_screen_lookup_visual
* gdk_x11_screen_lookup_visual:
* @screen: a #GdkScreen.
* @xvisualid: an X Visual ID.
*
@ -545,6 +550,8 @@ gdk_screen_list_visuals (GdkScreen *screen)
*
* Returns: the #GdkVisual (owned by the screen object), or %NULL
* if the visual ID wasn't found.
*
* Since: 2.2
*/
GdkVisual *
gdk_x11_screen_lookup_visual (GdkScreen *screen,
@ -646,6 +653,8 @@ gdk_x11_visual_get_xvisual (GdkVisual *visual)
* Gets the screen to which this visual belongs
*
* Return value: the screen to which this visual belongs.
*
* Since: 2.2
**/
GdkScreen *
gdk_visual_get_screen (GdkVisual *visual)

14
gdk/x11/gdkwindow-x11.c
View File

@ -734,6 +734,8 @@ x_event_mask_to_gdk_event_mask (long mask)
*
* Return value: the newly-created #GdkWindow wrapper for the
* native window or %NULL if the window has been destroyed.
*
* Since: 2.2
**/
GdkWindow *
gdk_window_foreign_new_for_display (GdkDisplay *display,
@ -820,6 +822,8 @@ gdk_window_foreign_new_for_display (GdkDisplay *display,
*
* Return value: the #GdkWindow wrapper for the native window,
* or %NULL if there is none.
*
* Since: 2.2
**/
GdkWindow *
gdk_window_lookup_for_display (GdkDisplay *display, GdkNativeWindow anid)
@ -1761,6 +1765,8 @@ gdk_window_set_modal_hint (GdkWindow *window,
* function should NOT be called in addition, instead you should allow
* the window to be treated according to standard policy for its
* semantic type.
*
* Since: 2.2
**/
void
gdk_window_set_skip_taskbar_hint (GdkWindow *window,
@ -1798,6 +1804,8 @@ gdk_window_set_skip_taskbar_hint (GdkWindow *window,
* already fully describes the window, this function should NOT be
* called in addition, instead you should allow the window to be
* treated according to standard policy for its semantic type.
*
* Since: 2.2
**/
void
gdk_window_set_skip_pager_hint (GdkWindow *window,
@ -3595,6 +3603,7 @@ gdk_window_unmaximize (GdkWindow *window)
* most standard window managers, and GDK makes a best effort to get
* it to happen.
*
* Since: 2.2
**/
void
gdk_window_fullscreen (GdkWindow *window)
@ -3628,8 +3637,9 @@ gdk_window_fullscreen (GdkWindow *window)
* don't have a concept of "fullscreen"; so you can't rely on the
* unfullscreenification actually happening. But it will happen with
* most standard window managers, and GDK makes a best effort to get
* it to happen.
*
* it to happen.
*
* Since: 2.2
**/
void
gdk_window_unfullscreen (GdkWindow *window)

10
gdk/x11/gdkxid.c
View File

@ -68,12 +68,14 @@ _gdk_xid_table_remove (GdkDisplay *display,
/**
* gdk_xid_table_lookup_for_display:
* @display : the #GdkDisplay.
* @xid : an X id.
* @display: the #GdkDisplay.
* @xid: an X id.
*
* Returns the Gdk object associated with the given X id.
* Returns the GDK object associated with the given X id.
*
* Returns: an GdkObject associated with the given X id.
* Returns: a GDK object associated with the given X id.
*
* Since: 2.2
*/
gpointer
gdk_xid_table_lookup_for_display (GdkDisplay *display,

4
gtk/gtkclipboard.c
View File

@ -190,6 +190,8 @@ clipboard_display_closed (GdkDisplay *display,
* be created. Once a clipboard object has
* been created, it is persistent for all time and
* cannot be freed.
*
* Since: 2.2
**/
GtkClipboard *
gtk_clipboard_get_for_display (GdkDisplay *display, GdkAtom selection)
@ -955,6 +957,8 @@ gtk_clipboard_wait_for_text (GtkClipboard *clipboard)
* Gets the #GdkDisplay associated with @clipboard
*
* Return value: the #GdkDisplay associated with @clipboard
*
* Since: 2.2
**/
GdkDisplay *
gtk_clipboard_get_display (GtkClipboard *clipboard)

2
gtk/gtkcolorsel.c
View File

@ -2708,6 +2708,8 @@ gtk_color_selection_set_change_palette_hook (GtkColorSelectionChangePaletteFunc
* "gtk-color-palette" so all GtkColorSelection widgets will be modified.
*
* Return value: the previous change palette hook (that was replaced).
*
* Since: 2.2
**/
GtkColorSelectionChangePaletteWithScreenFunc
gtk_color_selection_set_change_palette_with_screen_hook (GtkColorSelectionChangePaletteWithScreenFunc func)

2
gtk/gtkiconfactory.c
View File

@ -1212,6 +1212,8 @@ icon_size_lookup_intern (GtkSettings *settings,
* the usual size.
*
* Return value: %TRUE if @size was a valid size
*
* Since: 2.2
**/
gboolean
gtk_icon_size_lookup_for_settings (GtkSettings *settings,

8
gtk/gtkinvisible.c
View File

@ -156,6 +156,8 @@ gtk_invisible_destroy (GtkObject *object)
* Creates a new #GtkInvisible object for a specified screen
*
* Return value: a newly created #GtkInvisible object
*
* Since: 2.2
**/
GtkWidget*
gtk_invisible_new_for_screen (GdkScreen *screen)
@ -184,6 +186,8 @@ gtk_invisible_new (void)
* @screen: a #GdkScreen.
*
* Sets the #GdkScreen where the #GtkInvisible object will be displayed.
*
* Since: 2.2
**/
void
gtk_invisible_set_screen (GtkInvisible *invisible,
@ -222,7 +226,9 @@ gtk_invisible_set_screen (GtkInvisible *invisible,
*
* Returns the #GdkScreen object associated with @invisible
*
* Return value : the associated #GdkScreen.
* Return value: the associated #GdkScreen.
*
* Since: 2.2
**/
GdkScreen *
gtk_invisible_get_screen (GtkInvisible *invisible)

12
gtk/gtkliststore.c
View File

@ -1373,6 +1373,8 @@ gtk_list_store_clear (GtkListStore *list_store)
* Checks if the given iter is a valid iter for this #GtkListStore.
*
* Return value: %TRUE if the iter is valid, %FALSE if the iter is invalid.
*
* Since: 2.2
**/
gboolean
gtk_list_store_iter_is_valid (GtkListStore *list_store,
@ -1637,6 +1639,8 @@ gtk_list_store_reorder_func (gconstpointer a,
*
* Reorders @store to follow the order indicated by @new_order. Note that
* this function only works with unsorted stores.
*
* Since: 2.2
**/
void
gtk_list_store_reorder (GtkListStore *store,
@ -1692,6 +1696,8 @@ gtk_list_store_reorder (GtkListStore *store,
*
* Swaps @a and @b in @store. Note that this function only works with
* unsorted stores.
*
* Since: 2.2
**/
void
gtk_list_store_swap (GtkListStore *store,
@ -1952,6 +1958,8 @@ free_paths_and_out:
* Moves @iter in @store to the position before @position. Note that this
* function only works with unsorted stores. If @position is %NULL, @iter
* will be moved to the end of the list.
*
* Since: 2.2
**/
void
gtk_list_store_move_before (GtkListStore *store,
@ -1965,11 +1973,13 @@ gtk_list_store_move_before (GtkListStore *store,
* gtk_list_store_move_after:
* @store: A #GtkListStore.
* @iter: A #GtkTreeIter.
* @position: A #GtkTreeIter, or %NULL.
* @position: A #GtkTreeIter or %NULL.
*
* Moves @iter in @store to the position after @position. Note that this
* function only works with unsorted stores. If @position is %NULL, @iter
* will be moved to the start of the list.
*
* Since: 2.2
**/
void
gtk_list_store_move_after (GtkListStore *store,

2
gtk/gtkmenu.c
View File

@ -2957,6 +2957,8 @@ gtk_menu_hide_all (GtkWidget *widget)
* determined by the widget the menu is attached to.
*
* Sets the #GdkScreen on which the menu will be displayed.
*
* Since: 2.2
**/
void
gtk_menu_set_screen (GtkMenu *menu,

2
gtk/gtkmenushell.c
View File

@ -1003,6 +1003,8 @@ gtk_menu_shell_move_selected (GtkMenuShell *menu_shell,
* Select the first visible or selectable child of the menu shell;
* don't select tearoff items unless the only item is a tearoff
* item.
*
* Since: 2.2
**/
void
gtk_menu_shell_select_first (GtkMenuShell *menu_shell,

2
gtk/gtknotebook.c
View File

@ -4199,6 +4199,8 @@ gtk_notebook_get_nth_page (GtkNotebook *notebook,
* Gets the number of pages in a notebook.
*
* Return value: the number of pages in the notebook.
*
* Since: 2.2
**/
gint
gtk_notebook_get_n_pages (GtkNotebook *notebook)

4
gtk/gtkplug.c
View File

@ -351,6 +351,8 @@ gtk_plug_construct (GtkPlug *plug,
* Finish the initialization of @plug for a given #GtkSocket identified by
* @socket_id which is currently displayed on @display.
* This function will generally only be used by classes deriving from #GtkPlug.
*
* Since: 2.2
**/
void
gtk_plug_construct_for_display (GtkPlug *plug,
@ -408,6 +410,8 @@ gtk_plug_new (GdkNativeWindow socket_id)
* Create a new plug widget inside the #GtkSocket identified by socket_id.
*
* Return value: the new #GtkPlug widget.
*
* Since: 2.2
*/
GtkWidget*
gtk_plug_new_for_display (GdkDisplay *display,

4
gtk/gtkselection.c
View File

@ -306,6 +306,8 @@ gtk_target_list_find (GtkTargetList *list,
* if @widget is %NULL, release ownership of the selection.
*
* Return value: TRUE if the operation succeeded
*
* Since: 2.2
*/
gboolean
gtk_selection_owner_set_for_display (GdkDisplay *display,
@ -1024,6 +1026,8 @@ gtk_selection_init (void)
* be deprecated in future versions of GTK+.
*
* Return value: %TRUE if the event was handled, otherwise false
*
* Since: 2.2
**/
gboolean
gtk_selection_clear (GtkWidget *widget,

2
gtk/gtksettings.c
View File

@ -272,6 +272,8 @@ gtk_settings_finalize (GObject *object)
* Gets the #GtkSettings object for @screen, creating it if necessary.
*
* Return value: a #GtkSettings object.
*
* Since: 2.2
*/
GtkSettings*
gtk_settings_get_for_screen (GdkScreen *screen)

14
gtk/gtktreemodel.c
View File

@ -226,6 +226,8 @@ gtk_tree_path_new_from_string (const gchar *path)
* Creates a new path with @first_index and @varargs as indices.
*
* Return value: A newly created GtkTreePath.
*
* Since: 2.2
**/
GtkTreePath *
gtk_tree_path_new_from_indices (gint first_index,
@ -787,6 +789,8 @@ gtk_tree_model_get_iter_from_string (GtkTreeModel *tree_model,
* acceptable return value for this string.
*
* Return value: A newly-allocated string. Must be freed with g_free().
*
* Since: 2.2
**/
gchar *
gtk_tree_model_get_string_from_iter (GtkTreeModel *tree_model,
@ -1779,6 +1783,16 @@ gtk_tree_row_reference_valid (GtkTreeRowReference *reference)
}
/**
* gtk_tree_row_reference_copy:
* @reference: a #GtkTreeRowReference
*
* Copies a #GtkTreeRowReference.
*
* Return value: a copy of @reference.
*
* Since: 2.2
**/
GtkTreeRowReference *
gtk_tree_row_reference_copy (GtkTreeRowReference *reference)
{

2
gtk/gtktreemodelsort.c
View File

@ -2348,6 +2348,8 @@ gtk_tree_model_sort_iter_is_valid_helper (GtkTreeIter *iter,
* Checks if the given iter is a valid iter for this #GtkTreeModelSort.
*
* Return value: %TRUE if the iter is valid, %FALSE if the iter is invalid.
*
* Since: 2.2
**/
gboolean
gtk_tree_model_sort_iter_is_valid (GtkTreeModelSort *tree_model_sort,

6
gtk/gtktreeselection.c
View File

@ -422,6 +422,8 @@ gtk_tree_selection_get_selected (GtkTreeSelection *selection,
* </programlisting></informalexample>
*
* Return value: A #GList containing a #GtkTreePath for each selected row.
*
* Since: 2.2
**/
GList *
gtk_tree_selection_get_selected_rows (GtkTreeSelection *selection,
@ -543,6 +545,8 @@ gtk_tree_selection_count_selected_rows_helper (GtkRBTree *tree,
* Returns the number of rows that have been selected in @tree.
*
* Return value: The number of rows selected.
*
* Since: 2.2
**/
gint
gtk_tree_selection_count_selected_rows (GtkTreeSelection *selection)
@ -1257,6 +1261,8 @@ gtk_tree_selection_select_range (GtkTreeSelection *selection,
*
* Unselects a range of nodes, determined by @start_path and @end_path
* inclusive.
*
* Since: 2.2
**/
void
gtk_tree_selection_unselect_range (GtkTreeSelection *selection,

10
gtk/gtktreestore.c
View File

@ -1542,6 +1542,8 @@ gtk_tree_store_iter_is_valid_helper (GtkTreeIter *iter,
* Checks if the given iter is a valid iter for this #GtkTreeStore.
*
* Return value: %TRUE if the iter is valid, %FALSE if the iter is invalid.
*
* Since: 2.2
**/
gboolean
gtk_tree_store_iter_is_valid (GtkTreeStore *tree_store,
@ -1901,6 +1903,8 @@ gtk_tree_store_reorder_func (gconstpointer a,
* Reorders the children of @parent in @tree_store to follow the order
* indicated by @new_order. Note that this function only works with
* unsorted stores.
*
* Since: 2.2
**/
void
gtk_tree_store_reorder (GtkTreeStore *tree_store,
@ -1981,6 +1985,8 @@ gtk_tree_store_reorder (GtkTreeStore *tree_store,
*
* Swaps @a and @b in the same level of @tree_store. Note that this function
* only works with unsorted stores.
*
* Since: 2.2
**/
void
gtk_tree_store_swap (GtkTreeStore *tree_store,
@ -2418,6 +2424,8 @@ free_paths_and_out:
* @position should be in the same level. Note that this function only
* works with unsorted stores. If @position is %NULL, @iter will be
* moved to the end of the level.
*
* Since: 2.2
**/
void
gtk_tree_store_move_before (GtkTreeStore *tree_store,
@ -2437,6 +2445,8 @@ gtk_tree_store_move_before (GtkTreeStore *tree_store,
* @position should be in the same level. Note that this function only
* works with unsorted stores. If @position is %NULL, @iter will be moved
* to the start of the level.
*
* Since: 2.2
**/
void
gtk_tree_store_move_after (GtkTreeStore *tree_store,

4
gtk/gtktreeview.c
View File

@ -8971,6 +8971,8 @@ gtk_tree_view_collapse_all (GtkTreeView *tree_view)
*
* Expands the row at @path. This will also expand all parent rows of
* @path as necessary.
*
* Since: 2.2
**/
void
gtk_tree_view_expand_to_path (GtkTreeView *tree_view,
@ -9617,6 +9619,8 @@ gtk_tree_view_set_cursor (GtkTreeView *tree_view,
* @gtk_widget_grab_focus (@tree_view) in order to give keyboard focus to the
* widget. Please note that editing can only happen when the widget is
* realized.
*
* Since: 2.2
**/
void
gtk_tree_view_set_cursor_on_cell (GtkTreeView *tree_view,

2
gtk/gtktreeviewcolumn.c
View File

@ -3122,6 +3122,8 @@ gtk_tree_view_column_cell_is_visible (GtkTreeViewColumn *tree_column)
*
* Sets the current keyboard focus to be at @cell, if the column contains
* 2 or more editable and activatable cells.
*
* Since: 2.2
**/
void
gtk_tree_view_column_focus_cell (GtkTreeViewColumn *tree_column,

14
gtk/gtkwidget.c
View File

@ -4760,6 +4760,8 @@ gtk_widget_get_screen_unchecked (GtkWidget *widget)
* free those resources when the widget is unrealized.
*
* Return value: the #GdkScreen for the toplevel for this widget.
*
* Since: 2.2
**/
GdkScreen*
gtk_widget_get_screen (GtkWidget *widget)
@ -4796,6 +4798,8 @@ gtk_widget_get_screen (GtkWidget *widget)
*
* Return value: %TRUE if there is a #GdkScreen associcated
* with the widget.
*
* Since: 2.2
**/
gboolean
gtk_widget_has_screen (GtkWidget *widget)
@ -4818,6 +4822,8 @@ gtk_widget_has_screen (GtkWidget *widget)
* free those resources when the widget is unrealized.
*
* Return value: the #GdkDisplay for the toplevel for this widget.
*
* Since: 2.2
**/
GdkDisplay*
gtk_widget_get_display (GtkWidget *widget)
@ -4841,6 +4847,8 @@ gtk_widget_get_display (GtkWidget *widget)
* and you should free those resources when the widget is unrealized.
*
* Return value: the #GdkWindow root window for the toplevel for this widget.
*
* Since: 2.2
**/
GdkWindow*
gtk_widget_get_root_window (GtkWidget *widget)
@ -6403,6 +6411,8 @@ gtk_widget_class_install_style_property (GtkWidgetClass *class,
* style property with that name.
*
* Finds a style property of a widget class by name.
*
* Since: 2.2
*/
GParamSpec*
gtk_widget_class_find_style_property (GtkWidgetClass *klass,
@ -6423,6 +6433,8 @@ gtk_widget_class_find_style_property (GtkWidgetClass *klass,
* @returns: an newly allocated array of #GParamSpec*. The array must be freed with g_free().
*
* Returns all style properties of a widget class.
*
* Since: 2.2
*/
GParamSpec**
gtk_widget_class_list_style_properties (GtkWidgetClass *klass,
@ -6832,6 +6844,8 @@ gtk_widget_ref_accessible (AtkImplementor *implementor)
* clipboard already exists, a new one will
* be created. Once a clipboard object has
* been created, it is persistent for all time.
*
* Since: 2.2
**/
GtkClipboard *
gtk_widget_get_clipboard (GtkWidget *widget, GdkAtom selection)

17
gtk/gtkwindow.c
View File

@ -1894,6 +1894,7 @@ gtk_window_get_type_hint (GtkWindow *window)
* Windows may set a hint asking the desktop environment not to display
* the window in the task bar. This function toggles this hint.
*
* Since: 2.2
**/
void
gtk_window_set_skip_taskbar_hint (GtkWindow *window,
@ -1924,6 +1925,8 @@ gtk_window_set_skip_taskbar_hint (GtkWindow *window,
* Gets the value set by gtk_window_set_skip_taskbar_hint()
*
* Return value: %TRUE if window shouldn't be in taskbar
*
* Since: 2.2
**/
gboolean
gtk_window_get_skip_taskbar_hint (GtkWindow *window)
@ -1948,6 +1951,7 @@ gtk_window_get_skip_taskbar_hint (GtkWindow *window)
* switcher that displays a thumbnail representation of the windows
* on the screen.)
*
* Since: 2.2
**/
void
gtk_window_set_skip_pager_hint (GtkWindow *window,
@ -1978,6 +1982,8 @@ gtk_window_set_skip_pager_hint (GtkWindow *window,
* Gets the value set by gtk_window_set_skip_pager_hint().
*
* Return value: %TRUE if window shouldn't be in pager
*
* Since: 2.2
**/
gboolean
gtk_window_get_skip_pager_hint (GtkWindow *window)
@ -2649,6 +2655,8 @@ load_pixbuf_verbosely (const char *filename,
* with a pixbuf created by loading the image from @filename.
*
* Returns: %TRUE if setting the icon succeeded.
*
* Since: 2.2
**/
gboolean
gtk_window_set_icon_from_file (GtkWindow *window,
@ -2732,6 +2740,8 @@ gtk_window_set_default_icon_list (GList *list)
* on disk. Warns on failure if @err is %NULL.
*
* Returns: %TRUE if setting the icon succeeded.
*
* Since: 2.2
**/
gboolean
gtk_window_set_default_icon_from_file (const gchar *filename,
@ -5743,6 +5753,7 @@ gtk_window_unmaximize (GtkWindow *window)
* You can track the fullscreen state via the "window_state_event" signal
* on #GtkWidget.
*
* Since: 2.2
**/
void
gtk_window_fullscreen (GtkWindow *window)
@ -5782,6 +5793,7 @@ gtk_window_fullscreen (GtkWindow *window)
* You can track the fullscreen state via the "window_state_event" signal
* on #GtkWidget.
*
* Since: 2.2
**/
void
gtk_window_unfullscreen (GtkWindow *window)
@ -6021,6 +6033,8 @@ gtk_window_begin_move_drag (GtkWindow *window,
* Sets the #GdkScreen where the @window is displayed; if
* the window is already mapped, it will be unmapped, and
* then remapped on the new screen.
*
* Since: 2.2
*/
void
gtk_window_set_screen (GtkWindow *window,
@ -6077,6 +6091,8 @@ gtk_window_check_screen (GtkWindow *window)
* Returns the #GdkScreen associated with @window.
*
* Return value: a #GdkScreen.
*
* Since: 2.2
*/
GdkScreen*
gtk_window_get_screen (GtkWindow *window)
@ -6801,6 +6817,7 @@ _gtk_window_set_has_toplevel_focus (GtkWindow *window,
* temporarily, show your splash screen, then re-enable it so that
* showing the main window would automatically result in notification.
*
* Since: 2.2
**/
void
gtk_window_set_auto_startup_notification (gboolean setting)