[gtkmm] Regenerate C docs .xml files.
- From: Murray Cumming <murrayc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtkmm] Regenerate C docs .xml files.
- Date: Fri, 17 Jan 2014 09:51:32 +0000 (UTC)
commit ddb820a53352822296f2f555853456d5f8bf0f31
Author: Murray Cumming <murrayc murrayc com>
Date: Fri Jan 17 10:13:05 2014 +0100
Regenerate C docs .xml files.
gdk/src/gdk_docs.xml | 157 ++++--
gtk/src/gtk_docs.xml | 1705 ++++++++++++++++++++++++++++++++++++++++++++++++--
2 files changed, 1754 insertions(+), 108 deletions(-)
---
diff --git a/gdk/src/gdk_docs.xml b/gdk/src/gdk_docs.xml
index 033076f..fcc5df7 100644
--- a/gdk/src/gdk_docs.xml
+++ b/gdk/src/gdk_docs.xml
@@ -707,15 +707,18 @@ A set of bit-flags to indicate which events a window is to receive.
Most of these masks map onto one or more of the #GdkEventType event types
above.
-%GDK_POINTER_MOTION_HINT_MASK is a special mask which is used to reduce the
-number of %GDK_MOTION_NOTIFY events received. Normally a %GDK_MOTION_NOTIFY
-event is received each time the mouse moves. However, if the application
-spends a lot of time processing the event (updating the display, for example),
-it can lag behind the position of the mouse. When using
-%GDK_POINTER_MOTION_HINT_MASK, fewer %GDK_MOTION_NOTIFY events will be sent,
-some of which are marked as a hint (the is_hint member is %TRUE).
-To receive more motion events after a motion hint event, the application
-needs to asks for more, by calling gdk_event_request_motions().
+%GDK_POINTER_MOTION_HINT_MASK is deprecated. It is a special mask
+to reduce the number of %GDK_MOTION_NOTIFY events received. When using
+%GDK_POINTER_MOTION_HINT_MASK, fewer %GDK_MOTION_NOTIFY events will
+be sent, some of which are marked as a hint (the is_hint member is
+%TRUE). To receive more motion events after a motion hint event,
+the application needs to asks for more, by calling
+gdk_event_request_motions().
+
+Since GTK 3.8, motion events are already compressed by default, independent
+of this mechanism. This compression can be disabled with
+gdk_window_set_event_compression(). See the documentation of that function
+for details.
If %GDK_TOUCH_MASK is enabled, the window will receive touch events
from touch-enabled devices. Those will come as sequences of #GdkEventTouch
@@ -735,7 +738,7 @@ events, so different sequences may be distinguished.
</parameter_description>
</parameter>
<parameter name="GDK_POINTER_MOTION_HINT_MASK">
-<parameter_description> see the explanation above
+<parameter_description> deprecated. see the explanation above
</parameter_description>
</parameter>
<parameter name="GDK_BUTTON_MOTION_MASK">
@@ -3951,6 +3954,10 @@ do not support motion history, in which case, %FALSE will
be returned. (This is not distinguishable from the case where
motion history is supported and no events were found.)
+Note that there is also gdk_window_set_event_compression() to get
+more motion events delivered directly, independent of the windowing
+system.
+
</description>
<parameters>
@@ -14186,7 +14193,7 @@ Since: 3.8
</return>
</function>
-<function name="gdk_wayland_display_get_wl_shell">
+<function name="gdk_wayland_display_get_xdg_shell">
<description>
Returns the Wayland global singleton shell of a #GdkDisplay
@@ -14199,25 +14206,7 @@ Since: 3.8
</parameter_description>
</parameter>
</parameters>
-<return> a Wayland wl_shell
-
-</return>
-</function>
-
-<function name="gdk_wayland_window_get_wl_shell_surface">
-<description>
-Returns the Wayland shell surface of a #GdkWindow
-
-Since: 3.8
-
-</description>
-<parameters>
-<parameter name="window">
-<parameter_description> a #GdkWindow
-</parameter_description>
-</parameter>
-</parameters>
-<return> a Wayland wl_shell_surface
+<return> a Wayland xdg_shell
</return>
</function>
@@ -14386,7 +14375,7 @@ to begin a drag with a different device.
</parameter_description>
</parameter>
<parameter name="button">
-<parameter_description> the button being used to drag
+<parameter_description> the button being used to drag, or 0 for a keyboard-initiated drag
</parameter_description>
</parameter>
<parameter name="root_x">
@@ -14427,7 +14416,7 @@ Since: 3.4
</parameter_description>
</parameter>
<parameter name="button">
-<parameter_description> the button being used to drag
+<parameter_description> the button being used to drag, or 0 for a keyboard-initiated drag
</parameter_description>
</parameter>
<parameter name="root_x">
@@ -14542,7 +14531,7 @@ to begin a drag with a different device.
</parameter_description>
</parameter>
<parameter name="button">
-<parameter_description> the button being used to drag
+<parameter_description> the button being used to drag, or 0 for a keyboard-initiated drag
</parameter_description>
</parameter>
<parameter name="root_x">
@@ -14586,7 +14575,7 @@ Since: 3.4
</parameter_description>
</parameter>
<parameter name="button">
-<parameter_description> the button being used to drag
+<parameter_description> the button being used to drag, or 0 for a keyboard-initiated drag
</parameter_description>
</parameter>
<parameter name="root_x">
@@ -15468,6 +15457,24 @@ Since: 2.22
</return>
</function>
+<function name="gdk_window_get_event_compression">
+<description>
+Get the current event compression setting for this window.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GdkWindow
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if motion events will be compressed
+
+</return>
+</function>
+
<function name="gdk_window_get_events">
<description>
Gets the event mask for @window for all master input devices. See
@@ -16911,7 +16918,7 @@ Deprecated: 3.4: Use gdk_window_set_background_rgba() instead.
Sets the background of @window.
A background of %NULL means that the window will inherit its
-background form its parent window.
+background from its parent window.
The windowing system will normally fill a window with its background
when the window is obscured then exposed.
@@ -17172,6 +17179,33 @@ Since: 3.0
<return></return>
</function>
+<function name="gdk_window_set_event_compression">
+<description>
+Determines whether or not extra unprocessed motion events in
+the event queue can be discarded. If %TRUE only the most recent
+event will be delivered.
+
+Some types of applications, e.g. paint programs, need to see all
+motion events and will benefit from turning off event compression.
+
+By default, event compression is enabled.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GdkWindow
+</parameter_description>
+</parameter>
+<parameter name="event_compression">
+<parameter_description> %TRUE if motion events should be compressed
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gdk_window_set_events">
<description>
The event mask for a window determines which events will be reported
@@ -17640,6 +17674,46 @@ non-interchangeable kind of window.
<return></return>
</function>
+<function name="gdk_window_set_shadow_width">
+<description>
+Newer GTK+ windows using client-side decorations use extra geometry
+around their frames for effects like shadows and invisible borders.
+Window managers that want to maximize windows or snap to edges need
+to know where the extents of the actual frame lie, so that users
+don't feel like windows are snapping against random invisible edges.
+
+Note that this property is automatically updated by GTK+, so this
+function should only be used by applications which do not use GTK+
+to create toplevel windows.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GdkWindow
+</parameter_description>
+</parameter>
+<parameter name="left">
+<parameter_description> The left extent
+</parameter_description>
+</parameter>
+<parameter name="right">
+<parameter_description> The right extent
+</parameter_description>
+</parameter>
+<parameter name="top">
+<parameter_description> The top extent
+</parameter_description>
+</parameter>
+<parameter name="bottom">
+<parameter_description> The bottom extent
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gdk_window_set_skip_pager_hint">
<description>
Toggles whether a window should appear in a pager (workspace
@@ -19326,18 +19400,13 @@ Since: 3.10
<function name="gdk_x11_window_set_frame_extents">
<description>
-Newer GTK+ windows using client-side decorations use extra geometry
-around their frames for effects like shadows and invisible borders.
-Window managers that want to maximize windows or snap to edges need
-to know where the extents of the actual frame lie, so that users
-don't feel like windows are snapping against random invisible edges.
-
-Note that this property is automatically updated by GTK+, so this
-function should only be used by applications which do not use GTK+
-to create toplevel windows.
+This is the same as gdk_window_set_shadow_width() but it only works
+on GdkX11Window.
Since: 3.10
+Deprecated: 3.12: Use gdk_window_set_shadow_width() instead.
+
</description>
<parameters>
<parameter name="window">
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index e4c21c0..607e221 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -947,10 +947,6 @@ contains. (See also: #GtkVButtonBox and #GtkHButtonBox).
</description>
<parameters>
-<parameter name="GTK_BUTTONBOX_DEFAULT_STYLE">
-<parameter_description> Default packing.
-</parameter_description>
-</parameter>
<parameter name="GTK_BUTTONBOX_SPREAD">
<parameter_description> Buttons are evenly spread across the box.
</parameter_description>
@@ -3018,6 +3014,176 @@ display the file in the file chooser
</parameters>
</enum>
+<signal name="GtkFlowBox::activate-cursor-child">
+<description>
+The ::activate-cursor-child signal is a
+<link linkend="keybinding-signals">keybinding signal</link>
+which gets emitted when the user activates the @box.
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> the #GtkFlowBox on which the signal is emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkFlowBox::child-activated">
+<description>
+The ::child-activated signal is emitted when a child has been
+activated by the user.
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> the #GtkFlowBox on which the signal is emitted
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> the child that is activated
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkFlowBox::move-cursor">
+<description>
+The ::move-cursor signal is a
+<link linkend="keybinding-signals">keybinding signal</link>
+which gets emitted when the user initiates a cursor movement.
+If the cursor is not visible in @text_view, this signal causes
+the viewport to be moved instead.
+
+Applications should not connect to it, but may emit it with
+g_signal_emit_by_name() if they need to control the cursor
+programmatically.
+
+The default bindings for this signal come in two variants,
+the variant with the Shift modifier extends the selection,
+the variant without the Shift modifer does not.
+There are too many key combinations to list them all here.
+<itemizedlist>
+<listitem>Arrow keys move by individual children</listitem>
+<listitem>Home/End keys move to the ends of the box</listitem>
+<listitem>PageUp/PageDown keys move vertically by pages</listitem>
+</itemizedlist>
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> the #GtkFlowBox on which the signal is emitted
+</parameter_description>
+</parameter>
+<parameter name="step">
+<parameter_description> the granularity fo the move, as a #GtkMovementStep
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of @step units to move
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkFlowBox::select-all">
+<description>
+The ::select-all signal is a
+<link linkend="keybinding-signals">keybinding signal</link>
+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.
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> the #GtkFlowBox on which the signal is emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkFlowBox::selected-children-changed">
+<description>
+The ::selected-children-changed signal is emitted when the
+set of selected children changes.
+
+Use gtk_flow_box_selected_foreach() or
+gtk_flow_box_get_selected_children() to obtain the
+selected children.
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> the #GtkFlowBox on wich the signal is emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkFlowBox::toggle-cursor-child">
+<description>
+The ::toggle-cursor-child signal is a
+<link linkend="keybinding-signals">keybinding signal</link>
+which toggles the selection of the child that has the focus.
+
+The default binding for this signal is Ctrl-Space.
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> the #GtkFlowBox on which the signal is emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkFlowBox::unselect-all">
+<description>
+The ::unselect-all signal is a
+<link linkend="keybinding-signals">keybinding signal</link>
+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.
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> the #GtkFlowBox on which the signal is emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkFlowBoxChild::activate">
+<description>
+The ::activate signal is emitted when the user activates
+a child widget in a #GtkFlowBox, either by clicking or
+double-clicking, or by using the Space or Enter key.
+
+While this signal is used as a
+<link linkend="keybinding-signals">keybinding signal</link>,
+it can be used by applications for their own purposes.
+
+</description>
+<parameters>
+<parameter name="child">
+<parameter_description> The child on which the signal is emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
<signal name="GtkFontButton::font-set">
<description>
The ::font-set signal is emitted when the user selects a font.
@@ -3994,19 +4160,19 @@ developer
</parameter_description>
</parameter>
<parameter name="GTK_LICENSE_GPL_2_0">
-<parameter_description> The GNU General Public License, version 2.0
+<parameter_description> The GNU General Public License, version 2.0 or later
</parameter_description>
</parameter>
<parameter name="GTK_LICENSE_GPL_3_0">
-<parameter_description> The GNU General Public License, version 3.0
+<parameter_description> The GNU General Public License, version 3.0 or later
</parameter_description>
</parameter>
<parameter name="GTK_LICENSE_LGPL_2_1">
-<parameter_description> The GNU Lesser General Public License, version 2.1
+<parameter_description> The GNU Lesser General Public License, version 2.1 or later
</parameter_description>
</parameter>
<parameter name="GTK_LICENSE_LGPL_3_0">
-<parameter_description> The GNU Lesser General Public License, version 3.0
+<parameter_description> The GNU Lesser General Public License, version 3.0 or later
</parameter_description>
</parameter>
<parameter name="GTK_LICENSE_BSD">
@@ -4021,6 +4187,22 @@ developer
<parameter_description> The Artistic License, version 2.0
</parameter_description>
</parameter>
+<parameter name="GTK_LICENSE_GPL_2_0_ONLY">
+<parameter_description> The GNU General Public License, version 2.0 only. Since 3.12.
+</parameter_description>
+</parameter>
+<parameter name="GTK_LICENSE_GPL_3_0_ONLY">
+<parameter_description> The GNU General Public License, version 3.0 only. Since 3.12.
+</parameter_description>
+</parameter>
+<parameter name="GTK_LICENSE_LGPL_2_1_ONLY">
+<parameter_description> The GNU Lesser General Public License, version 2.1 only. Since 3.12.
+</parameter_description>
+</parameter>
+<parameter name="GTK_LICENSE_LGPL_3_0_ONLY">
+<parameter_description> The GNU Lesser General Public License, version 3.0 only. Since 3.12.
+</parameter_description>
+</parameter>
</parameters>
</enum>
@@ -6703,7 +6885,7 @@ Whether images should be shown on buttons
Since: 2.4
-Deprecated: 3.10: This setting is ignored
+Deprecated: 3.10: This setting is deprecated
</description>
<parameters>
@@ -6715,7 +6897,7 @@ Deprecated: 3.10: This setting is ignored
<description>
Whether images should be shown in menu items
-Deprecated: 3.10: This setting is ignored
+Deprecated: 3.10: This setting is deprecated
</description>
<parameters>
@@ -7030,6 +7212,42 @@ New values may be added to this enumeration over time.
<parameter_description> Slide from top down or bottom up according to the order
</parameter_description>
</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_OVER_UP">
+<parameter_description> Cover the old page by sliding up. Since 3.12
+</parameter_description>
+</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_OVER_DOWN">
+<parameter_description> Cover the old page by sliding down. Since: 3.12
+</parameter_description>
+</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_OVER_LEFT">
+<parameter_description> Cover the old page by sliding to the left. Since: 3.12
+</parameter_description>
+</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_OVER_RIGHT">
+<parameter_description> Cover the old page by sliding to the right. Since: 3.12
+</parameter_description>
+</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_UNDER_UP">
+<parameter_description> Uncover the new page by sliding up. Since 3.12
+</parameter_description>
+</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_UNDER_DOWN">
+<parameter_description> Uncover the new page by sliding down. Since: 3.12
+</parameter_description>
+</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_UNDER_LEFT">
+<parameter_description> Uncover the new page by sliding to the left. Since: 3.12
+</parameter_description>
+</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_UNDER_RIGHT">
+<parameter_description> Uncover the new page by sliding to the right. Since: 3.12
+</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>
+</parameter>
</parameters>
</enum>
@@ -7081,6 +7299,14 @@ classes and sometimes uses different names.
<parameter_description> Widget is in right-to-left text direction. Since 3.8
</parameter_description>
</parameter>
+<parameter name="GTK_STATE_FLAG_LINK">
+<parameter_description> Widget is a link. Since 3.12
+</parameter_description>
+</parameter>
+<parameter name="GTK_STATE_FLAG_VISITED">
+<parameter_description> The location the widget points to has already been visited. Since 3.12
+</parameter_description>
+</parameter>
</parameters>
</enum>
@@ -12169,6 +12395,31 @@ all accel groups which are attached to @object
</return>
</function>
+<function name="gtk_accel_label_get_accel">
+<description>
+Returns the keyval and modifier mask set with
+gtk_accel_label_set_accel().
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="accel_label">
+<parameter_description> a #GtkAccelLabel
+</parameter_description>
+</parameter>
+<parameter name="accelerator_key">
+<parameter_description> return location for the keyval
+</parameter_description>
+</parameter>
+<parameter name="accelerator_mods">
+<parameter_description> return location for the modifier mask
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_accel_label_get_accel_widget">
<description>
Fetches the widget monitored by this accelerator label. See
@@ -12949,6 +13200,100 @@ Deprecated: 3.10: Use g_action_group_activate_action() on a #GAction instead
<return></return>
</function>
+<function name="gtk_action_bar_get_center_widget">
+<description>
+Retrieves the center box widget of the bar.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkActionBar
+</parameter_description>
+</parameter>
+</parameters>
+<return> the center #GtkBox.
+
+</return>
+</function>
+
+<function name="gtk_action_bar_new">
+<description>
+Creates a new #GtkActionBar widget.
+
+Since: 3.12
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GtkActionBar
+
+</return>
+</function>
+
+<function name="gtk_action_bar_pack_end">
+<description>
+Adds @child to @box, packed with reference to the
+end of the @box.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> A #GtkActionBar
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> the #GtkWidget to be added to @bar
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_action_bar_pack_start">
+<description>
+Adds @child to @box, packed with reference to the
+start of the @box.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> A #GtkActionBar
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> the #GtkWidget to be added to @bar
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_action_bar_set_center_widget">
+<description>
+Sets the center widget for the #GtkActionBar.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkActionBar
+</parameter_description>
+</parameter>
+<parameter name="center_widget">
+<parameter_description> a widget to use for the center
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_action_block_activate">
<description>
Disable activation signals from the action
@@ -14433,6 +14778,37 @@ observer has explicitly registered itself to receive events.
<return></return>
</function>
+<function name="gtk_action_observer_primary_accel_changed">
+<description>
+This function is called when an action that the observer is
+registered to receive events for has one of its accelerators changed.
+
+Accelerator changes are reported for all targets associated with the
+action. The @action_and_target string should be used to check if the
+reported target is the one that the observer is interested in.
+
+</description>
+<parameters>
+<parameter name="observer">
+<parameter_description> a #GtkActionObserver
+</parameter_description>
+</parameter>
+<parameter name="observable">
+<parameter_description> the source of the event
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> the name of the action
+</parameter_description>
+</parameter>
+<parameter name="action_and_target">
+<parameter_description> detailed action of the changed accel, in "action and target" format
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_action_set_accel_group">
<description>
Sets the #GtkAccelGroup in which the accelerator for this action
@@ -14488,8 +14864,8 @@ 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 always show
-their image, if available.
+Sets whether @action<!-- -->'s menu item proxies will ignore the
+#GtkSettings:gtk-menu-images setting and always show their image, if available.
Use this if the menu item would be useless or hard to use
without their image.
@@ -16413,6 +16789,31 @@ Since: 3.0
<return></return>
</function>
+<function name="gtk_application_get_accels_for_action">
+<description>
+Gets the accelerators that are currently associated with
+the given action.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> a #GtkApplication
+</parameter_description>
+</parameter>
+<parameter name="detailed_action_name">
+<parameter_description> a detailed action name, specifying and action
+and target to obtain accelerators for
+</parameter_description>
+</parameter>
+</parameters>
+<return> accelerators for @detailed_action_name, as
+a %NULL-terminated array. Free with g_strfreev() when no longer needed
+
+</return>
+</function>
+
<function name="gtk_application_get_active_window">
<description>
Gets the "active" window for the application.
@@ -16600,6 +17001,26 @@ Since: 3.4
</return>
</function>
+<function name="gtk_application_list_action_descriptions">
+<description>
+Lists the detailed action names which have associated accelerators.
+See gtk_application_set_accels_for_action().
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> a #GtkApplication
+</parameter_description>
+</parameter>
+</parameters>
+<return> a %NULL-terminated array of strings,
+free with g_strfreev() when done
+
+</return>
+</function>
+
<function name="gtk_application_new">
<description>
Creates a new #GtkApplication instance.
@@ -16698,6 +17119,34 @@ Since: 3.0
<return></return>
</function>
+<function name="gtk_application_set_accels_for_action">
+<description>
+Sets one or more keyboard accelerator that will trigger the
+given action. The first item in @accels will be the primary
+accelerator, which may be displayed in the UI.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> a #GtkApplication
+</parameter_description>
+</parameter>
+<parameter name="detailed_action_name">
+<parameter_description> a detailed action name, specifying and action
+and target to associate accelerators with
+</parameter_description>
+</parameter>
+<parameter name="accels">
+<parameter_description> a list of accelerators in the format understood by
+gtk_accelerator_parse()
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_application_set_app_menu">
<description>
Sets or unsets the application menu for @application.
@@ -18991,6 +19440,32 @@ Since: 3.8
<return></return>
</function>
+<function name="gtk_builder_get_application">
+<description>
+Gets the #GtkApplication associated with the builder.
+
+The #GtkApplication is used for creating action proxies as requested
+from XML that the builder is loading.
+
+By default, the builder uses the default application: the one from
+g_application_get_default(). If you want to use another application
+for constructing proxies, use gtk_builder_set_application().
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="builder">
+<parameter_description> a #GtkBuilder
+</parameter_description>
+</parameter>
+</parameters>
+<return> the application being used by the builder,
+or %NULL
+
+</return>
+</function>
+
<function name="gtk_builder_get_object">
<description>
Gets the object named @name. Note that this function does not
@@ -19205,6 +19680,29 @@ Since: 3.10
</return>
</function>
+<function name="gtk_builder_set_application">
+<description>
+Sets the application associated with @builder.
+
+You only need this function if there is more than one #GApplication
+in your process. @application cannot be %NULL.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="builder">
+<parameter_description> a #GtkBuilder
+</parameter_description>
+</parameter>
+<parameter name="application">
+<parameter_description> a #GtkApplication
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_builder_set_translation_domain">
<description>
Sets the translation domain of @builder.
@@ -19521,8 +20019,8 @@ Since: 2.4
<function name="gtk_button_get_always_show_image">
<description>
-Returns whether the button will always show the image in addition
-to the label, if available.
+Returns whether the button will ignore the #GtkSettings:gtk-button-images
+setting and always show the image, if available.
Since: 3.6
@@ -19872,8 +20370,8 @@ Since: 2.4
<function name="gtk_button_set_always_show_image">
<description>
-If %TRUE, the button will always show the image in addition to the
-label, if available.
+If %TRUE, the button will ignore the #GtkSettings:gtk-button-images
+setting and always show the image, if available.
Use this property if the button would be useless or hard to use
without the image.
@@ -27559,6 +28057,11 @@ from the toplevel down to and including @child.
<description>
Returns the resize mode for the container. See
gtk_container_set_resize_mode ().
+
+Deprecated: 3.12: Resize modes are deprecated. They aren't necessary
+anymore since frame clocks and might introduce obscure bugs if
+used.
+
</description>
<parameters>
<parameter name="container">
@@ -27809,6 +28312,11 @@ Sets the resize mode for the container.
The resize mode of a container determines whether a resize request
will be passed to the container's parent, queued for later execution
or executed immediately.
+
+Deprecated: 3.12: Resize modes are deprecated. They aren't necessary
+anymore since frame clocks and might introduce obscure bugs if
+used.
+
</description>
<parameters>
<parameter name="container">
@@ -28817,6 +29325,7 @@ from the mouse, using gdk_event_copy(), and pass it to this function
(remember to free the event with gdk_event_free() when you are done).
If you can really not pass a real event, pass #NULL instead.
+Since: 3.10
</description>
<parameters>
@@ -28855,6 +29364,7 @@ the current pointer position.
</parameter>
</parameters>
<return> the context for this drag.
+
</return>
</function>
@@ -30751,10 +31261,15 @@ completion list with just strings. This function will set up @completion
to have a list displaying all (and just) strings in the completion list,
and to get those strings from @column in the model of @completion.
-This functions creates and adds a #GtkCellRendererText for the selected
-column. If you need to set the text column, but don't want the cell
-renderer, use g_object_set() to set the #GtkEntryCompletion:text-column
-property directly.
+The cell renderer added by this function is managed internally. Do
+not access or modify it.
+
+Any cell renderers that were added to @completion before calling this
+function will be removed.
+
+Conversely, the cell renderer created by this function will be
+removed when new renderers are added to @completion with
+gtk_cell_layout_pack_start() or gtk_cell_layout_pack_end().
Since: 2.4
@@ -35044,6 +35559,733 @@ Adds a widget to a #GtkFixed container at the given position.
<return></return>
</function>
+<function name="gtk_flow_box_child_changed">
+<description>
+Marks @child as changed, causing any state that depends on this
+to be updated. This affects sorting and filtering.
+
+Note that calls to this method must be in sync with the data
+used for the sorting and filtering functions. For instance, if
+the list is mirroring some external data set, and *two* children
+changed in the external data set when you call
+gtk_flow_box_child_changed() on the first child, the sort function
+must only read the new data for the first of the two changed
+children, otherwise the resorting of the children will be wrong.
+
+This generally means that if you don't fully control the data
+model, you have to duplicate the data that affects the sorting
+and filtering functions into the widgets themselves. Another
+alternative is to call gtk_flow_box_invalidate_sort() on any
+model change, but that is more expensive.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="child">
+<parameter_description> a #GtkFlowBoxChild
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_child_get_index">
+<description>
+Gets the current index of the @child in its #GtkFlowBox container.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="child">
+<parameter_description> a #GtkFlowBoxChild
+</parameter_description>
+</parameter>
+</parameters>
+<return> the index of the @child, or -1 if the @child is not
+in a flow box.
+
+</return>
+</function>
+
+<function name="gtk_flow_box_child_is_selected">
+<description>
+Returns whether the @child is currently selected in its
+#GtkFlowBox container.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="child">
+<parameter_description> a #GtkFlowBoxChild
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @child is selected
+
+</return>
+</function>
+
+<function name="gtk_flow_box_child_new">
+<description>
+Creates a new #GtkFlowBoxChild, to be used as a child
+of a #GtkFlowBox.
+
+Since: 3.12
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GtkFlowBoxChild
+
+</return>
+</function>
+
+<function name="gtk_flow_box_get_activate_on_single_click">
+<description>
+Returns whether children activate on single clicks.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if children are activated on single click,
+%FALSE otherwise
+
+</return>
+</function>
+
+<function name="gtk_flow_box_get_child_at_index">
+<description>
+Gets the nth child in the @box.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+<parameter name="idx">
+<parameter_description> the position of the child
+</parameter_description>
+</parameter>
+</parameters>
+<return> the child widget, which will
+always be a #GtkFlowBoxChild
+
+</return>
+</function>
+
+<function name="gtk_flow_box_get_column_spacing">
+<description>
+Gets the horizontal spacing.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> the horizontal spacing
+
+</return>
+</function>
+
+<function name="gtk_flow_box_get_homogeneous">
+<description>
+Returns whether the box is homogeneous (all children are the
+same size). See gtk_box_set_homogeneous().
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the box is homogeneous.
+
+</return>
+</function>
+
+<function name="gtk_flow_box_get_max_children_per_line">
+<description>
+Gets the maximum number of children per line.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> the maximum number of children per line
+
+</return>
+</function>
+
+<function name="gtk_flow_box_get_min_children_per_line">
+<description>
+Gets the minimum number of children per line.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> the minimum number of children per line
+
+</return>
+</function>
+
+<function name="gtk_flow_box_get_row_spacing">
+<description>
+Gets the vertical spacing.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> the vertical spacing
+
+</return>
+</function>
+
+<function name="gtk_flow_box_get_selected_children">
+<description>
+Creates a list of all selected children.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+</parameters>
+<return>
+A #GList containing the #GtkWidget for each selected child.
+Free with g_list_free() when done.
+
+</return>
+</function>
+
+<function name="gtk_flow_box_get_selection_mode">
+<description>
+Gets the selection mode of @box.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GtkSelectionMode
+
+</return>
+</function>
+
+<function name="gtk_flow_box_insert">
+<description>
+Inserts the @widget into @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
+as gtk_container_add().
+
+If @position is -1, or larger than the total number of children
+in the @box, then the @widget will be appended to the end.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+<parameter name="widget">
+<parameter_description> the #GtkWidget to add
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> the position to insert @child in
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_invalidate_filter">
+<description>
+Updates the filtering for all children.
+
+Call this function when the result of the filter
+function on the @box is changed due ot an external
+factor. For instance, this would be used if the
+filter function just looked for a specific search
+term, and the entry with the string has changed.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_invalidate_sort">
+<description>
+Updates the sorting for all children.
+
+Call this when the result of the sort function on
+ box is changed due to an external factor.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_new">
+<description>
+Creates a GtkFlowBox.
+
+Since: 3.12
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GtkFlowBox container
+
+</return>
+</function>
+
+<function name="gtk_flow_box_select_all">
+<description>
+Select all children of @box, if the selection
+mode allows it.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_select_child">
+<description>
+Selects a single child of @box, if the selection
+mode allows it.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> a child of @box
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_selected_foreach">
+<description>
+Calls a function for each selected child.
+
+Note that the selection cannot be modified from within
+this function.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</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_flow_box_set_activate_on_single_click">
+<description>
+If @single is %TRUE, children will be activated when you click
+on them, otherwise you need to double-click.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+<parameter name="single">
+<parameter_description> %TRUE to emit child-activated on a single click
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_set_column_spacing">
+<description>
+Sets the horizontal space to add between children.
+See the #GtkFlowBox:column-spacing property.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+<parameter name="spacing">
+<parameter_description> the spacing to use
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_set_filter_func">
+<description>
+By setting a filter function on the @box one can decide dynamically
+which of the children to show. For instance, to implement a search
+function that only shows the children matching the search terms.
+
+The @filter_func will be called for ach child after the call, and
+it will continue to be called each time a child changes (via
+gtk_flow_box_child_changed()) or when gtk_flow_box_invalidate_filter()
+is called.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+<parameter name="filter_func">
+<parameter_description> callback that
+lets you filter which children to show
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @filter_func
+</parameter_description>
+</parameter>
+<parameter name="destroy">
+<parameter_description> destroy notifier for @user_data
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_set_hadjustment">
+<description>
+Hooks up an adjustment to focus handling in @box.
+The adjustment is also used for autoscrolling during
+rubberband selection. See gtk_scrolled_window_get_hadjustment()
+for a typical way of obtaining the adjustment, and
+gtk_flow_box_set_vadjustment()for setting the vertical
+adjustment.
+
+The adjustments have to be in pixel units and in the same
+coordinate system as the allocation for immediate children
+of the box.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+<parameter name="adjustment">
+<parameter_description> an adjustment which should be adjusted
+when the focus is moved among the descendents of @container
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_set_homogeneous">
+<description>
+Sets the #GtkFlowBox:homogeneous property of @box, controlling
+whether or not all children of @box are given equal space
+in the box.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+<parameter name="homogeneous">
+<parameter_description> %TRUE to create equal allotments,
+%FALSE for variable allotments
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_set_max_children_per_line">
+<description>
+Sets the maximum number of children to request and
+allocate space for in @box's orientation.
+
+Setting the maximum number of children per line
+limits the overall natural size request to be no more
+than @n_children children long in the given orientation.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+<parameter name="n_children">
+<parameter_description> the maximum number of children per line
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_set_min_children_per_line">
+<description>
+Sets the minimum number of children to line up
+in @box's orientation before flowing.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+<parameter name="n_children">
+<parameter_description> the minimum number of children per line
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_set_row_spacing">
+<description>
+Sets the vertical space to add between children.
+See the #GtkFlowBox:row-spacing property.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+<parameter name="spacing">
+<parameter_description> the spacing to use
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_set_selection_mode">
+<description>
+Sets how selection works in @box.
+See #GtkSelectionMode for details.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+<parameter name="mode">
+<parameter_description> the new selection mode
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_set_sort_func">
+<description>
+By setting a sort function on the @box, one can dynamically
+reorder the children of the box, based on the contents of
+the children.
+
+The @sort_func will be called for each child after the call,
+and will continue to be called each time a child changes (via
+gtk_flow_box_child_changed()) and when gtk_flow_box_invalidate_sort()
+is called.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+<parameter name="sort_func">
+<parameter_description> the sort function
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @sort_func
+</parameter_description>
+</parameter>
+<parameter name="destroy">
+<parameter_description> destroy notifier for @user_data
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_set_vadjustment">
+<description>
+Hooks up an adjustment to focus handling in @box.
+The adjustment is also used for autoscrolling during
+rubberband selection. See gtk_scrolled_window_get_vadjustment()
+for a typical way of obtaining the adjustment, and
+gtk_flow_box_set_hadjustment()for setting the horizontal
+adjustment.
+
+The adjustments have to be in pixel units and in the same
+coordinate system as the allocation for immediate children
+of the box.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+<parameter name="adjustment">
+<parameter_description> an adjustment which should be adjusted
+when the focus is moved among the descendents of @container
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_unselect_all">
+<description>
+Unselect all children of @box, if the selection
+mode allows it.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_flow_box_unselect_child">
+<description>
+Unselects a single child of @box, if the selection
+mode allows it.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> a child of @box
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
<function name="gtk_font_button_get_font_name">
<description>
@@ -36401,6 +37643,40 @@ Since: 3.0
</return>
</function>
+<function name="gtk_get_locale_direction">
+<description>
+Get the direction of the current locale. This is the expected
+reading direction for text and UI.
+
+This function depends on the current locale being set with
+setlocale() and will default to setting the %GTK_TEXT_DIR_LTR
+direction otherwise. %GTK_TEXT_DIR_NONE will never be returned.
+
+GTK+ sets the default text direction according to the locale
+during gtk_init(), and you should normally use
+gtk_widget_get_direction() or gtk_widget_get_default_direction()
+to obtain the current direcion.
+
+This function is only needed rare cases when the locale is
+changed after GTK+ has already been initialized. In this case,
+you can use it to update the default text direction as follows:
+
+|[
+setlocale (LC_ALL, new_locale);
+direction = gtk_get_locale_direction ();
+gtk_widget_set_default_direction (direction);
+]|
+
+Since: 3.12
+
+</description>
+<parameters>
+</parameters>
+<return> the #GtkTextDirection of the current locale
+
+</return>
+</function>
+
<function name="gtk_get_major_version">
<description>
Returns the major version number of the GTK+ library.
@@ -37432,10 +38708,46 @@ of the header, or %NULL if none has been set explicitely.
</return>
</function>
+<function name="gtk_header_bar_get_decoration_layout">
+<description>
+Gets the decoration layout set with
+gtk_header_bar_set_decoration_layout().
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkHeaderBar
+</parameter_description>
+</parameter>
+</parameters>
+<return> the decoration layout
+
+</return>
+</function>
+
+<function name="gtk_header_bar_get_has_subtitle">
+<description>
+Returns whether the header bar reserves space
+for a subtitle.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkHeaderBar
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_header_bar_get_show_close_button">
<description>
-Returns whether this header bar shows a window close
-button.
+Returns whether this header bar shows the standard window
+decorations.
Since: 3.10
@@ -37446,7 +38758,7 @@ Since: 3.10
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if a window close button is shown
+<return> %TRUE if the decorations are shown
</return>
</function>
@@ -37549,11 +38861,16 @@ Since: 3.10
<function name="gtk_header_bar_set_custom_title">
<description>
-Sets a custom title for the #GtkHeaderBar. The title should help a
-user identify the current view. This supercedes any title set by
-gtk_header_bar_set_title() or gtk_header_bar_set_subtitle().
-You should set the custom title to %NULL, for the header title label
-to be visible again.
+Sets a custom title for the #GtkHeaderBar.
+
+The title should help a user identify the current view. This
+supersedes any title set by gtk_header_bar_set_title() or
+gtk_header_bar_set_subtitle(). To achieve the same style as
+the builtin title and subtitle, use the "title" and "subtitle"
+style classes.
+
+You should set the custom title to %NULL, for the header title
+label to be visible again.
Since: 3.10
@@ -37571,10 +38888,68 @@ Since: 3.10
<return></return>
</function>
+<function name="gtk_header_bar_set_decoration_layout">
+<description>
+Sets the decoration layout for this header bar, overriding
+the #GtkSettings:gtk-decoration-layout setting.
+
+There can be valid reasons for overriding the setting, such
+as a header bar design that does not allow for buttons to take
+room on the right, or only offers room for a single close button.
+Split header bars are another example for overriding the
+setting.
+
+The format of the string is button names, separated by commas.
+A colon separates the buttons that should appear on the left
+from those on the right. Recognized button names are minimize,
+maximize, close, icon (the window icon) and menu (a menu button
+for the fallback app menu).
+
+For example, "menu:minimize,maximize,close" specifies a menu
+on the left, and minimize, maximize and close buttons on the right.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkHeaderBar
+</parameter_description>
+</parameter>
+<parameter name="layout">
+<parameter_description> a decoration layout, or %NULL to
+unset the layout
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_header_bar_set_has_subtitle">
+<description>
+Sets whether the header bar should reserve space
+for a subtitle, even if none is currently set.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkHeaderBar
+</parameter_description>
+</parameter>
+<parameter name="setting">
+<parameter_description> %TRUE to reserve space for a subtitle
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_header_bar_set_show_close_button">
<description>
-Sets whether this header bar shows a window close
-button.
+Sets whether this header bar shows the standard window decorations,
+including close, maximize, and minimize.
Since: 3.10
@@ -37585,7 +38960,7 @@ Since: 3.10
</parameter_description>
</parameter>
<parameter name="setting">
-<parameter_description> %TRUE to show a window close button
+<parameter_description> %TRUE to show standard widow decorations
</parameter_description>
</parameter>
</parameters>
@@ -37597,11 +38972,9 @@ Since: 3.10
Sets the subtitle of the #GtkHeaderBar. The title should give a user
an additional detail to help him identify the current view.
-Note that GtkHeaderBar always reserves room for the subtitle, even
-if none is currently set. If this is not desired, use
-gtk_header_bar_set_custom_title() to place your own label in the
-title position. To achieve the same style, use the "title" style
-class.
+Note that GtkHeaderBar by default reserves room for the subtitle,
+even if none is currently set. If this is not desired, set the
+#GtkHeaderBar:has-subtitle property to %FALSE.
Since: 3.10
@@ -37612,7 +38985,7 @@ Since: 3.10
</parameter_description>
</parameter>
<parameter name="subtitle">
-<parameter_description> a subtitle
+<parameter_description> a subtitle, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -37634,7 +39007,7 @@ Since: 3.10
</parameter_description>
</parameter>
<parameter name="title">
-<parameter_description> a title
+<parameter_description> a title, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -38281,6 +39654,26 @@ return value is owned by GTK+ and should not be modified or freed.
</return>
</function>
+<function name="gtk_icon_info_is_symbolic">
+<description>
+Checks if the icon is symbolic or not. This currently uses only
+the file name and not the file contents for determining this.
+This behaviour may change in the future.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="icon_info">
+<parameter_description> a #GtkIconInfo structure
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the icon is symbolic, %FALSE otherwise.
+
+</return>
+</function>
+
<function name="gtk_icon_info_load_icon">
<description>
Renders an icon previously looked up in an icon theme using
@@ -40499,7 +41892,7 @@ icon theme or the default icon theme, and an image file with
the right name is found directly in one of the elements of
@path, then that image will be used for the icon name.
(This is legacy feature, and new icons should be put
-into the default icon theme, which is called DEFAULT_THEME_NAME,
+into the default icon theme, which is called hicolor,
rather than directly on the icon path.)
Since: 2.4
@@ -42659,7 +44052,8 @@ the return value will be %GTK_IMAGE_EMPTY.
<function name="gtk_image_menu_item_get_always_show_image">
<description>
-Returns whether the menu item will always show the image, if available.
+Returns whether the menu item will ignore the #GtkSettings:gtk-menu-images
+setting and always show the image, if available.
Since: 2.16
@@ -42832,7 +44226,8 @@ Deprecated: 3.10
<function name="gtk_image_menu_item_set_always_show_image">
<description>
-If %TRUE, the menu item will always show the image, if available.
+If %TRUE, the menu item will ignore the #GtkSettings:gtk-menu-images
+setting and always show the image, if available.
Use this property if the menuitem would be useless or hard to use
without the image.
@@ -53224,6 +54619,24 @@ Since: 3.10
<return></return>
</function>
+<function name="gtk_places_sidebar_get_local_only">
+<description>
+Returns the value previously set with gtk_places_sidebar_set_local_only().
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a places sidebar
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the sidebar will only show local files.
+
+</return>
+</function>
+
<function name="gtk_places_sidebar_get_location">
<description>
Gets the currently-selected location in the @sidebar. This can be #NULL when
@@ -53395,6 +54808,26 @@ Since: 3.10
<return></return>
</function>
+<function name="gtk_places_sidebar_set_local_only">
+<description>
+Sets whether the @sidebar should only show local files.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a places sidebar
+</parameter_description>
+</parameter>
+<parameter name="local_only">
+<parameter_description> whether to show only local files
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_places_sidebar_set_location">
<description>
Sets the location that is being shown in the widgets surrounding the
@@ -53477,9 +54910,10 @@ Since: 3.10
<function name="gtk_places_sidebar_set_show_desktop">
<description>
-Sets whether the @sidebar should show an item for the Desktop folder; this is off by default.
-An application may want to turn this on if the desktop environment actually supports the
-notion of a desktop.
+Sets whether the @sidebar should show an item for the Desktop folder.
+The default value for this option is determined by the desktop
+environment and the user's configuration, but this function can be
+used to override it on a per-application basis.
Since: 3.10
@@ -58385,7 +59819,7 @@ Deprecated: 3.10
</parameter_description>
</parameter>
<parameter name="group">
-<parameter_description> a list representing a radio group
+<parameter_description> a list representing a radio group, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -58539,7 +59973,7 @@ mnemonic for the button.
<parameters>
<parameter name="group">
<parameter_description> the radio button
-group
+group, or %NULL
</parameter_description>
</parameter>
<parameter name="label">
@@ -58590,7 +60024,7 @@ changes.
</parameter>
<parameter name="group">
<parameter_description> an existing radio
-button group, such as one returned from gtk_radio_button_get_group().
+button group, such as one returned from gtk_radio_button_get_group(), or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -58624,7 +60058,7 @@ Creates a new #GtkRadioMenuItem.
<parameters>
<parameter name="group">
<parameter_description> the group to which the
-radio menu item is to be attached
+radio menu item is to be attached, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -58659,6 +60093,7 @@ Creates a new #GtkRadioMenuItem whose child is a simple #GtkLabel.
<parameters>
<parameter name="group">
<parameter_description>
+group the radio menu item is inside, or %NULL
</parameter_description>
</parameter>
<parameter name="label">
@@ -58703,7 +60138,8 @@ in @label indicate the mnemonic for the menu item.
</description>
<parameters>
<parameter name="group">
-<parameter_description> group the radio menu item is inside
+<parameter_description>
+group the radio menu item is inside, or %NULL
</parameter_description>
</parameter>
<parameter name="label">
@@ -58754,7 +60190,7 @@ Sets the group of a radio menu item, or changes it.
</parameter_description>
</parameter>
<parameter name="group">
-<parameter_description> the new group.
+<parameter_description> the new group, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -58882,7 +60318,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="group">
-<parameter_description> an existing radio button group
+<parameter_description> an existing radio button group, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -66428,6 +67864,25 @@ Since: 3.10
</return>
</function>
+<function name="gtk_stack_get_transition_running">
+<description>
+Returns whether the @stack is currently in a transition from one page to
+another.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the transition is currently running, %FALSE otherwise.
+
+</return>
+</function>
+
<function name="gtk_stack_get_transition_type">
<description>
Gets the type of animation that will be used
@@ -68618,6 +70073,9 @@ again. It is useful if you modify the @context and need the new
information immediately.
Since: 3.0
+
+Deprecated: 3.12: Style contexts are invalidated automatically.
+
</description>
<parameters>
<parameter name="context">
@@ -70617,8 +72075,8 @@ Deprecated: 3.4: #GtkGrid resizes automatically.
Alters the amount of space between a given table column and the following
column.
-Deprecated: 3.4: Use gtk_widget_set_margin_left() and
-gtk_widget_set_margin_right() on the widgets contained in the row if
+Deprecated: 3.4: Use gtk_widget_set_margin_start() and
+gtk_widget_set_margin_end() on the widgets contained in the row if
you need this functionality. #GtkGrid does not support per-row spacing.
</description>
@@ -76711,15 +78169,11 @@ windows.
The window must have nonzero size (see
gtk_text_view_set_border_window_size()). Note that the child
-coordinates are given relative to the #GdkWindow in question, and
-that these coordinates have no sane relationship to scrolling. When
+coordinates are given relative to scrolling. When
placing a child in #GTK_TEXT_WINDOW_WIDGET, scrolling is
irrelevant, the child floats above all scrollable areas. But when
placing a child in one of the scrollable windows (border windows or
-text window), you'll need to compute the child's correct position
-in buffer coordinates any time scrolling occurs or buffer changes
-occur, and then call gtk_text_view_move_child() to update the
-child's position.
+text window) it will move with the scrolling as needed.
</description>
<parameters>
@@ -81214,8 +82668,7 @@ Retrieves the icon size for the toolbar. See gtk_toolbar_set_icon_size().
</parameter_description>
</parameter>
</parameters>
-<return> the current icon size for the icons on
-the toolbar.
+<return> the current icon size for the icons on the toolbar.
</return>
</function>
@@ -81427,8 +82880,7 @@ size of icons.
</parameter_description>
</parameter>
<parameter name="icon_size">
-<parameter_description> The #GtkIconSize that stock icons in the
-toolbar shall have.
+<parameter_description> The #GtkIconSize that stock icons in the toolbar shall have.
</parameter_description>
</parameter>
</parameters>
@@ -83383,6 +84835,28 @@ Since: 2.2
</return>
</function>
+<function name="gtk_tree_path_new_from_indicesv">
+<description>
+Creates a new path with the given @indices array of @length.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="indices">
+<parameter_description> array of indices
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> length of @indices array
+</parameter_description>
+</parameter>
+</parameters>
+<return> A newly created #GtkTreePath
+
+</return>
+</function>
+
<function name="gtk_tree_path_new_from_string">
<description>
Creates a new #GtkTreePath initialized to @path.
@@ -91179,6 +92653,24 @@ Since: 3.0
</return>
</function>
+<function name="gtk_widget_get_margin_end">
+<description>
+Gets the value of the #GtkWidget:margin-end property.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return> The end margin of @widget
+
+</return>
+</function>
+
<function name="gtk_widget_get_margin_left">
<description>
Gets the value of the #GtkWidget:margin-left property.
@@ -91215,6 +92707,24 @@ Since: 3.0
</return>
</function>
+<function name="gtk_widget_get_margin_start">
+<description>
+Gets the value of the #GtkWidget:margin-start property.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return> The start margin of @widget
+
+</return>
+</function>
+
<function name="gtk_widget_get_margin_top">
<description>
Gets the value of the #GtkWidget:margin-top property.
@@ -95258,6 +96768,27 @@ Since: 3.0
<return></return>
</function>
+<function name="gtk_widget_set_margin_end">
+<description>
+Sets the end margin of @widget.
+See the #GtkWidget:margin-end property.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="margin">
+<parameter_description> the end margin
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_widget_set_margin_left">
<description>
Sets the left margin of @widget.
@@ -95300,6 +96831,27 @@ Since: 3.0
<return></return>
</function>
+<function name="gtk_widget_set_margin_start">
+<description>
+Sets the start margin of @widget.
+See the #GtkWidget:margin-start property.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="margin">
+<parameter_description> the start margin
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_widget_set_margin_top">
<description>
Sets the top margin of @widget.
@@ -97584,6 +99136,30 @@ Since: 2.4
</return>
</function>
+<function name="gtk_window_is_maximized">
+<description>
+Retrieves the current maximized state of @window.
+
+Note that since maximization is ultimately handled by the window
+manager and happens asynchronously to an application request, you
+shouldn't assume the return value of this function changing
+immediately (or at all), as an effect of calling
+gtk_window_maximize() or gtk_window_unmaximize().
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GtkWindow
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether the window has a maximized state.
+
+</return>
+</function>
+
<function name="gtk_window_list_toplevels">
<description>
Returns a list of all existing toplevel windows. The widgets
@@ -97616,7 +99192,8 @@ in which case the window will be maximized when it appears onscreen
initially.
You can track maximization via the "window-state-event" signal
-on #GtkWidget.
+on #GtkWidget, or by listening to notifications on the
+#GtkWindow:is-maximized property.
</description>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
