[gtkmm] Gtk: Regenerate .defs and .xml
- From: Murray Cumming <murrayc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtkmm] Gtk: Regenerate .defs and .xml
- Date: Wed, 28 Aug 2013 10:55:49 +0000 (UTC)
commit 1b2a8bee27f31e0209c1f91dfa52f63e9e18709b
Author: Murray Cumming <murrayc murrayc com>
Date: Wed Aug 28 12:08:10 2013 +0200
Gtk: Regenerate .defs and .xml
gtk/src/gtk_docs.xml | 5187 +++++++++++++++++++++++++++++++++++++++++++---
gtk/src/gtk_enums.defs | 17 +
gtk/src/gtk_methods.defs | 137 ++-
gtk/src/gtk_signals.defs | 64 +-
4 files changed, 5118 insertions(+), 287 deletions(-)
---
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index 69437be..ef843d5 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -120,6 +120,8 @@ The "activate" signal is emitted when the action is activated.
Since: 2.4
+Deprecated: 3.10: Use #GSimpleAction:activate instead
+
</description>
<parameters>
<parameter name="action">
@@ -146,6 +148,8 @@ convenient to use.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -175,6 +179,8 @@ convenient to use.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -203,6 +209,8 @@ notification just after any action is activated.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -227,6 +235,8 @@ notification just before any action is activated.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -285,6 +295,10 @@ positioned to one side of the space.
Note that in horizontal context @GTK_ALIGN_START and @GTK_ALIGN_END
are interpreted relative to text direction.
+GTK_ALIGN_BASELINE support for it is optional for containers and widgets, and
+it is only supported for vertical alignment. When its not supported by
+a child or a container it is treated as @GTK_ALIGN_FILL.
+
</description>
<parameters>
<parameter name="GTK_ALIGN_FILL">
@@ -307,6 +321,10 @@ or top
allocation
</parameter_description>
</parameter>
+<parameter name="GTK_ALIGN_BASELINE">
+<parameter_description> align the widget according to the baseline. Since 3.10.
+</parameter_description>
+</parameter>
</parameters>
</enum>
@@ -675,6 +693,34 @@ container that has been allocated.
</parameters>
</enum>
+<enum name="GtkBaselinePosition">
+<description>
+Whenever a container has some form of natural row it may align
+children in that row along a common typographical baseline. If
+the amount of verical space in the row is taller than the total
+requested height of the baseline-aligned children then it can use a
+#GtkBaselinePosition to select where to put the baseline inside the
+extra availible space.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="GTK_BASELINE_POSITION_TOP">
+<parameter_description> Align the baseline at the top
+</parameter_description>
+</parameter>
+<parameter name="GTK_BASELINE_POSITION_CENTER">
+<parameter_description> Center the baseline
+</parameter_description>
+</parameter>
+<parameter name="GTK_BASELINE_POSITION_BOTTOM">
+<parameter_description> Align the baseline at the bottom
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<enum name="GtkBorderStyle">
<description>
Describes how the border of a UI element should be rendered.
@@ -775,6 +821,15 @@ of GTK+.
<parameter_description> An object id occurred twice.
</parameter_description>
</parameter>
+<parameter name="GTK_BUILDER_ERROR_OBJECT_TYPE_REFUSED">
+<parameter_description> A specified object type is of the same type or
+derived from the type of the composite class being extended with builder XML.
+</parameter_description>
+</parameter>
+<parameter name="GTK_BUILDER_ERROR_TEMPLATE_MISMATCH">
+<parameter_description> The wrong type was specified in a composite class's template XML
+</parameter_description>
+</parameter>
</parameters>
</enum>
@@ -2355,7 +2410,7 @@ If you need to add items to the context menu, connect
to this signal and append your items to the @widget, which
will be a #GtkMenu in this case.
-If #GtkEntry::populate-all is %TRUE, this signal will
+If #GtkEntry:populate-all is %TRUE, this signal will
also be emitted to populate touch popups. In this case,
@widget will be a different container, e.g. a #GtkToolbar.
The signal handler should not make assumptions about the
@@ -2397,6 +2452,18 @@ Since: 2.20
<return></return>
</signal>
+<signal name="GtkEntry::tabs">
+<description>
+A list of tabstops to apply to the text of the entry.
+
+Since: 3.8
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</signal>
+
<signal name="GtkEntry::toggle-overwrite">
<description>
The ::toggle-overwrite signal is a
@@ -3482,6 +3549,11 @@ This image type was added in GTK+ 2.6
This image type was added in GTK+ 2.14
</parameter_description>
</parameter>
+<parameter name="GTK_IMAGE_SURFACE">
+<parameter_description> the widget contains a #cairo_surface_t.
+This image type was added in GTK+ 3.10
+</parameter_description>
+</parameter>
</parameters>
</enum>
@@ -3970,6 +4042,48 @@ your handler.
<return></return>
</signal>
+<signal name="GtkListBox::row-activated">
+<description>
+The ::row-activated signal is emitted when a row has been activated by
+the user.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> the #GtkListBox
+</parameter_description>
+</parameter>
+<parameter name="row">
+<parameter_description> the activated row
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkListBox::row-selected">
+<description>
+The ::row-selected signal is emitted when a new row is selected, or
+(with a %NULL @row) when the selection is cleared.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> the #GtkListBox
+</parameter_description>
+</parameter>
+<parameter name="row">
+<parameter_description> the selected row
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
<signal name="GtkMenu::move-scroll">
<description>
@@ -4704,6 +4818,261 @@ Since: 2.0
<return></return>
</signal>
+<enum name="GtkPlacesOpenFlags">
+<description>
+These flags serve two purposes. First, the application can call gtk_places_sidebar_set_open_flags()
+using these flags as a bitmask. This tells the sidebar that the application is able to open
+folders selected from the sidebar in various ways, for example, in new tabs or in new windows in
+addition to the normal mode.
+
+Second, when one of these values gets passed back to the application in the
+#GtkPlacesSidebar::open-location signal, it means that the application should
+open the selected location in the normal way, in a new tab, or in a new
+window. The sidebar takes care of determining the desired way to open the location,
+based on the modifier keys that the user is pressing at the time the selection is made.
+
+If the application never calls gtk_places_sidebar_set_open_flags(), then the sidebar will only
+use #GTK_PLACES_OPEN_NORMAL in the #GtkPlacesSidebar::open-location signal. This is the
+default mode of operation.
+
+</description>
+<parameters>
+<parameter name="GTK_PLACES_OPEN_NORMAL">
+<parameter_description> This is the default mode that #GtkPlacesSidebar uses if no other flags
+are specified. It indicates that the calling application should open the selected location
+in the normal way, for example, in the folder view beside the sidebar.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PLACES_OPEN_NEW_TAB">
+<parameter_description> When passed to gtk_places_sidebar_set_open_flags(), this indicates
+that the application can open folders selected from the sidebar in new tabs. This value
+will be passed to the #GtkPlacesSidebar::open-location signal when the user selects
+that a location be opened in a new tab instead of in the standard fashion.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PLACES_OPEN_NEW_WINDOW">
+<parameter_description> Similar to @GTK_PLACES_OPEN_NEW_TAB, but indicates that the application
+can open folders in new windows.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
+<signal name="GtkPlacesSidebar::drag-action-ask">
+<description>
+The places sidebar emits this signal when it needs to ask the application
+to pop up a menu to ask the user for which drag action to perform.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> the object which received the signal.
+</parameter_description>
+</parameter>
+<parameter name="actions">
+<parameter_description> Possible drag actions that need to be asked for.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the final drag action that the sidebar should pass to the drag side
+of the drag-and-drop operation.
+
+</return>
+</signal>
+
+<signal name="GtkPlacesSidebar::drag-action-requested">
+<description>
+When the user starts a drag-and-drop operation and the sidebar needs
+to ask the application for which drag action to perform, then the
+sidebar will emit this signal.
+
+The application can evaluate the @context for customary actions, or
+it can check the type of the files indicated by @source_file_list against the
+possible actions for the destination @dest_file.
+
+The drag action to use must be the return value of the signal handler.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> the object which received the signal.
+</parameter_description>
+</parameter>
+<parameter name="context">
+<parameter_description> #GdkDragContext with information about the drag operation
+</parameter_description>
+</parameter>
+<parameter name="dest_file">
+<parameter_description> #GFile with the tentative location that is being hovered for a drop
+</parameter_description>
+</parameter>
+<parameter name="source_file_list">
+<parameter_description> List of #GFile that are being dragged
+</parameter_description>
+</parameter>
+</parameters>
+<return> The drag action to use, for example, #GDK_ACTION_COPY
+or #GDK_ACTION_MOVE, or 0 if no action is allowed here (i.e. drops
+are not allowed in the specified @dest_file).
+
+</return>
+</signal>
+
+<signal name="GtkPlacesSidebar::drag-perform-drop">
+<description>
+The places sidebar emits this signal when the user completes a
+drag-and-drop operation and one of the sidebar's items is the
+destination. This item is in the @dest_file, and the
+ source_file_list has the list of files that are dropped into it and
+which should be copied/moved/etc. based on the specified @action.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> the object which received the signal.
+</parameter_description>
+</parameter>
+<parameter name="dest_file">
+<parameter_description> Destination #GFile.
+</parameter_description>
+</parameter>
+<parameter name="source_file_list">
+<parameter_description> #GList of #GFile that got dropped.
+</parameter_description>
+</parameter>
+<parameter name="action">
+<parameter_description> Drop action to perform.
+</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
+in it. The calling application should display the contents of that
+location; for example, a file manager should show a list of files in
+the specified location.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> the object which received the signal.
+</parameter_description>
+</parameter>
+<parameter name="location">
+<parameter_description> #GFile to which the caller should switch.
+</parameter_description>
+</parameter>
+<parameter name="open_flags">
+<parameter_description> a single value from #GtkPlacesOpenFlags specifying how the @location should be
opened.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkPlacesSidebar::populate-popup">
+<description>
+The places sidebar emits this signal when the user invokes a contextual
+menu on one of its items. In the signal handler, the application may
+add extra items to the menu as appropriate. For example, a file manager
+may want to add a "Properties" command to the menu.
+
+It is not necessary to store the @selected_item for each menu item;
+during their GtkMenuItem::activate callbacks, the application can use
+gtk_places_sidebar_get_location() to get the file to which the item
+refers.
+
+The @selected_item argument may be #NULL in case the selection refers to
+a volume. In this case, @selected_volume will be non-NULL. In this case,
+the calling application will have to g_object_ref() the @selected_volume and
+keep it around for the purposes of its menu item's "activate" callback.
+
+The @menu and all its menu items are destroyed after the user
+dismisses the menu. The menu is re-created (and thus, this signal is
+emitted) every time the user activates the contextual menu.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> the object which received the signal.
+</parameter_description>
+</parameter>
+<parameter name="menu">
+<parameter_description> a #GtkMenu.
+</parameter_description>
+</parameter>
+<parameter name="selected_item">
+<parameter_description> #GFile with the item to which the menu should refer, or #NULL in the case of a
@selected_volume.
+</parameter_description>
+</parameter>
+<parameter name="selected_volume">
+<parameter_description> #GVolume if the selected item is a volume, or #NULL if it is a file.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkPlacesSidebar::show-connect-to-server">
+<description>
+The places sidebar emits this signal when it needs the calling
+application to present an way to connect directly to a network server.
+For example, the application may bring up a dialog box asking for
+a URL like "sftp://ftp.example.com". It is up to the application to create
+the corresponding mount by using, for example, g_file_mount_enclosing_volume().
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> the object which received the signal.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkPlacesSidebar::show-error-message">
+<description>
+The places sidebar emits this signal when it needs the calling
+application to present an error message. Most of these messages
+refer to mounting or unmounting media, for example, when a drive
+cannot be started for some reason.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> the object which received the signal.
+</parameter_description>
+</parameter>
+<parameter name="primary">
+<parameter_description> primary message with a summary of the error to show.
+</parameter_description>
+</parameter>
+<parameter name="secondary">
+<parameter_description> secondary message with details of the error to show.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
<signal name="GtkPlug::embedded">
<description>
Gets emitted when the plug becomes embedded in a socket.
@@ -5427,6 +5796,8 @@ for the previous and current active members.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action">
@@ -6047,6 +6418,40 @@ or if the dialog gets programmatically hidden or destroyed
</parameters>
</enum>
+<enum name="GtkRevealerTransitionType">
+<description>
+These enumeration values describe the possible transitions
+when the child of a #GtkRevealer widget is shown or hidden.
+
+</description>
+<parameters>
+<parameter name="GTK_REVEALER_TRANSITION_TYPE_NONE">
+<parameter_description> No transition
+</parameter_description>
+</parameter>
+<parameter name="GTK_REVEALER_TRANSITION_TYPE_CROSSFADE">
+<parameter_description> Fade in
+</parameter_description>
+</parameter>
+<parameter name="GTK_REVEALER_TRANSITION_TYPE_SLIDE_RIGHT">
+<parameter_description> Slide in from the left
+</parameter_description>
+</parameter>
+<parameter name="GTK_REVEALER_TRANSITION_TYPE_SLIDE_LEFT">
+<parameter_description> Slide in from the right
+</parameter_description>
+</parameter>
+<parameter name="GTK_REVEALER_TRANSITION_TYPE_SLIDE_UP">
+<parameter_description> Slide in from the bottom
+</parameter_description>
+</parameter>
+<parameter name="GTK_REVEALER_TRANSITION_TYPE_SLIDE_DOWN">
+<parameter_description> Slide in from the top
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<signal name="GtkScale::format-value">
<description>
Signal which allows you to change how the scale value is displayed.
@@ -6215,6 +6620,23 @@ horizontally or not
<return></return>
</signal>
+<signal name="GtkSearchEntry::search-changed">
+<description>
+The #GtkSearchEntry::search-changed signal is emitted with a short
+delay of 150 milliseconds after the last change to the entry text.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="entry">
+<parameter_description> the entry on which the signal was emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
<enum name="GtkSelectionMode">
<description>
Used to control what selections users are allowed to make.
@@ -6277,6 +6699,20 @@ Whether images should be shown on buttons
Since: 2.4
+Deprecated: 3.10: This setting is ignored
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkSettings::gtk-menu-images">
+<description>
+Whether images should be shown in menu items
+
+Deprecated: 3.10: This setting is ignored
+
</description>
<parameters>
</parameters>
@@ -6549,6 +6985,48 @@ change to make in gtk_spin_button_spin().
</parameters>
</enum>
+<enum name="GtkStackTransitionType">
+<description>
+These enumeration values describe the possible transitions
+between pages in a #GtkStack widget.
+
+</description>
+<parameters>
+<parameter name="GTK_STACK_TRANSITION_TYPE_NONE">
+<parameter_description> No transition
+</parameter_description>
+</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_CROSSFADE">
+<parameter_description> A cross-fade
+</parameter_description>
+</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_SLIDE_RIGHT">
+<parameter_description> Slide from left to right
+</parameter_description>
+</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_SLIDE_LEFT">
+<parameter_description> Slide from right to left
+</parameter_description>
+</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_SLIDE_UP">
+<parameter_description> Slide from bottom up
+</parameter_description>
+</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_SLIDE_DOWN">
+<parameter_description> Slide from top down
+</parameter_description>
+</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_SLIDE_LEFT_RIGHT">
+<parameter_description> Slide from left or right according to the children order
+</parameter_description>
+</parameter>
+<parameter name="GTK_STACK_TRANSITION_TYPE_SLIDE_UP_DOWN">
+<parameter_description> Slide from top down or bottom up according to the order
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<enum name="GtkStateFlags">
<description>
Describes a widget state. Widget states are used to match the widget
@@ -6756,7 +7234,7 @@ triggered the signal emission
<signal name="GtkStatusIcon::query-tooltip">
<description>
-Emitted when the #GtkSettings:gtk-tooltip-timeout has expired with the
+Emitted when the hover timeout has expired with the
cursor hovering above @status_icon; or emitted when @status_icon got
focus in keyboard mode.
@@ -7088,7 +7566,7 @@ from a #GtkTextBuffer.
Note that if your handler runs before the default handler it must not
invalidate the @start and @end iters (or has to revalidate them).
The default signal handler revalidates the @start and @end iters to
-both point point to the location where text was deleted. Handlers
+both point to the location where text was deleted. Handlers
which run after the default handler (see g_signal_connect_after())
do not have access to the deleted text.
@@ -7314,6 +7792,10 @@ Since: 2.16
<parameter_description> the object which received the signal
</parameter_description>
</parameter>
+<parameter name="clipboard">
+<parameter_description> the #GtkClipboard pasted from
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</signal>
@@ -7352,6 +7834,34 @@ gtk_text_buffer_remove_tag().
<return></return>
</signal>
+<enum name="GtkTextSearchFlags">
+<description>
+Flags affecting how a search is done.
+
+If neither #GTK_TEXT_SEARCH_VISIBLE_ONLY nor #GTK_TEXT_SEARCH_TEXT_ONLY are
+enabled, the match must be exact; the special 0xFFFC character will match
+embedded pixbufs or child widgets.
+
+</description>
+<parameters>
+<parameter name="GTK_TEXT_SEARCH_VISIBLE_ONLY">
+<parameter_description> Search only visible data. A search match may
+have invisible text interspersed.
+</parameter_description>
+</parameter>
+<parameter name="GTK_TEXT_SEARCH_TEXT_ONLY">
+<parameter_description> Search only text. A match may have pixbufs or
+child widgets mixed inside the matched range.
+</parameter_description>
+</parameter>
+<parameter name="GTK_TEXT_SEARCH_CASE_INSENSITIVE">
+<parameter_description> The text will be matched regardless of
+what case it is in.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<signal name="GtkTextTag::event">
<description>
The ::event signal is emitted when an event occurs on a region of the
@@ -7653,7 +8163,7 @@ If you need to add items to the context menu, connect
to this signal and append your items to the @popup, which
will be a #GtkMenu in this case.
-If #GtkEntry::populate-toolbar is %TRUE, this signal will
+If #GtkTextView:populate-all is %TRUE, this signal will
also be emitted to populate touch popups. In this case,
@popup will be a different container, e.g. a #GtkToolbar.
@@ -7785,6 +8295,8 @@ The default bindings for this signal is Insert.
Should be connected if you wish to perform an action
whenever the #GtkToggleAction state is changed.
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="toggleaction">
@@ -8460,6 +8972,8 @@ changes.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -8478,6 +8992,8 @@ gtk_ui_manager_get_widget().
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -8503,6 +9019,8 @@ statusbar.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -8528,6 +9046,8 @@ from an action in the group.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -8556,6 +9076,8 @@ just after any action is activated.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -8580,6 +9102,8 @@ just before any action is activated.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -8599,6 +9123,8 @@ Since: 2.4
These enumeration values are used by gtk_ui_manager_add_ui() to determine
what UI element to create.
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="GTK_UI_MANAGER_AUTO">
@@ -9578,6 +10104,8 @@ if it becomes unshadowed
<signal name="GtkWidget::hide">
<description>
+The ::hide signal is emitted when @widget is hidden, for example with
+gtk_widget_hide().
</description>
<parameters>
@@ -9720,6 +10248,15 @@ this signal.
<signal name="GtkWidget::map">
<description>
+The ::map signal is emitted when @widget is going to be mapped, that is
+when the widget is visible (which is controlled with
+gtk_widget_set_visible()) and all its parents up to the toplevel widget
+are also visible. Once the map has occurred, #GtkWidget::map-event will
+be emitted.
+
+The ::map signal can be used to determine whether a widget will be drawn,
+for instance it can resume an animation that was stopped during the
+emission of #GtkWidget::unmap.
</description>
<parameters>
@@ -9940,7 +10477,7 @@ this signal.
<signal name="GtkWidget::query-tooltip">
<description>
-Emitted when #GtkWidget:has-tooltip is %TRUE and the #GtkSettings:gtk-tooltip-timeout
+Emitted when #GtkWidget:has-tooltip is %TRUE and the hover timeout
has expired with the cursor hovering "above" @widget; or emitted when @widget got
focus in keyboard mode.
@@ -9987,6 +10524,9 @@ been emitted, relative to @widget's top
<signal name="GtkWidget::realize">
<description>
+The ::realize signal is emitted when @widget is associated with a
+#GdkWindow, which means that gtk_wiget_realize() has been called or the
+widget has been mapped (that is, it is going to be drawn).
</description>
<parameters>
@@ -10160,6 +10700,8 @@ this signal.
<signal name="GtkWidget::show">
<description>
+The ::show signal is emitted when @widget is shown, for example with
+gtk_widget_show().
</description>
<parameters>
@@ -10296,6 +10838,12 @@ Since: 3.0
<signal name="GtkWidget::unmap">
<description>
+The ::unmap signal is emitted when @widget is going to be unmapped, which
+means that either it or any of its parents up to the toplevel widget have
+been set as hidden.
+
+As ::unmap indicates that a widget will not be shown any longer, it can be
+used to, for example, stop an animation on the widget.
</description>
<parameters>
@@ -10335,6 +10883,10 @@ automatically for all new windows.
<signal name="GtkWidget::unrealize">
<description>
+The ::unrealize signal is emitted when the #GdkWindow associated with
+ widget is destroyed, which means that gtk_widget_unrealize() has been
+called or the widget has been unmapped (that is, it is going to be
+hidden).
</description>
<parameters>
@@ -12368,6 +12920,8 @@ It can also be used to manually activate an action.
Since: 2.4
+Deprecated: 3.10: Use g_action_group_activate_action() on a #GAction instead
+
</description>
<parameters>
<parameter name="action">
@@ -12389,6 +12943,9 @@ cases (updating toggle state for instance).
Since: 2.16
+Deprecated: 3.10: Use g_simple_action_set_enabled() to disable the
+#GSimpleAction instead
+
</description>
<parameters>
<parameter name="action">
@@ -12412,6 +12969,9 @@ gtk_action_disconnect_accelerator() has been called as many times.
Since: 2.4
+Deprecated: 3.10: Use #GAction and the accelerator group on an associated
+#GtkMenu instead
+
</description>
<parameters>
<parameter name="action">
@@ -12429,6 +12989,9 @@ create icons displayed in the proxy widgets.
Since: 2.4
+Deprecated: 3.10: Use g_menu_item_set_icon() to set an icon on a #GMenuItem,
+or gtk_container_add() to add a #GtkImage to a #GtkButton
+
</description>
<parameters>
<parameter name="action">
@@ -12453,6 +13016,9 @@ instance of that menu.
Since: 2.12
+Deprecated: 3.10: Use #GAction and #GMenuModel instead, and create a
+#GtkMenu with gtk_menu_new_from_model()
+
</description>
<parameters>
<parameter name="action">
@@ -12472,6 +13038,9 @@ Creates a menu item widget that proxies for the given action.
Since: 2.4
+Deprecated: 3.10: Use g_menu_item_new() and associate it with a #GAction
+instead.
+
</description>
<parameters>
<parameter name="action">
@@ -12490,6 +13059,9 @@ Creates a toolbar item widget that proxies for the given action.
Since: 2.4
+Deprecated: 3.10: Use a #GtkToolItem and associate it with a #GAction using
+gtk_actionable_set_action_name() instead
+
</description>
<parameters>
<parameter name="action">
@@ -12508,6 +13080,9 @@ Undoes the effect of one call to gtk_action_connect_accelerator().
Since: 2.4
+Deprecated: 3.10: Use #GAction and the accelerator group on an associated
+#GtkMenu instead
+
</description>
<parameters>
<parameter name="action">
@@ -12524,6 +13099,8 @@ Returns the accel closure for this action.
Since: 2.8
+Deprecated: 3.10: Use #GAction and #GtkMenu instead, which have no
+equivalent for getting the accel closure
</description>
<parameters>
@@ -12535,6 +13112,7 @@ Since: 2.8
<return> the accel closure for this action. The
returned closure is owned by GTK+ and must not be unreffed
or modified.
+
</return>
</function>
@@ -12544,6 +13122,8 @@ Returns the accel path for this action.
Since: 2.6
+Deprecated: 3.10: Use #GAction and the accelerator path on an associated
+#GtkMenu instead
</description>
<parameters>
@@ -12555,17 +13135,20 @@ Since: 2.6
<return> the accel path for this action, or %NULL
if none is set. The returned string is owned by GTK+
and must not be freed or modified.
+
</return>
</function>
<function name="gtk_action_get_always_show_image">
<description>
-Returns whether @action<!-- -->'s menu item proxies will ignore the
-#GtkSettings:gtk-menu-images setting and always show their image,
-if available.
+Returns whether @action<!-- -->'s menu item proxies will always
+show their image, if available.
Since: 2.20
+Deprecated: 3.10: Use g_menu_item_get_attribute_value() on a #GMenuItem
+instead
+
</description>
<parameters>
<parameter name="action">
@@ -12584,6 +13167,10 @@ Gets the gicon of @action.
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, and
+g_menu_item_get_attribute_value() to get an icon from a #GMenuItem
+associated with a #GAction
+
</description>
<parameters>
<parameter name="action">
@@ -12602,6 +13189,10 @@ Gets the icon name of @action.
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, and
+g_menu_item_get_attribute_value() to get an icon from a #GMenuItem
+associated with a #GAction
+
</description>
<parameters>
<parameter name="action">
@@ -12620,6 +13211,9 @@ Checks whether @action is important or not
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, and control and monitor whether
+labels are shown directly
+
</description>
<parameters>
<parameter name="action">
@@ -12638,6 +13232,10 @@ Gets the label text of @action.
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, and get a label from a menu item
+with g_menu_item_get_attribute_value(). For #GtkActionable widgets, use the
+widget-specific API to get a label
+
</description>
<parameters>
<parameter name="action">
@@ -12656,6 +13254,8 @@ Returns the name of the action.
Since: 2.4
+Deprecated: 3.10: Use g_action_get_name() on a #GAction instead
+
</description>
<parameters>
<parameter name="action">
@@ -12676,6 +13276,8 @@ See also gtk_activatable_get_related_action().
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action">
@@ -12697,6 +13299,9 @@ for that.
Since: 2.4
+Deprecated: 3.10: Use g_simple_action_get_enabled() on a #GSimpleAction
+instead
+
</description>
<parameters>
<parameter name="action">
@@ -12715,6 +13320,9 @@ Gets the short label text of @action.
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, which has no equivalent of short
+labels
+
</description>
<parameters>
<parameter name="action">
@@ -12733,6 +13341,9 @@ Gets the stock id of @action.
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, which has no equivalent of stock
+items
+
</description>
<parameters>
<parameter name="action">
@@ -12751,6 +13362,9 @@ Gets the tooltip text of @action.
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, and get tooltips from associated
+#GActionable widgets with gtk_widget_get_tooltip_text()
+
</description>
<parameters>
<parameter name="action">
@@ -12771,6 +13385,9 @@ for that.
Since: 2.4
+Deprecated: 3.10: Use #GAction instead, and control and monitor the state of
+#GtkActionable widgets directly
+
</description>
<parameters>
<parameter name="action">
@@ -12789,6 +13406,9 @@ Checks whether @action is visible when horizontal
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, and control and monitor the
+visibility of associated widgets and menu items directly
+
</description>
<parameters>
<parameter name="action">
@@ -12807,6 +13427,9 @@ Checks whether @action is visible when horizontal
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, and control and monitor the
+visibility of associated widgets and menu items directly
+
</description>
<parameters>
<parameter name="action">
@@ -12830,6 +13453,8 @@ gtk_action_set_accel_path(), or use
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -12856,6 +13481,8 @@ Accel paths are set to
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -12887,6 +13514,8 @@ their accel paths are set to
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -12916,6 +13545,8 @@ callback for @user_data.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -12953,6 +13584,8 @@ The "changed" signal of the first radio action is connected to the
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -12991,6 +13624,8 @@ This variant of gtk_action_group_add_radio_actions() adds a
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -13037,6 +13672,8 @@ their accel paths are set to
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -13066,6 +13703,8 @@ This variant of gtk_action_group_add_toggle_actions() adds a
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -13098,6 +13737,8 @@ Gets the accelerator group.
Since: 3.6
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -13117,6 +13758,8 @@ Looks up an action in the action group by name.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -13139,6 +13782,8 @@ Gets the name of the action group.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -13160,6 +13805,8 @@ is sensitive.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -13181,6 +13828,8 @@ is visible.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -13199,6 +13848,8 @@ Lists the actions in the action group.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -13219,6 +13870,8 @@ with the actions.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="name">
@@ -13237,6 +13890,8 @@ Removes an action object from the action group.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -13257,6 +13912,8 @@ Sets the accelerator group to be used by every action in this group.
Since: 3.6
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -13277,6 +13934,8 @@ Changes the sensitivity of @action_group
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -13301,6 +13960,8 @@ with gtk_action_group_set_translation_domain().
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -13335,6 +13996,8 @@ gtk_action_group_set_translate_func().
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -13356,6 +14019,8 @@ Changes the visible of @action_group.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -13378,6 +14043,8 @@ is mainly intended for language bindings.
Since: 2.6
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action_group">
@@ -13400,6 +14067,9 @@ Returns whether the action is effectively sensitive.
Since: 2.4
+Deprecated: 3.10: Use g_simple_action_get_enabled() on a #GSimpleAction
+instead
+
</description>
<parameters>
<parameter name="action">
@@ -13419,6 +14089,9 @@ Returns whether the action is effectively visible.
Since: 2.4
+Deprecated: 3.10: Use #GAction instead, and control and monitor the state of
+#GtkActionable widgets directly
+
</description>
<parameters>
<parameter name="action">
@@ -13432,6 +14105,103 @@ are both visible.
</return>
</function>
+<function name="gtk_action_muxer_get_parent">
+<description>
+
+</description>
+<parameters>
+<parameter name="muxer">
+<parameter_description> a #GtkActionMuxer
+</parameter_description>
+</parameter>
+</parameters>
+<return> the parent of @muxer, or NULL.
+</return>
+</function>
+
+<function name="gtk_action_muxer_insert">
+<description>
+Adds the actions in @action_group to the list of actions provided by
+ muxer @prefix is prefixed to each action name, such that for each
+action <varname>x</varname> in @action_group, there is an equivalent
+action @prefix<literal>.</literal><varname>x</varname> in @muxer.
+
+For example, if @prefix is "<literal>app</literal>" and @action_group
+contains an action called "<literal>quit</literal>", then @muxer will
+now contain an action called "<literal>app.quit</literal>".
+
+If any #GtkActionObservers are registered for actions in the group,
+"action_added" notifications will be emitted, as appropriate.
+
+ prefix must not contain a dot ('.').
+
+</description>
+<parameters>
+<parameter name="muxer">
+<parameter_description> a #GtkActionMuxer
+</parameter_description>
+</parameter>
+<parameter name="prefix">
+<parameter_description> the prefix string for the action group
+</parameter_description>
+</parameter>
+<parameter name="action_group">
+<parameter_description> a #GActionGroup
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_action_muxer_new">
+<description>
+Creates a new #GtkActionMuxer.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_action_muxer_remove">
+<description>
+Removes a #GActionGroup from the #GtkActionMuxer.
+
+If any #GtkActionObservers are registered for actions in the group,
+"action_removed" notifications will be emitted, as appropriate.
+
+</description>
+<parameters>
+<parameter name="muxer">
+<parameter_description> a #GtkActionMuxer
+</parameter_description>
+</parameter>
+<parameter name="prefix">
+<parameter_description> the prefix of the action group to remove
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_action_muxer_set_parent">
+<description>
+Sets the parent of @muxer to @parent.
+
+</description>
+<parameters>
+<parameter name="muxer">
+<parameter_description> a #GtkActionMuxer
+</parameter_description>
+</parameter>
+<parameter name="parent">
+<parameter_description> the new parent #GtkActionMuxer
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_action_new">
<description>
Creates a new #GtkAction object. To add the action to a
@@ -13442,6 +14212,9 @@ names.
Since: 2.4
+Deprecated: 3.10: Use #GAction instead, associating it to a widget with
+#GtkActionable or creating a #GtkMenu with gtk_menu_new_from_model()
+
</description>
<parameters>
<parameter name="name">
@@ -13468,6 +14241,181 @@ the action, or %NULL
</return>
</function>
+<function name="gtk_action_observable_register_observer">
+<description>
+Registers @observer as being interested in changes to @action_name on
+ observable
+
+</description>
+<parameters>
+<parameter name="observable">
+<parameter_description> a #GtkActionObservable
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> the name of the action
+</parameter_description>
+</parameter>
+<parameter name="observer">
+<parameter_description> the #GtkActionObserver to which the events will be reported
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_action_observable_unregister_observer">
+<description>
+Removes the registration of @observer as being interested in changes
+to @action_name on @observable.
+
+If the observer was registered multiple times, it must be
+unregistered an equal number of times.
+
+</description>
+<parameters>
+<parameter name="observable">
+<parameter_description> a #GtkActionObservable
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> the name of the action
+</parameter_description>
+</parameter>
+<parameter name="observer">
+<parameter_description> the #GtkActionObserver to which the events will be reported
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_action_observer_action_added">
+<description>
+This function is called when an action that the observer is
+registered to receive events for is added.
+
+This function should only be called by objects with which the
+observer has explicitly registered itself to receive events.
+
+</description>
+<parameters>
+<parameter name="observer">
+<parameter_description> a #GtkActionObserver
+</parameter_description>
+</parameter>
+<parameter name="observable">
+<parameter_description> the source of the event
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> the name of the action
+</parameter_description>
+</parameter>
+<parameter name="enabled">
+<parameter_description> %TRUE if the action is now enabled
+</parameter_description>
+</parameter>
+<parameter name="parameter_type">
+<parameter_description> the parameter type for action invocations, or %NULL
+if no parameter is required
+</parameter_description>
+</parameter>
+<parameter name="state">
+<parameter_description> the current state of the action, or %NULL if the action is
+stateless
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_action_observer_action_enabled_changed">
+<description>
+This function is called when an action that the observer is
+registered to receive events for becomes enabled or disabled.
+
+This function should only be called by objects with which the
+observer has explicitly registered itself to receive events.
+
+</description>
+<parameters>
+<parameter name="observer">
+<parameter_description> a #GtkActionObserver
+</parameter_description>
+</parameter>
+<parameter name="observable">
+<parameter_description> the source of the event
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> the name of the action
+</parameter_description>
+</parameter>
+<parameter name="enabled">
+<parameter_description> %TRUE if the action is now enabled
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_action_observer_action_removed">
+<description>
+This function is called when an action that the observer is
+registered to receive events for is removed.
+
+This function should only be called by objects with which the
+observer has explicitly registered itself to receive events.
+
+</description>
+<parameters>
+<parameter name="observer">
+<parameter_description> a #GtkActionObserver
+</parameter_description>
+</parameter>
+<parameter name="observable">
+<parameter_description> the source of the event
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> the name of the action
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_action_observer_action_state_changed">
+<description>
+This function is called when an action that the observer is
+registered to receive events for changes to its state.
+
+This function should only be called by objects with which the
+observer has explicitly registered itself to receive events.
+
+</description>
+<parameters>
+<parameter name="observer">
+<parameter_description> a #GtkActionObserver
+</parameter_description>
+</parameter>
+<parameter name="observable">
+<parameter_description> the source of the event
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> the name of the action
+</parameter_description>
+</parameter>
+<parameter name="state">
+<parameter_description> the new state of the action
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_action_set_accel_group">
<description>
Sets the #GtkAccelGroup in which the accelerator for this action
@@ -13475,6 +14423,9 @@ will be installed.
Since: 2.4
+Deprecated: 3.10: Use #GAction and the accelerator group on an associated
+#GtkMenu instead
+
</description>
<parameters>
<parameter name="action">
@@ -13501,6 +14452,9 @@ g_intern_static_string().
Since: 2.4
+Deprecated: 3.10: Use #GAction and the accelerator path on an associated
+#GtkMenu instead
+
</description>
<parameters>
<parameter name="action">
@@ -13517,14 +14471,17 @@ Since: 2.4
<function name="gtk_action_set_always_show_image">
<description>
-Sets whether @action<!-- -->'s menu item proxies will ignore the
-#GtkSettings:gtk-menu-images setting and always show their image, if available.
+Sets whether @action<!-- -->'s menu item proxies will always show
+their image, if available.
Use this if the menu item would be useless or hard to use
without their image.
Since: 2.20
+Deprecated: 3.10: Use g_menu_item_set_icon() on a #GMenuItem instead, if the
+item should have an image
+
</description>
<parameters>
<parameter name="action">
@@ -13545,6 +14502,10 @@ Sets the icon of @action.
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, and g_menu_item_set_icon() to set an
+icon on a #GMenuItem associated with a #GAction, or gtk_container_add() to
+add a #GtkImage to a #GtkButton
+
</description>
<parameters>
<parameter name="action">
@@ -13565,6 +14526,10 @@ Sets the icon name on @action
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, and g_menu_item_set_icon() to set an
+icon on a #GMenuItem associated with a #GAction, or gtk_container_add() to
+add a #GtkImage to a #GtkButton
+
</description>
<parameters>
<parameter name="action">
@@ -13587,6 +14552,9 @@ or not.
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, and control and monitor whether
+labels are shown directly
+
</description>
<parameters>
<parameter name="action">
@@ -13607,6 +14575,10 @@ Sets the label of @action.
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, and set a label on a menu item with
+g_menu_item_set_label(). For #GtkActionable widgets, use the widget-specific
+API to set a label
+
</description>
<parameters>
<parameter name="action">
@@ -13630,6 +14602,9 @@ for that.
Since: 2.6
+Deprecated: 3.10: Use g_simple_action_set_enabled() on a #GSimpleAction
+instead
+
</description>
<parameters>
<parameter name="action">
@@ -13650,6 +14625,9 @@ Sets a shorter label text on @action.
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, which has no equivalent of short
+labels
+
</description>
<parameters>
<parameter name="action">
@@ -13670,6 +14648,9 @@ Sets the stock id on @action
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, which has no equivalent of stock
+items
+
</description>
<parameters>
<parameter name="action">
@@ -13690,6 +14671,9 @@ Sets the tooltip text on @action
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, and set tooltips on associated
+#GActionable widgets with gtk_widget_set_tooltip_text()
+
</description>
<parameters>
<parameter name="action">
@@ -13713,6 +14697,9 @@ for that.
Since: 2.6
+Deprecated: 3.10: Use #GAction instead, and control and monitor the state of
+#GtkActionable widgets directly
+
</description>
<parameters>
<parameter name="action">
@@ -13733,6 +14720,9 @@ Sets whether @action is visible when horizontal
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, and control and monitor the
+visibility of associated widgets and menu items directly
+
</description>
<parameters>
<parameter name="action">
@@ -13753,6 +14743,9 @@ Sets whether @action is visible when vertical
Since: 2.16
+Deprecated: 3.10: Use #GAction instead, and control and monitor the
+visibility of associated widgets and menu items directly
+
</description>
<parameters>
<parameter name="action">
@@ -13773,6 +14766,9 @@ Reenable activation signals from the action
Since: 2.16
+Deprecated: 3.10: Use g_simple_action_set_enabled() to enable the
+#GSimpleAction instead
+
</description>
<parameters>
<parameter name="action">
@@ -13973,6 +14969,8 @@ previous action</para></note>
Since: 2.16
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="activatable">
@@ -13993,6 +14991,8 @@ Gets the related #GtkAction for @activatable.
Since: 2.16
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="activatable">
@@ -14013,6 +15013,8 @@ the action changes appearance.
Since: 2.16
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="activatable">
@@ -14034,6 +15036,8 @@ property and call gtk_activatable_do_set_related_action() when it changes.</p
Since: 2.16
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="activatable">
@@ -14060,6 +15064,8 @@ if needed.</para></note>
Since: 2.16
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="activatable">
@@ -14083,6 +15089,8 @@ or unset and by the implementing class when
Since: 2.16
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="activatable">
@@ -16960,6 +17968,24 @@ Since: 2.14
</return>
</function>
+<function name="gtk_box_get_baseline_position">
+<description>
+Gets the value set by gtk_box_set_baseline_position().
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> the baseline position
+
+</return>
+</function>
+
<function name="gtk_box_get_homogeneous">
<description>
Returns whether the box is homogeneous (all children are the
@@ -17170,6 +18196,31 @@ the list
<return></return>
</function>
+<function name="gtk_box_set_baseline_position">
+<description>
+Sets the baseline position of a box. This affects
+only horizontal boxes with at least one baseline aligned
+child. If there is more vertical space availible than requested,
+and the baseline is not allocated by the parent then
+ position is used to allocate the baseline wrt the
+extra space available.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkBox
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> a #GtkBaselinePosition
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_box_set_child_packing">
<description>
Sets the way @child is packed into @box.
@@ -17528,15 +18579,82 @@ Since: 2.12
<return></return>
</function>
+<function name="gtk_builder_add_callback_symbol">
+<description>
+Adds the @callback_symbol to the scope of @builder under the given @callback_name.
+
+Using this function overrides the behavior of gtk_builder_connect_signals()
+for any callback symbols that are added. Using this method allows for better
+encapsulation as it does not require that callback symbols be declared in
+the global namespace.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="builder">
+<parameter_description> a #GtkBuilder
+</parameter_description>
+</parameter>
+<parameter name="callback_name">
+<parameter_description> The name of the callback, as expected in the XML
+</parameter_description>
+</parameter>
+<parameter name="callback_symbol">
+<parameter_description> The callback pointer
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_builder_add_callback_symbols">
+<description>
+A convenience function to add many callbacks instead of calling
+gtk_builder_add_callback_symbol() for each symbol.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="builder">
+<parameter_description> a #GtkBuilder
+</parameter_description>
+</parameter>
+<parameter name="first_callback_name">
+<parameter_description> The name of the callback, as expected in the XML
+</parameter_description>
+</parameter>
+<parameter name="first_callback_symbol">
+<parameter_description> The callback pointer
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> A list of callback name and callback symbol pairs terminated with %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_builder_add_from_file">
<description>
Parses a file containing a <link linkend="BUILDER-UI">GtkBuilder
-UI definition</link> and merges it with the current contents of @builder.
+UI definition</link> and merges it with the current contents of @builder.
+
+Most users will probably want to use gtk_builder_new_from_file().
Upon errors 0 will be returned and @error will be assigned a
#GError from the #GTK_BUILDER_ERROR, #G_MARKUP_ERROR or #G_FILE_ERROR
domain.
+It's not really reasonable to attempt to handle failures of this
+call. You should not use this function with untrusted files (ie:
+files that are not part of your application). Broken #GtkBuilder
+files can easily crash your program, and it's possible that memory
+was leaked leading up to the reported failure. The only reasonable
+thing to do when an error is detected is to call g_error().
+
Since: 2.12
</description>
@@ -17564,10 +18682,16 @@ Since: 2.12
Parses a resource file containing a <link linkend="BUILDER-UI">GtkBuilder
UI definition</link> and merges it with the current contents of @builder.
+Most users will probably want to use gtk_builder_new_from_resource().
+
Upon errors 0 will be returned and @error will be assigned a
#GError from the #GTK_BUILDER_ERROR, #G_MARKUP_ERROR or #G_RESOURCE_ERROR
domain.
+It's not really reasonable to attempt to handle failures of this
+call. The only reasonable thing to do when an error is detected is
+to call g_error().
+
Since: 3.4
</description>
@@ -17595,9 +18719,15 @@ Since: 3.4
Parses a string containing a <link linkend="BUILDER-UI">GtkBuilder
UI definition</link> and merges it with the current contents of @builder.
+Most users will probably want to use gtk_builder_new_from_string().
+
Upon errors 0 will be returned and @error will be assigned a
#GError from the #GTK_BUILDER_ERROR or #G_MARKUP_ERROR domain.
+It's not really reasonable to attempt to handle failures of this
+call. The only reasonable thing to do when an error is detected is
+to call g_error().
+
Since: 2.12
</description>
@@ -17756,14 +18886,20 @@ Since: 2.14
<function name="gtk_builder_connect_signals">
<description>
This method is a simpler variation of gtk_builder_connect_signals_full().
-It uses #GModule's introspective features (by opening the module %NULL)
+It uses symbols explicitly added to @builder with prior calls to
+gtk_builder_add_callback_symbol(). In the case that symbols are not
+explicitly added; it uses #GModule's introspective features (by opening the module %NULL)
to look at the application's symbol table. From here it tries to match
the signal handler names given in the interface description with
symbols in the application and connects the signals. Note that this
function can only be called once, subsequent calls will do nothing.
-Note that this function will not work correctly if #GModule is not
-supported on the platform.
+Note that unless gtk_builder_add_callback_symbol() is called for
+all signal callbacks which are referenced by the loaded XML, this
+function will require that #GModule be supported on the platform.
+
+If you rely on #GModule support to lookup callbacks in the symbol table,
+the following details should be noted:
When compiling applications for Windows, you must declare signal callbacks
with #G_MODULE_EXPORT, or they will not be put in the symbol table.
@@ -17928,16 +19064,126 @@ if no type was found
</return>
</function>
+<function name="gtk_builder_lookup_callback_symbol">
+<description>
+Fetches a symbol previously added to @builder
+with gtk_builder_add_callback_symbols()
+
+This function is intended for possible use in language bindings
+or for any case that one might be cusomizing signal connections
+using gtk_builder_connect_signals_full()
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="builder">
+<parameter_description> a #GtkBuilder
+</parameter_description>
+</parameter>
+<parameter name="callback_name">
+<parameter_description> The name of the callback
+</parameter_description>
+</parameter>
+</parameters>
+<return> The callback symbol in @builder for @callback_name, or %NULL
+
+</return>
+</function>
+
<function name="gtk_builder_new">
<description>
-Creates a new builder object.
+Creates a new empty builder object.
+
+This function is only useful if you intend to make multiple calls to
+gtk_builder_add_from_file(), gtk_builder_add_from_resource() or
+gtk_builder_add_from_string() in order to merge multiple UI
+descriptions into a single builder.
+
+Most users will probably want to use gtk_builder_new_from_file(),
+gtk_builder_new_from_resource() or gtk_builder_new_from_string().
Since: 2.12
</description>
<parameters>
</parameters>
-<return> a new #GtkBuilder object
+<return> a new (empty) #GtkBuilder object
+
+</return>
+</function>
+
+<function name="gtk_builder_new_from_file">
+<description>
+Builds the <link linkend="BUILDER-UI">GtkBuilder UI definition</link>
+in the file @filename.
+
+If there is an error opening the file or parsing the description then
+the program will be aborted. You should only ever attempt to parse
+user interface descriptions that are shipped as part of your program.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> filename of user interface description file
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #Gtkbuilder containing the described interface
+
+</return>
+</function>
+
+<function name="gtk_builder_new_from_resource">
+<description>
+Builds the <link linkend="BUILDER-UI">GtkBuilder UI definition</link>
+at @resource_path.
+
+If there is an error locating the resurce or parsing the description
+then the program will be aborted.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="resource_path">
+<parameter_description> a #GResource resource path
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #Gtkbuilder containing the described interface
+
+</return>
+</function>
+
+<function name="gtk_builder_new_from_string">
+<description>
+Builds the user interface described by @string (in the <link
+linkend="BUILDER-UI">GtkBuilder UI definition</link> format).
+
+If @string is %NULL-terminated then @length should be -1. If @length
+is not -1 then it is the length of @string.
+
+If there is an error parsing @string then the program will be
+aborted. You should not attempt to parse user interface description
+from untrusted sources.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="string">
+<parameter_description> a user interface (XML) description
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> the length of @string, or -1
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #Gtkbuilder containing the interface described by @string
</return>
</function>
@@ -18258,8 +19504,8 @@ Since: 2.4
<function name="gtk_button_get_always_show_image">
<description>
-Returns whether the button will ignore the #GtkSettings:gtk-button-images
-setting and always show the image, if available.
+Returns whether the button will always show the image in addition
+to the label, if available.
Since: 3.6
@@ -18394,6 +19640,7 @@ Returns the current relief style of the given #GtkButton.
<description>
Returns whether the button label is a stock item.
+Deprecated: 3.10
</description>
<parameters>
@@ -18405,6 +19652,7 @@ Returns whether the button label is a stock item.
<return> %TRUE if the button label is used to
select a stock item instead of being
used directly as the label text.
+
</return>
</function>
@@ -18455,6 +19703,35 @@ use gtk_container_add().
</return>
</function>
+<function name="gtk_button_new_from_icon_name">
+<description>
+Creates a new button containing an icon from the current icon theme.
+
+If the icon name isn't known, a "broken image" icon will be
+displayed instead. If the current icon theme is changed, the icon
+will be updated appropriately.
+
+This function is a convenience wrapper around gtk_button_new() and
+gtk_button_set_image().
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="icon_name">
+<parameter_description> an icon name
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> an icon size
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GtkButton displaying the themed icon
+
+</return>
+</function>
+
<function name="gtk_button_new_from_stock">
<description>
Creates a new #GtkButton containing the image and text from a stock item.
@@ -18464,6 +19741,7 @@ Some stock ids have preprocessor macros like #GTK_STOCK_OK and
If @stock_id is unknown, then it will be treated as a mnemonic
label (as for gtk_button_new_with_mnemonic()).
+Deprecated: 3.10: Use gtk_button_new_with_label() instead.
</description>
<parameters>
@@ -18473,6 +19751,7 @@ label (as for gtk_button_new_with_mnemonic()).
</parameter>
</parameters>
<return> a new #GtkButton
+
</return>
</function>
@@ -18576,8 +19855,8 @@ Since: 2.4
<function name="gtk_button_set_always_show_image">
<description>
-If %TRUE, the button will ignore the #GtkSettings:gtk-button-images
-setting and always show the image, if available.
+If %TRUE, the button will always show the image in addition to the
+label, if available.
Use this property if the button would be useless or hard to use
without the image.
@@ -18623,9 +19902,9 @@ Since: 2.4
<function name="gtk_button_set_image">
<description>
-Set the image of @button to the given widget. Note that
-it depends on the #GtkSettings:gtk-button-images setting whether the
-image will be displayed or not, you don't have to call
+Set the image of @button to the given widget. The image will be
+displayed if the label text is %NULL or if
+#GtkButton:always-show-image is %TRUE. You don't have to call
gtk_widget_show() on @image yourself.
Since: 2.6
@@ -18714,6 +19993,8 @@ The default style is, as one can guess, GTK_RELIEF_NORMAL.
If %TRUE, the label set on the button is used as a
stock id to select the stock item for the button.
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="button">
@@ -24639,6 +25920,7 @@ Since: 2.4
<description>
Gets the current value of the :add-tearoffs property.
+Deprecated: 3.10
</description>
<parameters>
@@ -24648,6 +25930,7 @@ Gets the current value of the :add-tearoffs property.
</parameter>
</parameters>
<return> the current value of the :add-tearoffs property.
+
</return>
</function>
@@ -24871,6 +26154,8 @@ gtk_combo_box_set_add_tearoffs().
Since: 2.10
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="combo_box">
@@ -24956,11 +26241,13 @@ The new combo box will use @area to layout cells.
<description>
Creates a new empty #GtkComboBox with an entry.
+Since: 2.24
</description>
<parameters>
</parameters>
<return> A new #GtkComboBox.
+
</return>
</function>
@@ -24987,6 +26274,7 @@ Since: 2.4
Creates a new empty #GtkComboBox with an entry
and with the model initialized to @model.
+Since: 2.24
</description>
<parameters>
@@ -24996,6 +26284,7 @@ and with the model initialized to @model.
</parameter>
</parameters>
<return> A new #GtkComboBox
+
</return>
</function>
@@ -25137,6 +26426,8 @@ menu item.
Since: 2.6
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="combo_box">
@@ -25371,6 +26662,8 @@ Sets the menu's title in tearoff mode.
Since: 2.10
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="combo_box">
@@ -26324,6 +27617,20 @@ container and help break any circular reference count cycles.
<return></return>
</function>
+<function name="gtk_container_resize_children">
+<description>
+Deprecated: 3.10
+
+</description>
+<parameters>
+<parameter name="container">
+<parameter_description> a #GtkContainer
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_container_set_border_width">
<description>
Sets the border width of the container.
@@ -26964,11 +28271,11 @@ of the #GtkDialog struct.
<function name="gtk_dialog_add_button">
<description>
-Adds a button with the given text (or a stock button, if @button_text is a
-stock ID) and sets things up so that clicking the button will emit the
-#GtkDialog::response signal with the given @response_id. The button is
-appended to the end of the dialog's action area. The button widget is
-returned, but usually you don't need it.
+Adds a button with the given text and sets things up so that
+clicking the button will emit the #GtkDialog::response signal with
+the given @response_id. The button is appended to the end of the
+dialog's action area. The button widget is returned, but usually
+you don't need it.
</description>
@@ -26978,7 +28285,7 @@ returned, but usually you don't need it.
</parameter_description>
</parameter>
<parameter name="button_text">
-<parameter_description> text of button, or stock ID
+<parameter_description> text of button
</parameter_description>
</parameter>
<parameter name="response_id">
@@ -27004,7 +28311,7 @@ text and response ID.
</parameter_description>
</parameter>
<parameter name="first_button_text">
-<parameter_description> button text or stock ID
+<parameter_description> button text
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -27123,8 +28430,7 @@ argument can be used to make the dialog modal (#GTK_DIALOG_MODAL)
and/or to have it destroyed along with its transient parent
(#GTK_DIALOG_DESTROY_WITH_PARENT). After @flags, button
text/response ID pairs should be listed, with a %NULL pointer ending
-the list. Button text can be either a stock ID such as
-#GTK_STOCK_OK, or some arbitrary text. A response ID can be
+the list. Button text can be arbitrary text. A response ID can be
any positive number, or one of the values in the #GtkResponseType
enumeration. If the user clicks one of these dialog buttons,
#GtkDialog will emit the #GtkDialog::response signal with the corresponding
@@ -27140,9 +28446,9 @@ Here's a simple example:
GtkWidget *dialog = gtk_dialog_new_with_buttons ("My dialog",
main_app_window,
GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT,
-GTK_STOCK_OK,
+_("_OK"),
GTK_RESPONSE_ACCEPT,
-GTK_STOCK_CANCEL,
+_("_Cancel"),
GTK_RESPONSE_REJECT,
NULL);
]|
@@ -27163,7 +28469,7 @@ NULL);
</parameter_description>
</parameter>
<parameter name="first_button_text">
-<parameter_description> stock ID or text to go in first button, or %NULL
+<parameter_description> text to go in first button, or %NULL
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -27271,17 +28577,17 @@ Use this function after adding all the buttons to your dialog, as the
following example shows:
|[
cancel_button = gtk_dialog_add_button (GTK_DIALOG (dialog),
-GTK_STOCK_CANCEL,
+_("_Cancel"),
GTK_RESPONSE_CANCEL);
ok_button = gtk_dialog_add_button (GTK_DIALOG (dialog),
-GTK_STOCK_OK,
+_("_OK"),
GTK_RESPONSE_OK);
gtk_widget_grab_default (ok_button);
help_button = gtk_dialog_add_button (GTK_DIALOG (dialog),
-GTK_STOCK_HELP,
+_("_Help"),
GTK_RESPONSE_HELP);
gtk_dialog_set_alternative_button_order (GTK_DIALOG (dialog),
@@ -27438,16 +28744,44 @@ to @sizes.
<function name="gtk_drag_begin">
<description>
-Initiates a drag on the source side. The function
-only needs to be used when the application is
-starting drags itself, and is not needed when
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> the source widget.
+</parameter_description>
+</parameter>
+<parameter name="targets">
+<parameter_description> The targets (data formats) in which the
+source can provide the data.
+</parameter_description>
+</parameter>
+<parameter name="actions">
+<parameter_description> A bitmask of the allowed drag actions for this drag.
+</parameter_description>
+</parameter>
+<parameter name="button">
+<parameter_description> The button the user clicked to start the drag.
+</parameter_description>
+</parameter>
+<parameter name="event">
+<parameter_description> The event that triggered the start of the drag.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_drag_begin_with_coordinates">
+<description>
+Initiates a drag on the source side. The function only needs to be used
+when the application is starting drags itself, and is not needed when
gtk_drag_source_set() is used.
The @event is used to retrieve the timestamp that will be used internally to
-grab the pointer. If @event is #NULL, then GDK_CURRENT_TIME will be used.
+grab the pointer. If @event is %NULL, then %GDK_CURRENT_TIME will be used.
However, you should try to pass a real event in all cases, since that can be
-used by GTK+ to get information about the start position of the drag, for
-example if the @event is a %GDK_MOTION_NOTIFY.
+used to get information about the drag.
Generally there are three cases when you want to start a drag by hand by
calling this function:
@@ -27490,6 +28824,18 @@ source can provide the data.
<parameter_description> The event that triggered the start of the drag.
</parameter_description>
</parameter>
+<parameter name="x">
+<parameter_description> The initial x coordinate to start dragging from, in the coordinate space
+of @widget. If -1 is passed, the coordinates are retrieved from @event or
+the current pointer position.
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> The initial y coordinate to start dragging from, in the coordinate space
+of @widget. If -1 is passed, the coordinates are retrieved from @event or
+the current pointer position.
+</parameter_description>
+</parameter>
</parameters>
<return> the context for this drag.
</return>
@@ -27497,10 +28843,6 @@ source can provide the data.
<function name="gtk_drag_check_threshold">
<description>
-Checks to see if a mouse drag starting at (@start_x, @start_y) and ending
-at (@current_x, @current_y) has passed the GTK+ drag threshold, and thus
-should trigger the beginning of a drag-and-drop operation.
-
</description>
<parameters>
@@ -27525,19 +28867,11 @@ should trigger the beginning of a drag-and-drop operation.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the drag threshold has been passed.
-</return>
+<return></return>
</function>
<function name="gtk_drag_dest_add_image_targets">
<description>
-Add the image targets supported by #GtkSelection 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>
@@ -27551,13 +28885,6 @@ Since: 2.6
<function name="gtk_drag_dest_add_text_targets">
<description>
-Add the text targets supported by #GtkSelection 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>
@@ -27571,13 +28898,6 @@ Since: 2.6
<function name="gtk_drag_dest_add_uri_targets">
<description>
-Add the URI targets supported by #GtkSelection 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>
@@ -27591,14 +28911,6 @@ Since: 2.6
<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>
@@ -27616,16 +28928,11 @@ gtk_drag_dest_get_target_list (@widget).
</parameter_description>
</parameter>
</parameters>
-<return> first target that the source offers
-and the dest can accept, or %GDK_NONE
-</return>
+<return></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>
@@ -27634,16 +28941,11 @@ drag-and-drop.
</parameter_description>
</parameter>
</parameters>
-<return> the #GtkTargetList, or %NULL if none
-</return>
+<return></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>
@@ -27652,53 +28954,11 @@ Since: 2.10
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the widget always emits
-#GtkWidget::drag-motion events
-
-</return>
+<return></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:
-|[
-static void
-drag_motion (GtkWidget *widget,
-GdkDragContext *context,
-gint x,
-gint y,
-guint time)
-{
-GdkModifierType mask;
-
-gdk_window_get_pointer (gtk_widget_get_window (widget),
-NULL, NULL, &mask);
-if (mask & GDK_CONTROL_MASK)
-gdk_drag_status (context, GDK_ACTION_COPY, time);
-else
-gdk_drag_status (context, GDK_ACTION_MOVE, time);
-}
-]|
</description>
<parameters>
@@ -27731,7 +28991,6 @@ and gtk_drag_dest_find_target().
<function name="gtk_drag_dest_set_proxy">
<description>
-Sets this widget as a proxy for drops to another window.
</description>
<parameters>
@@ -27760,9 +29019,6 @@ subwindow.
<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>
@@ -27780,14 +29036,6 @@ gtk_drag_dest_set().
<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>
@@ -27805,9 +29053,6 @@ Since: 2.10
<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>
@@ -27821,8 +29066,6 @@ notification of drags.
<function name="gtk_drag_finish">
<description>
-Informs the drag source that the drop is finished, and
-that the data of the drag will no longer be required.
</description>
<parameters>
@@ -27849,14 +29092,6 @@ original data. (This should be %TRUE for a move)
<function name="gtk_drag_get_data">
<description>
-Gets the data associated with a drag. When the data
-is received or the retrieval fails, GTK+ will emit a
-#GtkWidget::drag-data-received signal. Failure of the retrieval
-is indicated by the length field of the @selection_data
-signal parameter being negative. However, when gtk_drag_get_data()
-is called implicitely because the %GTK_DEST_DEFAULT_DROP was set,
-then the widget will not receive notification of failed
-drops.
</description>
<parameters>
@@ -27885,8 +29120,6 @@ or #GtkWidget::drag-drop" signal.
<function name="gtk_drag_get_source_widget">
<description>
-Determines the source widget for a drag.
-
</description>
<parameters>
@@ -27895,18 +29128,11 @@ Determines the source widget for a drag.
</parameter_description>
</parameter>
</parameters>
-<return> if the drag is occurring
-within a single application, a pointer to the source widget.
-Otherwise, %NULL.
-</return>
+<return></return>
</function>
<function name="gtk_drag_highlight">
<description>
-Draws a highlight around a widget. This will attach
-handlers to #GtkWidget::draw, so the highlight
-will continue to be displayed until gtk_drag_unhighlight()
-is called.
</description>
<parameters>
@@ -28110,13 +29336,6 @@ signal and destroy it yourself.
<function name="gtk_drag_source_add_image_targets">
<description>
-Add the writable image targets supported by #GtkSelection to
-the target list of the drag source. The targets
-are added with @info = 0. If you need another value,
-use gtk_target_list_add_image_targets() and
-gtk_drag_source_set_target_list().
-
-Since: 2.6
</description>
<parameters>
@@ -28150,13 +29369,6 @@ Since: 2.6
<function name="gtk_drag_source_add_uri_targets">
<description>
-Add the URI targets supported by #GtkSelection to
-the target list of the drag source. The targets
-are added with @info = 0. If you need another value,
-use gtk_target_list_add_uri_targets() and
-gtk_drag_source_set_target_list().
-
-Since: 2.6
</description>
<parameters>
@@ -28170,10 +29382,6 @@ Since: 2.6
<function name="gtk_drag_source_get_target_list">
<description>
-Gets the list of targets this widget can provide for
-drag-and-drop.
-
-Since: 2.4
</description>
<parameters>
@@ -28182,15 +29390,11 @@ Since: 2.4
</parameter_description>
</parameter>
</parameters>
-<return> the #GtkTargetList, or %NULL if none
-
-</return>
+<return></return>
</function>
<function name="gtk_drag_source_set">
<description>
-Sets up a widget so that GTK+ will start a drag operation when the user
-clicks and drags on the widget. The widget must have a window.
</description>
<parameters>
@@ -28263,9 +29467,6 @@ Since: 2.8
<function name="gtk_drag_source_set_icon_pixbuf">
<description>
-Sets the icon that will be used for drags from a particular widget
-from a #GdkPixbuf. GTK+ retains a reference for @pixbuf and will
-release it when it is no longer needed.
</description>
<parameters>
@@ -28302,11 +29503,6 @@ to a stock icon.
<function name="gtk_drag_source_set_target_list">
<description>
-Changes the target types that this widget offers for drag-and-drop.
-The widget must first be made into a drag source with
-gtk_drag_source_set().
-
-Since: 2.4
</description>
<parameters>
@@ -28324,7 +29520,6 @@ Since: 2.4
<function name="gtk_drag_source_unset">
<description>
-Undoes the effects of gtk_drag_source_set().
</description>
<parameters>
@@ -28338,8 +29533,6 @@ Undoes the effects of gtk_drag_source_set().
<function name="gtk_drag_unhighlight">
<description>
-Removes a highlight set by gtk_drag_highlight() from
-a widget.
</description>
<parameters>
@@ -29909,6 +31102,8 @@ pixbuf, icon name or gicon).
Since: 2.16
+Deprecated: 3.10: Use gtk_entry_get_icon_name() instead.
+
</description>
<parameters>
<parameter name="entry">
@@ -30234,6 +31429,25 @@ Since: 2.16
</return>
</function>
+<function name="gtk_entry_get_tabs">
+<description>
+Gets the tabstops that were set on the entry using gtk_entry_set_tabs(), if
+any.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="entry">
+<parameter_description> a #GtkEntry
+</parameter_description>
+</parameter>
+</parameters>
+<return> the tabstops, or %NULL if none was set.
+
+</return>
+</function>
+
<function name="gtk_entry_get_text">
<description>
Retrieves the contents of the entry widget.
@@ -30784,6 +31998,8 @@ If @stock_id is %NULL, no icon will be shown in the specified position.
Since: 2.16
+Deprecated: 3.10: Use gtk_entry_set_icon_from_icon_name() instead.
+
</description>
<parameters>
<parameter name="entry">
@@ -31105,6 +32321,27 @@ Since: 2.16
<return></return>
</function>
+<function name="gtk_entry_set_tabs">
+<description>
+Sets a #PangoTabArray; the tabstops in the array are applied to the entry
+text.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="entry">
+<parameter_description> a #GtkEntry
+</parameter_description>
+</parameter>
+<parameter name="tabs">
+<parameter_description> a #PangoTabArray
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_entry_set_text">
<description>
Sets the text in the widget to the given
@@ -32224,6 +33461,34 @@ gtk_file_chooser_set_current_folder_uri() on a nonexistent folder.
</return>
</function>
+<function name="gtk_file_chooser_get_current_name">
+<description>
+Gets the current name in the file selector, as entered by the user in the
+text entry for "Name".
+
+This is meant to be used in save dialogs, to get the currently typed filename
+when the file itself does not exist yet. For example, an application that
+adds a custom extra widget to the file chooser for "file format" may want to
+change the extension of the typed filename based on the chosen format, say,
+from ".jpg" to ".png".
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="chooser">
+<parameter_description> a #GtkFileChooser
+</parameter_description>
+</parameter>
+</parameters>
+<return> The raw text from the file chooser's "Name" entry. Free this with
+g_free(). Note that this string is not a full pathname or URI; it is
+whatever the contents of the entry are. Note also that this string is in
+UTF-8 encoding, which is not necessarily the system's encoding for filenames.
+
+</return>
+</function>
+
<function name="gtk_file_chooser_get_do_overwrite_confirmation">
<description>
Queries whether a file chooser is set to confirm for overwriting when the user
@@ -33001,7 +34266,7 @@ Sets whether a file chooser in %GTK_FILE_CHOOSER_ACTION_SAVE mode will present
a confirmation dialog if the user types a file name that already exists. This
is %FALSE by default.
-Regardless of this setting, the @chooser will emit the
+If set to %TRUE, the @chooser will emit the
#GtkFileChooser::confirm-overwrite signal when appropriate.
If all you need is the stock confirmation dialog, set this property to %TRUE.
@@ -33226,8 +34491,7 @@ Otherwise, set the preview inactive.
When there is no application-supplied preview widget, or the
application-supplied preview widget is not active, the file chooser
-may display an internally generated preview of the current file or
-it may display no preview at all.
+will display no preview at all.
Since: 2.4
@@ -35534,6 +36798,24 @@ next to, or %NULL to place @child at the beginning or end
<return></return>
</function>
+<function name="gtk_grid_get_baseline_row">
+<description>
+Returns which row defines the global baseline of @grid.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="grid">
+<parameter_description> a #GtkGrid
+</parameter_description>
+</parameter>
+</parameters>
+<return> the row index defining the global baseline
+
+</return>
+</function>
+
<function name="gtk_grid_get_child_at">
<description>
Gets the child of @grid whose area covers the grid
@@ -35593,6 +36875,30 @@ Returns the amount of space between the columns of @grid.
</return>
</function>
+<function name="gtk_grid_get_row_baseline_position">
+<description>
+Returns the baseline position of @row as set
+by gtk_grid_set_row_baseline_position() or the default value
+%GTK_BASELINE_POSITION_CENTER.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="grid">
+<parameter_description> a #GtkGrid
+</parameter_description>
+</parameter>
+<parameter name="row">
+<parameter_description> a row index
+</parameter_description>
+</parameter>
+</parameters>
+<return> the baseline position of @row
+
+</return>
+</function>
+
<function name="gtk_grid_get_row_homogeneous">
<description>
Returns whether all rows of @grid have the same height.
@@ -35715,6 +37021,81 @@ Creates a new grid widget.
</return>
</function>
+<function name="gtk_grid_remove_column">
+<description>
+Removes a column from the grid.
+
+Children that are placed in this column are removed,
+spanning children that overlap this column have their
+width reduced by one, and children after the column
+are moved to the left.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="grid">
+<parameter_description> a #GtkGrid
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> the position of the column to remove
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_grid_remove_row">
+<description>
+Removes a row from the grid.
+
+Children that are placed in this row are removed,
+spanning children that overlap this row have their
+height reduced by one, and children below the row
+are moved up.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="grid">
+<parameter_description> a #GtkGrid
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> the position of the row to remove
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_grid_set_baseline_row">
+<description>
+Sets which row defines the global baseline for the entire grid.
+Each row in the grid can have its own local baseline, but only
+one of those is global, meaning it will be the baseline in the
+parent of the @grid.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="grid">
+<parameter_description> a #GtkGrid
+</parameter_description>
+</parameter>
+<parameter name="row">
+<parameter_description> the row index
+</parameter_description>
+</parameter>
+</parameters>
+<return> the row index defining the global baseline
+
+</return>
+</function>
+
<function name="gtk_grid_set_column_homogeneous">
<description>
Sets whether all columns of @grid will have the same width.
@@ -35751,6 +37132,31 @@ Sets the amount of space between columns of @grid.
<return></return>
</function>
+<function name="gtk_grid_set_row_baseline_position">
+<description>
+Sets how the baseline should be positioned on @row of the
+grid, in case that row is assigned more space than is requested.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="grid">
+<parameter_description> a #GtkGrid
+</parameter_description>
+</parameter>
+<parameter name="row">
+<parameter_description> a row index
+</parameter_description>
+</parameter>
+<parameter name="pos">
+<parameter_description> a #GtkBaselinePosition
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_grid_set_row_homogeneous">
<description>
Sets whether all rows of @grid will have the same height.
@@ -35994,6 +37400,233 @@ Deprecated: 3.2: Use gtk_button_box_new() with %GTK_ORIENTATION_HORIZONTAL inste
</return>
</function>
+<function name="gtk_header_bar_get_custom_title">
+<description>
+Retrieves the custom title widget of the header. See
+gtk_header_bar_set_custom_title().
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkHeaderBar
+</parameter_description>
+</parameter>
+</parameters>
+<return> the custom title widget
+of the header, or %NULL if none has been set explicitely.
+
+</return>
+</function>
+
+<function name="gtk_header_bar_get_show_close_button">
+<description>
+Returns whether this header bar shows a window close
+button.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkHeaderBar
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if a window close button is shown
+
+</return>
+</function>
+
+<function name="gtk_header_bar_get_subtitle">
+<description>
+Retrieves the subtitle of the header. See gtk_header_bar_set_subtitle().
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkHeaderBar
+</parameter_description>
+</parameter>
+</parameters>
+<return> the subtitle of the header, or %NULL if none has
+been set explicitely. The returned string is owned by the widget
+and must not be modified or freed.
+
+</return>
+</function>
+
+<function name="gtk_header_bar_get_title">
+<description>
+Retrieves the title of the header. See gtk_header_bar_set_title().
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkHeaderBar
+</parameter_description>
+</parameter>
+</parameters>
+<return> the title of the header, or %NULL if none has
+been set explicitely. The returned string is owned by the widget
+and must not be modified or freed.
+
+</return>
+</function>
+
+<function name="gtk_header_bar_new">
+<description>
+Creates a new #GtkHeaderBar widget.
+
+Since: 3.10
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GtkHeaderBar
+
+</return>
+</function>
+
+<function name="gtk_header_bar_pack_end">
+<description>
+Adds @child to @box, packed with reference to the
+end of the @box.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> A #GtkHeaderBar
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> the #GtkWidget to be added to @bar
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_header_bar_pack_start">
+<description>
+Adds @child to @box, packed with reference to the
+start of the @box.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> A #GtkHeaderBar
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> the #GtkWidget to be added to @bar
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_header_bar_set_custom_title">
+<description>
+Sets a custom title for the #GtkHeaderBar. The title should help a
+user identify the current view. This supercedes any title set by
+gtk_header_bar_set_title() or gtk_header_bar_set_subtitle().
+You should set the custom title to %NULL, for the header title label
+to be visible again.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkHeaderBar
+</parameter_description>
+</parameter>
+<parameter name="title_widget">
+<parameter_description> a custom widget to use for a title
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_header_bar_set_show_close_button">
+<description>
+Sets whether this header bar shows a window close
+button.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkHeaderBar
+</parameter_description>
+</parameter>
+<parameter name="setting">
+<parameter_description> %TRUE to show a window close button
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_header_bar_set_subtitle">
+<description>
+Sets the subtitle of the #GtkHeaderBar. The title should give a user
+an additional detail to help him identify the current view.
+
+Note that GtkHeaderBar always reserves room for the subtitle, even
+if none is currently set. If this is not desired, use
+gtk_header_bar_set_custom_title().
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkHeaderBar
+</parameter_description>
+</parameter>
+<parameter name="subtitle">
+<parameter_description> a subtitle
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_header_bar_set_title">
+<description>
+Sets the title of the #GtkHeaderBar. The title should help a user
+identify the current view. A good title should not include the
+application name.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkHeaderBar
+</parameter_description>
+</parameter>
+<parameter name="title">
+<parameter_description> a title
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_hpaned_new">
<description>
Create a new #GtkHPaned
@@ -36286,6 +37919,8 @@ override your application's default icons. If an icon already
existed in @factory for @stock_id, it is unreferenced and replaced
with the new @icon_set.
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="factory">
@@ -36313,6 +37948,8 @@ There will normally be an icon factory added for each library or
application that comes with icons. The default icon factories
can be overridden by themes.
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="factory">
@@ -36331,6 +37968,7 @@ use gtk_style_lookup_icon_set() on the #GtkStyle for the
widget that will display the icon, instead of using this
function directly, so that themes are taken into account.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -36344,6 +37982,7 @@ function directly, so that themes are taken into account.
</parameter>
</parameters>
<return> icon set of @stock_id.
+
</return>
</function>
@@ -36355,6 +37994,7 @@ the #GtkStyle for the widget that will display the icon, instead of
using this function directly, so that themes are taken into
account.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -36364,6 +38004,7 @@ account.
</parameter>
</parameters>
<return> a #GtkIconSet, or %NULL
+
</return>
</function>
@@ -36383,11 +38024,13 @@ gtk_icon_factory_remove_default(). Applications with icons should
add a default icon factory with their icons, which will allow
themes to override the icons for the application.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
</parameters>
<return> a new #GtkIconFactory
+
</return>
</function>
@@ -36397,6 +38040,8 @@ Removes an icon factory from the list of default icon
factories. Not normally used; you might use it for a library that
can be unloaded or shut down.
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="factory">
@@ -36474,6 +38119,27 @@ free the array of points with g_free().
</return>
</function>
+<function name="gtk_icon_info_get_base_scale">
+<description>
+Gets the base scale for the icon. The base scale is a scale for the
+icon that was specified by the icon theme creator. For instance an
+icon drawn for a high-dpi screen with window-scale 2 for a base
+size of 32 will be 64 pixels tall and have a base_scale of 2.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="icon_info">
+<parameter_description> a #GtkIconInfo
+</parameter_description>
+</parameter>
+</parameters>
+<return> the base scale.
+
+</return>
+</function>
+
<function name="gtk_icon_info_get_base_size">
<description>
Gets the base size for the icon. The base size
@@ -36485,6 +38151,9 @@ to a larger icon. These icons will be given
the same base size as the larger icons to which
they are attached.
+Note that for scaled icons the base size does
+not include the base scale.
+
Since: 2.4
</description>
@@ -36698,6 +38367,46 @@ to the icon.
</return>
</function>
+<function name="gtk_icon_info_load_surface">
+<description>
+Renders an icon previously looked up in an icon theme using
+gtk_icon_theme_lookup_icon(); the size will be based on the size
+passed to gtk_icon_theme_lookup_icon(). Note that the resulting
+surface may not be exactly this size; an icon theme may have icons
+that differ slightly from their nominal sizes, and in addition GTK+
+will avoid scaling icons that it considers sufficiently close to the
+requested size or for which the source image would have to be scaled
+up too far. (This maintains sharpness.). This behaviour can be changed
+by passing the %GTK_ICON_LOOKUP_FORCE_SIZE flag when obtaining
+the #GtkIconInfo. If this flag has been specified, the pixbuf
+returned by this function will be scaled to the exact size.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="icon_info">
+<parameter_description> a #GtkIconInfo structure from gtk_icon_theme_lookup_icon()
+</parameter_description>
+</parameter>
+<parameter name="for_window">
+<parameter_description> #GdkWindow to optimize drawing for, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store error information on failure,
+or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the rendered icon; this may be a newly
+created icon or a new reference to an internal icon, so you must
+not modify the icon. Use cairo_surface_destroy() to release your reference
+to the icon.
+
+</return>
+</function>
+
<function name="gtk_icon_info_load_symbolic">
<description>
Loads an icon, modifying it to match the system colours for the foreground,
@@ -37096,6 +38805,8 @@ add the sources to the icon set does not matter.
gtk_icon_set_new_from_pixbuf() creates a new icon set with a
default icon source based on the given pixbuf.
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="icon_set">
@@ -37114,6 +38825,7 @@ default icon source based on the given pixbuf.
<description>
Copies @icon_set by value.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -37123,6 +38835,7 @@ Copies @icon_set by value.
</parameter>
</parameters>
<return> a new #GtkIconSet identical to the first.
+
</return>
</function>
@@ -37131,6 +38844,8 @@ Copies @icon_set by value.
Obtains a list of icon sizes this icon set can render. The returned
array must be freed with g_free().
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="icon_set">
@@ -37162,11 +38877,13 @@ using #GtkIconSet directly. The one case where you'd use
#GtkIconSet is to create application-specific icon sets to place in
a #GtkIconFactory.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
</parameters>
<return> a new #GtkIconSet
+
</return>
</function>
@@ -37178,6 +38895,7 @@ icon set, all variants of the icon will be created from @pixbuf,
using scaling, pixelation, etc. as required to adjust the icon size
or make the icon look insensitive/prelighted.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -37187,6 +38905,7 @@ or make the icon look insensitive/prelighted.
</parameter>
</parameters>
<return> a new #GtkIconSet
+
</return>
</function>
@@ -37194,6 +38913,7 @@ or make the icon look insensitive/prelighted.
<description>
Increments the reference count on @icon_set.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -37203,6 +38923,7 @@ Increments the reference count on @icon_set.
</parameter>
</parameters>
<return> @icon_set.
+
</return>
</function>
@@ -37269,6 +38990,8 @@ image" icon will be returned instead.
Since: 3.0
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="icon_set">
@@ -37290,11 +39013,55 @@ means render at the size of the source and don't scale.
</return>
</function>
+<function name="gtk_icon_set_render_icon_surface">
+<description>
+Renders an icon using gtk_render_icon_pixbuf() and converts it to a
+cairo surface.
+
+This function never returns %NULL; if the icon can't be rendered
+(perhaps because an image file fails to load), a default "missing
+image" icon will be returned instead.
+
+Since: 3.10
+
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
+</description>
+<parameters>
+<parameter name="icon_set">
+<parameter_description> a #GtkIconSet
+</parameter_description>
+</parameter>
+<parameter name="context">
+<parameter_description> a #GtkStyleContext
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> icon size. A size of (GtkIconSize)-1
+means render at the size of the source and don't scale.
+</parameter_description>
+</parameter>
+<parameter name="scale">
+<parameter_description> the window scale to render for
+</parameter_description>
+</parameter>
+<parameter name="for_window">
+<parameter_description> #GdkWindow to optimize drawing for, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #cairo_surface_t to be displayed
+
+</return>
+</function>
+
<function name="gtk_icon_set_unref">
<description>
Decrements the reference count on @icon_set, and frees memory
if the reference count reaches 0.
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="icon_set">
@@ -37309,6 +39076,7 @@ if the reference count reaches 0.
<description>
Looks up the icon size associated with @name.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -37318,6 +39086,7 @@ Looks up the icon size associated with @name.
</parameter>
</parameters>
<return> the icon size
+
</return>
</function>
@@ -37326,6 +39095,7 @@ Looks up the icon size associated with @name.
Gets the canonical name of the given icon size. The returned string
is statically allocated and should not be freed.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -37335,17 +39105,15 @@ is statically allocated and should not be freed.
</parameter>
</parameters>
<return> the name of the given icon size.
+
</return>
</function>
<function name="gtk_icon_size_lookup">
<description>
-Obtains the pixel size of a semantic icon size, possibly
-modified by user preferences for the default #GtkSettings.
-(See gtk_icon_size_lookup_for_settings().)
-Normally @size would be
+Obtains the pixel size of a semantic icon size @size:
#GTK_ICON_SIZE_MENU, #GTK_ICON_SIZE_BUTTON, etc. This function
-isn't normally needed, gtk_widget_render_icon_pixbuf() is the usual
+isn't normally needed, gtk_icon_theme_load_icon() is the usual
way to get an icon for rendering, then just look at the size of
the rendered pixbuf. The rendered pixbuf may not even correspond to
the width/height returned by gtk_icon_size_lookup(), because themes
@@ -37387,6 +39155,8 @@ the usual size.
Since: 2.2
+Deprecated: 3.10: Use gtk_icon_size_lookup() instead.
+
</description>
<parameters>
<parameter name="settings">
@@ -37417,6 +39187,7 @@ which set of user preferences to used.
Registers a new icon size, along the same lines as #GTK_ICON_SIZE_MENU,
etc. Returns the integer value for the size.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -37434,6 +39205,7 @@ etc. Returns the integer value for the size.
</parameter>
</parameters>
<return> integer value representing the size
+
</return>
</function>
@@ -37443,6 +39215,8 @@ Registers @alias as another name for @target.
So calling gtk_icon_size_from_name() with @alias as argument
will return @target.
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="alias">
@@ -37461,6 +39235,7 @@ will return @target.
<description>
Creates a copy of @source; mostly useful for language bindings.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -37470,6 +39245,7 @@ Creates a copy of @source; mostly useful for language bindings.
</parameter>
</parameters>
<return> a new #GtkIconSource
+
</return>
</function>
@@ -37478,6 +39254,8 @@ Creates a copy of @source; mostly useful for language bindings.
Frees a dynamically-allocated icon source, along with its
filename, size, and pixbuf fields if those are not %NULL.
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="source">
@@ -37494,6 +39272,7 @@ Obtains the text direction this icon source applies to. The return
value is only useful/meaningful if the text direction is <emphasis>not</emphasis>
wildcarded.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -37503,6 +39282,7 @@ wildcarded.
</parameter>
</parameters>
<return> text direction this source matches
+
</return>
</function>
@@ -37510,6 +39290,7 @@ wildcarded.
<description>
Gets the value set by gtk_icon_source_set_direction_wildcarded().
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -37519,6 +39300,7 @@ Gets the value set by gtk_icon_source_set_direction_wildcarded().
</parameter>
</parameters>
<return> %TRUE if this icon source is a base for any text direction variant
+
</return>
</function>
@@ -37528,6 +39310,7 @@ Retrieves the source filename, or %NULL if none is set. The
filename is not a copy, and should not be modified or expected to
persist beyond the lifetime of the icon source.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -37538,6 +39321,7 @@ persist beyond the lifetime of the icon source.
</parameters>
<return> image filename. This string must not
be modified or freed.
+
</return>
</function>
@@ -37547,6 +39331,7 @@ Retrieves the source icon name, or %NULL if none is set. The
icon_name is not a copy, and should not be modified or expected to
persist beyond the lifetime of the icon source.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -37556,6 +39341,7 @@ persist beyond the lifetime of the icon source.
</parameter>
</parameters>
<return> icon name. This string must not be modified or freed.
+
</return>
</function>
@@ -37569,6 +39355,7 @@ for the GtkIconSource passed to the GtkStyle::render_icon()
virtual function. The reference count on the pixbuf is
not incremented.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -37578,6 +39365,7 @@ not incremented.
</parameter>
</parameters>
<return> source pixbuf
+
</return>
</function>
@@ -37586,6 +39374,7 @@ not incremented.
Obtains the icon size this source applies to. The return value
is only useful/meaningful if the icon size is <emphasis>not</emphasis> wildcarded.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -37595,6 +39384,7 @@ is only useful/meaningful if the icon size is <emphasis>not</emphasis&g
</parameter>
</parameters>
<return> icon size this source matches.
+
</return>
</function>
@@ -37602,6 +39392,7 @@ is only useful/meaningful if the icon size is <emphasis>not</emphasis&g
<description>
Gets the value set by gtk_icon_source_set_size_wildcarded().
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -37611,6 +39402,7 @@ Gets the value set by gtk_icon_source_set_size_wildcarded().
</parameter>
</parameters>
<return> %TRUE if this icon source is a base for any icon size variant
+
</return>
</function>
@@ -37620,6 +39412,7 @@ Obtains the widget state this icon source applies to. The return
value is only useful/meaningful if the widget state is <emphasis>not</emphasis>
wildcarded.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -37629,6 +39422,7 @@ wildcarded.
</parameter>
</parameters>
<return> widget state this source matches
+
</return>
</function>
@@ -37636,6 +39430,7 @@ wildcarded.
<description>
Gets the value set by gtk_icon_source_set_state_wildcarded().
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
@@ -37645,6 +39440,7 @@ Gets the value set by gtk_icon_source_set_state_wildcarded().
</parameter>
</parameters>
<return> %TRUE if this icon source is a base for any widget state variant
+
</return>
</function>
@@ -37679,11 +39475,13 @@ By default, the icon source has all parameters wildcarded. That is,
the icon source will be used as the base icon for any desired text
direction, widget state, or icon size.
+Deprecated: 3.10: Use #GtkIconTheme instead.
</description>
<parameters>
</parameters>
<return> a new #GtkIconSource
+
</return>
</function>
@@ -37697,6 +39495,8 @@ if the text direction is wildcarded. Therefore, you should usually
call gtk_icon_source_set_direction_wildcarded() to un-wildcard it
in addition to calling this function.
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="source">
@@ -37723,6 +39523,8 @@ will only be used with that text direction.
#GtkIconSet prefers non-wildcarded sources (exact matches) over
wildcarded sources, and will use an exact match when possible.
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="source">
@@ -37742,6 +39544,8 @@ wildcarded sources, and will use an exact match when possible.
Sets the name of an image file to use as a base image when creating
icon variants for #GtkIconSet. The filename must be absolute.
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="source">
@@ -37761,6 +39565,8 @@ icon variants for #GtkIconSet. The filename must be absolute.
Sets the name of an icon to look up in the current icon theme
to use as a base image when creating icon variants for #GtkIconSet.
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="source">
@@ -37780,6 +39586,8 @@ to use as a base image when creating icon variants for #GtkIconSet.
Sets a pixbuf to use as a base image when creating icon variants
for #GtkIconSet.
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="source">
@@ -37804,6 +39612,8 @@ if the size is wildcarded. Therefore, you should usually
call gtk_icon_source_set_size_wildcarded() to un-wildcard it
in addition to calling this function.
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="source">
@@ -37833,6 +39643,8 @@ wildcarded sources, and will use an exact match when possible.
an appropriate icon at a given size, but will not change the size
of source images that match exactly.
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="source">
@@ -37857,6 +39669,8 @@ if the state is wildcarded. Therefore, you should usually
call gtk_icon_source_set_state_wildcarded() to un-wildcard it
in addition to calling this function.
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="source">
@@ -37887,6 +39701,8 @@ produce an appropriate icon for a given state, for example
lightening an image on prelight, but will not modify source images
that match exactly.
+Deprecated: 3.10: Use #GtkIconTheme instead.
+
</description>
<parameters>
<parameter name="source">
@@ -38001,6 +39817,50 @@ about the icon, or %NULL if the icon wasn't found.
</return>
</function>
+<function name="gtk_icon_theme_choose_icon_for_scale">
+<description>
+Looks up a named icon for a particular window scale and returns a
+structure containing information such as the filename of the
+icon. The icon can then be rendered into a pixbuf using
+gtk_icon_info_load_icon(). (gtk_icon_theme_load_icon() combines
+these two steps if all you need is the pixbuf.)
+
+If @icon_names contains more than one name, this function
+tries them all in the given order before falling back to
+inherited icon themes.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="icon_theme">
+<parameter_description> a #GtkIconTheme
+</parameter_description>
+</parameter>
+<parameter name="icon_names">
+<parameter_description> %NULL-terminated array of
+icon names to lookup
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> desired icon size
+</parameter_description>
+</parameter>
+<parameter name="scale">
+<parameter_description> desired scale
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags modifying the behavior of the icon lookup
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GtkIconInfo object containing information
+about the icon, or %NULL if the icon wasn't found.
+
+</return>
+</function>
+
<function name="gtk_icon_theme_get_default">
<description>
Gets the icon theme for the default screen. See
@@ -38247,6 +40107,116 @@ your reference to the icon. %NULL if the icon isn't found.
</return>
</function>
+<function name="gtk_icon_theme_load_icon_for_scale">
+<description>
+Looks up an icon in an icon theme for a particular window scale,
+scales it to the given size and renders it into a pixbuf. This is a
+convenience function; if more details about the icon are needed,
+use gtk_icon_theme_lookup_icon() followed by
+gtk_icon_info_load_icon().
+
+Note that you probably want to listen for icon theme changes and
+update the icon. This is usually done by connecting to the
+GtkWidget::style-set signal. If for some reason you do not want to
+update the icon when the icon theme changes, you should consider
+using gdk_pixbuf_copy() to make a private copy of the pixbuf
+returned by this function. Otherwise GTK+ may need to keep the old
+icon theme loaded, which would be a waste of memory.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="icon_theme">
+<parameter_description> a #GtkIconTheme
+</parameter_description>
+</parameter>
+<parameter name="icon_name">
+<parameter_description> the name of the icon to lookup
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the desired icon size. The resulting icon may not be
+exactly this size; see gtk_icon_info_load_icon().
+</parameter_description>
+</parameter>
+<parameter name="scale">
+<parameter_description> desired scale
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags modifying the behavior of the icon lookup
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Location to store error information on failure,
+or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the rendered icon; this may be a
+newly created icon or a new reference to an internal icon, so
+you must not modify the icon. Use g_object_unref() to release
+your reference to the icon. %NULL if the icon isn't found.
+
+</return>
+</function>
+
+<function name="gtk_icon_theme_load_surface">
+<description>
+Looks up an icon in an icon theme for a particular window scale,
+scales it to the given size and renders it into a cairo surface. This is a
+convenience function; if more details about the icon are needed,
+use gtk_icon_theme_lookup_icon() followed by
+gtk_icon_info_load_surface().
+
+Note that you probably want to listen for icon theme changes and
+update the icon. This is usually done by connecting to the
+GtkWidget::style-set signal.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="icon_theme">
+<parameter_description> a #GtkIconTheme
+</parameter_description>
+</parameter>
+<parameter name="icon_name">
+<parameter_description> the name of the icon to lookup
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the desired icon size. The resulting icon may not be
+exactly this size; see gtk_icon_info_load_icon().
+</parameter_description>
+</parameter>
+<parameter name="scale">
+<parameter_description> desired scale
+</parameter_description>
+</parameter>
+<parameter name="for_window">
+<parameter_description> #GdkWindow to optimize drawing for, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags modifying the behavior of the icon lookup
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Location to store error information on failure,
+or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the rendered icon; this may be a
+newly created icon or a new reference to an internal icon, so
+you must not modify the icon. Use cairo_surface_destroy() to release
+your reference to the icon. %NULL if the icon isn't found.
+
+</return>
+</function>
+
<function name="gtk_icon_theme_lookup_by_gicon">
<description>
Looks up an icon and returns a structure containing
@@ -38282,6 +40252,45 @@ wasn't found. Unref with g_object_unref()
</return>
</function>
+<function name="gtk_icon_theme_lookup_by_gicon_for_scale">
+<description>
+Looks up an icon and returns a structure containing
+information such as the filename of the icon.
+The icon can then be rendered into a pixbuf using
+gtk_icon_info_load_icon_for_scale ().
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="icon_theme">
+<parameter_description> a #GtkIconTheme
+</parameter_description>
+</parameter>
+<parameter name="icon">
+<parameter_description> the #GIcon to look up
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> desired icon size
+</parameter_description>
+</parameter>
+<parameter name="scale">
+<parameter_description> the desired scale
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags modifying the behavior of the icon lookup
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GtkIconInfo structure containing
+information about the icon, or %NULL if the icon
+wasn't found. Unref with g_object_unref()
+
+</return>
+</function>
+
<function name="gtk_icon_theme_lookup_icon">
<description>
Looks up a named icon and returns a structure containing
@@ -38317,6 +40326,45 @@ about the icon, or %NULL if the icon wasn't found.
</return>
</function>
+<function name="gtk_icon_theme_lookup_icon_for_scale">
+<description>
+Looks up a named icon for a particular window scale and returns a
+structure containing information such as the filename of the
+icon. The icon can then be rendered into a pixbuf using
+gtk_icon_info_load_icon(). (gtk_icon_theme_load_icon() combines
+these two steps if all you need is the pixbuf.)
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="icon_theme">
+<parameter_description> a #GtkIconTheme
+</parameter_description>
+</parameter>
+<parameter name="icon_name">
+<parameter_description> the name of the icon to lookup
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> desired icon size
+</parameter_description>
+</parameter>
+<parameter name="scale">
+<parameter_description> the desired scale
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags modifying the behavior of the icon lookup
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GtkIconInfo object containing
+information about the icon, or %NULL if the icon wasn't found.
+
+</return>
+</function>
+
<function name="gtk_icon_theme_new">
<description>
Creates a new icon theme object. Icon theme objects are used
@@ -38687,12 +40735,13 @@ Since: 2.8
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> Return location for the current cursor path,
-or %NULL
+<parameter_description> Return location for the current
+cursor path, or %NULL
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> Return location the current focus cell, or %NULL
+<parameter_description> Return location the current
+focus cell, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -40310,6 +42359,11 @@ Add menuitems for various available input methods to a menu;
the menuitems, when selected, will switch the input method
for the context and the global default input method.
+Deprecated: 3.10: It is better to use the system-wide input
+method framework for changing input methods. Modern
+desktop shells offer on-screen displays for this that
+can triggered with a keyboard shortcut, e.g. Super-Space.
+
</description>
<parameters>
<parameter name="context">
@@ -40480,6 +42534,8 @@ Gets the icon set and size being displayed by the #GtkImage.
The storage type of the image must be %GTK_IMAGE_EMPTY or
%GTK_IMAGE_ICON_SET (see gtk_image_get_storage_type()).
+Deprecated: 3.10: Use gtk_image_get_icon_name() instead.
+
</description>
<parameters>
<parameter name="image">
@@ -40547,6 +42603,8 @@ The storage type of the image must be %GTK_IMAGE_EMPTY or
The returned string is owned by the #GtkImage and should not
be freed.
+Deprecated: 3.10: Use gtk_image_get_icon_name() instead.
+
</description>
<parameters>
<parameter name="image">
@@ -40587,11 +42645,12 @@ the return value will be %GTK_IMAGE_EMPTY.
<function name="gtk_image_menu_item_get_always_show_image">
<description>
-Returns whether the menu item will ignore the #GtkSettings:gtk-menu-images
-setting and always show the image, if available.
+Returns whether the menu item will always show the image, if available.
Since: 2.16
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="image_menu_item">
@@ -40609,6 +42668,7 @@ Since: 2.16
Gets the widget that is currently set as the image of @image_menu_item.
See gtk_image_menu_item_set_image().
+Deprecated: 3.10
</description>
<parameters>
@@ -40618,6 +42678,7 @@ See gtk_image_menu_item_set_image().
</parameter>
</parameters>
<return> the widget set as image of @image_menu_item
+
</return>
</function>
@@ -40628,6 +42689,8 @@ stock id to select the stock item for the item.
Since: 2.16
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="image_menu_item">
@@ -40645,11 +42708,13 @@ stock id to select the stock item for the item
<description>
Creates a new #GtkImageMenuItem with an empty label.
+Deprecated: 3.10: Use gtk_menu_item_new() instead.
</description>
<parameters>
</parameters>
<return> a new #GtkImageMenuItem
+
</return>
</function>
@@ -40665,6 +42730,7 @@ appropriate path for the menu item, use gtk_stock_lookup() to look up the
standard accelerator for the stock item, and if one is found, call
gtk_accel_map_add_entry() to register it.
+Deprecated: 3.10: Use gtk_menu_item_new() instead.
</description>
<parameters>
@@ -40679,6 +42745,7 @@ accelerator to, or %NULL.
</parameter>
</parameters>
<return> a new #GtkImageMenuItem.
+
</return>
</function>
@@ -40686,6 +42753,7 @@ accelerator to, or %NULL.
<description>
Creates a new #GtkImageMenuItem containing a label.
+Deprecated: 3.10: Use gtk_menu_item_new_with_label() instead.
</description>
<parameters>
@@ -40695,6 +42763,7 @@ Creates a new #GtkImageMenuItem containing a label.
</parameter>
</parameters>
<return> a new #GtkImageMenuItem.
+
</return>
</function>
@@ -40704,6 +42773,7 @@ Creates a new #GtkImageMenuItem containing a label. The label
will be created using gtk_label_new_with_mnemonic(), so underscores
in @label indicate the mnemonic for the menu item.
+Deprecated: 3.10: Use gtk_menu_item_new_with_mnemonic() instead.
</description>
<parameters>
@@ -40714,6 +42784,7 @@ mnemonic character
</parameter>
</parameters>
<return> a new #GtkImageMenuItem
+
</return>
</function>
@@ -40729,6 +42800,8 @@ you shouldnt need this (see gtk_image_menu_item_new_from_stock()).
Since: 2.16
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="image_menu_item">
@@ -40745,14 +42818,15 @@ Since: 2.16
<function name="gtk_image_menu_item_set_always_show_image">
<description>
-If %TRUE, the menu item will ignore the #GtkSettings:gtk-menu-images
-setting and always show the image, if available.
+If %TRUE, the menu item will always show the image, if available.
Use this property if the menuitem would be useless or hard to use
without the image.
Since: 2.16
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="image_menu_item">
@@ -40773,6 +42847,8 @@ Sets the image of @image_menu_item to the given widget.
Note that it depends on the show-menu-images setting whether
the image will be displayed or not.
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="image_menu_item">
@@ -40794,6 +42870,8 @@ stock id to select the stock item for the item.
Since: 2.16
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="image_menu_item">
@@ -40939,6 +43017,7 @@ The #GtkImage does not assume a reference to the
icon set; you still need to unref it if you own references.
#GtkImage will add its own reference rather than adopting yours.
+Deprecated: 3.10: Use gtk_image_new_from_icon_name() instead.
</description>
<parameters>
@@ -40952,6 +43031,7 @@ icon set; you still need to unref it if you own references.
</parameter>
</parameters>
<return> a new #GtkImage
+
</return>
</function>
@@ -40964,7 +43044,7 @@ pixbuf; you still need to unref it if you own references.
Note that this function just creates an #GtkImage from the pixbuf. The
#GtkImage created will not react to state changes. Should you want that,
-you should use gtk_image_new_from_icon_set().
+you should use gtk_image_new_from_icon_name().
</description>
@@ -41020,6 +43100,7 @@ icon name isn't known, the image will be empty.
You can register your own stock icon names, see
gtk_icon_factory_add_default() and gtk_icon_factory_add().
+Deprecated: 3.10: Use gtk_image_new_from_icon_name() instead.
</description>
<parameters>
@@ -41033,6 +43114,26 @@ gtk_icon_factory_add_default() and gtk_icon_factory_add().
</parameter>
</parameters>
<return> a new #GtkImage displaying the stock icon
+
+</return>
+</function>
+
+<function name="gtk_image_new_from_surface">
+<description>
+Creates a new #GtkImage displaying @surface.
+The #GtkImage does not assume a reference to the
+surface; you still need to unref it if you own references.
+#GtkImage will add its own reference rather than adopting yours.
+
+
+</description>
+<parameters>
+<parameter name="surface">
+<parameter_description> a #cairo_surface_t, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GtkImage
</return>
</function>
@@ -41125,6 +43226,8 @@ Since: 2.6
<description>
See gtk_image_new_from_icon_set() for details.
+Deprecated: 3.10: Use gtk_image_set_from_icon_name() instead.
+
</description>
<parameters>
<parameter name="image">
@@ -41183,6 +43286,8 @@ See gtk_image_new_from_resource() for details.
<description>
See gtk_image_new_from_stock() for details.
+Deprecated: 3.10: Use gtk_image_set_from_icon_name() instead.
+
</description>
<parameters>
<parameter name="image">
@@ -41201,6 +43306,26 @@ See gtk_image_new_from_stock() for details.
<return></return>
</function>
+<function name="gtk_image_set_from_surface">
+<description>
+See gtk_image_new_from_surface() for details.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="image">
+<parameter_description> a #GtkImage
+</parameter_description>
+</parameter>
+<parameter name="surface">
+<parameter_description> a cairo_surface_t
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_image_set_pixel_size">
<description>
Sets the pixel size to use for named icons. If the pixel size is set
@@ -41252,11 +43377,11 @@ Since: 2.18
<function name="gtk_info_bar_add_button">
<description>
-Adds a button with the given text (or a stock button, if button_text
-is a stock ID) and sets things up so that clicking the button will emit
-the "response" signal with the given response_id. The button is appended
-to the end of the info bars's action area. The button widget is
-returned, but usually you don't need it.
+Adds a button with the given text and sets things up so that
+clicking the button will emit the "response" signal with the given
+response_id. The button is appended to the end of the info bars's
+action area. The button widget is returned, but usually you don't
+need it.
Since: 2.18
@@ -41267,7 +43392,7 @@ Since: 2.18
</parameter_description>
</parameter>
<parameter name="button_text">
-<parameter_description> text of button, or stock ID
+<parameter_description> text of button
</parameter_description>
</parameter>
<parameter name="response_id">
@@ -41362,6 +43487,24 @@ Since: 2.18
</return>
</function>
+<function name="gtk_info_bar_get_show_close_button">
+<description>
+Returns whether the widget will display a standard close button.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="info_bar">
+<parameter_description> a #GtkInfoBar
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the widget displays standard close button
+
+</return>
+</function>
+
<function name="gtk_info_bar_new">
<description>
Creates a new #GtkInfoBar object.
@@ -41496,6 +43639,27 @@ Since: 2.18
<return></return>
</function>
+<function name="gtk_info_bar_set_show_close_button">
+<description>
+If true, a standard close button is shown. When clicked it emits
+the response %GTK_RESPONSE_CLOSE.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="info_bar">
+<parameter_description> a #GtkInfoBar
+</parameter_description>
+</parameter>
+<parameter name="setting">
+<parameter_description> %TRUE to include a close button
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_init">
<description>
Call this function before using any other GTK+ functions in your GUI
@@ -41961,6 +44125,25 @@ Since: 2.10
</return>
</function>
+<function name="gtk_label_get_lines">
+<description>
+Gets the number of lines to which an ellipsized, wrapping
+label should be limited. See gtk_label_set_lines().
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="label">
+<parameter_description> a #GtkLabel
+</parameter_description>
+</parameter>
+</parameters>
+<return> The number of lines
+
+</return>
+</function>
+
<function name="gtk_label_get_max_width_chars">
<description>
Retrieves the desired maximum width of @label, in characters. See
@@ -42430,6 +44613,29 @@ Since: 2.10
<return></return>
</function>
+<function name="gtk_label_set_lines">
+<description>
+Sets the number of lines to which an ellipsized, wrapping label
+should be limited. This has no effect if the label is not wrapping
+or ellipsized. Set this to -1 if you don't want to limit the
+number of lines.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="label">
+<parameter_description> a #GtkLabel
+</parameter_description>
+</parameter>
+<parameter name="lines">
+<parameter_description> the desired number of lines, or -1
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_label_set_markup">
<description>
Parses @str which is marked up with the <link
@@ -43383,6 +45589,615 @@ Since: 2.14
<return></return>
</function>
+<function name="gtk_list_box_drag_highlight_row">
+<description>
+This is a helper function for implementing DnD onto a #GtkListBox.
+The passed in @row will be highlighted via gtk_drag_highlight(),
+and any previously highlighted row will be unhighlighted.
+
+The row will also be unhighlighted when the widget gets
+a drag leave event.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> An #GtkListBox.
+</parameter_description>
+</parameter>
+<parameter name="row">
+<parameter_description> a #GtkListBoxRow
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_list_box_drag_unhighlight_row">
+<description>
+If a row has previously been highlighted via gtk_list_box_drag_highlight_row()
+it will have the highlight removed.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> An #GtkListBox.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_list_box_get_activate_on_single_click">
+<description>
+Returns whether rows activate on single clicks.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if rows are activated on single click, %FALSE otherwise
+
+</return>
+</function>
+
+<function name="gtk_list_box_get_adjustment">
+<description>
+Gets the adjustment (if any) that the widget uses to
+for vertical scrolling.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> the adjustment
+
+</return>
+</function>
+
+<function name="gtk_list_box_get_row_at_index">
+<description>
+Gets the n:th child in the list (not counting headers).
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+<parameter name="index_">
+<parameter_description> the index of the row
+</parameter_description>
+</parameter>
+</parameters>
+<return> the child #GtkWidget
+
+</return>
+</function>
+
+<function name="gtk_list_box_get_row_at_y">
+<description>
+Gets the row at the @y position.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> position
+</parameter_description>
+</parameter>
+</parameters>
+<return> the row
+
+</return>
+</function>
+
+<function name="gtk_list_box_get_selected_row">
+<description>
+Gets the selected row.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> the selected #GtkWidget
+
+</return>
+</function>
+
+<function name="gtk_list_box_get_selection_mode">
+<description>
+Gets the selection mode of the listbox.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GtkSelectionMode
+
+</return>
+</function>
+
+<function name="gtk_list_box_insert">
+<description>
+Insert the @child into the @list_box at @position. If a sort function is
+set, the widget will actually be inserted at the calculated position and
+this function has the same effect of gtk_container_add().
+
+If @position is -1, or larger than the total number of items in the
+ list_box, then the @child will be appended to the end.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox.
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> the #GtkWidget to add
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> the position to insert @child in
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_list_box_invalidate_filter">
+<description>
+Update the filtering for all rows. Call this when result
+of the filter function on the @list_box is changed due
+to an external factor. For instance, this would be used
+if the filter function just looked for a specific search
+string and the entry with the search string has changed.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_list_box_invalidate_headers">
+<description>
+Update the separators for all rows. Call this when result
+of the header function on the @list_box is changed due
+to an external factor.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_list_box_invalidate_sort">
+<description>
+Update the sorting for all rows. Call this when result
+of the sort function on the @list_box is changed due
+to an external factor.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_list_box_new">
+<description>
+Creates a new #GtkListBox container.
+
+Since: 3.10
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GtkListBox
+
+</return>
+</function>
+
+<function name="gtk_list_box_prepend">
+<description>
+Prepend a widget to the list. If a sort function is set, the widget will
+actually be inserted at the calculated position and this function has the
+same effect of gtk_container_add().
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox.
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> the #GtkWidget to add
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_list_box_row_changed">
+<description>
+Marks @row as changed, causing any state that depends on this
+to be updated. This affects sorting, filtering and headers.
+
+Note that calls to this method must be in sync with the data
+used for the row functions. For instance, if the list is
+mirroring some external data set, and *two* rows changed in the
+external data set then when you call gtk_list_box_row_changed()
+on the first row the sort function must only read the new data
+for the first of the two changed rows, otherwise the resorting
+of the rows will be wrong.
+
+This generally means that if you don't fully control the data
+model you have to duplicate the data that affects the listbox
+row functions into the row widgets themselves. Another alternative
+is to call gtk_list_box_invalidate_sort() on any model change,
+but that is more expensive.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="row">
+<parameter_description> a #GtkListBoxRow
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_list_box_row_get_header">
+<description>
+Returns the current header of the @row. This can be used
+in a #GtkListBoxUpdateHeaderFunc to see if there is a header
+set already, and if so to update the state of it.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="row">
+<parameter_description> a #GtkListBoxRow
+</parameter_description>
+</parameter>
+</parameters>
+<return> the current header, or %NULL if none
+
+</return>
+</function>
+
+<function name="gtk_list_box_row_get_index">
+<description>
+Gets the current index of the @row in its #GtkListBox container.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="row">
+<parameter_description> a #GtkListBoxRow
+</parameter_description>
+</parameter>
+</parameters>
+<return> the index of the @row, or -1 if the @row is not in a listbox
+
+</return>
+</function>
+
+<function name="gtk_list_box_row_new">
+<description>
+Creates a new #GtkListBoxRow, to be used as a child of a #GtkListBox.
+
+Since: 3.10
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GtkListBoxRow
+
+</return>
+</function>
+
+<function name="gtk_list_box_row_set_header">
+<description>
+Sets the current header of the @row. This is only allowed to be called
+from a #GtkListBoxUpdateHeaderFunc. It will replace any existing
+header in the row, and be shown in front of the row in the listbox.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="row">
+<parameter_description> a #GtkListBoxRow
+</parameter_description>
+</parameter>
+<parameter name="header">
+<parameter_description> the header, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_list_box_select_row">
+<description>
+Make @row the currently selected row.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+<parameter name="row">
+<parameter_description> The row to select or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_list_box_set_activate_on_single_click">
+<description>
+If @single is %TRUE, rows will be activated when you click on them,
+otherwise you need to double-click.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+<parameter name="single">
+<parameter_description> a boolean
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_list_box_set_adjustment">
+<description>
+Sets the adjustment (if any) that the widget uses to
+for vertical scrolling. For instance, this is used
+to get the page size for PageUp/Down key handling.
+
+In the normal case when the @list_box is packed inside
+a #GtkScrolledWindow the adjustment from that will
+be picked up automatically, so there is no need
+to manually do that.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+<parameter name="adjustment">
+<parameter_description> the adjustment, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_list_box_set_filter_func">
+<description>
+By setting a filter function on the @list_box one can decide dynamically which
+of the rows to show. For instance, to implement a search function on a list that
+filters the original list to only show the matching rows.
+
+The @filter_func will be called for each row after the call, and it will
+continue to be called each time a row changes (via gtk_list_box_row_changed()) or
+when gtk_list_box_invalidate_filter() is called.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+<parameter name="filter_func">
+<parameter_description> callback that lets you filter which rows to show
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @filter_func
+</parameter_description>
+</parameter>
+<parameter name="destroy">
+<parameter_description> destroy notifier for @user_data
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_list_box_set_header_func">
+<description>
+By setting a header function on the @list_box one can dynamically add headers
+in front of rows, depending on the contents of the row and its position in the list.
+For instance, one could use it to add headers in front of the first item of a
+new kind, in a list sorted by the kind.
+
+The @update_header can look at the current header widget using gtk_list_box_row_get_header()
+and either update the state of the widget as needed, or set a new one using
+gtk_list_box_row_set_header(). If no header is needed, set the header to %NULL.
+
+Note that you may get many calls @update_header to this for a particular row when e.g.
+changing things that don't affect the header. In this case it is important for performance
+to not blindly replace an exisiting header widh an identical one.
+
+The @update_header function will be called for each row after the call, and it will
+continue to be called each time a row changes (via gtk_list_box_row_changed()) and when
+the row before changes (either by gtk_list_box_row_changed() on the previous row, or when
+the previous row becomes a different row). It is also called for all rows when
+gtk_list_box_invalidate_headers() is called.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+<parameter name="update_header">
+<parameter_description> callback that lets you add row headers
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @update_header
+</parameter_description>
+</parameter>
+<parameter name="destroy">
+<parameter_description> destroy notifier for @user_data
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_list_box_set_placeholder">
+<description>
+Sets the placeholder widget that is shown in the list when
+it doesn't display any visible children.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+<parameter name="placeholder">
+<parameter_description> a #GtkWidget or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_list_box_set_selection_mode">
+<description>
+Sets how selection works in the listbox.
+See #GtkSelectionMode for details.
+
+Note: #GtkListBox does not support @GTK_SELECTION_MULTIPLE.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+<parameter name="mode">
+<parameter_description> The #GtkSelectionMode
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_list_box_set_sort_func">
+<description>
+By setting a sort function on the @list_box one can dynamically reorder the rows
+of the list, based on the contents of the rows.
+
+The @sort_func will be called for each row after the call, and will continue to
+be called each time a row changes (via gtk_list_box_row_changed()) and when
+gtk_list_box_invalidate_sort() is called.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="list_box">
+<parameter_description> a #GtkListBox
+</parameter_description>
+</parameter>
+<parameter name="sort_func">
+<parameter_description> the sort function
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @sort_func
+</parameter_description>
+</parameter>
+<parameter name="destroy">
+<parameter_description> destroy notifier for @user_data
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_list_store_append">
<description>
Appends a new row to @list_store. @iter will be changed to point to this new
@@ -44187,6 +47002,11 @@ Attaches the menu to the widget and provides a callback function
that will be invoked when the menu calls gtk_menu_detach() during
its destruction.
+If the menu is attached to the widget then it will be destroyed
+when the widget is destroyed, as if it was a child widget.
+An attached menu will also move between screens correctly if the
+widgets moves between screens.
+
</description>
<parameters>
<parameter name="menu">
@@ -44658,6 +47478,7 @@ Since: 2.18
Returns whether the menu is torn off.
See gtk_menu_set_tearoff_state().
+Deprecated: 3.10
</description>
<parameters>
@@ -44667,6 +47488,7 @@ See gtk_menu_set_tearoff_state().
</parameter>
</parameters>
<return> %TRUE if the menu is currently torn off.
+
</return>
</function>
@@ -44674,6 +47496,7 @@ See gtk_menu_set_tearoff_state().
<description>
Returns the title of the menu. See gtk_menu_set_title().
+Deprecated: 3.10
</description>
<parameters>
@@ -44685,6 +47508,7 @@ Returns the title of the menu. See gtk_menu_set_title().
<return> the title of the menu, or %NULL if the menu
has no title set on it. This string is owned by GTK+
and should not be modified or freed.
+
</return>
</function>
@@ -45457,6 +48281,8 @@ displayed as drop down menu which persists as long as the menu is
active. It can also be displayed as a tearoff menu which persists
until it is closed or reattached.
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="menu">
@@ -45480,6 +48306,8 @@ menu. If @title is %NULL, the menu will see if it is attached
to a parent menu item, and if so it will try to use the same
text as that menu item's label.
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="menu">
@@ -45557,6 +48385,16 @@ namespace, plus a dot. For example, if the action "quit" is
mentioned and @action_namespace is "app" then the effective action
name is "app.quit".
+This function uses #GtkActionable to define the action name and
+target values on the created menu items. If you want to use an
+action group other than "app" and "win", or if you want to use a
+#GtkMenuShell outside of a #GtkApplicationWindow, then you will need
+to attach your own action group to the widget hierarchy using
+gtk_widget_insert_action_group(). As an example, if you created a
+group with a "quit" action and inserted it with the name "mygroup"
+then you would use the action name "mygroup.quit" in your
+#GMenuModel.
+
For most cases you are probably better off using
gtk_menu_new_from_model() or gtk_menu_bar_new_from_model() or just
directly passing the #GMenuModel to gtk_application_set_app_menu() or
@@ -45876,6 +48714,8 @@ the stock item indicated by @stock_id.
Since: 2.6
+Deprecated: 3.10: Use gtk_menu_tool_button_new() instead.
+
</description>
<parameters>
<parameter name="stock_id">
@@ -45953,6 +48793,48 @@ Since: 2.6
<return></return>
</function>
+<function name="gtk_menu_tracker_item_get_has_submenu">
+<description>
+Returns whether the menu item has a submenu. If so, only
+certain properties may need to be obeyed. See the documentation
+for #GtkMenuTrackerItem.
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #GtkMenuTrackerItem instance
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_menu_tracker_item_get_icon">
+<description>
+
+</description>
+<parameters>
+</parameters>
+<return>
+</return>
+</function>
+
+<function name="gtk_menu_tracker_item_get_is_separator">
+<description>
+Returns whether the menu item is a separator. If so, only
+certain properties may need to be obeyed. See the documentation
+for #GtkMenuTrackerItem.
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> A #GtkMenuTrackerItem instance
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_message_dialog_format_secondary_markup">
<description>
Sets the secondary text of the message dialog to be @message_format (with
@@ -50296,6 +53178,281 @@ command line arguments
</return>
</function>
+<function name="gtk_places_sidebar_add_shortcut">
+<description>
+Applications may want to present some folders in the places sidebar if
+they could be immediately useful to users. For example, a drawing
+program could add a "/usr/share/clipart" location when the sidebar is
+being used in an "Insert Clipart" dialog box.
+
+This function adds the specified @location to a special place for immutable
+shortcuts. The shortcuts are application-specific; they are not shared
+across applications, and they are not persistent. If this function
+is called multiple times with different locations, then they are added
+to the sidebar's list in the same order as the function is called.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a places sidebar
+</parameter_description>
+</parameter>
+<parameter name="location">
+<parameter_description> location to add as an application-specific shortcut
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_places_sidebar_get_location">
+<description>
+Gets the currently-selected location in the @sidebar. This can be #NULL when
+nothing is selected, for example, when gtk_places_sidebar_set_location() has
+been called with a location that is not among the sidebar's list of places to
+show.
+
+You can use this function to get the selection in the @sidebar. Also, if you
+connect to the #GtkPlacesSidebar::popup-menu signal, you can use this
+function to get the location that is being referred to during the callbacks
+for your menu items.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a places sidebar
+</parameter_description>
+</parameter>
+</parameters>
+<return> a GFile with the selected location, or #NULL if nothing is visually
+selected.
+
+</return>
+</function>
+
+<function name="gtk_places_sidebar_get_nth_bookmark">
+<description>
+This function queries the bookmarks added by the user to the places sidebar,
+and returns one of them. This function is used by #GtkFileChooser to implement
+the "Alt-1", "Alt-2", etc. shortcuts, which activate the cooresponding bookmark.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a places sidebar
+</parameter_description>
+</parameter>
+<parameter name="n">
+<parameter_description> index of the bookmark to query
+</parameter_description>
+</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".
+
+</return>
+</function>
+
+<function name="gtk_places_sidebar_get_show_connect_to_server">
+<description>
+Returns the value previously set with gtk_places_sidebar_set_show_connect_to_server()
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a places sidebar
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the sidebar will display a "Connect to Server" item.
+
+</return>
+</function>
+
+<function name="gtk_places_sidebar_get_show_desktop">
+<description>
+Returns the value previously set with gtk_places_sidebar_set_show_desktop()
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a places sidebar
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the sidebar will display a builtin shortcut to the desktop folder.
+
+</return>
+</function>
+
+<function name="gtk_places_sidebar_list_shortcuts">
+<description>
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a places sidebar
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GSList of #GFile of the locations
+that have been added as application-specific shortcuts with gtk_places_sidebar_add_shortcut().
+To free this list, you can use
+|[
+g_slist_free_full (list, (GDestroyNotify) g_object_unref);
+]|
+
+</return>
+</function>
+
+<function name="gtk_places_sidebar_new">
+<description>
+Creates a new #GtkPlacesSidebar widget. The application should connect
+to at least the #GtkPlacesSidebar::open-location signal to be notified
+when the user makes a selection in the sidebar.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_places_sidebar_remove_shortcut">
+<description>
+Removes an application-specific shortcut that has been previously been
+inserted with gtk_places_sidebar_add_shortcut(). If the @location is not a
+shortcut in the sidebar, then nothing is done.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a places sidebar
+</parameter_description>
+</parameter>
+<parameter name="location">
+<parameter_description> location to remove
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_places_sidebar_set_location">
+<description>
+Sets the location that is being shown in the widgets surrounding the
+ sidebar, for example, in a folder view in a file manager. In turn, the
+ sidebar will highlight that location if it is being shown in the list of
+places, or it will unhighlight everything if the @location is not among the
+places in the list.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a places sidebar
+</parameter_description>
+</parameter>
+<parameter name="location">
+<parameter_description> location to select, or #NULL for no current path
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_places_sidebar_set_open_flags">
+<description>
+Sets the way in which the calling application can open new locations from
+the places sidebar. For example, some applications only open locations
+"directly" into their main view, while others may support opening locations
+in a new notebook tab or a new window.
+
+This function is used to tell the places @sidebar about the ways in which the
+application can open new locations, so that the sidebar can display (or not)
+the "Open in new tab" and "Open in new window" menu items as appropriate.
+
+When the #GtkPlacesSidebar::open-location signal is emitted, its flags
+argument will be set to one of the @flags that was passed in
+gtk_places_sidebar_set_open_flags().
+
+Passing 0 for @flags will cause #GTK_PLACES_OPEN_NORMAL to always be sent
+to callbacks for the "open-location" signal.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a places sidebar
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Bitmask of modes in which the calling application can open locations
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_places_sidebar_set_show_connect_to_server">
+<description>
+Sets whether the @sidebar should show an item for connecting to a network server; this is off by default.
+An application may want to turn this on if it implements a way for the user to connect
+to network servers directly.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a places sidebar
+</parameter_description>
+</parameter>
+<parameter name="show_connect_to_server">
+<parameter_description> whether to show an item for the Connect to Server command
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_places_sidebar_set_show_desktop">
+<description>
+Sets whether the @sidebar should show an item for the Desktop folder; this is off by default.
+An application may want to turn this on if the desktop environment actually supports the
+notion of a desktop.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a places sidebar
+</parameter_description>
+</parameter>
+<parameter name="show_desktop">
+<parameter_description> whether to show an item for the Desktop folder
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_plug_construct">
<description>
Finish the initialization of @plug for a given #GtkSocket identified by
@@ -55015,6 +58172,8 @@ the group to which @action belongs.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action">
@@ -55049,6 +58208,8 @@ group = gtk_radio_action_get_group (action);
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action">
@@ -55084,6 +58245,8 @@ last_action = action;
Since: 3.0
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action">
@@ -55107,6 +58270,8 @@ call gtk_action_group_add_action_with_accel().
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="name">
@@ -55145,6 +58310,8 @@ property @current_value.
Since: 2.10
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action">
@@ -55165,6 +58332,8 @@ Sets the radio group for the radio action object.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action">
@@ -55593,6 +58762,8 @@ stock item indicated by @stock_id.
Since: 2.4
+Deprecated: 3.10: Use gtk_radio_tool_button_new() instead.
+
</description>
<parameters>
<parameter name="group">
@@ -55636,6 +58807,8 @@ stock item indicated by @stock_id.
Since: 2.4
+Deprecated: 3.10: gtk_radio_tool_button_new_from_widget
+
</description>
<parameters>
<parameter name="group">
@@ -56926,6 +60099,8 @@ Returns the value set by gtk_recent_chooser_menu_set_show_numbers().
Since: 2.12
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action">
@@ -56946,6 +60121,8 @@ call gtk_action_group_add_action_with_accel().
Since: 2.12
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="name">
@@ -56980,6 +60157,8 @@ call gtk_action_group_add_action_with_accel().
Since: 2.12
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="name">
@@ -57020,6 +60199,8 @@ label. Only the first ten items get a number to avoid clashes.
Since: 2.12
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action">
@@ -58442,8 +61623,8 @@ is owned by the recent manager, and should not be freed.
<function name="gtk_recent_info_get_modified">
<description>
-Gets the timestamp (seconds from system's Epoch) when the resource
-was last modified.
+Gets the timestamp (seconds from system's Epoch) when the meta-data
+for the resource was last modified.
Since: 2.10
@@ -58543,8 +61724,8 @@ resource's URI or %NULL. Use g_free() when done using it.
<function name="gtk_recent_info_get_visited">
<description>
-Gets the timestamp (seconds from system's Epoch) when the resource
-was last visited.
+Gets the timestamp (seconds from system's Epoch) when the meta-data
+for the resource was last visited.
Since: 2.10
@@ -59458,6 +62639,8 @@ in a pixbuf.
Since: 3.0
+Deprecated: 3.10: Use gtk_icon_theme_load_icon() instead.
+
</description>
<parameters>
<parameter name="context">
@@ -59479,6 +62662,38 @@ means render at the size of the source and don't scale.
</return>
</function>
+<function name="gtk_render_icon_surface">
+<description>
+Renders the icon in @surface at the specified @x and @y coordinates.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="context">
+<parameter_description> a #GtkStyleContext
+</parameter_description>
+</parameter>
+<parameter name="cr">
+<parameter_description> a #cairo_t
+</parameter_description>
+</parameter>
+<parameter name="surface">
+<parameter_description> a #cairo_surface_t containing the icon to draw
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> X position for the @icon
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> Y position for the @incon
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_render_insertion_cursor">
<description>
Draws a text caret on @cr at the specified index of @layout.
@@ -59722,6 +62937,152 @@ be freed with gtk_requisition_free().
</return>
</function>
+<function name="gtk_revealer_get_child_revealed">
+<description>
+Returns whether the child is fully revealed, ie wether
+the transition to the revealed state is completed.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="revealer">
+<parameter_description> a #GtkRevealer
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the child is fully revealed
+
+</return>
+</function>
+
+<function name="gtk_revealer_get_reveal_child">
+<description>
+Returns whether the child is currently
+revealed. See gtk_revealer_set_reveal_child().
+
+This function returns %TRUE as soon as the transition
+is to the revealed state is started. To learn whether
+the child is fully revealed (ie the transition is completed),
+use gtk_revealer_get_child_revealed().
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="revealer">
+<parameter_description> a #GtkRevealer
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the child is revealed.
+
+</return>
+</function>
+
+<function name="gtk_revealer_get_transition_duration">
+<description>
+Returns the amount of time (in milliseconds) that
+transitions will take.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="revealer">
+<parameter_description> a #GtkRevealer
+</parameter_description>
+</parameter>
+</parameters>
+<return> the transition duration
+
+</return>
+</function>
+
+<function name="gtk_revealer_get_transition_type">
+<description>
+Gets the type of animation that will be used
+for transitions in @revealer.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="revealer">
+<parameter_description> a #GtkRevealer
+</parameter_description>
+</parameter>
+</parameters>
+<return> the current transition type of @revealer
+
+</return>
+</function>
+
+<function name="gtk_revealer_set_reveal_child">
+<description>
+Tells the #GtkRevealer to reveal or conceal its child.
+
+The transition will be animated with the current
+transition type of @revealer.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="revealer">
+<parameter_description> a #GtkRevealer
+</parameter_description>
+</parameter>
+<parameter name="reveal_child">
+<parameter_description> %TRUE to reveal the child
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_revealer_set_transition_duration">
+<description>
+Sets the duration that transitions will take.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="revealer">
+<parameter_description> a #GtkRevealer
+</parameter_description>
+</parameter>
+<parameter name="duration">
+<parameter_description> the new duration, in milliseconds
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_revealer_set_transition_type">
+<description>
+Sets the type of animation that will be used for
+transitions in @revealer. Available types include
+various kinds of fades and slides.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="revealer">
+<parameter_description> a #GtkRevealer
+</parameter_description>
+</parameter>
+<parameter name="transition">
+<parameter_description> the new transition type
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_rgb_to_hsv">
<description>
Converts a color from RGB space to HSV.
@@ -60931,7 +64292,7 @@ Sets the #GtkAdjustment for the vertical scrollbar.
<description>
Unsets the placement of the contents with respect to the scrollbars
for the scrolled window. If no window placement is set for a scrolled
-window, it obeys the "gtk-scrolled-window-placement" XSETTING.
+window, it defaults to GTK_CORNER_TOP_LEFT.
See also gtk_scrolled_window_set_placement() and
gtk_scrolled_window_get_placement().
@@ -60948,6 +64309,174 @@ Since: 2.10
<return></return>
</function>
+<function name="gtk_search_bar_connect_entry">
+<description>
+Connects the #GtkEntry widget passed as the one to be used in
+this search bar. The entry should be a descendant of the search bar.
+This is only required if the entry isn't the direct child of the
+search bar (as in our main example).
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkSearchBar
+</parameter_description>
+</parameter>
+<parameter name="entry">
+<parameter_description> a #GtkEntry
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_search_bar_get_search_mode">
+<description>
+Returns whether the search mode is on or off.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkSearchBar
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether search mode is toggled on
+
+</return>
+</function>
+
+<function name="gtk_search_bar_get_show_close_button">
+<description>
+Returns whether the close button is shown.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkSearchBar
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether the close button is shown
+
+</return>
+</function>
+
+<function name="gtk_search_bar_handle_event">
+<description>
+This function should be called when the top-level
+window which contains the search bar received a key event.
+
+If the key event is handled by the search bar, the bar will
+be shown, the entry populated with the entered text and %GDK_EVENT_STOP
+will be returned. The caller should ensure that events are
+not propagated further.
+
+If no entry has been connected to the search bar, using
+gtk_search_bar_connect_entry(), this function will return
+immediately with a warning.
+
+<example>
+<title>Showing the search bar on key presses</title>
+<programlisting><![CDATA[
+static gboolean
+window_key_press_event_cb (GtkWidget *widget,
+GdkEvent *event,
+gpointer user_data)
+{
+return gtk_search_bar_handle_event (GTK_SEARCH_BAR (user_data), event);
+}
+
+g_signal_connect (window, "key-press-event",
+G_CALLBACK (window_key_press_event_cb), search_bar);
+]]></programlisting>
+</example>
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkSearchBar
+</parameter_description>
+</parameter>
+<parameter name="event">
+<parameter_description> a #GdkEvent containing key press events
+</parameter_description>
+</parameter>
+</parameters>
+<return> %GDK_EVENT_STOP if the key press event resulted
+in text being entered in the search entry (and revealing
+the search bar if necessary), %GDK_EVENT_PROPAGATE otherwise.
+
+</return>
+</function>
+
+<function name="gtk_search_bar_new">
+<description>
+Creates a #GtkSearchBar. You will need to tell it about
+which widget is going to be your text entry using
+gtk_search_bar_set_entry().
+
+Since: 3.10
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GtkSearchBar
+
+</return>
+</function>
+
+<function name="gtk_search_bar_set_search_mode">
+<description>
+Switches the search mode on or off.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkSearchBar
+</parameter_description>
+</parameter>
+<parameter name="search_mode">
+<parameter_description> the new state of the search mode
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_search_bar_set_show_close_button">
+<description>
+Shows or hides the close button. Applications that
+already have a "search" toggle button should not show a close
+button in their search bar, as it duplicates the role of the
+toggle button.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="bar">
+<parameter_description> a #GtkSearchBar
+</parameter_description>
+</parameter>
+<parameter name="visible">
+<parameter_description> whether the close button will be shown or not
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_search_entry_new">
<description>
Creates a #GtkSearchEntry, with a find icon when the search field is
@@ -62746,6 +66275,369 @@ Since: 2.20
<return></return>
</function>
+<function name="gtk_stack_add_named">
+<description>
+Adds a child to @stack.
+The child is identified by the @name.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> the widget to add
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name for @child
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_stack_add_titled">
+<description>
+Adds a child to @stack.
+The child is identified by the @name. The @title
+will be used by #GtkStackSwitcher to represent
+ child in a tab bar, so it should be short.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> the widget to add
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name for @child
+</parameter_description>
+</parameter>
+<parameter name="title">
+<parameter_description> a human-readable title for @child
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_stack_get_homogeneous">
+<description>
+Gets whether @stack is homogeneous.
+See gtk_stack_set_homogeneous().
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether @stack is homogeneous.
+
+</return>
+</function>
+
+<function name="gtk_stack_get_transition_duration">
+<description>
+Returns the amount of time (in milliseconds) that
+transitions between pages in @stack will take.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+</parameters>
+<return> the transition duration
+
+</return>
+</function>
+
+<function name="gtk_stack_get_transition_type">
+<description>
+Gets the type of animation that will be used
+for transitions between pages in @stack.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+</parameters>
+<return> the current transition type of @stack
+
+</return>
+</function>
+
+<function name="gtk_stack_get_visible_child">
+<description>
+Gets the currently visible child of @stack, or %NULL if
+there are no visible children.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+</parameters>
+<return> the visible child of the #GtkStack
+
+</return>
+</function>
+
+<function name="gtk_stack_get_visible_child_name">
+<description>
+Returns the name of the currently visible child of @stack, or
+%NULL if there is no visible child.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+</parameters>
+<return> the name of the visible child of the #GtkStack
+
+</return>
+</function>
+
+<function name="gtk_stack_new">
+<description>
+Creates a new #GtkStack container.
+
+Since: 3.10
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GtkStack
+
+</return>
+</function>
+
+<function name="gtk_stack_set_homogeneous">
+<description>
+Sets the #GtkStack to be homogeneous or not. If it
+is homogeneous, the #GtkStack will request the same
+size for all its children. If it isn't, the stack
+may change size when a different child becomes visible.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+<parameter name="homogeneous">
+<parameter_description> %TRUE to make @stack homogeneous
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_stack_set_transition_duration">
+<description>
+Sets the duration that transitions between pages in @stack
+will take.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+<parameter name="duration">
+<parameter_description> the new duration, in milliseconds
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_stack_set_transition_type">
+<description>
+Sets the type of animation that will be used for
+transitions between pages in @stack. Available
+types include various kinds of fades and slides.
+
+The transition type can be changed without problems
+at runtime, so it is possible to change the animation
+based on the page that is about to become current.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+<parameter name="transition">
+<parameter_description> the new transition type
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_stack_set_visible_child">
+<description>
+Makes @child the visible child of @stack.
+
+If @child is different from the currently
+visible child, the transition between the
+two will be animated with the current
+transition type of @stack.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> a child of @stack
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_stack_set_visible_child_full">
+<description>
+Makes the child with the given name visible.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of the child to make visible
+</parameter_description>
+</parameter>
+<parameter name="transition">
+<parameter_description> the transition type to use
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_stack_set_visible_child_name">
+<description>
+Makes the child with the given name visible.
+
+If @child is different from the currently
+visible child, the transition between the
+two will be animated with the current
+transition type of @stack.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of the child to make visible
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_stack_switcher_get_stack">
+<description>
+Retrieves the stack.
+See gtk_stack_switcher_set_stack().
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="switcher">
+<parameter_description> a #GtkStackSwitcher
+</parameter_description>
+</parameter>
+</parameters>
+<return> the stack, or %NULL if
+none has been set explicitly.
+
+</return>
+</function>
+
+<function name="gtk_stack_switcher_new">
+<description>
+Create a new #GtkStackSwitcher.
+
+Since: 3.10
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GtkStackSwitcher.
+
+</return>
+</function>
+
+<function name="gtk_stack_switcher_set_stack">
+<description>
+Sets the stack to control.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="switcher">
+<parameter_description> a #GtkStackSwitcher
+</parameter_description>
+</parameter>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_status_icon_get_geometry">
<description>
Obtains information about the location of the status icon
@@ -62934,6 +66826,8 @@ be freed or modified.
Since: 2.10
+Deprecated: 3.10: Use gtk_status_icon_get_icon_name() instead.
+
</description>
<parameters>
<parameter name="status_icon">
@@ -63196,6 +67090,8 @@ gtk_icon_factory_add().
Since: 2.10
+Deprecated: 3.10: Use gtk_status_icon_new_from_icon_name() instead.
+
</description>
<parameters>
<parameter name="stock_id">
@@ -63333,7 +67229,9 @@ Since: 2.10
Makes @status_icon display the stock icon with the id @stock_id.
See gtk_status_icon_new_from_stock() for details.
-Since: 2.10
+Since: 2.10
+
+Deprecated: 3.10: Use gtk_status_icon_set_from_icon_name() instead.
</description>
<parameters>
@@ -63667,6 +67565,7 @@ any pointer into @items and @items can be freed. Use
gtk_stock_add_static() if @items is persistent and GTK+ need not
copy the array.
+Deprecated: 3.10
</description>
<parameters>
@@ -63687,6 +67586,7 @@ copy the array.
Same as gtk_stock_add(), but doesn't copy @items, so
@items must persist until application exit.
+Deprecated: 3.10
</description>
<parameters>
@@ -63706,6 +67606,7 @@ Same as gtk_stock_add(), but doesn't copy @items, so
<description>
Copies a stock item, mostly useful for language bindings and not in applications.
+Deprecated: 3.10
</description>
<parameters>
@@ -63715,6 +67616,7 @@ Copies a stock item, mostly useful for language bindings and not in applications
</parameter>
</parameters>
<return> a new #GtkStockItem
+
</return>
</function>
@@ -63724,6 +67626,7 @@ Frees a stock item allocated on the heap, such as one returned by
gtk_stock_item_copy(). Also frees the fields inside the stock item,
if they are not %NULL.
+Deprecated: 3.10
</description>
<parameters>
@@ -63741,11 +67644,13 @@ Retrieves a list of all known stock IDs added to a #GtkIconFactory
or registered with gtk_stock_add(). The list must be freed with g_slist_free(),
and each string in the list must be freed with g_free().
+Deprecated: 3.10
</description>
<parameters>
</parameters>
<return> a list of known stock IDs
+
</return>
</function>
@@ -63754,7 +67659,7 @@ and each string in the list must be freed with g_free().
Fills @item with the registered values for @stock_id, returning %TRUE
if @stock_id was known.
-
+Deprecated: 3.10
</description>
<parameters>
@@ -63768,6 +67673,7 @@ if @stock_id was known.
</parameter>
</parameters>
<return> %TRUE if @item was initialized
+
</return>
</function>
@@ -63810,6 +67716,8 @@ gtk_stock_set_translate_func ("even-item-domain", my_translate_func, &
Since: 2.8
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="domain">
@@ -64279,6 +68187,7 @@ Since: 3.8
</parameters>
<return> a #GdkFrameClock, or %NULL
if @context does not have an attached frame clock.
+
</return>
</function>
@@ -64418,6 +68327,24 @@ Since: 3.0
<return></return>
</function>
+<function name="gtk_style_context_get_scale">
+<description>
+Returns the scale used for assets.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="context">
+<parameter_description> a #GtkStyleContext
+</parameter_description>
+</parameter>
+</parameters>
+<return> the scale
+
+</return>
+</function>
+
<function name="gtk_style_context_get_screen">
<description>
Returns the #GdkScreen to which @context is attached.
@@ -64718,6 +68645,7 @@ Looks up @stock_id in the icon factories associated to @context and
the default icon factory, returning an icon set if found, otherwise
%NULL.
+Deprecated: 3.10: Use gtk_icon_theme_lookup_icon() instead.
</description>
<parameters>
@@ -64731,6 +68659,7 @@ the default icon factory, returning an icon set if found, otherwise
</parameter>
</parameters>
<return> The looked up %GtkIconSet, or %NULL
+
</return>
</function>
@@ -65207,6 +69136,26 @@ Since: 3.0
<return></return>
</function>
+<function name="gtk_style_context_set_scale">
+<description>
+Sets the scale to use when getting image assets for the style .
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="context">
+<parameter_description> a #GtkStyleContext
+</parameter_description>
+</parameter>
+<parameter name="scale">
+<parameter_description> scale
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_style_context_set_screen">
<description>
Attaches @context to the given screen.
@@ -67618,6 +71567,28 @@ Since: 2.14
</return>
</function>
+<function name="gtk_test_widget_wait_for_draw">
+<description>
+Enters the main loop and waits for @widget to be "drawn". In this
+context that means it waits for the frame clock of @widget to have
+run a full styling, layout and drawing cycle.
+
+This function is intended to be used for syncing with actions that
+depend on @widget relayouting or on interaction with the display
+server.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> the widget to wait for
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_text_attributes_copy">
<description>
Copies @src and returns a new #GtkTextAttributes.
@@ -68323,7 +72294,7 @@ count is cached, so this function is very fast.
<description>
This function returns the list of targets this text buffer can
provide for copying and as DND source. The targets in the list are
-added with %info values from the #GtkTextBufferTargetInfo enum,
+added with @info values from the #GtkTextBufferTargetInfo enum,
using gtk_target_list_add_rich_text_targets() and
gtk_target_list_add_text_targets().
@@ -68636,7 +72607,7 @@ editor.
<description>
This function returns the list of targets this text buffer supports
for pasting and as DND destination. The targets in the list are
-added with %info values from the #GtkTextBufferTargetInfo enum,
+added with @info values from the #GtkTextBufferTargetInfo enum,
using gtk_target_list_add_rich_text_targets() and
gtk_target_list_add_text_targets().
@@ -69370,7 +73341,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> %function's user_data
+<parameter_description> @function's user_data
</parameter_description>
</parameter>
<parameter name="user_data_destroy">
@@ -69639,7 +73610,7 @@ Used to keep track of whether the buffer has been modified since the
last time it was saved. Whenever the buffer is saved to disk, call
gtk_text_buffer_set_modified (@buffer, FALSE). When the buffer is modified,
it will automatically toggled on the modified bit again. When the modified
-bit flips, the buffer emits a "modified-changed" signal.
+bit flips, the buffer emits the #GtkTextBuffer::modified-changed signal.
</description>
<parameters>
@@ -69961,6 +73932,9 @@ moves forward by 0 - @count lines.
<description>
Same as gtk_text_iter_forward_search(), but moves backward.
+ match_end will never be set to a #GtkTextIter located after @iter, even if
+there is a possible @match_start before or at @iter.
+
</description>
<parameters>
@@ -70265,11 +74239,14 @@ Calls gtk_text_iter_backward_word_start() up to @count times.
<function name="gtk_text_iter_begins_tag">
<description>
Returns %TRUE if @tag is toggled on at exactly this point. If @tag
-is %NULL, returns %TRUE if any tag is toggled on at this point. Note
-that the gtk_text_iter_begins_tag () returns %TRUE if @iter is the
-<emphasis>start</emphasis> of the tagged range;
-gtk_text_iter_has_tag () tells you whether an iterator is
-<emphasis>within</emphasis> a tagged range.
+is %NULL, returns %TRUE if any tag is toggled on at this point.
+
+Note that if gtk_text_iter_begins_tag() returns %TRUE, it means that @iter is
+at the beginning of the tagged range, and that the
+<emphasis>character</emphasis> at @iter is inside the tagged range. In other
+words, unlike gtk_text_iter_ends_tag(), if gtk_text_iter_begins_tag() returns
+%TRUE, gtk_text_iter_has_tag() will also return %TRUE for the same
+parameters.
</description>
@@ -70430,11 +74407,13 @@ algorithms).
<function name="gtk_text_iter_ends_tag">
<description>
Returns %TRUE if @tag is toggled off at exactly this point. If @tag
-is %NULL, returns %TRUE if any tag is toggled off at this point. Note
-that the gtk_text_iter_ends_tag () returns %TRUE if @iter is the
-<emphasis>end</emphasis> of the tagged range;
-gtk_text_iter_has_tag () tells you whether an iterator is
-<emphasis>within</emphasis> a tagged range.
+is %NULL, returns %TRUE if any tag is toggled off at this point.
+
+Note that if gtk_text_iter_ends_tag() returns %TRUE, it means that @iter is
+at the end of the tagged range, but that the <emphasis>character</emphasis>
+at @iter is <emphasis>outside</emphasis> the tagged range. In other words,
+unlike gtk_text_iter_begins_tag(), if gtk_text_iter_ends_tag() returns %TRUE,
+gtk_text_iter_has_tag() will return %FALSE for the same parameters.
</description>
@@ -70449,7 +74428,6 @@ gtk_text_iter_has_tag () tells you whether an iterator is
</parameter>
</parameters>
<return> whether @iter is the end of a range tagged with @tag
-
</return>
</function>
@@ -70674,15 +74652,8 @@ first character after the match. The search will not continue past
may wish to use @limit to avoid locking up your UI on large
buffers.
-If the #GTK_TEXT_SEARCH_VISIBLE_ONLY flag is present, the match may
-have invisible text interspersed in @str. i.e. @str will be a
-possibly-noncontiguous subsequence of the matched range. similarly,
-if you specify #GTK_TEXT_SEARCH_TEXT_ONLY, the match may have
-pixbufs or child widgets mixed inside the matched range. If these
-flags are not given, the match must be exact; the special 0xFFFC
-character in @str will match embedded pixbufs or child widgets.
-If you specify the #GTK_TEXT_SEARCH_CASE_INSENSITIVE flag, the text will
-be matched regardless of what case it is in.
+ match_start will never be set to a #GtkTextIter located before @iter, even if
+there is a possible @match_end after or at @iter.
</description>
@@ -70708,7 +74679,7 @@ be matched regardless of what case it is in.
</parameter_description>
</parameter>
<parameter name="limit">
-<parameter_description> bound for the search, or %NULL for the end of the buffer
+<parameter_description> location of last possible @match_end, or %NULL for the end of the buffer
</parameter_description>
</parameter>
</parameters>
@@ -71100,12 +75071,12 @@ including the paragraph delimiters.
<function name="gtk_text_iter_get_char">
<description>
-Returns the Unicode character at this iterator. (Equivalent to
+The Unicode character at this iterator is returned. (Equivalent to
operator* on a C++ iterator.) If the element at this iterator is a
non-character element, such as an image embedded in the buffer, the
Unicode "unknown" character 0xFFFC is returned. If invoked on
the end iterator, zero is returned; zero is not a valid Unicode character.
-So you can write a loop which ends when gtk_text_iter_get_char ()
+So you can write a loop which ends when gtk_text_iter_get_char()
returns 0.
@@ -71467,7 +75438,8 @@ Invisible text is usually invisible because a #GtkTextTag with the
<function name="gtk_text_iter_has_tag">
<description>
-Returns %TRUE if @iter is within a range tagged with @tag.
+Returns %TRUE if @iter points to a character that is part of a range tagged
+with @tag. See also gtk_text_iter_begins_tag() and gtk_text_iter_ends_tag().
</description>
@@ -72633,9 +76605,10 @@ default.
<function name="gtk_text_tag_table_remove">
<description>
-Remove a tag from the table. This will remove the table's
-reference to the tag, so be careful - the tag will end
-up destroyed if you don't have a reference to it.
+Remove a tag from the table. If a #GtkTextBuffer has @table as its tag table,
+the tag is removed from the buffer. The table's reference to the tag is
+removed, so the tag will end up destroyed if you don't have a reference to
+it.
</description>
<parameters>
@@ -74815,6 +78788,8 @@ Returns the checked state of the toggle action.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action">
@@ -74833,6 +78808,8 @@ Returns whether the action should have proxies like a radio action.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action">
@@ -74853,6 +78830,8 @@ call gtk_action_group_add_action_with_accel().
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="name">
@@ -74885,6 +78864,8 @@ Sets the checked state on the toggle action.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action">
@@ -74905,6 +78886,8 @@ Sets whether the action should have proxies like a radio action.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action">
@@ -74926,6 +78909,8 @@ Emits the "toggled" signal on the toggle action.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="action">
@@ -75165,6 +79150,8 @@ It is an error if @stock_id is not a name of a stock item.
Since: 2.4
+Deprecated: 3.10: Use gtk_toggle_tool_button_new() instead.
+
</description>
<parameters>
<parameter name="stock_id">
@@ -75286,6 +79273,8 @@ The returned string is owned by GTK+ and must not be freed or modifed.
Since: 2.4
+Deprecated: 3.10: Use gtk_tool_button_get_icon_name() instead.
+
</description>
<parameters>
<parameter name="button">
@@ -75351,6 +79340,8 @@ It is an error if @stock_id is not a name of a stock item.
Since: 2.4
+Deprecated: 3.10: Use gtk_tool_button_new() instead.
+
</description>
<parameters>
<parameter name="stock_id">
@@ -75465,6 +79456,8 @@ overridden by non-%NULL "label" and "icon_widget" properties
Since: 2.4
+Deprecated: 3.10: Use gtk_tool_button_set_icon_name() instead.
+
</description>
<parameters>
<parameter name="button">
@@ -77562,6 +81555,8 @@ by @size. If @stock_id is %NULL, the image will be hidden.
Since: 2.12
+Deprecated: 3.10: Use gtk_tooltip_set_icon_from_icon_name() instead.
+
</description>
<parameters>
<parameter name="tooltip">
@@ -78811,6 +82806,47 @@ i.e. @new_order<literal>[newpos] = oldpos</literal>
<return></return>
</function>
+<function name="gtk_tree_model_rows_reordered_with_length">
+<description>
+Emits the #GtkTreeModel::rows-reordered signal on @tree_model.
+
+This should be called by models when their rows have been
+reordered.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="tree_model">
+<parameter_description> a #GtkTreeModel
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> a #GtkTreePath pointing to the tree node whose children
+have been reordered
+</parameter_description>
+</parameter>
+<parameter name="iter">
+<parameter_description> a valid #GtkTreeIter pointing to the node
+whose children have been reordered, or %NULL if the depth
+of @path is 0
+</parameter_description>
+</parameter>
+<parameter name="new_order">
+<parameter_description> an array of integers
+mapping the current position of each child to its old
+position before the re-ordering,
+i.e. @new_order<literal>[newpos] = oldpos</literal>
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> length of @new_order array
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_tree_model_sort_clear_cache">
<description>
This function should almost never be called. It clears the @tree_model_sort
@@ -84566,6 +88602,8 @@ before or after this item, depending on @top.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -84608,6 +88646,8 @@ merges it with the current contents of @manager.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -84637,6 +88677,8 @@ merges it with the current contents of @manager.
Since: 3.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -84667,6 +88709,8 @@ element is added if it is missing.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -84713,6 +88757,8 @@ gtk_widget_show (window);
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -84729,6 +88775,8 @@ Returns the #GtkAccelGroup associated with @manager.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -84748,6 +88796,8 @@ for more information about paths.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -84771,6 +88821,8 @@ Returns the list of action groups associated with @manager.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -84813,6 +88865,8 @@ Obtains a list of all toplevel widgets of the requested types.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -84838,6 +88892,8 @@ Creates a <link linkend="XML-UI">UI definition</link> of t
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -84869,6 +88925,8 @@ destruction of the ui manager.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -84898,6 +88956,8 @@ list.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -84922,6 +88982,8 @@ Creates a new ui manager object.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
</parameters>
@@ -84937,6 +88999,8 @@ gtk_ui_manager_add_ui().
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -84956,6 +89020,8 @@ with @manager.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -84976,6 +89042,8 @@ Unmerges the part of @manager<!-- -->s content identified by @merge_id.
Since: 2.4
+Deprecated: 3.10
+
</description>
<parameters>
<parameter name="manager">
@@ -85468,10 +89536,10 @@ Since: 2.4
<function name="gtk_widget_add_tick_callback">
<description>
-Queues a animation frame update and adds a callback to be called
+Queues an animation frame update and adds a callback to be called
before each frame. Until the tick callback is removed, it will be
called frequently (usually at the frame rate of the output device
-or as quickly as the application an be repainted, whichever is
+or as quickly as the application can be repainted, whichever is
slower). For this reason, is most suitable for handling graphics
that change every frame or every few frames. The tick callback does
not automatically imply a relayout or repaint. If you want a
@@ -85607,6 +89675,233 @@ class of @widget<!-- -->'s parent
<return></return>
</function>
+<function name="gtk_widget_class_bind_template_callback">
+<description>
+Binds a callback function defined in a template to the @widget_class.
+
+This macro is a convenience wrapper around the
+gtk_widget_class_bind_template_callback_full() function.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="widget_class">
+<parameter_description> a #GtkWidgetClass
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> the callback symbol
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_widget_class_bind_template_callback_full">
+<description>
+Declares a @callback_symbol to handle @callback_name from the template XML
+defined for @widget_type. See gtk_builder_add_callback_symbol().
+
+<note><para>This must be called from a composite widget classes class
+initializer after calling gtk_widget_class_set_template()</para></note>
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="widget_class">
+<parameter_description> A #GtkWidgetClass
+</parameter_description>
+</parameter>
+<parameter name="callback_name">
+<parameter_description> The name of the callback as expected in the template XML
+</parameter_description>
+</parameter>
+<parameter name="callback_symbol">
+<parameter_description> The callback symbol
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_widget_class_bind_template_child">
+<description>
+Binds a child widget defined in a template to the @widget_class.
+
+This macro is a convenience wrapper around the
+gtk_widget_class_bind_template_child_full() function.
+
+This macro will use the offset of the @member_name inside the @TypeName
+instance structure.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="widget_class">
+<parameter_description> a #GtkWidgetClass
+</parameter_description>
+</parameter>
+<parameter name="TypeName">
+<parameter_description> the type name of this widget
+</parameter_description>
+</parameter>
+<parameter name="member_name">
+<parameter_description> name of the instance member in the instance struct for @data_type
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_widget_class_bind_template_child_internal">
+<description>
+Binds a child widget defined in a template to the @widget_class, and
+also makes it available as an internal child in GtkBuilder, under the
+name @member_name.
+
+This macro is a convenience wrapper around the
+gtk_widget_class_bind_template_child_full() function.
+
+This macro will use the offset of the @member_name inside the @TypeName
+instance structure.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="widget_class">
+<parameter_description> a #GtkWidgetClass
+</parameter_description>
+</parameter>
+<parameter name="TypeName">
+<parameter_description> the type name, in CamelCase
+</parameter_description>
+</parameter>
+<parameter name="member_name">
+<parameter_description> name of the instance member in the instance struct for @data_type
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_widget_class_bind_template_child_internal_private">
+<description>
+Binds a child widget defined in a template to the @widget_class, and
+also makes it available as an internal child in GtkBuilder, under the
+name @member_name.
+
+This macro is a convenience wrapper around the
+gtk_widget_class_bind_template_child_full() function.
+
+This macro will use the offset of the @member_name inside the @TypeName
+private data structure.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="widget_class">
+<parameter_description> a #GtkWidgetClass
+</parameter_description>
+</parameter>
+<parameter name="TypeName">
+<parameter_description> the type name, in CamelCase
+</parameter_description>
+</parameter>
+<parameter name="member_name">
+<parameter_description> name of the instance private member on the private struct for @data_type
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_widget_class_bind_template_child_private">
+<description>
+Binds a child widget defined in a template to the @widget_class.
+
+This macro is a convenience wrapper around the
+gtk_widget_class_bind_template_child_full() function.
+
+This macro will use the offset of the @member_name inside the @TypeName
+private data structure (it uses G_PRIVATE_OFFSET(), so the private struct
+must be added with G_ADD_PRIVATE()).
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="widget_class">
+<parameter_description> a #GtkWidgetClass
+</parameter_description>
+</parameter>
+<parameter name="TypeName">
+<parameter_description> the type name of this widget
+</parameter_description>
+</parameter>
+<parameter name="member_name">
+<parameter_description> name of the instance private member in the private struct for @data_type
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_widget_class_bind_template_child_private_full">
+<description>
+Automatically assign an object declared in the class template XML to be set to a location
+on a freshly built instance's private data, or alternatively accessible via gtk_widget_get_automated_child().
+
+The struct can point either into the public instance, then you should use G_STRUCT_OFFSET(WidgetType, member)
+for @struct_offset, or in the private struct, then you should use G_PRIVATE_OFFSET(WidgetType, member).
+
+An explicit strong reference will be held automatically for the duration of your
+instance's life cycle, it will be released automatically when #GObjectClass.dispose() runs
+on your instance and if a @struct_offset that is >= 0 is specified, then the automatic location
+in your instance private data will be set to %NULL. You can however access an automated child
+pointer the first time your classes #GObjectClass.dispose() runs, or alternatively in
+#GtkWidgetClass.destroy().
+
+If @internal_child is specified, #GtkBuildableIface.get_internal_child() will be automatically
+implemented by the #GtkWidget class so there is no need to implement it manually.
+
+The wrapper macros gtk_widget_class_bind_template_child(), gtk_widget_class_bind_template_child_internal(),
+gtk_widget_class_bind_template_child_private() and gtk_widget_class_bind_private_template_child_internal()
+might be more convenient to use.
+
+<note><para>This must be called from a composite widget classes class
+initializer after calling gtk_widget_class_set_template()</para></note>
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="widget_class">
+<parameter_description> A #GtkWidgetClass
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The "id" of the child defined in the template XML
+</parameter_description>
+</parameter>
+<parameter name="internal_child">
+<parameter_description> Whether the child should be accessible as an "internal-child"
+when this class is used in GtkBuilder XML
+</parameter_description>
+</parameter>
+<parameter name="struct_offset">
+<parameter_description> The structure offset into the composite widget's instance public or private structure
+where the automated child pointer should be set, or -1 to not assign the pointer.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_widget_class_find_style_property">
<description>
Finds a style property of a widget class by name.
@@ -85784,6 +90079,88 @@ Since: 3.2
<return></return>
</function>
+<function name="gtk_widget_class_set_connect_func">
+<description>
+For use in lanuage bindings, this will override the default #GtkBuilderConnectFunc to be
+used when parsing GtkBuilder xml from this class's template data.
+
+<note><para>This must be called from a composite widget classes class
+initializer after calling gtk_widget_class_set_template()</para></note>
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="widget_class">
+<parameter_description> A #GtkWidgetClass
+</parameter_description>
+</parameter>
+<parameter name="connect_func">
+<parameter_description> The #GtkBuilderConnectFunc to use when connecting signals in the class template
+</parameter_description>
+</parameter>
+<parameter name="connect_data">
+<parameter_description> The data to pass to @connect_func
+</parameter_description>
+</parameter>
+<parameter name="connect_data_destroy">
+<parameter_description> The #GDestroyNotify to free @connect_data, this will only be used at
+class finalization time, when no classes of type @widget_type are in use anymore.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_widget_class_set_template">
+<description>
+This should be called at class initialization time to specify
+the GtkBuilder XML to be used to extend a widget.
+
+For convenience, gtk_widget_class_set_template_from_resource() is also provided.
+
+<note><para>Any class that installs templates must call gtk_widget_init_template()
+in the widget's instance initializer</para></note>
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="widget_class">
+<parameter_description> A #GtkWidgetClass
+</parameter_description>
+</parameter>
+<parameter name="template_bytes">
+<parameter_description> A #GBytes holding the #GtkBuilder XML
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_widget_class_set_template_from_resource">
+<description>
+A convenience function to call gtk_widget_class_set_template().
+
+<note><para>Any class that installs templates must call gtk_widget_init_template()
+in the widget's instance initializer</para></note>
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="widget_class">
+<parameter_description> A #GtkWidgetClass
+</parameter_description>
+</parameter>
+<parameter name="resource_name">
+<parameter_description> The name of the resource to load the template from
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_widget_common_ancestor">
<description>
Find the common ancestor of @widget_a and @widget_b that
@@ -86113,6 +90490,27 @@ library contains more information about accessible objects and their uses.
</return>
</function>
+<function name="gtk_widget_get_allocated_baseline">
+<description>
+Returns the baseline that has currently been allocated to @widget.
+This function is intended to be used when implementing handlers
+for the #GtkWidget::draw function, and when allocating child
+widgets in #GtkWidget::size_allocate.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> the widget to query
+</parameter_description>
+</parameter>
+</parameters>
+<return> the baseline of the @widget, or -1 if none
+
+</return>
+</function>
+
<function name="gtk_widget_get_allocated_height">
<description>
Returns the height that has currently been allocated to @widget.
@@ -86366,6 +90764,7 @@ been created, it is persistent for all time.
<description>
Obtains the composite name of a widget.
+Deprecated: 3.10: Use gtk_widget_class_set_template(), or don't use this API at all.
</description>
<parameters>
@@ -86377,6 +90776,7 @@ Obtains the composite name of a widget.
<return> the composite name of @widget, or %NULL if @widget is not
a composite child. The string should be freed when it is no
longer needed.
+
</return>
</function>
@@ -86559,7 +90959,7 @@ change the widget's frame clock.
Unrealized widgets do not have a frame clock.
-Since: 3.0
+Since: 3.8
</description>
<parameters>
@@ -87017,6 +91417,50 @@ Since: 3.0
<return></return>
</function>
+<function name="gtk_widget_get_preferred_height_and_baseline_for_width">
+<description>
+Retrieves a widget's minimum and natural height and the corresponding baselines if it would be given
+the specified @width, or the default height if @width is -1. The baselines may be -1 which means
+that no baseline is requested for this widget.
+
+The returned request will be modified by the
+GtkWidgetClass::adjust_size_request and GtkWidgetClass::adjust_baseline_request virtual methods
+and by any #GtkSizeGroup<!-- -->s 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.10
+
+</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, or -1 if none
+</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>
+<parameter name="minimum_baseline">
+<parameter_description> location for storing the baseline for the minimum height, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="natural_baseline">
+<parameter_description> location for storing the baseline for 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
@@ -87067,6 +91511,9 @@ widget will generally be a smaller size than the minimum height, since the requi
height for the natural width is generally smaller than the required height for
the minimum width.</para></note>
+Use gtk_widget_get_preferred_size_and_baseline() if you want to support
+baseline alignment.
+
Since: 3.0
</description>
@@ -87464,6 +91911,36 @@ gtk_widget_set_support_multidevice() for more information.
</return>
</function>
+<function name="gtk_widget_get_template_child">
+<description>
+Fetch an object build from the template XML for @widget_type in this @widget instance.
+
+This will only report children which were previously declared with
gtk_widget_class_bind_template_child_private_full() or one of its variants.
+
+This function is only meant to be called for code which is private to the @widget_type which
+declared the child and is meant for language bindings which cannot easily make use
+of the GObject structure offsets.
+
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> A #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="widget_type">
+<parameter_description> The #GType to get a template child for
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The "id" of the child defined in the template XML
+</parameter_description>
+</parameter>
+</parameters>
+<return> The object built in the template XML with the id @name
+</return>
+</function>
+
<function name="gtk_widget_get_tooltip_markup">
<description>
Gets the contents of the tooltip for @widget.
@@ -87566,6 +92043,29 @@ if there's no ancestor.
<description>
Gets the value of the #GtkWidget:valign property.
+For backwards compatibility reasons this method will never return
+%GTK_ALIGN_BASELINE, but instead it will convert it to
+%GTK_ALIGN_FILL. If your widget want to support baseline aligned
+children it must use gtk_widget_get_valign_with_baseline().
+
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return> the vertical alignment of @widget, ignoring baseline alignment
+</return>
+</function>
+
+<function name="gtk_widget_get_valign_with_baseline">
+<description>
+Gets the value of the #GtkWidget:valign property, including
+%GTK_ALIGN_BASELINE.
+
+Since: 3.10
</description>
<parameters>
@@ -87575,6 +92075,7 @@ Gets the value of the #GtkWidget:valign property.
</parameter>
</parameters>
<return> the vertical alignment of @widget
+
</return>
</function>
@@ -87904,6 +92405,37 @@ unnecessary work.
</return>
</function>
+<function name="gtk_widget_init_template">
+<description>
+Creates and initializes child widgets defined in templates. This
+function must be called in the instance initializer for any
+class which assigned itself a template using gtk_widget_class_set_template()
+
+It is important to call this function in the instance initializer
+of a #GtkWidget subclass and not in #GObject.constructed() or
+#GObject.constructor() for two reasons.
+
+One reason is that generally derived widgets will assume that parent
+class composite widgets have been created in their instance
+initializers.
+
+Another reason is that when calling g_object_new() on a widget with
+composite templates, it's important to build the composite widgets
+before the construct properties are set. Properties passed to g_object_new()
+should take precedence over properties set in the private template XML.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_widget_input_shape_combine_region">
<description>
Sets an input shape for this widget's GDK window. This allows for
@@ -88147,11 +92679,7 @@ gtk_widget_child_focus() on the widget's toplevel.
The default ::keynav-failed handler returns %TRUE for
%GTK_DIR_TAB_FORWARD and %GTK_DIR_TAB_BACKWARD. For the other
-values of #GtkDirectionType, it looks at the
-#GtkSettings:gtk-keynav-cursor-only setting and returns %FALSE
-if the setting is %TRUE. This way the entire user interface
-becomes cursor-navigatable on input devices such as mobile phones
-which only have cursor keys but no tab key.
+values of #GtkDirectionType it returns %FALSE.
Whenever the default handler returns %TRUE, it also calls
gtk_widget_error_bell() to notify the user of the failed keyboard
@@ -89556,6 +94084,8 @@ Since: 3.2
<description>
Cancels the effect of a previous call to gtk_widget_push_composite_child().
+Deprecated: 3.10: Use gtk_widget_class_set_template(), or don't use this API at all.
+
</description>
<parameters>
</parameters>
@@ -89584,6 +94114,9 @@ GTK_WIDGET (scrolled_window));
g_object_ref (scrolled_window->hscrollbar);
]|
+Deprecated: 3.10: This API never really worked well and was mostly unused, now
+we have a more complete mechanism for composite children, see gtk_widget_class_set_template().
+
</description>
<parameters>
</parameters>
@@ -89662,12 +94195,12 @@ defined as @widget->window coordinates for widgets that are not
<function name="gtk_widget_queue_draw_region">
<description>
-Invalidates the rectangular area of @widget defined by @region by
-calling gdk_window_invalidate_region() on the widget's window and
-all its child windows. Once the main loop becomes idle (after the
-current batch of events has been processed, roughly), the window
-will receive expose events for the union of all regions that have
-been invalidated.
+Invalidates the area of @widget defined by @region by calling
+gdk_window_invalidate_region() on the widget's window and all its
+child windows. Once the main loop becomes idle (after the current
+batch of events has been processed, roughly), the window will
+receive expose events for the union of all regions that have been
+invalidated.
Normally you would only use this function in widget
implementations. You might also use it to schedule a redraw of a
@@ -89791,7 +94324,7 @@ window of @widget->window for widgets with their own window.
<function name="gtk_widget_register_window">
<description>
Registers a #GdkWindow with the widget and sets it up so that
-the widget recieves events for it. Call gtk_widget_unregister_window()
+the widget receives events for it. Call gtk_widget_unregister_window()
when destroying the window.
Before 3.8 you needed to call gdk_window_set_user_data() directly to set
@@ -89946,6 +94479,8 @@ after use with g_object_unref().
Since: 3.0
+Deprecated: 3.10: Use gtk_icon_theme_load_icon() instead.
+
</description>
<parameters>
<parameter name="widget">
@@ -90283,6 +94818,8 @@ never should be called by an application.
Sets a widgets composite name. The widget must be
a composite child of its parent; see gtk_widget_push_composite_child().
+Deprecated: 3.10: Use gtk_widget_class_set_template(), or don't use this API at all.
+
</description>
<parameters>
<parameter name="widget">
@@ -90425,6 +94962,9 @@ expose events, since even the clearing to the background color or
pixmap will not happen automatically (as it is done in
gdk_window_begin_paint_region()).
+Since 3.10 this function only works for widgets with native
+windows.
+
</description>
<parameters>
<parameter name="widget">
@@ -91413,6 +95953,9 @@ method on the child will be used to adjust the allocation. Standard
adjustments include removing the widget's margins, and applying the
widget's #GtkWidget:halign and #GtkWidget:valign properties.
+For baseline support in containers you need to use gtk_widget_size_allocate_with_baseline()
+instead.
+
</description>
<parameters>
<parameter name="widget">
@@ -91427,6 +95970,42 @@ widget's #GtkWidget:halign and #GtkWidget:valign properties.
<return></return>
</function>
+<function name="gtk_widget_size_allocate_with_baseline">
+<description>
+This function is only used by #GtkContainer subclasses, to assign a size,
+position and (optionally) baseline to their child widgets.
+
+In this function, the allocation and baseline may be adjusted. It
+will be forced to a 1x1 minimum size, and the
+adjust_size_allocation virtual and adjust_baseline_allocation
+methods on the child will be used to adjust the allocation and
+baseline. Standard adjustments include removing the widget's
+margins, and applying the widget's #GtkWidget:halign and
+#GtkWidget:valign properties.
+
+If the child widget does not have a valign of %GTK_ALIGN_BASELINE the
+baseline argument is ignored and -1 is used instead.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="allocation">
+<parameter_description> position and size to be allocated to @widget
+</parameter_description>
+</parameter>
+<parameter name="baseline">
+<parameter_description> The baseline of the child, or -1
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_widget_size_request">
<description>
This function is typically used when implementing a #GtkContainer
@@ -91834,7 +96413,6 @@ linkend="gtk-X11-arch">window manager</link> or windowing
system. Otherwise, GDK will try to emulate window movement,
potentially not all that well, depending on the windowing system.
-
</description>
<parameters>
<parameter name="window">
@@ -91870,7 +96448,6 @@ linkend="gtk-X11-arch">window manager</link> or windowing
system. Otherwise, GDK will try to emulate window resizing,
potentially not all that well, depending on the windowing system.
-
</description>
<parameters>
<parameter name="window">
@@ -91901,6 +96478,26 @@ potentially not all that well, depending on the windowing system.
<return></return>
</function>
+<function name="gtk_window_close">
+<description>
+Requests that the window is closed, similar to what happens
+when a window manager close button is clicked.
+
+This function can be used with close buttons in custom
+titlebars.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GtkWindow
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_window_deiconify">
<description>
Asks to deiconify (i.e. unminimize) the specified @window. Note
@@ -93284,6 +97881,10 @@ Hides @window, then reshows it, resetting the
default size and position of the window. Used
by GUI builders only.
+Deprecated: 3.10: GUI builders can call gtk_widget_hide(),
+gtk_widget_unrealize() and then gtk_widget_show() on @window
+themselves, if they still need this functionality.
+
</description>
<parameters>
<parameter name="window">
@@ -94417,6 +99018,32 @@ document filename, for example.
<return></return>
</function>
+<function name="gtk_window_set_titlebar">
+<description>
+Sets a custom titlebar for @window.
+
+If you set a custom titlebar, GTK+ will do its best to convince
+the window manager not to put its own titlebar on the window.
+Depending on the system, this function may not work for a window
+that is already visible, so you set the titlebar before calling
+gtk_widget_show().
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GtkWindow
+</parameter_description>
+</parameter>
+<parameter name="titlebar">
+<parameter_description> the widget to use as titlebar
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_window_set_transient_for">
<description>
Dialog windows should be set transient for the main application
diff --git a/gtk/src/gtk_enums.defs b/gtk/src/gtk_enums.defs
index 1bcc65d..0e42d01 100644
--- a/gtk/src/gtk_enums.defs
+++ b/gtk/src/gtk_enums.defs
@@ -524,6 +524,23 @@
;; Original typedef:
;; typedef enum /*< skip >*/ {
+;; GTK_CSS_IMAGE_EFFECT_NONE,
+;; GTK_CSS_IMAGE_EFFECT_HIGHLIGHT,
+;; GTK_CSS_IMAGE_EFFECT_DIM
+;; } GtkCssImageEffect;
+
+(define-enum-extended CssImageEffect
+ (in-module "Gtk")
+ (c-name "GtkCssImageEffect")
+ (values
+ '("none" "GTK_CSS_IMAGE_EFFECT_NONE" "0")
+ '("highlight" "GTK_CSS_IMAGE_EFFECT_HIGHLIGHT" "1")
+ '("dim" "GTK_CSS_IMAGE_EFFECT_DIM" "2")
+ )
+)
+
+;; Original typedef:
+;; typedef enum /*< skip >*/ {
;; /* relative font sizes */
;; GTK_CSS_FONT_SIZE_SMALLER,
;; GTK_CSS_FONT_SIZE_LARGER,
diff --git a/gtk/src/gtk_methods.defs b/gtk/src/gtk_methods.defs
index 9697dad..118c622 100644
--- a/gtk/src/gtk_methods.defs
+++ b/gtk/src/gtk_methods.defs
@@ -177,6 +177,20 @@
(gtype-id "GTK_TYPE_CELL_RENDERER_TOGGLE")
)
+(define-object Clipboard
+ (in-module "Gtk")
+ (parent "GObject")
+ (c-name "GtkClipboard")
+ (gtype-id "GTK_TYPE_CLIPBOARD")
+)
+
+(define-object ClipboardWayland
+ (in-module "Gtk")
+ (parent "GtkClipboard")
+ (c-name "GtkClipboardWayland")
+ (gtype-id "GTK_TYPE_CLIPBOARD_WAYLAND")
+)
+
(define-object CssComputedValues
(in-module "Gtk")
(parent "GObject")
@@ -1962,6 +1976,17 @@
)
)
+(define-enum CssImageEffect
+ (in-module "Gtk")
+ (c-name "GtkCssImageEffect")
+ (gtype-id "GTK_TYPE_CSS_IMAGE_EFFECT")
+ (values
+ '("none" "GTK_CSS_IMAGE_EFFECT_NONE")
+ '("highlight" "GTK_CSS_IMAGE_EFFECT_HIGHLIGHT")
+ '("dim" "GTK_CSS_IMAGE_EFFECT_DIM")
+ )
+)
+
(define-enum CssFontSize
(in-module "Gtk")
(c-name "GtkCssFontSize")
@@ -6243,6 +6268,15 @@
)
)
+(define-function gtk_button_new_from_icon_name
+ (c-name "gtk_button_new_from_icon_name")
+ (return-type "GtkWidget*")
+ (parameters
+ '("const-gchar*" "icon_name")
+ '("GtkIconSize" "size")
+ )
+)
+
(define-function gtk_button_new_from_stock
(c-name "gtk_button_new_from_stock")
(return-type "GtkWidget*")
@@ -8286,6 +8320,19 @@
+;; From gtkclipboardprivate.h
+
+
+
+;; From gtkclipboard-waylandprivate.h
+
+(define-function gtk_clipboard_wayland_get_type
+ (c-name "gtk_clipboard_wayland_get_type")
+ (return-type "GType")
+)
+
+
+
;; From gtkcolorbutton.h
(define-function gtk_color_button_get_type
@@ -10015,6 +10062,20 @@
)
)
+(define-function gtk_drag_begin_with_coordinates
+ (c-name "gtk_drag_begin_with_coordinates")
+ (return-type "GdkDragContext*")
+ (parameters
+ '("GtkWidget*" "widget")
+ '("GtkTargetList*" "targets")
+ '("GdkDragAction" "actions")
+ '("gint" "button")
+ '("GdkEvent*" "event")
+ '("gint" "x")
+ '("gint" "y")
+ )
+)
+
(define-function gtk_drag_begin
(c-name "gtk_drag_begin")
(return-type "GdkDragContext*")
@@ -11142,6 +11203,21 @@
(return-type "PangoAttrList*")
)
+(define-method set_tabs
+ (of-object "GtkEntry")
+ (c-name "gtk_entry_set_tabs")
+ (return-type "none")
+ (parameters
+ '("PangoTabArray*" "tabs")
+ )
+)
+
+(define-method get_tabs
+ (of-object "GtkEntry")
+ (c-name "gtk_entry_get_tabs")
+ (return-type "PangoTabArray*")
+)
+
;; From gtkentryprivate.h
@@ -12697,6 +12773,21 @@
)
)
+(define-method get_show_close_button
+ (of-object "GtkHeaderBar")
+ (c-name "gtk_header_bar_get_show_close_button")
+ (return-type "gboolean")
+)
+
+(define-method set_show_close_button
+ (of-object "GtkHeaderBar")
+ (c-name "gtk_header_bar_set_show_close_button")
+ (return-type "none")
+ (parameters
+ '("gboolean" "setting")
+ )
+)
+
;; From gtkheaderbarprivate.h
@@ -14563,6 +14654,21 @@
(return-type "gint")
)
+(define-method set_lines
+ (of-object "GtkLabel")
+ (c-name "gtk_label_set_lines")
+ (return-type "none")
+ (parameters
+ '("gint" "lines")
+ )
+)
+
+(define-method get_lines
+ (of-object "GtkLabel")
+ (c-name "gtk_label_get_lines")
+ (return-type "gint")
+)
+
(define-method set_pattern
(of-object "GtkLabel")
(c-name "gtk_label_set_pattern")
@@ -15033,6 +15139,25 @@
(return-type "GType")
)
+(define-method prepend
+ (of-object "GtkListBox")
+ (c-name "gtk_list_box_prepend")
+ (return-type "none")
+ (parameters
+ '("GtkWidget*" "child")
+ )
+)
+
+(define-method insert
+ (of-object "GtkListBox")
+ (c-name "gtk_list_box_insert")
+ (return-type "none")
+ (parameters
+ '("GtkWidget*" "child")
+ '("gint" "position")
+ )
+)
+
(define-method get_selected_row
(of-object "GtkListBox")
(c-name "gtk_list_box_get_selected_row")
@@ -33827,9 +33952,9 @@
(return-type "none")
)
-(define-method get_automated_child
+(define-method get_template_child
(of-object "GtkWidget")
- (c-name "gtk_widget_get_automated_child")
+ (c-name "gtk_widget_get_template_child")
(return-type "GObject*")
(parameters
'("GType" "widget_type")
@@ -33855,9 +33980,9 @@
)
)
-(define-method declare_callback
+(define-method bind_template_callback_full
(of-object "GtkWidgetClass")
- (c-name "gtk_widget_class_declare_callback")
+ (c-name "gtk_widget_class_bind_template_callback_full")
(return-type "none")
(parameters
'("const-gchar*" "callback_name")
@@ -33876,9 +34001,9 @@
)
)
-(define-method automate_child
+(define-method bind_template_child_full
(of-object "GtkWidgetClass")
- (c-name "gtk_widget_class_automate_child")
+ (c-name "gtk_widget_class_bind_template_child_full")
(return-type "none")
(parameters
'("const-gchar*" "name")
diff --git a/gtk/src/gtk_signals.defs b/gtk/src/gtk_signals.defs
index b95842f..e0b0964 100644
--- a/gtk/src/gtk_signals.defs
+++ b/gtk/src/gtk_signals.defs
@@ -950,7 +950,7 @@
(define-property baseline-position
(of-object "GtkBox")
(prop-type "GParamEnum")
- (docs "The position of the baseline aligned widgets if extra space is availible")
+ (docs "The position of the baseline aligned widgets if extra space is available")
(readable #t)
(writable #t)
(construct-only #f)
@@ -3563,6 +3563,15 @@
(construct-only #f)
)
+(define-property tabs
+ (of-object "GtkEntry")
+ (prop-type "GParamBoxed")
+ (docs "A list of tabstop locations to apply to the text of the entry")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
;; From GtkEntryCompletion
(define-signal insert-prefix
@@ -4946,6 +4955,15 @@
(construct-only #f)
)
+(define-property lines
+ (of-object "GtkLabel")
+ (prop-type "GParamInt")
+ (docs "The desired number of lines, when ellipsizing a wrapping label")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
;; From GtkLayout
(define-property width
@@ -6763,6 +6781,44 @@
(construct-only #f)
)
+;; From GtkRevealer
+
+(define-property transition-type
+ (of-object "GtkRevealer")
+ (prop-type "GParamEnum")
+ (docs "The type of animation used to transition")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property transition-duration
+ (of-object "GtkRevealer")
+ (prop-type "GParamUInt")
+ (docs "The animation duration, in milliseconds")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property reveal-child
+ (of-object "GtkRevealer")
+ (prop-type "GParamBoolean")
+ (docs "Whether the container should reveal the child")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property child-revealed
+ (of-object "GtkRevealer")
+ (prop-type "GParamBoolean")
+ (docs "Whether the child is revealed and the animation target reached")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+)
+
;; From GtkScale
(define-signal format-value
@@ -7022,6 +7078,12 @@
;; From GtkSearchEntry
+(define-signal search-changed
+ (of-object "GtkSearchEntry")
+ (return-type "void")
+ (when "last")
+)
+
;; From GtkSeparator
;; From GtkSeparatorToolItem
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
