[gtkmm] Regenerate gtk_docs.xml



commit 7d8c4cb658afd54456ba39d362d20b6c08dd6cc3
Author: Kjell Ahlstedt <kjellahlstedt gmail com>
Date:   Tue Jun 6 15:41:46 2017 +0200

    Regenerate gtk_docs.xml

 gtk/src/gtk_docs.xml |  804 +++++++++++++++++++++----------------------------
 1 files changed, 345 insertions(+), 459 deletions(-)
---
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index 99cb52d..34dcdbe 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -5792,16 +5792,6 @@ Since: 3.14
 </description>
 </property>
 
-<property name="GtkGesture:window">
-<description>
-If non-%NULL, the gesture will only listen for events that happen on
-this #GdkWindow, or a child of it.
-
-Since: 3.14
-
-</description>
-</property>
-
 <signal name="GtkGestureDrag::drag-begin">
 <description>
 This signal is emitted whenever dragging starts.
@@ -17561,15 +17551,6 @@ Since: 2.4
 </description>
 </property>
 
-<property name="GtkWindow:hide-titlebar-when-maximized">
-<description>
-Whether the titlebar should be hidden during maximization.
-
-Since: 3.4
-
-</description>
-</property>
-
 <property name="GtkWindow:icon-name">
 <description>
 The :icon-name property specifies the name of the themed icon to
@@ -28105,6 +28086,134 @@ Since: 2.6
 <return></return>
 </function>
 
+<function name="gtk_center_box_get_center_widget">
+<description>
+Gets the center widget.
+
+Since: 3.92
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkCenterBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> the center widget.
+
+</return>
+</function>
+
+<function name="gtk_center_box_get_end_widget">
+<description>
+Gets the end widget.
+
+Since: 3.92
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkCenterBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> the end widget.
+
+</return>
+</function>
+
+<function name="gtk_center_box_get_start_widget">
+<description>
+Gets the start widget.
+
+Since: 3.92
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkCenterBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> the start widget.
+
+</return>
+</function>
+
+<function name="gtk_center_box_new">
+<description>
+Creates a new #GtkCenterBox.
+
+Since: 3.92
+
+</description>
+<parameters>
+</parameters>
+<return> the new #GtkCenterBox.
+
+</return>
+</function>
+
+<function name="gtk_center_box_set_center_widget">
+<description>
+Sets the center widget.
+
+Since: 3.92
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkCenterBox
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> the child
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_center_box_set_end_widget">
+<description>
+Sets the end widget.
+
+Since: 3.92
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkCenterBox
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> the child
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_center_box_set_start_widget">
+<description>
+Sets the start widget.
+
+Since: 3.92
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkCenterBox
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> the child
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_check_button_get_draw_indicator">
 <description>
 Returns Whether or not the indicator part of the button gets drawn.
@@ -32659,6 +32768,13 @@ to @sizes.
 
 <function name="gtk_drag_dest_add_image_targets">
 <description>
+Add the image targets supported by #GtkSelectionData to
+the target list of the drag destination. The targets
+are added with @info = 0. If you need another value,
+use gtk_target_list_add_image_targets() and
+gtk_drag_dest_set_target_list().
+
+Since: 2.6
 
 </description>
 <parameters>
@@ -32672,6 +32788,13 @@ to @sizes.
 
 <function name="gtk_drag_dest_add_text_targets">
 <description>
+Add the text targets supported by #GtkSelectionData to
+the target list of the drag destination. The targets
+are added with @info = 0. If you need another value,
+use gtk_target_list_add_text_targets() and
+gtk_drag_dest_set_target_list().
+
+Since: 2.6
 
 </description>
 <parameters>
@@ -32685,6 +32808,13 @@ to @sizes.
 
 <function name="gtk_drag_dest_add_uri_targets">
 <description>
+Add the URI targets supported by #GtkSelectionData to
+the target list of the drag destination. The targets
+are added with @info = 0. If you need another value,
+use gtk_target_list_add_uri_targets() and
+gtk_drag_dest_set_target_list().
+
+Since: 2.6
 
 </description>
 <parameters>
@@ -32698,6 +32828,14 @@ to @sizes.
 
 <function name="gtk_drag_dest_find_target">
 <description>
+Looks for a match between the supported targets of @context and the
+@dest_target_list, returning the first matching target, otherwise
+returning %GDK_NONE. @dest_target_list should usually be the return
+value from gtk_drag_dest_get_target_list(), but some widgets may
+have different valid targets for different parts of the widget; in
+that case, they will have to implement a drag_motion handler that
+passes the correct target list to this function.
+
 
 </description>
 <parameters>
@@ -32715,12 +32853,16 @@ gtk_drag_dest_get_target_list (@widget).
 </parameter_description>
 </parameter>
 </parameters>
-<return>
+<return> first target that the source offers
+and the dest can accept, or %GDK_NONE
 </return>
 </function>
 
 <function name="gtk_drag_dest_get_target_list">
 <description>
+Returns the list of targets this widget can accept from
+drag-and-drop.
+
 
 </description>
 <parameters>
@@ -32729,11 +32871,16 @@ gtk_drag_dest_get_target_list (@widget).
 </parameter_description>
 </parameter>
 </parameters>
-<return></return>
+<return> the #GtkTargetList, or %NULL if none
+</return>
 </function>
 
 <function name="gtk_drag_dest_get_track_motion">
 <description>
+Returns whether the widget has been configured to always
+emit #GtkWidget::drag-motion signals.
+
+Since: 2.10
 
 </description>
 <parameters>
@@ -32742,11 +32889,53 @@ gtk_drag_dest_get_target_list (@widget).
 </parameter_description>
 </parameter>
 </parameters>
-<return></return>
+<return> %TRUE if the widget always emits
+#GtkWidget::drag-motion events
+
+</return>
 </function>
 
 <function name="gtk_drag_dest_set">
 <description>
+Sets a widget as a potential drop destination, and adds default behaviors.
+
+The default behaviors listed in @flags have an effect similar
+to installing default handlers for the widget’s drag-and-drop signals
+(#GtkWidget::drag-motion, #GtkWidget::drag-drop, ...). They all exist
+for convenience. When passing #GTK_DEST_DEFAULT_ALL for instance it is
+sufficient to connect to the widget’s #GtkWidget::drag-data-received
+signal to get primitive, but consistent drag-and-drop support.
+
+Things become more complicated when you try to preview the dragged data,
+as described in the documentation for #GtkWidget::drag-motion. The default
+behaviors described by @flags make some assumptions, that can conflict
+with your own signal handlers. For instance #GTK_DEST_DEFAULT_DROP causes
+invokations of gdk_drag_status() in the context of #GtkWidget::drag-motion,
+and invokations of gtk_drag_finish() in #GtkWidget::drag-data-received.
+Especially the later is dramatic, when your own #GtkWidget::drag-motion
+handler calls gtk_drag_get_data() to inspect the dragged data.
+
+There’s no way to set a default action here, you can use the
+#GtkWidget::drag-motion callback for that. Here’s an example which selects
+the action to use depending on whether the control key is pressed or not:
+|[&lt;!-- language=&quot;C&quot; --&gt;
+static void
+drag_motion (GtkWidget *widget,
+GdkDragContext *context,
+gint x,
+gint y,
+guint time)
+{
+GdkModifierType mask;
+
+gdk_window_get_pointer (gtk_widget_get_window (widget),
+NULL, NULL, &amp;mask);
+if (mask &amp; GDK_CONTROL_MASK)
+gdk_drag_status (context, GDK_ACTION_COPY, time);
+else
+gdk_drag_status (context, GDK_ACTION_MOVE, time);
+}
+]|
 
 </description>
 <parameters>
@@ -32759,10 +32948,10 @@ gtk_drag_dest_get_target_list (@widget).
 </parameter_description>
 </parameter>
 <parameter name="targets">
-<parameter_description> a pointer to an array of #GtkTargetEntrys
-indicating the drop types that this @widget will accept, or %NULL.
-Later you can access the list with gtk_drag_dest_get_target_list()
-and gtk_drag_dest_find_target().
+<parameter_description> a pointer to an array of
+#GtkTargetEntrys indicating the drop types that this @widget will
+accept, or %NULL. Later you can access the list with
+gtk_drag_dest_get_target_list() and gtk_drag_dest_find_target().
 </parameter_description>
 </parameter>
 <parameter name="n_targets">
@@ -32779,6 +32968,9 @@ and gtk_drag_dest_find_target().
 
 <function name="gtk_drag_dest_set_target_list">
 <description>
+Sets the target types that this widget can accept from drag-and-drop.
+The widget must first be made into a drag destination with
+gtk_drag_dest_set().
 
 </description>
 <parameters>
@@ -32796,6 +32988,14 @@ and gtk_drag_dest_find_target().
 
 <function name="gtk_drag_dest_set_track_motion">
 <description>
+Tells the widget to emit #GtkWidget::drag-motion and
+#GtkWidget::drag-leave events regardless of the targets and the
+%GTK_DEST_DEFAULT_MOTION flag.
+
+This may be used when a widget wants to do generic
+actions regardless of the targets that the source offers.
+
+Since: 2.10
 
 </description>
 <parameters>
@@ -32813,6 +33013,9 @@ and gtk_drag_dest_find_target().
 
 <function name="gtk_drag_dest_unset">
 <description>
+Clears information about a drop destination set with
+gtk_drag_dest_set(). The widget will no longer receive
+notification of drags.
 
 </description>
 <parameters>
@@ -37324,7 +37527,7 @@ Since: 2.8
 
 <function name="gtk_file_chooser_get_extra_widget">
 <description>
-Gets the current preview widget; see
+Gets the current extra widget; see
 gtk_file_chooser_set_extra_widget().
 
 Since: 2.4
@@ -39229,7 +39432,8 @@ with the given index exists.
 
 <function name="gtk_flow_box_get_child_at_pos">
 <description>
-Gets the child in the (@x, @y) position.
+Gets the child in the (@x, @y) position. Both @x and @y are
+assumed to be relative to the allocation of @box.
 
 Since: 3.22.6
 
@@ -40975,26 +41179,6 @@ 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
@@ -41190,7 +41374,7 @@ Since: 3.14
 </description>
 <parameters>
 <parameter name="gesture">
-<parameter_description> a #GtkGesture
+<parameter_description> a #GtkGestureMultiPress
 </parameter_description>
 </parameter>
 <parameter name="rect">
@@ -41393,28 +41577,6 @@ 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
@@ -41793,6 +41955,47 @@ must not be freed
 </return>
 </function>
 
+<function name="gtk_get_event_target">
+<description>
+If @event is %NULL or the event was not associated with any widget,
+returns %NULL, otherwise returns the widget that is the deepmost
+receiver of the event.
+
+Since: 3.92
+
+</description>
+<parameters>
+<parameter name="event">
+<parameter_description> a #GdkEvent
+</parameter_description>
+</parameter>
+</parameters>
+<return> the target widget, or %NULL
+
+</return>
+</function>
+
+<function name="gtk_get_event_target_with_type">
+<description>
+If @event is %NULL or the event was not associated with any widget,
+returns %NULL, otherwise returns first widget found from the event
+target to the toplevel that matches @type.
+
+Since: 3.92
+
+</description>
+<parameters>
+<parameter name="event">
+<parameter_description> a #GdkEvent
+</parameter_description>
+</parameter>
+</parameters>
+<return> the widget in the target stack
+with the given type, or %NULL
+
+</return>
+</function>
+
 <function name="gtk_get_event_widget">
 <description>
 If @event is %NULL or the event was not associated with any widget,
@@ -46278,10 +46481,10 @@ method to clear the preedit state.
 <return></return>
 </function>
 
-<function name="gtk_im_context_set_client_window">
+<function name="gtk_im_context_set_client_widget">
 <description>
 Set the client window for the input context; this is the
-#GdkWindow in which the input appears. This window is
+#GtkWidget holding the input focus. This widget is
 used in order to correctly position status windows, and may
 also be used for purposes internal to the input method.
 
@@ -46291,9 +46494,9 @@ also be used for purposes internal to the input method.
 <parameter_description> a #GtkIMContext
 </parameter_description>
 </parameter>
-<parameter name="window">
-<parameter_description>  the client window. This may be %NULL to indicate
-that the previous client window no longer exists.
+<parameter name="widget">
+<parameter_description>  the client widget. This may be %NULL to indicate
+that the previous client widget no longer exists.
 </parameter_description>
 </parameter>
 </parameters>
@@ -66288,9 +66491,10 @@ Since: 3.0
 <function name="gtk_scale_set_digits">
 <description>
 Sets the number of decimal places that are displayed in the value. Also
-causes the value of the adjustment to be rounded to this number of digits
-whenever it is changed, so the retrieved value matches the displayed one, if
-#GtkScale:draw-value is TRUE at the time of the change.
+causes the value of the adjustment to be rounded to this number of digits,
+so the retrieved value matches the displayed one, if #GtkScale:draw-value is
+%TRUE when the value changes. If you want to enforce rounding the value when
+#GtkScale:draw-value is %FALSE, you can set #GtkRange:round-digits instead.
 
 Note that rounding to a small number of digits can interfere with
 the smooth autoscrolling that is built into #GtkScale. As an alternative,
@@ -66333,9 +66537,8 @@ to the slider.
 
 <function name="gtk_scale_set_has_origin">
 <description>
-If @has_origin is set to %TRUE (the default),
-the scale will highlight the part of the scale
-between the origin (bottom or left side) of the scale
+If #GtkScale:has-origin is set to %TRUE (the default), the scale will
+highlight the part of the trough between the origin (bottom or left side)
 and the current value.
 
 Since: 3.4
@@ -79427,25 +79630,6 @@ for @tool_item.
 </return>
 </function>
 
-<function name="gtk_tool_item_get_use_drag_window">
-<description>
-Returns whether @tool_item has a drag window. See
-gtk_tool_item_set_use_drag_window().
-
-Since: 2.4
-
-</description>
-<parameters>
-<parameter name="tool_item">
-<parameter_description> a #GtkToolItem 
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if @tool_item uses a drag window.
-
-</return>
-</function>
-
 <function name="gtk_tool_item_get_visible_horizontal">
 <description>
 Returns whether the @tool_item is visible on toolbars that are
@@ -80033,29 +80217,6 @@ Since: 2.12
 <return></return>
 </function>
 
-<function name="gtk_tool_item_set_use_drag_window">
-<description>
-Sets whether @tool_item has a drag window. When %TRUE the
-toolitem can be used as a drag source through gtk_drag_source_set().
-When @tool_item has a drag window it will intercept all events,
-even those that would otherwise be sent to a child of @tool_item.
-
-Since: 2.4
-
-</description>
-<parameters>
-<parameter name="tool_item">
-<parameter_description> a #GtkToolItem 
-</parameter_description>
-</parameter>
-<parameter name="use_drag_window">
-<parameter_description> Whether @tool_item has a drag window.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
 <function name="gtk_tool_item_set_visible_horizontal">
 <description>
 Sets whether @tool_item is visible when the toolbar is docked horizontally.
@@ -88137,51 +88298,6 @@ gtk_menu_item_set_accel_path() instead.
 <return></return>
 </function>
 
-<function name="gtk_widget_add_device_events">
-<description>
-Adds the device events in the bitfield @events to the event mask for
-@widget. See gtk_widget_set_device_events() for details.
-
-Since: 3.0
-
-</description>
-<parameters>
-<parameter name="widget">
-<parameter_description> a #GtkWidget
-</parameter_description>
-</parameter>
-<parameter name="device">
-<parameter_description> a #GdkDevice
-</parameter_description>
-</parameter>
-<parameter name="events">
-<parameter_description> an event mask, see #GdkEventMask
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="gtk_widget_add_events">
-<description>
-Adds the events in the bitfield @events to the event mask for
-@widget. See gtk_widget_set_events() and the
-[input handling overview][event-masks] for details.
-
-</description>
-<parameters>
-<parameter name="widget">
-<parameter_description> a #GtkWidget
-</parameter_description>
-</parameter>
-<parameter name="events">
-<parameter_description> an event mask, see #GdkEventMask
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
 <function name="gtk_widget_add_mnemonic_label">
 <description>
 Adds a widget to the list of mnemonic labels for
@@ -89454,29 +89570,6 @@ Since: 3.0
 </return>
 </function>
 
-<function name="gtk_widget_get_device_events">
-<description>
-Returns the events mask for the widget corresponding to an specific device. These
-are the events that the widget will receive when @device operates on it.
-
-Since: 3.0
-
-</description>
-<parameters>
-<parameter name="widget">
-<parameter_description> a #GtkWidget
-</parameter_description>
-</parameter>
-<parameter name="device">
-<parameter_description> a #GdkDevice
-</parameter_description>
-</parameter>
-</parameters>
-<return> device event mask for @widget
-
-</return>
-</function>
-
 <function name="gtk_widget_get_direction">
 <description>
 Gets the reading direction for a particular widget. See
@@ -89518,28 +89611,6 @@ Since: 2.2
 </return>
 </function>
 
-<function name="gtk_widget_get_events">
-<description>
-Returns the event mask (see #GdkEventMask) for the widget. These are the
-events that the widget will receive.
-
-Note: Internally, the widget event mask will be the logical OR of the event
-mask set through gtk_widget_set_events() or gtk_widget_add_events(), and the
-event mask necessary to cater for every #GtkEventController created for the
-widget.
-
-
-</description>
-<parameters>
-<parameter name="widget">
-<parameter_description> a #GtkWidget
-</parameter_description>
-</parameter>
-</parameters>
-<return> event mask for @widget
-</return>
-</function>
-
 <function name="gtk_widget_get_first_child">
 <description>
 Since: 3.90
@@ -90021,73 +90092,6 @@ created.
 </return>
 </function>
 
-<function name="gtk_widget_get_preferred_height">
-<description>
-Retrieves a widget’s initial minimum and natural height.
-
-This call is specific to width-for-height requests.
-
-The returned request will be modified by the
-GtkWidgetClass::adjust_size_request virtual method and by any
-#GtkSizeGroups that have been applied. That is, the returned request
-is the one that should be used for layout, not necessarily the one
-returned by the widget itself.
-
-Since: 3.0
-
-</description>
-<parameters>
-<parameter name="widget">
-<parameter_description> a #GtkWidget instance
-</parameter_description>
-</parameter>
-<parameter name="minimum_height">
-<parameter_description> location to store the minimum height, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="natural_height">
-<parameter_description> location to store the natural height, or %NULL
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="gtk_widget_get_preferred_height_for_width">
-<description>
-Retrieves a widget’s minimum and natural height if it would be given
-the specified @width.
-
-The returned request will be modified by the
-GtkWidgetClass::adjust_size_request virtual method and by any
-#GtkSizeGroups that have been applied. That is, the returned request
-is the one that should be used for layout, not necessarily the one
-returned by the widget itself.
-
-Since: 3.0
-
-</description>
-<parameters>
-<parameter name="widget">
-<parameter_description> a #GtkWidget instance
-</parameter_description>
-</parameter>
-<parameter name="width">
-<parameter_description> the width which is available for allocation
-</parameter_description>
-</parameter>
-<parameter name="minimum_height">
-<parameter_description> location for storing the minimum height, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="natural_height">
-<parameter_description> location for storing the natural height, or %NULL
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
 <function name="gtk_widget_get_preferred_size">
 <description>
 Retrieves the minimum and natural size of a widget, taking
@@ -90126,73 +90130,6 @@ Since: 3.0
 <return></return>
 </function>
 
-<function name="gtk_widget_get_preferred_width">
-<description>
-Retrieves a widget’s initial minimum and natural width.
-
-This call is specific to height-for-width requests.
-
-The returned request will be modified by the
-GtkWidgetClass::adjust_size_request virtual method and by any
-#GtkSizeGroups that have been applied. That is, the returned request
-is the one that should be used for layout, not necessarily the one
-returned by the widget itself.
-
-Since: 3.0
-
-</description>
-<parameters>
-<parameter name="widget">
-<parameter_description> a #GtkWidget instance
-</parameter_description>
-</parameter>
-<parameter name="minimum_width">
-<parameter_description> location to store the minimum width, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="natural_width">
-<parameter_description> location to store the natural width, or %NULL
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="gtk_widget_get_preferred_width_for_height">
-<description>
-Retrieves a widget’s minimum and natural width if it would be given
-the specified @height.
-
-The returned request will be modified by the
-GtkWidgetClass::adjust_size_request virtual method and by any
-#GtkSizeGroups that have been applied. That is, the returned request
-is the one that should be used for layout, not necessarily the one
-returned by the widget itself.
-
-Since: 3.0
-
-</description>
-<parameters>
-<parameter name="widget">
-<parameter_description> a #GtkWidget instance
-</parameter_description>
-</parameter>
-<parameter name="height">
-<parameter_description> the height which is available for allocation
-</parameter_description>
-</parameter>
-<parameter name="minimum_width">
-<parameter_description> location for storing the minimum width, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="natural_width">
-<parameter_description> location for storing the natural width, or %NULL
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
 <function name="gtk_widget_get_prev_sibling">
 <description>
 Since: 3.90
@@ -90967,6 +90904,66 @@ Since: 3.6
 <return></return>
 </function>
 
+<function name="gtk_widget_insert_after">
+<description>
+Inserts @widget into the child widget list of @parent.
+It will be placed after @previous_sibling, or at the beginning if @previous_sibling is %NULL.
+
+After calling this function, gtk_widget_get_prev_sibling(widget) will return @previous_sibling.
+
+If @parent is already set as the parent widget of @widget, this function can also be used
+to reorder @widget in the child widget list of @parent.
+
+Since: 3.92
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="parent">
+<parameter_description> the parent #GtkWidget to insert @widget into
+</parameter_description>
+</parameter>
+<parameter name="previous_sibling">
+<parameter_description> the new previous sibling of @widget or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_widget_insert_before">
+<description>
+Inserts @widget into the child widget list of @parent.
+It will be placed before @next_sibling, or at the end if @next_sibling is %NULL.
+
+After calling this function, gtk_widget_get_next_sibling(widget) will return @next_sibling.
+
+If @parent is already set as the parent widget of @widget, this function can also be used
+to reorder @widget in the child widget list of @parent.
+
+Since: 3.92
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="parent">
+<parameter_description> the parent #GtkWidget to insert @widget into
+</parameter_description>
+</parameter>
+<parameter name="next_sibling">
+<parameter_description> the new next sibling of @widget or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_widget_intersect">
 <description>
 Computes the intersection of a @widget’s area and @area, storing
@@ -92687,40 +92684,6 @@ Since: 3.0
 <return></return>
 </function>
 
-<function name="gtk_widget_set_device_events">
-<description>
-Sets the device event mask (see #GdkEventMask) for a widget. The event
-mask determines which events a widget will receive from @device. Keep
-in mind that different widgets have different default event masks, and by
-changing the event mask you may disrupt a widget’s functionality,
-so be careful. This function must be called while a widget is
-unrealized. Consider gtk_widget_add_device_events() for widgets that are
-already realized, or if you want to preserve the existing event
-mask. This function can’t be used with windowless widgets (which return
-%FALSE from gtk_widget_get_has_window());
-to get events on those widgets, place them inside a #GtkEventBox
-and receive events on the event box.
-
-Since: 3.0
-
-</description>
-<parameters>
-<parameter name="widget">
-<parameter_description> a #GtkWidget
-</parameter_description>
-</parameter>
-<parameter name="device">
-<parameter_description> a #GdkDevice
-</parameter_description>
-</parameter>
-<parameter name="events">
-<parameter_description> event mask
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
 <function name="gtk_widget_set_direction">
 <description>
 Sets the reading direction on a particular widget. This direction
@@ -92750,34 +92713,6 @@ set by gtk_widget_set_default_direction() will be used.
 <return></return>
 </function>
 
-<function name="gtk_widget_set_events">
-<description>
-Sets the event mask (see #GdkEventMask) for a widget. The event
-mask determines which events a widget will receive. Keep in mind
-that different widgets have different default event masks, and by
-changing the event mask you may disrupt a widget’s functionality,
-so be careful. This function must be called while a widget is
-unrealized. Consider gtk_widget_add_events() for widgets that are
-already realized, or if you want to preserve the existing event
-mask. This function can’t be used with widgets that have no window.
-(See gtk_widget_get_has_window()).  To get events on those widgets,
-place them inside a #GtkEventBox and receive events on the event
-box.
-
-</description>
-<parameters>
-<parameter name="widget">
-<parameter_description> a #GtkWidget
-</parameter_description>
-</parameter>
-<parameter name="events">
-<parameter_description> event mask
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
 <function name="gtk_widget_set_focus_on_click">
 <description>
 Sets whether the widget should grab focus when it is clicked with the mouse.
@@ -94516,26 +94451,6 @@ Since: 2.10
 </return>
 </function>
 
-<function name="gtk_window_get_hide_titlebar_when_maximized">
-<description>
-Returns whether the window has requested to have its titlebar hidden
-when maximized. See gtk_window_set_hide_titlebar_when_maximized ().
-
-Since: 3.4
-
-</description>
-<parameters>
-<parameter name="window">
-<parameter_description> a #GtkWindow
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if the window has requested to have its titlebar
-hidden when maximized
-
-</return>
-</function>
-
 <function name="gtk_window_get_icon">
 <description>
 Gets the value set by gtk_window_set_icon() (or if you've
@@ -95967,35 +95882,6 @@ Since: 3.0
 <return></return>
 </function>
 
-<function name="gtk_window_set_hide_titlebar_when_maximized">
-<description>
-If @setting is %TRUE, then @window will request that it’s titlebar
-should be hidden when maximized.
-This is useful for windows that don’t convey any information other
-than the application name in the titlebar, to put the available
-screen space to better use. If the underlying window system does not
-support the request, the setting will not have any effect.
-
-Note that custom titlebars set with gtk_window_set_titlebar() are
-not affected by this. The application is in full control of their
-content and visibility anyway.
-
-Since: 3.4
-
-</description>
-<parameters>
-<parameter name="window">
-<parameter_description> a #GtkWindow
-</parameter_description>
-</parameter>
-<parameter name="setting">
-<parameter_description> whether to hide the titlebar when @window is maximized
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
 <function name="gtk_window_set_icon">
 <description>
 Sets up the icon representing a #GtkWindow. This icon is used when


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]