[gtkmm] Update *_docs.xml files, used to generate documentation.
- From: Murray Cumming <murrayc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtkmm] Update *_docs.xml files, used to generate documentation.
- Date: Mon, 23 Jun 2014 11:20:09 +0000 (UTC)
commit 2bdf76f54f95743161c819c69d05482f235e5969
Author: Murray Cumming <murrayc murrayc com>
Date: Mon Jun 23 12:23:29 2014 +0200
Update *_docs.xml files, used to generate documentation.
gdk/src/gdk_docs.xml | 340 ++++---
gtk/src/gtk_docs.xml | 2765 ++++++++++++++++++++++++++++++++++++++++++++------
2 files changed, 2667 insertions(+), 438 deletions(-)
---
diff --git a/gdk/src/gdk_docs.xml b/gdk/src/gdk_docs.xml
index ff4e481..667d027 100644
--- a/gdk/src/gdk_docs.xml
+++ b/gdk/src/gdk_docs.xml
@@ -67,7 +67,7 @@ in memory as 0x00, 0xff, 0xee, 0xcc.
<enum name="GdkColorspace">
<description>
This enumeration defines the color spaces that are supported by
-the &gdk-pixbuf; library. Currently only RGB is supported.
+the gdk-pixbuf library. Currently only RGB is supported.
</description>
<parameters>
@@ -1542,13 +1542,12 @@ menu accelerators.
<parameter name="GDK_MODIFIER_INTENT_CONTEXT_MENU">
<parameter_description> the modifier used to invoke context menus.
Note that mouse button 3 always triggers context menus. When this modifier
-is not 0, it <strong>additionally</strong> triggers context menus when used
-with mouse button 1.
+is not 0, it additionally triggers context menus when used with mouse button 1.
</parameter_description>
</parameter>
<parameter name="GDK_MODIFIER_INTENT_EXTEND_SELECTION">
<parameter_description> the modifier used to extend selections
-using <modifier>-click or <modifier>-cursor-key
+using `modifier`-click or `modifier`-cursor-key
</parameter_description>
</parameter>
<parameter name="GDK_MODIFIER_INTENT_MODIFY_SELECTION">
@@ -1822,7 +1821,7 @@ In the future it will do full alpha compositing.
<enum name="GdkPixbufError">
<description>
-An error code in the #GDK_PIXBUF_ERROR domain. Many &gdk-pixbuf;
+An error code in the #GDK_PIXBUF_ERROR domain. Many gdk-pixbuf
operations can cause errors in this domain, or in the #G_FILE_ERROR
domain.
@@ -1874,7 +1873,7 @@ Since: 2.2
</parameter_description>
</parameter>
<parameter name="GDK_PIXBUF_FORMAT_THREADSAFE">
-<parameter_description> the module is threadsafe. &gdk-pixbuf;
+<parameter_description> the module is threadsafe. gdk-pixbuf
ignores modules that are not marked as threadsafe. (Since 2.28).
</parameter_description>
</parameter>
@@ -2485,8 +2484,8 @@ Since: 2.18
</parameter_description>
</parameter>
</parameters>
-<return> the #GdkWindow of the embedded child at
- x, @y, or %NULL
+<return> the #GdkWindow of the
+embedded child at @x, @y, or %NULL
</return>
</signal>
@@ -3118,6 +3117,11 @@ Creates a Cairo context for drawing to @window.
Note that calling cairo_reset_clip() on the resulting #cairo_t will
produce undefined results, so avoid it at all costs.
+As of GTK+ 3.14, you need to wrap calls to this function with
+gdk_window_begin_paint_region() / gdk_window_begin_paint_rect() and
+gdk_window_end_paint(). Calling it outside of a "paint" will
+result in a warning printed and a dummy surface being returned.
+
Since: 2.8
</description>
@@ -3357,6 +3361,7 @@ Makes a copy of a #GdkColor.
The result must be freed using gdk_color_free().
+Deprecated: 3.14: Use #GdkRGBA
</description>
<parameters>
@@ -3366,6 +3371,7 @@ The result must be freed using gdk_color_free().
</parameter>
</parameters>
<return> a copy of @color
+
</return>
</function>
@@ -3373,6 +3379,7 @@ The result must be freed using gdk_color_free().
<description>
Compares two colors.
+Deprecated: 3.14: Use #GdkRGBA
</description>
<parameters>
@@ -3386,6 +3393,7 @@ Compares two colors.
</parameter>
</parameters>
<return> %TRUE if the two colors compare equal
+
</return>
</function>
@@ -3393,6 +3401,8 @@ Compares two colors.
<description>
Frees a #GdkColor created with gdk_color_copy().
+Deprecated: 3.14: Use #GdkRGBA
+
</description>
<parameters>
<parameter name="color">
@@ -3408,6 +3418,7 @@ Frees a #GdkColor created with gdk_color_copy().
A hash function suitable for using for a hash
table that stores #GdkColors.
+Deprecated: 3.14: Use #GdkRGBA
</description>
<parameters>
@@ -3417,6 +3428,7 @@ table that stores #GdkColors.
</parameter>
</parameters>
<return> The hash function applied to @color
+
</return>
</function>
@@ -3433,6 +3445,7 @@ the red, green, and blue components of the color, respectively.
(White in the four forms is “\#fff”, “\#ffffff”, “\#fffffffff”
and “\#ffffffffffff”).
+Deprecated: 3.14: Use #GdkRGBA
</description>
<parameters>
@@ -3446,19 +3459,22 @@ and “\#ffffffffffff”).
</parameter>
</parameters>
<return> %TRUE if the parsing succeeded
+
</return>
</function>
<function name="gdk_color_to_string">
<description>
Returns a textual specification of @color in the hexadecimal
-form `\#rrrrggggbbbb`, where `r`, `g` and `b` are hex digits
+form “\#rrrrggggbbbb” where “r”, “g” and “b” are hex digits
representing the red, green and blue components respectively.
The returned string can be parsed by gdk_color_parse().
Since: 2.12
+Deprecated: 3.14: Use #GdkRGBA
+
</description>
<parameters>
<parameter name="color">
@@ -3524,7 +3540,8 @@ Since: 2.8
</parameter_description>
</parameter>
</parameters>
-<return> a #GdkPixbuf representing @cursor, or %NULL
+<return> a #GdkPixbuf representing
+ cursor, or %NULL
</return>
</function>
@@ -3546,15 +3563,18 @@ Since: 3.10
</parameter_description>
</parameter>
<parameter name="x_hot">
-<parameter_description> Location to store the hotspot x position, or %NULL
+<parameter_description> Location to store the hotspot x position,
+or %NULL
</parameter_description>
</parameter>
<parameter name="y_hot">
-<parameter_description> Location to store the hotspot y position, or %NULL
+<parameter_description> Location to store the hotspot y position,
+or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #cairo_surface_t representing @cursor, or %NULL
+<return> a #cairo_surface_t
+representing @cursor, or %NULL
</return>
</function>
@@ -3637,8 +3657,8 @@ Since: 2.8
</parameter_description>
</parameter>
</parameters>
-<return> a new #GdkCursor, or %NULL if there is no cursor with
-the given name
+<return> a new #GdkCursor, or %NULL if there is no
+cursor with the given name
</return>
</function>
@@ -3806,7 +3826,8 @@ Since: 3.0
</parameter_description>
</parameter>
</parameters>
-<return> The associated device, or %NULL
+<return> The associated device, or
+%NULL
</return>
</function>
@@ -3982,11 +4003,14 @@ system.
</parameter_description>
</parameter>
<parameter name="events">
-<parameter_description> location to store a newly-allocated array of #GdkTimeCoord, or %NULL
+<parameter_description>
+location to store a newly-allocated array of #GdkTimeCoord, or
+%NULL
</parameter_description>
</parameter>
<parameter name="n_events">
-<parameter_description> location to store the length of @events, or %NULL
+<parameter_description> location to store the length of
+ events, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -4220,8 +4244,8 @@ unless there is an ongoing grab on them. See gdk_device_grab().
</parameter_description>
</parameter>
<parameter name="axes">
-<parameter_description> an array of doubles to store the values of the axes of @device in,
-or %NULL.
+<parameter_description> an array of doubles to store the values of
+the axes of @device in, or %NULL.
</parameter_description>
</parameter>
<parameter name="mask">
@@ -4260,7 +4284,8 @@ relative to the window origin, or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> the #GdkWindow under the device position, or %NULL.
+<return> the #GdkWindow under the
+device position, or %NULL.
</return>
</function>
@@ -4294,7 +4319,8 @@ relative to the window origin, or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> the #GdkWindow under the device position, or %NULL.
+<return> the #GdkWindow under the
+device position, or %NULL.
</return>
</function>
@@ -4439,10 +4465,10 @@ the list of slave devices attached to it, otherwise it will return
</parameter_description>
</parameter>
</parameters>
-<return> the list of
-slave devices, or %NULL. The list must be freed with
-g_list_free(), the contents of the list are owned by GTK+
-and should not be freed.
+<return>
+the list of slave devices, or %NULL. The list must be
+freed with g_list_free(), the contents of the list are
+owned by GTK+ and should not be freed.
</return>
</function>
@@ -4483,9 +4509,9 @@ Since: 3.0
</parameter_description>
</parameter>
</parameters>
-<return> the #GdkDisplay to which @device_manager is
-associated to, or #NULL. This memory is owned by GDK and
-must not be freed or unreferenced.
+<return> the #GdkDisplay to which
+ device_manager is associated to, or #NULL. This memory is
+owned by GDK and must not be freed or unreferenced.
</return>
</function>
@@ -4772,8 +4798,8 @@ Since: 2.2
</description>
<parameters>
</parameters>
-<return> a #GdkDisplay, or %NULL if there is no default
-display.
+<return> a #GdkDisplay, or %NULL if
+there is no default display.
</return>
</function>
@@ -4848,8 +4874,9 @@ Since: 3.0
</parameter_description>
</parameter>
</parameters>
-<return> A #GdkDeviceManager, or %NULL. This memory is
-owned by GDK and must not be freed or unreferenced.
+<return> A #GdkDeviceManager, or
+%NULL. This memory is owned by GDK and must not be freed
+or unreferenced.
</return>
</function>
@@ -4868,8 +4895,9 @@ Since: 2.2
</parameter_description>
</parameter>
</parameters>
-<return> the next #GdkEvent to be processed, or %NULL if no events
-are pending. The returned #GdkEvent should be freed with gdk_event_free().
+<return> the next #GdkEvent to be processed, or %NULL
+if no events are pending. The returned #GdkEvent should be freed
+with gdk_event_free().
</return>
</function>
@@ -5023,7 +5051,8 @@ to the window origin, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the window under the mouse pointer, or %NULL
+<return> the window under the mouse
+pointer, or %NULL
</return>
</function>
@@ -5145,8 +5174,8 @@ Since: 2.2
</parameter_description>
</parameter>
</parameters>
-<return> a #GdkDisplay, or %NULL
-if there is no default display.
+<return> a #GdkDisplay, or %NULL if
+there is no default display.
</return>
</function>
@@ -5188,8 +5217,8 @@ Since: 3.0
</parameter_description>
</parameter>
</parameters>
-<return> a #GdkDisplay, or %NULL
-if the display could not be opened
+<return> a #GdkDisplay, or %NULL if the
+display could not be opened
</return>
</function>
@@ -5254,8 +5283,8 @@ Since: 2.2
</parameter_description>
</parameter>
</parameters>
-<return> a #GdkDisplay, or %NULL
-if the display could not be opened
+<return> a #GdkDisplay, or %NULL if the
+display could not be opened
</return>
</function>
@@ -5272,8 +5301,8 @@ function that should not be used by applications.
</description>
<parameters>
</parameters>
-<return> the default display, if it could be
-opened, otherwise %NULL.
+<return> the default display, if it
+could be opened, otherwise %NULL.
</return>
</function>
@@ -5293,9 +5322,9 @@ Since: 2.2
</parameter_description>
</parameter>
</parameters>
-<return> a copy of the first #GdkEvent on the event queue, or %NULL
-if no events are in the queue. The returned #GdkEvent should be freed with
-gdk_event_free().
+<return> a copy of the first #GdkEvent on the event
+queue, or %NULL if no events are in the queue. The returned
+#GdkEvent should be freed with gdk_event_free().
</return>
</function>
@@ -5754,7 +5783,7 @@ as list of #GdkAtoms
<function name="gdk_drag_context_get_actions">
<description>
Determines the bitmask of actions proposed by the source if
-gdk_drag_context_get_suggested_action() returns GDK_ACTION_ASK.
+gdk_drag_context_get_suggested_action() returns %GDK_ACTION_ASK.
Since: 2.22
@@ -6256,8 +6285,9 @@ See gdk_display_get_event().
</description>
<parameters>
</parameters>
-<return> the next #GdkEvent to be processed, or %NULL if no events
-are pending. The returned #GdkEvent should be freed with gdk_event_free().
+<return> the next #GdkEvent to be processed, or %NULL
+if no events are pending. The returned #GdkEvent should be freed
+with gdk_event_free().
</return>
</function>
@@ -6588,7 +6618,7 @@ as if the event had no state field.
</description>
<parameters>
<parameter name="event">
-<parameter_description> a #GdkEvent or NULL
+<parameter_description> a #GdkEvent or %NULL
</parameter_description>
</parameter>
<parameter name="state">
@@ -6691,9 +6721,9 @@ display, returns a copy of it. See gdk_display_peek_event().
</description>
<parameters>
</parameters>
-<return> a copy of the first #GdkEvent on some event queue, or %NULL if no
-events are in any queues. The returned #GdkEvent should be freed with
-gdk_event_free().
+<return> a copy of the first #GdkEvent on some event
+queue, or %NULL if no events are in any queues. The returned
+#GdkEvent should be freed with gdk_event_free().
</return>
</function>
@@ -7000,10 +7030,10 @@ Since: 3.8
</parameter_description>
</parameter>
</parameters>
-<return> the #GdkFrameTimings for the frame currently being
-processed, or even no frame is being processed, for the
-previous frame. Before any frames have been procesed,
-returns %NULL.
+<return> the #GdkFrameTimings for the frame currently
+being processed, or even no frame is being processed, for the
+previous frame. Before any frames have been procesed, returns
+%NULL.
</return>
</function>
@@ -7370,8 +7400,9 @@ Since: 2.2
</description>
<parameters>
</parameters>
-<return> the display name, if specified explicitly, otherwise %NULL
-this string is owned by GTK+ and must not be modified or freed.
+<return> the display name, if specified explicitly,
+otherwise %NULL this string is owned by GTK+ and must not be
+modified or freed.
</return>
</function>
@@ -8011,9 +8042,9 @@ but without the leading “GDK_KEY_”.
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the name of the key,
-or %NULL if @keyval is not a valid key. The string should not be
-modified.
+<return> a string containing the name
+of the key, or %NULL if @keyval is not a valid key. The string
+should not be modified.
</return>
</function>
@@ -8143,8 +8174,8 @@ Since: 2.18
</parameter_description>
</parameter>
</parameters>
-<return> the embedding #GdkWindow, or %NULL
-if @window is not an mbedded offscreen window
+<return> the embedding #GdkWindow, or
+%NULL if @window is not an mbedded offscreen window
</return>
</function>
@@ -8163,7 +8194,8 @@ add a reference to it.
</parameter_description>
</parameter>
</parameters>
-<return> The offscreen surface, or %NULL if not offscreen
+<return> The offscreen surface, or
+%NULL if not offscreen
</return>
</function>
@@ -9523,8 +9555,8 @@ The pixbuf will contain an alpha channel if the @surface contains one.
</parameter_description>
</parameter>
</parameters>
-<return> A newly-created pixbuf with a reference
-count of 1, or %NULL on error
+<return> A newly-created pixbuf with a
+reference count of 1, or %NULL on error
</return>
</function>
@@ -9580,8 +9612,8 @@ it returns %NULL; so check the return value.)
</parameter_description>
</parameter>
</parameters>
-<return> A newly-created pixbuf with a reference
-count of 1, or %NULL on error
+<return> A newly-created pixbuf with a
+reference count of 1, or %NULL on error
</return>
</function>
@@ -10014,14 +10046,14 @@ cannot parse the buffer.
<function name="gdk_pixbuf_major_version">
<description>
-The major version number of the &gdk-pixbuf; library. (e.g. in
-&gdk-pixbuf; version 1.2.5 this is 1.)
+The major version number of the gdk-pixbuf library. (e.g. in
+gdk-pixbuf version 1.2.5 this is 1.)
This variable is in the library, so represents the
-&gdk-pixbuf; library you have linked against. Contrast with the
+gdk-pixbuf library you have linked against. Contrast with the
#GDK_PIXBUF_MAJOR macro, which represents the major version of the
-&gdk-pixbuf; headers you have included.
+gdk-pixbuf headers you have included.
</description>
<parameters>
@@ -10031,14 +10063,14 @@ This variable is in the library, so represents the
<function name="gdk_pixbuf_micro_version">
<description>
-The micro version number of the &gdk-pixbuf; library. (e.g. in
-&gdk-pixbuf; version 1.2.5 this is 5.)
+The micro version number of the gdk-pixbuf library. (e.g. in
+gdk-pixbuf version 1.2.5 this is 5.)
This variable is in the library, so represents the
-&gdk-pixbuf; library you have linked against. Contrast with the
+gdk-pixbuf library you have linked against. Contrast with the
#GDK_PIXBUF_MICRO macro, which represents the micro version of the
-&gdk-pixbuf; headers you have included.
+gdk-pixbuf headers you have included.
</description>
<parameters>
@@ -10048,14 +10080,14 @@ This variable is in the library, so represents the
<function name="gdk_pixbuf_minor_version">
<description>
-The minor version number of the &gdk-pixbuf; library. (e.g. in
-&gdk-pixbuf; version 1.2.5 this is 2.)
+The minor version number of the gdk-pixbuf library. (e.g. in
+gdk-pixbuf version 1.2.5 this is 2.)
This variable is in the library, so represents the
-&gdk-pixbuf; library you have linked against. Contrast with the
+gdk-pixbuf library you have linked against. Contrast with the
#GDK_PIXBUF_MINOR macro, which represents the minor version of the
-&gdk-pixbuf; headers you have included.
+gdk-pixbuf headers you have included.
</description>
<parameters>
@@ -11394,7 +11426,7 @@ Deprecated: 2.0: Use g_object_unref().
<function name="gdk_pixbuf_version">
<description>
-Contains the full version of the &gdk-pixbuf; library as a string.
+Contains the full version of the gdk-pixbuf library as a string.
This is the version currently in use by a running program.
</description>
@@ -12051,7 +12083,8 @@ Since: 2.10
</parameter_description>
</parameter>
</parameters>
-<return> the currently active window, or %NULL.
+<return> the currently active window,
+or %NULL.
</return>
</function>
@@ -12066,7 +12099,8 @@ Since: 2.2
</description>
<parameters>
</parameters>
-<return> a #GdkScreen, or %NULL if there is no default display.
+<return> a #GdkScreen, or %NULL if
+there is no default display.
</return>
</function>
@@ -12102,8 +12136,8 @@ Since: 2.10
</parameter_description>
</parameter>
</parameters>
-<return> the current font options, or %NULL if no default
-font options have been set.
+<return> the current font options, or %NULL if no
+default font options have been set.
</return>
</function>
@@ -12270,8 +12304,8 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated string containing the name of the monitor,
-or %NULL if the name cannot be determined
+<return> a newly-allocated string containing the name
+of the monitor, or %NULL if the name cannot be determined
</return>
</function>
@@ -12465,8 +12499,9 @@ Since: 2.8
</parameter_description>
</parameter>
</parameters>
-<return> a visual to use for windows with an
-alpha channel or %NULL if the capability is not available.
+<return> a visual to use for windows
+with an alpha channel or %NULL if the capability is not
+available.
</return>
</function>
@@ -12628,9 +12663,8 @@ Since: 2.10
</parameter_description>
</parameter>
</parameters>
-<return>
-a list of #GdkWindows for the current window stack,
-or %NULL.
+<return> a
+list of #GdkWindows for the current window stack, or %NULL.
</return>
</function>
@@ -12846,14 +12880,12 @@ Determines the owner of the given selection.
</parameter_description>
</parameter>
</parameters>
-<return> if there is a selection owner for
-this window, and it is a window known to the current
-process, the #GdkWindow that owns the selection, otherwise
-%NULL. Note that the return value may be owned
-by a different process if a foreign window
-was previously created for that window, but
-a new foreign window will never be created by
-this call.
+<return> if there is a selection owner
+for this window, and it is a window known to the current process,
+the #GdkWindow that owns the selection, otherwise %NULL. Note
+that the return value may be owned by a different process if a
+foreign window was previously created for that window, but a new
+foreign window will never be created by this call.
</return>
</function>
@@ -12878,9 +12910,10 @@ Since: 2.2
</parameter_description>
</parameter>
</parameters>
-<return> if there is a selection owner for this window,
-and it is a window known to the current process, the #GdkWindow that
-owns the selection, otherwise %NULL.
+<return> if there is a selection owner
+for this window, and it is a window known to the current
+process, the #GdkWindow that owns the selection, otherwise
+%NULL.
</return>
</function>
@@ -13738,9 +13771,9 @@ is not specified; it may be as pseudo-escape sequences
</parameter>
</parameters>
<return> the newly-allocated string, or %NULL if the
-conversion failed. (It should not fail for
-any properly formed UTF-8 string unless system
-limits like memory or file descriptors are exceeded.)
+conversion failed. (It should not fail for any properly
+formed UTF-8 string unless system limits like memory or
+file descriptors are exceeded.)
</return>
</function>
@@ -13800,8 +13833,8 @@ gdk_visual_get_best_with_type().
</parameter_description>
</parameter>
</parameters>
-<return> best visual with both @depth and
- visual_type, or %NULL if none
+<return> best visual with both @depth
+and @visual_type, or %NULL if none
</return>
</function>
@@ -14520,9 +14553,7 @@ expose event handler, you can assume that the exposed area in
#GdkEventExpose has already been cleared to the window background,
is already set as the clip region, and already has a backing store.
Therefore in most cases, application code need not call
-gdk_window_begin_paint_region(). (You can disable the automatic
-calls around expose events on a widget-by-widget basis by calling
-gtk_widget_set_double_buffered().)
+gdk_window_begin_paint_region().
If you call this function multiple times before calling the
matching gdk_window_end_paint(), the backing stores are pushed onto
@@ -14792,7 +14823,8 @@ Since: 3.10
</description>
<parameters>
<parameter name="window">
-<parameter_description> window to make new surface similar to, or %NULL if none
+<parameter_description> window to make new surface similar to, or
+%NULL if none
</parameter_description>
</parameter>
<parameter name="format">
@@ -14969,22 +15001,12 @@ Since: 2.18
<function name="gdk_window_flush">
<description>
-Flush all outstanding cached operations on a window, leaving the
-window in a state which reflects all that has been drawn before.
-
-Gdk uses multiple kinds of caching to get better performance and
-nicer drawing. For instance, during exposes all paints to a window
-using double buffered rendering are keep on a surface until the last
-window has been exposed.
-
-Normally this should be completely invisible to applications, as
-we automatically flush the windows when required, but this might
-be needed if you for instance mix direct native drawing with
-gdk drawing. For Gtk widgets that don’t use double buffering this
-will be called automatically before sending the expose event.
+This function does nothing.
Since: 2.18
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="window">
@@ -15136,8 +15158,8 @@ Since: 2.22
</parameter_description>
</parameter>
</parameters>
-<return> The pattern to use for the background or
-%NULL to use the parent’s background.
+<return> The pattern to use for the
+background or %NULL to use the parent’s background.
</return>
</function>
@@ -15252,10 +15274,10 @@ Since: 2.18
</parameter_description>
</parameter>
</parameters>
-<return> a #GdkCursor, or %NULL. The returned
-object is owned by the #GdkWindow and should not be unreferenced
-directly. Use gdk_window_set_cursor() to unset the cursor of the
-window
+<return> a #GdkCursor, or %NULL. The
+returned object is owned by the #GdkWindow and should not be
+unreferenced directly. Use gdk_window_set_cursor() to unset the
+cursor of the window
</return>
</function>
@@ -15301,10 +15323,10 @@ Since: 3.0
</parameter_description>
</parameter>
</parameters>
-<return> a #GdkCursor, or %NULL. The returned
-object is owned by the #GdkWindow and should not be unreferenced
-directly. Use gdk_window_set_cursor() to unset the cursor of the
-window
+<return> a #GdkCursor, or %NULL. The
+returned object is owned by the #GdkWindow and should not be
+unreferenced directly. Use gdk_window_set_cursor() to unset the
+cursor of the window
</return>
</function>
@@ -15364,8 +15386,9 @@ Since: 3.0
</parameter_description>
</parameter>
</parameters>
-<return> The window underneath @device (as with
-gdk_device_get_window_at_position()), or %NULL if the window is not known to GDK.
+<return> The window underneath @device
+(as with gdk_device_get_window_at_position()), or %NULL if the
+window is not known to GDK.
</return>
</function>
@@ -15401,8 +15424,9 @@ Since: 3.10
</parameter_description>
</parameter>
</parameters>
-<return> The window underneath @device (as with
-gdk_device_get_window_at_position()), or %NULL if the window is not known to GDK.
+<return> The window underneath @device
+(as with gdk_device_get_window_at_position()), or %NULL if the
+window is not known to GDK.
</return>
</function>
@@ -15799,9 +15823,9 @@ modifier mask
</parameter_description>
</parameter>
</parameters>
-<return> the window containing the pointer (as with
-gdk_window_at_pointer()), or %NULL if the window containing the
-pointer isn’t known to GDK
+<return> the window containing the
+pointer (as with gdk_window_at_pointer()), or %NULL if the window
+containing the pointer isn’t known to GDK
</return>
</function>
@@ -16271,7 +16295,7 @@ invalidate regions that you know should be redrawn.
The @child_func parameter controls whether the region of
each child window that intersects @region will also be invalidated.
-Only children for which @child_func returns TRUE will have the area
+Only children for which @child_func returns #TRUE will have the area
invalidated.
</description>
@@ -18091,6 +18115,32 @@ that you can’t really use XMapWindow() directly on a GDK window).
<return></return>
</function>
+<function name="gdk_window_show_window_menu">
+<description>
+Asks the windowing system to show the window menu. The window menu
+is the menu shown when right-clicking the titlebar on traditional
+windows managed by the window manager. This is useful for windows
+using client-side decorations, activating it with a right-click
+on the window decorations.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GdkWindow
+</parameter_description>
+</parameter>
+<parameter name="event">
+<parameter_description> a #GdkEvent to show the menu for
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the window menu was shown and %FALSE otherwise.
+
+</return>
+</function>
+
<function name="gdk_window_stick">
<description>
“Pins” a window such that it’s on all workspaces and does not scroll
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index c14ff74..ec08b68 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -530,7 +530,7 @@ Used to specify the placement of scroll arrows in scrolling menus.
<enum name="GtkArrowType">
<description>
-Used to indicate the direction in which a #GtkArrow should point.
+Used to indicate the direction in which an arrow should point.
</description>
<parameters>
@@ -851,6 +851,14 @@ derived from the type of the composite class being extended with builder XML.
<parameter_description> The wrong type was specified in a composite class’s template XML
</parameter_description>
</parameter>
+<parameter name="GTK_BUILDER_ERROR_INVALID_PROPERTY">
+<parameter_description> The specified property is unknown for the object class.
+</parameter_description>
+</parameter>
+<parameter name="GTK_BUILDER_ERROR_INVALID_SIGNAL">
+<parameter_description> The specified signal is unknown for the object class.
+</parameter_description>
+</parameter>
</parameters>
</enum>
@@ -964,7 +972,7 @@ Deprecated: 2.8: Use the #GtkWidget::button-release-event signal.
<enum name="GtkButtonBoxStyle">
<description>
Used to dictate the style that a #GtkButtonBox uses to layout the buttons it
-contains. (See also: #GtkVButtonBox and #GtkHButtonBox).
+contains.
</description>
<parameters>
@@ -2825,6 +2833,29 @@ Since: 2.16
</parameters>
</enum>
+<enum name="GtkEventSequenceState">
+<description>
+Describes the state of a #GdkEventSequence in a #GtkGesture.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="GTK_EVENT_SEQUENCE_NONE">
+<parameter_description> The sequence is handled, but not grabbed.
+</parameter_description>
+</parameter>
+<parameter name="GTK_EVENT_SEQUENCE_CLAIMED">
+<parameter_description> The sequence is handled and grabbed.
+</parameter_description>
+</parameter>
+<parameter name="GTK_EVENT_SEQUENCE_DENIED">
+<parameter_description> The sequence is denied.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<enum name="GtkExpanderStyle">
<description>
Used to specify the style of the expanders drawn by a #GtkTreeView.
@@ -3642,6 +3673,418 @@ Space, Shift+Space, Return or Enter.
<return></return>
</signal>
+<signal name="GtkGesture::begin">
+<description>
+This signal is emitted when the gesture is recognized. This means the
+number of touch sequences matches #GtkGesture:n-points, and the #GtkGesture::check
+handler(s) returned #TRUE.
+
+Note: These conditions may also happen when an extra touch (eg. a third touch
+on a 2-touches gesture) is lifted, in that situation @sequence won't pertain
+to the current set of active touches, so don't rely on this being true.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the object which received the signal
+</parameter_description>
+</parameter>
+<parameter name="sequence">
+<parameter_description> the #GdkEventSequence that made the gesture to be recognized
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGesture::cancel">
+<description>
+This signal is emitted whenever a sequence is cancelled. This usually
+happens on active touches when gtk_event_controller_reset() is called
+on @gesture (manually, due to grabs...), or the individual @sequence
+was claimed by parent widgets' controllers (see gtk_gesture_set_sequence_state()).
+
+ gesture must forget everything about @sequence as a reaction to this signal.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the object which received the signal
+</parameter_description>
+</parameter>
+<parameter name="sequence">
+<parameter_description> the #GdkEventSequence that was cancelled
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGesture::end">
+<description>
+This signal is emitted when @gesture either stopped recognizing the event
+sequences as something to be handled (the #GtkGesture::check handler returned
+%FALSE), or the number of touch sequences became higher or lower than
+#GtkGesture:n-points.
+
+Note: @sequence might not pertain to the group of sequences that were
+previously triggering recognition on @gesture (ie. a just pressed touch
+sequence that exceeds #GtkGesture:n-points). This situation may be detected
+by checking through gtk_gesture_handles_sequence().
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the object which received the signal
+</parameter_description>
+</parameter>
+<parameter name="sequence">
+<parameter_description> the #GdkEventSequence that made gesture recognition to finish
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGesture::sequence-state-changed">
+<description>
+This signal is emitted whenever a sequence state changes. See
+gtk_gesture_set_sequence_state() to know more about the expectable
+sequence lifetimes.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the object which received the signal
+</parameter_description>
+</parameter>
+<parameter name="sequence">
+<parameter_description> the #GdkEventSequence that was cancelled
+</parameter_description>
+</parameter>
+<parameter name="state">
+<parameter_description> the new sequence state
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGesture::update">
+<description>
+This signal is emitted whenever an event is handled while the gesture is
+recognized. @sequence is guaranteed to pertain to the set of active touches.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the object which received the signal
+</parameter_description>
+</parameter>
+<parameter name="sequence">
+<parameter_description> the #GdkEventSequence that was updated
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGestureDrag::drag-begin">
+<description>
+This signal is emitted whenever dragging starts.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the object which received the signal
+</parameter_description>
+</parameter>
+<parameter name="start_x">
+<parameter_description> X coordinate, relative to the widget allocation
+</parameter_description>
+</parameter>
+<parameter name="start_y">
+<parameter_description> Y coordinate, relative to the widget allocation
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGestureDrag::drag-end">
+<description>
+This signal is emitted whenever the dragging is finished.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the object which received the signal
+</parameter_description>
+</parameter>
+<parameter name="offset_x">
+<parameter_description> X offset, relative to the start point
+</parameter_description>
+</parameter>
+<parameter name="offset_y">
+<parameter_description> Y offset, relative to the start point
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGestureDrag::drag-update">
+<description>
+This signal is emitted whenever the dragging point moves.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the object which received the signal
+</parameter_description>
+</parameter>
+<parameter name="offset_x">
+<parameter_description> X offset, relative to the start point
+</parameter_description>
+</parameter>
+<parameter name="offset_y">
+<parameter_description> Y offset, relative to the start point
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGestureLongPress::cancelled">
+<description>
+This signal is emitted whenever a press moved too far, or was released
+before #GtkGestureLongPress:pressed happened.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the object which received the signal
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGestureLongPress::pressed">
+<description>
+This signal is emitted whenever a press goes unmoved/unreleased longer than
+what the GTK+ defaults tell.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the object which received the signal
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> the X coordinate where the press happened, relative to the widget allocation
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> the Y coordinate where the press happened, relative to the widget allocation
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGestureMultiPress::pressed">
+<description>
+This signal is emitted whenever a button or touch press happens.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the object which received the signal
+</parameter_description>
+</parameter>
+<parameter name="n_press">
+<parameter_description> how many touch/button presses happened with this one
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> The X coordinate, in widget allocation coordinates
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> The Y coordinate, in widget allocation coordinates
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGestureMultiPress::released">
+<description>
+This signal is emitted when a button or touch is released. @n_press
+will report the number of press that is paired to this event, note
+that #GtkGestureMultiPress::stopped may have been emitted between the
+press and its release, @n_press will only start over at the next press.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the object which received the signal
+</parameter_description>
+</parameter>
+<parameter name="n_press">
+<parameter_description> number of press that is paired with this release
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> The X coordinate, in widget allocation coordinates
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> The Y coordinate, in widget allocation coordinates
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGestureMultiPress::stopped">
+<description>
+This signal is emitted whenever any time/distance threshold has
+been exceeded.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the object which received the signal
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGesturePan::pan">
+<description>
+This signal is emitted once a panning gesture along the
+expected axis is detected.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> The object which received the signal
+</parameter_description>
+</parameter>
+<parameter name="direction">
+<parameter_description> current direction of the pan gesture
+</parameter_description>
+</parameter>
+<parameter name="offset">
+<parameter_description> Offset along the gesture orientation
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGestureRotate::angle-changed">
+<description>
+This signal is emitted when the angle between both tracked points
+changes.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the object on which the signal is emitted
+</parameter_description>
+</parameter>
+<parameter name="angle">
+<parameter_description> Current angle in radians
+</parameter_description>
+</parameter>
+<parameter name="angle_delta">
+<parameter_description> Difference with the starting angle, in radians
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGestureSwipe::swipe">
+<description>
+This signal is emitted when the recognized gesture is finished, velocity
+and direction are a product of previously recorded events.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> object which received the signal
+</parameter_description>
+</parameter>
+<parameter name="velocity_x">
+<parameter_description> velocity in the X axis, in pixels/sec
+</parameter_description>
+</parameter>
+<parameter name="velocity_y">
+<parameter_description> velocity in the Y axis, in pixels/sec
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGestureZoom::scale-changed">
+<description>
+This signal is emitted whenever the distance between both tracked
+sequences changes.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="controller">
+<parameter_description> the object on which the signal is emitted
+</parameter_description>
+</parameter>
+<parameter name="scale">
+<parameter_description> Scale delta, taking the initial state as 1:1
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
<signal name="GtkHandleBox::child-attached">
<description>
This signal is emitted when the contents of the
@@ -3884,6 +4327,26 @@ fallback, see gtk_icon_theme_choose_icon(). Since 2.12.
requested size. Since 2.14.
</parameter_description>
</parameter>
+<parameter name="GTK_ICON_LOOKUP_FORCE_REGULAR">
+<parameter_description> Try to always load regular icons, even
+when symbolic icon names are given. Since 3.14.
+</parameter_description>
+</parameter>
+<parameter name="GTK_ICON_LOOKUP_FORCE_SYMBOLIC">
+<parameter_description> Try to always load symbolic icons, even
+when regular icon names are given. Since 3.14.
+</parameter_description>
+</parameter>
+<parameter name="GTK_ICON_LOOKUP_DIR_LTR">
+<parameter_description> Try to load a variant of the icon for left-to-right
+text direction. Since 3.14.
+</parameter_description>
+</parameter>
+<parameter name="GTK_ICON_LOOKUP_DIR_RTL">
+<parameter_description> Try to load a variant of the icon for right-to-left
+text direction. Since 3.14.
+</parameter_description>
+</parameter>
</parameters>
</enum>
@@ -4724,14 +5187,13 @@ your handler.
<signal name="GtkListBox::row-activated">
<description>
-The ::row-activated signal is emitted when a row has been activated by
-the user.
+The ::row-activated signal is emitted when a row has been activated by the user.
Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> the #GtkListBox
</parameter_description>
</parameter>
@@ -4748,11 +5210,15 @@ Since: 3.10
The ::row-selected signal is emitted when a new row is selected, or
(with a %NULL @row) when the selection is cleared.
+When the @box is using #GTK_SELECTION_MULTIPLE, this signal will not
+give you the full picture of selection changes, and you should use
+the #GtkListBox::selected-rows-changed signal instead.
+
Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> the #GtkListBox
</parameter_description>
</parameter>
@@ -4764,6 +5230,63 @@ Since: 3.10
<return></return>
</signal>
+<signal name="GtkListBox::select-all">
+<description>
+The ::select-all signal is a [keybinding signal][GtkBindingSignal]
+which gets emitted to select all children of the box, if the selection
+mode permits it.
+
+The default bindings for this signal is Ctrl-a.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> the #GtkListBox on which the signal is emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkListBox::selected-rows-changed">
+<description>
+The ::selected-rows-changed signal is emitted when the
+set of selected rows changes.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> the #GtkListBox on wich the signal is emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkListBox::unselect-all">
+<description>
+The ::unselect-all signal is a [keybinding signal][GtkBindingSignal]
+which gets emitted to unselect all children of the box, if the selection
+mode permits it.
+
+The default bindings for this signal is Ctrl-Shift-a.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> the #GtkListBox on which the signal is emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
<signal name="GtkMenu::move-scroll">
<description>
@@ -5266,17 +5789,18 @@ multiple pages per sheet.
<enum name="GtkOrientation">
<description>
-Represents the orientation of widgets which can be switched between horizontal
-and vertical orientation on the fly, like #GtkToolbar.
+Represents the orientation of widgets and other objects which can be switched
+between horizontal and vertical orientation on the fly, like #GtkToolbar or
+#GtkGesturePan.
</description>
<parameters>
<parameter name="GTK_ORIENTATION_HORIZONTAL">
-<parameter_description> The widget is in horizontal orientation.
+<parameter_description> The element is in horizontal orientation.
</parameter_description>
</parameter>
<parameter name="GTK_ORIENTATION_VERTICAL">
-<parameter_description> The widget is in vertical orientation.
+<parameter_description> The element is in vertical orientation.
</parameter_description>
</parameter>
</parameters>
@@ -5311,7 +5835,8 @@ Return: %TRUE if the @allocation has been filled
</parameter_description>
</parameter>
<parameter name="allocation">
-<parameter_description> return location for the allocation
+<parameter_description> return
+location for the allocation
</parameter_description>
</parameter>
</parameters>
@@ -5408,6 +5933,33 @@ See also gtk_print_job_set_page_set().
</parameters>
</enum>
+<enum name="GtkPanDirection">
+<description>
+Describes the panning direction of a #GtkGesturePan
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="GTK_PAN_DIRECTION_LEFT">
+<parameter_description> panned towards the left
+</parameter_description>
+</parameter>
+<parameter name="GTK_PAN_DIRECTION_RIGHT">
+<parameter_description> panned towards the right
+</parameter_description>
+</parameter>
+<parameter name="GTK_PAN_DIRECTION_UP">
+<parameter_description> panned upwards
+</parameter_description>
+</parameter>
+<parameter name="GTK_PAN_DIRECTION_DOWN">
+<parameter_description> panned downwards
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<signal name="GtkPaned::accept-position">
<description>
The ::accept-position signal is a
@@ -5697,7 +6249,8 @@ Since: 3.10
</parameter_description>
</parameter>
<parameter name="source_file_list">
-<parameter_description> List of #GFile that are being dragged
+<parameter_description>
+List of #GFile that are being dragged
</parameter_description>
</parameter>
</parameters>
@@ -5729,7 +6282,8 @@ Since: 3.10
</parameter_description>
</parameter>
<parameter name="source_file_list">
-<parameter_description> #GList of #GFile that got dropped.
+<parameter_description>
+#GList of #GFile that got dropped.
</parameter_description>
</parameter>
<parameter name="action">
@@ -5832,6 +6386,25 @@ Since: 3.10
<return></return>
</signal>
+<signal name="GtkPlacesSidebar::show-enter-location">
+<description>
+The places sidebar emits this signal when it needs the calling
+application to present an way to directly enter a location.
+For example, the application may bring up a dialog box asking for
+a URL like "http://http.example.com".
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> the object which received the signal.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
<signal name="GtkPlacesSidebar::show-error-message">
<description>
The places sidebar emits this signal when it needs the calling
@@ -5875,21 +6448,24 @@ Gets emitted when the plug becomes embedded in a socket.
<enum name="GtkPolicyType">
<description>
-Determines when a scroll bar will be visible.
+Determines how the size should be computed to achieve the one of the
+visibility mode for the scrollbars.
</description>
<parameters>
<parameter name="GTK_POLICY_ALWAYS">
-<parameter_description> The scrollbar is always visible.
+<parameter_description> The scrollbar is always visible. The view size is
+independent of the content.
</parameter_description>
</parameter>
<parameter name="GTK_POLICY_AUTOMATIC">
-<parameter_description> The scrollbar will appear and disappear as necessary. For example,
-when all of a #GtkCList can not be seen.
+<parameter_description> The scrollbar will appear and disappear as necessary.
+For example, when all of a #GtkTreeView can not be seen.
</parameter_description>
</parameter>
<parameter name="GTK_POLICY_NEVER">
-<parameter_description> The scrollbar will never appear.
+<parameter_description> The scrollbar should never appear. In this mode the
+content determines the size.
</parameter_description>
</parameter>
</parameters>
@@ -6627,19 +7203,38 @@ Since: 2.10
<return></return>
</signal>
-<enum name="GtkQueueResizeFlags">
+<enum name="GtkPropagationPhase">
<description>
-Flags that affect the operation of queueing a widget for resize.
+Describes the stage at which events are fed into a #GtkEventController.
+
+Since: 3.14
</description>
<parameters>
-<parameter name="GTK_QUEUE_RESIZE_INVALIDATE_ONLY">
-<parameter_description> invalidate all cached sizes
-as we would normally do when a widget is queued for resize,
-but don’t actually add the toplevel resize container to the
-resize queue. Useful if we want to change the size of a widget
-see how that would affect the overall layout, then restore
-the old size.
+<parameter name="GTK_PHASE_NONE">
+<parameter_description> Events are not delivered automatically. Those can be
+manually fed through gtk_event_controller_handle_event(). This should
+only be used when full control about when, or whether the controller
+handles the event is needed.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PHASE_CAPTURE">
+<parameter_description> Events are delivered in the capture phase. The
+capture phase happens before the bubble phase, runs from the toplevel down
+to the event widget. This option should only be used on containers that
+might possibly handle events before their children do.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PHASE_BUBBLE">
+<parameter_description> Events are delivered in the bubble phase. The bubble
+phase happens after the capture phase, and before the default handlers
+are run. This phase runs from the event widget, up to the toplevel.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PHASE_TARGET">
+<parameter_description> Events are delivered in the default widget event handlers,
+note that widget implementations must chain up on button, motion, touch and
+grab broken handlers for controllers in this phase to be run.
</parameter_description>
</parameter>
</parameters>
@@ -6662,7 +7257,7 @@ Deprecated: 3.10
</parameter_description>
</parameter>
<parameter name="current">
-<parameter_description> the member of @action<!-- -->s group which has just been activated
+<parameter_description> the member of @action's group which has just been activated
</parameter_description>
</parameter>
</parameters>
@@ -8043,7 +8638,19 @@ New values may be added to this enumeration over time.
</parameter_description>
</parameter>
<parameter name="GTK_STACK_TRANSITION_TYPE_OVER_UP_DOWN">
-<parameter_description> Cover the old page or uncover the new page, according to order. Since: 3.12
+<parameter_description> Cover the old page sliding up or uncover the new page sliding down, according to
order. Since: 3.12
+</parameter_description>
+</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_OVER_DOWN_UP">
+<parameter_description> Cover the old page sliding down or uncover the new page sliding up, according to
order. Since: 3.14
+</parameter_description>
+</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_OVER_LEFT_RIGHT">
+<parameter_description> Cover the old page sliding left or uncover the new page sliding right, according to
order. Since: 3.14
+</parameter_description>
+</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_OVER_RIGHT_LEFT">
+<parameter_description> Cover the old page sliding right or uncover the new page sliding left, according to
order. Since: 3.14
</parameter_description>
</parameter>
</parameters>
@@ -8115,6 +8722,9 @@ the widget is drawn. The #GtkStateType enumeration is also used to
identify different colors in a #GtkStyle for drawing, so states can be
used for subparts of a widget as well as entire widgets.
+Deprecated: 3.14: All APIs that are using this enumeration have been deprecated
+in favor of alternatives using #GtkStateFlags.
+
</description>
<parameters>
<parameter name="GTK_STATE_NORMAL">
@@ -8484,6 +9094,36 @@ notify::active signal.
<return></return>
</signal>
+<signal name="GtkSwitch::state-set">
+<description>
+The ::state-set signal on GtkSwitch is emitted to change the underlying
+state. It is emitted when the user changes the switch position. The
+default handler keeps the state in sync with the #GtkState:active
+property.
+
+To implement delayed state change, applications can connect to this signal,
+initiate the change of the underlying state, and call gtk_switch_set_state()
+when the underlying state change is complete. The signal handler should
+return %TRUE to prevent the default handler from running.
+
+Visually, the underlying state is represented by the trough color of
+the switch, while the #GtkSwitch:active property is represented by the
+position of the switch.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> the object on which the signal was emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE to stop the signal emission
+
+</return>
+</signal>
+
<enum name="GtkTargetFlags">
<description>
The #GtkTargetFlags enumeration is used to specify
@@ -11940,7 +12580,8 @@ gtk_widget_show().
</parameter_description>
</parameter>
<parameter name="allocation">
-<parameter_description>
+<parameter_description> the region which has been
+allocated to the widget.
</parameter_description>
</parameter>
</parameters>
@@ -11952,7 +12593,7 @@ gtk_widget_show().
The ::state-changed signal is emitted when the widget state changes.
See gtk_widget_get_state().
-Deprecated: 3.0. Use #GtkWidget::state-flags-changed instead.
+Deprecated: 3.0: Use #GtkWidget::state-flags-changed instead.
</description>
<parameters>
@@ -12220,6 +12861,25 @@ or mnemonics that are associated with @window changes.
<return></return>
</signal>
+<signal name="GtkWindow::toggle-debugging">
+<description>
+The ::toggle-debugging signal is a
+[keybinding signal][GtkBindingSignal]
+which gets emitted when the user enables or disables
+interactive debugging.
+
+The default binding for this signal is Ctrl-Shift-I.
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> the window on which the signal is emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
<enum name="GtkWindowPosition">
<description>
Window placement can be influenced using this enumeration. Note that
@@ -14484,7 +15144,7 @@ and must not be freed or modified.
<function name="gtk_action_get_always_show_image">
<description>
-Returns whether @action<!-- -->’s menu item proxies will always
+Returns whether @action's menu item proxies will always
show their image, if available.
Since: 2.20
@@ -15293,7 +15953,7 @@ Deprecated: 3.10
<function name="gtk_action_group_set_translate_func">
<description>
Sets a function to be used for translating the @label and @tooltip of
-#GtkActionEntry<!-- -->s added by gtk_action_group_add_actions().
+#GtkActionEntrys added by gtk_action_group_add_actions().
If you’re using gettext(), it is enough to set the translation domain
with gtk_action_group_set_translation_domain().
@@ -15328,7 +15988,7 @@ destroyed and when the translation function is changed again
<function name="gtk_action_group_set_translation_domain">
<description>
Sets the translation domain and uses g_dgettext() for translating the
- label and @tooltip of #GtkActionEntry<!-- -->s added by
+ label and @tooltip of #GtkActionEntrys added by
gtk_action_group_add_actions().
If you’re not using gettext() for localization, see
@@ -15588,7 +16248,7 @@ Deprecated: 3.10: Use #GAction and the accelerator path on an associated
<function name="gtk_action_set_always_show_image">
<description>
-Sets whether @action<!-- -->’s menu item proxies will ignore the
+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
@@ -16648,6 +17308,8 @@ See gtk_alignment_set_padding ().
Since: 2.4
+Deprecated: 3.14: Use #GtkWidget alignment and margin properties
+
</description>
<parameters>
<parameter name="alignment">
@@ -16682,6 +17344,7 @@ for the right of the widget, or %NULL
<description>
Creates a new #GtkAlignment.
+Deprecated: 3.14: Use #GtkWidget alignment and margin properties
</description>
<parameters>
@@ -16709,7 +17372,8 @@ unused space, from 0 to 1. The values are similar to @xscale.
</parameter_description>
</parameter>
</parameters>
-<return> the new #GtkAlignment.
+<return> the new #GtkAlignment
+
</return>
</function>
@@ -16717,6 +17381,8 @@ unused space, from 0 to 1. The values are similar to @xscale.
<description>
Sets the #GtkAlignment values.
+Deprecated: 3.14: Use #GtkWidget alignment and margin properties
+
</description>
<parameters>
<parameter name="alignment">
@@ -16759,6 +17425,8 @@ padding on the left.
Since: 2.4
+Deprecated: 3.14: Use #GtkWidget alignment and margin properties
+
</description>
<parameters>
<parameter name="alignment">
@@ -17460,6 +18128,8 @@ than calling this function for each accelerator.
Since: 3.4
+Deprecated: 3.14: Use gtk_application_set_accels_for_action() instead
+
</description>
<parameters>
<parameter name="application">
@@ -17677,7 +18347,7 @@ Since: 3.4
</description>
<parameters>
<parameter name="application">
-<parameter_description> the #GApplication
+<parameter_description> the #GtkApplication
</parameter_description>
</parameter>
<parameter name="window">
@@ -17712,7 +18382,7 @@ Since: 3.4
</description>
<parameters>
<parameter name="application">
-<parameter_description> the #GApplication
+<parameter_description> the #GtkApplication
</parameter_description>
</parameter>
<parameter name="flags">
@@ -17797,6 +18467,8 @@ with gtk_application_add_accelerator().
Since: 3.4
+Deprecated: 3.14: Use gtk_application_set_accels_for_action() instead
+
</description>
<parameters>
<parameter name="application">
@@ -17845,10 +18517,13 @@ Since: 3.0
<function name="gtk_application_set_accels_for_action">
<description>
-Sets one or more keyboard accelerator that will trigger the
+Sets zero or more keyboard accelerators that will trigger the
given action. The first item in @accels will be the primary
accelerator, which may be displayed in the UI.
+To remove all accelerators for an action, use an empty, zero-terminated
+array for @accels.
+
Since: 3.12
</description>
@@ -17954,7 +18629,7 @@ Since: 3.4
</description>
<parameters>
<parameter name="application">
-<parameter_description> the #GApplication
+<parameter_description> the #GtkApplication
</parameter_description>
</parameter>
<parameter name="cookie">
@@ -18047,6 +18722,7 @@ Since: 3.4
<description>
Creates a new #GtkArrow widget.
+Deprecated: 3.14: Use a #GtkImage with a suitable icon.
</description>
<parameters>
@@ -18060,6 +18736,7 @@ Creates a new #GtkArrow widget.
</parameter>
</parameters>
<return> the new #GtkArrow widget.
+
</return>
</function>
@@ -18067,6 +18744,8 @@ Creates a new #GtkArrow widget.
<description>
Sets the direction and style of the #GtkArrow, @arrow.
+Deprecated: 3.14: Use a #GtkImage with a suitable icon.
+
</description>
<parameters>
<parameter name="arrow">
@@ -20757,6 +21436,9 @@ Gets the alignment of the child in the button.
Since: 2.4
+Deprecated: 3.14: Access the child widget directly if you need to control
+its alignment.
+
</description>
<parameters>
<parameter name="button">
@@ -21106,6 +21788,9 @@ the child is a #GtkMisc or a #GtkAlignment.
Since: 2.4
+Deprecated: 3.14: Access the child widget directly if you need to control
+its alignment.
+
</description>
<parameters>
<parameter name="button">
@@ -21245,8 +21930,6 @@ Sets the relief style of the edges of the given #GtkButton widget.
Three styles exist, GTK_RELIEF_NORMAL, GTK_RELIEF_HALF, GTK_RELIEF_NONE.
The default style is, as one can guess, GTK_RELIEF_NORMAL.
-<!-- FIXME: put pictures of each style -->
-
</description>
<parameters>
<parameter name="button">
@@ -21925,6 +22608,33 @@ Since: 3.0
<return></return>
</function>
+<function name="gtk_cell_area_attribute_get_column">
+<description>
+Returns the model column that an attribute has been mapped to,
+or -1 if the attribute is not mapped.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="cell_layout">
+<parameter_description> a #GtkCellLayout
+</parameter_description>
+</parameter>
+<parameter name="cell">
+<parameter_description> a #GtkCellRenderer
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> an attribute on the renderer
+</parameter_description>
+</parameter>
+</parameters>
+<return> the model column, or -1
+
+</return>
+</function>
+
<function name="gtk_cell_area_box_get_spacing">
<description>
Gets the spacing added between cell renderers.
@@ -25490,7 +26200,7 @@ Since: 2.2
</description>
<parameters>
<parameter name="display">
-<parameter_description> the display for which the clipboard is to be retrieved or created
+<parameter_description> the #GdkDisplay for which the clipboard is to be retrieved or created.
</parameter_description>
</parameter>
<parameter name="selection">
@@ -26067,12 +26777,11 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> 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
+<return>
+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
the clipboard could not be converted into URI form.)
</return>
@@ -28281,6 +28990,22 @@ with @first_prop_name
<return></return>
</function>
+<function name="gtk_container_cell_accessible_get_children">
+<description>
+Get a list of children.
+
+
+</description>
+<parameters>
+<parameter name="container">
+<parameter_description> the container
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer none) (element-type Gtk.CellAccessible)
+</return>
+</function>
+
<function name="gtk_container_child_get">
<description>
Gets the values of one or more child properties for @child and @container.
@@ -28508,8 +29233,9 @@ Finds a child property of a container class by name.
</parameter_description>
</parameter>
</parameters>
-<return> the #GParamSpec of the child property
-or %NULL if @class has no child property with that name.
+<return> the #GParamSpec of the child
+property or %NULL if @class has no child property with that
+name.
</return>
</function>
@@ -29049,6 +29775,8 @@ Sets the @reallocate_redraws flag of the container to the given value.
Containers requesting reallocation redraws get automatically
redrawn if any of their children changed allocation.
+Deprecated: 3.14: Call gtk_widget_queue_draw() in your size_allocate handler.
+
</description>
<parameters>
<parameter name="container">
@@ -32469,8 +33197,8 @@ Since: 2.16
</parameter_description>
</parameter>
</parameters>
-<return> the tooltip text, or %NULL. Free the returned string
-with g_free() when done.
+<return> the tooltip text, or %NULL. Free the returned
+string with g_free() when done.
</return>
</function>
@@ -32493,8 +33221,8 @@ Since: 2.16
</parameter_description>
</parameter>
</parameters>
-<return> the tooltip text, or %NULL. Free the returned string
-with g_free() when done.
+<return> the tooltip text, or %NULL. Free the returned
+string with g_free() when done.
</return>
</function>
@@ -32517,7 +33245,8 @@ this function is ignored by #GtkEntry.
</parameter_description>
</parameter>
</parameters>
-<return> the entry’s #GtkBorder, or %NULL if none was set.
+<return> the entry’s #GtkBorder, or
+%NULL if none was set.
</return>
</function>
@@ -33969,6 +34698,108 @@ Since: 2.4
<return></return>
</function>
+<function name="gtk_event_controller_get_propagation_phase">
+<description>
+Gets the propagation phase at which @controller handles events.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="controller">
+<parameter_description> a #GtkEventController
+</parameter_description>
+</parameter>
+</parameters>
+<return> the propagation phase
+
+</return>
+</function>
+
+<function name="gtk_event_controller_get_widget">
+<description>
+Returns the #GtkWidget this controller relates to.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="controller">
+<parameter_description> a #GtkEventController
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GtkWidget
+
+</return>
+</function>
+
+<function name="gtk_event_controller_handle_event">
+<description>
+Feeds an events into @controller, so it can be interpreted
+and the controller actions triggered.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="controller">
+<parameter_description> a #GtkEventController
+</parameter_description>
+</parameter>
+<parameter name="event">
+<parameter_description> a #GdkEvent
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the event was potentially useful to trigger the
+controller action
+
+</return>
+</function>
+
+<function name="gtk_event_controller_reset">
+<description>
+Resets the @controller to a clean state. Every interaction
+the controller did through #GtkEventController::handle-event
+will be dropped at this point.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="controller">
+<parameter_description> a #GtkEventController
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_event_controller_set_propagation_phase">
+<description>
+Sets the propagation phase at which a controller handles events.
+
+If @phase is %GTK_PHASE_NONE, no automatic event handling will be
+performed, but other additional gesture maintenance will. In that phase,
+the events can be managed by calling gtk_event_controller_handle_event().
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="controller">
+<parameter_description> a #GtkEventController
+</parameter_description>
+</parameter>
+<parameter name="phase">
+<parameter_description> a propagation phase
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_events_pending">
<description>
Checks if any events are pending.
@@ -34725,7 +35556,7 @@ Since: 2.18
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the New Folder button should be displayed.
+<return> %TRUE if the Create Folder button should be displayed.
</return>
</function>
@@ -35250,9 +36081,9 @@ Since: 2.4
</parameter_description>
</parameter>
</parameters>
-<return> 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().
+<return> 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().
</return>
</function>
@@ -35271,9 +36102,9 @@ Since: 2.4
</parameter_description>
</parameter>
</parameters>
-<return> 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
+<return> 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().
</return>
@@ -35489,7 +36320,7 @@ Since: 2.18
</parameter_description>
</parameter>
<parameter name="create_folders">
-<parameter_description> %TRUE if the New Folder button should be displayed
+<parameter_description> %TRUE if the Create Folder button should be displayed
</parameter_description>
</parameter>
</parameters>
@@ -35800,9 +36631,9 @@ Since: 2.4
<description>
Sets whether only local files can be selected in the
file selector. If @local_only is %TRUE (the default),
-then the selected file are files are guaranteed to be
+then the selected file or files are guaranteed to be
accessible through the operating systems native file
-file system and therefore the application only
+system and therefore the application only
needs to worry about the filename functions in
#GtkFileChooser, like gtk_file_chooser_get_filename(),
rather than the URI functions like
@@ -38192,7 +39023,8 @@ gtk_frame_set_label_widget().
</parameter_description>
</parameter>
</parameters>
-<return> the label widget, or %NULL if there is none.
+<return> the label widget, or %NULL if
+there is none.
</return>
</function>
@@ -38315,6 +39147,958 @@ Sets the shadow type for @frame.
<return></return>
</function>
+<function name="gtk_gesture_drag_get_offset">
+<description>
+If the @gesture is active, this function returns %TRUE and
+fills in @x and @y with the coordinates of the current point,
+as an offset to the starting drag point.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> X offset for the current point
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y offset for the current point
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the gesture is active
+
+</return>
+</function>
+
+<function name="gtk_gesture_drag_get_start_point">
+<description>
+If the @gesture is active, this function returns %TRUE
+and fills in @x and @y with the drag start coordinates,
+in window-relative coordinates.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> X coordinate for the drag start point
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y coordinate for the drag start point
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the gesture is active
+
+</return>
+</function>
+
+<function name="gtk_gesture_drag_new">
+<description>
+Returns a newly created #GtkGesture that recognizes drags.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly created #GtkGestureDrag
+
+</return>
+</function>
+
+<function name="gtk_gesture_get_bounding_box">
+<description>
+If there are touch sequences being currently handled by @gesture,
+this function returns %TRUE and fills in @rect with the bounding
+box containing all active touches. Otherwise, %FALSE will be
+returned.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+<parameter name="rect">
+<parameter_description> bounding box containing all active touches.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if there are active touches, %FALSE otherwise
+
+</return>
+</function>
+
+<function name="gtk_gesture_get_bounding_box_center">
+<description>
+If there are touch sequences being currently handled by @gesture,
+this function returns %TRUE and fills in @x and @y with the center
+of the bounding box containing all active touches. Otherwise, %FALSE
+will be returned.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> X coordinate for the bounding box center
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y coordinate for the bounding box center
+</parameter_description>
+</parameter>
+</parameters>
+<return> %FALSE if no active touches are present, %TRUE otherwise
+
+</return>
+</function>
+
+<function name="gtk_gesture_get_device">
+<description>
+Returns the master #GdkDevice that is currently operating
+on @gesture, or %NULL if the gesture is not being interacted.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GdkDevice, or %NULL
+
+</return>
+</function>
+
+<function name="gtk_gesture_get_group">
+<description>
+Returns all gestures in the group of @gesture
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+</parameters>
+<return> The list
+of #GtkGestures, free with g_list_free()
+
+</return>
+</function>
+
+<function name="gtk_gesture_get_last_event">
+<description>
+Returns the last event that was processed for @sequence.
+
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+<parameter name="sequence">
+<parameter_description> a #GdkEventSequence
+</parameter_description>
+</parameter>
+</parameters>
+<return> The last event from @sequence
+</return>
+</function>
+
+<function name="gtk_gesture_get_last_updated_sequence">
+<description>
+Returns the #GdkEventSequence that was last updated on @gesture.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+</parameters>
+<return> The last updated sequence
+
+</return>
+</function>
+
+<function name="gtk_gesture_get_point">
+<description>
+If @sequence is currently being interpreted by @gesture, this
+function returns %TRUE and fills in @x and @y with the last coordinates
+stored for that event sequence. The coordinates are always relative to the
+widget allocation.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+<parameter name="sequence">
+<parameter_description> a #GdkEventSequence, or %NULL for pointer events
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> return location for X axis of the sequence coordinates
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> return location for Y axis of the sequence coordinates
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @sequence is currently interpreted
+
+</return>
+</function>
+
+<function name="gtk_gesture_get_sequence_state">
+<description>
+Returns the @sequence state, as seen by @gesture.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+<parameter name="sequence">
+<parameter_description> a #GdkEventSequence
+</parameter_description>
+</parameter>
+</parameters>
+<return> The sequence state in @gesture
+
+</return>
+</function>
+
+<function name="gtk_gesture_get_sequences">
+<description>
+Returns the list of #GdkEventSequences currently being interpreted
+by @gesture.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+</parameters>
+<return> A list
+of #GdkEventSequences, the list elements are owned by GTK+
+and must not be freed or modified, the list itself must be deleted
+through g_list_free()
+
+</return>
+</function>
+
+<function name="gtk_gesture_get_window">
+<description>
+Returns the user-defined window that receives the events
+handled by @gesture. See gtk_gesture_set_window() for more
+information.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+</parameters>
+<return> the user defined window, or %NULL if none
+
+</return>
+</function>
+
+<function name="gtk_gesture_group">
+<description>
+Adds @gesture to the same group than @group_gesture. Gestures
+are by default isolated in their own groups.
+
+When gestures are grouped, the state of #GdkEventSequences
+is kept in sync for all of those, so calling gtk_gesture_set_sequence_state(),
+on one will transfer the same value to the others.
+
+Groups also perform an "implicit grabbing" of sequences, if a
+#GdkEventSequence state is set to #GTK_EVENT_SEQUENCE_CLAIMED on one group,
+every other gesture group attached to the same #GtkWidget will switch the
+state for that sequence to #GTK_EVENT_SEQUENCE_DENIED.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+<parameter name="group_gesture">
+<parameter_description> #GtkGesture to group @gesture with
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_gesture_handles_sequence">
+<description>
+Returns %TRUE if @gesture is currently handling events corresponding to
+ sequence
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+<parameter name="sequence">
+<parameter_description> a #GdkEventSequence
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @gesture is handling @sequence
+
+</return>
+</function>
+
+<function name="gtk_gesture_is_active">
+<description>
+Returns %TRUE if the gesture is currently active.
+A gesture is active meanwhile there are touch sequences
+interacting with it.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if gesture is active
+
+</return>
+</function>
+
+<function name="gtk_gesture_is_grouped_with">
+<description>
+Returns %TRUE if both gestures pertain to the same group.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+<parameter name="other">
+<parameter_description> another #GtkGesture
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether the gestures are grouped
+
+</return>
+</function>
+
+<function name="gtk_gesture_is_recognized">
+<description>
+Returns %TRUE if the gesture is currently recognized.
+A gesture is recognized if there are as many interacting
+touch sequences as required by @gesture, and #GtkGesture::check
+returned %TRUE for the sequences being currently interpreted.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if gesture is recognized
+
+</return>
+</function>
+
+<function name="gtk_gesture_long_press_new">
+<description>
+Returns a newly created #GtkGesture that recognizes long presses.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly created #GtkGestureLongPress
+
+</return>
+</function>
+
+<function name="gtk_gesture_multi_press_get_area">
+<description>
+If an area was set through gtk_gesture_multi_press_set_area(),
+this function will return %TRUE and fill in @rect with the
+press area. See gtk_gesture_multi_press_set_area() for more
+details on what the press area represents.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGestureMultiPress
+</parameter_description>
+</parameter>
+<parameter name="rect">
+<parameter_description> return location for the press area
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @rect was filled with the press area
+
+</return>
+</function>
+
+<function name="gtk_gesture_multi_press_new">
+<description>
+Returns a newly created #GtkGesture that recognizes single and multiple
+presses.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly created #GtkGestureMultiPress
+
+</return>
+</function>
+
+<function name="gtk_gesture_multi_press_set_area">
+<description>
+If @rect is non-%NULL, the press area will be checked to be
+confined within the rectangle, otherwise the button count
+will be reset so the press is seen as being the first one.
+If @rect is #NULL, the area will be reset to an unrestricted
+state.
+
+Note: The rectangle is only used to determine whether any
+non-first click falls within the expected area. This is not
+akin to an input shape.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+<parameter name="rect">
+<parameter_description> rectangle to receive coordinates on
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_gesture_pan_get_orientation">
+<description>
+Returns the orientation of the pan gestures that this @gesture expects.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> A #GtkGesturePan
+</parameter_description>
+</parameter>
+</parameters>
+<return> the expected orientation for pan gestures
+
+</return>
+</function>
+
+<function name="gtk_gesture_pan_new">
+<description>
+Returns a newly created #GtkGesture that recognizes pan gestures.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="orientation">
+<parameter_description> expected orientation
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly created #GtkGesturePan
+
+</return>
+</function>
+
+<function name="gtk_gesture_pan_set_orientation">
+<description>
+Sets the orientation to be expected on pan gestures.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> A #GtkGesturePan
+</parameter_description>
+</parameter>
+<parameter name="orientation">
+<parameter_description> expected orientation
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_gesture_rotate_get_angle_delta">
+<description>
+If @gesture is active, this function returns the angle difference
+in radians since the gesture was first recognized. If @gesture is
+not active, 0 is returned.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGestureRotate
+</parameter_description>
+</parameter>
+</parameters>
+<return> the angle delta in radians
+
+</return>
+</function>
+
+<function name="gtk_gesture_rotate_new">
+<description>
+Returns a newly created #GtkGesture that recognizes 2-touch
+rotation gestures.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly created #GtkGestureRotate
+
+</return>
+</function>
+
+<function name="gtk_gesture_set_sequence_state">
+<description>
+Sets the state of @sequence in @gesture. Sequences start
+in state #GTK_EVENT_SEQUENCE_NONE, and whenever they change
+state, they can never go back to that state. Likewise,
+sequences in state #GTK_EVENT_SEQUENCE_DENIED cannot turn
+back to a not denied state. With these rules, the lifetime
+of an event sequence is constrained to the next four:
+
+* None
+* None → Denied
+* None → Claimed
+* None → Claimed → Denied
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+<parameter name="sequence">
+<parameter_description> a #GdkEventSequence
+</parameter_description>
+</parameter>
+<parameter name="state">
+<parameter_description> the sequence state
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @sequence is handled by @gesture,
+and the state is changed successfully
+
+</return>
+</function>
+
+<function name="gtk_gesture_set_state">
+<description>
+Sets the state of all sequences that @gesture is currently
+interacting with. See gtk_gesture_set_sequence_state()
+for more details on sequence states.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+<parameter name="state">
+<parameter_description> the sequence state
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the state of at least one sequence
+was changed successfully
+
+</return>
+</function>
+
+<function name="gtk_gesture_set_window">
+<description>
+Sets a specific window to receive events about, so @gesture
+will effectively handle only events targeting @window, or
+a child of it. @window must pertain to gtk_event_controller_get_widget().
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+<parameter name="window">
+<parameter_description> a #GdkWindow, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_gesture_single_get_button">
+<description>
+Returns the button number @gesture listens for, or 0 if @gesture
+reacts to any button press.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGestureSingle
+</parameter_description>
+</parameter>
+</parameters>
+<return> The button number, or 0 for any button
+
+</return>
+</function>
+
+<function name="gtk_gesture_single_get_current_button">
+<description>
+Returns the button number currently interacting with @gesture, or 0 if there
+is none.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGestureSingle
+</parameter_description>
+</parameter>
+</parameters>
+<return> The current button number
+
+</return>
+</function>
+
+<function name="gtk_gesture_single_get_current_sequence">
+<description>
+Returns the event sequence currently interacting with @gesture.
+This is only meaningful if gtk_gesture_is_active() returns %TRUE.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGestureSingle
+</parameter_description>
+</parameter>
+</parameters>
+<return> the current sequence
+
+</return>
+</function>
+
+<function name="gtk_gesture_single_get_exclusive">
+<description>
+Gets whether a gesture is exclusive. For more information, see
+gtk_gesture_single_set_exclusive().
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGestureSingle
+</parameter_description>
+</parameter>
+</parameters>
+<return> Whether the gesture is exclusive
+
+</return>
+</function>
+
+<function name="gtk_gesture_single_get_touch_only">
+<description>
+Returns %TRUE if the gesture is only triggered by touch events.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGestureSingle
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the gesture only handles touch events
+
+</return>
+</function>
+
+<function name="gtk_gesture_single_set_button">
+<description>
+Sets the button number @gesture listens to. If non-0, every
+button press from a different button number will be ignored.
+Touch events implicitly match with button 1.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGestureSingle
+</parameter_description>
+</parameter>
+<parameter name="button">
+<parameter_description> button number to listen to, or 0 for any button
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_gesture_single_set_exclusive">
+<description>
+Sets whether @gesture is exclusive. An exclusive gesture will
+only handle pointer and "pointer emulated" touch events, so at
+any given time, there is only one sequence able to interact with
+those.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGestureSingle
+</parameter_description>
+</parameter>
+<parameter name="exclusive">
+<parameter_description> %TRUE to make @gesture exclusive
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_gesture_single_set_touch_only">
+<description>
+If @touch_only is %TRUE, @gesture will only handle events of type
+#GDK_TOUCH_BEGIN, #GDK_TOUCH_UPDATE or #GDK_TOUCH_END. If %FALSE,
+mouse events will be handled too.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGestureSingle
+</parameter_description>
+</parameter>
+<parameter name="touch_only">
+<parameter_description> whether @gesture handles only touch events
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_gesture_swipe_get_velocity">
+<description>
+If the gesture is recognized, this function returns %TRUE and fill in
+ velocity_x and @velocity_y with the recorded velocity, as per the
+last event(s) processed.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGestureSwipe
+</parameter_description>
+</parameter>
+<parameter name="velocity_x">
+<parameter_description> return value for the velocity in the X axis, in pixels/sec
+</parameter_description>
+</parameter>
+<parameter name="velocity_y">
+<parameter_description> return value for the velocity in the Y axis, in pixels/sec
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether velocity could be calculated
+
+</return>
+</function>
+
+<function name="gtk_gesture_swipe_new">
+<description>
+Returns a newly created #GtkGesture that recognizes swipes.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly created #GtkGestureSwipe
+
+</return>
+</function>
+
+<function name="gtk_gesture_ungroup">
+<description>
+Separates @gesture into an isolated group.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGesture
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_gesture_zoom_get_scale_delta">
+<description>
+If @gesture is active, this function returns the zooming difference
+since the gesture was recognized (hence the starting point is
+considered 1:1). If @gesture is not active, 1 is returned.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> a #GtkGestureZoom
+</parameter_description>
+</parameter>
+</parameters>
+<return> the scale delta
+
+</return>
+</function>
+
+<function name="gtk_gesture_zoom_new">
+<description>
+Returns a newly created #GtkGesture that recognizes zoom
+in/out gestures (usually known as pinch/zoom).
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly created #GtkGestureZoom
+
+</return>
+</function>
+
<function name="gtk_get_binary_age">
<description>
Returns the binary age as passed to `libtool`
@@ -38580,8 +40364,8 @@ when parsing the commandline arguments
</parameter_description>
</parameter>
</parameters>
-<return> a #GOptionGroup for the commandline arguments recognized
-by GTK+
+<return> a #GOptionGroup for the commandline
+arguments recognized by GTK+
</return>
</function>
@@ -39646,8 +41430,8 @@ Since: 3.10
<function name="gtk_header_bar_pack_end">
<description>
-Adds @child to @box, packed with reference to the
-end of the @box.
+Adds @child to @bar, packed with reference to the
+end of the @bar.
Since: 3.10
@@ -39667,8 +41451,8 @@ Since: 3.10
<function name="gtk_header_bar_pack_start">
<description>
-Adds @child to @box, packed with reference to the
-start of the @box.
+Adds @child to @bar, packed with reference to the
+start of the @bar.
Since: 3.10
@@ -39864,7 +41648,8 @@ Deprecated: 3.2: Use gtk_scale_new() with %GTK_ORIENTATION_HORIZONTAL instead
</description>
<parameters>
<parameter name="adjustment">
-<parameter_description> the #GtkAdjustment which sets the range of the scale.
+<parameter_description> the #GtkAdjustment which sets the range of
+the scale.
</parameter_description>
</parameter>
</parameters>
@@ -40225,11 +42010,11 @@ Deprecated: 3.10: Use #GtkIconTheme instead.
<function name="gtk_icon_factory_new">
<description>
Creates a new #GtkIconFactory. An icon factory manages a collection
-of #GtkIconSet<!-- -->s; a #GtkIconSet manages a set of variants of a
+of #GtkIconSets; a #GtkIconSet manages a set of variants of a
particular icon (i.e. a #GtkIconSet contains variants for different
sizes and widget states). Icons in an icon factory are named by a
stock ID, which is a simple string identifying the icon. Each
-#GtkStyle has a list of #GtkIconFactory<!-- -->s derived from the current
+#GtkStyle has a list of #GtkIconFactorys derived from the current
theme; those icon factories are consulted first when searching for
an icon. If the theme doesn’t set a particular icon, GTK+ looks for
the icon in a list of default icon factories, maintained by
@@ -40306,12 +42091,12 @@ Deprecated: 3.8: Use g_object_unref()
<function name="gtk_icon_info_get_attach_points">
<description>
-Fetches the set of attach points for an icon. An attach point
-is a location in the icon that can be used as anchor points for attaching
-emblems or overlays to the icon.
+This function is deprecated and always returns %FALSE.
Since: 2.4
+Deprecated: 3.14: Attachment points are deprecated
+
</description>
<parameters>
<parameter name="icon_info">
@@ -40319,26 +42104,28 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="points">
-<parameter_description> location to store pointer to an array of points, or %NULL
-free the array of points with g_free().
+<parameter_description> location to store pointer
+to an array of points, or %NULL free the array of points with g_free().
</parameter_description>
</parameter>
<parameter name="n_points">
-<parameter_description> location to store the number of points in @points, or %NULL
+<parameter_description> location to store the number of points in @points,
+or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if there are any attach points for the icon.
+<return> %FALSE
</return>
</function>
<function name="gtk_icon_info_get_base_scale">
<description>
-Gets the base scale for the icon. The base scale is a scale for the
-icon that was specified by the icon theme creator. For instance an
-icon drawn for a high-dpi screen with window-scale 2 for a base
-size of 32 will be 64 pixels tall and have a base_scale of 2.
+Gets the base scale for the icon. The base scale is a scale
+for the icon that was specified by the icon theme creator.
+For instance an icon drawn for a high-dpi screen with window
+scale 2 for a base size of 32 will be 64 pixels tall and have
+a base scale of 2.
Since: 3.10
@@ -40349,7 +42136,7 @@ Since: 3.10
</parameter_description>
</parameter>
</parameters>
-<return> the base scale.
+<return> the base scale
</return>
</function>
@@ -40385,10 +42172,9 @@ size is known for the icon.
<function name="gtk_icon_info_get_builtin_pixbuf">
<description>
-Gets the built-in image for this icon, if any. To allow
-GTK+ to use built in icon images, you must pass the
-%GTK_ICON_LOOKUP_USE_BUILTIN to
-gtk_icon_theme_lookup_icon().
+Gets the built-in image for this icon, if any. To allow GTK+ to use
+built in icon images, you must pass the %GTK_ICON_LOOKUP_USE_BUILTIN
+to gtk_icon_theme_lookup_icon().
Since: 2.4
@@ -40399,8 +42185,8 @@ Since: 2.4
</parameter_description>
</parameter>
</parameters>
-<return> the built-in image pixbuf, or %NULL. No
-extra reference is added to the returned pixbuf, so if
+<return> 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.
@@ -40409,12 +42195,12 @@ The returned image must not be modified.
<function name="gtk_icon_info_get_display_name">
<description>
-Gets the display name for an icon. A display name is a
-string to be used in place of the icon name in a user
-visible context like a list of icons.
+This function is deprecated and always returns %NULL.
Since: 2.4
+Deprecated: 3.14: Display names are deprecated
+
</description>
<parameters>
<parameter name="icon_info">
@@ -40422,23 +42208,19 @@ Since: 2.4
</parameter_description>
</parameter>
</parameters>
-<return> the display name for the icon or %NULL, if
-the icon doesn’t have a specified display name. This value
-is owned @icon_info and must not be modified or free.
+<return> %NULL
</return>
</function>
<function name="gtk_icon_info_get_embedded_rect">
<description>
-Gets the coordinates of a rectangle within the icon
-that can be used for display of information such
-as a preview of the contents of a text file.
-See gtk_icon_info_set_raw_coordinates() for further
-information about the coordinate system.
+This function is deprecated and always returns %FALSE.
Since: 2.4
+Deprecated: 3.14: Embedded rectangles are deprecated
+
</description>
<parameters>
<parameter name="icon_info">
@@ -40452,18 +42234,17 @@ when this function returns %TRUE.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the icon has an embedded rectangle
+<return> %FALSE
</return>
</function>
<function name="gtk_icon_info_get_filename">
<description>
-Gets the filename for the icon. If the
-%GTK_ICON_LOOKUP_USE_BUILTIN flag was passed
-to gtk_icon_theme_lookup_icon(), there may be
-no filename if a builtin icon is returned; in this
-case, you should use gtk_icon_info_get_builtin_pixbuf().
+Gets the filename for the icon. If the %GTK_ICON_LOOKUP_USE_BUILTIN
+flag was passed to gtk_icon_theme_lookup_icon(), there may be no
+filename if a builtin icon is returned; in this case, you should
+use gtk_icon_info_get_builtin_pixbuf().
Since: 2.4
@@ -40475,8 +42256,9 @@ Since: 2.4
</parameter>
</parameters>
<return> the filename for the icon, or %NULL
-if gtk_icon_info_get_builtin_pixbuf() should be used instead. The
-return value is owned by GTK+ and should not be modified or freed.
+if gtk_icon_info_get_builtin_pixbuf() should be used instead.
+The return value is owned by GTK+ and should not be modified
+or freed.
</return>
</function>
@@ -40496,7 +42278,7 @@ Since: 3.12
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the icon is symbolic, %FALSE otherwise.
+<return> %TRUE if the icon is symbolic, %FALSE otherwise
</return>
</function>
@@ -40554,8 +42336,7 @@ Since: 3.8
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object,
-%NULL to ignore
+<parameter_description> optional #GCancellable object, %NULL to ignore
</parameter_description>
</parameter>
<parameter name="callback">
@@ -40628,15 +42409,14 @@ Since: 3.10
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store error information on failure,
-or %NULL.
+<parameter_description> location for error information on failure, or %NULL
</parameter_description>
</parameter>
</parameters>
<return> the rendered icon; this may be a newly
created icon or a new reference to an internal icon, so you must
-not modify the icon. Use cairo_surface_destroy() to release your reference
-to the icon.
+not modify the icon. Use cairo_surface_destroy() to release your
+reference to the icon.
</return>
</function>
@@ -40837,11 +42617,11 @@ or %NULL.
<function name="gtk_icon_info_load_symbolic_for_context_async">
<description>
-Asynchronously load, render and scale a symbolic icon previously looked up
-from the icon theme using gtk_icon_theme_lookup_icon().
+Asynchronously load, render and scale a symbolic icon previously
+looked up from the icon theme using gtk_icon_theme_lookup_icon().
-For more details, see gtk_icon_info_load_symbolic_for_context() which is the synchronous
-version of this call.
+For more details, see gtk_icon_info_load_symbolic_for_context()
+which is the synchronous version of this call.
Since: 3.8
@@ -40995,6 +42775,8 @@ for older API's, and is not expected to be useful for applications.
Since: 2.4
+Deprecated: 3.14: Embedded rectangles and attachment points are deprecated
+
</description>
<parameters>
<parameter name="icon_info">
@@ -41585,7 +43367,7 @@ Retrieves the source pixbuf, or %NULL if none is set.
In addition, if a filename source is in use, this
function in some cases will return the pixbuf from
loaded from the filename. This is, for example, true
-for the GtkIconSource passed to the #GtkStyle render_icon(<!-- -->)
+for the GtkIconSource passed to the #GtkStyle render_icon()
virtual function. The reference count on the pixbuf is
not incremented.
@@ -41977,13 +43759,11 @@ Since: 2.4
</parameter>
<parameter name="size">
<parameter_description> the size in pixels at which to register the icon (different
-images can be registered for the same icon name
-at different sizes.)
+images can be registered for the same icon name at different sizes.)
</parameter_description>
</parameter>
<parameter name="pixbuf">
-<parameter_description> #GdkPixbuf that contains the image to use
-for @icon_name.
+<parameter_description> #GdkPixbuf that contains the image to use for @icon_name
</parameter_description>
</parameter>
</parameters>
@@ -42045,19 +43825,20 @@ icon names to lookup
</parameter_description>
</parameter>
</parameters>
-<return> a #GtkIconInfo object containing information
-about the icon, or %NULL if the icon wasn’t found.
+<return> a #GtkIconInfo object
+containing information about the icon, or %NULL if the icon wasn’t
+found.
</return>
</function>
<function name="gtk_icon_theme_choose_icon_for_scale">
<description>
-Looks up a named icon for a particular window scale and returns a
-#GtkIconInfo containing information such as the filename of the
+Looks up a named icon for a particular window scale and returns
+a #GtkIconInfo containing information such as the filename of the
icon. The icon can then be rendered into a pixbuf using
-gtk_icon_info_load_icon(). (gtk_icon_theme_load_icon() combines
-these two steps if all you need is the pixbuf.)
+gtk_icon_info_load_icon(). (gtk_icon_theme_load_icon()
+combines these two steps if all you need is the pixbuf.)
If @icon_names contains more than one name, this function
tries them all in the given order before falling back to
@@ -42072,8 +43853,8 @@ Since: 3.10
</parameter_description>
</parameter>
<parameter name="icon_names">
-<parameter_description> %NULL-terminated array of
-icon names to lookup
+<parameter_description> %NULL-terminated
+array of icon names to lookup
</parameter_description>
</parameter>
<parameter name="size">
@@ -42089,8 +43870,9 @@ icon names to lookup
</parameter_description>
</parameter>
</parameters>
-<return> a #GtkIconInfo object containing information
-about the icon, or %NULL if the icon wasn’t found.
+<return> a #GtkIconInfo object
+containing information about the icon, or %NULL if the
+icon wasn’t found.
</return>
</function>
@@ -42182,9 +43964,10 @@ Since: 2.6
</parameter_description>
</parameter>
</parameters>
-<return> An newly allocated array
-describing the sizes at which the icon is available. The array
-should be freed with g_free() when it is no longer needed.
+<return> An newly
+allocated array describing the sizes at which the icon is
+available. The array should be freed with g_free() when it is no
+longer needed.
</return>
</function>
@@ -42284,9 +44067,9 @@ icon, or %NULL to list all icons.
</parameter>
</parameters>
<return> 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().
+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().
</return>
</function>
@@ -42333,8 +44116,8 @@ or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> the rendered icon; this may be a
-newly created icon or a new reference to an internal icon, so
+<return> the rendered icon; this may be
+a newly created icon or a new reference to an internal icon, so
you must not modify the icon. Use g_object_unref() to release
your reference to the icon. %NULL if the icon isn’t found.
@@ -42388,8 +44171,8 @@ or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> the rendered icon; this may be a
-newly created icon or a new reference to an internal icon, so
+<return> the rendered icon; this may be
+a newly created icon or a new reference to an internal icon, so
you must not modify the icon. Use g_object_unref() to release
your reference to the icon. %NULL if the icon isn’t found.
@@ -42443,20 +44226,20 @@ or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> the rendered icon; this may be a
-newly created icon or a new reference to an internal icon, so
-you must not modify the icon. Use cairo_surface_destroy() to release
-your reference to the icon. %NULL if the icon isn’t found.
+<return> the rendered icon; this may be
+a newly created icon or a new reference to an internal icon, so
+you must not modify the icon. Use cairo_surface_destroy() to
+release your reference to the icon. %NULL if the icon isn’t
+found.
</return>
</function>
<function name="gtk_icon_theme_lookup_by_gicon">
<description>
-Looks up an icon and returns a #GtkIconInfo containing
-information such as the filename of the icon.
-The icon can then be rendered into a pixbuf using
-gtk_icon_info_load_icon().
+Looks up an icon and returns a #GtkIconInfo containing information
+such as the filename of the icon. The icon can then be rendered
+into a pixbuf using gtk_icon_info_load_icon().
Since: 2.14
@@ -42479,19 +44262,18 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> a #GtkIconInfo containing
-information about the icon, or %NULL if the icon
-wasn’t found. Unref with g_object_unref()
+<return> a #GtkIconInfo containing
+information about the icon, or %NULL if the icon wasn’t
+found. Unref with g_object_unref()
</return>
</function>
<function name="gtk_icon_theme_lookup_by_gicon_for_scale">
<description>
-Looks up an icon and returns a #GtkIconInfo containing
-information such as the filename of the icon.
-The icon can then be rendered into a pixbuf using
-gtk_icon_info_load_icon().
+Looks up an icon and returns a #GtkIconInfo containing information
+such as the filename of the icon. The icon can then be rendered into
+a pixbuf using gtk_icon_info_load_icon().
Since: 3.10
@@ -42519,8 +44301,8 @@ Since: 3.10
</parameter>
</parameters>
<return> a #GtkIconInfo containing
-information about the icon, or %NULL if the icon
-wasn’t found. Unref with g_object_unref()
+information about the icon, or %NULL if the icon wasn’t
+found. Unref with g_object_unref()
</return>
</function>
@@ -42554,8 +44336,9 @@ Since: 2.4
</parameter_description>
</parameter>
</parameters>
-<return> a #GtkIconInfo object containing information
-about the icon, or %NULL if the icon wasn’t found.
+<return> a #GtkIconInfo object
+containing information about the icon, or %NULL if the
+icon wasn’t found.
</return>
</function>
@@ -42593,8 +44376,9 @@ Since: 3.10
</parameter_description>
</parameter>
</parameters>
-<return> a #GtkIconInfo object containing
-information about the icon, or %NULL if the icon wasn’t found.
+<return> a #GtkIconInfo object
+containing information about the icon, or %NULL if the
+icon wasn’t found.
</return>
</function>
@@ -44559,7 +46343,7 @@ the length of the sequence should be zero.)
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> the table
+<parameter_description> the table
</parameter_description>
</parameter>
<parameter name="max_seq_len">
@@ -45636,7 +47420,8 @@ Since: 2.18
</parameter_description>
</parameter>
</parameters>
-<return> the #GtkButton widget that was added
+<return> the #GtkButton widget
+that was added
</return>
</function>
@@ -45915,6 +47700,10 @@ gtk_init_with_args() or g_option_context_parse() with
the option group returned by gtk_get_option_group(),
you don’t have to call gtk_init().
+And if you are using #GtkApplication, you don't have to call any of the
+initialization functions either; the #GtkApplication::startup handler
+does it for you.
+
This function will terminate your program if it was unable to
initialize the windowing system for some reason. If you want
your program to fall back to a textual interface you want to
@@ -46756,11 +48545,11 @@ Since: 2.6
<function name="gtk_label_set_justify">
<description>
Sets the alignment of the lines in the text of the label relative to
-each other. %GTK_JUSTIFY_LEFT is the default value when the
-widget is first created with gtk_label_new(). If you instead want
-to set the alignment of the label as a whole, use
-gtk_misc_set_alignment() instead. gtk_label_set_justify() has no
-effect on labels containing only a single line.
+each other. %GTK_JUSTIFY_LEFT is the default value when the widget is
+first created with gtk_label_new(). If you instead want to set the
+alignment of the label as a whole, use gtk_widget_set_halign() instead.
+gtk_label_set_justify() has no effect on labels containing only a
+single line.
</description>
<parameters>
@@ -47835,8 +49624,8 @@ Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
-<parameter_description> An #GtkListBox.
+<parameter name="box">
+<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
<parameter name="row">
@@ -47856,8 +49645,8 @@ Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
-<parameter_description> An #GtkListBox.
+<parameter name="box">
+<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
</parameters>
@@ -47872,7 +49661,7 @@ Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
@@ -47891,7 +49680,7 @@ Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
@@ -47903,13 +49692,15 @@ Since: 3.10
<function name="gtk_list_box_get_row_at_index">
<description>
-Gets the n:th child in the list (not counting headers).
+Gets the n-th child in the list (not counting headers).
+If @_index is negative or larger than the number of items in the
+list, %NULL is returned.
Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
@@ -47918,7 +49709,7 @@ Since: 3.10
</parameter_description>
</parameter>
</parameters>
-<return> the child #GtkWidget
+<return> the child #GtkWidget or %NULL
</return>
</function>
@@ -47931,7 +49722,7 @@ Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
@@ -47949,16 +49740,40 @@ Since: 3.10
<description>
Gets the selected row.
+Note that the box may allow multiple selection, in which
+case you should use gtk_list_box_selected_foreach() to
+find all selected rows.
+
Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
</parameters>
-<return> the selected #GtkWidget
+<return> the selected row
+
+</return>
+</function>
+
+<function name="gtk_list_box_get_selected_rows">
+<description>
+Creates a list of all selected children.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+</parameters>
+<return>
+A #GList containing the #GtkWidget for each selected child.
+Free with g_list_free() when done.
</return>
</function>
@@ -47971,7 +49786,7 @@ Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
@@ -47983,19 +49798,19 @@ Since: 3.10
<function name="gtk_list_box_insert">
<description>
-Insert the @child into the @list_box at @position. If a sort function is
+Insert the @child into the @box at @position. If a sort function is
set, the widget will actually be inserted at the calculated position and
this function has the same effect of gtk_container_add().
If @position is -1, or larger than the total number of items in the
- list_box, then the @child will be appended to the end.
+ box, then the @child will be appended to the end.
Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
-<parameter_description> a #GtkListBox.
+<parameter name="box">
+<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
<parameter name="child">
@@ -48013,7 +49828,7 @@ Since: 3.10
<function name="gtk_list_box_invalidate_filter">
<description>
Update the filtering for all rows. Call this when result
-of the filter function on the @list_box is changed due
+of the filter function on the @box is changed due
to an external factor. For instance, this would be used
if the filter function just looked for a specific search
string and the entry with the search string has changed.
@@ -48022,7 +49837,7 @@ Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
@@ -48033,14 +49848,14 @@ Since: 3.10
<function name="gtk_list_box_invalidate_headers">
<description>
Update the separators for all rows. Call this when result
-of the header function on the @list_box is changed due
+of the header function on the @box is changed due
to an external factor.
Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
@@ -48051,14 +49866,14 @@ Since: 3.10
<function name="gtk_list_box_invalidate_sort">
<description>
Update the sorting for all rows. Call this when result
-of the sort function on the @list_box is changed due
+of the sort function on the @box is changed due
to an external factor.
Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
@@ -48090,8 +49905,8 @@ Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
-<parameter_description> a #GtkListBox.
+<parameter name="box">
+<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
<parameter name="child">
@@ -48171,6 +49986,25 @@ Since: 3.10
</return>
</function>
+<function name="gtk_list_box_row_is_selected">
+<description>
+Returns whether the child is currently selected in its
+#GtkListBox container.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="row">
+<parameter_description> a #GtkListBoxRow
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @row is selected
+
+</return>
+</function>
+
<function name="gtk_list_box_row_new">
<description>
Creates a new #GtkListBoxRow, to be used as a child of a #GtkListBox.
@@ -48207,6 +50041,22 @@ Since: 3.10
<return></return>
</function>
+<function name="gtk_list_box_select_all">
+<description>
+Select all children of @box, if the selection mode allows it.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_list_box_select_row">
<description>
Make @row the currently selected row.
@@ -48215,7 +50065,7 @@ Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
@@ -48227,6 +50077,32 @@ Since: 3.10
<return></return>
</function>
+<function name="gtk_list_box_selected_foreach">
+<description>
+Calls a function for each selected child.
+
+Note that the selection cannot be modified from within this function.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> the function to call for each selected child
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> user data to pass to the function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_list_box_set_activate_on_single_click">
<description>
If @single is %TRUE, rows will be activated when you click on them,
@@ -48236,7 +50112,7 @@ Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
@@ -48254,7 +50130,7 @@ Sets the adjustment (if any) that the widget uses to
for vertical scrolling. For instance, this is used
to get the page size for PageUp/Down key handling.
-In the normal case when the @list_box is packed inside
+In the normal case when the @box is packed inside
a #GtkScrolledWindow the adjustment from that will
be picked up automatically, so there is no need
to manually do that.
@@ -48263,7 +50139,7 @@ Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
@@ -48277,7 +50153,7 @@ Since: 3.10
<function name="gtk_list_box_set_filter_func">
<description>
-By setting a filter function on the @list_box one can decide dynamically which
+By setting a filter function on the @box one can decide dynamically which
of the rows to show. For instance, to implement a search function on a list that
filters the original list to only show the matching rows.
@@ -48289,7 +50165,7 @@ Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
@@ -48311,7 +50187,7 @@ Since: 3.10
<function name="gtk_list_box_set_header_func">
<description>
-By setting a header function on the @list_box one can dynamically add headers
+By setting a header function on the @box one can dynamically add headers
in front of rows, depending on the contents of the row and its position in the list.
For instance, one could use it to add headers in front of the first item of a
new kind, in a list sorted by the kind.
@@ -48334,7 +50210,7 @@ Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
@@ -48357,13 +50233,13 @@ Since: 3.10
<function name="gtk_list_box_set_placeholder">
<description>
Sets the placeholder widget that is shown in the list when
-it doesn’t display any visible children.
+it doesn't display any visible children.
Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
@@ -48386,7 +50262,7 @@ Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
@@ -48400,7 +50276,7 @@ Since: 3.10
<function name="gtk_list_box_set_sort_func">
<description>
-By setting a sort function on the @list_box one can dynamically reorder the rows
+By setting a sort function on the @box one can dynamically reorder the rows
of the list, based on the contents of the rows.
The @sort_func will be called for each row after the call, and will continue to
@@ -48411,7 +50287,7 @@ Since: 3.10
</description>
<parameters>
-<parameter name="list_box">
+<parameter name="box">
<parameter_description> a #GtkListBox
</parameter_description>
</parameter>
@@ -48431,6 +50307,42 @@ Since: 3.10
<return></return>
</function>
+<function name="gtk_list_box_unselect_all">
+<description>
+Unselect all children of @box, if the selection mode allows it.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_list_box_unselect_row">
+<description>
+Unselects a single row of @box, if the selection mode allows it.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+<parameter name="row">
+<parameter_description> the row to unselected
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_list_store_append">
<description>
Appends a new row to @list_store. @iter will be changed to point to this new
@@ -50501,7 +52413,7 @@ the #GtkComboBox and should not be used by anyone else.
</parameter_description>
</parameter>
<parameter name="index">
-<parameter_description> the index of the menu item to select. Iindex values are
+<parameter_description> the index of the menu item to select. Index values are
from 0 to n-1
</parameter_description>
</parameter>
@@ -51099,6 +53011,37 @@ Since: 2.6
<return></return>
</function>
+<function name="gtk_menu_tracker_item_get_is_visible">
+<description>
+Don't use this unless you're tracking items for yourself -- normally
+the tracker will emit add/remove automatically when this changes.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #GtkMenuTrackerItem instance
+</parameter_description>
+</parameter>
+</parameters>
+<return> if the item should currently be shown
+</return>
+</function>
+
+<function name="gtk_menu_tracker_item_may_disappear">
+<description>
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #GtkMenuTrackerItem instance
+</parameter_description>
+</parameter>
+</parameters>
+<return> if the item may disappear (ie: is-visible property may change)
+</return>
+</function>
+
<function name="gtk_message_dialog_format_secondary_markup">
<description>
Sets the secondary text of the message dialog to be @message_format (with
@@ -51357,6 +53300,8 @@ Since: 2.4
Gets the X and Y alignment of the widget within its allocation.
See gtk_misc_set_alignment().
+Deprecated: 3.14: Use #GtkWidget alignment and margin properties.
+
</description>
<parameters>
<parameter name="misc">
@@ -51380,6 +53325,8 @@ See gtk_misc_set_alignment().
Gets the padding in the X and Y directions of the widget.
See gtk_misc_set_padding().
+Deprecated: 3.14: Use #GtkWidget alignment and margin properties.
+
</description>
<parameters>
<parameter name="misc">
@@ -51404,6 +53351,8 @@ direction, or %NULL
<description>
Sets the alignment of the widget.
+Deprecated: 3.14: Use #GtkWidget alignment and margin properties.
+
</description>
<parameters>
<parameter name="misc">
@@ -51426,6 +53375,8 @@ Sets the alignment of the widget.
<description>
Sets the amount of space to add around the widget.
+Deprecated: 3.14: Use #GtkWidget alignment and margin properties.
+
</description>
<parameters>
<parameter name="misc">
@@ -52581,6 +54532,8 @@ a reference to the returned #GIcon.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="self">
@@ -52600,6 +54553,8 @@ or %NULL if there’s none.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="self">
@@ -52618,6 +54573,8 @@ Returns the value currently displayed by @self.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="self">
@@ -52636,6 +54593,8 @@ Returns the currently displayed label of the icon, or %NULL.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="self">
@@ -52655,6 +54614,8 @@ or %NULL if there’s none.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="self">
@@ -52675,6 +54636,8 @@ Creates a new unthemed #GtkNumerableIcon.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="base_icon">
@@ -52695,6 +54658,8 @@ that calls gtk_numerable_icon_set_style_context() internally.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="base_icon">
@@ -52724,6 +54689,8 @@ gtk_numerable_icon_set_background_icon_name() has always priority.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="self">
@@ -52752,6 +54719,8 @@ and gtk_numerable_icon_set_background_gicon() has always priority.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="self">
@@ -52779,6 +54748,8 @@ and gtk_numerable_icon_set_label() has always priority.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="self">
@@ -52811,6 +54782,8 @@ has always priority.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="self">
@@ -52832,6 +54805,8 @@ given #GtkStyleContext.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="self">
@@ -55600,6 +57575,24 @@ Since: 3.10
</return>
</function>
+<function name="gtk_places_sidebar_get_show_enter_location">
+<description>
+Returns the value previously set with gtk_places_sidebar_set_show_enter_location()
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a places sidebar
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the sidebar will display an “Enter Location” item.
+
+</return>
+</function>
+
<function name="gtk_places_sidebar_list_shortcuts">
<description>
Gets the list of shortcuts.
@@ -55787,6 +57780,28 @@ Since: 3.10
<return></return>
</function>
+<function name="gtk_places_sidebar_set_show_enter_location">
+<description>
+Sets whether the @sidebar should show an item for connecting to a network server; this is off by default.
+An application may want to turn this on if it implements a way for the user to connect
+to network servers directly.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a places sidebar
+</parameter_description>
+</parameter>
+<parameter name="show_enter_location">
+<parameter_description> whether to show an item for the Connect to Server command
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_plug_construct">
<description>
Finish the initialization of @plug for a given #GtkSocket identified by
@@ -58381,7 +60396,6 @@ Since: 2.10
Gets the value of %GTK_PRINT_SETTINGS_MEDIA_TYPE.
The set of media types is defined in PWG 5101.1-2002 PWG.
-<!-- FIXME link here -->
Since: 2.10
@@ -59157,7 +61171,6 @@ Since: 2.10
Sets the value of %GTK_PRINT_SETTINGS_MEDIA_TYPE.
The set of media types is defined in PWG 5101.1-2002 PWG.
-<!-- FIXME link here -->
Since: 2.10
@@ -62251,11 +64264,12 @@ when matching against class styles, or #G_TYPE_NONE
</parameter_description>
</parameter>
</parameters>
-<return> A style created by matching with the
-supplied paths, or %NULL if nothing matching was specified and the
-default style should be used. The returned value is owned by GTK+
-as part of an internal cache, so you must call g_object_ref() on
-the returned value if you want to keep a reference to it.
+<return> A style created by matching
+with the supplied paths, or %NULL if nothing matching was
+specified and the default style should be used. The returned
+value is owned by GTK+ as part of an internal cache, so you
+must call g_object_ref() on the returned value if you want to
+keep a reference to it.
</return>
</function>
@@ -63833,7 +65847,9 @@ Since: 2.10
<description>
Tests whether a file should be displayed according to @filter.
The #GtkRecentFilterInfo @filter_info should include
-the fields returned from gtk_recent_filter_get_needed().
+the fields returned from gtk_recent_filter_get_needed(), and
+must set the #GtkRecentFilterInfo.contains field of @filter_info
+to indicate which fields have been set.
This function will not typically be used by applications; it
is intended principally for use in the implementation of
@@ -66500,8 +68516,7 @@ Since: 2.8
</parameter_description>
</parameter>
</parameters>
-<return> the horizontal scrollbar of the scrolled window,
-or %NULL if it does not have one.
+<return> the horizontal scrollbar of the scrolled window.
</return>
</function>
@@ -66652,8 +68667,7 @@ Since: 2.8
</parameter_description>
</parameter>
</parameters>
-<return> the vertical scrollbar of the scrolled window,
-or %NULL if it does not have one.
+<return> the vertical scrollbar of the scrolled window.
</return>
</function>
@@ -67242,7 +69256,8 @@ Since: 2.14
</description>
<parameters>
<parameter name="selection_data">
-<parameter_description> a pointer to a #GtkSelectionData-struct.
+<parameter_description> a pointer to a
+#GtkSelectionData-struct.
</parameter_description>
</parameter>
</parameters>
@@ -67358,10 +69373,11 @@ Since: 2.6
</parameter_description>
</parameter>
</parameters>
-<return> if the selection data contained a recognized
-image type and it could be converted to a #GdkPixbuf, a
-newly allocated pixbuf is returned, otherwise %NULL.
-If the result is non-%NULL it must be freed with g_object_unref().
+<return> if the selection data
+contained a recognized image type and it could be converted to a
+#GdkPixbuf, a newly allocated pixbuf is returned, otherwise
+%NULL. If the result is non-%NULL it must be freed with
+g_object_unref().
</return>
</function>
@@ -67927,7 +69943,7 @@ or ftp://, as only local files are handled by GIO itself).
Typical examples are
- `file:///home/gnome/pict.jpg`
- `http://www.gnome.org`
-- `mailto:me\ gnome org`
+- `mailto:me gnome org`
Ideally the timestamp is taken from the event triggering
the gtk_show_uri() call. If timestamp is not known you can take
%GDK_CURRENT_TIME.
@@ -70605,6 +72621,8 @@ and “-”, starting always with a lowercase letter.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="context">
@@ -71187,6 +73205,8 @@ affecting the region.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="context">
@@ -71254,6 +73274,8 @@ Returns the list of regions currently defined in @context.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="context">
@@ -71526,6 +73548,8 @@ Removes a region from @context.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="context">
@@ -72624,6 +74648,24 @@ Since: 3.0
</return>
</function>
+<function name="gtk_switch_get_state">
+<description>
+Gets the underlying state of the #GtkSwitch.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="sw">
+<parameter_description> a #GtkSwitch
+</parameter_description>
+</parameter>
+</parameters>
+<return> the underlying state
+
+</return>
+</function>
+
<function name="gtk_switch_new">
<description>
Creates a new #GtkSwitch widget.
@@ -72658,6 +74700,32 @@ Since: 3.0
<return></return>
</function>
+<function name="gtk_switch_set_state">
+<description>
+Sets the underlying state of the #GtkSwitch.
+
+Normally, this is the same as #GtkSwitch:active, unless the switch
+is set up for delayed state changes. This function is typically
+called from a #GtkSwitch::state-set signal handler.
+
+See #GtkSwitch::state-set for details.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="sw">
+<parameter_description> a #GtkSwitch
+</parameter_description>
+</parameter>
+<parameter name="state">
+<parameter_description> the new state
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_symbolic_color_new_alpha">
<description>
Creates a symbolic color by modifying the relative alpha
@@ -73564,7 +75632,8 @@ Creates a new #GtkTargetList from an array of #GtkTargetEntry.
</description>
<parameters>
<parameter name="targets">
-<parameter_description> Pointer to an array of #GtkTargetEntry
+<parameter_description> Pointer to an array
+of #GtkTargetEntry
</parameter_description>
</parameter>
<parameter name="ntargets">
@@ -78087,7 +80156,8 @@ Invisible text is usually invisible because a #GtkTextTag with the
</parameter_description>
</parameter>
</parameters>
-<return> string containing visible text in the range
+<return> string containing visible text in the
+range
</return>
</function>
@@ -78159,10 +80229,13 @@ correct fix would be to the Pango text boundary algorithms).
<function name="gtk_text_iter_inside_word">
<description>
-Determines whether @iter is inside a natural-language word (as
-opposed to say inside some whitespace). Word breaks are determined
-by Pango and should be correct for nearly any language (if not, the
-correct fix would be to the Pango word break algorithms).
+Determines whether the character pointed by @iter is part of a
+natural-language word (as opposed to say inside some whitespace). Word
+breaks are determined by Pango and should be correct for nearly any language
+(if not, the correct fix would be to the Pango word break algorithms).
+
+Note that if gtk_text_iter_starts_word() returns %TRUE, then this function
+returns %TRUE too, since @iter points to the first character of the word.
</description>
@@ -79171,6 +81244,7 @@ in the table.
@tag must not be in a tag table already, and may not have
the same name as an already-added tag.
+
</description>
<parameters>
<parameter name="table">
@@ -79182,7 +81256,8 @@ the same name as an already-added tag.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE on success.
+</return>
</function>
<function name="gtk_text_tag_table_foreach">
@@ -81280,6 +83355,8 @@ to the flags affecting the region.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="engine">
@@ -84305,6 +86382,17 @@ Since: 2.12
<return></return>
</function>
+<function name="gtk_toplevel_accessible_get_children">
+<description>
+
+</description>
+<parameters>
+</parameters>
+<return> List of
+children.
+</return>
+</function>
+
<function name="gtk_tree_drag_dest_drag_data_received">
<description>
Asks the #GtkTreeDragDest to insert a row before the path @dest,
@@ -87374,11 +89462,11 @@ Since: 2.2
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore.
+<parameter_description> A #GtkTreeStore
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> A #GtkTreeIter.
+<parameter_description> A #GtkTreeIter, or %NULL
</parameter_description>
</parameter>
<parameter name="new_order">
@@ -89278,11 +91366,13 @@ you are done with it.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> A pointer to be filled with the current cursor path, or %NULL
+<parameter_description> A pointer to be
+filled with the current cursor path, or %NULL
</parameter_description>
</parameter>
<parameter name="focus_column">
-<parameter_description> A pointer to be filled with the current focus column, or %NULL
+<parameter_description> A
+pointer to be filled with the current focus column, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -89312,11 +91402,13 @@ return %FALSE if @tree_view is not realized or does not have a model.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> Return location for the path of the highlighted row, or %NULL.
+<parameter_description> Return location for the path of
+the highlighted row, or %NULL.
</parameter_description>
</parameter>
<parameter name="pos">
-<parameter_description> Return location for the drop position, or %NULL
+<parameter_description> Return location for the drop position, or
+%NULL
</parameter_description>
</parameter>
</parameters>
@@ -89559,7 +91651,8 @@ model is unset.
</parameter_description>
</parameter>
</parameters>
-<return> A #GtkTreeModel, or %NULL if none is currently being used.
+<return> A #GtkTreeModel, or %NULL if
+none is currently being used.
</return>
</function>
@@ -89617,19 +91710,23 @@ gtk_tree_view_convert_widget_to_bin_window_coords().
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> A pointer to a #GtkTreePath pointer to be filled in, or %NULL
+<parameter_description> A pointer to a #GtkTreePath
+pointer to be filled in, or %NULL
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> A pointer to a #GtkTreeViewColumn pointer to be filled in, or %NULL
+<parameter_description> A pointer to
+a #GtkTreeViewColumn pointer to be filled in, or %NULL
</parameter_description>
</parameter>
<parameter name="cell_x">
-<parameter_description> A pointer where the X coordinate relative to the cell can be placed, or %NULL
+<parameter_description> A pointer where the X coordinate
+relative to the cell can be placed, or %NULL
</parameter_description>
</parameter>
<parameter name="cell_y">
-<parameter_description> A pointer where the Y coordinate relative to the cell can be placed, or %NULL
+<parameter_description> A pointer where the Y coordinate
+relative to the cell can be placed, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -89868,8 +91965,8 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> a pointer to receive a
-#GtkTreeModel or %NULL
+<parameter_description> a pointer to
+receive a #GtkTreeModel or %NULL
</parameter_description>
</parameter>
<parameter name="path">
@@ -91699,7 +93796,7 @@ Deprecated: 3.10
<function name="gtk_ui_manager_remove_ui">
<description>
-Unmerges the part of @manager<!-- -->s content identified by @merge_id.
+Unmerges the part of @manager's content identified by @merge_id.
Since: 2.4
@@ -93389,6 +95486,32 @@ never should be called by an application.
</return>
</function>
+<function name="gtk_widget_get_clip">
+<description>
+Retrieves the widget’s clip area.
+
+The clip area is the area in which all of @widget's drawing will
+happen. Other toolkits call it the bounding box.
+
+Historically, in GTK+ the clip area has been equal to the allocation
+retrieved via gtk_widget_get_allocation().
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="clip">
+<parameter_description> a pointer to a #GtkAllocation to copy to
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_widget_get_clipboard">
<description>
Returns the clipboard object for the given selection to
@@ -93974,8 +96097,8 @@ Since: 2.4
<function name="gtk_widget_get_opacity">
<description>
-Fetches the requested opacity for this widget. See
-gtk_widget_set_opacity().
+Fetches the requested opacity for this widget.
+See gtk_widget_set_opacity().
Since: 3.8
@@ -94553,7 +96676,7 @@ Returns the widget’s state. See gtk_widget_set_state().
Since: 2.18
-Deprecated: 3.0. Use gtk_widget_get_state_flags() instead.
+Deprecated: 3.0: Use gtk_widget_get_state_flags() instead.
</description>
<parameters>
@@ -94777,7 +96900,9 @@ Gets the value of the #GtkWidget:valign property.
For backwards compatibility reasons this method will never return
%GTK_ALIGN_BASELINE, but instead it will convert it to
%GTK_ALIGN_FILL. If your widget want to support baseline aligned
-children it must use gtk_widget_get_valign_with_baseline().
+children it must use gtk_widget_get_valign_with_baseline(), or
+`g_object_get (widget, "valign", &value, NULL)`, which will
+also report the true value.
</description>
@@ -95625,7 +97750,7 @@ See also gtk_widget_modify_style().
Since: 2.12
-Deprecated: 3.0. Use gtk_widget_override_cursor() instead.
+Deprecated: 3.0: Use gtk_widget_override_cursor() instead.
</description>
<parameters>
@@ -95634,15 +97759,15 @@ Deprecated: 3.0. Use gtk_widget_override_cursor() instead.
</parameter_description>
</parameter>
<parameter name="primary">
-<parameter_description> the color to use for primary cursor (does not need to be
-allocated), or %NULL to undo the effect of previous calls to
-of gtk_widget_modify_cursor().
+<parameter_description> the color to use for primary cursor (does not
+need to be allocated), or %NULL to undo the effect of previous
+calls to of gtk_widget_modify_cursor().
</parameter_description>
</parameter>
<parameter name="secondary">
-<parameter_description> the color to use for secondary cursor (does not need to be
-allocated), or %NULL to undo the effect of previous calls to
-of gtk_widget_modify_cursor().
+<parameter_description> the color to use for secondary cursor (does
+not need to be allocated), or %NULL to undo the effect of
+previous calls to of gtk_widget_modify_cursor().
</parameter_description>
</parameter>
</parameters>
@@ -96226,6 +98351,8 @@ and “-”, starting always with a lowercase letter.
Since: 3.0
+Deprecated: 3.14: The use of regions is deprecated.
+
</description>
<parameters>
<parameter name="path">
@@ -96276,6 +98403,8 @@ hierarchy defined in @path.
Since: 3.0
+Deprecated: 3.14: The use of regions is deprecated.
+
</description>
<parameters>
<parameter name="path">
@@ -96494,6 +98623,8 @@ with GQuarks.
Since: 3.0
+Deprecated: 3.14: The use of regions is deprecated.
+
</description>
<parameters>
<parameter name="path">
@@ -96525,6 +98656,8 @@ defined, %FALSE otherwise.
Since: 3.0
+Deprecated: 3.14: The use of regions is deprecated.
+
</description>
<parameters>
<parameter name="path">
@@ -96582,6 +98715,8 @@ at position @pos in the hierarchy defined in @path.
Since: 3.0
+Deprecated: 3.14: The use of regions is deprecated.
+
</description>
<parameters>
<parameter name="path">
@@ -96633,6 +98768,8 @@ the hierarchy defined in @path.
Since: 3.0
+Deprecated: 3.14: The use of regions is deprecated.
+
</description>
<parameters>
<parameter name="path">
@@ -97020,6 +99157,8 @@ Computes the intersection of a @widget’s area and @region, returning
the intersection. The result may be empty, use cairo_region_is_empty() to
check.
+Deprecated: 3.14: Use gtk_widget_get_allocation() and
+cairo_region_intersect_rectangle() to get the same behavior.
</description>
<parameters>
@@ -97039,6 +99178,7 @@ of @widget->window for widgets with their own window.
and @region. The coordinates of the return value are relative to
@widget->window for %NO_WINDOW widgets, and relative to the parent
window of @widget->window for widgets with their own window.
+
</return>
</function>
@@ -97230,6 +99370,8 @@ stock ID wasn’t known
Moves a widget from one #GtkContainer to another, handling reference
count issues to avoid destroying the widget.
+Deprecated: 3.14: Use gtk_container_remove() and gtk_container_add().
+
</description>
<parameters>
<parameter name="widget">
@@ -97534,6 +99676,42 @@ never should be called by an application.
<return></return>
</function>
+<function name="gtk_widget_set_clip">
+<description>
+Sets the widget’s clip. This must not be used
+directly, but from within a widget’s size_allocate method.
+
+The clip set should be the area that @widget draws on. If @widget is a
+#GtkContainer, the area must contain all children's clips.
+
+If this function is not called by @widget during a ::size-allocate handler,
+it is assumed to be equal to the allocation. However, if the function is
+not called, certain features that might extend a widget's allocation will
+not be available:
+
+* The #GtkWidget::draw signal will be clipped to the widget's allocation
+to avoid overdraw.
+* Calling gtk_render_background() will not draw outset shadows.
+
+It is therefore suggested that you always call gtk_widget_set_clip() during
+a ::size-allocate handler.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="clip">
+<parameter_description> a pointer to a #GtkAllocation to copy from
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_widget_set_composite_name">
<description>
Sets a widgets composite name. The widget must be
@@ -97664,27 +99842,9 @@ set by gtk_widget_set_default_direction() will be used.
<function name="gtk_widget_set_double_buffered">
<description>
-Widgets are double buffered by default; you can use this function
-to turn off the buffering. “Double buffered” simply means that
-gdk_window_begin_paint_region() and gdk_window_end_paint() are called
-automatically around expose events sent to the
-widget. gdk_window_begin_paint_region() diverts all drawing to a widget's
-window to an offscreen buffer, and gdk_window_end_paint() draws the
-buffer to the screen. The result is that users see the window
-update in one smooth step, and don’t see individual graphics
-primitives being rendered.
-
-In very simple terms, double buffered widgets don’t flicker,
-so you would only use this function to turn off double buffering
-if you had special needs and really knew what you were doing.
-
-Note: if you turn off double-buffering, you have to handle
-expose events, since even the clearing to the background color or
-pixmap will not happen automatically (as it is done in
-gdk_window_begin_paint_region()).
-
-Since 3.10 this function only works for widgets with native
-windows.
+This function does nothing.
+
+Deprecated: 3.14: Widgets are always double-buffered.
</description>
<parameters>
@@ -98157,7 +100317,9 @@ window is realized.
<function name="gtk_widget_set_realized">
<description>
-Marks the widget as being realized.
+Marks the widget as being realized. This function must only be
+called after all #GdkWindows for the @widget have been created
+and registered.
This function should only ever be called in a derived widget's
“realize” or “unrealize” implementation.
@@ -98315,7 +100477,7 @@ This function is for use in widget implementations. Sets the state
of a widget (insensitive, prelighted, etc.) Usually you should set
the state using wrapper functions such as gtk_widget_set_sensitive().
-Deprecated: 3.0. Use gtk_widget_set_state_flags() instead.
+Deprecated: 3.0: Use gtk_widget_set_state_flags() instead.
</description>
<parameters>
@@ -98822,7 +100984,7 @@ implementation which does not chain up to its parent class'
Since: 2.20
-Deprecated: 3.0. This step is unnecessary with #GtkStyleContext.
+Deprecated: 3.0: This step is unnecessary with #GtkStyleContext.
</description>
<parameters>
@@ -100458,7 +102620,7 @@ gtk_window_list_toplevels(). Due to Gtk+ keeping a reference to
the window internally, gtk_window_new() does not return a reference
to the caller.
-To delete a #GtkWindow, call gtk_window_destroy().
+To delete a #GtkWindow, call gtk_widget_destroy().
</description>
@@ -100515,8 +102677,7 @@ GdkGeometry size_hints = {
gtk_init (&argc, &argv);
window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
-vbox = gtk_box_new (GTK_ORIENTATION_VERTICAL,
-FALSE, 0);
+vbox = gtk_box_new (GTK_ORIENTATION_VERTICAL, 0);
gtk_container_add (GTK_CONTAINER (window), vbox);
fill_with_content (vbox);
@@ -101468,6 +103629,24 @@ Since: 2.6
<return></return>
</function>
+<function name="gtk_window_set_interactive_debugging">
+<description>
+Opens or closes the [interactive debugger][interactive-debugging],
+which offers access to the widget hierarchy of the application
+and to useful debugging tools.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="enable">
+<parameter_description> %TRUE to enable interactive debugging
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_window_set_keep_above">
<description>
Asks to keep @window above, so that it stays on top. Note that
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
