[gtkmm] Regenerate gtk_docs.xml
- From: Kjell Ahlstedt <kjellahl src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtkmm] Regenerate gtk_docs.xml
- Date: Fri, 11 Mar 2016 15:44:54 +0000 (UTC)
commit ec4f2ce58e6eded7ee6687e0454de615ca2df809
Author: Kjell Ahlstedt <kjell ahlstedt bredband net>
Date: Fri Mar 11 16:39:20 2016 +0100
Regenerate gtk_docs.xml
gtk/src/gtk_docs.xml | 971 +++++++++++++++++++++++++++++++++++++++++--------
1 files changed, 812 insertions(+), 159 deletions(-)
---
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index c6e96a9..95dd55a 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -3512,6 +3512,20 @@ Since: 3.0
</description>
</property>
+<property name="GtkColorButton:show-editor">
+<description>
+Set this property to %TRUE to skip the palette
+in the dialog and go directly to the color editor.
+
+This property should be used in cases where the palette
+in the editor would be redundant, such as when the color
+button is already part of a palette.
+
+Since: 3.20
+
+</description>
+</property>
+
<property name="GtkColorButton:title">
<description>
The title of the color selection dialog
@@ -4011,7 +4025,7 @@ widget.
<signal name="GtkCssProvider::parsing-error">
<description>
-Signals that a parsing error occured. the @path, @line and @position
+Signals that a parsing error occurred. the @path, @line and @position
describe the actual location of the error as accurately as possible.
Parsing errors are never fatal, so the parsing will resume after
@@ -5219,6 +5233,9 @@ Since: 2.16
Which kind of shadow to draw around the entry when
#GtkEntry:has-frame is set to %TRUE.
+Deprecated: 3.20: Use CSS to determine the style of the border;
+the value of this style property is ignored.
+
Since: 2.12
</description>
@@ -5636,6 +5653,17 @@ Since: 3.2
</description>
</property>
+<property name="GtkExpander:spacing">
+<description>
+Space to put between the label and the child when the
+expander is expanded.
+
+Deprecated: 3.20: This property is deprecated and ignored.
+Use margins on the child instead.
+
+</description>
+</property>
+
<enum name="GtkExpanderStyle">
<description>
Used to specify the style of the expanders drawn by a #GtkTreeView.
@@ -7037,7 +7065,7 @@ Since: 3.14
<signal name="GtkGestureLongPress::cancelled">
<description>
This signal is emitted whenever a press moved too far, or was released
-before #GtkGestureLongPress:pressed happened.
+before #GtkGestureLongPress::pressed happened.
Since: 3.14
@@ -8859,6 +8887,9 @@ height for blocks filling the #GtkLevelBar widget.
Since: 3.6
+Deprecated: 3.20: Use the standard min-width/min-height CSS properties on
+the block elements; the value of this style property is ignored.
+
</description>
</property>
@@ -8869,6 +8900,9 @@ width for blocks filling the #GtkLevelBar widget.
Since: 3.6
+Deprecated: 3.20: Use the standard min-width/min-height CSS properties on
+the block elements; the value of this style property is ignored.
+
</description>
</property>
@@ -10240,6 +10274,9 @@ arrows and the tabs.
Since: 2.10
+Deprecated: 3.20: This property is ignored. Use margins on arrows or
+the "tabs" node to achieve the same effect.
+
</description>
</property>
@@ -10303,6 +10340,8 @@ gtk_render_background and gtk_render_frame are used.
Since: 3.12
+Deprecated: 3.20: This function always behaves as if it was set to %FALSE.
+
</description>
</property>
@@ -10313,6 +10352,9 @@ gap between the first tab.
Since: 3.2
+Deprecated: 3.20: The intial gap is ignored. Use margins on the header node
+to achieve the same effect.
+
</description>
</property>
@@ -10322,6 +10364,9 @@ The “tab-curvature” property defines size of tab curvature.
Since: 2.10
+Deprecated: 3.20: This property is ignored. Use margins on tab nodes
+to achieve the same effect.
+
</description>
</property>
@@ -10332,6 +10377,9 @@ area.
Since: 2.10
+Deprecated: 3.20: This property is ignored. Use margins on tab nodes
+to achieve the same effect.
+
</description>
</property>
@@ -10958,6 +11006,29 @@ Since: 3.10
<return></return>
</signal>
+<signal name="GtkPlacesSidebar::mount">
+<description>
+The places sidebar emits this signal when it starts a new operation
+because the user clicked on some location that needs mounting.
+In this way the application using the #GtkPlacesSidebar can track the
+progress of the operation and, for example, show a notification.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> the object which received the signal.
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> the #GMountOperation that is going to start.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
<signal name="GtkPlacesSidebar::open-location">
<description>
The places sidebar emits this signal when the user selects a location
@@ -11112,6 +11183,10 @@ and network access points.
For example, the application may bring up a page showing persistent
volumes and discovered network addresses.
+Deprecated: 3.20: use the #GtkPlacesSidebar::show-other-locations-with-flags
+which includes the open flags in order to allow the user to specify to open
+in a new tab or window, in a similar way than #GtkPlacesSidebar::open-location
+
Since: 3.18
</description>
@@ -11124,6 +11199,53 @@ Since: 3.18
<return></return>
</signal>
+<signal name="GtkPlacesSidebar::show-other-locations-with-flags">
+<description>
+The places sidebar emits this signal when it needs the calling
+application to present a way to show other locations e.g. drives
+and network access points.
+For example, the application may bring up a page showing persistent
+volumes and discovered network addresses.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> the object which received the signal.
+</parameter_description>
+</parameter>
+<parameter name="open_flags">
+<parameter_description> a single value from #GtkPlacesOpenFlags specifying how it should be opened.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkPlacesSidebar::unmount">
+<description>
+The places sidebar emits this signal when it starts a new operation
+because the user for example ejected some drive or unmounted a mount.
+In this way the application using the #GtkPlacesSidebar can track the
+progress of the operation and, for example, show a notification.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> the object which received the signal.
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> the #GMountOperation that is going to start.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
<property name="GtkPlacesSidebar:populate-all">
<description>
If :populate-all is %TRUE, the #GtkPlacesSidebar::populate-popup signal
@@ -12166,7 +12288,7 @@ A value of this type is returned by gtk_print_operation_run().
</description>
<parameters>
<parameter name="GTK_PRINT_OPERATION_RESULT_ERROR">
-<parameter_description> An error has occured.
+<parameter_description> An error has occurred.
</parameter_description>
</parameter>
<parameter name="GTK_PRINT_OPERATION_RESULT_APPLY">
@@ -12688,6 +12810,9 @@ The arrow size proportion relative to the scroll button size.
Since: 2.14
+Deprecated: 3.20: Use min-width/min-height on the "button" node instead.
+The value of this style property is ignored.
+
</description>
</property>
@@ -12733,11 +12858,44 @@ Since: 2.12
</description>
</property>
+<property name="GtkRange:slider-width">
+<description>
+Width of scrollbar or scale thumb.
+
+Depreacated: 3.20: Use the min-height/min-width CSS properties on the
+slider element. The value of this style property is ignored.
+
+</description>
+</property>
+
+<property name="GtkRange:stepper-size">
+<description>
+Length of step buttons at ends.
+
+Depreacated: 3.20: Use the min-height/min-width CSS properties on the
+stepper elements. The value of this style property is ignored.
+
+</description>
+</property>
+
<property name="GtkRange:stepper-spacing">
<description>
The spacing between the stepper buttons and thumb. Note that
stepper-spacing won't have any effect if there are no steppers.
+Depreacated: 3.20: Use the margin CSS property on the stepper elements.
+The value of this style property is ignored.
+
+</description>
+</property>
+
+<property name="GtkRange:trough-border">
+<description>
+Spacing between thumb/steppers and outer trough bevel.
+
+Depreacated: 3.20: Use the margin/padding CSS properties on the through and
+stepper elements. The value of this style property is ignored.
+
</description>
</property>
@@ -12748,6 +12906,9 @@ to exclude the steppers and their spacing.
Since: 2.10
+Deprecated: 3.20: The value of this style property is ignored, and the
+widget will behave as if it was set to %TRUE.
+
</description>
</property>
@@ -13475,6 +13636,26 @@ gtk_scale_get_digits (scale), value);
</return>
</signal>
+<property name="GtkScale:slider-length">
+<description>
+Length of scale's slider.
+
+Deprecated: 3.20: Use min-height/min-width CSS properties on the slider
+element instead. The value of this style property is ignored.
+
+</description>
+</property>
+
+<property name="GtkScale:value-spacing">
+<description>
+Space between value text and the slider/trough area.
+
+Deprecated: 3.20: Use min-height/min-width CSS properties on the value
+element instead. The value of this style property is ignored.
+
+</description>
+</property>
+
<signal name="GtkScaleButton::popdown">
<description>
The ::popdown signal is a
@@ -13736,6 +13917,16 @@ the scrolled window adjustments in a given orientation.
</parameters>
</enum>
+<property name="GtkScrollbar:min-slider-length">
+<description>
+Minimum length of scrollbar slider.
+
+Deprecated: 3.20: Use min-height/min-width CSS properties on the slider
+element instead. The value of this style property is ignored.
+
+</description>
+</property>
+
<signal name="GtkScrolledWindow::edge-overshot">
<description>
The ::edge-overshot signal is emitted whenever user initiated scrolling
@@ -13890,6 +14081,8 @@ Whether to place scrollbars within the scrolled window's bevel.
Since: 2.12
+Deprecated: 3.20: the value of this style property is ignored.
+
</description>
</property>
@@ -14416,6 +14609,17 @@ performed dynamically based on gdk_event_get_source_device().
</description>
</property>
+<property name="GtkSettings:gtk-keynav-use-caret">
+<description>
+Whether GTK+ should make sure that text can be navigated with
+a caret, even if it is not editable. This is useful when using
+a screen reader.
+
+Since: 3.20
+
+</description>
+</property>
+
<property name="GtkSettings:gtk-keynav-wrap-around">
<description>
When %TRUE, some widgets will wrap around when doing keyboard
@@ -14935,7 +15139,7 @@ This is used internally by GTK+, and must not be modified by applications.
<property name="GtkShortcutsShortcut:accelerator">
<description>
The accelerator(s) represented by this object. This property is used
-if #GtkShorcutsShortcut:shortcut-type is set to #GTK_SHORTCUT_ACCELERATOR.
+if #GtkShortcutsShortcut:shortcut-type is set to #GTK_SHORTCUT_ACCELERATOR.
The syntax of this property is (an extension of) the syntax understood by
gtk_accelerator_parse(). Multiple accelerators can be specified by separating
@@ -15309,7 +15513,7 @@ Since: 2.10
Style of bevel around the sping button.
Deprecated: 3.20: Use CSS to determine the style of the border;
-the value of this syyle property is ignored.
+the value of this style property is ignored.
</description>
</property>
@@ -16063,6 +16267,26 @@ Since: 3.4
</description>
</property>
+<enum name="GtkStyleContextPrintFlags">
+<description>
+Flags that modify the behavior of gtk_style_context_to_string().
+New values may be added to this enumeration.
+
+</description>
+<parameters>
+<parameter name="GTK_STYLE_CONTEXT_PRINT_RECURSE">
+<parameter_description> Print the entire tree of
+CSS nodes starting at the style context's node
+</parameter_description>
+</parameter>
+<parameter name="GTK_STYLE_CONTEXT_PRINT_SHOW_STYLE">
+<parameter_description> Show the values of the
+CSS properties for each node
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<signal name="GtkSwitch::activate">
<description>
The ::activate signal on GtkSwitch is an action signal and
@@ -16084,7 +16308,7 @@ notify::active signal.
<description>
The ::state-set signal on GtkSwitch is emitted to change the underlying
state. It is emitted when the user changes the switch position. The
-default handler keeps the state in sync with the #GtkState:active
+default handler keeps the state in sync with the #GtkSwitch:active
property.
To implement delayed state change, applications can connect to this signal,
@@ -16715,7 +16939,7 @@ buffer marked with this tag.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a #GtkTextIter pointing at the location the event occured
+<parameter_description> a #GtkTextIter pointing at the location the event occurred
</parameter_description>
</parameter>
</parameters>
@@ -17306,9 +17530,10 @@ This signal has no default bindings.
<signal name="GtkTextView::toggle-cursor-visible">
<description>
-The ::toggle-cursor-visible signal is a
-[keybinding signal][GtkBindingSignal]
-which gets emitted to toggle the visibility of the cursor.
+The ::toggle-cursor-visible signal is a
+[keybinding signal][GtkBindingSignal]
+which gets emitted to toggle the #GtkTextView:cursor-visible
+property.
The default binding for this signal is F7.
@@ -17903,10 +18128,32 @@ of this style property is ignored.
</description>
</property>
+<property name="GtkToolbar:space-size">
+<description>
+Size of toolbar spacers.
+
+Deprecated: 3.20: Use the standard margin/padding CSS properties on the
+separator elements; the value of this style property is ignored.
+
+</description>
+</property>
+
+<property name="GtkToolbar:space-style">
+<description>
+Style of toolbar spacers.
+
+Deprecated: 3.20: Use CSS properties on the separator elements to style
+toolbar spacers; the value of this style property is ignored.
+
+</description>
+</property>
+
<enum name="GtkToolbarSpaceStyle">
<description>
Whether spacers are vertical lines or just blank.
+Deprecated: 3.20
+
</description>
<parameters>
<parameter name="GTK_TOOLBAR_SPACE_EMPTY">
@@ -19364,7 +19611,7 @@ If the decision whether the drop will be accepted or rejected can't be
made based solely on the cursor position and the type of the data, the
handler may inspect the dragged data by calling gtk_drag_get_data() and
defer the gdk_drag_status() call to the #GtkWidget::drag-data-received
-handler. Note that you cannot not pass #GTK_DEST_DEFAULT_DROP,
+handler. Note that you must pass #GTK_DEST_DEFAULT_DROP,
#GTK_DEST_DEFAULT_MOTION or #GTK_DEST_DEFAULT_ALL to gtk_drag_dest_set()
when using the drag-motion signal that way.
@@ -20576,6 +20823,16 @@ event. %FALSE to propagate the event further.
</return>
</signal>
+<property name="GtkWidget:cursor-color">
+<description>
+The color with which to draw the insertion cursor in entries and
+text views.
+
+Deprecated: 3.20: Use the caret-color CSS property
+
+</description>
+</property>
+
<property name="GtkWidget:double-buffered">
<description>
Whether the widget is double buffered.
@@ -20843,6 +21100,16 @@ Since: 2.10
</description>
</property>
+<property name="GtkWidget:secondary-cursor-color">
+<description>
+The color with which to draw the secondary insertion cursor in entries and
+text views when editing mixed right-to-left and left-to-right text.
+
+Deprecated: 3.20: Use the -gtk-secondary-caret-color CSS property
+
+</description>
+</property>
+
<property name="GtkWidget:separator-height">
<description>
The "separator-height" style property defines the height of separators.
@@ -20850,6 +21117,9 @@ This property only takes effect if the "wide-separators" style propert
Since: 2.10
+Deprecated: 3.20: Use the standard min-height CSS property on the separator
+elements to size separators; the value of this style property is ignored.
+
</description>
</property>
@@ -20860,6 +21130,9 @@ This property only takes effect if the "wide-separators" style propert
Since: 2.10
+Deprecated: 3.20: Use the standard min-width CSS property on the separator
+elements to size separators; the value of this style property is ignored.
+
</description>
</property>
@@ -20947,6 +21220,9 @@ configurable width and should be drawn using a box instead of a line.
Since: 2.10
+Deprecated: 3.20: Use CSS properties on the separator elements to style
+separators; the value of this style property is ignored.
+
</description>
</property>
@@ -23357,7 +23633,8 @@ or gtk_container_add() to add a #GtkImage to a #GtkButton
</parameter_description>
</parameter>
<parameter name="icon_size">
-<parameter_description> the size of the icon that should be created.
+<parameter_description> the size of the icon (#GtkIconSize) that should
+be created.
</parameter_description>
</parameter>
</parameters>
@@ -30163,7 +30440,8 @@ Since: 2.6
</parameter_description>
</parameter>
</parameters>
-<return> a #GtkWidget or %NULL in case there is no image
+<return> a #GtkWidget or %NULL in case
+there is no image
</return>
</function>
@@ -30311,7 +30589,7 @@ Since: 3.10
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> an icon size
+<parameter_description> an icon size (#GtkIconSize)
</parameter_description>
</parameter>
</parameters>
@@ -38037,12 +38315,14 @@ removed.
<function name="gtk_container_forall">
<description>
-Invokes @callback on each child of @container, including children
-that are considered “internal” (implementation details of the
-container). “Internal” children generally weren’t added by the user
-of the container, but were added by the container implementation
-itself. Most applications should use gtk_container_foreach(),
-rather than gtk_container_forall().
+Invokes @callback on each direct child of @container, including
+children that are considered “internal” (implementation details
+of the container). “Internal” children generally weren’t added
+by the user of the container, but were added by the container
+implementation itself.
+
+Most applications should use gtk_container_foreach(), rather
+than gtk_container_forall().
</description>
<parameters>
@@ -38064,10 +38344,15 @@ rather than gtk_container_forall().
<function name="gtk_container_foreach">
<description>
-Invokes @callback on each non-internal child of @container. See
-gtk_container_forall() for details on what constitutes an
-“internal” child. Most applications should use
-gtk_container_foreach(), rather than gtk_container_forall().
+Invokes @callback on each non-internal child of @container.
+See gtk_container_forall() for details on what constitutes
+an “internal” child. For all practical purposes, this function
+should iterate over precisely those child widgets that were
+added to the container by the application with explicit add()
+calls.
+
+Most applications should use gtk_container_foreach(),
+rather than gtk_container_forall().
</description>
<parameters>
@@ -38204,8 +38489,8 @@ gtk_container_set_focus_vadjustment().
</parameter_description>
</parameter>
</parameters>
-<return> the vertical focus adjustment, or %NULL if
-none has been set.
+<return> the vertical focus adjustment, or
+%NULL if none has been set.
</return>
</function>
@@ -38637,6 +38922,25 @@ Adds a style class to the gadgets CSS node.
<return></return>
</function>
+<function name="gtk_css_gadget_add_state">
+<description>
+Adds the given states to the states of gadget's CSS node. Other states
+will be kept as they are.
+
+</description>
+<parameters>
+<parameter name="gadget">
+<parameter_description> a #GtkCssGadget
+</parameter_description>
+</parameter>
+<parameter name="state">
+<parameter_description> The state to add
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_css_gadget_allocate">
<description>
Allocates the gadget.
@@ -38668,6 +38972,60 @@ any content clip.
<return></return>
</function>
+<function name="gtk_css_gadget_border_box_contains_point">
+<description>
+Checks whether the point at the provided coordinates is contained within the
+border box of the gadget. The (X, Y) are relative to the gadget
+origin.
+
+
+</description>
+<parameters>
+<parameter name="gadget">
+<parameter_description> the #GtkCssGadget being tested
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> X coordinate of the testing point
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y coordinate of the testing point
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the point at (X, Y) is contained within the border
+box of the @gadget.
+</return>
+</function>
+
+<function name="gtk_css_gadget_content_box_contains_point">
+<description>
+Checks whether the point at the provided coordinates is contained within the
+content box of the gadget. The (X, Y) are relative to the gadget
+origin.
+
+
+</description>
+<parameters>
+<parameter name="gadget">
+<parameter_description> the #GtkCssGadget being tested
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> X coordinate of the testing point
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y coordinate of the testing point
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the point at (X, Y) is contained within the content
+box of the @gadget.
+</return>
+</function>
+
<function name="gtk_css_gadget_draw">
<description>
Will draw the gadget at the position allocated via
@@ -38692,6 +39050,66 @@ gtk_container_propagate_draw() depend on that.
<return></return>
</function>
+<function name="gtk_css_gadget_get_border_box">
+<description>
+Returns the border box of the gadget. The box coordinates are relative to
+the gadget origin. Compare with gtk_css_gadget_get_border_allocation(),
+which returns the border box in the widget allocation coordinates.
+
+</description>
+<parameters>
+<parameter name="gadget">
+<parameter_description> a #GtkCssGadget
+</parameter_description>
+</parameter>
+<parameter name="box">
+<parameter_description> Return location for gadget's the border box
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_css_gadget_get_content_box">
+<description>
+Returns the content box of the gadget. The box coordinates are relative to
+the gadget origin. Compare with gtk_css_gadget_get_content_allocation(),
+which returns the content box in the widget allocation coordinates.
+
+</description>
+<parameters>
+<parameter name="gadget">
+<parameter_description> a #GtkCssGadget
+</parameter_description>
+</parameter>
+<parameter name="box">
+<parameter_description> Return location for gadget's the content box
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_css_gadget_get_margin_box">
+<description>
+Returns the margin box of the gadget. The box coordinates are relative to
+the gadget origin. Compare with gtk_css_gadget_get_margin_allocation(),
+which returns the margin box in the widget allocation coordinates.
+
+</description>
+<parameters>
+<parameter name="gadget">
+<parameter_description> a #GtkCssGadget
+</parameter_description>
+</parameter>
+<parameter name="box">
+<parameter_description> Return location for gadget's the margin box
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_css_gadget_get_node">
<description>
Get the CSS node for this gadget.
@@ -38784,6 +39202,33 @@ Get the CSS style for this gadget.
</return>
</function>
+<function name="gtk_css_gadget_margin_box_contains_point">
+<description>
+Checks whether the point at the provided coordinates is contained within the
+margin box of the gadget. The (X, Y) are relative to the gadget
+origin.
+
+
+</description>
+<parameters>
+<parameter name="gadget">
+<parameter_description> the #GtkCssGadget being tested
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> X coordinate of the testing point
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y coordinate of the testing point
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the point at (X, Y) is contained within the margin
+box of the @gadget.
+</return>
+</function>
+
<function name="gtk_css_gadget_remove_class">
<description>
Removes a style class from the gadgets CSS node.
@@ -38802,6 +39247,43 @@ Removes a style class from the gadgets CSS node.
<return></return>
</function>
+<function name="gtk_css_gadget_remove_state">
+<description>
+Adds the given states to the states of gadget's CSS node. Other states
+will be kept as they are.
+
+</description>
+<parameters>
+<parameter name="gadget">
+<parameter_description> a #GtkCssGadget
+</parameter_description>
+</parameter>
+<parameter name="state">
+<parameter_description> The state to remove
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_css_gadget_set_state">
+<description>
+Sets the state of the gadget's CSS node.
+
+</description>
+<parameters>
+<parameter name="gadget">
+<parameter_description> a #GtkCssGadget
+</parameter_description>
+</parameter>
+<parameter name="state">
+<parameter_description> The new state
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_css_node_new">
<description>
Creates a new CSS node.
@@ -38852,7 +39334,7 @@ This memory is owned by GTK+, and you must not free it.
<function name="gtk_css_provider_load_from_data">
<description>
-Loads @data into @css_provider, making it clear any previously loaded
+Loads @data into @css_provider, and by doing so clears any previously loaded
information.
@@ -38879,7 +39361,7 @@ potentially do a copy.
</parameters>
<return> %TRUE. The return value is deprecated and %FALSE will only be
returned for backwards compatibility reasons if an @error is not
-%NULL and a loading error occured. To track errors while loading
+%NULL and a loading error occurred. To track errors while loading
CSS, connect to the #GtkCssProvider::parsing-error signal.
</return>
</function>
@@ -38907,7 +39389,7 @@ clear any previously loaded information.
</parameters>
<return> %TRUE. The return value is deprecated and %FALSE will only be
returned for backwards compatibility reasons if an @error is not
-%NULL and a loading error occured. To track errors while loading
+%NULL and a loading error occurred. To track errors while loading
CSS, connect to the #GtkCssProvider::parsing-error signal.
</return>
</function>
@@ -38935,7 +39417,7 @@ any previously loaded information.
</parameters>
<return> %TRUE. The return value is deprecated and %FALSE will only be
returned for backwards compatibility reasons if an @error is not
-%NULL and a loading error occured. To track errors while loading
+%NULL and a loading error occurred. To track errors while loading
CSS, connect to the #GtkCssProvider::parsing-error signal.
</return>
</function>
@@ -41263,8 +41745,8 @@ Since: 3.4
</parameter_description>
</parameter>
</parameters>
-<return> The common prefix all rows starting with @key
-or %NULL if no row matches @key.
+<return> The common prefix all rows starting with
+ key or %NULL if no row matches @key.
</return>
</function>
@@ -43373,7 +43855,7 @@ Since: 3.2
</parameter_description>
</parameter>
<parameter name="text">
-<parameter_description> a string to be displayed when @entry is empty an unfocused, or %NULL
+<parameter_description> a string to be displayed when @entry is empty and unfocused, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -43961,6 +44443,8 @@ Gets the value set by gtk_expander_set_spacing().
Since: 2.4
+Deprecated: 3.20: Use margins on the child instead.
+
</description>
<parameters>
<parameter name="expander">
@@ -44170,6 +44654,8 @@ pixels to place between expander and the child.
Since: 2.4
+Deprecated: 3.20: Use margins on the child instead.
+
</description>
<parameters>
<parameter name="expander">
@@ -44603,8 +45089,8 @@ Since: 2.4
</parameter_description>
</parameter>
</parameters>
-<return> the full path of the current folder,
-or %NULL if the current path cannot be represented as a local
+<return> the full path of the current
+folder, or %NULL if the current path cannot be represented as a local
filename. Free with g_free(). This function will also return
%NULL if the file chooser was unable to load the last folder that
was requested from it; for example, as would be for calling
@@ -44654,10 +45140,11 @@ Since: 2.4
</parameter_description>
</parameter>
</parameters>
-<return> the URI for the current folder. Free with g_free(). This
-function will also return %NULL if the file chooser was unable to load the
-last folder that was requested from it; for example, as would be for calling
-gtk_file_chooser_set_current_folder_uri() on a nonexistent folder.
+<return> the URI for the current folder.
+Free with g_free(). This function will also return %NULL if the file chooser
+was unable to load the last folder that was requested from it; for example,
+as would be for calling gtk_file_chooser_set_current_folder_uri() on a
+nonexistent folder.
</return>
</function>
@@ -44772,8 +45259,8 @@ Since: 2.4
</parameter_description>
</parameter>
</parameters>
-<return> The currently selected filename, or %NULL
-if no file is selected, or the selected file can't
+<return> The currently selected filename,
+or %NULL if no file is selected, or the selected file can't
be represented with a local filename. Free with g_free().
</return>
@@ -44917,8 +45404,8 @@ Since: 2.4
</parameter_description>
</parameter>
</parameters>
-<return> the URI for the file to preview, or %NULL if no file is
-selected. Free with g_free().
+<return> the URI for the file to preview,
+or %NULL if no file is selected. Free with g_free().
</return>
</function>
@@ -45019,8 +45506,8 @@ Since: 2.4
</parameter>
</parameters>
<return> The currently selected URI, or %NULL
-if no file is selected. If gtk_file_chooser_set_local_only() is set to %TRUE
-(the default) a local URI will be returned for any FUSE locations.
+if no file is selected. If gtk_file_chooser_set_local_only() is set to
+%TRUE (the default) a local URI will be returned for any FUSE locations.
Free with g_free()
</return>
@@ -45143,8 +45630,8 @@ Since: 3.20
</parameter_description>
</parameter>
</parameters>
-<return> The custom label, or %NULL for the default. This string is
-owned by GTK+ and should not be modified or freed
+<return> The custom label, or %NULL for the default. This string
+is owned by GTK+ and should not be modified or freed
</return>
</function>
@@ -45162,8 +45649,8 @@ Since: 3.20
</parameter_description>
</parameter>
</parameters>
-<return> The custom label, or %NULL for the default. This string is
-owned by GTK+ and should not be modified or freed
+<return> The custom label, or %NULL for the default. This string
+is owned by GTK+ and should not be modified or freed
</return>
</function>
@@ -52526,7 +53013,7 @@ Deprecated: 3.10: Use #GtkIconTheme instead.
</parameter>
<parameter name="sizes">
<parameter_description> return location
-for array of sizes
+for array of sizes (#GtkIconSize)
</parameter_description>
</parameter>
<parameter name="n_sizes">
@@ -52629,7 +53116,7 @@ Deprecated: 3.0: Use gtk_icon_set_render_icon_pixbuf() instead
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> icon size. A size of (GtkIconSize)-1
+<parameter_description> icon size (#GtkIconSize). A size of `(GtkIconSize)-1`
means render at the size of the source and don’t scale.
</parameter_description>
</parameter>
@@ -52675,7 +53162,7 @@ Deprecated: 3.10: Use #GtkIconTheme instead.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> icon size. A size of (GtkIconSize)-1
+<parameter_description> icon size (#GtkIconSize). A size of `(GtkIconSize)-1`
means render at the size of the source and don’t scale.
</parameter_description>
</parameter>
@@ -52709,7 +53196,7 @@ Deprecated: 3.10: Use #GtkIconTheme instead.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> icon size. A size of (GtkIconSize)-1
+<parameter_description> icon size (#GtkIconSize). A size of `(GtkIconSize)-1`
means render at the size of the source and don’t scale.
</parameter_description>
</parameter>
@@ -52757,7 +53244,7 @@ Deprecated: 3.10: Use #GtkIconTheme instead.
</parameter_description>
</parameter>
</parameters>
-<return> the icon size
+<return> the icon size (#GtkIconSize)
</return>
</function>
@@ -52796,7 +53283,7 @@ the usual size.
</description>
<parameters>
<parameter name="size">
-<parameter_description> an icon size
+<parameter_description> an icon size (#GtkIconSize)
</parameter_description>
</parameter>
<parameter name="width">
@@ -52837,7 +53324,7 @@ which set of user preferences to used.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> an icon size
+<parameter_description> an icon size (#GtkIconSize)
</parameter_description>
</parameter>
<parameter name="width">
@@ -52876,7 +53363,7 @@ Deprecated: 3.10: Use #GtkIconTheme instead.
</parameter_description>
</parameter>
</parameters>
-<return> integer value representing the size
+<return> integer value representing the size (#GtkIconSize)
</return>
</function>
@@ -52896,7 +53383,7 @@ Deprecated: 3.10: Use #GtkIconTheme instead.
</parameter_description>
</parameter>
<parameter name="target">
-<parameter_description> an existing icon size
+<parameter_description> an existing icon size (#GtkIconSize)
</parameter_description>
</parameter>
</parameters>
@@ -53055,7 +53542,7 @@ Deprecated: 3.10: Use #GtkIconTheme instead.
</parameter_description>
</parameter>
</parameters>
-<return> icon size this source matches.
+<return> icon size (#GtkIconSize) this source matches.
</return>
</function>
@@ -53293,7 +53780,7 @@ Deprecated: 3.10: Use #GtkIconTheme instead.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> icon size this source applies to
+<parameter_description> icon size (#GtkIconSize) this source applies to
</parameter_description>
</parameter>
</parameters>
@@ -54756,8 +55243,8 @@ Since: 2.6
</parameter_description>
</parameter>
</parameters>
-<return> The #GtkTreePath corresponding to the icon or %NULL
-if no icon exists at that position.
+<return> The #GtkTreePath corresponding
+to the icon or %NULL if no icon exists at that position.
</return>
</function>
@@ -56214,8 +56701,8 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> place to store an icon size,
-or %NULL
+<parameter_description> place to store an icon size
+(#GtkIconSize), or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -56244,8 +56731,8 @@ icon name, or %NULL
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> place to store an icon size,
-or %NULL
+<parameter_description> place to store an icon size
+(#GtkIconSize), or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -56273,7 +56760,7 @@ Deprecated: 3.10: Use gtk_image_get_icon_name() instead.
</parameter>
<parameter name="size">
<parameter_description> location to store a stock
-icon size, or %NULL
+icon size (#GtkIconSize), or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -56342,7 +56829,7 @@ stock icon name, or %NULL
</parameter>
<parameter name="size">
<parameter_description> place to store a stock icon
-size, or %NULL
+size (#GtkIconSize), or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -56695,7 +57182,7 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> a stock icon size (#GtkIconSize)
</parameter_description>
</parameter>
</parameters>
@@ -56720,7 +57207,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> a stock icon size (#GtkIconSize)
</parameter_description>
</parameter>
</parameters>
@@ -56752,7 +57239,7 @@ Deprecated: 3.10: Use gtk_image_new_from_icon_name() instead.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> a stock icon size (#GtkIconSize)
</parameter_description>
</parameter>
</parameters>
@@ -56835,7 +57322,7 @@ Deprecated: 3.10: Use gtk_image_new_from_icon_name() instead.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> a stock icon size (#GtkIconSize)
</parameter_description>
</parameter>
</parameters>
@@ -56919,7 +57406,7 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> an icon size
+<parameter_description> an icon size (#GtkIconSize)
</parameter_description>
</parameter>
</parameters>
@@ -56943,7 +57430,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> an icon size
+<parameter_description> an icon size (#GtkIconSize)
</parameter_description>
</parameter>
</parameters>
@@ -56967,7 +57454,7 @@ Deprecated: 3.10: Use gtk_image_set_from_icon_name() instead.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> a stock icon size (#GtkIconSize)
</parameter_description>
</parameter>
</parameters>
@@ -57027,7 +57514,7 @@ Deprecated: 3.10: Use gtk_image_set_from_icon_name() instead.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> a stock icon size (#GtkIconSize)
</parameter_description>
</parameter>
</parameters>
@@ -59213,6 +59700,9 @@ Since: 3.8
<description>
Sets the value of the #GtkLevelBar:max-value property.
+You probably want to update preexisting level offsets after calling
+this function.
+
Since: 3.6
</description>
@@ -59233,6 +59723,9 @@ Since: 3.6
<description>
Sets the value of the #GtkLevelBar:min-value property.
+You probably want to update preexisting level offsets after calling
+this function.
+
Since: 3.6
</description>
@@ -59581,7 +60074,8 @@ Since: 3.10
</parameter_description>
</parameter>
</parameters>
-<return> the row
+<return> the row or %NULL
+in case no row exists for the given y coordinate.
</return>
</function>
@@ -59958,7 +60452,7 @@ Since: 3.14
</description>
<parameters>
<parameter name="row">
-<parameter_description> a #GTkListBoxrow
+<parameter_description> a #GtkListBoxRow
</parameter_description>
</parameter>
<parameter name="selectable">
@@ -61704,8 +62198,8 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> the accelerator path corresponding to this menu
-item’s functionality, or %NULL if not set
+<return> the accelerator path corresponding to
+this menu item’s functionality, or %NULL if not set
</return>
</function>
@@ -63532,8 +64026,8 @@ Since: 3.20
</parameter_description>
</parameter>
</parameters>
-<return> the transient parent for this window, or %NULL
-if no transient parent has been set.
+<return> the transient parent for this window,
+or %NULL if no transient parent has been set.
</return>
</function>
@@ -63818,8 +64312,8 @@ Since: 2.20
</parameter_description>
</parameter>
</parameters>
-<return> The action widget with the given @pack_type
-or %NULL when this action widget has not been set
+<return> The action widget with the given
+ pack_type or %NULL when this action widget has not been set
</return>
</function>
@@ -63855,8 +64349,7 @@ Since: 2.24
</parameter_description>
</parameter>
</parameters>
-<return> the group name,
-or %NULL if none is set.
+<return> the group name, or %NULL if none is set
</return>
</function>
@@ -63878,8 +64371,8 @@ Retrieves the menu label widget of the page containing @child.
</parameter>
</parameters>
<return> the menu label, or %NULL if the
-notebook page does not have a menu label other than the
-default (the tab label).
+notebook page does not have a menu label other than the default (the tab
+label).
</return>
</function>
@@ -63900,10 +64393,10 @@ Retrieves the text of the menu label for the page containing
</parameter_description>
</parameter>
</parameters>
-<return> the text of the tab label, or %NULL if the
-widget does not have a menu label other than the default
-menu label, or the menu label widget is not a #GtkLabel.
-The string is owned by the widget and must not be freed.
+<return> the text of the tab label, or %NULL if the widget does
+not have a menu label other than the default menu label, or the menu label
+widget is not a #GtkLabel. The string is owned by the widget and must not be
+freed.
</return>
</function>
@@ -63942,8 +64435,8 @@ to get the last page
</parameter_description>
</parameter>
</parameters>
-<return> the child widget, or %NULL
-if @page_num is out of bounds
+<return> the child widget, or %NULL if @page_num
+is out of bounds
</return>
</function>
@@ -64079,9 +64572,9 @@ Retrieves the text of the tab label for the page containing
</parameter_description>
</parameter>
</parameters>
-<return> the text of the tab label, or %NULL if the
-tab label widget is not a #GtkLabel. The string is owned
-by the widget and must not be freed.
+<return> the text of the tab label, or %NULL if the tab label
+widget is not a #GtkLabel. The string is owned by the widget and must not be
+freed.
</return>
</function>
@@ -67801,6 +68294,10 @@ Any arguments used by GTK+ or GDK are removed from the array and
There is no need to call this function explicitly if you are using
gtk_init(), or gtk_init_check().
+Note that many aspects of GTK+ require a display connection to
+function, so this way of initializing GTK+ is really only useful
+for specialized use cases.
+
</description>
<parameters>
@@ -67886,8 +68383,8 @@ Since: 3.10
</parameter_description>
</parameter>
</parameters>
-<return> a GFile with the selected location, or #NULL if nothing is visually
-selected.
+<return> a GFile with the selected location, or
+%NULL if nothing is visually selected.
</return>
</function>
@@ -67912,8 +68409,8 @@ Since: 3.10
</parameter>
</parameters>
<return> The bookmark specified by the index @n, or
-#NULL if no such index exist. Note that the indices start at 0, even though
-the file chooser starts them with the keyboard shortcut “Alt-1”.
+%NULL if no such index exist. Note that the indices start at 0, even though
+the file chooser starts them with the keyboard shortcut "Alt-1".
</return>
</function>
@@ -68796,7 +69293,8 @@ Since: 3.18
</parameter_description>
</parameter>
</parameters>
-<return> the default widget, or %NULL if there is none
+<return> the default widget,
+or %NULL if there is none
</return>
</function>
@@ -74500,6 +74998,9 @@ See gtk_range_set_min_slider_size().
Since: 2.20
+Deprecated: 3.20: Use the min-height/min-width CSS properties on the slider
+node.
+
</description>
<parameters>
<parameter name="range">
@@ -74832,6 +75333,9 @@ This function is useful mainly for #GtkRange subclasses.
Since: 2.20
+Deprecated: 3.20: Use the min-height/min-width CSS properties on the slider
+node.
+
</description>
<parameters>
<parameter name="range">
@@ -77840,6 +78344,44 @@ Since: 3.0.
<return></return>
</function>
+<function name="gtk_render_background_get_clip">
+<description>
+Returns the area that will be affected (i.e. drawn to) when
+calling gtk_render_background() for the given @context and
+rectangle.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="context">
+<parameter_description> a #GtkStyleContext
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> X origin of the rectangle
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y origin of the rectangle
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> rectangle width
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> rectangle height
+</parameter_description>
+</parameter>
+<parameter name="out_clip">
+<parameter_description> return location for the clip
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_render_check">
<description>
Renders a checkmark (as in a #GtkCheckButton).
@@ -78209,8 +78751,9 @@ Deprecated: 3.10: Use gtk_icon_theme_load_icon() instead.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> the size to render the icon at. A size of (GtkIconSize) -1
-means render at the size of the source and don’t scale.
+<parameter_description> the size (#GtkIconSize) to render the icon at.
+A size of `(GtkIconSize) -1` means render at the size of the source
+and don’t scale.
</parameter_description>
</parameter>
</parameters>
@@ -78832,7 +79375,7 @@ Since: 2.12
</description>
<parameters>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> a stock icon size (#GtkIconSize)
</parameter_description>
</parameter>
<parameter name="min">
@@ -79671,8 +80214,8 @@ Since: 2.8
Creates a new scrolled window.
The two arguments are the scrolled window’s adjustments; these will be
-shared with the scrollbars and the child widget to keep the bars in sync
-with the child. Usually you want to pass %NULL for the adjustments, which
+shared with the scrollbars and the child widget to keep the bars in sync
+with the child. Usually you want to pass %NULL for the adjustments, which
will cause the scrolled window to create them for you.
@@ -80915,8 +81458,8 @@ it if necessary. See gtk_settings_get_for_screen().
</description>
<parameters>
</parameters>
-<return> a #GtkSettings object. If there is no default
-screen, then returns %NULL.
+<return> a #GtkSettings object. If there is
+no default screen, then returns %NULL.
</return>
</function>
@@ -81479,7 +82022,8 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> the window of the plug if available, or %NULL
+<return> the window of the plug if
+available, or %NULL
</return>
</function>
@@ -82198,7 +82742,7 @@ Since: 3.10
<function name="gtk_stack_get_interpolate_size">
<description>
Returns wether the #GtkStack is set up to interpolate between
-the sizes of childen on page switch.
+the sizes of children on page switch.
Since: 3.18
@@ -82395,7 +82939,7 @@ Since: 3.10
<function name="gtk_stack_set_interpolate_size">
<description>
Sets whether or not @stack will interpolate its size when
-changing the visible child. If the #GtkStack::interpolate-size
+changing the visible child. If the #GtkStack:interpolate-size
property is set to %TRUE, @stack will interpolate its size between
the current one and the one it'll take after changing the
visible child, according to the set transition duration.
@@ -83929,17 +84473,17 @@ Adds a style class to @context, so posterior calls to
gtk_style_context_get() or any of the gtk_render_*()
functions will make use of this new class for styling.
-In the CSS file format, a #GtkEntry defining an “entry”
+In the CSS file format, a #GtkEntry defining a “search”
class, would be matched by:
|[
-GtkEntry.entry { ... }
+entry.search { ... }
]|
-While any widget defining an “entry” class would be
+While any widget defining a “search” class would be
matched by:
|[
-.entry { ... }
+.search { ... }
]|
Since: 3.0
@@ -84113,6 +84657,8 @@ See gtk_style_context_push_animatable_region()
Retrieves several style property values from @context for a
given state.
+See gtk_style_context_get_property() for details.
+
Since: 3.0
</description>
@@ -84171,7 +84717,9 @@ Deprecated: 3.16: Use gtk_render_background() instead.
<function name="gtk_style_context_get_border">
<description>
Gets the border for a given state as a #GtkBorder.
-See %GTK_STYLE_PROPERTY_BORDER_WIDTH.
+
+See gtk_style_context_get_property() and
+#GTK_STYLE_PROPERTY_BORDER_WIDTH for details.
Since: 3.0
@@ -84199,7 +84747,7 @@ Gets the border color for a given state.
Since: 3.0
-Deprecated: 3.16: Use gtk_render_border() instead.
+Deprecated: 3.16: Use gtk_render_frame() instead.
</description>
<parameters>
@@ -84244,6 +84792,9 @@ FIXME 4.0: Make this part of the signal.
<description>
Gets the foreground color for a given state.
+See gtk_style_context_get_property() and
+#GTK_STYLE_PROPERTY_COLOR for details.
+
Since: 3.0
</description>
@@ -84355,7 +84906,8 @@ Since: 3.0
<function name="gtk_style_context_get_margin">
<description>
Gets the margin for a given state as a #GtkBorder.
-See %GTK_STYLE_PROPERTY_MARGIN.
+See gtk_style_property_get() and #GTK_STYLE_PROPERTY_MARGIN
+for details.
Since: 3.0
@@ -84380,7 +84932,8 @@ Since: 3.0
<function name="gtk_style_context_get_padding">
<description>
Gets the padding for a given state as a #GtkBorder.
-See %GTK_STYLE_PROPERTY_PADDING.
+See gtk_style_context_get() and #GTK_STYLE_PROPERTY_PADDING
+for details.
Since: 3.0
@@ -84443,6 +84996,15 @@ Since: 3.0
<description>
Gets a style property from @context for the given state.
+Note that not all CSS properties that are supported by GTK+ can be
+retrieved in this way, since they may not be representable as #GValue.
+GTK+ defines macros for a number of properties that can be used
+with this function.
+
+Note that passing a state other than the current state of @context
+is not recommended unless the style context has been saved with
+gtk_style_context_save().
+
When @value is no longer needed, g_value_unset() must be called
to free any allocated memory.
@@ -84531,13 +85093,19 @@ always return %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %NULL or the section where value was defined
+<return> %NULL or the section where a value
+for @property was defined
</return>
</function>
<function name="gtk_style_context_get_state">
<description>
-Returns the state used when rendering.
+Returns the state used for style matching.
+
+This method should only be used to retrieve the #GtkStateFlags
+to pass to #GtkStyleContext methods, like gtk_style_context_get_padding().
+If you need to retrieve the current state of a #GtkWidget, use
+gtk_widget_get_state_flags().
Since: 3.0
@@ -84624,6 +85192,8 @@ Since: 3.0
<description>
Retrieves several style property values from @context for a given state.
+See gtk_style_context_get_property() for details.
+
Since: 3.0
</description>
@@ -84647,7 +85217,7 @@ Since: 3.0
<function name="gtk_style_context_has_class">
<description>
Returns %TRUE if @context currently has defined the
-given class name
+given class name.
Since: 3.0
@@ -85290,7 +85860,7 @@ Since: 3.0
<function name="gtk_style_context_set_scale">
<description>
-Sets the scale to use when getting image assets for the style .
+Sets the scale to use when getting image assets for the style.
Since: 3.10
@@ -85337,8 +85907,7 @@ Since: 3.0
<function name="gtk_style_context_set_state">
<description>
-Sets the state to be used when rendering with any
-of the gtk_render_*() functions.
+Sets the state to be used for style matching.
Since: 3.0
@@ -85391,6 +85960,37 @@ Deprecated: 3.6: This function always returns %FALSE
</return>
</function>
+<function name="gtk_style_context_to_string">
+<description>
+Converts the style context into a string representation.
+
+The string representation always includes information about
+the name, state, id, visibility and style classes of the CSS
+node that is backing @context. Depending on the flags, more
+information may be included.
+
+This function is intended for testing and debugging of the
+CSS implementation in GTK+. There are no guarantees about
+the format of the returned string, it may change.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="context">
+<parameter_description> a #GtkStyleContext
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags that determine what to print
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated string representing @context
+
+</return>
+</function>
+
<function name="gtk_style_copy">
<description>
Creates a copy of the passed in #GtkStyle object.
@@ -86081,8 +86681,8 @@ Deprecated:3.0: Use gtk_render_icon_pixbuf() instead
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> the size to render the icon at. A size of
-(GtkIconSize)-1 means render at the size of the source and
+<parameter_description> the size to render the icon at (#GtkIconSize). A size of
+`(GtkIconSize)-1` means render at the size of the source and
don’t scale.
</parameter_description>
</parameter>
@@ -92927,7 +93527,8 @@ Look up a named tag.
</parameter_description>
</parameter>
</parameters>
-<return> The tag, or %NULL if none by that name is in the table.
+<return> The tag, or %NULL if none by that
+name is in the table.
</return>
</function>
@@ -93299,7 +93900,7 @@ cursor position (may be %NULL)
<function name="gtk_text_view_get_cursor_visible">
<description>
-Find out whether the cursor is being displayed.
+Find out whether the cursor should be displayed.
</description>
@@ -93431,6 +94032,7 @@ currently-displayed portion. If you have coordinates from an
event, you have to convert those to buffer coordinates with
gtk_text_view_window_to_buffer_coords().
+
</description>
<parameters>
<parameter name="text_view">
@@ -93450,16 +94052,17 @@ gtk_text_view_window_to_buffer_coords().
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the position is over text
+</return>
</function>
<function name="gtk_text_view_get_iter_at_position">
<description>
-Retrieves the iterator pointing to the character at buffer
-coordinates @x and @y. Buffer coordinates are coordinates for
-the entire buffer, not just the currently-displayed portion.
-If you have coordinates from an event, you have to convert
-those to buffer coordinates with
+Retrieves the iterator pointing to the character at buffer
+coordinates @x and @y. Buffer coordinates are coordinates for
+the entire buffer, not just the currently-displayed portion.
+If you have coordinates from an event, you have to convert
+those to buffer coordinates with
gtk_text_view_window_to_buffer_coords().
Note that this is different from gtk_text_view_get_iter_at_location(),
@@ -93481,7 +94084,7 @@ Since: 2.6
<parameter name="trailing">
<parameter_description> if non-%NULL, location to store an integer indicating where
in the grapheme the user clicked. It will either be
-zero, or the number of characters in the grapheme.
+zero, or the number of characters in the grapheme.
0 represents the trailing edge of the grapheme.
</parameter_description>
</parameter>
@@ -93494,7 +94097,9 @@ zero, or the number of characters in the grapheme.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the position is over text
+
+</return>
</function>
<function name="gtk_text_view_get_iter_location">
@@ -93730,8 +94335,8 @@ with pango_tab_array_free().
</parameter_description>
</parameter>
</parameters>
-<return> copy of default tab array, or %NULL if “standard”
-tabs are used; must be freed with pango_tab_array_free().
+<return> copy of default tab array, or %NULL if
+“standard" tabs are used; must be freed with pango_tab_array_free().
</return>
</function>
@@ -94039,6 +94644,28 @@ buffer, it it isn’t there already.
</return>
</function>
+<function name="gtk_text_view_reset_cursor_blink">
+<description>
+Ensures that the cursor is shown (i.e. not in an 'off' blink
+interval) and resets the time that it will stay blinking (or
+visible, in case blinking is disabled).
+
+This function should be called in response to user input
+(e.g. from derived classes that override the textview's
+#GtkWidget::key-press-event handler).
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="text_view">
+<parameter_description> a #GtkTextView
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_text_view_reset_im_context">
<description>
Reset the input method context of the text view if needed.
@@ -94268,9 +94895,12 @@ will not “adopt” it.
<function name="gtk_text_view_set_cursor_visible">
<description>
-Toggles whether the insertion point is displayed. A buffer with no editable
-text probably shouldn’t have a visible cursor, so you may want to turn
-the cursor off.
+Toggles whether the insertion point should be displayed. A buffer with
+no editable text probably shouldn’t have a visible cursor, so you may
+want to turn the cursor off.
+
+Note that this property may be overridden by the
+#GtkSettings:gtk-keynave-use-caret settings.
</description>
<parameters>
@@ -95573,7 +96203,10 @@ visual appearance, it doesn’t affect the semantics of the button.
<description>
Sets whether the button is displayed as a separate indicator and label.
You can call this function on a checkbutton or a radiobutton with
- draw_indicator = %FALSE to make the button look like a normal button
+ draw_indicator = %FALSE to make the button look like a normal button.
+
+This can be used to create linked strip of buttons that work like
+a #GtkStackSwitcher.
This function only affects instances of classes like #GtkCheckButton
and #GtkRadioButton that derive from #GtkToggleButton,
@@ -97068,8 +97701,8 @@ Since: 2.20
</parameter_description>
</parameter>
</parameters>
-<return> the #GtkToolItemGroup at position or %NULL
-if there is no such group
+<return> the #GtkToolItemGroup at position
+or %NULL if there is no such group
</return>
</function>
@@ -97469,7 +98102,7 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> the current size for icons of @shell
+<return> the current size (#GtkIconSize) for icons of @shell
</return>
</function>
@@ -98013,7 +98646,7 @@ Since: 2.20
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> a stock icon size (#GtkIconSize)
</parameter_description>
</parameter>
</parameters>
@@ -98039,7 +98672,7 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> a stock icon size (#GtkIconSize)
</parameter_description>
</parameter>
</parameters>
@@ -98067,7 +98700,7 @@ Deprecated: 3.10: Use gtk_tooltip_set_icon_from_icon_name() instead.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock icon size
+<parameter_description> a stock icon size (#GtkIconSize)
</parameter_description>
</parameter>
</parameters>
@@ -103055,7 +103688,7 @@ to confirm that the event on @tree_view is on the right window.
</parameter>
</parameters>
<return> A #GdkWindow, or %NULL when @tree_view
-hasn’t been realized yet
+hasn’t been realized yet.
</return>
</function>
@@ -107701,7 +108334,8 @@ Since: 3.8
</parameter_description>
</parameter>
</parameters>
-<return> a #GdkFrameClock (or #NULL if widget is unrealized)
+<return> a #GdkFrameClock,
+or #NULL if widget is unrealized
</return>
</function>
@@ -108646,6 +109280,10 @@ that the effective %GTK_STATE_FLAG_INSENSITIVE state will be
returned, that is, also based on parent insensitivity, even if
@widget itself is sensitive.
+Also note that if you are looking for a way to obtain the
+#GtkStateFlags to pass to a #GtkStyleContext method, you
+should look at gtk_style_context_get_state().
+
Since: 3.0
</description>
@@ -109943,9 +110581,8 @@ are actually containers.
This API is mostly meant as a quick way for applications to
change a widget appearance. If you are developing a widgets
library and intend this change to be themeable, it is better
-done by setting meaningful CSS classes and regions in your
-widget/container implementation through gtk_style_context_add_class()
-and gtk_style_context_add_region().
+done by setting meaningful CSS classes in your
+widget/container implementation through gtk_style_context_add_class().
This way, your widget library can install a #GtkCssProvider
with the %GTK_STYLE_PROVIDER_PRIORITY_FALLBACK priority in order
@@ -111454,8 +112091,8 @@ Deprecated: 3.0: Use gtk_widget_render_icon_pixbuf() instead.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock size. A size of (GtkIconSize)-1 means
-render at the size of the source and don’t scale (if there are
+<parameter_description> a stock size (#GtkIconSize). A size of `(GtkIconSize)-1`
+means render at the size of the source and don’t scale (if there are
multiple source sizes, GTK+ picks one of the available sizes).
</parameter_description>
</parameter>
@@ -111497,8 +112134,8 @@ Deprecated: 3.10: Use gtk_icon_theme_load_icon() instead.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a stock size. A size of (GtkIconSize)-1 means
-render at the size of the source and don’t scale (if there are
+<parameter_description> a stock size (#GtkIconSize). A size of `(GtkIconSize)-1`
+means render at the size of the source and don’t scale (if there are
multiple source sizes, GTK+ picks one of the available sizes).
</parameter_description>
</parameter>
@@ -114996,6 +115633,7 @@ return 0;
}
]|
+Deprecated: 3.20: Geometry handling in GTK is deprecated.
</description>
<parameters>
@@ -115009,6 +115647,7 @@ return 0;
</parameter>
</parameters>
<return> %TRUE if string was parsed successfully
+
</return>
</function>
@@ -115413,6 +116052,9 @@ gtk_window_set_geometry_hints.
Since: 3.0
+Deprecated: 3.20: This function does nothing. If you want to set a default
+size, use gtk_window_set_default_size() instead.
+
</description>
<parameters>
<parameter name="window">
@@ -115541,6 +116183,11 @@ it had prior to hiding, rather than using the default size.
Windows can’t actually be 0x0 in size, they must be at least 1x1, but
passing 0 for @width and @height is OK, resulting in a 1x1 default size.
+If you use this function to reestablish a previously saved window size,
+note that the appropriate size to save is the one returned by
+gtk_window_get_size(). Using the window allocation directly will not
+work in all circumstances and can lead to growing or shrinking windows.
+
</description>
<parameters>
<parameter name="window">
@@ -116359,6 +117006,12 @@ gtk_window_set_transient_for() on your behalf.
Passing %NULL for @parent unsets the current transient window.
+On Wayland, this function can also be used to attach a new
+#GTK_WINDOW_POPUP to a #GTK_WINDOW_TOPLEVEL parent already mapped
+on screen so that the #GTK_WINDOW_POPUP will be created as a
+subsurface-based window #GDK_WINDOW_SUBSURFACE which can be
+positioned at will relatively to the #GTK_WINDOW_TOPLEVEL surface.
+
On Windows, this function puts the child window on top of the parent,
much as the window manager would have done on X.
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
