[gtkmm] Updated gtk_docs.xml to get API reference for new methods.
- From: Murray Cumming <murrayc src gnome org>
- To: svn-commits-list gnome org
- Cc:
- Subject: [gtkmm] Updated gtk_docs.xml to get API reference for new methods.
- Date: Tue, 19 Jan 2010 10:28:39 +0000 (UTC)
commit 78bb577931f7085e76153b1d61a34413092c41b6
Author: Murray Cumming <murrayc murrayc com>
Date: Tue Jan 19 11:28:32 2010 +0100
Updated gtk_docs.xml to get API reference for new methods.
* gtk/src/gtk_docs.xml: Regnerated with docextract_to_xml.py.
ChangeLog | 6 +
gtk/src/gtk_docs.xml | 4654 +++++++++++++++++++++++++++++++++++++-------------
2 files changed, 3440 insertions(+), 1220 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index 52a1dcd..939e137 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,11 @@
2010-01-19 Murray Cumming <murrayc murrayc com>
+ Updated gtk_docs.xml to get API reference for new methods.
+
+ * gtk/src/gtk_docs.xml: Regnerated with docextract_to_xml.py.
+
+2010-01-19 Murray Cumming <murrayc murrayc com>
+
Wrapped some new GTK+ functions.
* gtk/src/gtk_methods.defs: Regenerated with h2defs.py
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index 09c2aeb..28a4f57 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -202,6 +202,25 @@ boundary algorithms).
</return>
</function>
+<function name="gtk_font_selection_get_face_list">
+<description>
+This returns the #GtkTreeView which lists all styles available for
+the selected font. For example, 'Regular', 'Bold', etc.
+
+
+</description>
+<parameters>
+<parameter name="fontsel">
+<parameter_description> a #GtkFontSelection
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GtkWidget that is part of @fontsel
+
+Since: 2.14
+</return>
+</function>
+
<function name="gtk_tree_view_set_tooltip_row">
<description>
Sets the tip area of @tooltip to be the area covered by the row at @path.
@@ -284,7 +303,7 @@ string used by the label, and must not be modified.
<description>
Sets the file referred to by @uri as the current file for the file chooser,
by changing to the URI's parent folder and actually selecting the URI in the
-list. If the @chooser is #GTK_FILE_CHOOSER_ACTION_SAVE mode, the URI's base
+list. If the @chooser is %GTK_FILE_CHOOSER_ACTION_SAVE mode, the URI's base
name will also appear in the dialog's file name entry.
If the URI isn't in the current folder of @chooser, then the current folder
@@ -300,8 +319,6 @@ user may save; for example, when the user opens an existing file and then
does <guimenuitem>File/Save As...</guimenuitem> on it. If you don't have
a file name already — for example, if the user just created a new
file and is saving it for the first time, do not call this function.
-
-
</description>
<parameters>
<parameter name="chooser">
@@ -931,7 +948,8 @@ The return value of this function is affected by the "sort-type" and
</parameter_description>
</parameter>
</parameters>
-<return> A newly allocated list of #GtkRecentInfo objects. You should
+<return> (element-type GtkRecentInfo) (transfer full): A newly allocated
+list of #GtkRecentInfo objects. You should
use gtk_recent_info_unref() on every item of the list, and then free
the list itself using g_list_free().
@@ -986,22 +1004,6 @@ toplevel window (taking into account inter-process embedding.)
<return></return>
</function>
-<function name="GtkMountOperation">
-<description>
-#GtkMountOperation is an implementation of #GMountOperation that
-can be used with GIO functions for mounting volumes such as
-g_file_mount_enclosing_volume(), g_file_mount_mountable(),
-g_volume_mount(), g_mount_unmount() and others.
-
-When necessary, #GtkMountOperation shows dialogs to ask for
-passwords, questions or show processes blocking unmount.
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="gtk_text_buffer_delete_interactive">
<description>
Deletes all <emphasis>editable</emphasis> text in the given range.
@@ -1036,7 +1038,7 @@ no text was deleted.
<function name="gtk_tree_view_get_columns">
<description>
-Return value: A list of #GtkTreeViewColumn s
+Return value: (element-type GtkTreeViewColumn) (transfer container): A list of #GtkTreeViewColumn s
</description>
<parameters>
@@ -1045,7 +1047,7 @@ Return value: A list of #GtkTreeViewColumn s
</parameter_description>
</parameter>
</parameters>
-<return> A list of #GtkTreeViewColumn s
+<return> (element-type GtkTreeViewColumn) (transfer container): A list of #GtkTreeViewColumn s
</return>
</function>
@@ -1171,7 +1173,8 @@ of the children. In that case, GTK+ stores %NULL in
</parameter_description>
</parameter>
<parameter name="focusable_widgets">
-<parameter_description> location to store the focus chain of the
+<parameter_description> (element-type GtkWidget) (out) (transfer container): location
+to store the focus chain of the
container, or %NULL. You should free this list
using g_list_free() when you are done with it, however
no additional reference count is added to the
@@ -1242,7 +1245,7 @@ Since: 2.12
<function name="gtk_about_dialog_get_website_label">
<description>
-Return value: The label used for the website link. The string is owned by the about
+Return value: The label used for the website link. The string is
</description>
<parameters>
@@ -1251,8 +1254,8 @@ Return value: The label used for the website link. The string is owned by the ab
</parameter_description>
</parameter>
</parameters>
-<return> The label used for the website link. The string is owned by the about
-dialog and must not be modified.
+<return> The label used for the website link. The string is
+owned by the about dialog and must not be modified.
Since: 2.6
</return>
@@ -1412,6 +1415,23 @@ Since: 2.14
</return>
</function>
+<function name="gtk_offscreen_window_get_pixbuf">
+<description>
+Retrieves a snapshot of the contained widget in the form of
+a #GdkPixbuf. This is a new pixbuf with a reference count of 1,
+and the application should unreference it once it is no longer
+needed.
+
+
+</description>
+<parameters>
+</parameters>
+<return> A #GdkPixbuf pointer, or %NULL.
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_text_view_get_wrap_mode">
<description>
Gets the line wrapping for the view.
@@ -1516,7 +1536,7 @@ Activates the targets associated with the mnemonic.
<function name="gtk_toolbar_set_drop_highlight_item">
<description>
Highlights @toolbar to give an idea of what it would look like
-if @item was added to @toolbar at the position indicated by @index_.
+if @item was added to @toolbar at the position indicated by @index_.
If @item is %NULL, highlighting is turned off. In that case @index_
is ignored.
@@ -1534,7 +1554,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="tool_item">
-<parameter_description> a #GtkToolItem, or %NULL to turn of highlighting
+<parameter_description> (allow-none): a #GtkToolItem, or %NULL to turn of highlighting
</parameter_description>
</parameter>
<parameter name="index_">
@@ -1839,9 +1859,9 @@ Since: 2.4
<function name="gtk_paper_size_new">
<description>
-Creates a new #GtkPaperSize object by parsing a
+Creates a new #GtkPaperSize object by parsing a
<ulink url="ftp://ftp.pwg.org/pub/pwg/candidates/cs-pwgmsn10-20020226-5101.1.pdf">PWG 5101.1-2002</ulink>
-paper name.
+paper name.
If @name is %NULL, the default paper size is returned,
see gtk_paper_size_get_default().
@@ -1850,7 +1870,7 @@ see gtk_paper_size_get_default().
</description>
<parameters>
<parameter name="name">
-<parameter_description> a paper size name, or %NULL
+<parameter_description> (allow-none): a paper size name, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -2003,11 +2023,13 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="icon_name">
-<parameter_description> place to store an icon name, or %NULL
+<parameter_description> (out) (transfer none) (allow-none): place to store an
+icon name, or %NULL
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> place to store an icon size, or %NULL
+<parameter_description> (out) (allow-none) (type int): place to store an icon size,
+or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -2210,6 +2232,24 @@ Since: 2.10
<return></return>
</function>
+<function name="gtk_tool_item_group_get_n_items">
+<description>
+Gets the number of tool items in @group.
+
+
+</description>
+<parameters>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup
+</parameter_description>
+</parameter>
+</parameters>
+<return> the number of tool items in @group
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_test_find_widget">
<description>
This function will search the descendants of @widget for a widget
@@ -2338,16 +2378,16 @@ parameters. @arrow_type determines the direction of the arrow.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="arrow_type">
@@ -2399,11 +2439,11 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="columns">
-<parameter_description> an array of column numbers
+<parameter_description> (array length=n_values): an array of column numbers
</parameter_description>
</parameter>
<parameter name="values">
-<parameter_description> an array of GValues
+<parameter_description> (array length=n_values): an array of GValues
</parameter_description>
</parameter>
<parameter name="n_values">
@@ -2646,7 +2686,7 @@ be added to the returned colormap; it should not be unreferenced.
</parameter_description>
</parameter>
</parameters>
-<return> the colormap used by @widget
+<return> (transfer none): the colormap used by @widget
</return>
</function>
@@ -2663,7 +2703,7 @@ Pressing Alt and that key activates the button.
</description>
<parameters>
<parameter name="label">
-<parameter_description> the text of the label with an underscore in front of the
+<parameter_description> (allow-none): the text of the label with an underscore in front of the
mnemonic character
</parameter_description>
</parameter>
@@ -3015,7 +3055,7 @@ gtk_text_buffer_register_serialize_tagset() for details.
</parameter_description>
</parameter>
<parameter name="tagset_name">
-<parameter_description> an optional tagset name, on %NULL
+<parameter_description> (allow-none): an optional tagset name, on %NULL
</parameter_description>
</parameter>
</parameters>
@@ -3147,6 +3187,40 @@ is %TRUE.
</return>
</function>
+<function name="gtk_print_context_get_hard_margins">
+<description>
+Obtains the hardware printer margins of the #GtkPrintContext, in units.
+
+
+</description>
+<parameters>
+<parameter name="context">
+<parameter_description> a #GtkPrintContext
+</parameter_description>
+</parameter>
+<parameter name="top">
+<parameter_description> top hardware printer margin
+</parameter_description>
+</parameter>
+<parameter name="bottom">
+<parameter_description> bottom hardware printer margin
+</parameter_description>
+</parameter>
+<parameter name="left">
+<parameter_description> left hardware printer margin
+</parameter_description>
+</parameter>
+<parameter name="right">
+<parameter_description> right hardware printer margin
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the hard margins were retrieved
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_widget_set_has_tooltip">
<description>
Sets the has-tooltip property on @widget to @has_tooltip. See
@@ -3168,6 +3242,33 @@ Since: 2.12
<return></return>
</function>
+<function name="gtk_tooltips_set_tip">
+<description>
+Adds a tooltip containing the message @tip_text to the specified #GtkWidget.
+Deprecated: 2.12:
+
+</description>
+<parameters>
+<parameter name="tooltips">
+<parameter_description> a #GtkTooltips.
+</parameter_description>
+</parameter>
+<parameter name="widget">
+<parameter_description> the #GtkWidget you wish to associate the tip with.
+</parameter_description>
+</parameter>
+<parameter name="tip_text">
+<parameter_description> (allow-none): a string containing the tip itself.
+</parameter_description>
+</parameter>
+<parameter name="tip_private">
+<parameter_description> (allow-none): a string of any further information that may be useful if the user gets stuck.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_menu_item_get_label">
<description>
Sets @text on the @menu_item label
@@ -3240,11 +3341,11 @@ g_intern_static_string().
</parameter_description>
</parameter>
<parameter name="accel_path">
-<parameter_description> path used to look up the accelerator
+<parameter_description> (allow-none): path used to look up the accelerator
</parameter_description>
</parameter>
<parameter name="accel_group">
-<parameter_description> a #GtkAccelGroup.
+<parameter_description> (allow-none): a #GtkAccelGroup.
</parameter_description>
</parameter>
</parameters>
@@ -3286,7 +3387,7 @@ create icons displayed in the proxy widgets.
</parameter_description>
</parameter>
<parameter name="icon_size">
-<parameter_description> the size of the icon that should be created.
+<parameter_description> (type int): the size of the icon that should be created.
</parameter_description>
</parameter>
</parameters>
@@ -3393,52 +3494,22 @@ for display.
<return></return>
</function>
-<function name="gtk_draw_extension">
+<function name="gtk_tool_palette_get_hadjustment">
<description>
-Draws an extension, i.e. a notebook tab.
+Gets the horizontal adjustment of the tool palette.
-Deprecated: 2.0: Use gtk_paint_extension() instead.
</description>
<parameters>
-<parameter name="style">
-<parameter_description> a #GtkStyle
-</parameter_description>
-</parameter>
-<parameter name="window">
-<parameter_description> a #GdkWindow
-</parameter_description>
-</parameter>
-<parameter name="state_type">
-<parameter_description> a state
-</parameter_description>
-</parameter>
-<parameter name="shadow_type">
-<parameter_description> type of shadow to draw
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> x origin of the extension
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> y origin of the extension
-</parameter_description>
-</parameter>
-<parameter name="width">
-<parameter_description> width of the extension
-</parameter_description>
-</parameter>
-<parameter name="height">
-<parameter_description> width of the extension
-</parameter_description>
-</parameter>
-<parameter name="gap_side">
-<parameter_description> the side on to which the extension is attached
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the horizontal adjustment of @palette
+
+Since: 2.20
+</return>
</function>
<function name="gtk_icon_source_set_state">
@@ -3653,6 +3724,29 @@ character position 0) to the end iterator.
<return></return>
</function>
+<function name="gtk_dialog_get_widget_for_response">
+<description>
+Gets the widget button that uses the given response ID in the action area
+of a dialog.
+
+
+</description>
+<parameters>
+<parameter name="dialog">
+<parameter_description> a #GtkDialog
+</parameter_description>
+</parameter>
+<parameter name="response_id">
+<parameter_description> the response ID used by the @dialog widget
+</parameter_description>
+</parameter>
+</parameters>
+<return> the @widget button that uses the given @response_id, or %NULL.
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_vscrollbar_new">
<description>
Creates a new vertical scrollbar.
@@ -3878,6 +3972,33 @@ Increments the reference count on @icon_set.
</return>
</function>
+<function name="gtk_tool_palette_get_drop_item">
+<description>
+Gets the item at position (x, y).
+See gtk_tool_palette_get_drop_group().
+
+
+</description>
+<parameters>
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> the x position
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> the y position
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GtkToolItem at position or %NULL if there is no such item
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_recent_info_get_mime_type">
<description>
Gets the MIME type of the resource.
@@ -3946,36 +4067,24 @@ indicates the mnemonic accelerator keys.
</return>
</function>
-<function name="gtk_text_layout_validate_yrange">
+<function name="gtk_progress_bar_get_text">
<description>
-Ensure that a region of a #GtkTextLayout is valid. The ::changed
-signal will be emitted if any lines are validated.
+Retrieves the text displayed superimposed on the progress bar,
+if any, otherwise %NULL. The return value is a reference
+to the text, not a copy of it, so will become invalid
+if you change the text in the progress bar.
+
</description>
<parameters>
-<parameter name="layout">
-<parameter_description> a #GtkTextLayout
-</parameter_description>
-</parameter>
-<parameter name="anchor">
-<parameter_description> iter pointing into a line that will be used as the
-coordinate origin
-</parameter_description>
-</parameter>
-<parameter name="y0_">
-<parameter_description> offset from the top of the line pointed to by @anchor at
-which to begin validation. (The offset here is in pixels
-after validation.)
-</parameter_description>
-</parameter>
-<parameter name="y1_">
-<parameter_description> offset from the top of the line pointed to by @anchor at
-which to end validation. (The offset here is in pixels
-after validation.)
+<parameter name="pbar">
+<parameter_description> a #GtkProgressBar
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> text, or %NULL; this string is owned by the widget
+and should not be modified or freed.
+</return>
</function>
<function name="gtk_text_iter_get_line_offset">
@@ -4058,7 +4167,7 @@ Since: 2.4
<function name="gtk_about_dialog_set_wrap_license">
<description>
-Sets whether the license text in @about is
+Sets whether the license text in @about is
automatically wrapped.
Since: 2.8
@@ -4512,25 +4621,29 @@ Since: 2.4
<return></return>
</function>
-<function name="gtk_paper_size_get_default_top_margin">
+<function name="gtk_tool_item_group_get_drop_item">
<description>
-Gets the default top margin for the #GtkPaperSize.
+Gets the tool item at position (x, y).
</description>
<parameters>
-<parameter name="size">
-<parameter_description> a #GtkPaperSize object
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup
</parameter_description>
</parameter>
-<parameter name="unit">
-<parameter_description> the unit for the return value
+<parameter name="x">
+<parameter_description> the x position
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> the y position
</parameter_description>
</parameter>
</parameters>
-<return> the default top margin
+<return> the #GtkToolItem at position (x, y)
-Since: 2.10
+Since: 2.20
</return>
</function>
@@ -4660,7 +4773,7 @@ custom windows and it is the same widget that is used by
<return> a new #GtkFileChooserWidget
Since: 2.4
-Deprecated: 2.14
+Deprecated: 2.14: Use gtk_file_chooser_widget_new() instead.
</return>
</function>
@@ -4744,26 +4857,20 @@ to activate the accelerator.
</return>
</function>
-<function name="gtk_print_operation_set_unit">
+<function name="gtk_progress_bar_new_with_adjustment">
<description>
-Sets up the transformation for the cairo context obtained from
-#GtkPrintContext in such a way that distances are measured in
-units of @unit.
+Creates a new #GtkProgressBar with an associated #GtkAdjustment.
-Since: 2.10
</description>
<parameters>
-<parameter name="op">
-<parameter_description> a #GtkPrintOperation
-</parameter_description>
-</parameter>
-<parameter name="unit">
-<parameter_description> the unit to use
+<parameter name="adjustment">
+<parameter_description> (allow-none):
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> (transfer none): a #GtkProgressBar.
+</return>
</function>
<function name="gtk_label_set_attributes">
@@ -5602,6 +5709,22 @@ assign match patterns to #GtkBindingSet structures.
<return></return>
</function>
+<function name="gtk_spinner_stop">
+<description>
+Stops the animation of the spinner.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="spinner">
+<parameter_description> a #GtkSpinner
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_text_buffer_get_iter_at_mark">
<description>
Initializes @iter with the current position of @mark.
@@ -5668,6 +5791,24 @@ moves forward by 0 - @count lines.
</return>
</function>
+<function name="gtk_tool_item_group_get_ellipsize">
+<description>
+Gets the ellipsization mode of @group.
+
+
+</description>
+<parameters>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #PangoEllipsizeMode of @group
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_page_setup_load_key_file">
<description>
Reads the page setup from the group @group_name in the key file
@@ -5967,6 +6108,16 @@ Since: 2.4
</return>
</function>
+<function name="gtk_text_layout_get_lines">
+<description>
+
+</description>
+<parameters>
+</parameters>
+<return> (element-type GtkTextLine) (transfer container):
+</return>
+</function>
+
<function name="gtk_tree_store_new">
<description>
Creates a new tree store as with @n_columns columns each of the types passed
@@ -6048,6 +6199,16 @@ potentially not all that well, depending on the windowing system.
<return></return>
</function>
+<function name="gtk_printer_option_set_get_groups">
+<description>
+
+</description>
+<parameters>
+</parameters>
+<return> (element-type utf8) (transfer full):
+</return>
+</function>
+
<function name="gtk_tree_view_get_path_at_pos">
<description>
Finds the path at the point (@x, @y), relative to bin_window coordinates
@@ -6121,7 +6282,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="entry">
-<parameter_description> the entry the interactive search code of @tree_view should use or %NULL
+<parameter_description> (allow-none): the entry the interactive search code of @tree_view should use or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -6228,6 +6389,25 @@ Since: 2.14
</return>
</function>
+<function name="gtk_tool_item_group_get_label_widget">
+<description>
+Gets the label widget of @group.
+See gtk_tool_item_group_set_label_widget().
+
+
+</description>
+<parameters>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup
+</parameter_description>
+</parameter>
+</parameters>
+<return> the label widget of @group
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_icon_view_get_spacing">
<description>
Return value: the space between cells
@@ -6245,31 +6425,21 @@ Since: 2.6
</return>
</function>
-<function name="gtk_page_setup_load_file">
+<function name="gtk_tool_palette_unset_style">
<description>
-Reads the page setup from the file @file_name.
-See gtk_page_setup_to_file().
+Unsets a toolbar style set with gtk_tool_palette_set_style(),
+so that user preferences will be used to determine the toolbar style.
+Since: 2.20
</description>
<parameters>
-<parameter name="setup">
-<parameter_description> a #GtkPageSetup
-</parameter_description>
-</parameter>
-<parameter name="file_name">
-<parameter_description> the filename to read the page setup from
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success
-
-Since: 2.14
-</return>
+<return></return>
</function>
<function name="gtk_action_get_is_important">
@@ -6294,7 +6464,7 @@ Since: 2.16
<description>
Sets @file as the current filename for the file chooser, by changing
to the file's parent folder and actually selecting the file in list. If
-the @chooser is in #GTK_FILE_CHOOSER_ACTION_SAVE mode, the file's base name
+the @chooser is in %GTK_FILE_CHOOSER_ACTION_SAVE mode, the file's base name
will also appear in the dialog's file name entry.
If the file name isn't in the current folder of @chooser, then the current
@@ -6311,8 +6481,6 @@ user may save; for example, when the user opens an existing file and then
does <guimenuitem>File/Save As...</guimenuitem> on it. If you don't have
a file name already — for example, if the user just created a new
file and is saving it for the first time, do not call this function.
-
-
</description>
<parameters>
<parameter name="chooser">
@@ -6398,7 +6566,7 @@ in addition to calling this function.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> icon size this source applies to
+<parameter_description> (type int): icon size this source applies to
</parameter_description>
</parameter>
</parameters>
@@ -6443,8 +6611,8 @@ Since: 2.10
<function name="gtk_icon_view_set_model">
<description>
-Sets the model for a #GtkIconView.
-If the @icon_view already has a model set, it will remove
+Sets the model for a #GtkIconView.
+If the @icon_view already has a model set, it will remove
it before setting the new model. If @model is %NULL, then
it will unset the old model.
@@ -6457,7 +6625,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> The model.
+<parameter_description> (allow-none): The model.
</parameter_description>
</parameter>
</parameters>
@@ -6516,7 +6684,8 @@ Gets the list of recently used resources.
</parameter_description>
</parameter>
</parameters>
-<return> a list of newly allocated #GtkRecentInfo objects. Use
+<return> (element-type GtkRecentInfo) (transfer full): a list of
+newly allocated #GtkRecentInfo objects. Use
gtk_recent_info_unref() on each item inside the list, and then
free the list itself using g_list_free().
@@ -6568,7 +6737,7 @@ and @root as the virtual root.
</parameter_description>
</parameter>
<parameter name="root">
-<parameter_description> A #GtkTreePath or %NULL.
+<parameter_description> (allow-none): A #GtkTreePath or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -6613,7 +6782,7 @@ Return value: whether we found a tag toggle after @iter
</parameter_description>
</parameter>
<parameter name="tag">
-<parameter_description> a #GtkTextTag, or %NULL
+<parameter_description> (allow-none): a #GtkTextTag, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -6790,16 +6959,16 @@ Draws an extension, i.e. a notebook tab.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="x">
@@ -6811,11 +6980,11 @@ output should not be clipped
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> width of the extension
+<parameter_description> width of the extension
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> width of the extension
+<parameter_description> width of the extension
</parameter_description>
</parameter>
<parameter name="gap_side">
@@ -6870,9 +7039,31 @@ map dump.
<return></return>
</function>
+<function name="gtk_cell_view_set_model">
+<description>
+Sets the model for @cell_view. If @cell_view already has a model
+set, it will remove it before setting the new model. If @model is
+%NULL, then it will unset the old model.
+
+Since: 2.6
+
+</description>
+<parameters>
+<parameter name="cell_view">
+<parameter_description> a #GtkCellView
+</parameter_description>
+</parameter>
+<parameter name="model">
+<parameter_description> (allow-none): a #GtkTreeModel
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="_gtk_file_system_model_get_file">
<description>
-Gets the path for a particular row in @model.
+Gets the file for a particular row in @model.
</description>
@@ -6921,7 +7112,7 @@ receiving buffer to deal with with pasting of arbitrary tags.
</parameter_description>
</parameter>
<parameter name="tagset_name">
-<parameter_description> an optional tagset name, on %NULL
+<parameter_description> (allow-none): an optional tagset name, on %NULL
</parameter_description>
</parameter>
</parameters>
@@ -7131,17 +7322,20 @@ Return value: %TRUE if the lines of the label are automatically wrapped.
<function name="SECTION">
<description>
-The functions and objects described here make working with GTK+ and
-GIO more convenient. #GtkMountOperation is needed when mounting volumes
-and gtk_show_uri() is a convenient way to launch applications for URIs.
-Another object that is worth mentioning in this context is
-#GdkAppLaunchContext, which provides visual feedback when lauching
-applications.
+A #GtkToolItemGroup is used together with #GtkToolPalette to add
+#GtkToolItem<!-- -->s to a palette like container with different
+categories and drag and drop support.
+
+Since: 2.20
</description>
<parameters>
-<parameter name="short_description">
-<parameter_description> Functions for working with GIO
+<parameter name="Short_description">
+<parameter_description> A sub container used in a tool palette
+</parameter_description>
+</parameter>
+<parameter name="Title">
+<parameter_description> GtkToolItemGroup
</parameter_description>
</parameter>
</parameters>
@@ -7205,16 +7399,16 @@ expanded position.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="x">
@@ -7382,16 +7576,16 @@ gap in one side.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="x">
@@ -7403,11 +7597,11 @@ output should not be clipped
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> width of the rectangle
+<parameter_description> width of the rectangle
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> width of the rectangle
+<parameter_description> width of the rectangle
</parameter_description>
</parameter>
<parameter name="gap_side">
@@ -7530,7 +7724,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="website">
-<parameter_description> a URL string starting with "http://"
+<parameter_description> (allow-none): a URL string starting with "http://"
</parameter_description>
</parameter>
</parameters>
@@ -7643,22 +7837,22 @@ Since: 2.16
</return>
</function>
-<function name="gtk_tool_item_set_homogeneous">
+<function name="_gtk_file_system_model_clear_cache">
<description>
-Sets whether @tool_item is to be allocated the same size as other
-homogeneous items. The effect is that all homogeneous items will have
-the same width as the widest of the items.
-
-Since: 2.4
+Clears the cached values in the model for the given @column. Use
+this function whenever your get_value function would return different
+values for a column.
+The file chooser uses this for example when the icon theme changes to
+invalidate the cached pixbufs.
</description>
<parameters>
-<parameter name="tool_item">
-<parameter_description> a #GtkToolItem
+<parameter name="model">
+<parameter_description> a #GtkFileSystemModel
</parameter_description>
</parameter>
-<parameter name="homogeneous">
-<parameter_description> whether @tool_item is the same size as other homogeneous items
+<parameter name="column">
+<parameter_description> the column to clear or -1 for all columns
</parameter_description>
</parameter>
</parameters>
@@ -7773,7 +7967,7 @@ the base color on that.
</parameter_description>
</parameter>
<parameter name="color">
-<parameter_description> the color to assign (does not need to be allocated),
+<parameter_description> (allow-none): the color to assign (does not need to be allocated),
or %NULL to undo the effect of previous calls to
of gtk_widget_modify_base().
</parameter_description>
@@ -7795,7 +7989,7 @@ gtk_file_chooser_add_shortcut_folder().
</parameter_description>
</parameter>
</parameters>
-<return> A list of folder filenames, or %NULL if there are no shortcut
+<return> (element-type utf8) (transfer full): A list of folder filenames, or %NULL if there are no shortcut
folders. Free the returned list with g_slist_free(), and the filenames with
g_free().
@@ -7816,7 +8010,7 @@ gtk_window_set_transient_for().
</parameter_description>
</parameter>
</parameters>
-<return> the transient parent for this window, or %NULL
+<return> (transfer none): the transient parent for this window, or %NULL
if no transient parent has been set.
</return>
</function>
@@ -7921,27 +8115,28 @@ Since: 2.4
<return></return>
</function>
-<function name="gtk_status_icon_set_tooltip_markup">
+<function name="_gtk_file_system_model_update_file">
<description>
-Sets @markup as the contents of the tooltip, which is marked up with
-the <link linkend="PangoMarkupFormat">Pango text markup language</link>.
-
-This function will take care of setting #GtkStatusIcon:has-tooltip to %TRUE
-and of the default handler for the #GtkStatusIcon::query-tooltip signal.
-
-See also the #GtkStatusIcon:tooltip-markup property and
-gtk_tooltip_set_markup().
-
-Since: 2.16
+Tells the file system model that the file changed and that the
+new @info should be used for it now. If the file is not part of
+ model, it will get added automatically.
</description>
<parameters>
-<parameter name="status_icon">
-<parameter_description> a #GtkStatusIcon
+<parameter name="model">
+<parameter_description> the model
</parameter_description>
</parameter>
-<parameter name="markup">
-<parameter_description> the contents of the tooltip for @status_icon, or %NULL
+<parameter name="file">
+<parameter_description> the file
+</parameter_description>
+</parameter>
+<parameter name="info">
+<parameter_description> the new file info
+</parameter_description>
+</parameter>
+<parameter name="requires_resort">
+<parameter_description> FIXME: get rid of this argument
</parameter_description>
</parameter>
</parameters>
@@ -8032,7 +8227,7 @@ interface is called.
</parameter_description>
</parameter>
<parameter name="types">
-<parameter_description> An array length n of #GTypes
+<parameter_description> (array length=n_columns): An array length n of #GTypes
</parameter_description>
</parameter>
</parameters>
@@ -8063,7 +8258,7 @@ and toggle focus between the colliding widgets otherwise.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the target #GtkWidget
+<parameter_description> (allow-none): the target #GtkWidget
</parameter_description>
</parameter>
</parameters>
@@ -8078,7 +8273,7 @@ See gtk_file_chooser_set_current_folder_uri().
Note that this is the folder that the file chooser is currently displaying
(e.g. "file:///home/username/Documents"), which is <emphasis>not the same</emphasis>
as the currently-selected folder if the chooser is in
-#GTK_FILE_CHOOSER_SELECT_FOLDER mode
+%GTK_FILE_CHOOSER_SELECT_FOLDER mode
(e.g. "file:///home/username/Documents/selected-folder/". To get the
currently-selected folder in that mode, use gtk_file_chooser_get_uri() as the
usual way to get the selection.
@@ -8534,7 +8729,7 @@ gtk_icon_theme_lookup_icon().
</parameter_description>
</parameter>
</parameters>
-<return> the built-in image pixbuf, or %NULL. No
+<return> (transfer none): the built-in image pixbuf, or %NULL. No
extra reference is added to the returned pixbuf, so if
you want to keep it around, you must use g_object_ref().
The returned image must not be modified.
@@ -8795,11 +8990,11 @@ Return value: %TRUE if the widget supports scrolling
</parameter_description>
</parameter>
<parameter name="hadjustment">
-<parameter_description> an adjustment for horizontal scrolling, or %NULL
+<parameter_description> (allow-none): an adjustment for horizontal scrolling, or %NULL
</parameter_description>
</parameter>
<parameter name="vadjustment">
-<parameter_description> an adjustment for vertical scrolling, or %NULL
+<parameter_description> (allow-none): an adjustment for vertical scrolling, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -9198,6 +9393,47 @@ Since: 2.14
</return>
</function>
+<function name="_gtk_file_system_model_new_for_directory">
+<description>
+Creates a new #GtkFileSystemModel object. The #GtkFileSystemModel
+object wraps the given @directory as a #GtkTreeModel.
+The model will query the given directory with the given @attributes
+and add all files inside the directory automatically. If supported,
+it will also monitor the drectory and update the model's
+contents to reflect changes, if the @directory supports monitoring.
+
+
+</description>
+<parameters>
+<parameter name="directory">
+<parameter_description> the directory to show.
+</parameter_description>
+</parameter>
+<parameter name="attributes">
+<parameter_description> attributes to immediately load or %NULL for all
+</parameter_description>
+</parameter>
+<parameter name="get_func">
+<parameter_description> function that the model should call to query data about a file
+</parameter_description>
+</parameter>
+<parameter name="get_data">
+<parameter_description> user data to pass to the @get_func
+</parameter_description>
+</parameter>
+<parameter name="n_columns">
+<parameter_description> number of columns
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> @n_columns #GType types for the columns
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly created #GtkFileSystemModel
+</return>
+</function>
+
<function name="GtkMenuBar">
<description>
The child pack direction of the menubar. It determines how
@@ -9211,6 +9447,29 @@ Since: 2.8
<return></return>
</function>
+<function name="gtk_tool_palette_get_drag_item">
+<description>
+Get the dragged item from the selection.
+This could be a #GtkToolItem or a #GtkToolItemGroup.
+
+
+</description>
+<parameters>
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
+</parameter_description>
+</parameter>
+<parameter name="selection">
+<parameter_description> a #GtkSelectionData
+</parameter_description>
+</parameter>
+</parameters>
+<return> the dragged item in selection
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_icon_source_set_size_wildcarded">
<description>
If the icon size is wildcarded, this source can be used as the base
@@ -9307,6 +9566,35 @@ Since: 2.18
<return></return>
</function>
+<function name="gtk_notebook_set_action_widget">
+<description>
+Sets @widget as one of the action widgets. Depending on the pack type
+the widget will be placed before or after the tabs. You can use
+a #GtkBox if you need to pack more than one widget on the same side.
+
+Note that action widgets are "internal" children of the notebook and thus
+not included in the list returned from gtk_container_foreach().
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="notebook">
+<parameter_description> a #GtkNotebook
+</parameter_description>
+</parameter>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="pack_type">
+<parameter_description> pack type of the action widget
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_font_selection_get_size">
<description>
The selected font size.
@@ -9383,6 +9671,7 @@ Since: 2.10
<description>
Gets @widget's parent window.
+
</description>
<parameters>
<parameter name="widget">
@@ -9390,7 +9679,7 @@ Gets @widget's parent window.
</parameter_description>
</parameter>
</parameters>
-<return> the parent window of @widget.
+<return> (transfer none): the parent window of @widget.
</return>
</function>
@@ -9482,7 +9771,7 @@ gtk_entry_set_inner_border() for more information.
</parameter_description>
</parameter>
</parameters>
-<return> the entry's #GtkBorder, or %NULL if none was set.
+<return> (transfer none): the entry's #GtkBorder, or %NULL if none was set.
Since: 2.10
</return>
@@ -9550,6 +9839,22 @@ Since: 2.10
</return>
</function>
+<function name="gtk_offscreen_window_get_pixmap">
+<description>
+Retrieves a snapshot of the contained widget in the form of
+a #GdkPixmap. If you need to keep this around over window
+resizes then you should add a reference to it.
+
+
+</description>
+<parameters>
+</parameters>
+<return> A #GdkPixmap pointer to the offscreen pixmap, or %NULL.
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_radio_button_new_with_mnemonic">
<description>
Creates a new #GtkRadioButton containing a label, adding it to the same
@@ -9860,6 +10165,19 @@ Adds the events in the bitfield @events to the event mask for
<return></return>
</function>
+<function name="gtk_text_layout_set_buffer">
+<description>
+
+</description>
+<parameters>
+<parameter name="buffer">
+<parameter_description> (allow-none):
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_color_selection_get_has_palette">
<description>
Determines whether the color selector has a color palette.
@@ -9902,7 +10220,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="translator_credits">
-<parameter_description> the translator credits
+<parameter_description> (allow-none): the translator credits
</parameter_description>
</parameter>
</parameters>
@@ -10033,19 +10351,19 @@ gtk_status_icon_is_embedded().
</parameter_description>
</parameter>
<parameter name="screen">
-<parameter_description> return location for the screen, or %NULL if the
-information is not needed
+<parameter_description> (out) (transfer none) (allow-none): return location for the screen, or %NULL if the
+information is not needed
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> return location for the area occupied by the status
+<parameter_description> (out) (allow-none): return location for the area occupied by the status
icon, or %NULL
</parameter_description>
</parameter>
<parameter name="orientation">
-<parameter_description> return location for the orientation of the panel
-in which the status icon is embedded, or %NULL. A panel
-at the top or bottom of the screen is horizontal, a panel
+<parameter_description> (out) (allow-none): return location for the orientation of the panel
+in which the status icon is embedded, or %NULL. A panel
+at the top or bottom of the screen is horizontal, a panel
at the left or right is vertical.
</parameter_description>
</parameter>
@@ -10161,7 +10479,7 @@ untouched. See also gtk_widget_modify_style().
</parameter_description>
</parameter>
<parameter name="font_desc">
-<parameter_description> the font description to use, or %NULL to undo
+<parameter_description> (allow-none): the font description to use, or %NULL to undo
the effect of previous calls to gtk_widget_modify_font().
</parameter_description>
</parameter>
@@ -10227,7 +10545,7 @@ function directly, but rely on gtk_tool_item_get_icon_size() instead.
</parameter_description>
</parameter>
</parameters>
-<return> the current size for icons of @shell
+<return> (type int): the current size for icons of @shell
Since: 2.14
</return>
@@ -10371,7 +10689,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="print_settings">
-<parameter_description> #GtkPrintSettings, or %NULL
+<parameter_description> (allow-none): #GtkPrintSettings
</parameter_description>
</parameter>
</parameters>
@@ -10470,7 +10788,7 @@ node after this function has been called. As a special case, if @parent is
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> The #GtkTreeIter to get the child from, or %NULL.
+<parameter_description> (allow-none): The #GtkTreeIter to get the child from, or %NULL.
</parameter_description>
</parameter>
<parameter name="n">
@@ -11344,7 +11662,7 @@ whether insertions are allowed at a given position.
<function name="gtk_tool_item_get_icon_size">
<description>
-Return value: a #GtkIconSize indicating the icon size used for @tool_item
+Return value: (type int): a #GtkIconSize indicating the icon size
</description>
<parameters>
@@ -11353,7 +11671,8 @@ Return value: a #GtkIconSize indicating the icon size used for @tool_item
</parameter_description>
</parameter>
</parameters>
-<return> a #GtkIconSize indicating the icon size used for @tool_item
+<return> (type int): a #GtkIconSize indicating the icon size
+used for @tool_item
Since: 2.4
</return>
@@ -11533,6 +11852,23 @@ Since: 2.10
<return></return>
</function>
+<function name="gtk_offscreen_window_new">
+<description>
+Creates a toplevel container widget that is used to retrieve
+snapshots of widgets without showing them on the screen. For
+widgets that are on the screen and part of a normal widget
+hierarchy, gtk_widget_get_snapshot() can be used instead.
+
+
+</description>
+<parameters>
+</parameters>
+<return> A pointer to a #GtkWidget
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_file_chooser_get_filter">
<description>
Gets the current filter; see gtk_file_chooser_set_filter().
@@ -11683,7 +12019,7 @@ Gets the value set by gtk_label_set_selectable().
<description>
Activates the default widget for the window, unless the current
focused widget has been configured to receive the default action
-(see #GTK_RECEIVES_DEFAULT in #GtkWidgetFlags), in which case the
+(see gtk_widget_set_receives_default()), in which case the
focused widget is activated.
@@ -11914,7 +12250,7 @@ called by models after the child state of a node changes.
<function name="gtk_ui_manager_get_action_groups">
<description>
-Return value: a #GList of action groups. The list is owned by GTK+
+Return value: (element-type GtkActionGroup) (transfer none): a #GList of
</description>
<parameters>
@@ -11923,7 +12259,8 @@ Return value: a #GList of action groups. The list is owned by GTK+
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of action groups. The list is owned by GTK+
+<return> (element-type GtkActionGroup) (transfer none): a #GList of
+action groups. The list is owned by GTK+
and should not be modified.
Since: 2.4
@@ -11945,6 +12282,16 @@ Return value: number of bytes in the line
</return>
</function>
+<function name="gtk_print_backend_get_printer_list">
+<description>
+
+</description>
+<parameters>
+</parameters>
+<return> (element-type GtkPrinter) (transfer container):
+</return>
+</function>
+
<function name="gtk_toolbar_get_relief_style">
<description>
Return value: The relief style of buttons on @toolbar.
@@ -12206,6 +12553,51 @@ Deprecated: 2.16: Use gtk_activatable_set_related_action() instead.
<return></return>
</function>
+<function name="gtk_style_apply_default_background">
+<description>
+
+</description>
+<parameters>
+<parameter name="style">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="window">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="set_bg">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="state_type">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="area">
+<parameter_description> (allow-none):
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description>
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="GtkBuilder">
<description>
The translation domain used when translating property values that
@@ -12325,7 +12717,7 @@ Since: 2.10
<function name="gtk_about_dialog_set_copyright">
<description>
Sets the copyright string to display in the about dialog.
-This should be a short string of one or two lines.
+This should be a short string of one or two lines.
Since: 2.6
@@ -12336,7 +12728,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="copyright">
-<parameter_description> the copyright string
+<parameter_description> (allow-none) the copyright string
</parameter_description>
</parameter>
</parameters>
@@ -12360,6 +12752,26 @@ this change.
<return></return>
</function>
+<function name="gtk_tool_item_group_set_collapsed">
+<description>
+Sets whether the @group should be collapsed or expanded.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup
+</parameter_description>
+</parameter>
+<parameter name="collapsed">
+<parameter_description> whether the @group should be collapsed or expanded
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_notebook_set_menu_label_text">
<description>
Creates a new label and sets it as the menu label of @child.
@@ -12401,7 +12813,7 @@ free those resources when the widget is unrealized.
</parameter_description>
</parameter>
</parameters>
-<return> the #GdkScreen for the toplevel for this widget.
+<return> (transfer none): the #GdkScreen for the toplevel for this widget.
Since: 2.2
</return>
@@ -12500,24 +12912,21 @@ specified by @style for the given state.
<return></return>
</function>
-<function name="gtk_page_setup_get_page_height">
+<function name="gtk_label_get_mnemonic_widget">
<description>
-Return value: the page height.
+Retrieves the target of the mnemonic (keyboard shortcut) of this
+label. See gtk_label_set_mnemonic_widget().
+
</description>
<parameters>
-<parameter name="setup">
-<parameter_description> a #GtkPageSetup
-</parameter_description>
-</parameter>
-<parameter name="unit">
-<parameter_description> the unit for the return value
+<parameter name="label">
+<parameter_description> a #GtkLabel
</parameter_description>
</parameter>
</parameters>
-<return> the page height.
-
-Since: 2.10
+<return> the target of the label's mnemonic, or %NULL if none
+has been set and the default algorithm will be used.
</return>
</function>
@@ -12622,7 +13031,7 @@ the current label is removed.
</parameter_description>
</parameter>
<parameter name="label">
-<parameter_description> the text to use as the label of the frame
+<parameter_description> (allow-none): the text to use as the label of the frame
</parameter_description>
</parameter>
</parameters>
@@ -12747,6 +13156,26 @@ Since: 2.6
</return>
</function>
+<function name="gtk_radio_menu_item_new_with_label">
+<description>
+Creates a new #GtkRadioMenuItem whose child is a simple #GtkLabel.
+
+
+</description>
+<parameters>
+<parameter name="group">
+<parameter_description> (element-type GtkRadioMenuItem) (transfer full):
+</parameter_description>
+</parameter>
+<parameter name="label">
+<parameter_description> the text for the label
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer none): A new #GtkRadioMenuItem
+</return>
+</function>
+
<function name="gtk_container_forall">
<description>
Invokes @callback on each child of @container, including children
@@ -12838,7 +13267,9 @@ a better choice if you want to draw a region of a widget.
<function name="gtk_print_settings_load_key_file">
<description>
-Reads the print settings from the group @group_name in @key_file.
+Reads the print settings from the group @group_name in @key_file. If the
+file could not be loaded then error is set to either a #GFileError or
+#GKeyFileError.
</description>
@@ -12891,13 +13322,13 @@ and each string in the list must be freed with g_free().
</description>
<parameters>
</parameters>
-<return> a list of known stock IDs
+<return> (element-type utf8) (transfer full): a list of known stock IDs
</return>
</function>
<function name="gtk_widget_list_mnemonic_labels">
<description>
-Return value: the list of mnemonic labels; free this list
+Return value: (element-type GtkWidget) (transfer container): the list of
</description>
<parameters>
@@ -12906,7 +13337,8 @@ Return value: the list of mnemonic labels; free this list
</parameter_description>
</parameter>
</parameters>
-<return> the list of mnemonic labels; free this list
+<return> (element-type GtkWidget) (transfer container): the list of
+mnemonic labels; free this list
with g_list_free() when you are done with it.
Since: 2.4
@@ -12955,6 +13387,31 @@ a class used in gtk_binding_set_by_class().
</return>
</function>
+<function name="gtk_ctree_set_node_info">
+<description>
+
+</description>
+<parameters>
+<parameter name="pixmap_closed">
+<parameter_description> (allow-none):
+</parameter_description>
+</parameter>
+<parameter name="mask_closed">
+<parameter_description> (allow-none):
+</parameter_description>
+</parameter>
+<parameter name="pixmap_opened">
+<parameter_description> (allow-none):
+</parameter_description>
+</parameter>
+<parameter name="mask_opened">
+<parameter_description> (allow-none):
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_file_chooser_button_get_width_chars">
<description>
Retrieves the width in characters of the @button widget's entry and/or label.
@@ -13023,16 +13480,16 @@ leaving a gap in one side.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="x">
@@ -13044,11 +13501,11 @@ output should not be clipped
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> width of the rectangle
+<parameter_description> width of the rectangle
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> width of the rectangle
+<parameter_description> width of the rectangle
</parameter_description>
</parameter>
<parameter name="gap_side">
@@ -13082,7 +13539,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="label">
-<parameter_description> a string
+<parameter_description> (allow-none): a string
</parameter_description>
</parameter>
</parameters>
@@ -13130,26 +13587,18 @@ Since: 2.18
</return>
</function>
-<function name="gtk_cell_view_set_model">
+<function name="gtk_tool_palette_get_drag_target_group">
<description>
-Sets the model for @cell_view. If @cell_view already has a model
-set, it will remove it before setting the new model. If @model is
-%NULL, then it will unset the old model.
+Get the target entry for a dragged #GtkToolItemGroup.
-Since: 2.6
</description>
<parameters>
-<parameter name="cell_view">
-<parameter_description> a #GtkCellView
-</parameter_description>
-</parameter>
-<parameter name="model">
-<parameter_description> a #GtkTreeModel
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> the #GtkTargetEntry for a dragged group
+
+Since: 2.20
+</return>
</function>
<function name="gtk_selection_owner_set_for_display">
@@ -13161,11 +13610,11 @@ if @widget is %NULL, release ownership of the selection.
</description>
<parameters>
<parameter name="display">
-<parameter_description> the #Gdkdisplay where the selection is set
+<parameter_description> the #Gdkdisplay where the selection is set
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> new selection owner (a #GdkWidget), or %NULL.
+<parameter_description> (allow-none): new selection owner (a #GdkWidget), or %NULL.
</parameter_description>
</parameter>
<parameter name="selection">
@@ -13216,7 +13665,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="action">
-<parameter_description> the name of the action to be proxied, or %NULL to add a separator
+<parameter_description> (allow-none): the name of the action to be proxied, or %NULL to add a separator
</parameter_description>
</parameter>
<parameter name="type">
@@ -13224,7 +13673,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="top">
-<parameter_description> if %TRUE, the UI element is added before its siblings, otherwise it
+<parameter_description> if %TRUE, the UI element is added before its siblings, otherwise it
is added after its siblings.
</parameter_description>
</parameter>
@@ -13866,7 +14315,7 @@ available, see gtk_printer_has_details() and gtk_printer_request_details().
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated list of newly allocated #GtkPageSetup s.
+<return> (element-type GtkPageSetup) (transfer full): a newly allocated list of newly allocated #GtkPageSetup s.
Since: 2.12
</return>
@@ -14104,7 +14553,7 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> an icon size
+<parameter_description> (type int): an icon size
</parameter_description>
</parameter>
</parameters>
@@ -14210,6 +14659,33 @@ Since: 2.6
</return>
</function>
+<function name="gtk_page_setup_load_file">
+<description>
+Reads the page setup from the file @file_name.
+See gtk_page_setup_to_file().
+
+
+</description>
+<parameters>
+<parameter name="setup">
+<parameter_description> a #GtkPageSetup
+</parameter_description>
+</parameter>
+<parameter name="file_name">
+<parameter_description> the filename to read the page setup from
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for an error, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success
+
+Since: 2.14
+</return>
+</function>
+
<function name="gtk_widget_set_extension_events">
<description>
Sets the extension events mask to @mode. See #GdkExtensionMode
@@ -14379,6 +14855,8 @@ Returns: index of the icon which is the source of the current
</parameters>
<return> index of the icon which is the source of the current
DND operation, or -1.
+
+Since: 2.16
</return>
</function>
@@ -14405,7 +14883,7 @@ icon variants for #GtkIconSet. The filename must be absolute.
<description>
Sets whether file choser will offer to create new folders.
This is only relevant if the action is not set to be
-GTK_FILE_CHOOSER_ACTION_OPEN.
+%GTK_FILE_CHOOSER_ACTION_OPEN.
Since: 2.18
@@ -14494,6 +14972,37 @@ Since: 2.10
<return></return>
</function>
+<function name="_gtk_file_system_model_get_value">
+<description>
+Gets the value associated with the given row @iter and @column.
+If no value is available yet and the default value should be used,
+%NULL is returned.
+This is a performance optimization for the calls
+gtk_tree_model_get() or gtk_tree_model_get_value(), which copy
+the value and spend a considerable amount of time in iterator
+lookups. Both of which are slow.
+
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #GtkFileSystemModel
+</parameter_description>
+</parameter>
+<parameter name="iter">
+<parameter_description> a #GtkTreeIter pointing to a row of @model
+</parameter_description>
+</parameter>
+<parameter name="column">
+<parameter_description> the column to get the value for
+</parameter_description>
+</parameter>
+</parameters>
+<return> a pointer to the actual value as stored in @model or %NULL
+if no value available yet.
+</return>
+</function>
+
<function name="gtk_paint_vline">
<description>
Draws a vertical line from (@x, @y1_) to (@x, @y2_) in @window
@@ -14514,16 +15023,16 @@ using the given style and state.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> rectangle to which the output is clipped, or %NULL if the
+<parameter_description> (allow-none): rectangle to which the output is clipped, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="y1_">
@@ -14638,7 +15147,8 @@ Retrieves the icon size for the toolbar. See gtk_toolbar_set_icon_size().
</parameter_description>
</parameter>
</parameters>
-<return> the current icon size for the icons on the toolbar.
+<return> (type int): the current icon size for the icons on
+the toolbar.
</return>
</function>
@@ -14732,7 +15242,7 @@ realized.
</parameter_description>
</parameter>
</parameters>
-<return> a #GdkWindow, or %NULL
+<return> (transfer none): a #GdkWindow, or %NULL
</return>
</function>
@@ -15014,20 +15524,30 @@ mnemonic character
</return>
</function>
-<function name="gtk_color_button_set_alpha">
+<function name="gtk_print_context_set_hard_margins">
<description>
-Sets the current opacity to be @alpha.
-
-Since: 2.4
+set the hard margins in pixel coordinates
</description>
<parameters>
-<parameter name="color_button">
-<parameter_description> a #GtkColorButton.
+<parameter name="context">
+<parameter_description> a #GtkPrintContext
</parameter_description>
</parameter>
-<parameter name="alpha">
-<parameter_description> an integer between 0 and 65535.
+<parameter name="top">
+<parameter_description> top hardware printer margin
+</parameter_description>
+</parameter>
+<parameter name="bottom">
+<parameter_description> bottom hardware printer margin
+</parameter_description>
+</parameter>
+<parameter name="left">
+<parameter_description> left hardware printer margin
+</parameter_description>
+</parameter>
+<parameter name="right">
+<parameter_description> right hardware printer margin
</parameter_description>
</parameter>
</parameters>
@@ -15207,7 +15727,7 @@ Retrieves the current focused widget within the window.
Note that this is the widget that would have the focus
if the toplevel window focused; if the toplevel window
is not focused then <literal>GTK_WIDGET_HAS_FOCUS (widget)</literal> will
-not be %TRUE for the widget.
+not be %TRUE for the widget.
</description>
@@ -15217,7 +15737,7 @@ not be %TRUE for the widget.
</parameter_description>
</parameter>
</parameters>
-<return> the currently focused widget, or %NULL if there is none.
+<return> (transfer none): the currently focused widget, or %NULL if there is none.
</return>
</function>
@@ -15390,7 +15910,7 @@ the icon list).
</parameter_description>
</parameter>
</parameters>
-<return> icon for window
+<return> (transfer none): icon for window
</return>
</function>
@@ -15541,7 +16061,7 @@ Gets the visual that will be used to render @widget.
</parameter_description>
</parameter>
</parameters>
-<return> the visual for @widget
+<return> (transfer none): the visual for @widget
</return>
</function>
@@ -15583,6 +16103,30 @@ connected to one accelerator group.
<return></return>
</function>
+<function name="_gtk_file_system_model_add_and_query_file">
+<description>
+This is a conenience function that calls g_file_query_info_async() on
+the given file, and when successful, adds it to the model.
+Upon failure, the @file is discarded.
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #GtkFileSystemModel
+</parameter_description>
+</parameter>
+<parameter name="file">
+<parameter_description> the file to add
+</parameter_description>
+</parameter>
+<parameter name="attributes">
+<parameter_description> attributes to query before adding the file
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_tree_model_sort_convert_child_iter_to_iter">
<description>
Sets @sort_iter to point to the row in @tree_model_sort that corresponds to
@@ -15643,7 +16187,7 @@ of the same dialog.
</parameter_description>
</parameter>
<parameter name="widget_pointer">
-<parameter_description> address of a variable that contains @widget
+<parameter_description> (inout) (transfer none): address of a variable that contains @widget
</parameter_description>
</parameter>
</parameters>
@@ -15682,7 +16226,7 @@ restoring the session.
<function name="gtk_widget_get_tooltip_window">
<description>
-Return value: The #GtkWindow of the current tooltip.
+Return value: (transfer none): The #GtkWindow of the current tooltip.
</description>
<parameters>
@@ -15691,7 +16235,7 @@ Return value: The #GtkWindow of the current tooltip.
</parameter_description>
</parameter>
</parameters>
-<return> The #GtkWindow of the current tooltip.
+<return> (transfer none): The #GtkWindow of the current tooltip.
Since: 2.12
</return>
@@ -15773,7 +16317,7 @@ g_intern_static_string().
</parameter_description>
</parameter>
<parameter name="accel_path">
-<parameter_description> a valid accelerator path
+<parameter_description> (allow-none): a valid accelerator path
</parameter_description>
</parameter>
</parameters>
@@ -15908,15 +16452,15 @@ storage specification, they will be expanded.
</parameter_description>
</parameter>
<parameter name="app_exec">
-<parameter_description> return location for the string containing the command line
+<parameter_description> (transfer none) (out): return location for the string containing the command line
</parameter_description>
</parameter>
<parameter name="count">
-<parameter_description> return location for the number of times this item was registered
+<parameter_description> (out): return location for the number of times this item was registered
</parameter_description>
</parameter>
<parameter name="time_">
-<parameter_description> return location for the timestamp this item was last registered
+<parameter_description> (out): return location for the timestamp this item was last registered
for this application
</parameter_description>
</parameter>
@@ -15961,7 +16505,7 @@ gtk_file_chooser_add_filter(), gtk_file_chooser_remove_filter().
</parameter_description>
</parameter>
</parameters>
-<return> a #GSList containing the current set of
+<return> (element-type utf8) (transfer container): a #GSList containing the current set of
user selectable filters. The contents of the list are
owned by GTK+, but you must free the list itself with
g_slist_free() when you are done with it.
@@ -16151,12 +16695,12 @@ Creates a new #GtkTreeViewColumn.
<function name="gtk_window_list_toplevels">
<description>
-Return value: list of toplevel widgets
+Return value: (element-type GtkWidget) (transfer container): list of toplevel widgets
</description>
<parameters>
</parameters>
-<return> list of toplevel widgets
+<return> (element-type GtkWidget) (transfer container): list of toplevel widgets
</return>
</function>
@@ -16320,6 +16864,12 @@ have been reordered
<parameter_description> a valid #GtkTreeIter pointing to the node whose
</parameter_description>
</parameter>
+<parameter name="new_order">
+<parameter_description> an array of integers mapping the current position of
+each child to its old position before the re-ordering,
+i.e. @new_order<literal>[newpos] = oldpos</literal>.
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
@@ -16458,6 +17008,23 @@ Deprecated: 2.0: Use gtk_paint_polygon() instead.
<return></return>
</function>
+<function name="gtk_tool_item_get_text_size_group">
+<description>
+Return value: a #GtkSizeGroup
+
+</description>
+<parameters>
+<parameter name="tool_item">
+<parameter_description> a #GtkToolItem
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GtkSizeGroup
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_item_factory_from_path">
<description>
Finds an item factory which has been constructed using the
@@ -16616,7 +17183,7 @@ on the layout in response to the #GtkWidget::style-set and
</parameter_description>
</parameter>
</parameters>
-<return> the #PangoContext for the widget.
+<return> (transfer none): the #PangoContext for the widget.
</return>
</function>
@@ -16966,6 +17533,28 @@ See gtk_image_menu_item_set_image().
</return>
</function>
+<function name="gtk_assistant_get_page_complete">
+<description>
+Gets whether @page is complete.
+
+
+</description>
+<parameters>
+<parameter name="assistant">
+<parameter_description> a #GtkAssistant
+</parameter_description>
+</parameter>
+<parameter name="page">
+<parameter_description> a page of @assistant
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @page is complete.
+
+Since: 2.10
+</return>
+</function>
+
<function name="gtk_menu_shell_set_take_focus">
<description>
If @take_focus is %TRUE (the default) the menu shell will take the keyboard
@@ -17107,12 +17696,12 @@ G_OBJECT_TYPE (widget));
</parameter_description>
</parameter>
<parameter name="widget_path">
-<parameter_description> the widget path to use when looking up the style, or %NULL
+<parameter_description> (allow-none): the widget path to use when looking up the style, or %NULL
if no matching against the widget path should be done
</parameter_description>
</parameter>
<parameter name="class_path">
-<parameter_description> the class path to use when looking up the style, or %NULL
+<parameter_description> (allow-none): the class path to use when looking up the style, or %NULL
if no matching against the class path should be done.
</parameter_description>
</parameter>
@@ -17170,25 +17759,21 @@ Since: 2.18
</return>
</function>
-<function name="gtk_assistant_get_page_complete">
+<function name="gtk_viewport_get_bin_window">
<description>
-Gets whether @page is complete.
+Gets the bin window of the #GtkViewport.
</description>
<parameters>
-<parameter name="assistant">
-<parameter_description> a #GtkAssistant
-</parameter_description>
-</parameter>
-<parameter name="page">
-<parameter_description> a page of @assistant
+<parameter name="viewport">
+<parameter_description> a #GtkViewport
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @page is complete.
+<return> a #GdkWindow
-Since: 2.10
+Since: 2.20
</return>
</function>
@@ -17266,7 +17851,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> location to store a list of icon theme path directories or %NULL
+<parameter_description> (array length=n_elements) (out): location to store a list of icon theme path directories or %NULL
The stored value should be freed with g_strfreev().
</parameter_description>
</parameter>
@@ -17496,7 +18081,7 @@ image" icon will be returned instead.
</parameter_description>
</parameter>
<parameter name="style">
-<parameter_description> a #GtkStyle associated with @widget, or %NULL
+<parameter_description> (allow-none): a #GtkStyle associated with @widget, or %NULL
</parameter_description>
</parameter>
<parameter name="direction">
@@ -17508,7 +18093,7 @@ image" icon will be returned instead.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> icon size. A size of (GtkIconSize)-1
+<parameter_description> (type int): icon size. A size of (GtkIconSize)-1
means render at the size of the source and don't scale.
</parameter_description>
</parameter>
@@ -17747,7 +18332,7 @@ gtk_file_chooser_add_shortcut_folder_uri().
</parameter_description>
</parameter>
</parameters>
-<return> A list of folder URIs, or %NULL if there are no shortcut
+<return> (element-type utf8) (transfer full): A list of folder URIs, or %NULL if there are no shortcut
folders. Free the returned list with g_slist_free(), and the URIs with
g_free().
@@ -18122,11 +18707,11 @@ use @selection is #GTK_SELECTION_MULTIPLE.
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> A pointer to set to the #GtkTreeModel, or NULL.
+<parameter_description> (out) (allow-none): A pointer to set to the #GtkTreeModel, or NULL.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> The #GtkTreeIter, or NULL.
+<parameter_description> (allow-none): The #GtkTreeIter, or NULL.
</parameter_description>
</parameter>
</parameters>
@@ -18282,7 +18867,7 @@ See gtk_entry_set_cursor_hadjustment().
</parameter_description>
</parameter>
</parameters>
-<return> the horizontal cursor adjustment, or %NULL
+<return> (transfer none): the horizontal cursor adjustment, or %NULL
if none has been set.
Since: 2.12
@@ -18341,6 +18926,29 @@ Return value: a character offset
</return>
</function>
+<function name="gtk_tool_palette_get_expand">
+<description>
+Gets whether group should be given extra space.
+See gtk_tool_palette_set_expand().
+
+
+</description>
+<parameters>
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
+</parameter_description>
+</parameter>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup which is a child of palette
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if group should be given extra space, %FALSE otherwise
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_print_settings_to_key_file">
<description>
This function adds the print settings from @settings to @key_file.
@@ -18468,7 +19076,7 @@ Since: 2.4
<function name="gtk_text_buffer_get_selection_bound">
<description>
-Return value: selection bound mark
+Return value: (transfer none): selection bound mark
</description>
<parameters>
@@ -18477,7 +19085,7 @@ Return value: selection bound mark
</parameter_description>
</parameter>
</parameters>
-<return> selection bound mark
+<return> (transfer none): selection bound mark
</return>
</function>
@@ -18686,6 +19294,26 @@ Since: 2.2
</return>
</function>
+<function name="gtk_color_button_set_alpha">
+<description>
+Sets the current opacity to be @alpha.
+
+Since: 2.4
+
+</description>
+<parameters>
+<parameter name="color_button">
+<parameter_description> a #GtkColorButton.
+</parameter_description>
+</parameter>
+<parameter name="alpha">
+<parameter_description> an integer between 0 and 65535.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_tree_view_get_tooltip_context">
<description>
This function is supposed to be used in a #GtkWidget::query-tooltip
@@ -18904,6 +19532,54 @@ you'd like the layout to use for scrolling, pass %NULL for
</return>
</function>
+<function name="gtk_draw_extension">
+<description>
+Draws an extension, i.e. a notebook tab.
+
+Deprecated: 2.0: Use gtk_paint_extension() instead.
+
+</description>
+<parameters>
+<parameter name="style">
+<parameter_description> a #GtkStyle
+</parameter_description>
+</parameter>
+<parameter name="window">
+<parameter_description> a #GdkWindow
+</parameter_description>
+</parameter>
+<parameter name="state_type">
+<parameter_description> a state
+</parameter_description>
+</parameter>
+<parameter name="shadow_type">
+<parameter_description> type of shadow to draw
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> x origin of the extension
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> y origin of the extension
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> width of the extension
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> width of the extension
+</parameter_description>
+</parameter>
+<parameter name="gap_side">
+<parameter_description> the side on to which the extension is attached
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_alignment_set_padding">
<description>
Sets the padding on the different sides of the widget.
@@ -18978,7 +19654,8 @@ which is an entry with completion with respect to a
<function name="gtk_print_settings_load_file">
<description>
-Reads the print settings from @file_name.
+Reads the print settings from @file_name. If the file could not be loaded
+then error is set to either a #GFileError or #GKeyFileError.
See gtk_print_settings_to_file().
@@ -19092,11 +19769,14 @@ Since: 2.4
<function name="GtkTextView">
<description>
-The ::toggle-cursor-visible signal is a
-<link linkend="keybinding-signals">keybinding signal</link>
-which gets emitted to toggle the visibility of the cursor.
+If an input method is used, the typed text will not immediately
+be committed to the buffer. So if you are interested in the text,
+connect to this signal.
-The default binding for this signal is F7.
+This signal is only emitted if the text at the given position
+is actually editable.
+
+Since: 2.20
</description>
<parameters>
@@ -19104,6 +19784,10 @@ The default binding for this signal is F7.
<parameter_description> the object which received the signal
</parameter_description>
</parameter>
+<parameter name="preedit">
+<parameter_description> the current preedit string
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
@@ -19208,7 +19892,7 @@ returned instance will be freed when you application terminates.
</description>
<parameters>
</parameters>
-<return> A unique #GtkRecentManager. Do not ref or unref it.
+<return> (transfer none): A unique #GtkRecentManager. Do not ref or unref it.
Since: 2.10
</return>
@@ -19282,9 +19966,8 @@ Since: 2.6
<function name="gtk_about_dialog_set_comments">
<description>
-Sets the comments string to display in the about
-dialog. This should be a short string of one or
-two lines.
+Sets the comments string to display in the about dialog.
+This should be a short string of one or two lines.
Since: 2.6
@@ -19295,7 +19978,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="comments">
-<parameter_description> a comments string
+<parameter_description> (allow-none): a comments string
</parameter_description>
</parameter>
</parameters>
@@ -19367,25 +20050,24 @@ gtk_get_default_language ().
</return>
</function>
-<function name="gtk_file_chooser_add_filter">
+<function name="gtk_tool_palette_set_drag_source">
<description>
-Adds @filter to the list of filters that the user can select between.
-When a filter is selected, only files that are passed by that
-filter are displayed.
-
-Note that the @chooser takes ownership of the filter, so you have to
-ref and sink it if you want to keep a reference.
+Sets the tool palette as a drag source.
+Enables all groups and items in the tool palette as drag sources
+on button 1 and button 3 press with copy and move actions.
+See gtk_drag_source_set().
-Since: 2.4
+Since: 2.20
</description>
<parameters>
-<parameter name="chooser">
-<parameter_description> a #GtkFileChooser
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
</parameter_description>
</parameter>
-<parameter name="filter">
-<parameter_description> a #GtkFileFilter
+<parameter name="targets">
+<parameter_description> the #GtkToolPaletteDragTarget<!-- -->s
+which the widget should support
</parameter_description>
</parameter>
</parameters>
@@ -19473,16 +20155,16 @@ Draws a handle as used in #GtkHandleBox and #GtkPaned.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="x">
@@ -19530,8 +20212,8 @@ writing loops.
<function name="gtk_tree_model_iter_children">
<description>
-Sets @iter to point to the first child of @parent. If @parent has no
-children, %FALSE is returned and @iter is set to be invalid. @parent
+Sets @iter to point to the first child of @parent. If @parent has no
+children, %FALSE is returned and @iter is set to be invalid. @parent
will remain a valid node after this function has been called.
If @parent is %NULL returns the first node, equivalent to
@@ -19549,7 +20231,7 @@ If @parent is %NULL returns the first node, equivalent to
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> The #GtkTreeIter, or %NULL
+<parameter_description> (allow-none): The #GtkTreeIter, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -19642,7 +20324,7 @@ Since: 2.14
<function name="gtk_action_get_proxies">
<description>
-Return value: a #GSList of proxy widgets. The list is owned by GTK+
+Return value: (element-type GtkWidget) (transfer none): a #GSList of proxy widgets. The list is owned by GTK+
</description>
<parameters>
@@ -19651,7 +20333,7 @@ Return value: a #GSList of proxy widgets. The list is owned by GTK+
</parameter_description>
</parameter>
</parameters>
-<return> a #GSList of proxy widgets. The list is owned by GTK+
+<return> (element-type GtkWidget) (transfer none): a #GSList of proxy widgets. The list is owned by GTK+
and must not be modified.
Since: 2.4
@@ -19699,7 +20381,7 @@ g_intern_static_string().
<function name="gtk_combo_box_set_model">
<description>
-Sets the model used by @combo_box to be @model. Will unset a previously set
+Sets the model used by @combo_box to be @model. Will unset a previously set
model (if applicable). If model is %NULL, then it will unset the model.
Note that this function does not clear the cell renderers, you have to
@@ -19715,7 +20397,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> A #GtkTreeModel
+<parameter_description> (allow-none): A #GtkTreeModel
</parameter_description>
</parameter>
</parameters>
@@ -19769,7 +20451,7 @@ as #GFile. An internal function, see gtk_file_chooser_get_uris().
</parameter_description>
</parameter>
</parameters>
-<return> a #GSList containing a #GFile for each selected
+<return> (element-type utf8) (transfer full): a #GSList containing a #GFile for each selected
file and subfolder in the current folder. Free the returned list
with g_slist_free(), and the files with g_object_unref().
@@ -19900,7 +20582,7 @@ Since: 2.4
<function name="gtk_text_buffer_get_mark">
<description>
-Return value: a #GtkTextMark, or %NULL
+Return value: (transfer none): a #GtkTextMark, or %NULL
</description>
<parameters>
@@ -19913,7 +20595,7 @@ Return value: a #GtkTextMark, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GtkTextMark, or %NULL
+<return> (transfer none): a #GtkTextMark, or %NULL
</return>
</function>
@@ -20045,7 +20727,7 @@ objects.
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated #GSList containing all the objects
+<return> (element-type GObject) (transfer container): a newly-allocated #GSList containing all the objects
constructed by the #GtkBuilder instance. It should be freed by
g_slist_free()
@@ -20074,6 +20756,20 @@ Since: 2.4
</return>
</function>
+<function name="gtk_tool_palette_new">
+<description>
+Creates a new tool palette.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GtkToolPalette
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_tree_view_get_headers_visible">
<description>
Return value: Whether the headers are visible or not.
@@ -20101,7 +20797,7 @@ signal is emitted with response IDs from #GtkResponseType. See
</description>
<parameters>
<parameter name="parent">
-<parameter_description> transient parent, or %NULL for none
+<parameter_description> (allow-none): transient parent, or %NULL for none
</parameter_description>
</parameter>
<parameter name="flags">
@@ -20117,7 +20813,7 @@ signal is emitted with response IDs from #GtkResponseType. See
</parameter_description>
</parameter>
<parameter name="message_format">
-<parameter_description> printf()-style format string, or %NULL
+<parameter_description> (allow-none): printf()-style format string, or %NULL
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -20125,7 +20821,7 @@ signal is emitted with response IDs from #GtkResponseType. See
</parameter_description>
</parameter>
</parameters>
-<return> a new #GtkMessageDialog
+<return> (transfer none): a new #GtkMessageDialog
</return>
</function>
@@ -20205,46 +20901,6 @@ window.
<return></return>
</function>
-<function name="_gtk_file_system_model_path_do">
-<description>
-Locates @path within @model, referencing
-(gtk_tree_model_ref_node()) all parent nodes,
-calls @func passing in the path and iter for @path,
-then unrefs all the parent nodes.
-
-The reason for doing this operation as a callback
-is so that if the operation performed with the
-path and iter results in referencing the node
-and/or parent nodes, we don't load all the information
-about the nodes.
-
-This function is particularly useful for expanding
-a #GtkTreeView to a particular point in the file system.
-
-</description>
-<parameters>
-<parameter name="model">
-<parameter_description> a #GtkFileSystemModel
-</parameter_description>
-</parameter>
-<parameter name="path">
-<parameter_description> a path pointing to a file in the filesystem
-for @model.
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> Function to call with the path and iter corresponding
-to @path.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> data to pass to @func
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="gtk_tree_view_set_hadjustment">
<description>
Sets the #GtkAdjustment for the current horizontal aspect.
@@ -20734,7 +21390,7 @@ Obtains the default colormap used to create widgets.
</description>
<parameters>
</parameters>
-<return> default widget colormap
+<return> (transfer none): default widget colormap
</return>
</function>
@@ -21160,16 +21816,16 @@ Draws a polygon on @window with the given parameters.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="points">
@@ -21325,7 +21981,7 @@ Looks up an action in the action group by name.
</parameter_description>
</parameter>
</parameters>
-<return> the action, or %NULL if no action by that name exists
+<return> (transfer-none): the action, or %NULL if no action by that name exists
Since: 2.4
</return>
@@ -21471,11 +22127,11 @@ instead.
</parameter_description>
</parameter>
<parameter name="tip_text">
-<parameter_description> text to be used as tooltip text for tool_item
+<parameter_description> (allow-none): text to be used as tooltip text for tool_item
</parameter_description>
</parameter>
<parameter name="tip_private">
-<parameter_description> text to be used as private tooltip text
+<parameter_description> (allow-none): text to be used as private tooltip text
</parameter_description>
</parameter>
</parameters>
@@ -21735,6 +22391,24 @@ Since: 2.4
<return></return>
</function>
+<function name="gtk_tool_item_get_text_alignment">
+<description>
+Return value: a #gfloat indicating the horizontal text alignment
+
+</description>
+<parameters>
+<parameter name="tool_item">
+<parameter_description> a #GtkToolItem:
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #gfloat indicating the horizontal text alignment
+used for @tool_item
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_file_chooser_get_filename">
<description>
Gets the filename for the currently selected file in
@@ -22208,7 +22882,7 @@ Since: 2.16
<function name="gtk_about_dialog_set_email_hook">
<description>
Installs a global function to be called whenever the user activates an
-email link in an about dialog.
+email link in an about dialog.
Since 2.18 there exists a default function which uses gtk_show_uri(). To
deactivate it, you can pass %NULL for @func.
@@ -22259,16 +22933,16 @@ the given parameters.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="x">
@@ -22336,7 +23010,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="label_widget">
-<parameter_description> the widget used as label, or %NULL
+<parameter_description> (allow-none): the widget used as label, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -22401,7 +23075,7 @@ Since: 2.6
<function name="gtk_text_view_get_buffer">
<description>
-Return value: a #GtkTextBuffer
+Return value: (transfer none): a #GtkTextBuffer
</description>
<parameters>
@@ -22410,7 +23084,7 @@ Return value: a #GtkTextBuffer
</parameter_description>
</parameter>
</parameters>
-<return> a #GtkTextBuffer
+<return> (transfer none): a #GtkTextBuffer
</return>
</function>
@@ -22559,24 +23233,36 @@ Since: 2.18
<return></return>
</function>
-<function name="gtk_progress_bar_get_text">
+<function name="gtk_text_layout_validate_yrange">
<description>
-Retrieves the text displayed superimposed on the progress bar,
-if any, otherwise %NULL. The return value is a reference
-to the text, not a copy of it, so will become invalid
-if you change the text in the progress bar.
-
+Ensure that a region of a #GtkTextLayout is valid. The ::changed
+signal will be emitted if any lines are validated.
</description>
<parameters>
-<parameter name="pbar">
-<parameter_description> a #GtkProgressBar
+<parameter name="layout">
+<parameter_description> a #GtkTextLayout
+</parameter_description>
+</parameter>
+<parameter name="anchor">
+<parameter_description> iter pointing into a line that will be used as the
+coordinate origin
+</parameter_description>
+</parameter>
+<parameter name="y0_">
+<parameter_description> offset from the top of the line pointed to by @anchor at
+which to begin validation. (The offset here is in pixels
+after validation.)
+</parameter_description>
+</parameter>
+<parameter name="y1_">
+<parameter_description> offset from the top of the line pointed to by @anchor at
+which to end validation. (The offset here is in pixels
+after validation.)
</parameter_description>
</parameter>
</parameters>
-<return> text, or %NULL; this string is owned by the widget
-and should not be modified or freed.
-</return>
+<return></return>
</function>
<function name="gtk_list_store_insert_with_values">
@@ -22724,7 +23410,7 @@ Since: 2.4
<function name="gtk_size_group_get_widgets">
<description>
-Return value: a #GSList of widgets. The list is owned by GTK+
+Return value: (element-type GtkWidget) (transfer none): a #GSList of
</description>
<parameters>
@@ -22733,8 +23419,8 @@ Return value: a #GSList of widgets. The list is owned by GTK+
</parameter_description>
</parameter>
</parameters>
-<return> a #GSList of widgets. The list is owned by GTK+
-and should not be modified.
+<return> (element-type GtkWidget) (transfer none): a #GSList of
+widgets. The list is owned by GTK+ and should not be modified.
Since: 2.10
</return>
@@ -22809,22 +23495,19 @@ of the editable. Note that @position is in characters, not in bytes.
<function name="gtk_clipboard_get">
<description>
-Return value: the appropriate clipboard object. If no
+Return value: the appropriate clipboard object. If no clipboard
</description>
<parameters>
<parameter name="selection">
-<parameter_description> a #GdkAtom which identifies the clipboard
-to use.
+<parameter_description> a #GdkAtom which identifies the clipboard to use
</parameter_description>
</parameter>
</parameters>
-<return> the appropriate clipboard object. If no
-clipboard already exists, a new one will
-be created. Once a clipboard object has
-been created, it is persistent and, since
-it is owned by GTK+, must not be freed or
-unrefd.
+<return> the appropriate clipboard object. If no clipboard
+already exists, a new one will be created. Once a clipboard
+object has been created, it is persistent and, since it is
+owned by GTK+, must not be freed or unreffed.
</return>
</function>
@@ -22845,7 +23528,7 @@ Return value: The current width of @tree_column.
<function name="gtk_notebook_get_tab_label">
<description>
-Return value: the tab label
+Return value: (transfer none): the tab label
</description>
<parameters>
@@ -22858,7 +23541,7 @@ Return value: the tab label
</parameter_description>
</parameter>
</parameters>
-<return> the tab label
+<return> (transfer none): the tab label
</return>
</function>
@@ -23214,46 +23897,6 @@ Since: 2.10
<return></return>
</function>
-<function name="gtk_window_begin_resize_drag">
-<description>
-Starts resizing a window. This function is used if an application
-has window resizing controls. When GDK can support it, the resize
-will be done using the standard mechanism for the <link
-linkend="gtk-X11-arch">window manager</link> or windowing
-system. Otherwise, GDK will try to emulate window resizing,
-potentially not all that well, depending on the windowing system.
-
-
-</description>
-<parameters>
-<parameter name="window">
-<parameter_description> a #GtkWindow
-</parameter_description>
-</parameter>
-<parameter name="button">
-<parameter_description> mouse button that initiated the drag
-</parameter_description>
-</parameter>
-<parameter name="edge">
-<parameter_description> position of the resize control
-</parameter_description>
-</parameter>
-<parameter name="root_x">
-<parameter_description> X position where the user clicked to initiate the drag, in root window coordinates
-</parameter_description>
-</parameter>
-<parameter name="root_y">
-<parameter_description> Y position where the user clicked to initiate the drag
-</parameter_description>
-</parameter>
-<parameter name="timestamp">
-<parameter_description> timestamp from the click event that initiated the drag
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="gtk_text_buffer_backspace">
<description>
Performs the appropriate action as if the user hit the delete
@@ -23347,7 +23990,7 @@ a stepping of @step.
</description>
<parameters>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> (int): a stock icon size
</parameter_description>
</parameter>
<parameter name="min">
@@ -23431,12 +24074,12 @@ label in the popup menu.
</parameter_description>
</parameter>
<parameter name="tab_label">
-<parameter_description> the #GtkWidget to be used as the label for the page,
+<parameter_description> (allow-none): the #GtkWidget to be used as the label for the page,
or %NULL to use the default label, 'page N'.
</parameter_description>
</parameter>
<parameter name="menu_label">
-<parameter_description> the widget to use as a label for the page-switch
+<parameter_description> (allow-none): the widget to use as a label for the page-switch
menu, if that is enabled. If %NULL, and @tab_label
is a #GtkLabel or %NULL, then the menu label will be
a newly created label with the same text as @tab_label;
@@ -23595,8 +24238,8 @@ Since: 2.16
<function name="gtk_print_run_page_setup_dialog">
<description>
-Runs a page setup dialog, letting the user modify the values from
- page_setup If the user cancels the dialog, the returned #GtkPageSetup
+Runs a page setup dialog, letting the user modify the values from
+ page_setup If the user cancels the dialog, the returned #GtkPageSetup
is identical to the passed in @page_setup, otherwise it contains the
modifications done in the dialog.
@@ -23608,11 +24251,11 @@ a problem.
</description>
<parameters>
<parameter name="parent">
-<parameter_description> transient parent, or %NULL
+<parameter_description> (allow-none): transient parent
</parameter_description>
</parameter>
<parameter name="page_setup">
-<parameter_description> an existing #GtkPageSetup, or %NULL
+<parameter_description> (allow-none): an existing #GtkPageSetup
</parameter_description>
</parameter>
<parameter name="settings">
@@ -23820,7 +24463,7 @@ Since: 2.18
<function name="gtk_recent_info_get_groups">
<description>
-Return value: a newly allocated %NULL terminated array of strings. Use
+Return value: (array length=length zero-terminated=1): a newly allocated
</description>
<parameters>
@@ -23829,12 +24472,12 @@ Return value: a newly allocated %NULL terminated array of strings. Use
</parameter_description>
</parameter>
<parameter name="length">
-<parameter_description> return location for the number of groups returned, or %NULL
+<parameter_description> (out) (allow-none): return location for the number of groups returned
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated %NULL terminated array of strings. Use
-g_strfreev() to free it.
+<return> (array length=length zero-terminated=1): a newly allocated
+%NULL terminated array of strings. Use g_strfreev() to free it.
Since: 2.10
</return>
@@ -24097,7 +24740,7 @@ etc. Returns the integer value for the size.
</parameter_description>
</parameter>
</parameters>
-<return> integer value representing the size
+<return> (type int): integer value representing the size
</return>
</function>
@@ -24198,7 +24841,7 @@ Since: 2.6
<function name="gtk_text_buffer_get_insert">
<description>
-Return value: insertion point mark
+Return value: (transfer none): insertion point mark
</description>
<parameters>
@@ -24207,7 +24850,7 @@ Return value: insertion point mark
</parameter_description>
</parameter>
</parameters>
-<return> insertion point mark
+<return> (transfer none): insertion point mark
</return>
</function>
@@ -24363,7 +25006,7 @@ Insert a page into @notebook at the given position.
</parameter_description>
</parameter>
<parameter name="tab_label">
-<parameter_description> the #GtkWidget to be used as the label for the page,
+<parameter_description> (allow-none): the #GtkWidget to be used as the label for the page,
or %NULL to use the default label, 'page N'.
</parameter_description>
</parameter>
@@ -24652,17 +25295,38 @@ returned image and mask.
</parameter_description>
</parameter>
<parameter name="gdk_image">
-<parameter_description> return location for a #GtkImage, or %NULL
+<parameter_description> (out) (transfer none) (allow-none): return location for
+a #GtkImage, or %NULL
</parameter_description>
</parameter>
<parameter name="mask">
-<parameter_description> return location for a #GdkBitmap, or %NULL
+<parameter_description> (out) (transfer none) (allow-none): return location for a
+#GdkBitmap, or %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="_gtk_file_system_model_get_cancellable">
+<description>
+Gets the cancellable used by the @model. This is the cancellable used
+internally by the @model that will be cancelled when @model is
+disposed. So you can use it for operations that should be cancelled
+when the model goes away.
+
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> the model
+</parameter_description>
+</parameter>
+</parameters>
+<return> The cancellable used by @model
+</return>
+</function>
+
<function name="gtk_window_group_add_window">
<description>
Adds a window to a #GtkWindowGroup.
@@ -24732,7 +25396,7 @@ If the element at @iter is a pixbuf, the pixbuf is returned
</parameter_description>
</parameter>
</parameters>
-<return> the pixbuf at @iter
+<return> (transfer none): the pixbuf at @iter
</return>
</function>
@@ -24903,6 +25567,28 @@ Since: 2.12
</return>
</function>
+<function name="gtk_paper_size_get_default_top_margin">
+<description>
+Gets the default top margin for the #GtkPaperSize.
+
+
+</description>
+<parameters>
+<parameter name="size">
+<parameter_description> a #GtkPaperSize object
+</parameter_description>
+</parameter>
+<parameter name="unit">
+<parameter_description> the unit for the return value
+</parameter_description>
+</parameter>
+</parameters>
+<return> the default top margin
+
+Since: 2.10
+</return>
+</function>
+
<function name="gtk_font_selection_new">
<description>
Creates a new #GtkFontSelection.
@@ -25178,15 +25864,15 @@ Deprecated: 2.4: Use gtk_toolbar_insert() instead.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> a #GtkWidget to add to the toolbar.
+<parameter_description> a #GtkWidget to add to the toolbar.
</parameter_description>
</parameter>
<parameter name="tooltip_text">
-<parameter_description> the element's tooltip.
+<parameter_description> (allow-none): the element's tooltip.
</parameter_description>
</parameter>
<parameter name="tooltip_private_text">
-<parameter_description> used for context-sensitive help about this toolbar element.
+<parameter_description> (allow-none): used for context-sensitive help about this toolbar element.
</parameter_description>
</parameter>
<parameter name="position">
@@ -25261,8 +25947,6 @@ inside a #GtkSocket within the same application.
To reliably find the toplevel #GtkWindow, use
gtk_widget_get_toplevel() and check if the %TOPLEVEL flags
is set on the result.
-
-
</description>
<parameters>
<parameter name="widget">
@@ -25270,14 +25954,14 @@ is set on the result.
</parameter_description>
</parameter>
</parameters>
-<return> the topmost ancestor of @widget, or @widget itself
+<return> (transfer none): the topmost ancestor of @widget, or @widget itself
if there's no ancestor.
</return>
</function>
<function name="gtk_widget_get_clipboard">
<description>
-Return value: the appropriate clipboard object. If no
+Return value: (transfer none): the appropriate clipboard object. If no
</description>
<parameters>
@@ -25294,7 +25978,7 @@ the primary X selection.
</parameter_description>
</parameter>
</parameters>
-<return> the appropriate clipboard object. If no
+<return> (transfer none): the appropriate clipboard object. If no
clipboard already exists, a new one will
be created. Once a clipboard object has
been created, it is persistent for all time.
@@ -25401,8 +26085,11 @@ Gets the value set by gtk_entry_set_width_chars().
<function name="gtk_print_settings_new_from_key_file">
<description>
-Reads the print settings from the group @group_name in @key_file.
-Return value: the restored #GtkPrintSettings
+Reads the print settings from the group @group_name in @key_file. Returns a
+new #GtkPrintSettings object with the restored settings, or %NULL if an
+error occurred. If the file could not be loaded then error is set to either
+a #GFileError or #GKeyFileError.
+
</description>
<parameters>
@@ -25426,21 +26113,21 @@ Since: 2.12
</return>
</function>
-<function name="gtk_label_get_mnemonic_widget">
+<function name="gtk_statusbar_get_message_area">
<description>
-Retrieves the target of the mnemonic (keyboard shortcut) of this
-label. See gtk_label_set_mnemonic_widget().
+Retrieves the box containing the label widget.
</description>
<parameters>
-<parameter name="label">
-<parameter_description> a #GtkLabel
+<parameter name="statusbar">
+<parameter_description> a #GtkStatusBar
</parameter_description>
</parameter>
</parameters>
-<return> the target of the label's mnemonic, or %NULL if none
-has been set and the default algorithm will be used.
+<return> a #GtkBox
+
+Since: 2.20
</return>
</function>
@@ -25744,7 +26431,8 @@ size of icons.
</parameter_description>
</parameter>
<parameter name="icon_size">
-<parameter_description> The #GtkIconSize that stock icons in the toolbar shall have.
+<parameter_description> (type int): The #GtkIconSize that stock icons in the
+toolbar shall have.
</parameter_description>
</parameter>
</parameters>
@@ -25820,11 +26508,11 @@ label.
</description>
<parameters>
<parameter name="label">
-<parameter_description> a string that will be used as label, or %NULL
+<parameter_description> (allow-none): a string that will be used as label, or %NULL
</parameter_description>
</parameter>
<parameter name="icon_widget">
-<parameter_description> a widget that will be used as icon widget, or %NULL
+<parameter_description> (allow-none): a widget that will be used as icon widget, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -25906,6 +26594,26 @@ policy involved.
<return></return>
</function>
+<function name="gtk_tool_item_group_get_label">
+<description>
+Gets the label of @group.
+
+
+</description>
+<parameters>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup
+</parameter_description>
+</parameter>
+</parameters>
+<return> the label of @group. The label is an internal string of @group
+and must not be modified. Note that %NULL is returned if a custom
+label has been set with gtk_tool_item_group_set_label_widget()
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_info_bar_get_content_area">
<description>
Returns: the content area.
@@ -26002,14 +26710,15 @@ Deprecated: 2.2: Use gtk_widget_queue_draw_area() instead.
<description>
Gets a list of all accel groups which are attached to @object.
+
</description>
<parameters>
<parameter name="object">
-<parameter_description> a #GObject, usually a #GtkWindow
+<parameter_description> a #GObject, usually a #GtkWindow
</parameter_description>
</parameter>
</parameters>
-<return> a list of all accel groups which are attached to @object
+<return> (element-type GtkAccelGroup) (transfer none): a list of all accel groups which are attached to @object
</return>
</function>
@@ -26050,6 +26759,8 @@ overriding the standard key handling for a toplevel window.
</parameter>
</parameters>
<return> %TRUE if a mnemonic or accelerator was found and activated.
+
+Since: 2.4
</return>
</function>
@@ -26127,6 +26838,26 @@ This function is used in the implementation of #GtkUIManager.
<return></return>
</function>
+<function name="gtk_menu_bar_set_child_pack_direction">
+<description>
+Sets how widgets should be packed inside the children of a menubar.
+
+Since: 2.8
+
+</description>
+<parameters>
+<parameter name="menubar">
+<parameter_description> a #GtkMenuBar
+</parameter_description>
+</parameter>
+<parameter name="child_pack_dir">
+<parameter_description> a new #GtkPackDirection
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_entry_set_alignment">
<description>
Sets the alignment for the contents of the entry. This controls
@@ -26194,7 +26925,7 @@ is only useful/meaningful if the icon size is <emphasis>not</emphasis&g
</parameter_description>
</parameter>
</parameters>
-<return> icon size this source matches.
+<return> (type int): icon size this source matches.
</return>
</function>
@@ -26355,13 +27086,13 @@ Simply an accessor function that returns @widget->style.
</parameter_description>
</parameter>
</parameters>
-<return> the widget's #GtkStyle
+<return> (transfer none): the widget's #GtkStyle
</return>
</function>
<function name="gtk_combo_box_get_model">
<description>
-Return value: A #GtkTreeModel which was passed during construction.
+Return value: (transfer none): A #GtkTreeModel which was passed during construction.
</description>
<parameters>
@@ -26370,7 +27101,7 @@ Return value: A #GtkTreeModel which was passed during construction.
</parameter_description>
</parameter>
</parameters>
-<return> A #GtkTreeModel which was passed during construction.
+<return> (transfer none): A #GtkTreeModel which was passed during construction.
Since: 2.4
</return>
@@ -26394,7 +27125,7 @@ the usual size.
</description>
<parameters>
<parameter name="size">
-<parameter_description> an icon size
+<parameter_description> (type int): an icon size
</parameter_description>
</parameter>
<parameter name="width">
@@ -26422,12 +27153,12 @@ Retrieves the list of applications that have registered this resource.
</parameter_description>
</parameter>
<parameter name="length">
-<parameter_description> return location for the length of the returned list, or %NULL
+<parameter_description> (out) (allow-none): return location for the length of the returned list
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated %NULL-terminated array of strings.
-Use g_strfreev() to free it.
+<return> (array length=length zero-terminated=1): a newly allocated
+%NULL-terminated array of strings. Use g_strfreev() to free it.
Since: 2.10
</return>
@@ -26523,21 +27254,41 @@ Since: 2.6
<return></return>
</function>
-<function name="gtk_widget_get_modifier_style">
+<function name="gtk_print_operation_set_unit">
<description>
-Return value: the modifier style for the widget. This rc style is
+Sets up the transformation for the cairo context obtained from
+#GtkPrintContext in such a way that distances are measured in
+units of @unit.
+
+Since: 2.10
</description>
<parameters>
-<parameter name="widget">
-<parameter_description> a #GtkWidget
+<parameter name="op">
+<parameter_description> a #GtkPrintOperation
+</parameter_description>
+</parameter>
+<parameter name="unit">
+<parameter_description> the unit to use
</parameter_description>
</parameter>
</parameters>
-<return> the modifier style for the widget. This rc style is
-owned by the widget. If you want to keep a pointer to value this
-around, you must add a refcount using g_object_ref().
-</return>
+<return></return>
+</function>
+
+<function name="gtk_editable_copy_clipboard">
+<description>
+Copies the contents of the currently selected content in the editable and
+puts it on the clipboard.
+
+</description>
+<parameters>
+<parameter name="editable">
+<parameter_description> a #GtkEditable
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
<function name="gtk_cell_renderer_toggle_get_activatable">
@@ -26626,7 +27377,7 @@ Removes @column from @tree_view.
<description>
Associates @value with @key.
-Since: 2.10
+Since: 2.10
</description>
<parameters>
@@ -26639,7 +27390,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="value">
-<parameter_description> a string value, or %NULL
+<parameter_description> (allow-none): a string value, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -26719,7 +27470,7 @@ Gets the value set by gtk_range_set_inverted().
<function name="gtk_about_dialog_set_program_name">
<description>
-Sets the name to display in the about dialog.
+Sets the name to display in the about dialog.
If this is not set, it defaults to g_get_application_name().
Since: 2.12
@@ -27025,7 +27776,7 @@ destroyed and when the translation function is changed again
<function name="gtk_text_iter_get_tags">
<description>
-Return value: list of #GtkTextTag
+Return value: (element-type GtkTextTag) (transfer container): list of #GtkTextTag
</description>
<parameters>
@@ -27034,7 +27785,7 @@ Return value: list of #GtkTextTag
</parameter_description>
</parameter>
</parameters>
-<return> list of #GtkTextTag
+<return> (element-type GtkTextTag) (transfer container): list of #GtkTextTag
</return>
</function>
@@ -27200,7 +27951,7 @@ a single icon theme object will be shared between users.
</parameter_description>
</parameter>
</parameters>
-<return> A unique #GtkIconTheme associated with
+<return> (transfer none): A unique #GtkIconTheme associated with
the given screen. This icon theme is associated with
the screen and can be used as long as the screen
is open. Do not ref or unref it.
@@ -27638,11 +28389,13 @@ The storage type of the image must be %GTK_IMAGE_EMPTY or
</parameter_description>
</parameter>
<parameter name="icon_set">
-<parameter_description> location to store a #GtkIconSet, or %NULL
+<parameter_description> (out) (transfer none) (allow-none): location to store a
+#GtkIconSet, or %NULL
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> location to store a stock icon size, or %NULL
+<parameter_description> (out) (allow-none) (type int): location to store a stock
+icon size, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -27714,7 +28467,7 @@ Return value: whether @iter is the start of a range tagged with @tag
</parameter_description>
</parameter>
<parameter name="tag">
-<parameter_description> a #GtkTextTag, or %NULL
+<parameter_description> (allow-none): a #GtkTextTag, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -28146,7 +28899,21 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="border">
-<parameter_description> a #GtkBorder, or %NULL
+<parameter_description> (allow-none): a #GtkBorder, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_tree_view_column_clear">
+<description>
+Unsets all the mappings on all renderers on the @tree_column.
+
+</description>
+<parameters>
+<parameter name="tree_column">
+<parameter_description> A #GtkTreeViewColumn
</parameter_description>
</parameter>
</parameters>
@@ -28162,7 +28929,7 @@ it if necessary. See gtk_settings_get_for_screen().
</description>
<parameters>
</parameters>
-<return> a #GtkSettings object. If there is no default
+<return> (transfer none): a #GtkSettings object. If there is no default
screen, then returns %NULL.
</return>
</function>
@@ -28715,21 +29482,23 @@ spin button is always updated or only when a valid value is set.
<return></return>
</function>
-<function name="gtk_recent_chooser_get_show_icons">
+<function name="gtk_tool_shell_get_text_orientation">
<description>
-Retrieves whether @chooser should show an icon near the resource.
+Retrieves the current text orientation for the tool shell. Tool items must not
+call this function directly, but rely on gtk_tool_item_get_text_orientation()
+instead.
</description>
<parameters>
-<parameter name="chooser">
-<parameter_description> a #GtkRecentChooser
+<parameter name="shell">
+<parameter_description> a #GtkToolShell
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the icons should be displayed, %FALSE otherwise.
+<return> the current text orientation of @shell
-Since: 2.10
+Since: 2.14
</return>
</function>
@@ -28790,38 +29559,31 @@ Since: 2.4
<function name="_gtk_file_system_model_new">
<description>
-Creates a new #GtkFileSystemModel object. The #GtkFileSystemModel
-object wraps a #GtkFileSystem interface as a #GtkTreeModel.
-Using the @root_file and @max_depth parameters, the tree model
-can be restricted to a subportion of the entire file system.
+Creates a new #GtkFileSystemModel object. You need to add files
+to the list using _gtk_file_system_model_add_and_query_file()
+or _gtk_file_system_model_update_file().
</description>
<parameters>
-<parameter name="file_system">
-<parameter_description> an object implementing #GtkFileSystem
+<parameter name="get_func">
+<parameter_description> function to call for getting a value
</parameter_description>
</parameter>
-<parameter name="root_file">
-<parameter_description> the root file path to show.
+<parameter name="get_data">
+<parameter_description> user data argument passed to @get_func
</parameter_description>
</parameter>
-<parameter name="max_depth">
-<parameter_description> the maximum depth from the children of @root_file
-or the roots of the file system to display in
-the file selector). A depth of 0 displays
-only the immediate children of @root_file,
-or the roots of the filesystem. -1 for no
-maximum depth.
+<parameter name="n_columns">
+<parameter_description> number of columns
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> location to store error, or %NULL.
+<parameter name="Varargs">
+<parameter_description> @n_columns #GType types for the columns
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #GtkFileSystemModel object, or NULL if there
-was an error.
+<return> the newly created #GtkFileSystemModel
</return>
</function>
@@ -28888,7 +29650,7 @@ gtk_icon_theme_get_for_screen().
</description>
<parameters>
</parameters>
-<return> A unique #GtkIconTheme associated with
+<return> (transfer none): A unique #GtkIconTheme associated with
the default screen. This icon theme is associated with
the screen and can be used as long as the screen
is open. Do not ref or unref it.
@@ -28913,7 +29675,7 @@ for @tab_label, then the page will have the label 'page N'.
</parameter_description>
</parameter>
<parameter name="tab_label">
-<parameter_description> the tab label widget to use, or %NULL for default tab
+<parameter_description> (allow-none): the tab label widget to use, or %NULL for default tab
label.
</parameter_description>
</parameter>
@@ -29089,7 +29851,7 @@ display lines vs. paragraphs.
<function name="gtk_window_group_list_windows">
<description>
-Returns: A newly-allocated list of windows inside the group.
+Returns: (element-type GtkWidget) (transfer container): A newly-allocated list of
</description>
<parameters>
@@ -29098,7 +29860,8 @@ Returns: A newly-allocated list of windows inside the group.
</parameter_description>
</parameter>
</parameters>
-<return> A newly-allocated list of windows inside the group.
+<return> (element-type GtkWidget) (transfer container): A newly-allocated list of
+windows inside the group.
Since: 2.14
</return>
@@ -29283,7 +30046,7 @@ increased.
<description>
Sets an application-supplied widget to use to display a custom preview
of the currently selected file. To implement a preview, after setting the
-preview widget, you connect to the ::update-preview
+preview widget, you connect to the #GtkFileChooser::update-preview
signal, and call gtk_file_chooser_get_preview_filename() or
gtk_file_chooser_get_preview_uri() on each change. If you can
display a preview of the new file, update your widget and
@@ -29354,6 +30117,29 @@ be controlled with the @flags field.
</return>
</function>
+<function name="gtk_tool_palette_get_exclusive">
+<description>
+Gets whether @group is exclusive or not.
+See gtk_tool_palette_set_exclusive().
+
+
+</description>
+<parameters>
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
+</parameter_description>
+</parameter>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup which is a child of palette
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @group is exclusive
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_entry_get_buffer">
<description>
Get the #GtkEntryBuffer object which holds the text for
@@ -29479,8 +30265,6 @@ Note that for gtk_window_parse_geometry() to work as expected, it has
to be called when the window has its "final" size, i.e. after calling
gtk_widget_show_all() on the contents and gtk_window_set_geometry_hints()
on the window.
-
-
</description>
<parameters>
<parameter name="window">
@@ -29530,12 +30314,12 @@ the widget to use as the label in the popup menu.
</parameter_description>
</parameter>
<parameter name="tab_label">
-<parameter_description> the #GtkWidget to be used as the label for the page,
+<parameter_description> (allow-none): the #GtkWidget to be used as the label for the page,
or %NULL to use the default label, 'page N'.
</parameter_description>
</parameter>
<parameter name="menu_label">
-<parameter_description> the widget to use as a label for the page-switch
+<parameter_description> (allow-none): the widget to use as a label for the page-switch
menu, if that is enabled. If %NULL, and @tab_label
is a #GtkLabel or %NULL, then the menu label will be
a newly created label with the same text as @tab_label;
@@ -29646,7 +30430,7 @@ See gtk_image_new_from_icon_set() for details.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> (type int): a stock icon size
</parameter_description>
</parameter>
</parameters>
@@ -29831,24 +30615,50 @@ Since: 2.8
<return></return>
</function>
-<function name="gtk_ui_manager_new">
+<function name="gtk_window_begin_resize_drag">
<description>
-Creates a new ui manager object.
+Starts resizing a window. This function is used if an application
+has window resizing controls. When GDK can support it, the resize
+will be done using the standard mechanism for the <link
+linkend="gtk-X11-arch">window manager</link> or windowing
+system. Otherwise, GDK will try to emulate window resizing,
+potentially not all that well, depending on the windowing system.
</description>
<parameters>
+<parameter name="window">
+<parameter_description> a #GtkWindow
+</parameter_description>
+</parameter>
+<parameter name="button">
+<parameter_description> mouse button that initiated the drag
+</parameter_description>
+</parameter>
+<parameter name="edge">
+<parameter_description> position of the resize control
+</parameter_description>
+</parameter>
+<parameter name="root_x">
+<parameter_description> X position where the user clicked to initiate the drag, in root window coordinates
+</parameter_description>
+</parameter>
+<parameter name="root_y">
+<parameter_description> Y position where the user clicked to initiate the drag
+</parameter_description>
+</parameter>
+<parameter name="timestamp">
+<parameter_description> timestamp from the click event that initiated the drag
+</parameter_description>
+</parameter>
</parameters>
-<return> a new ui manager object.
-
-Since: 2.4
-</return>
+<return></return>
</function>
<function name="gtk_about_dialog_set_documenters">
<description>
Sets the strings which are displayed in the documenters tab
-of the secondary credits dialog.
+of the secondary credits dialog.
Since: 2.6
@@ -29859,7 +30669,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="documenters">
-<parameter_description> a %NULL-terminated array of strings
+<parameter_description> a %NULL-terminated array of strings
</parameter_description>
</parameter>
</parameters>
@@ -29893,7 +30703,7 @@ used to be useful before gdk_colormap_get_visual() existed.
</description>
<parameters>
</parameters>
-<return> visual of the default colormap
+<return> (transfer none): visual of the default colormap
</return>
</function>
@@ -29993,6 +30803,24 @@ Creates a new entry.
</return>
</function>
+<function name="gtk_tool_palette_get_style">
+<description>
+Gets the style (icons, text or both) of items in the tool palette.
+
+
+</description>
+<parameters>
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GtkToolbarStyle of items in the tool palette.
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_scale_button_get_popup">
<description>
Retrieves the popup of the #GtkScaleButton.
@@ -30112,6 +30940,25 @@ Since: 2.10
<return></return>
</function>
+<function name="gtk_radio_button_get_group">
+<description>
+Retrieves the group assigned to a radio button.
+
+
+</description>
+<parameters>
+<parameter name="radio_button">
+<parameter_description> a #GtkRadioButton.
+</parameter_description>
+</parameter>
+</parameters>
+<return> (element-type GtkRadioButton) (transfer none): a linked list
+containing all the radio buttons in the same group
+as @radio_button. The returned list is owned by the radio button
+and must not be modified or freed.
+</return>
+</function>
+
<function name="gtk_text_view_get_line_at_y">
<description>
Gets the #GtkTextIter at the start of the line containing
@@ -30142,6 +30989,18 @@ edge of the line.
<return></return>
</function>
+<function name="gtk_toolbar_new">
+<description>
+Creates a new toolbar.
+
+
+</description>
+<parameters>
+</parameters>
+<return> the newly-created toolbar.
+</return>
+</function>
+
<function name="gtk_tree_model_sort_set_model">
<description>
Sets the model of @tree_model_sort to be @model. If @model is %NULL,
@@ -30263,8 +31122,10 @@ Since: 2.6
<function name="gtk_combo_box_set_active_iter">
<description>
-Sets the current active item to be the one referenced by @iter.
- iter must correspond to a path of depth one.
+Sets the current active item to be the one referenced by @iter, or
+unsets the active item if @iter is %NULL.
+
+ iter must correspond to a path of depth one, or be %NULL.
Since: 2.4
@@ -30275,7 +31136,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> The #GtkTreeIter
+<parameter_description> The #GtkTreeIter, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -30327,6 +31188,24 @@ Moves a current child of @layout to a new position.
<return></return>
</function>
+<function name="gtk_tool_item_get_ellipsize_mode">
+<description>
+Return value: a #PangoEllipsizeMode indicating how text in @tool_item
+
+</description>
+<parameters>
+<parameter name="tool_item">
+<parameter_description> a #GtkToolItem
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #PangoEllipsizeMode indicating how text in @tool_item
+should be ellipsized.
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_print_error_quark">
<description>
Registers an error quark for #GtkPrintOperation if necessary.
@@ -30643,6 +31522,28 @@ The @text is used to show how the selected font looks.
<return></return>
</function>
+<function name="gtk_widget_error_bell">
+<description>
+Notifies the user about an input-related error on this widget.
+If the #GtkSettings:gtk-error-bell setting is %TRUE, it calls
+gdk_window_beep(), otherwise it does nothing.
+
+Note that the effect of gdk_window_beep() can be configured in many
+ways, depending on the windowing backend and the desktop environment
+or window manager that is used.
+
+Since: 2.12
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_accel_group_lock">
<description>
Locks the given accelerator group.
@@ -30683,20 +31584,18 @@ show invisible text at all.
</return>
</function>
-<function name="gtk_widget_unparent">
+<function name="gtk_ui_manager_new">
<description>
-This function is only for use in widget implementations.
-Should be called by implementations of the remove method
-on #GtkContainer, to dissociate a child from the container.
+Creates a new ui manager object.
+
</description>
<parameters>
-<parameter name="widget">
-<parameter_description> a #GtkWidget
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> a new ui manager object.
+
+Since: 2.4
+</return>
</function>
<function name="gtk_tree_view_enable_model_drag_dest">
@@ -30971,6 +31870,33 @@ Since: 2.6
<return></return>
</function>
+<function name="gtk_spin_button_configure">
+<description>
+Changes the properties of an existing spin button. The adjustment, climb rate,
+and number of decimal places are all changed accordingly, after this function call.
+
+</description>
+<parameters>
+<parameter name="spin_button">
+<parameter_description> a #GtkSpinButton
+</parameter_description>
+</parameter>
+<parameter name="adjustment">
+<parameter_description> (allow-none): a #GtkAdjustment.
+</parameter_description>
+</parameter>
+<parameter name="climb_rate">
+<parameter_description> the new climb rate.
+</parameter_description>
+</parameter>
+<parameter name="digits">
+<parameter_description> the number of decimal places to display in the spin button.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_text_view_scroll_to_iter">
<description>
Scrolls @text_view so that @iter is on the screen in the position
@@ -31037,7 +31963,7 @@ be clamped to the range 0-65536.
</parameters>
<return> a new #GtkEntry
-Deprecated: Use gtk_entry_set_max_length() instead.
+Deprecated: 2.0: Use gtk_entry_set_max_length() instead.
</return>
</function>
@@ -31081,7 +32007,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="pixbuf">
-<parameter_description> the new header image @page
+<parameter_description> (allow-none): the new header image @page
</parameter_description>
</parameter>
</parameters>
@@ -31270,7 +32196,8 @@ array must be freed with g_free().
</parameter_description>
</parameter>
<parameter name="sizes">
-<parameter_description> return location for array of sizes
+<parameter_description> (array length=n_sizes) (out) (type int): return location
+for array of sizes
</parameter_description>
</parameter>
<parameter name="n_sizes">
@@ -31313,7 +32240,7 @@ Return value: whether we found a tag toggle before @iter
</parameter_description>
</parameter>
<parameter name="tag">
-<parameter_description> a #GtkTextTag, or %NULL
+<parameter_description> (allow-none): a #GtkTextTag, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -31365,11 +32292,11 @@ path will be modified to reflect this change.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> The path of the row to move to, or %NULL.
+<parameter_description> (allow-none): The path of the row to move to, or %NULL.
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> The #GtkTreeViewColumn to move horizontally to, or %NULL.
+<parameter_description> (allow-none): The #GtkTreeViewColumn to move horizontally to, or %NULL.
</parameter_description>
</parameter>
<parameter name="use_align">
@@ -31484,22 +32411,13 @@ Since: 2.10
</return>
</function>
-<function name="gtk_combo_box_set_row_span_column">
+<function name="gtk_pixmap_new">
<description>
-Sets the column with row span information for @combo_box to be @row_span.
-The row span column contains integers which indicate how many rows
-an item should span.
-
-Since: 2.4
</description>
<parameters>
-<parameter name="combo_box">
-<parameter_description> A #GtkComboBox.
-</parameter_description>
-</parameter>
-<parameter name="row_span">
-<parameter_description> A column in the model passed during construction.
+<parameter name="mask">
+<parameter_description> (allow-none):
</parameter_description>
</parameter>
</parameters>
@@ -31700,7 +32618,7 @@ or %NULL if the mark is deleted.
</parameter_description>
</parameter>
</parameters>
-<return> the mark's #GtkTextBuffer
+<return> (transfer none): the mark's #GtkTextBuffer
</return>
</function>
@@ -32012,11 +32930,11 @@ this function.
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> return location for width, or %NULL
+<parameter_description> (out): return location for width, or %NULL
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> return location for height, or %NULL
+<parameter_description> (out): return location for height, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -32073,7 +32991,7 @@ will be updated appropriately.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> (type int): a stock icon size
</parameter_description>
</parameter>
</parameters>
@@ -32292,7 +33210,7 @@ Since: 2.12
<function name="gtk_notebook_get_nth_page">
<description>
-Return value: the child widget, or %NULL if @page_num is
+Return value: (transfer none): the child widget, or %NULL if @page_num is
</description>
<parameters>
@@ -32306,7 +33224,7 @@ to get the last page.
</parameter_description>
</parameter>
</parameters>
-<return> the child widget, or %NULL if @page_num is
+<return> (transfer none): the child widget, or %NULL if @page_num is
out of bounds.
</return>
</function>
@@ -32330,17 +33248,17 @@ in the buffer may override the default.
<function name="gtk_file_chooser_set_do_overwrite_confirmation">
<description>
-Sets whether a file chooser in GTK_FILE_CHOOSER_ACTION_SAVE mode will present
+Sets whether a file chooser in %GTK_FILE_CHOOSER_ACTION_SAVE mode will present
a confirmation dialog if the user types a file name that already exists. This
is %FALSE by default.
-Regardless of this setting, the @chooser will emit the "confirm-overwrite"
-signal when appropriate.
+Regardless of this setting, the @chooser will emit the
+#GtkFileChooser::confirm-overwrite signal when appropriate.
If all you need is the stock confirmation dialog, set this property to %TRUE.
You can override the way confirmation is done by actually handling the
-"confirm-overwrite" signal; please refer to its documentation for the
-details.
+#GtkFileChooser::confirm-overwrite signal; please refer to its documentation
+for the details.
Since: 2.8
@@ -32467,7 +33385,7 @@ and the function will return without failing.
</parameter_description>
</parameter>
<parameter name="focus_column">
-<parameter_description> A #GtkTreeViewColumn, or %NULL
+<parameter_description> (allow-none): A #GtkTreeViewColumn, or %NULL
</parameter_description>
</parameter>
<parameter name="start_editing">
@@ -32586,11 +33504,11 @@ toplevel.
</parameter_description>
</parameter>
<parameter name="dest_x">
-<parameter_description> location to store X position relative to @dest_widget
+<parameter_description> (out): location to store X position relative to @dest_widget
</parameter_description>
</parameter>
<parameter name="dest_y">
-<parameter_description> location to store Y position relative to @dest_widget
+<parameter_description> (out): location to store Y position relative to @dest_widget
</parameter_description>
</parameter>
</parameters>
@@ -32621,7 +33539,7 @@ the function is very fast.
<description>
Sets @filename as the current filename for the file chooser, by changing
to the file's parent folder and actually selecting the file in list. If
-the @chooser is in #GTK_FILE_CHOOSER_ACTION_SAVE mode, the file's base name
+the @chooser is in %GTK_FILE_CHOOSER_ACTION_SAVE mode, the file's base name
will also appear in the dialog's file name entry.
If the file name isn't in the current folder of @chooser, then the current
@@ -32637,9 +33555,7 @@ you should use this function if you already have a file name to which the
user may save; for example, when the user opens an existing file and then
does <guimenuitem>File/Save As...</guimenuitem> on it. If you don't have
a file name already — for example, if the user just created a new
-file and is saving it for the first time, do not call this function.
-
-
+file and is saving it for the first time, do not call this function.
</description>
<parameters>
<parameter name="chooser">
@@ -32739,6 +33655,23 @@ Since: 2.14
</return>
</function>
+<function name="gtk_action_get_always_show_image">
+<description>
+Returns: %TRUE if the menu item proxies will always show their image
+
+</description>
+<parameters>
+<parameter name="action">
+<parameter_description> a #GtkAction
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the menu item proxies will always show their image
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_icon_source_get_filename">
<description>
Retrieves the source filename, or %NULL if none is set. The
@@ -32902,7 +33835,7 @@ gtk_combo_box_remove_text().
</description>
<parameters>
</parameters>
-<return> A new text combo box.
+<return> (transfer none): A new text combo box.
Since: 2.4
</return>
@@ -33036,7 +33969,7 @@ gtk_widget_modify_style().
</parameter_description>
</parameter>
<parameter name="style">
-<parameter_description> a #GtkStyle, or %NULL to remove the effect of a previous
+<parameter_description> (allow-none): a #GtkStyle, or %NULL to remove the effect of a previous
gtk_widget_set_style() and go back to the default style
</parameter_description>
</parameter>
@@ -33053,7 +33986,7 @@ To do this, you can use gtk_tree_row_reference_new().
To free the return value, use:
|[
-g_list_foreach (list, gtk_tree_path_free, NULL);
+g_list_foreach (list, (GFunc) gtk_tree_path_free, NULL);
g_list_free (list);
]|
@@ -33065,11 +33998,11 @@ g_list_free (list);
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> A pointer to set to the #GtkTreeModel, or NULL.
+<parameter_description> (allow-none): A pointer to set to the #GtkTreeModel, or NULL.
</parameter_description>
</parameter>
</parameters>
-<return> A #GList containing a #GtkTreePath for each selected row.
+<return> (element-type GtkTreePath) (transfer full): A #GList containing a #GtkTreePath for each selected row.
Since: 2.2
</return>
@@ -33151,6 +34084,8 @@ Look up a named tag.
Removes an accelerator previously installed through
gtk_accel_group_connect().
+Since 2.20 @closure can be %NULL.
+
</description>
<parameters>
<parameter name="accel_group">
@@ -33158,7 +34093,8 @@ gtk_accel_group_connect().
</parameter_description>
</parameter>
<parameter name="closure">
-<parameter_description> the closure to remove from this accelerator group
+<parameter_description> the closure to remove from this accelerator group, or %NULL
+to remove all closures
</parameter_description>
</parameter>
</parameters>
@@ -33240,7 +34176,7 @@ See gtk_file_chooser_set_current_folder().
Note that this is the folder that the file chooser is currently displaying
(e.g. "/home/username/Documents"), which is <emphasis>not the same</emphasis>
as the currently-selected folder if the chooser is in
-#GTK_FILE_CHOOSER_SELECT_FOLDER mode
+%GTK_FILE_CHOOSER_SELECT_FOLDER mode
(e.g. "/home/username/Documents/selected-folder/". To get the
currently-selected folder in that mode, use gtk_file_chooser_get_uri() as the
usual way to get the selection.
@@ -33655,7 +34591,7 @@ you should use gtk_image_new_from_icon_set().
</description>
<parameters>
<parameter name="pixbuf">
-<parameter_description> a #GdkPixbuf, or %NULL
+<parameter_description> (allow-none): a #GdkPixbuf, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -33702,7 +34638,7 @@ See gtk_notebook_set_show_tabs().
<function name="gtk_tool_item_retrieve_proxy_menu_item">
<description>
-Return value: The #GtkMenuItem that is going to appear in the
+Return value: (transfer none): The #GtkMenuItem that is going to appear in the
</description>
<parameters>
@@ -33711,13 +34647,36 @@ Return value: The #GtkMenuItem that is going to appear in the
</parameter_description>
</parameter>
</parameters>
-<return> The #GtkMenuItem that is going to appear in the
+<return> (transfer none): The #GtkMenuItem that is going to appear in the
overflow menu for @tool_item.
Since: 2.4
</return>
</function>
+<function name="add_file">
+<description>
+Adds the given @file with its associated @info to the @model.
+If the model is frozen, the file will only show up after it is thawn.
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> the model
+</parameter_description>
+</parameter>
+<parameter name="file">
+<parameter_description> the file to add
+</parameter_description>
+</parameter>
+<parameter name="info">
+<parameter_description> the information to associate with the file
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_ruler_get_range">
<description>
Retrieves values indicating the range and current position of a #GtkRuler.
@@ -33806,7 +34765,7 @@ gtk_text_iter_ends_tag ()), i.e. it tells you whether a range with
</parameter_description>
</parameter>
<parameter name="tag">
-<parameter_description> a #GtkTextTag, or %NULL
+<parameter_description> (allow-none): a #GtkTextTag, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -33853,27 +34812,24 @@ Since: 2.18
</return>
</function>
-<function name="gtk_action_group_get_name">
+<function name="_gtk_file_system_model_thaw_updates">
<description>
-Gets the name of the action group.
-
+Undoes the effect of a previous call to
+_gtk_file_system_model_freeze_updates()
</description>
<parameters>
-<parameter name="action_group">
-<parameter_description> the action group
+<parameter name="model">
+<parameter_description> a #GtkFileSystemModel
</parameter_description>
</parameter>
</parameters>
-<return> the name of the action group.
-
-Since: 2.4
-</return>
+<return></return>
</function>
<function name="gtk_radio_action_get_group">
<description>
-Returns: the list representing the radio group for this object
+Returns: (element-type GtkAction) (transfer none): the list representing the radio group for this object
</description>
<parameters>
@@ -33882,7 +34838,7 @@ Returns: the list representing the radio group for this object
</parameter_description>
</parameter>
</parameters>
-<return> the list representing the radio group for this object
+<return> (element-type GtkAction) (transfer none): the list representing the radio group for this object
Since: 2.4
</return>
@@ -34170,6 +35126,46 @@ Since: 2.10
</return>
</function>
+<function name="gtk_tool_item_group_get_header_relief">
+<description>
+Gets the relief mode of the header button of @group.
+
+
+</description>
+<parameters>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GtkReliefStyle
+
+Since: 2.20
+</return>
+</function>
+
+<function name="gtk_tool_item_group_get_nth_item">
+<description>
+Gets the tool item at @index in group.
+
+
+</description>
+<parameters>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup
+</parameter_description>
+</parameter>
+<parameter name="index">
+<parameter_description> the index
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GtkToolItem at index
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_im_context_simple_add_table">
<description>
Adds an additional table to search to the input context.
@@ -35118,7 +36114,7 @@ placement.
</parameter_description>
</parameter>
<parameter name="mark_name">
-<parameter_description> name for mark, or %NULL
+<parameter_description> (allow-none): name for mark, or %NULL
</parameter_description>
</parameter>
<parameter name="where">
@@ -35312,7 +36308,7 @@ will not "adopt" it.
</parameter_description>
</parameter>
<parameter name="buffer">
-<parameter_description> a #GtkTextBuffer
+<parameter_description> (allow-none): a #GtkTextBuffer
</parameter_description>
</parameter>
</parameters>
@@ -36090,7 +37086,7 @@ Return value: A %NULL-terminated string array containing
</parameter>
</parameters>
<return> A %NULL-terminated string array containing
-the documenters. The array is owned by the about dialog
+the documenters. The array is owned by the about dialog
and must not be modified.
Since: 2.6
@@ -36099,7 +37095,9 @@ Since: 2.6
<function name="gtk_print_settings_to_file">
<description>
-This function saves the print settings from @settings to @file_name.
+This function saves the print settings from @settings to @file_name. If the
+file could not be loaded then error is set to either a #GFileError or
+#GKeyFileError.
</description>
@@ -36163,7 +37161,7 @@ Since: 2.14
<function name="gtk_widget_get_accessible">
<description>
-Returns: the #AtkObject associated with @widget
+Returns: (transfer none): the #AtkObject associated with @widget
</description>
<parameters>
@@ -36172,7 +37170,7 @@ Returns: the #AtkObject associated with @widget
</parameter_description>
</parameter>
</parameters>
-<return> the #AtkObject associated with @widget
+<return> (transfer none): the #AtkObject associated with @widget
</return>
</function>
@@ -36310,13 +37308,32 @@ will return @target.
</parameter_description>
</parameter>
<parameter name="target">
-<parameter_description> an existing icon size
+<parameter_description> (type int): an existing icon size
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="gtk_tool_palette_get_icon_size">
+<description>
+Gets the size of icons in the tool palette.
+See gtk_tool_palette_set_icon_size().
+
+
+</description>
+<parameters>
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
+</parameter_description>
+</parameter>
+</parameters>
+<return> (type int): the #GtkIconSize of icons in the tool palette
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_progress_bar_get_orientation">
<description>
Retrieves the current progress bar orientation.
@@ -36375,7 +37392,7 @@ Recursively hides a widget and any child widgets.
<function name="gtk_show_about_dialog">
<description>
This is a convenience function for showing an application's about box.
-The constructed dialog is associated with the parent window and
+The constructed dialog is associated with the parent window and
reused for future invocations of this function.
Since: 2.6
@@ -36387,7 +37404,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="first_property_name">
-<parameter_description> the name of the first property
+<parameter_description> the name of the first property
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -36436,7 +37453,7 @@ indices in the layout to byte indices in the entry contents.
</parameter_description>
</parameter>
</parameters>
-<return> the #PangoLayout for this entry
+<return> (transfer none): the #PangoLayout for this entry
</return>
</function>
@@ -36567,7 +37584,7 @@ gtk_widget_add_accelerator().
<function name="gtk_notebook_set_menu_label">
<description>
-Changes the menu label for the page containing @child.
+Changes the menu label for the page containing @child.
</description>
<parameters>
@@ -36580,7 +37597,7 @@ Changes the menu label for the page containing @child.
</parameter_description>
</parameter>
<parameter name="menu_label">
-<parameter_description> the menu label, or NULL for default
+<parameter_description> (allow-none): the menu label, or NULL for default
</parameter_description>
</parameter>
</parameters>
@@ -36677,6 +37694,7 @@ _gtk_file_chooser_delegate_iface_init().
<description>
Looks up the icon size associated with @name.
+
</description>
<parameters>
<parameter name="name">
@@ -36685,6 +37703,7 @@ Looks up the icon size associated with @name.
</parameter>
</parameters>
<return> the icon size with the given name.
+ (type int): the icon size
</return>
</function>
@@ -36817,7 +37836,7 @@ for all windows in your application in one go.
</parameter_description>
</parameter>
<parameter name="icon">
-<parameter_description> icon image, or %NULL
+<parameter_description> (allow-none): icon image, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -36827,9 +37846,7 @@ for all windows in your application in one go.
<function name="_gtk_file_system_model_get_info">
<description>
Gets the #GFileInfo structure for a particular row
-of @model. The information included in this structure
-is determined by the @types parameter to
-_gtk_file_system_model_new().
+of @model.
</description>
@@ -36845,8 +37862,8 @@ _gtk_file_system_model_new().
</parameters>
<return> a #GFileInfo structure. This structure
is owned by @model and must not be modified or freed.
-If you want to save the information for later use,
-you must make a copy, since the structure may be
+If you want to keep the information for later use,
+you must take a reference, since the structure may be
freed on later changes to the file system. If you have
called _gtk_file_system_model_add_editable() and the @iter
corresponds to the row that this function returned, the
@@ -36892,7 +37909,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath or %NULL to unset.
+<parameter_description> (allow-none): a #GtkTreePath or %NULL to unset.
</parameter_description>
</parameter>
</parameters>
@@ -36927,7 +37944,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="accel_group">
-<parameter_description> a #GtkAccelGroup or %NULL
+<parameter_description> (allow-none): a #GtkAccelGroup or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -37068,7 +38085,7 @@ Moves the @path to point to its parent node, if it has a parent.
<function name="gtk_text_iter_get_marks">
<description>
-Return value: list of #GtkTextMark
+Return value: (element-type GtkTextMark) (transfer container): list of #GtkTextMark
</description>
<parameters>
@@ -37077,7 +38094,7 @@ Return value: list of #GtkTextMark
</parameter_description>
</parameter>
</parameters>
-<return> list of #GtkTextMark
+<return> (element-type GtkTextMark) (transfer container): list of #GtkTextMark
</return>
</function>
@@ -37231,7 +38248,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="version">
-<parameter_description> the version string
+<parameter_description> (allow-none): the version string
</parameter_description>
</parameter>
</parameters>
@@ -37310,16 +38327,16 @@ graphics context of @style
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="x">
@@ -37439,7 +38456,8 @@ returned animation.
</parameter_description>
</parameter>
</parameters>
-<return> the displayed animation, or %NULL if the image is empty
+<return> (transfer none): the displayed animation, or %NULL if
+the image is empty
</return>
</function>
@@ -37465,8 +38483,8 @@ Since: 2.10
<function name="gtk_editable_insert_text">
<description>
-Inserts @new_text_length bytes of @new_text into the contents of the
-widget, at position @position.
+Inserts @new_text_length bytes of @new_text into the contents of the
+widget, at position @position.
Note that the position is in characters, not in bytes.
The function updates @position to point after the newly inserted text.
@@ -37486,7 +38504,7 @@ The function updates @position to point after the newly inserted text.
</parameter_description>
</parameter>
<parameter name="position">
-<parameter_description> location of the position text will be inserted at
+<parameter_description> (in-out): location of the position text will be inserted at
</parameter_description>
</parameter>
</parameters>
@@ -37579,7 +38597,7 @@ Return value: a newly allocated #GtkPageSetup with default page size of the prin
</parameters>
<return> a newly allocated #GtkPageSetup with default page size of the printer.
-Since: 2.13
+Since: 2.14
</return>
</function>
@@ -37598,23 +38616,44 @@ Since: 2.4
</description>
<parameters>
<parameter name="action_group">
-<parameter_description> the action group
+<parameter_description> the action group
</parameter_description>
</parameter>
<parameter name="action">
-<parameter_description> the action to add
+<parameter_description> the action to add
</parameter_description>
</parameter>
<parameter name="accelerator">
-<parameter_description> the accelerator for the action, in
-the format understood by gtk_accelerator_parse(), or "" for no accelerator, or
-%NULL to use the stock accelerator
+<parameter_description> (allow-none): the accelerator for the action, in
+the format understood by gtk_accelerator_parse(), or "" for no accelerator, or
+%NULL to use the stock accelerator
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="gtk_page_setup_get_page_height">
+<description>
+Return value: the page height.
+
+</description>
+<parameters>
+<parameter name="setup">
+<parameter_description> a #GtkPageSetup
+</parameter_description>
+</parameter>
+<parameter name="unit">
+<parameter_description> the unit for the return value
+</parameter_description>
+</parameter>
+</parameters>
+<return> the page height.
+
+Since: 2.10
+</return>
+</function>
+
<function name="gtk_progress_bar_set_ellipsize">
<description>
Sets the mode used to ellipsize (add an ellipsis: "...") the text
@@ -37727,11 +38766,11 @@ Non-vararg creation function. Used primarily by language bindings.
</parameter_description>
</parameter>
<parameter name="types">
-<parameter_description> an array of #GType types for the columns, from first to last
+<parameter_description> (array length=n_columns): an array of #GType types for the columns, from first to last
</parameter_description>
</parameter>
</parameters>
-<return> a new #GtkListStore
+<return> (transfer none): a new #GtkListStore
</return>
</function>
@@ -38181,6 +39220,9 @@ gtk_tree_view_column_set_attributes().
Query the packing attributes for the tab label of the page
containing @child.
+Deprecated: 2.20: Modify the #GtkNotebook:tab-expand and
+#GtkNotebook:tab-fill child properties instead.
+
</description>
<parameters>
<parameter name="notebook">
@@ -38300,11 +39342,13 @@ be freed.
</parameter_description>
</parameter>
<parameter name="stock_id">
-<parameter_description> place to store a stock icon name, or %NULL
+<parameter_description> (out) (transfer none) (allow-none): place to store a
+stock icon name, or %NULL
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> place to store a stock icon size, or %NULL
+<parameter_description> (out) (allow-none) (type int): place to store a stock icon
+size, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -38348,15 +39392,15 @@ Same as gtk_text_iter_forward_search(), but moves backward.
</parameter_description>
</parameter>
<parameter name="match_start">
-<parameter_description> return location for start of match, or %NULL
+<parameter_description> (allow-none): return location for start of match, or %NULL
</parameter_description>
</parameter>
<parameter name="match_end">
-<parameter_description> return location for end of match, or %NULL
+<parameter_description> (allow-none): return location for end of match, or %NULL
</parameter_description>
</parameter>
<parameter name="limit">
-<parameter_description> location of last possible @match_start, or %NULL for start of buffer
+<parameter_description> (allow-none): location of last possible @match_start, or %NULL for start of buffer
</parameter_description>
</parameter>
</parameters>
@@ -38453,7 +39497,7 @@ The returned list should be freed with g_list_free().
</parameter_description>
</parameter>
</parameters>
-<return> list of widgets anchored at @anchor
+<return> (element-type GtkWidget) (transfer container): list of widgets anchored at @anchor
</return>
</function>
@@ -38636,18 +39680,16 @@ Since: 2.16
</return>
</function>
-<function name="gtk_entry_unset_invisible_char">
+<function name="_gtk_file_system_model_remove_editable">
<description>
-Unsets the invisible char previously set with
-gtk_entry_set_invisible_char(). So that the
-default invisible char is used again.
-
-Since: 2.16
+Removes the "empty" row at the beginning of the model that was
+created with _gtk_file_system_model_add_editable(). You should call
+this function when your code is finished editing this temporary row.
</description>
<parameters>
-<parameter name="entry">
-<parameter_description> a #GtkEntry
+<parameter name="model">
+<parameter_description> a #GtkFileSystemModel
</parameter_description>
</parameter>
</parameters>
@@ -38831,6 +39873,27 @@ Since: 2.6
<return></return>
</function>
+<function name="gtk_tool_item_group_header_relief">
+<description>
+Set the button relief of the group header.
+See gtk_button_set_relief() for details.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup
+</parameter_description>
+</parameter>
+<parameter name="style">
+<parameter_description> the #GtkReliefStyle
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_range_set_show_fill_level">
<description>
Sets whether a graphical fill level is show on the trough. See
@@ -39035,7 +40098,7 @@ Since: 2.4
<function name="GtkCellRenderer">
<description>
This signal gets emitted when a cell starts to be edited.
-The indended use of this signal is to do special setup
+The intended use of this signal is to do special setup
on @editable, e.g. adding a #GtkEntryCompletion or setting
up additional columns in a #GtkComboBox.
@@ -39128,7 +40191,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> The #GtkTreeModel.
+<parameter_description> (allow-none): The #GtkTreeModel.
</parameter_description>
</parameter>
</parameters>
@@ -39163,6 +40226,8 @@ See gtk_fixed_set_has_window().
</parameter>
</parameters>
<return> %TRUE if @fixed has its own window.
+
+Deprecated: 2.20: Use gtk_widget_get_has_window() instead.
</return>
</function>
@@ -39240,7 +40305,7 @@ header button is set with a #GtkLabel set to the title of @tree_column.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> A child #GtkWidget, or %NULL.
+<parameter_description> (allow-none): A child #GtkWidget, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -39486,24 +40551,23 @@ Since: 2.14
</return>
</function>
-<function name="gtk_menu_bar_set_child_pack_direction">
+<function name="gtk_widget_has_rc_style">
<description>
-Sets how widgets should be packed inside the children of a menubar.
+Determines if the widget style has been looked up through the rc mechanism.
-Since: 2.8
</description>
<parameters>
-<parameter name="menubar">
-<parameter_description> a #GtkMenuBar
-</parameter_description>
-</parameter>
-<parameter name="child_pack_dir">
-<parameter_description> a new #GtkPackDirection
+<parameter name="widget">
+<parameter_description> a #GtkWidget
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the widget has been looked up through the rc
+mechanism, %FALSE otherwise.
+
+Since: 2.20
+</return>
</function>
<function name="gtk_icon_view_convert_widget_to_bin_window_coords">
@@ -39563,16 +40627,16 @@ the given parameters.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="x">
@@ -39614,7 +40678,7 @@ gtk_widget_modify_style().
</parameter_description>
</parameter>
<parameter name="color">
-<parameter_description> the color to assign (does not need to be allocated),
+<parameter_description> (allow-none): the color to assign (does not need to be allocated),
or %NULL to undo the effect of previous calls to
of gtk_widget_modify_text().
</parameter_description>
@@ -39949,16 +41013,16 @@ parameters.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="x">
@@ -40041,7 +41105,7 @@ Sets the horizontal adjustment of the viewport.
</parameter_description>
</parameter>
<parameter name="adjustment">
-<parameter_description> a #GtkAdjustment.
+<parameter_description> (allow-none): a #GtkAdjustment.
</parameter_description>
</parameter>
</parameters>
@@ -40098,6 +41162,30 @@ Since: 2.12
<return></return>
</function>
+<function name="_gtk_file_system_model_iter_is_visible">
+<description>
+Checks if the iterator is visible. A visible iterator references
+a row that is currently exposed using the #GtkTreeModel API. If
+the iterator is invisible, it references a file that is not shown
+for some reason, such as being filtered by the current filter or
+being a hidden file.
+
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> the model
+</parameter_description>
+</parameter>
+<parameter name="iter">
+<parameter_description> a valid iterator
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the iterator is visible
+</return>
+</function>
+
<function name="gtk_tree_view_column_set_sort_order">
<description>
Changes the appearance of the sort indicator.
@@ -40149,6 +41237,33 @@ Since: 2.10
</return>
</function>
+<function name="gtk_status_icon_set_tooltip_markup">
+<description>
+Sets @markup as the contents of the tooltip, which is marked up with
+the <link linkend="PangoMarkupFormat">Pango text markup language</link>.
+
+This function will take care of setting #GtkStatusIcon:has-tooltip to %TRUE
+and of the default handler for the #GtkStatusIcon::query-tooltip signal.
+
+See also the #GtkStatusIcon:tooltip-markup property and
+gtk_tooltip_set_markup().
+
+Since: 2.16
+
+</description>
+<parameters>
+<parameter name="status_icon">
+<parameter_description> a #GtkStatusIcon
+</parameter_description>
+</parameter>
+<parameter name="markup">
+<parameter_description> the contents of the tooltip for @status_icon, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_print_operation_set_has_selection">
<description>
Sets whether there is a selection to print.
@@ -40191,21 +41306,25 @@ Since: 2.16
</return>
</function>
-<function name="gtk_toolbar_new">
+<function name="gtk_widget_unparent">
<description>
-Creates a new toolbar.
-
+This function is only for use in widget implementations.
+Should be called by implementations of the remove method
+on #GtkContainer, to dissociate a child from the container.
</description>
<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
</parameters>
-<return> the newly-created toolbar.
-</return>
+<return></return>
</function>
<function name="gtk_text_iter_get_toggled_tags">
<description>
-Return value: tags toggled at this point
+Return value: (element-type GtkTextTag) (transfer container): tags toggled at this point
</description>
<parameters>
@@ -40218,7 +41337,7 @@ Return value: tags toggled at this point
</parameter_description>
</parameter>
</parameters>
-<return> tags toggled at this point
+<return> (element-type GtkTextTag) (transfer container): tags toggled at this point
</return>
</function>
@@ -40240,6 +41359,28 @@ Since: 2.4
</return>
</function>
+<function name="gtk_tool_item_group_set_label_widget">
+<description>
+Sets the label of the tool item group.
+The label widget is displayed in the header of the group, in place
+of the usual label.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup
+</parameter_description>
+</parameter>
+<parameter name="label_widget">
+<parameter_description> the widget to be displayed in place of the usual label
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_editable_get_position">
<description>
Retrieves the current position of the cursor relative to the start
@@ -40373,7 +41514,7 @@ The function is used for all stock items whose
to use strings different from the actual gettext translation domain
of your application for this, as long as your #GtkTranslateFunc uses
the correct domain when calling dgettext(). This can be useful, e.g.
-when dealing with message contexts. file and is saving it for the first time, do not call this function.
+when dealing with message contexts.
Since: 2.8
@@ -40462,7 +41603,7 @@ Since: 2.10
<function name="gtk_container_get_children">
<description>
-Return value: a newly-allocated list of the container's non-internal children.
+Return value: (element-type GtkWidget) (transfer container): a newly-allocated list of the container's non-internal children.
</description>
<parameters>
@@ -40471,7 +41612,7 @@ Return value: a newly-allocated list of the container's non-internal children.
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated list of the container's non-internal children.
+<return> (element-type GtkWidget) (transfer container): a newly-allocated list of the container's non-internal children.
</return>
</function>
@@ -40593,6 +41734,9 @@ Sets the packing parameters for the tab label of the page
containing @child. See gtk_box_pack_start() for the exact meaning
of the parameters.
+Deprecated: 2.20: Modify the #GtkNotebook:tab-expand and
+#GtkNotebook:tab-fill child properties instead.
+
</description>
<parameters>
<parameter name="notebook">
@@ -40622,7 +41766,7 @@ of the parameters.
<function name="gtk_drag_source_set_icon">
<description>
Sets the icon that will be used for drags from a particular widget
-from a pixmap/mask. GTK+ retains references for the arguments, and
+from a pixmap/mask. GTK+ retains references for the arguments, and
will release them when they are no longer needed.
Use gtk_drag_source_set_icon_pixbuf() instead.
@@ -40641,7 +41785,7 @@ Use gtk_drag_source_set_icon_pixbuf() instead.
</parameter_description>
</parameter>
<parameter name="mask">
-<parameter_description> the transparency mask for an image.
+<parameter_description> (allow-none): the transparency mask for an image.
</parameter_description>
</parameter>
</parameters>
@@ -40822,7 +41966,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="shape_mask">
-<parameter_description> shape to be added, or %NULL to remove an existing shape
+<parameter_description> (allow-none): shape to be added, or %NULL to remove an existing shape
</parameter_description>
</parameter>
<parameter name="offset_x">
@@ -40975,9 +42119,8 @@ Since: 2.18
<function name="_gtk_file_system_model_set_filter">
<description>
-Sets a callback called for each file/directory to see whether
-it should be included in model. If this function was made
-public, we'd want to include a GDestroyNotify as well.
+Sets a filter to be used for deciding if a row should be visible or not.
+Directories are always visible.
</description>
<parameters>
@@ -40986,11 +42129,7 @@ public, we'd want to include a GDestroyNotify as well.
</parameter_description>
</parameter>
<parameter name="filter">
-<parameter_description> function to be called for each file
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> data to pass to @filter
+<parameter_description> %NULL or filter to use
</parameter_description>
</parameter>
</parameters>
@@ -41163,6 +42302,31 @@ Since: 2.4
</return>
</function>
+<function name="gtk_tool_item_group_insert">
+<description>
+Inserts @item at @position in the list of children of @group.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup
+</parameter_description>
+</parameter>
+<parameter name="item">
+<parameter_description> the #GtkToolItem to insert into @group
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> the position of @item in @group, starting with 0.
+The position -1 means end of list.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_status_icon_new">
<description>
Creates an empty status icon object.
@@ -41216,19 +42380,54 @@ or should all have the same requisition in both directions
<return></return>
</function>
-<function name="gtk_widget_get_events">
+<function name="gtk_text_buffer_begin_user_action">
<description>
-Return value: event mask for @widget
+Called to indicate that the buffer operations between here and a
+call to gtk_text_buffer_end_user_action() are part of a single
+user-visible operation. The operations between
+gtk_text_buffer_begin_user_action() and
+gtk_text_buffer_end_user_action() can then be grouped when creating
+an undo stack. #GtkTextBuffer maintains a count of calls to
+gtk_text_buffer_begin_user_action() that have not been closed with
+a call to gtk_text_buffer_end_user_action(), and emits the
+"begin-user-action" and "end-user-action" signals only for the
+outermost pair of calls. This allows you to build user actions
+from other user actions.
+
+The "interactive" buffer mutation functions, such as
+gtk_text_buffer_insert_interactive(), automatically call begin/end
+user action around the buffer operations they perform, so there's
+no need to add extra calls if you user action consists solely of a
+single call to one of those functions.
</description>
<parameters>
-<parameter name="widget">
-<parameter_description> a #GtkWidget
+<parameter name="buffer">
+<parameter_description> a #GtkTextBuffer
</parameter_description>
</parameter>
</parameters>
-<return> event mask for @widget
-</return>
+<return></return>
+</function>
+
+<function name="gtk_tool_item_group_set_ellipsize">
+<description>
+Sets the ellipsization mode which should be used by labels in @group.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup
+</parameter_description>
+</parameter>
+<parameter name="ellipsize">
+<parameter_description> the #PangoEllipsizeMode labels in @group should use
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
<function name="gtk_printer_accepts_ps">
@@ -41366,7 +42565,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="completion">
-<parameter_description> The #GtkEntryCompletion or %NULL
+<parameter_description> (allow-none): The #GtkEntryCompletion or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -41596,7 +42795,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> the function to call
+<parameter_description> (scope call) the function to call
</parameter_description>
</parameter>
<parameter name="user_data">
@@ -41654,8 +42853,8 @@ Since: 2.10
<function name="gtk_style_render_icon">
<description>
-Renders the icon specified by @source at the given @size
-according to the given parameters and returns the result in a
+Renders the icon specified by @source at the given @size
+according to the given parameters and returns the result in a
pixbuf.
</description>
@@ -41677,16 +42876,17 @@ pixbuf.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> the size to render the icon at. A size of (GtkIconSize)-1
-means render at the size of the source and don't scale.
+<parameter_description> (type int) the size to render the icon at. A size of
+(GtkIconSize)-1 means render at the size of the source and
+don't scale.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
</parameters>
@@ -41931,11 +43131,11 @@ handle the details for you.
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> return location for width, or %NULL
+<parameter_description> (out): return location for width, or %NULL
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> return location for height, or %NULL
+<parameter_description> (out): return location for height, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -42111,32 +43311,24 @@ Since: 2.10
<return></return>
</function>
-<function name="_gtk_file_chooser_remove_shortcut_folder">
+<function name="gtk_drag_dest_set_target_list">
<description>
-Removes a folder from the shortcut folders in a file chooser. Internal
-function, see gtk_file_chooser_remove_shortcut_folder().
-
+Sets the target types that this widget can accept from drag-and-drop.
+The widget must first be made into a drag destination with
+gtk_drag_dest_set().
</description>
<parameters>
-<parameter name="chooser">
-<parameter_description> a #GtkFileChooser
-</parameter_description>
-</parameter>
-<parameter name="file">
-<parameter_description> file for the folder to remove
+<parameter name="widget">
+<parameter_description> a #GtkWidget that's a drag destination
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> location to store error, or %NULL
+<parameter name="target_list">
+<parameter_description> list of droppable targets, or %NULL for none
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the folder could be removed successfully, %FALSE
-otherwise.
-
-Since: 2.4
-</return>
+<return></return>
</function>
<function name="gtk_widget_get_no_show_all">
@@ -42184,6 +43376,24 @@ re-initialized to point to the location where text was deleted.
<return></return>
</function>
+<function name="gtk_window_get_window_type">
+<description>
+Gets the type of the window. See #GtkWindowType.
+
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GtkWindow
+</parameter_description>
+</parameter>
+</parameters>
+<return> the type of the window
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_tree_model_get_iter_first">
<description>
Initializes @iter with the first iterator in the tree (the one at the path
@@ -42216,7 +43426,7 @@ See gtk_image_new_from_file() for details.
</parameter_description>
</parameter>
<parameter name="filename">
-<parameter_description> a filename or %NULL
+<parameter_description> (allow-none): a filename or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -42608,15 +43818,15 @@ Deprecated: 2.4: Use gtk_toolbar_insert() instead.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> a #GtkWidget to add to the toolbar.
+<parameter_description> a #GtkWidget to add to the toolbar.
</parameter_description>
</parameter>
<parameter name="tooltip_text">
-<parameter_description> the element's tooltip.
+<parameter_description> (allow-none): the element's tooltip.
</parameter_description>
</parameter>
<parameter name="tooltip_private_text">
-<parameter_description> used for context-sensitive help about this toolbar element.
+<parameter_description> (allow-none): used for context-sensitive help about this toolbar element.
</parameter_description>
</parameter>
</parameters>
@@ -42751,7 +43961,7 @@ Deprecated: 2.16: Use gtk_status_icon_set_tooltip_text() instead.
</parameter_description>
</parameter>
<parameter name="tooltip_text">
-<parameter_description> the tooltip text, or %NULL
+<parameter_description> (allow-none): the tooltip text, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -42793,6 +44003,22 @@ Since: 2.4
</return>
</function>
+<function name="gtk_accel_map_load">
+<description>
+Parses a file previously saved with gtk_accel_map_save() for
+accelerator specifications, and propagates them accordingly.
+
+</description>
+<parameters>
+<parameter name="file_name">
+<parameter_description> a file containing accelerator specifications,
+in the GLib file name encoding
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_print_settings_new">
<description>
Creates a new #GtkPrintSettings object.
@@ -42833,7 +44059,7 @@ Return value: The number of children of @iter.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> The #GtkTreeIter, or %NULL.
+<parameter_description> (allow-none): The #GtkTreeIter, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -42902,11 +44128,11 @@ See gtk_image_new_from_image() for details.
</parameter_description>
</parameter>
<parameter name="gdk_image">
-<parameter_description> a #GdkImage or %NULL
+<parameter_description> (allow-none): a #GdkImage or %NULL
</parameter_description>
</parameter>
<parameter name="mask">
-<parameter_description> a #GdkBitmap or %NULL
+<parameter_description> (allow-none): a #GdkBitmap or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -42975,6 +44201,28 @@ Since: 2.6
</return>
</function>
+<function name="gtk_tool_item_set_homogeneous">
+<description>
+Sets whether @tool_item is to be allocated the same size as other
+homogeneous items. The effect is that all homogeneous items will have
+the same width as the widest of the items.
+
+Since: 2.4
+
+</description>
+<parameters>
+<parameter name="tool_item">
+<parameter_description> a #GtkToolItem
+</parameter_description>
+</parameter>
+<parameter name="homogeneous">
+<parameter_description> whether @tool_item is the same size as other homogeneous items
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_adjustment_get_page_increment">
<description>
Retrieves the page increment of the adjustment.
@@ -43076,15 +44324,15 @@ never uses a custom name set with gtk_widget_set_name().
</parameter_description>
</parameter>
<parameter name="path_length">
-<parameter_description> location to store the length of the class path, or %NULL
+<parameter_description> (out) (allow-none): location to store the length of the class path, or %NULL
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> location to store the class path as an allocated string, or %NULL
+<parameter_description> (out) (allow-none) location to store the class path as an allocated string, or %NULL
</parameter_description>
</parameter>
<parameter name="path_reversed">
-<parameter_description> location to store the reverse class path as an allocated
+<parameter_description> (out) (allow-none) location to store the reverse class path as an allocated
string, or %NULL
</parameter_description>
</parameter>
@@ -43302,6 +44550,31 @@ Since: 2.12
</return>
</function>
+<function name="gtk_tool_palette_set_exclusive">
+<description>
+Sets whether the group should be exclusive or not.
+If an exclusive group is expanded all other groups are collapsed.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
+</parameter_description>
+</parameter>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup which is a child of palette
+</parameter_description>
+</parameter>
+<parameter name="exclusive">
+<parameter_description> whether the group should be exclusive or not
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="GtkCellRendererToggle">
<description>
The ::toggled signal is emitted when the cell is toggled.
@@ -43437,11 +44710,11 @@ Creates a new #GtkLinkButton containing a label.
</parameter_description>
</parameter>
<parameter name="label">
-<parameter_description> the text of the button
+<parameter_description> (allow-none): the text of the button
</parameter_description>
</parameter>
</parameters>
-<return> a new link button widget.
+<return> (transfer none): a new link button widget.
Since: 2.10
</return>
@@ -43703,16 +44976,16 @@ parameters.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="edge">
@@ -43790,7 +45063,7 @@ Return value: A %NULL-terminated string array containing
</parameter>
</parameters>
<return> A %NULL-terminated string array containing
-the artists. The array is owned by the about dialog
+the artists. The array is owned by the about dialog
and must not be modified.
Since: 2.6
@@ -43881,7 +45154,7 @@ See gtk_image_new_from_stock() for details.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> (type int): a stock icon size
</parameter_description>
</parameter>
</parameters>
@@ -43942,20 +45215,26 @@ Return value: %TRUE if @ancestor contains @path somewhere below it
</return>
</function>
-<function name="gtk_color_button_set_title">
+<function name="gtk_tool_item_group_set_item_position">
<description>
-Sets the title for the color selection dialog.
+Sets the position of @item in the list of children of @group.
-Since: 2.4
+Since: 2.20
</description>
<parameters>
-<parameter name="color_button">
-<parameter_description> a #GtkColorButton
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup
</parameter_description>
</parameter>
-<parameter name="title">
-<parameter_description> String containing new window title.
+<parameter name="item">
+<parameter_description> the #GtkToolItem to move to a new position, should
+be a child of @group.
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> the new position of @item in @group, starting with 0.
+The position -1 means end of list.
</parameter_description>
</parameter>
</parameters>
@@ -44057,6 +45336,24 @@ Since: 2.10
<return></return>
</function>
+<function name="gtk_recent_chooser_get_sort_type">
+<description>
+Gets the value set by gtk_recent_chooser_set_sort_type().
+
+
+</description>
+<parameters>
+<parameter name="chooser">
+<parameter_description> a #GtkRecentChooser
+</parameter_description>
+</parameter>
+</parameters>
+<return> the sorting order of the @chooser.
+
+Since: 2.10
+</return>
+</function>
+
<function name="gtk_get_current_event_state">
<description>
If there is a current event and it has a state field, place
@@ -44095,7 +45392,7 @@ Since: 2.2
</parameter_description>
</parameter>
<parameter name="position">
-<parameter_description> A #GtkTreeIter.
+<parameter_description> (allow-none): A #GtkTreeIter.
</parameter_description>
</parameter>
</parameters>
@@ -44322,6 +45619,63 @@ a @dest no longer found in the model!
</return>
</function>
+<function name="gtk_tool_item_get_text_orientation">
+<description>
+Return value: a #GtkOrientation indicating the text orientation
+
+</description>
+<parameters>
+<parameter name="tool_item">
+<parameter_description> a #GtkToolItem
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GtkOrientation indicating the text orientation
+used for @tool_item
+
+Since: 2.20
+</return>
+</function>
+
+<function name="gtk_spinner_start">
+<description>
+Starts the animation of the spinner.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="spinner">
+<parameter_description> a #GtkSpinner
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_notebook_get_action_widget">
+<description>
+Gets one of the action widgets. See gtk_notebook_set_action_widget().
+
+
+</description>
+<parameters>
+<parameter name="notebook">
+<parameter_description> a #GtkNotebook
+</parameter_description>
+</parameter>
+<parameter name="pack_type">
+<parameter_description> pack type of the action widget to receive
+</parameter_description>
+</parameter>
+</parameters>
+<return> The action widget with the given @pack_type or
+%NULL when this action widget has not been set
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_ui_manager_get_toplevels">
<description>
Obtains a list of all toplevel widgets of the requested types.
@@ -44340,8 +45694,8 @@ types are #GTK_UI_MANAGER_MENUBAR, #GTK_UI_MANAGER_TOOLBAR and
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated #GSList of all toplevel widgets of the
-requested types. Free the returned list with g_slist_free().
+<return> (element-type GtkWidget) (transfer container): a newly-allocated #GSList of
+all toplevel widgets of the requested types. Free the returned list with g_slist_free().
Since: 2.4
</return>
@@ -44360,7 +45714,7 @@ Since: 2.8
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> The path of the item to highlight, or %NULL.
+<parameter_description> (allow-none): The path of the item to highlight, or %NULL.
</parameter_description>
</parameter>
<parameter name="pos">
@@ -44460,7 +45814,7 @@ icon set; you still need to unref it if you own references.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> (type int): a stock icon size
</parameter_description>
</parameter>
</parameters>
@@ -44662,6 +46016,34 @@ Since: 2.14
<return></return>
</function>
+<function name="_gtk_file_chooser_remove_shortcut_folder">
+<description>
+Removes a folder from the shortcut folders in a file chooser. Internal
+function, see gtk_file_chooser_remove_shortcut_folder().
+
+
+</description>
+<parameters>
+<parameter name="chooser">
+<parameter_description> a #GtkFileChooser
+</parameter_description>
+</parameter>
+<parameter name="file">
+<parameter_description> file for the folder to remove
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store error, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the folder could be removed successfully, %FALSE
+otherwise.
+
+Since: 2.4
+</return>
+</function>
+
<function name="gtk_clipboard_wait_for_targets">
<description>
Return value: %TRUE if any targets are present on the clipboard,
@@ -44701,7 +46083,7 @@ Since: 2.4
</description>
<parameters>
<parameter name="tool_item">
-<parameter_description> a #GtkToolItem
+<parameter_description> a #GtkToolItem
</parameter_description>
</parameter>
<parameter name="expand">
@@ -44801,21 +46183,26 @@ See also gtk_widget_get_child_requisition().
<return></return>
</function>
-<function name="gtk_recent_chooser_get_sort_type">
+<function name="gtk_tool_palette_get_group_position">
<description>
-Gets the value set by gtk_recent_chooser_set_sort_type().
+Gets the position of @group in @palette as index.
+See gtk_tool_palette_set_group_position().
</description>
<parameters>
-<parameter name="chooser">
-<parameter_description> a #GtkRecentChooser
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
+</parameter_description>
+</parameter>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup
</parameter_description>
</parameter>
</parameters>
-<return> the sorting order of the @chooser.
+<return> the index of group or -1 if @group is not a child of @palette
-Since: 2.10
+Since: 2.20
</return>
</function>
@@ -45456,11 +46843,11 @@ defined as @widget->window coordinates for widgets that are not
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> return location for the X coordinate, or %NULL
+<parameter_description> (out) (allow-none): return location for the X coordinate, or %NULL
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> return location for the Y coordinate, or %NULL
+<parameter_description> (out) (allow-none): return location for the Y coordinate, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -45609,7 +46996,7 @@ Return value: a line number
<function name="gtk_menu_get_for_attach_widget">
<description>
-Return value: the list of menus attached to his widget.
+Return value: (element-type GtkWidget) (transfer none): the list of menus attached to his widget.
</description>
<parameters>
@@ -45618,7 +47005,7 @@ Return value: the list of menus attached to his widget.
</parameter_description>
</parameter>
</parameters>
-<return> the list of menus attached to his widget.
+<return> (element-type GtkWidget) (transfer none): the list of menus attached to his widget.
Since: 2.6
</return>
@@ -45626,7 +47013,7 @@ Since: 2.6
<function name="gtk_widget_modify_bg">
<description>
-Sets the background color for a widget in a particular state.
+Sets the background color for a widget in a particular state.
All other style values are left untouched. See also
gtk_widget_modify_style().
@@ -45649,7 +47036,7 @@ and setting the background color on that.
</parameter_description>
</parameter>
<parameter name="color">
-<parameter_description> the color to assign (does not need to be allocated),
+<parameter_description> (allow-none): the color to assign (does not need to be allocated),
or %NULL to undo the effect of previous calls to
of gtk_widget_modify_bg().
</parameter_description>
@@ -45766,6 +47153,26 @@ Adds @child_widget to @layout, at position (@x,@y).
<return></return>
</function>
+<function name="gtk_tool_shell_get_ellipsize_mode">
+<description>
+Retrieves the current ellipsize mode for the tool shell. Tool items must not
+call this function directly, but rely on gtk_tool_item_get_ellipsize_mode()
+instead.
+
+
+</description>
+<parameters>
+<parameter name="shell">
+<parameter_description> a #GtkToolShell
+</parameter_description>
+</parameter>
+</parameters>
+<return> the current ellipsize mode of @shell
+
+Since: 2.14
+</return>
+</function>
+
<function name="gtk_notebook_set_homogeneous_tabs">
<description>
Sets whether the tabs must have all the same size or not.
@@ -45800,11 +47207,11 @@ gtk_init(), or gtk_init_check().
</description>
<parameters>
<parameter name="argc">
-<parameter_description> a pointer to the number of command line arguments.
+<parameter_description> (inout): a pointer to the number of command line arguments.
</parameter_description>
</parameter>
<parameter name="argv">
-<parameter_description> a pointer to the array of command line arguments.
+<parameter_description> (array) (inout): a pointer to the array of command line arguments.
</parameter_description>
</parameter>
</parameters>
@@ -45816,7 +47223,7 @@ gtk_init(), or gtk_init_check().
<description>
Sets @color to be the current color in the GtkColorSelection widget.
-Deprecated: Use gtk_color_selection_get_current_color() instead.
+Deprecated: 2.0: Use gtk_color_selection_get_current_color() instead.
</description>
<parameters>
@@ -45868,6 +47275,21 @@ and when the embedding ends.
<return></return>
</function>
+<function name="gtk_tree_model_sort_get_model">
+<description>
+Return value: the "child model" being sorted
+
+</description>
+<parameters>
+<parameter name="tree_model">
+<parameter_description> a #GtkTreeModelSort
+</parameter_description>
+</parameter>
+</parameters>
+<return> the "child model" being sorted
+</return>
+</function>
+
<function name="gtk_tool_button_new_from_stock">
<description>
Creates a new #GtkToolButton containing the image and text from a
@@ -45926,6 +47348,63 @@ Since: 2.4
<return></return>
</function>
+<function name="gtk_paint_spinner">
+<description>
+Draws a spinner on @window using the given parameters.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="style">
+<parameter_description> a #GtkStyle
+</parameter_description>
+</parameter>
+<parameter name="window">
+<parameter_description> a #GdkWindow
+</parameter_description>
+</parameter>
+<parameter name="state_type">
+<parameter_description> a state
+</parameter_description>
+</parameter>
+<parameter name="area">
+<parameter_description> clip rectangle, or %NULL if the
+output should not be clipped
+</parameter_description>
+</parameter>
+<parameter name="widget">
+<parameter_description> the widget (may be %NULL)
+</parameter_description>
+</parameter>
+<parameter name="detail">
+<parameter_description> a style detail (may be %NULL)
+</parameter_description>
+</parameter>
+<parameter name="step">
+<parameter_description> the nth step, a value between 0 and #GtkSpinner:num-steps
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> the x origin of the rectangle in which to draw the spinner
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> the y origin of the rectangle in which to draw the spinner
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> the width of the rectangle in which to draw the spinner
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> the height of the rectangle in which to draw the spinner
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_print_unix_dialog_set_settings">
<description>
Sets the #GtkPrintSettings for the #GtkPrintUnixDialog. Typically,
@@ -46345,23 +47824,30 @@ Deprecated: 2.0: Use gtk_paint_arrow() instead.
<return></return>
</function>
-<function name="gtk_font_selection_get_face_list">
+<function name="gtk_tool_palette_set_group_position">
<description>
-This returns the #GtkTreeView which lists all styles available for
-the selected font. For example, 'Regular', 'Bold', etc.
+Sets the position of the group as an index of the tool palette.
+If position is 0 the group will become the first child, if position is
+-1 it will become the last child.
+Since: 2.20
</description>
<parameters>
-<parameter name="fontsel">
-<parameter_description> a #GtkFontSelection
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
+</parameter_description>
+</parameter>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup which is a child of palette
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> a new index for group
</parameter_description>
</parameter>
</parameters>
-<return> A #GtkWidget that is part of @fontsel
-
-Since: 2.14
-</return>
+<return></return>
</function>
<function name="gtk_font_button_set_use_size">
@@ -46599,13 +48085,13 @@ after use with g_object_unref().
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock size. A size of (GtkIconSize)-1 means render at
-the size of the source and don't scale (if there are multiple
-source sizes, GTK+ picks one of the available sizes).
+<parameter_description> (type int) a stock size. A size of (GtkIconSize)-1 means
+render at the size of the source and don't scale (if there are
+multiple source sizes, GTK+ picks one of the available sizes).
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> render detail to pass to theme engine
+<parameter_description> (allow-none): render detail to pass to theme engine
</parameter_description>
</parameter>
</parameters>
@@ -46615,7 +48101,7 @@ source sizes, GTK+ picks one of the available sizes).
<function name="gtk_window_get_screen">
<description>
-Return value: a #GdkScreen.
+Return value: (transfer none): a #GdkScreen.
</description>
<parameters>
@@ -46624,12 +48110,33 @@ Return value: a #GdkScreen.
</parameter_description>
</parameter>
</parameters>
-<return> a #GdkScreen.
+<return> (transfer none): a #GdkScreen.
Since: 2.2
</return>
</function>
+<function name="gtk_tool_item_group_set_label">
+<description>
+Sets the label of the tool item group. The label is displayed in the header
+of the group.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup
+</parameter_description>
+</parameter>
+<parameter name="label">
+<parameter_description> the new human-readable label of of the group
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_info_bar_add_button">
<description>
Adds a button with the given text (or a stock button, if button_text
@@ -46675,11 +48182,38 @@ returned pixmap and mask.
</parameter_description>
</parameter>
<parameter name="pixmap">
-<parameter_description> location to store the pixmap, or %NULL
+<parameter_description> (out) (transfer none) (allow-none): location to store the
+pixmap, or %NULL
</parameter_description>
</parameter>
<parameter name="mask">
-<parameter_description> location to store the mask, or %NULL
+<parameter_description> (out) (transfer none) (allow-none): location to store the
+mask, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_file_chooser_add_filter">
+<description>
+Adds @filter to the list of filters that the user can select between.
+When a filter is selected, only files that are passed by that
+filter are displayed.
+
+Note that the @chooser takes ownership of the filter, so you have to
+ref and sink it if you want to keep a reference.
+
+Since: 2.4
+
+</description>
+<parameters>
+<parameter name="chooser">
+<parameter_description> a #GtkFileChooser
+</parameter_description>
+</parameter>
+<parameter name="filter">
+<parameter_description> a #GtkFileFilter
</parameter_description>
</parameter>
</parameters>
@@ -46940,16 +48474,16 @@ given style and orientation.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="x">
@@ -47090,7 +48624,7 @@ member won't be incremented.
</parameter_description>
</parameter>
</parameters>
-<return> copy of window's icon list
+<return> (element-type GdkPixbuf) (transfer container): copy of window's icon list
</return>
</function>
@@ -47146,10 +48680,9 @@ Since: 2.18
<function name="gtk_about_dialog_set_logo_icon_name">
<description>
-Sets the pixbuf to be displayed as logo in
-the about dialog. If it is %NULL, the default
-window icon set with gtk_window_set_default_icon()
-will be used.
+Sets the pixbuf to be displayed as logo in the about dialog.
+If it is %NULL, the default window icon set with
+gtk_window_set_default_icon() will be used.
Since: 2.6
@@ -47160,7 +48693,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="icon_name">
-<parameter_description> an icon name, or %NULL
+<parameter_description> (allow-none): an icon name, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -47194,7 +48727,7 @@ To do this, you can use gtk_tree_row_reference_new().
To free the return value, use:
|[
-g_list_foreach (list, gtk_tree_path_free, NULL);
+g_list_foreach (list, (GFunc)gtk_tree_path_free, NULL);
g_list_free (list);
]|
@@ -47206,7 +48739,7 @@ g_list_free (list);
</parameter_description>
</parameter>
</parameters>
-<return> A #GList containing a #GtkTreePath for each selected row.
+<return> (element-type GtkTreePath) (transfer full): A #GList containing a #GtkTreePath for each selected row.
Since: 2.6
</return>
@@ -47389,11 +48922,11 @@ See gtk_image_new_from_pixmap() for details.
</parameter_description>
</parameter>
<parameter name="pixmap">
-<parameter_description> a #GdkPixmap or %NULL
+<parameter_description> (allow-none): a #GdkPixmap or %NULL
</parameter_description>
</parameter>
<parameter name="mask">
-<parameter_description> a #GdkBitmap or %NULL
+<parameter_description> (allow-none): a #GdkBitmap or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -47453,7 +48986,7 @@ Sets @iter to a valid iterator pointing to @path.
<function name="gtk_cell_layout_get_cells">
<description>
-Return value: a list of cell renderers. The list, but not the
+Return value: (element-type GtkCellRenderer) (transfer container): a list of cell renderers. The list, but not the
</description>
<parameters>
@@ -47462,7 +48995,7 @@ Return value: a list of cell renderers. The list, but not the
</parameter_description>
</parameter>
</parameters>
-<return> a list of cell renderers. The list, but not the
+<return> (element-type GtkCellRenderer) (transfer container): a list of cell renderers. The list, but not the
renderers has been newly allocated and should be freed with
g_list_free() when no longer needed.
@@ -47525,8 +49058,8 @@ context, using gtk_print_context_set_cairo_context().
<function name="gtk_text_iter_forward_search">
<description>
-Searches forward for @str. Any match is returned by setting
- match_start to the first character of the match and @match_end to the
+Searches forward for @str. Any match is returned by setting
+ match_start to the first character of the match and @match_end to the
first character after the match. The search will not continue past
@limit. Note that a search is a linear or O(n) operation, so you
may wish to use @limit to avoid locking up your UI on large
@@ -47556,15 +49089,15 @@ character in @str will match embedded pixbufs or child widgets.
</parameter_description>
</parameter>
<parameter name="match_start">
-<parameter_description> return location for start of match, or %NULL
+<parameter_description> (allow-none): return location for start of match, or %NULL
</parameter_description>
</parameter>
<parameter name="match_end">
-<parameter_description> return location for end of match, or %NULL
+<parameter_description> (allow-none): return location for end of match, or %NULL
</parameter_description>
</parameter>
<parameter name="limit">
-<parameter_description> bound for the search, or %NULL for the end of the buffer
+<parameter_description> (allow-none): bound for the search, or %NULL for the end of the buffer
</parameter_description>
</parameter>
</parameters>
@@ -47720,6 +49253,44 @@ Makes a copy of a #GtkSelectionData structure and its data.
</return>
</function>
+<function name="gtk_printer_get_hard_margins">
+<description>
+Retrieve the hard margins of @printer, i.e. the margins that define
+the area at the borders of the paper that the printer cannot print to.
+
+Note: This will not succeed unless the printer's details are available,
+see gtk_printer_has_details() and gtk_printer_request_details().
+
+
+</description>
+<parameters>
+<parameter name="printer">
+<parameter_description> a #GtkPrinter
+</parameter_description>
+</parameter>
+<parameter name="top">
+<parameter_description> a location to store the top margin in
+</parameter_description>
+</parameter>
+<parameter name="bottom">
+<parameter_description> a location to store the bottom margin in
+</parameter_description>
+</parameter>
+<parameter name="left">
+<parameter_description> a location to store the left margin in
+</parameter_description>
+</parameter>
+<parameter name="right">
+<parameter_description> a location to store the right margin in
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE iff the hard margins were retrieved
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_window_remove_accel_group">
<description>
Reverses the effects of gtk_window_add_accel_group().
@@ -48600,7 +50171,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="label_widget">
-<parameter_description> the new label widget
+<parameter_description> (allow-none): the new label widget
</parameter_description>
</parameter>
</parameters>
@@ -48620,7 +50191,7 @@ Since: 2.2
</parameter_description>
</parameter>
<parameter name="screen">
-<parameter_description> a #GdkScreen, or %NULL if the screen should be
+<parameter_description> (allow-none): a #GdkScreen, or %NULL if the screen should be
determined by the widget the menu is attached to.
</parameter_description>
</parameter>
@@ -48628,6 +50199,27 @@ determined by the widget the menu is attached to.
<return></return>
</function>
+<function name="gtk_tool_palette_set_icon_size">
+<description>
+Sets the size of icons in the tool palette.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
+</parameter_description>
+</parameter>
+<parameter name="icon_size">
+<parameter_description> (type int): the #GtkIconSize that icons in the tool
+palette shall have
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_text_buffer_insert_pixbuf">
<description>
Inserts an image into the text buffer at @iter. The image will be
@@ -48657,6 +50249,32 @@ gtk_text_buffer_get_text().
<return></return>
</function>
+<function name="gtk_tooltip_set_icon_from_gicon">
+<description>
+Sets the icon of the tooltip (which is in front of the text)
+to be the icon indicated by @gicon with the size indicated
+by @size. If @gicon is %NULL, the image will be hidden.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="tooltip">
+<parameter_description> a #GtkTooltip
+</parameter_description>
+</parameter>
+<parameter name="gicon">
+<parameter_description> a #GIcon representing the icon, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> (type int): a stock icon size
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_action_get_icon_name">
<description>
Gets the icon name of @action.
@@ -48973,7 +50591,7 @@ Gets the value set by gtk_window_set_gravity().
</parameter_description>
</parameter>
</parameters>
-<return> window gravity
+<return> (transfer none): window gravity
</return>
</function>
@@ -49440,16 +51058,16 @@ in the given rectangle on @window using the given parameters.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="x">
@@ -49781,7 +51399,7 @@ destruction of the ui manager.
</parameter_description>
</parameter>
</parameters>
-<return> the widget found by following the path, or %NULL if no widget
+<return> (transfer none): the widget found by following the path, or %NULL if no widget
was found.
Since: 2.4
@@ -49999,7 +51617,7 @@ If either @tree_x or @tree_y are -1, then that direction isn't scrolled.
<function name="gtk_about_dialog_set_name">
<description>
-Sets the name to display in the about dialog.
+Sets the name to display in the about dialog.
If this is not set, it defaults to g_get_application_name().
Since: 2.6
@@ -50013,7 +51631,7 @@ Deprecated: 2.12: Use gtk_about_dialog_set_program_name() instead.
</parameter_description>
</parameter>
<parameter name="name">
-<parameter_description> the program name
+<parameter_description> (allow-none): the program name
</parameter_description>
</parameter>
</parameters>
@@ -50225,11 +51843,11 @@ pixmap or mask; you still need to unref them if you own references.
</description>
<parameters>
<parameter name="pixmap">
-<parameter_description> a #GdkPixmap, or %NULL
+<parameter_description> (allow-none): a #GdkPixmap, or %NULL
</parameter_description>
</parameter>
<parameter name="mask">
-<parameter_description> a #GdkBitmap, or %NULL
+<parameter_description> (allow-none): a #GdkBitmap, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -50406,7 +52024,7 @@ Since: 2.4
<function name="gtk_window_set_icon_name">
<description>
Sets the icon for the window from a named themed icon. See
-the docs for #GtkIconTheme for more details.
+the docs for #GtkIconTheme for more details.
Note that this has nothing to do with the WM_ICON_NAME
property which is mentioned in the ICCCM.
@@ -50420,7 +52038,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="name">
-<parameter_description> the name of the themed icon
+<parameter_description> (allow-none): the name of the themed icon
</parameter_description>
</parameter>
</parameters>
@@ -50488,6 +52106,49 @@ Since: 2.4
<return></return>
</function>
+<function name="gtk_action_group_get_name">
+<description>
+Gets the name of the action group.
+
+
+</description>
+<parameters>
+<parameter name="action_group">
+<parameter_description> the action group
+</parameter_description>
+</parameter>
+</parameters>
+<return> the name of the action group.
+
+Since: 2.4
+</return>
+</function>
+
+<function name="gtk_window_set_default">
+<description>
+The default widget is the widget that's activated when the user
+presses Enter in a dialog (for example). This function sets or
+unsets the default widget for a #GtkWindow about. When setting
+(rather than unsetting) the default widget it's generally easier to
+call gtk_widget_grab_focus() on the widget. Before making a widget
+the default widget, you must set the #GTK_CAN_DEFAULT flag on the
+widget you'd like to make the default using GTK_WIDGET_SET_FLAGS().
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GtkWindow
+</parameter_description>
+</parameter>
+<parameter name="default_widget">
+<parameter_description> (allow-none): widget to be the default, or %NULL to unset the
+default widget for the toplevel.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_style_get_style_property">
<description>
Queries the value of a style property corresponding to a
@@ -50728,19 +52389,21 @@ expander column to a hidden column.
<return></return>
</function>
-<function name="gtk_editable_copy_clipboard">
+<function name="gtk_widget_get_modifier_style">
<description>
-Copies the contents of the currently selected content in the editable and
-puts it on the clipboard.
+Return value: (transfer none): the modifier style for the widget. This rc style is
</description>
<parameters>
-<parameter name="editable">
-<parameter_description> a #GtkEditable
+<parameter name="widget">
+<parameter_description> a #GtkWidget
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> (transfer none): the modifier style for the widget. This rc style is
+owned by the widget. If you want to keep a pointer to value this
+around, you must add a refcount using g_object_ref().
+</return>
</function>
<function name="gtk_icon_info_free">
@@ -50841,7 +52504,7 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> (type int): a stock icon size
</parameter_description>
</parameter>
</parameters>
@@ -50924,6 +52587,34 @@ Creates a new #GtkViewport with the given adjustments.
</return>
</function>
+<function name="_gtk_file_system_model_get_iter_for_file">
+<description>
+Initializes @iter to point to the row used for @file, if @file is part
+of the model. Note that upon successful return, @iter may point to an
+invisible row in the @model. Use
+_gtk_file_system_model_iter_is_visible() to make sure it is visible to
+the tree view.
+
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> the model
+</parameter_description>
+</parameter>
+<parameter name="iter">
+<parameter_description> the iterator to be initialized
+</parameter_description>
+</parameter>
+<parameter name="file">
+<parameter_description> the file to look up
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if file is part of the model and @iter was initialized
+</return>
+</function>
+
<function name="gtk_icon_theme_get_example_icon_name">
<description>
Gets the name of an icon that is representative of the
@@ -50959,7 +52650,7 @@ added, so you do not need to unref it.
</parameter_description>
</parameter>
</parameters>
-<return> pointer to child of the #GtkBin
+<return> (transfer none): pointer to child of the #GtkBin
</return>
</function>
@@ -51070,14 +52761,20 @@ told the plug that it modality has toggled on.
<return></return>
</function>
-<function name="gtk_tree_view_column_clear">
+<function name="remove_file">
<description>
-Unsets all the mappings on all renderers on the @tree_column.
+Removes the given file from the model. If the file is not part of
+ model, this function does nothing.
</description>
<parameters>
-<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn
+<parameter name="model">
+<parameter_description> the model
+</parameter_description>
+</parameter>
+<parameter name="file">
+<parameter_description> file to remove from the model. The file must have been
+added to the model previously
</parameter_description>
</parameter>
</parameters>
@@ -51102,7 +52799,7 @@ free those resources when the widget is unrealized.
</parameter_description>
</parameter>
</parameters>
-<return> the #GdkDisplay for the toplevel for this widget.
+<return> (transfer none): the #GdkDisplay for the toplevel for this widget.
Since: 2.2
</return>
@@ -51373,6 +53070,28 @@ and invokations of gtk_drag_finish() in #GtkWidget:drag-data-received.
Especially the later is dramatic, when your own #GtkWidget:drag-motion
handler calls gtk_drag_get_data() to inspect the dragged data.
+There's no way to set a default action here, you can use the
+#GtkWidget:drag-motion callback for that. Here's an example which selects
+the action to use depending on whether the control key is pressed or not:
+|[
+static void
+drag_motion (GtkWidget *widget,
+GdkDragContext *context,
+gint x,
+gint y,
+guint time)
+{
+GdkModifierType mask;
+
+gdk_window_get_pointer (gtk_widget_get_window (widget),
+NULL, NULL, &mask);
+if (mask & GDK_CONTROL_MASK)
+gdk_drag_status (context, GDK_ACTION_COPY, time);
+else
+gdk_drag_status (context, GDK_ACTION_MOVE, time);
+}
+]|
+
</description>
<parameters>
<parameter name="widget">
@@ -51476,7 +53195,7 @@ emblems or overlays to the icon.
</parameter_description>
</parameter>
<parameter name="points">
-<parameter_description> location to store pointer to an array of points, or %NULL
+<parameter_description> (array length=n_points) (out): location to store pointer to an array of points, or %NULL
free the array of points with g_free().
</parameter_description>
</parameter>
@@ -51756,7 +53475,7 @@ Since: 2.6
<function name="gtk_icon_view_set_item_padding">
<description>
-Sets the ::item-padding property which specifies the padding
+Sets the #GtkIconView:item-padding property which specifies the padding
around each of the icon view's items.
Since: 2.18
@@ -51767,7 +53486,7 @@ Since: 2.18
<parameter_description> a #GtkIconView
</parameter_description>
</parameter>
-<parameter name="column_spacing">
+<parameter name="item_padding">
<parameter_description> the item padding
</parameter_description>
</parameter>
@@ -51870,6 +53589,8 @@ Looks up key bindings for @object to find one matching
</parameter>
</parameters>
<return> %TRUE if a matching key binding was found
+
+Since: 2.4
</return>
</function>
@@ -52063,6 +53784,19 @@ Since: 2.12
</return>
</function>
+<function name="gtk_clist_set_pixmap">
+<description>
+
+</description>
+<parameters>
+<parameter name="mask">
+<parameter_description> (allow-none):
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_item_factory_add_foreign">
<description>
Installs an accelerator for @accel_widget in @accel_group, that causes
@@ -52359,7 +54093,7 @@ Lists the actions in the action group.
</parameter_description>
</parameter>
</parameters>
-<return> an allocated list of the action objects in the action group
+<return> (element-type GtkAction) (transfer container): an allocated list of the action objects in the action group
Since: 2.4
</return>
@@ -52482,10 +54216,6 @@ Returns: %TRUE if the menu item will always show the image
<parameter_description> a #GtkImageMenuItem
</parameter_description>
</parameter>
-<parameter name="always_show">
-<parameter_description> %TRUE if the menuitem should always show the image
-</parameter_description>
-</parameter>
</parameters>
<return> %TRUE if the menu item will always show the image
@@ -52584,6 +54314,8 @@ overriding the standard key handling for a toplevel window.
</parameter>
</parameters>
<return> %TRUE if a widget in the focus chain handled the event.
+
+Since: 2.4
</return>
</function>
@@ -52866,7 +54598,7 @@ Since: 2.10
<function name="gtk_window_get_group">
<description>
-Returns: the #GtkWindowGroup for a window or the default group
+Returns: (transfer none): the #GtkWindowGroup for a window or the default group
</description>
<parameters>
@@ -52875,7 +54607,7 @@ Returns: the #GtkWindowGroup for a window or the default group
</parameter_description>
</parameter>
</parameters>
-<return> the #GtkWindowGroup for a window or the default group
+<return> (transfer none): the #GtkWindowGroup for a window or the default group
Since: 2.10
</return>
@@ -52905,8 +54637,8 @@ associated with, for example.
<function name="gtk_editable_get_selection_bounds">
<description>
Retrieves the selection bound of the editable. start_pos will be filled
-with the start of the selection and @end_pos with end. If no text was
-selected both will be identical and %FALSE will be returned.
+with the start of the selection and @end_pos with end. If no text was
+selected both will be identical and %FALSE will be returned.
Note that positions are specified in characters, not bytes.
@@ -52918,11 +54650,11 @@ Note that positions are specified in characters, not bytes.
</parameter_description>
</parameter>
<parameter name="start_pos">
-<parameter_description> location to store the starting position, or %NULL
+<parameter_description> (out) (allow-none): location to store the starting position, or %NULL
</parameter_description>
</parameter>
<parameter name="end_pos">
-<parameter_description> location to store the end position, or %NULL
+<parameter_description> (out) (allow-none): location to store the end position, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -53045,7 +54777,7 @@ gtk_icon_factory_add_default() and gtk_icon_factory_add().
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> (type int): a stock icon size
</parameter_description>
</parameter>
</parameters>
@@ -53184,34 +54916,19 @@ Deprecated: 2.0: Use gtk_paint_check() instead.
<return></return>
</function>
-<function name="gtk_text_buffer_begin_user_action">
+<function name="gtk_widget_get_events">
<description>
-Called to indicate that the buffer operations between here and a
-call to gtk_text_buffer_end_user_action() are part of a single
-user-visible operation. The operations between
-gtk_text_buffer_begin_user_action() and
-gtk_text_buffer_end_user_action() can then be grouped when creating
-an undo stack. #GtkTextBuffer maintains a count of calls to
-gtk_text_buffer_begin_user_action() that have not been closed with
-a call to gtk_text_buffer_end_user_action(), and emits the
-"begin-user-action" and "end-user-action" signals only for the
-outermost pair of calls. This allows you to build user actions
-from other user actions.
-
-The "interactive" buffer mutation functions, such as
-gtk_text_buffer_insert_interactive(), automatically call begin/end
-user action around the buffer operations they perform, so there's
-no need to add extra calls if you user action consists solely of a
-single call to one of those functions.
+Return value: event mask for @widget
</description>
<parameters>
-<parameter name="buffer">
-<parameter_description> a #GtkTextBuffer
+<parameter name="widget">
+<parameter_description> a #GtkWidget
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> event mask for @widget
+</return>
</function>
<function name="GtkCellRendererText">
@@ -53340,7 +55057,7 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> (type int): a stock icon size
</parameter_description>
</parameter>
</parameters>
@@ -53973,7 +55690,7 @@ freed by the caller.
</parameter_description>
</parameter>
</parameters>
-<return> the #PangoLayout for this label
+<return> (transfer none): the #PangoLayout for this label
</return>
</function>
@@ -54120,19 +55837,28 @@ Sets a non default parent window for @widget.
<return></return>
</function>
-<function name="gtk_tree_model_sort_get_model">
+<function name="gtk_image_set">
<description>
-Return value: the "child model" being sorted
+Sets the #GtkImage.
+
+Deprecated: 2.0: Use gtk_image_set_from_image() instead.
</description>
<parameters>
-<parameter name="tree_model">
-<parameter_description> a #GtkTreeModelSort
+<parameter name="image">
+<parameter_description> a #GtkImage
+</parameter_description>
+</parameter>
+<parameter name="val">
+<parameter_description> a #GdkImage
+</parameter_description>
+</parameter>
+<parameter name="mask">
+<parameter_description> a #GdkBitmap that indicates which parts of the image should be transparent.
</parameter_description>
</parameter>
</parameters>
-<return> the "child model" being sorted
-</return>
+<return></return>
</function>
<function name="gtk_builder_new">
@@ -54228,6 +55954,30 @@ Since: 2.10
<return></return>
</function>
+<function name="gtk_action_set_always_show_image">
+<description>
+Sets whether @action<!-- -->'s menu item proxies will ignore the
+#GtkSettings:gtk-menu-images setting and always show their image, if available.
+
+Use this if the menu item would be useless or hard to use
+without their image.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="action">
+<parameter_description> a #GtkAction
+</parameter_description>
+</parameter>
+<parameter name="always_show">
+<parameter_description> %TRUE if menuitem proxies should always show their image
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_tool_button_get_label">
<description>
Return value: The label, or %NULL
@@ -54288,6 +56038,26 @@ Since: 2.16
<return></return>
</function>
+<function name="gtk_color_button_set_title">
+<description>
+Sets the title for the color selection dialog.
+
+Since: 2.4
+
+</description>
+<parameters>
+<parameter name="color_button">
+<parameter_description> a #GtkColorButton
+</parameter_description>
+</parameter>
+<parameter name="title">
+<parameter_description> String containing new window title.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_widget_is_ancestor">
<description>
Determines whether @widget is somewhere inside @ancestor, possibly with
@@ -54356,16 +56126,16 @@ Draws a box on @window with the given parameters.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="x">
@@ -54700,6 +56470,31 @@ widget.
<return></return>
</function>
+<function name="gtk_ctree_insert_node">
+<description>
+
+</description>
+<parameters>
+<parameter name="pixmap_closed">
+<parameter_description> (allow-none):
+</parameter_description>
+</parameter>
+<parameter name="mask_closed">
+<parameter_description> (allow-none):
+</parameter_description>
+</parameter>
+<parameter name="pixmap_opened">
+<parameter_description> (allow-none):
+</parameter_description>
+</parameter>
+<parameter name="mask_opened">
+<parameter_description> (allow-none):
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_tooltip_trigger_tooltip_query">
<description>
Triggers a new tooltip query on @display, in order to update the current
@@ -54719,6 +56514,24 @@ Since: 2.12
<return></return>
</function>
+<function name="gtk_widget_reset_rc_styles">
+<description>
+Reset the styles of @widget and all descendents, so when
+they are looked up again, they get the correct values
+for the currently loaded RC file settings.
+
+This function is not useful for applications.
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_file_chooser_button_set_width_chars">
<description>
Sets the width (in characters) that @button will use to @n_chars.
@@ -54804,7 +56617,7 @@ is statically allocated and should not be freed.
</description>
<parameters>
<parameter name="size">
-<parameter_description> a #GtkIconSize.
+<parameter_description> (type int): a #GtkIconSize.
</parameter_description>
</parameter>
</parameters>
@@ -54902,6 +56715,26 @@ Determines whether the mark has left gravity.
</return>
</function>
+<function name="gtk_recent_info_get_visited">
+<description>
+Gets the timestamp (seconds from system's Epoch) when the resource
+was last visited.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GtkRecentInfo
+</parameter_description>
+</parameter>
+</parameters>
+<return> the number of seconds elapsed from system's Epoch when
+the resource was last visited, or -1 on failure.
+
+Since: 2.10
+</return>
+</function>
+
<function name="_gtk_size_group_get_child_requisition">
<description>
Retrieve the "child requisition" of the widget, taking account grouping
@@ -55021,7 +56854,7 @@ Since: 2.2
</parameter_description>
</parameter>
<parameter name="position">
-<parameter_description> A #GtkTreeIter, or %NULL.
+<parameter_description> (allow-none): A #GtkTreeIter, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -55050,15 +56883,15 @@ of @widget's outermost ancestor.
</parameter_description>
</parameter>
<parameter name="path_length">
-<parameter_description> location to store length of the path, or %NULL
+<parameter_description> (out) (allow-none): location to store length of the path, or %NULL
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> location to store allocated path string, or %NULL
+<parameter_description> (out) (allow-none): location to store allocated path string, or %NULL
</parameter_description>
</parameter>
<parameter name="path_reversed">
-<parameter_description> location to store allocated reverse path string, or %NULL
+<parameter_description> (out) (allow-none): location to store allocated reverse path string, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -55180,13 +57013,31 @@ Since: 2.2
</parameter_description>
</parameter>
<parameter name="position">
-<parameter_description> A #GtkTreeIter or %NULL.
+<parameter_description> (allow-none): A #GtkTreeIter or %NULL.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="gtk_recent_chooser_get_show_icons">
+<description>
+Retrieves whether @chooser should show an icon near the resource.
+
+
+</description>
+<parameters>
+<parameter name="chooser">
+<parameter_description> a #GtkRecentChooser
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the icons should be displayed, %FALSE otherwise.
+
+Since: 2.10
+</return>
+</function>
+
<function name="gtk_text_buffer_get_modified">
<description>
Indicates whether the buffer has been modified since the last call
@@ -55522,7 +57373,7 @@ Sets the vertical adjustment of the viewport.
</parameter_description>
</parameter>
<parameter name="adjustment">
-<parameter_description> a #GtkAdjustment.
+<parameter_description> (allow-none): a #GtkAdjustment.
</parameter_description>
</parameter>
</parameters>
@@ -55550,6 +57401,23 @@ Since: 2.10
</return>
</function>
+<function name="gtk_ctree_move">
+<description>
+
+</description>
+<parameters>
+<parameter name="new_parent">
+<parameter_description> (allow-none):
+</parameter_description>
+</parameter>
+<parameter name="new_sibling">
+<parameter_description> (allow-none):
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_info_bar_set_default_response">
<description>
Sets the last widget in the info bar's action area with
@@ -55651,7 +57519,7 @@ gtk_container_set_focus_hadjustment ().
</parameter_description>
</parameter>
</parameters>
-<return> the horizontal focus adjustment, or %NULL if
+<return> (transfer none): the horizontal focus adjustment, or %NULL if
none has been set.
</return>
</function>
@@ -55725,9 +57593,9 @@ Since: 2.2
<function name="gtk_scrolled_window_new">
<description>
-Creates a new scrolled window.
+Creates a new scrolled window.
-The two arguments are the scrolled window's adjustments; these will be
+The two arguments are the scrolled window's adjustments; these will be
shared with the scrollbars and the child widget to keep the bars in sync
with the child. Usually you want to pass %NULL for the adjustments, which
will cause the scrolled window to create them for you.
@@ -55736,11 +57604,11 @@ will cause the scrolled window to create them for you.
</description>
<parameters>
<parameter name="hadjustment">
-<parameter_description> horizontal adjustment
+<parameter_description> (allow-none): horizontal adjustment
</parameter_description>
</parameter>
<parameter name="vadjustment">
-<parameter_description> vertical adjustment
+<parameter_description> (allow-none): vertical adjustment
</parameter_description>
</parameter>
</parameters>
@@ -55869,7 +57737,7 @@ Since: 2.18
</parameter_description>
</parameter>
<parameter name="allocation">
-<parameter_description> a pointer to a #GtkAllocation to copy to
+<parameter_description> (out): a pointer to a #GtkAllocation to copy to
</parameter_description>
</parameter>
</parameters>
@@ -55892,7 +57760,8 @@ returned pixbuf.
</parameter_description>
</parameter>
</parameters>
-<return> the displayed pixbuf, or %NULL if the image is empty
+<return> (transfer none): the displayed pixbuf, or %NULL if
+the image is empty
</return>
</function>
@@ -55982,7 +57851,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="pixbuf">
-<parameter_description> the new header image @page
+<parameter_description> (allow-none): the new header image @page
</parameter_description>
</parameter>
</parameters>
@@ -56084,7 +57953,7 @@ Gets the number of decimal places that are displayed in the value.
<function name="gtk_about_dialog_get_wrap_license">
<description>
-Returns: %TRUE if the license text is wrapped
+Returns: %TRUE if the license text is wrapped
</description>
<parameters>
@@ -56093,7 +57962,7 @@ Returns: %TRUE if the license text is wrapped
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the license text is wrapped
+<return> %TRUE if the license text is wrapped
Since: 2.8
</return>
@@ -56237,7 +58106,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> an icon size
+<parameter_description> (type int): an icon size
</parameter_description>
</parameter>
</parameters>
@@ -56264,16 +58133,16 @@ using the given style and state.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> rectangle to which the output is clipped, or %NULL if the
+<parameter_description> (allow-none): rectangle to which the output is clipped, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="x1">
@@ -56362,6 +58231,24 @@ with a context for the source side of a drag)
<return></return>
</function>
+<function name="gtk_tool_item_group_new">
+<description>
+Creates a new tool item group with label @label.
+
+
+</description>
+<parameters>
+<parameter name="label">
+<parameter_description> the label of the new group
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GtkToolItemGroup.
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_widget_keynav_failed">
<description>
This function should be called whenever keyboard navigation within
@@ -56527,10 +58414,6 @@ Gets the short label text of @action.
<parameter_description> a #GtkAction
</parameter_description>
</parameter>
-<parameter name="label">
-<parameter_description> the label text to set
-</parameter_description>
-</parameter>
</parameters>
<return> the short label text.
@@ -56711,7 +58594,7 @@ Since: 2.10
<function name="gtk_icon_view_set_cursor">
<description>
Sets the current keyboard focus to be at @path, and selects it. This is
-useful when you want to focus the user's attention on a particular item.
+useful when you want to focus the user's attention on a particular item.
If @cell is not %NULL, then focus is given to the cell specified by
it. Additionally, if @start_editing is %TRUE, then editing should be
started in the specified cell.
@@ -56733,7 +58616,7 @@ Since: 2.8
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> One of the cell renderers of @icon_view, or %NULL
+<parameter_description> (allow-none): One of the cell renderers of @icon_view, or %NULL
</parameter_description>
</parameter>
<parameter name="start_editing">
@@ -56766,7 +58649,7 @@ Since: 2.10
<function name="gtk_about_dialog_set_authors">
<description>
Sets the strings which are displayed in the authors tab
-of the secondary credits dialog.
+of the secondary credits dialog.
Since: 2.6
@@ -56777,7 +58660,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="authors">
-<parameter_description> a %NULL-terminated array of strings
+<parameter_description> a %NULL-terminated array of strings
</parameter_description>
</parameter>
</parameters>
@@ -57092,6 +58975,19 @@ Since: 2.16
</return>
</function>
+<function name="gtk_spinner_new">
+<description>
+Return value: a new #GtkSpinner
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GtkSpinner
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_font_button_get_title">
<description>
Retrieves the title of the font selection dialog.
@@ -57442,6 +59338,24 @@ Gets the column searched on by the interactive search code.
</return>
</function>
+<function name="_gtk_file_system_model_freeze_updates">
+<description>
+Freezes most updates on the model, so that performing multiple
+operations on the files in the model do not cause any events.
+Use _gtk_file_system_model_thaw_updates() to resume proper
+operations. It is fine to call this function multiple times as
+long as freeze and thaw calls are balanced.
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #GtkFileSystemModel
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_calendar_get_detail_height_rows">
<description>
Queries the height of detail cells, in rows.
@@ -57655,7 +59569,7 @@ Returns: Whether the alternative button order should be used
</description>
<parameters>
<parameter name="screen">
-<parameter_description> a #GdkScreen, or %NULL to use the default screen
+<parameter_description> (allow-none): a #GdkScreen, or %NULL to use the default screen
</parameter_description>
</parameter>
</parameters>
@@ -57982,6 +59896,19 @@ Since: 2.14
</return>
</function>
+<function name="GtkToolPalette">
+<description>
+Whether the item group should receive extra space when the palette grows.
+at a given time.
+
+Since: 2.20
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_icon_view_select_all">
<description>
Selects all the icons. @icon_view must has its selection mode set
@@ -58015,12 +59942,12 @@ Deprecated: 2.4: Use #GtkUIManager instead.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> the factory path of the new item factory, a string of the form
+<parameter_description> the factory path of the new item factory, a string of the form
<literal>"<name>"</literal>
</parameter_description>
</parameter>
<parameter name="accel_group">
-<parameter_description> a #GtkAccelGroup to which the accelerators for the
+<parameter_description> (allow-none): a #GtkAccelGroup to which the accelerators for the
menu items will be added, or %NULL to create a new one
</parameter_description>
</parameter>
@@ -58214,15 +60141,15 @@ Deprecated: 2.4: Use gtk_toolbar_insert() instead.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> a #GtkWidget to add to the toolbar.
+<parameter_description> a #GtkWidget to add to the toolbar.
</parameter_description>
</parameter>
<parameter name="tooltip_text">
-<parameter_description> the element's tooltip.
+<parameter_description> (allow-none): the element's tooltip.
</parameter_description>
</parameter>
<parameter name="tooltip_private_text">
-<parameter_description> used for context-sensitive help about this toolbar element.
+<parameter_description> (allow-none): used for context-sensitive help about this toolbar element.
</parameter_description>
</parameter>
</parameters>
@@ -58269,19 +60196,44 @@ Deprecated: 2.4: Use #GtkUIManager instead.
</return>
</function>
-<function name="gtk_editable_delete_selection">
+<function name="gtk_im_context_get_surrounding">
<description>
-Deletes the currently selected text of the editable.
-This call doesn't do anything if there is no selected text.
+Retrieves context around the insertion point. Input methods
+typically want context in order to constrain input text based on
+existing text; this is important for languages such as Thai where
+only some sequences of characters are allowed.
+
+This function is implemented by emitting the
+GtkIMContext::retrieve_surrounding signal on the input method; in
+response to this signal, a widget should provide as much context as
+is available, up to an entire paragraph, by calling
+gtk_im_context_set_surrounding(). Note that there is no obligation
+for a widget to respond to the ::retrieve_surrounding signal, so input
+methods must be prepared to function without context.
+
</description>
<parameters>
-<parameter name="editable">
-<parameter_description> a #GtkEditable
+<parameter name="context">
+<parameter_description> a #GtkIMContext
+</parameter_description>
+</parameter>
+<parameter name="text">
+<parameter_description> location to store a UTF-8 encoded string of text
+holding context around the insertion point.
+If the function returns %TRUE, then you must free
+the result stored in this location with g_free().
+</parameter_description>
+</parameter>
+<parameter name="cursor_index">
+<parameter_description> location to store byte index of the insertion cursor
+within @text.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if surrounding text was provided; in this case
+you must free the result stored in *text.
+</return>
</function>
<function name="gtk_text_iter_backward_visible_word_starts">
@@ -58471,11 +60423,11 @@ realized.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
+<parameter_description> (allow-none): a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordinates
+<parameter_description> (allow-none): a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordinates
</parameter_description>
</parameter>
<parameter name="rect">
@@ -58486,6 +60438,19 @@ realized.
<return></return>
</function>
+<function name="gtk_menu_set_accel_group">
+<description>
+
+</description>
+<parameters>
+<parameter name="accel_group">
+<parameter_description> (allow-none):
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_text_buffer_create_child_anchor">
<description>
This is a convenience function which simply creates a child anchor
@@ -58603,7 +60568,7 @@ default behaviour by overriding the class closure of this signal.
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> a #GtkWidget, or %NULL
+<parameter_description> (allow-none): a #GtkWidget, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -58684,6 +60649,9 @@ hiding @custom_window at the right moment, to behave likewise as
the default tooltip window. If @custom_window is %NULL, the default
tooltip window will be used.
+If the custom window should have the default theming it needs to
+have the name "gtk-tooltip", see gtk_widget_set_name().
+
Since: 2.12
</description>
@@ -58700,6 +60668,28 @@ Since: 2.12
<return></return>
</function>
+<function name="gtk_combo_box_set_row_span_column">
+<description>
+Sets the column with row span information for @combo_box to be @row_span.
+The row span column contains integers which indicate how many rows
+an item should span.
+
+Since: 2.4
+
+</description>
+<parameters>
+<parameter name="combo_box">
+<parameter_description> A #GtkComboBox.
+</parameter_description>
+</parameter>
+<parameter name="row_span">
+<parameter_description> A column in the model passed during construction.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_fixed_set_has_window">
<description>
Sets whether a #GtkFixed widget is created with a separate
@@ -58711,6 +60701,8 @@ window is created.
This function was added to provide an easy migration path for
older applications which may expect #GtkFixed to have a separate window.
+Deprecated: 2.20: Use gtk_widget_set_has_window() instead.
+
</description>
<parameters>
<parameter name="fixed">
@@ -58786,7 +60778,7 @@ Moves @column to be after to @base_column. If @base_column is %NULL, then
</parameter_description>
</parameter>
<parameter name="base_column">
-<parameter_description> The #GtkTreeViewColumn to be moved relative to, or %NULL.
+<parameter_description> (allow-none): The #GtkTreeViewColumn to be moved relative to, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -58972,7 +60964,7 @@ Since: 2.8
</parameter_description>
</parameter>
<parameter name="icon_name">
-<parameter_description> the name of the themed icon
+<parameter_description> (allow-none): the name of the themed icon
</parameter_description>
</parameter>
</parameters>
@@ -58996,12 +60988,12 @@ label in the popup menu.
</parameter_description>
</parameter>
<parameter name="tab_label">
-<parameter_description> the #GtkWidget to be used as the label for the page,
+<parameter_description> (allow-none): the #GtkWidget to be used as the label for the page,
or %NULL to use the default label, 'page N'.
</parameter_description>
</parameter>
<parameter name="menu_label">
-<parameter_description> the widget to use as a label for the page-switch
+<parameter_description> (allow-none): the widget to use as a label for the page-switch
menu, if that is enabled. If %NULL, and @tab_label
is a #GtkLabel or %NULL, then the menu label will be
a newly created label with the same text as @tab_label;
@@ -59152,7 +61144,7 @@ Prepends a page to @notebook.
</parameter_description>
</parameter>
<parameter name="tab_label">
-<parameter_description> the #GtkWidget to be used as the label for the page,
+<parameter_description> (allow-none): the #GtkWidget to be used as the label for the page,
or %NULL to use the default label, 'page N'.
</parameter_description>
</parameter>
@@ -59300,7 +61292,7 @@ Adds a client message to the stack of current XEMBED events.
<function name="gtk_text_buffer_paste_clipboard">
<description>
-Pastes the contents of a clipboard at the insertion point, or at
+Pastes the contents of a clipboard at the insertion point, or at
@override_location. (Note: pasting is asynchronous, that is, we'll
ask for the paste data and return, and at some point later after
the main loop runs, the paste data will be inserted.)
@@ -59316,7 +61308,7 @@ the main loop runs, the paste data will be inserted.)
</parameter_description>
</parameter>
<parameter name="override_location">
-<parameter_description> location to insert pasted text, or %NULL for
+<parameter_description> (allow-none): location to insert pasted text, or %NULL for
at the cursor
</parameter_description>
</parameter>
@@ -59545,8 +61537,8 @@ See gtk_window_set_has_frame(), gtk_window_set_frame_dimensions().
<function name="gtk_file_chooser_set_select_multiple">
<description>
Sets whether multiple files can be selected in the file selector. This is
-only relevant if the action is set to be GTK_FILE_CHOOSER_ACTION_OPEN or
-GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER.
+only relevant if the action is set to be %GTK_FILE_CHOOSER_ACTION_OPEN or
+%GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER.
Since: 2.4
@@ -59709,7 +61701,7 @@ Since: 2.2
</parameter_description>
</parameter>
<parameter name="position">
-<parameter_description> A #GtkTreeIter or %NULL.
+<parameter_description> (allow-none): A #GtkTreeIter or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -59749,6 +61741,28 @@ Return value: The maximum width of the @tree_column.
</return>
</function>
+<function name="gtk_tool_item_group_get_item_position">
+<description>
+Gets the position of @item in @group as index.
+
+
+</description>
+<parameters>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup
+</parameter_description>
+</parameter>
+<parameter name="item">
+<parameter_description> a #GtkToolItem
+</parameter_description>
+</parameter>
+</parameters>
+<return> the index of @item in @group or -1 if @item is no child of @group
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_print_operation_run">
<description>
Runs the print operation, by first letting the user modify
@@ -59819,7 +61833,7 @@ given #GtkPrintOperation.
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> Transient parent of the dialog, or %NULL
+<parameter_description> (allow-none): Transient parent of the dialog
</parameter_description>
</parameter>
<parameter name="error">
@@ -59871,6 +61885,8 @@ By default, GTK+ uses the icon as the drag icon. You can use the
have to use g_signal_connect_after() to ensure that your signal handler
gets executed after the default handler.
+Since: 2.16
+
</description>
<parameters>
<parameter name="entry">
@@ -59984,7 +62000,7 @@ or %NULL to list all icons.
</parameter_description>
</parameter>
</parameters>
-<return> a #GList list holding the names of all the
+<return> (element-type utf8) (transfer none): a #GList list holding the names of all the
icons in the theme. You must first free each element
in the list with g_free(), then free the list itself
with g_list_free().
@@ -60278,6 +62294,26 @@ stock id to select the stock item for the button.
<return></return>
</function>
+<function name="gtk_tool_shell_get_text_alignment">
+<description>
+Retrieves the current text alignment for the tool shell. Tool items must not
+call this function directly, but rely on gtk_tool_item_get_text_alignment()
+instead.
+
+
+</description>
+<parameters>
+<parameter name="shell">
+<parameter_description> a #GtkToolShell
+</parameter_description>
+</parameter>
+</parameters>
+<return> the current text alignment of @shell
+
+Since: 2.14
+</return>
+</function>
+
<function name="GtkRadioToolButton">
<description>
Sets a new group for a radio tool button.
@@ -60326,10 +62362,9 @@ Since: 2.4
<function name="gtk_about_dialog_set_logo">
<description>
-Sets the pixbuf to be displayed as logo in
-the about dialog. If it is %NULL, the default
-window icon set with gtk_window_set_default_icon ()
-will be used.
+Sets the pixbuf to be displayed as logo in the about dialog.
+If it is %NULL, the default window icon set with
+gtk_window_set_default_icon() will be used.
Since: 2.6
@@ -60340,7 +62375,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="logo">
-<parameter_description> a #GdkPixbuf, or %NULL
+<parameter_description> (allow-none): a #GdkPixbuf, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -60365,23 +62400,26 @@ Since: 2.10
</return>
</function>
-<function name="gtk_spin_button_set_wrap">
+<function name="gtk_custom_paper_unix_dialog_new">
<description>
-Sets the flag that determines if a spin button value wraps around to the
-opposite limit when the upper or lower limit of the range is exceeded.
+Creates a new custom paper dialog.
+
</description>
<parameters>
-<parameter name="spin_button">
-<parameter_description> a #GtkSpinButton
+<parameter name="title">
+<parameter_description> the title of the dialog, or %NULL
</parameter_description>
</parameter>
-<parameter name="wrap">
-<parameter_description> a flag indicating if wrapping behavior is performed.
+<parameter name="parent">
+<parameter_description> transient parent of the dialog, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the new #GtkCustomPaperUnixDialog
+
+Since: 2.18
+</return>
</function>
<function name="gtk_size_group_get_mode">
@@ -60475,16 +62513,16 @@ using the given style and state and shadow type.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle or %NULL if the
+<parameter_description> (allow-none): clip rectangle or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="x">
@@ -60496,11 +62534,11 @@ output should not be clipped
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> width of the rectangle
+<parameter_description> width of the rectangle
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> width of the rectangle
+<parameter_description> width of the rectangle
</parameter_description>
</parameter>
</parameters>
@@ -60563,6 +62601,26 @@ Since: 2.8
</return>
</function>
+<function name="gtk_tool_shell_get_text_size_group">
+<description>
+Retrieves the current text size group for the tool shell. Tool items must not
+call this function directly, but rely on gtk_tool_item_get_text_size_group()
+instead.
+
+
+</description>
+<parameters>
+<parameter name="shell">
+<parameter_description> a #GtkToolShell
+</parameter_description>
+</parameter>
+</parameters>
+<return> the current text size group of @shell
+
+Since: 2.14
+</return>
+</function>
+
<function name="gtk_tool_item_set_tooltip">
<description>
Sets the #GtkTooltips object to be used for @tool_item, the
@@ -60576,7 +62634,7 @@ Deprecated: 2.12: Use gtk_tool_item_set_tooltip_text() instead.
</description>
<parameters>
<parameter name="tool_item">
-<parameter_description> a #GtkToolItem
+<parameter_description> a #GtkToolItem
</parameter_description>
</parameter>
<parameter name="tooltips">
@@ -60584,11 +62642,11 @@ Deprecated: 2.12: Use gtk_tool_item_set_tooltip_text() instead.
</parameter_description>
</parameter>
<parameter name="tip_text">
-<parameter_description> text to be used as tooltip text for @tool_item
+<parameter_description> (allow-none): text to be used as tooltip text for @tool_item
</parameter_description>
</parameter>
<parameter name="tip_private">
-<parameter_description> text to be used as private tooltip text
+<parameter_description> (allow-none): text to be used as private tooltip text
</parameter_description>
</parameter>
</parameters>
@@ -60698,6 +62756,18 @@ Since: 2.10
</return>
</function>
+<function name="GtkCellRendererSpinner">
+<description>
+The #GtkIconSize value that specifies the size of the rendered spinner.
+
+Since: 2.20
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_drag_begin">
<description>
Initiates a drag on the source side. The function
@@ -60803,11 +62873,11 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="drawable">
-<parameter_description> a #GdkDrawable
+<parameter_description> a #GdkDrawable
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> rectangle to which the output is clipped, or %NULL if the
+<parameter_description> (allow-none): rectangle to which the output is clipped, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
@@ -61025,7 +63095,7 @@ left-to-right insertion and right-to-left insertion.
<function name="gtk_about_dialog_set_artists">
<description>
Sets the strings which are displayed in the artists tab
-of the secondary credits dialog.
+of the secondary credits dialog.
Since: 2.6
@@ -61036,7 +63106,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="artists">
-<parameter_description> a %NULL-terminated array of strings
+<parameter_description> a %NULL-terminated array of strings
</parameter_description>
</parameter>
</parameters>
@@ -61296,6 +63366,30 @@ Deprecated: 2.4: Use #GtkUIManager instead.
</return>
</function>
+<function name="gtk_image_get">
+<description>
+Gets the #GtkImage.
+
+Deprecated: 2.0: Use gtk_image_get_image() instead.
+
+</description>
+<parameters>
+<parameter name="image">
+<parameter_description> a #GtkImage
+</parameter_description>
+</parameter>
+<parameter name="val">
+<parameter_description> return location for a #GdkImage
+</parameter_description>
+</parameter>
+<parameter name="mask">
+<parameter_description> a #GdkBitmap that indicates which parts of the image should be transparent.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_icon_source_new">
<description>
Creates a new #GtkIconSource. A #GtkIconSource contains a #GdkPixbuf (or
@@ -61349,6 +63443,26 @@ Since: 2.12
<return></return>
</function>
+<function name="gtk_tool_palette_set_style">
+<description>
+Sets the style (text, icons or both) of items in the tool palette.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
+</parameter_description>
+</parameter>
+<parameter name="style">
+<parameter_description> the #GtkToolbarStyle that items in the tool palette shall have
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_cell_renderer_toggle_set_radio">
<description>
If @radio is %TRUE, the cell renderer renders a radio toggle
@@ -61423,7 +63537,7 @@ Lists all the selected files and subfolders in the current folder of
</parameter_description>
</parameter>
</parameters>
-<return> a #GSList containing the URIs of all selected
+<return> (element-type utf8) (transfer full): a #GSList containing the URIs of all selected
files and subfolders in the current folder. Free the returned list
with g_slist_free(), and the filenames with g_free().
@@ -61542,11 +63656,11 @@ Since: 2.2
</parameter_description>
</parameter>
<parameter name="focus_column">
-<parameter_description> A #GtkTreeViewColumn, or %NULL
+<parameter_description> (allow-none): A #GtkTreeViewColumn, or %NULL
</parameter_description>
</parameter>
<parameter name="focus_cell">
-<parameter_description> A #GtkCellRenderer, or %NULL
+<parameter_description> (allow-none): A #GtkCellRenderer, or %NULL
</parameter_description>
</parameter>
<parameter name="start_editing">
@@ -61718,6 +63832,24 @@ Since: 2.6
<return></return>
</function>
+<function name="gtk_tool_item_group_get_collapsed">
+<description>
+Gets whether @group is collapsed or expanded.
+
+
+</description>
+<parameters>
+<parameter name="group">
+<parameter_description> a GtkToolItemGroup
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @group is collapsed, %FALSE if it is expanded
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_print_unix_dialog_get_current_page">
<description>
Gets the current page of the #GtkPrintDialog.
@@ -61861,7 +63993,7 @@ Appends a page to @notebook.
</parameter_description>
</parameter>
<parameter name="tab_label">
-<parameter_description> the #GtkWidget to be used as the label for the page,
+<parameter_description> (allow-none): the #GtkWidget to be used as the label for the page,
or %NULL to use the default label, 'page N'.
</parameter_description>
</parameter>
@@ -61990,7 +64122,7 @@ See #GtkScrolledWindow, #GtkScrollbar, #GtkAdjustment for details.
</parameter_description>
</parameter>
<parameter name="adjustment">
-<parameter_description> new scroll adjustment
+<parameter_description> (allow-none): new scroll adjustment
</parameter_description>
</parameter>
</parameters>
@@ -62467,7 +64599,7 @@ Return value: A %NULL-terminated string array containing
</parameter>
</parameters>
<return> A %NULL-terminated string array containing
-the authors. The array is owned by the about dialog
+the authors. The array is owned by the about dialog
and must not be modified.
Since: 2.6
@@ -62589,7 +64721,7 @@ will be updated appropriately.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> (type int): a stock icon size
</parameter_description>
</parameter>
</parameters>
@@ -62623,7 +64755,21 @@ considers @widget to be an ancestor of itself.
</parameter_description>
</parameter>
</parameters>
-<return> the ancestor widget, or %NULL if not found
+<return> (transfer none): the ancestor widget, or %NULL if not found
+</return>
+</function>
+
+<function name="gtk_tool_palette_get_drag_target_item">
+<description>
+Gets the target entry for a dragged #GtkToolItem.
+
+
+</description>
+<parameters>
+</parameters>
+<return> the #GtkTargetEntry for a dragged item.
+
+Since: 2.20
</return>
</function>
@@ -62763,9 +64909,8 @@ overflow menu item for @tool_item has changed. If the
overflow menu is visible when this function it called,
the menu will be rebuilt.
-The function must be called when the tool item
-changes what it will do in response to the "create_menu_proxy"
-signal.
+The function must be called when the tool item changes what it
+will do in response to the #GtkToolItem::create-menu-proxy signal.
Since: 2.6
@@ -62832,26 +64977,14 @@ Since: 2.4
<return></return>
</function>
-<function name="gtk_widget_error_bell">
+<function name="gtk_printer_backend_load_modules">
<description>
-Notifies the user about an input-related error on this widget.
-If the #GtkSettings:gtk-error-bell setting is %TRUE, it calls
-gdk_window_beep(), otherwise it does nothing.
-
-Note that the effect of gdk_window_beep() can be configured in many
-ways, depending on the windowing backend and the desktop environment
-or window manager that is used.
-
-Since: 2.12
</description>
<parameters>
-<parameter name="widget">
-<parameter_description> a #GtkWidget
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> (element-type GtkPrintBackend) (transfer container):
+</return>
</function>
<function name="gtk_scrolled_window_get_hscrollbar">
@@ -62979,7 +65112,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="icon_widget">
-<parameter_description> the widget used as icon, or %NULL
+<parameter_description> (allow-none): the widget used as icon, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -63042,7 +65175,7 @@ Copies a stock item, mostly useful for language bindings and not in applications
<function name="gtk_text_iter_get_buffer">
<description>
-Return value: the buffer
+Return value: (transfer none): the buffer
</description>
<parameters>
@@ -63051,7 +65184,7 @@ Return value: the buffer
</parameter_description>
</parameter>
</parameters>
-<return> the buffer
+<return> (transfer none): the buffer
</return>
</function>
@@ -63285,7 +65418,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="default_page_setup">
-<parameter_description> a #GtkPageSetup, or %NULL
+<parameter_description> (allow-none): a #GtkPageSetup, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -63386,7 +65519,7 @@ Get the #GtkTextTagTable associated with this buffer.
</parameter_description>
</parameter>
</parameters>
-<return> the buffer's tag table
+<return> (transfer none): the buffer's tag table
</return>
</function>
@@ -63650,16 +65783,16 @@ given style.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="x">
@@ -63780,11 +65913,12 @@ timeouts, etc, may be dispatched during the wait.
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated %NULL-terminated array of strings which must
+<return> (array zero-terminated=1) (element-type utf8) (transfer full): a newly-allocated
+%NULL-terminated array of strings which must
be freed with g_strfreev(), or %NULL if
-retrieving the selection data failed. (This
-could happen for various reasons, in particular
-if the clipboard was empty or if the contents of
+retrieving the selection data failed. (This
+could happen for various reasons, in particular
+if the clipboard was empty or if the contents of
the clipboard could not be converted into URI form.)
Since: 2.14
@@ -63852,7 +65986,7 @@ gtk_container_set_focus_vadjustment().
</parameter_description>
</parameter>
</parameters>
-<return> the vertical focus adjustment, or %NULL if
+<return> (transfer none): the vertical focus adjustment, or %NULL if
none has been set.
</return>
</function>
@@ -64115,7 +66249,7 @@ Since: 2.4
<function name="gtk_ui_manager_get_accel_group">
<description>
-Return value: the #GtkAccelGroup.
+Return value: (transfer none): the #GtkAccelGroup.
</description>
<parameters>
@@ -64124,7 +66258,7 @@ Return value: the #GtkAccelGroup.
</parameter_description>
</parameter>
</parameters>
-<return> the #GtkAccelGroup.
+<return> (transfer none): the #GtkAccelGroup.
Since: 2.4
</return>
@@ -64132,8 +66266,8 @@ Since: 2.4
<function name="gtk_init_check">
<description>
-This function does the same work as gtk_init() with only
-a single change: It does not terminate the program if the GUI can't be
+This function does the same work as gtk_init() with only
+a single change: It does not terminate the program if the GUI can't be
initialized. Instead it returns %FALSE on failure.
This way the application can fall back to some other means of communication
@@ -64143,12 +66277,12 @@ with the user - for example a curses or command line interface.
</description>
<parameters>
<parameter name="argc">
-<parameter_description> Address of the <parameter>argc</parameter> parameter of your
+<parameter_description> (inout): Address of the <parameter>argc</parameter> parameter of your
main() function. Changed if any arguments were handled.
</parameter_description>
</parameter>
<parameter name="argv">
-<parameter_description> Address of the <parameter>argv</parameter> parameter of main().
+<parameter_description> (array length=argc) (inout) (allow-none): Address of the <parameter>argv</parameter> parameter of main().
Any parameters understood by gtk_init() are stripped before return.
</parameter_description>
</parameter>
@@ -64160,12 +66294,12 @@ Any parameters understood by gtk_init() are stripped before return.
<function name="gtk_widget_get_default_style">
<description>
-Returns: the default style. This #GtkStyle object is owned
+Returns: (transfer none): the default style. This #GtkStyle object is owned
</description>
<parameters>
</parameters>
-<return> the default style. This #GtkStyle object is owned
+<return> (transfer none): the default style. This #GtkStyle object is owned
by GTK+ and should not be modified or freed.
</return>
</function>
@@ -64269,7 +66403,7 @@ to load files.
<return> a new #GtkFileChooserDialog
Since: 2.4
-Deprecated: 2.14
+Deprecated: 2.14: Use gtk_file_chooser_dialog_new() instead.
</return>
</function>
@@ -64359,7 +66493,7 @@ hierarchy of icon themes
</parameter_description>
</parameter>
</parameters>
-<return> a #GList list holding the names of all the
+<return> (element-type utf8) (transfer full): a #GList list holding the names of all the
contexts in the theme. You must first free each element
in the list with g_free(), then free the list itself
with g_list_free().
@@ -64391,16 +66525,16 @@ Draws a flat box on @window with the given parameters.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="x">
@@ -64469,16 +66603,18 @@ Since: 2.12
</return>
</function>
-<function name="_gtk_file_system_model_remove_editable">
+<function name="gtk_entry_unset_invisible_char">
<description>
-Removes the "empty" row at the beginning of the model that was
-created with _gtk_file_system_model_add_editable(). You should call
-this function when your code is finished editing this temporary row.
+Unsets the invisible char previously set with
+gtk_entry_set_invisible_char(). So that the
+default invisible char is used again.
+
+Since: 2.16
</description>
<parameters>
-<parameter name="model">
-<parameter_description> a #GtkFileSystemModel
+<parameter name="entry">
+<parameter_description> a #GtkEntry
</parameter_description>
</parameter>
</parameters>
@@ -64936,7 +67072,7 @@ Sets the way @child is packed into @box.
<function name="gtk_image_set_from_pixbuf">
<description>
-See gtk_image_new_from_pixbuf() for details.
+See gtk_image_new_from_pixbuf() for details.
</description>
<parameters>
@@ -64945,27 +67081,24 @@ See gtk_image_new_from_pixbuf() for details.
</parameter_description>
</parameter>
<parameter name="pixbuf">
-<parameter_description> a #GdkPixbuf or %NULL
+<parameter_description> (allow-none): a #GdkPixbuf or %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="gtk_drag_dest_set_target_list">
+<function name="gtk_tool_palette_unset_icon_size">
<description>
-Sets the target types that this widget can accept from drag-and-drop.
-The widget must first be made into a drag destination with
-gtk_drag_dest_set().
+Unsets the tool palette icon size set with gtk_tool_palette_set_icon_size(),
+so that user preferences will be used to determine the icon size.
+
+Since: 2.20
</description>
<parameters>
-<parameter name="widget">
-<parameter_description> a #GtkWidget that's a drag destination
-</parameter_description>
-</parameter>
-<parameter name="target_list">
-<parameter_description> list of droppable targets, or %NULL for none
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
</parameter_description>
</parameter>
</parameters>
@@ -64986,7 +67119,7 @@ See #GtkScrolledWindow, #GtkScrollbar, #GtkAdjustment for details.
</parameter_description>
</parameter>
<parameter name="adjustment">
-<parameter_description> new scroll adjustment
+<parameter_description> (allow-none): new scroll adjustment
</parameter_description>
</parameter>
</parameters>
@@ -64995,7 +67128,7 @@ See #GtkScrolledWindow, #GtkScrollbar, #GtkAdjustment for details.
<function name="gtk_widget_modify_fg">
<description>
-Sets the foreground color for a widget in a particular state.
+Sets the foreground color for a widget in a particular state.
All other style values are left untouched. See also
gtk_widget_modify_style().
@@ -65010,7 +67143,7 @@ gtk_widget_modify_style().
</parameter_description>
</parameter>
<parameter name="color">
-<parameter_description> the color to assign (does not need to be allocated),
+<parameter_description> (allow-none): the color to assign (does not need to be allocated),
or %NULL to undo the effect of previous calls to
of gtk_widget_modify_fg().
</parameter_description>
@@ -65059,7 +67192,7 @@ the image will be displayed or not.
</parameter_description>
</parameter>
<parameter name="image">
-<parameter_description> a widget to set as the image for the menu item.
+<parameter_description> (allow-none): a widget to set as the image for the menu item.
</parameter_description>
</parameter>
</parameters>
@@ -65078,11 +67211,11 @@ image or mask; you still need to unref them if you own references.
</description>
<parameters>
<parameter name="image">
-<parameter_description> a #GdkImage, or %NULL
+<parameter_description> (allow-none): a #GdkImage, or %NULL
</parameter_description>
</parameter>
<parameter name="mask">
-<parameter_description> a #GdkBitmap, or %NULL
+<parameter_description> (allow-none): a #GdkBitmap, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -65090,20 +67223,17 @@ image or mask; you still need to unref them if you own references.
</return>
</function>
-<function name="gtk_accel_map_load">
+<function name="gtk_cell_renderer_spinner_new">
<description>
-Parses a file previously saved with gtk_accel_map_save() for
-accelerator specifications, and propagates them accordingly.
+Return value: a new #GtkCellRenderer
</description>
<parameters>
-<parameter name="file_name">
-<parameter_description> a file containing accelerator specifications,
-in the GLib file name encoding
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> a new #GtkCellRenderer
+
+Since: 2.20
+</return>
</function>
<function name="gtk_window_new">
@@ -65482,7 +67612,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="license">
-<parameter_description> the license information or %NULL
+<parameter_description> (allow-none): the license information or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -65652,7 +67782,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="label">
-<parameter_description> a string that will be used as label, or %NULL.
+<parameter_description> (allow-none): a string that will be used as label, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -65707,7 +67837,7 @@ g_intern_static_string().
</parameter_description>
</parameter>
<parameter name="accel_path">
-<parameter_description> accelerator path, corresponding to this menu item's
+<parameter_description> (allow-none): accelerator path, corresponding to this menu item's
functionality, or %NULL to unset the current path.
</parameter_description>
</parameter>
@@ -66182,6 +68312,19 @@ Updates the position of a child, as for gtk_text_view_add_child_in_window().
<return></return>
</function>
+<function name="gtk_ctree_node_set_pixtext">
+<description>
+
+</description>
+<parameters>
+<parameter name="mask">
+<parameter_description> (allow-none):
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_info_bar_get_action_area">
<description>
Returns: the action area.
@@ -66219,34 +68362,27 @@ Since: 2.4
<return></return>
</function>
-<function name="gtk_window_set_default">
+<function name="gtk_tool_palette_get_vadjustment">
<description>
-The default widget is the widget that's activated when the user
-presses Enter in a dialog (for example). This function sets or
-unsets the default widget for a #GtkWindow about. When setting
-(rather than unsetting) the default widget it's generally easier to
-call gtk_widget_grab_focus() on the widget. Before making a widget
-the default widget, you must set the #GTK_CAN_DEFAULT flag on the
-widget you'd like to make the default using GTK_WIDGET_SET_FLAGS().
+Gets the vertical adjustment of the tool palette.
+
</description>
<parameters>
-<parameter name="window">
-<parameter_description> a #GtkWindow
-</parameter_description>
-</parameter>
-<parameter name="default_widget">
-<parameter_description> widget to be the default, or %NULL to unset the
-default widget for the toplevel.
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the vertical adjustment of @palette
+
+Since: 2.20
+</return>
</function>
<function name="gtk_dialog_get_action_area">
<description>
-Returns: the action area.
+Returns: (transfer none): the action area.
</description>
<parameters>
@@ -66255,7 +68391,7 @@ Returns: the action area.
</parameter_description>
</parameter>
</parameters>
-<return> the action area.
+<return> (transfer none): the action area.
Since: 2.14
</return>
@@ -66312,11 +68448,13 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="gicon">
-<parameter_description> place to store a #GIcon, or %NULL
+<parameter_description> (out) (transfer none) (allow-none): place to store a
+#GIcon, or %NULL
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> place to store an icon size, or %NULL
+<parameter_description> (out) (allow-none) (type int): place to store an icon size,
+or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -66342,7 +68480,7 @@ and you should free those resources when the widget is unrealized.
</parameter_description>
</parameter>
</parameters>
-<return> the #GdkWindow root window for the toplevel for this widget.
+<return> (transfer none): the #GdkWindow root window for the toplevel for this widget.
Since: 2.2
</return>
@@ -66361,7 +68499,7 @@ as defined in the page setup dialog
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated list of newly
+<return> (element-type GtkPaperSize) (transfer full): a newly allocated list of newly
allocated #GtkPaperSize objects
Since: 2.12
@@ -66383,7 +68521,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="stock_id">
-<parameter_description> a name of a stock item, or %NULL
+<parameter_description> (allow-none): a name of a stock item, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -66503,7 +68641,7 @@ Since: 2.10
<function name="gtk_tree_view_set_model">
<description>
Sets the model for a #GtkTreeView. If the @tree_view already has a model
-set, it will remove it before setting the new model. If @model is %NULL,
+set, it will remove it before setting the new model. If @model is %NULL,
then it will unset the old model.
</description>
@@ -66513,7 +68651,7 @@ then it will unset the old model.
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> The model.
+<parameter_description> (allow-none): The model.
</parameter_description>
</parameter>
</parameters>
@@ -66723,6 +68861,19 @@ of the #GtkTreeView
</return>
</function>
+<function name="gtk_ctree_node_set_pixmap">
+<description>
+
+</description>
+<parameters>
+<parameter name="mask">
+<parameter_description> (allow-none):
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_text_iter_forward_word_end">
<description>
Moves forward to the next word end. (If @iter is currently on a
@@ -66798,24 +68949,28 @@ Since: 2.16
<return></return>
</function>
-<function name="gtk_recent_info_get_visited">
+<function name="gtk_tool_palette_set_expand">
<description>
-Gets the timestamp (seconds from system's Epoch) when the resource
-was last visited.
+Sets whether the group should be given extra space.
+Since: 2.20
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GtkRecentInfo
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
+</parameter_description>
+</parameter>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup which is a child of palette
+</parameter_description>
+</parameter>
+<parameter name="expand">
+<parameter_description> whether the group should be given extra space
</parameter_description>
</parameter>
</parameters>
-<return> the number of seconds elapsed from system's Epoch when
-the resource was last visited, or -1 on failure.
-
-Since: 2.10
-</return>
+<return></return>
</function>
<function name="gtk_drag_source_add_uri_targets">
@@ -66840,7 +68995,7 @@ Since: 2.6
<function name="gtk_dialog_get_content_area">
<description>
-Returns: the content area #GtkVBox.
+Returns: (transfer none): the content area #GtkVBox.
</description>
<parameters>
@@ -66849,7 +69004,7 @@ Returns: the content area #GtkVBox.
</parameter_description>
</parameter>
</parameters>
-<return> the content area #GtkVBox.
+<return> (transfer none): the content area #GtkVBox.
Since: 2.14
</return>
@@ -66867,9 +69022,10 @@ Gets the contents of the selection data as array of URIs.
</parameter_description>
</parameter>
</parameters>
-<return> if the selection data contains a list of
+<return> (array zero-terminated=1) (element-type utf8) (transfer full): if
+the selection data contains a list of
URIs, a newly allocated %NULL-terminated string array
-containing the URIs, otherwise %NULL. If the result is
+containing the URIs, otherwise %NULL. If the result is
non-%NULL it must be freed with g_strfreev().
Since: 2.6
@@ -66891,7 +69047,7 @@ gtk_file_chooser_get_uris())
</parameter_description>
</parameter>
</parameters>
-<return> a #GSList containing the filenames of all selected
+<return> (element-type utf8) (transfer full): a #GSList containing the filenames of all selected
files and subfolders in the current folder. Free the returned list
with g_slist_free(), and the filenames with g_free().
@@ -66902,8 +69058,9 @@ Since: 2.4
<function name="gtk_print_settings_new_from_file">
<description>
Reads the print settings from @file_name. Returns a new #GtkPrintSettings
-object with the restored settings, or %NULL if an error occurred.
-See gtk_print_settings_to_file().
+object with the restored settings, or %NULL if an error occurred. If the
+file could not be loaded then error is set to either a #GFileError or
+#GKeyFileError. See gtk_print_settings_to_file().
</description>
@@ -66963,7 +69120,7 @@ much as the window manager would have done on X.
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> parent window
+<parameter_description> (allow-none): parent window
</parameter_description>
</parameter>
</parameters>
@@ -66972,7 +69129,7 @@ much as the window manager would have done on X.
<function name="gtk_status_icon_set_from_pixbuf">
<description>
-Makes @status_icon display @pixbuf.
+Makes @status_icon display @pixbuf.
See gtk_status_icon_new_from_pixbuf() for details.
Since: 2.10
@@ -66984,7 +69141,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="pixbuf">
-<parameter_description> a #GdkPixbuf or %NULL
+<parameter_description> (allow-none): a #GdkPixbuf or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -67211,6 +69368,33 @@ default.
</return>
</function>
+<function name="gtk_tool_palette_get_drop_group">
+<description>
+Gets the group at position (x, y).
+
+
+</description>
+<parameters>
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> the x position
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> the y position
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GtkToolItemGroup at position or %NULL
+if there is no such group
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_dialog_new_with_buttons">
<description>
Creates a new #GtkDialog with title @title (or %NULL for the default
@@ -67248,11 +69432,11 @@ NULL);
</description>
<parameters>
<parameter name="title">
-<parameter_description> Title of the dialog, or %NULL
+<parameter_description> (allow-none): Title of the dialog, or %NULL
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> Transient parent of the dialog, or %NULL
+<parameter_description> (allow-none): Transient parent of the dialog, or %NULL
</parameter_description>
</parameter>
<parameter name="flags">
@@ -67260,7 +69444,7 @@ NULL);
</parameter_description>
</parameter>
<parameter name="first_button_text">
-<parameter_description> stock ID or text to go in first button, or %NULL
+<parameter_description> (allow-none): stock ID or text to go in first button, or %NULL
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -67450,7 +69634,7 @@ which set of user preferences to used.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> an icon size
+<parameter_description> (type int): an icon size
</parameter_description>
</parameter>
<parameter name="width">
@@ -67698,7 +69882,7 @@ e.g. for #GtkTreeView, a string representation of #GtkTreePath
<function name="gtk_widget_get_parent">
<description>
-Return value: the parent container of @widget, or %NULL
+Return value: (transfer none): the parent container of @widget, or %NULL
</description>
<parameters>
@@ -67707,7 +69891,7 @@ Return value: the parent container of @widget, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the parent container of @widget, or %NULL
+<return> (transfer none): the parent container of @widget, or %NULL
</return>
</function>
@@ -67776,26 +69960,23 @@ Deprecated: 2.2: Use gtk_widget_set_size_request() instead.
<return></return>
</function>
-<function name="gtk_custom_paper_unix_dialog_new">
+<function name="gtk_spin_button_set_wrap">
<description>
-Creates a new custom paper dialog.
-
+Sets the flag that determines if a spin button value wraps around to the
+opposite limit when the upper or lower limit of the range is exceeded.
</description>
<parameters>
-<parameter name="title">
-<parameter_description> the title of the dialog, or %NULL
+<parameter name="spin_button">
+<parameter_description> a #GtkSpinButton
</parameter_description>
</parameter>
-<parameter name="parent">
-<parameter_description> transient parent of the dialog, or %NULL
+<parameter name="wrap">
+<parameter_description> a flag indicating if wrapping behavior is performed.
</parameter_description>
</parameter>
</parameters>
-<return> the new #GtkCustomPaperUnixDialog
-
-Since: 2.18
-</return>
+<return></return>
</function>
<function name="gtk_border_copy">
@@ -68162,6 +70343,42 @@ Since: 2.10
</return>
</function>
+<function name="gtk_tool_palette_add_drag_dest">
+<description>
+Sets @palette as drag source (see gtk_tool_palette_set_drag_source())
+and sets @widget as a drag destination for drags from @palette.
+See gtk_drag_dest_set().
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="palette">
+<parameter_description> a #GtkToolPalette
+</parameter_description>
+</parameter>
+<parameter name="widget">
+<parameter_description> a #GtkWidget which should be a drag destination for @palette
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> the flags that specify what actions GTK+ should take for drops
+on that widget
+</parameter_description>
+</parameter>
+<parameter name="targets">
+<parameter_description> the #GtkToolPaletteDragTarget<!-- -->s which the widget
+should support
+</parameter_description>
+</parameter>
+<parameter name="actions">
+<parameter_description> the #GdkDragAction<!-- -->s which the widget should suppport
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_print_settings_get_collate">
<description>
Gets the value of %GTK_PRINT_SETTINGS_COLLATE.
@@ -68426,16 +70643,16 @@ Deprecated: 2.0: Use gtk_paint_layout() instead.
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail
</parameter_description>
</parameter>
<parameter name="x">
@@ -68532,6 +70749,18 @@ Since: 2.4
<return></return>
</function>
+<function name="GtkSpinner">
+<description>
+The duration in milliseconds for the spinner to complete a full cycle.
+
+Since: 2.20
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_tree_sortable_sort_column_changed">
<description>
Emits a #GtkTreeSortable::sort-column-changed signal on @sortable.
@@ -68680,7 +70909,7 @@ widget
<function name="gtk_init">
<description>
Call this function before using any other GTK+ functions in your GUI
-applications. It will initialize everything needed to operate the
+applications. It will initialize everything needed to operate the
toolkit and parses some standard command line options. @argc and
@argv are adjusted accordingly so your own code will
never see those standard arguments.
@@ -68697,15 +70926,24 @@ the GUI for some reason. If you want your program to fall back to a
textual interface you want to call gtk_init_check() instead.
</para></note>
+<note><para>
+Since 2.18, GTK+ calls <literal>signal (SIGPIPE, SIG_IGN)</literal>
+during initialization, to ignore SIGPIPE signals, since these are
+almost never wanted in graphical applications. If you do need to
+handle SIGPIPE for some reason, reset the handler after gtk_init(),
+but notice that other libraries (e.g. libdbus or gvfs) might do
+similar things.
+</para></note>
+
</description>
<parameters>
<parameter name="argc">
-<parameter_description> Address of the <parameter>argc</parameter> parameter of your
+<parameter_description> (inout): Address of the <parameter>argc</parameter> parameter of your
main() function. Changed if any arguments were handled.
</parameter_description>
</parameter>
<parameter name="argv">
-<parameter_description> Address of the <parameter>argv</parameter> parameter of main().
+<parameter_description> (array length=argc) (inout) (allow-none): Address of the <parameter>argv</parameter> parameter of main().
Any parameters understood by gtk_init() are stripped before return.
</parameter_description>
</parameter>
@@ -69103,7 +71341,7 @@ to use as a base image when creating icon variants for #GtkIconSet.
</parameter_description>
</parameter>
<parameter name="icon_name">
-<parameter_description> name of icon to use
+<parameter_description> (allow-none): name of icon to use
</parameter_description>
</parameter>
</parameters>
@@ -69142,44 +71380,19 @@ widget
<return></return>
</function>
-<function name="gtk_im_context_get_surrounding">
+<function name="gtk_editable_delete_selection">
<description>
-Retrieves context around the insertion point. Input methods
-typically want context in order to constrain input text based on
-existing text; this is important for languages such as Thai where
-only some sequences of characters are allowed.
-
-This function is implemented by emitting the
-GtkIMContext::retrieve_surrounding signal on the input method; in
-response to this signal, a widget should provide as much context as
-is available, up to an entire paragraph, by calling
-gtk_im_context_set_surrounding(). Note that there is no obligation
-for a widget to respond to the ::retrieve_surrounding signal, so input
-methods must be prepared to function without context.
-
+Deletes the currently selected text of the editable.
+This call doesn't do anything if there is no selected text.
</description>
<parameters>
-<parameter name="context">
-<parameter_description> a #GtkIMContext
-</parameter_description>
-</parameter>
-<parameter name="text">
-<parameter_description> location to store a UTF-8 encoded string of text
-holding context around the insertion point.
-If the function returns %TRUE, then you must free
-the result stored in this location with g_free().
-</parameter_description>
-</parameter>
-<parameter name="cursor_index">
-<parameter_description> location to store byte index of the insertion cursor
-within @text.
+<parameter name="editable">
+<parameter_description> a #GtkEditable
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if surrounding text was provided; in this case
-you must free the result stored in *text.
-</return>
+<return></return>
</function>
<function name="gtk_text_iter_backward_cursor_positions">
@@ -69220,7 +71433,7 @@ to a particular #GdkScreen.
</parameter_description>
</parameter>
</parameters>
-<return> the relevant #GtkSettings object
+<return> (transfer none): the relevant #GtkSettings object
</return>
</function>
@@ -69236,7 +71449,8 @@ Gets the #GtkRecentFilter objects held by @chooser.
</parameter_description>
</parameter>
</parameters>
-<return> A singly linked list of #GtkRecentFilter objects. You
+<return> (element-type GtkRecentFilter) (transfer container): A singly linked list
+of #GtkRecentFilter objects. You
should just free the returned list using g_slist_free().
Since: 2.10
@@ -69393,7 +71607,7 @@ gtk_widget_grab_focus() instead of this function.
</parameter_description>
</parameter>
<parameter name="focus">
-<parameter_description> widget to be the new focus widget, or %NULL to unset
+<parameter_description> (allow-none): widget to be the new focus widget, or %NULL to unset
any focus widget for the toplevel window.
</parameter_description>
</parameter>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
