[gtkmm] Regenerate *_docs.xml
- From: Murray Cumming <murrayc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtkmm] Regenerate *_docs.xml
- Date: Fri, 22 Aug 2014 18:31:13 +0000 (UTC)
commit d4360ec33644d0b73c1509ce1de2d68f897a12a2
Author: Murray Cumming <murrayc murrayc com>
Date: Fri Aug 22 20:01:26 2014 +0200
Regenerate *_docs.xml
gdk/src/gdk_docs.xml | 13 +-
gtk/src/gtk_docs.xml | 689 +++++++++++++++++++++++++++++++++++++++++++-------
2 files changed, 601 insertions(+), 101 deletions(-)
---
diff --git a/gdk/src/gdk_docs.xml b/gdk/src/gdk_docs.xml
index 667d027..d1e642f 100644
--- a/gdk/src/gdk_docs.xml
+++ b/gdk/src/gdk_docs.xml
@@ -3117,11 +3117,6 @@ Creates a Cairo context for drawing to @window.
Note that calling cairo_reset_clip() on the resulting #cairo_t will
produce undefined results, so avoid it at all costs.
-As of GTK+ 3.14, you need to wrap calls to this function with
-gdk_window_begin_paint_region() / gdk_window_begin_paint_rect() and
-gdk_window_end_paint(). Calling it outside of a "paint" will
-result in a warning printed and a dummy surface being returned.
-
Since: 2.8
</description>
@@ -4597,6 +4592,10 @@ Sets a the mode of an input device. The mode controls if the
device is active and whether the device’s range is mapped to the
entire screen or to a single window.
+Note: This is only meaningful for floating devices, master devices (and
+slaves connected to these) drive the pointer cursor, which is not limited
+by the input mode.
+
</description>
<parameters>
@@ -14553,7 +14552,9 @@ expose event handler, you can assume that the exposed area in
#GdkEventExpose has already been cleared to the window background,
is already set as the clip region, and already has a backing store.
Therefore in most cases, application code need not call
-gdk_window_begin_paint_region().
+gdk_window_begin_paint_region(). (You can disable the automatic
+calls around expose events on a widget-by-widget basis by calling
+gtk_widget_set_double_buffered().)
If you call this function multiple times before calling the
matching gdk_window_end_paint(), the backing stores are pushed onto
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index ec08b68..4bb7884 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -2814,6 +2814,25 @@ Since: 2.4
</return>
</signal>
+<signal name="GtkEntryCompletion::no-matches">
+<description>
+Gets emitted when the filter model has zero
+number of rows in completion_complete method.
+(In other words when GtkEntryCompletion is out of
+suggestions)
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> the object which received the signal
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
<enum name="GtkEntryIconPosition">
<description>
Specifies the side of the entry at which an icon is placed.
@@ -5822,7 +5841,6 @@ be full-width/height). If the main child is a
#GtkScrolledWindow, the overlays are placed relative
to its contents.
-Return: %TRUE if the @allocation has been filled
</description>
<parameters>
@@ -5840,7 +5858,8 @@ location for the allocation
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the @allocation has been filled
+</return>
</signal>
<enum name="GtkPackDirection">
@@ -7809,7 +7828,7 @@ Indicated the relief to be drawn around a #GtkButton.
</parameter_description>
</parameter>
<parameter name="GTK_RELIEF_HALF">
-<parameter_description> A half relief.
+<parameter_description> A half relief. Deprecated in 3.14, does the same as @GTK_RELIEF_NORMAL
</parameter_description>
</parameter>
<parameter name="GTK_RELIEF_NONE">
@@ -8302,6 +8321,10 @@ Deprecated: 3.10: This setting is deprecated
<description>
Used to change the appearance of an outline typically provided by a #GtkFrame.
+Note that many themes do not differentiate the appearance of the
+various shadow types: Either their is no visible shadow (@GTK_SHADOW_NONE),
+or there is (any other value).
+
</description>
<parameters>
<parameter name="GTK_SHADOW_NONE">
@@ -8425,6 +8448,31 @@ Determines the direction of a sort.
</parameters>
</enum>
+<signal name="GtkSpinButton::change-value">
+<description>
+The ::change-value signal is a [keybinding signal][GtkBindingSignal]
+which gets emitted when the user initiates a value change.
+
+Applications should not connect to it, but may emit it with
+g_signal_emit_by_name() if they need to control the cursor
+programmatically.
+
+The default bindings for this signal are Up/Down and PageUp and/PageDown.
+
+</description>
+<parameters>
+<parameter name="spin_button">
+<parameter_description> the object on which the signal was emitted
+</parameter_description>
+</parameter>
+<parameter name="scroll">
+<parameter_description> a #GtkScrollType to specify the speed and amount of change
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
<signal name="GtkSpinButton::input">
<description>
The ::input signal can be used to influence the conversion of
@@ -8479,7 +8527,7 @@ return TRUE;
</description>
<parameters>
<parameter name="spin_button">
-<parameter_description> the object which received the signal
+<parameter_description> the object on which the signal was emitted
</parameter_description>
</parameter>
</parameters>
@@ -8487,17 +8535,32 @@ return TRUE;
</return>
</signal>
+<signal name="GtkSpinButton::value-changed">
+<description>
+The ::value-changed signal is emitted when the value represented by
+ spinbutton changes. Also see the #GtkSpinButton::output signal.
+
+</description>
+<parameters>
+<parameter name="spin_button">
+<parameter_description> the object on which the signal was emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
<signal name="GtkSpinButton::wrapped">
<description>
-The wrapped signal is emitted right after the spinbutton wraps
+The ::wrapped signal is emitted right after the spinbutton wraps
from its maximum to minimum value or vice-versa.
Since: 2.10
</description>
<parameters>
-<parameter name="spinbutton">
-<parameter_description> the object which received the signal
+<parameter name="spin_button">
+<parameter_description> the object on which the signal was emitted
</parameter_description>
</parameter>
</parameters>
@@ -8712,6 +8775,10 @@ classes and sometimes uses different names.
<parameter_description> The location the widget points to has already been visited. Since 3.12
</parameter_description>
</parameter>
+<parameter name="GTK_STATE_FLAG_CHECKED">
+<parameter_description> Widget is checked. Since 3.14
+</parameter_description>
+</parameter>
</parameters>
</enum>
@@ -9118,6 +9185,10 @@ Since: 3.14
<parameter_description> the object on which the signal was emitted
</parameter_description>
</parameter>
+<parameter name="state">
+<parameter_description> the new state of the switch
+</parameter_description>
+</parameter>
</parameters>
<return> %TRUE to stop the signal emission
@@ -10005,6 +10076,23 @@ The default bindings for this signal is Insert.
<return></return>
</signal>
+<enum name="GtkTextViewLayer">
+<description>
+Used to reference the parts of #GtkTextView.
+
+</description>
+<parameters>
+<parameter name="GTK_TEXT_VIEW_LAYER_BELOW">
+<parameter_description> The layer rendered below the text (but above the background).
+</parameter_description>
+</parameter>
+<parameter name="GTK_TEXT_VIEW_LAYER_ABOVE">
+<parameter_description> The layer rendered above the text.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<enum name="GtkTextWindowType">
<description>
Used to reference the parts of #GtkTextView.
@@ -12846,34 +12934,40 @@ focused widget of @window.
<return></return>
</signal>
-<signal name="GtkWindow::keys-changed">
+<signal name="GtkWindow::enable-debugging">
<description>
-The ::keys-changed signal gets emitted when the set of accelerators
-or mnemonics that are associated with @window changes.
+The ::enable-debugging signal is a [keybinding signal][GtkBindingSignal]
+which gets emitted when the user enables or disables interactive
+debugging. When @toggle is %TRUE, interactive debugging is toggled
+on or off, when it is %FALSE, the debugger will be pointed at the
+widget under the pointer.
+
+The default bindings for this signal are Ctrl-Shift-I
+and Ctrl-Shift-D.
</description>
<parameters>
<parameter name="window">
-<parameter_description> the window which received the signal
+<parameter_description> the window on which the signal is emitted
+</parameter_description>
+</parameter>
+<parameter name="toggle">
+<parameter_description> toggle the debugger
</parameter_description>
</parameter>
</parameters>
<return></return>
</signal>
-<signal name="GtkWindow::toggle-debugging">
+<signal name="GtkWindow::keys-changed">
<description>
-The ::toggle-debugging signal is a
-[keybinding signal][GtkBindingSignal]
-which gets emitted when the user enables or disables
-interactive debugging.
-
-The default binding for this signal is Ctrl-Shift-I.
+The ::keys-changed signal gets emitted when the set of accelerators
+or mnemonics that are associated with @window changes.
</description>
<parameters>
<parameter name="window">
-<parameter_description> the window on which the signal is emitted
+<parameter_description> the window which received the signal
</parameter_description>
</parameter>
</parameters>
@@ -18208,6 +18302,42 @@ a %NULL-terminated array. Free with g_strfreev() when no longer needed
</return>
</function>
+<function name="gtk_application_get_actions_for_accel">
+<description>
+Returns the list of actions (possibly empty) that @accel maps to.
+Each item in the list is a detailed action name in the usual form.
+
+This might be useful to discover if an accel already exists in
+order to prevent installation of a conflicting accelerator (from
+an accelerator editor or a plugin system, for example). Note that
+having more than one action per accelerator may not be a bad thing
+and might make sense in cases where the actions never appear in the
+same context.
+
+In case there are no actions for a given accelerator, an empty array
+is returned. %NULL is never returned.
+
+It is a programmer error to pass an invalid accelerator string.
+If you are unsure, check it with gtk_accelerator_parse() first.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> a #GtkApplication
+</parameter_description>
+</parameter>
+<parameter name="accel">
+<parameter_description> an accelerator that can be parsed by gtk_accelerator_parse()
+</parameter_description>
+</parameter>
+</parameters>
+<return> a %NULL-terminated array of actions for @accel
+
+</return>
+</function>
+
<function name="gtk_application_get_active_window">
<description>
Gets the “active” window for the application.
@@ -18250,6 +18380,31 @@ Since: 3.4
</return>
</function>
+<function name="gtk_application_get_menu_by_id">
+<description>
+Gets a menu from automatically loaded resources.
+See [Automatic resources][automatic-resources]
+for more information.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> a #GtkApplication
+</parameter_description>
+</parameter>
+<parameter name="id">
+<parameter_description> the id of the menu to look up
+</parameter_description>
+</parameter>
+</parameters>
+<return> Gets the menu with the
+given id from the automatically loaded resources
+
+</return>
+</function>
+
<function name="gtk_application_get_menubar">
<description>
Returns the menu model that has been set with
@@ -18460,6 +18615,57 @@ Since: 3.0
</return>
</function>
+<function name="gtk_application_prefers_app_menu">
+<description>
+Determines if the desktop environment in which the application is
+running would prefer an application menu be shown.
+
+If this function returns %TRUE then the application should call
+gtk_application_set_app_menu() with the contents of an application
+menu, which will be shown by the desktop environment. If it returns
+%FALSE then you should consider using an alternate approach, such as
+a menubar.
+
+The value returned by this function is purely advisory and you are
+free to ignore it. If you call gtk_application_set_app_menu() even
+if the desktop environment doesn't support app menus, then a fallback
+will be provided.
+
+Applications are similarly free not to set an app menu even if the
+desktop environment wants to show one. In that case, a fallback will
+also be created by the desktop environment (GNOME, for example, uses
+a menu with only a "Quit" item in it).
+
+The value returned by this function never changes. Once it returns a
+particular value, it is guaranteed to always return the same value.
+
+You may only call this function after the application has been
+registered and after the base startup handler has run. You're most
+likely to want to use this from your own startup handler. It may
+also make sense to consult this function while constructing UI (in
+activate, open or an action activation handler) in order to determine
+if you should show a gear menu or not.
+
+This function will return %FALSE on Mac OS and a default app menu
+will be created automatically with the "usual" contents of that menu
+typical to most Mac OS applications. If you call
+gtk_application_set_app_menu() anyway, then this menu will be
+replaced with your own.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> a #GtkApplication
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if you should set an app menu
+
+</return>
+</function>
+
<function name="gtk_application_remove_accelerator">
<description>
Removes an accelerator that has been previously added
@@ -21927,17 +22133,19 @@ This will also clear any previously set labels.
<function name="gtk_button_set_relief">
<description>
Sets the relief style of the edges of the given #GtkButton widget.
-Three styles exist, GTK_RELIEF_NORMAL, GTK_RELIEF_HALF, GTK_RELIEF_NONE.
-The default style is, as one can guess, GTK_RELIEF_NORMAL.
+Two styles exist, %GTK_RELIEF_NORMAL and %GTK_RELIEF_NONE.
+The default style is, as one can guess, %GTK_RELIEF_NORMAL.
+The deprecated value %GTK_RELIEF_HALF behaves the same as
+%GTK_RELIEF_NORMAL.
</description>
<parameters>
<parameter name="button">
-<parameter_description> The #GtkButton you want to set relief styles of.
+<parameter_description> The #GtkButton you want to set relief styles of
</parameter_description>
</parameter>
-<parameter name="newstyle">
-<parameter_description> The GtkReliefStyle as described above.
+<parameter name="relief">
+<parameter_description> The GtkReliefStyle as described above
</parameter_description>
</parameter>
</parameters>
@@ -22617,11 +22825,11 @@ Since: 3.14
</description>
<parameters>
-<parameter name="cell_layout">
-<parameter_description> a #GtkCellLayout
+<parameter name="area">
+<parameter_description> a #GtkCellArea
</parameter_description>
</parameter>
-<parameter name="cell">
+<parameter name="renderer">
<parameter_description> a #GtkCellRenderer
</parameter_description>
</parameter>
@@ -30844,40 +31052,40 @@ Since: 3.10
</description>
<parameters>
<parameter name="widget">
-<parameter_description> the source 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.
+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> 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> 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> 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.
+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.
+the current pointer position
</parameter_description>
</parameter>
</parameters>
-<return> the context for this drag.
+<return> the context for this drag
</return>
</function>
@@ -31203,16 +31411,16 @@ icon.
<function name="gtk_drag_set_icon_gicon">
<description>
-Sets the icon for a given drag from the given @icon. See the
-documentation for gtk_drag_set_icon_name() for more details about
-using icons in drag and drop.
+Sets the icon for a given drag from the given @icon.
+See the documentation for gtk_drag_set_icon_name()
+for more details about using icons in drag and drop.
Since: 3.2
</description>
<parameters>
<parameter name="context">
-<parameter_description> the context for a drag. (This must be called
+<parameter_description> the context for a drag (This must be called
with a context for the source side of a drag)
</parameter_description>
</parameter>
@@ -31585,37 +31793,6 @@ to a stock icon.
<return></return>
</function>
-<function name="gtk_drag_update">
-<description>
-Updates the status of the drag; called when the
-cursor moves or the modifier changes
-
-</description>
-<parameters>
-<parameter name="info">
-<parameter_description> DragSourceInfo for the drag
-</parameter_description>
-</parameter>
-<parameter name="screen">
-<parameter_description> new screen
-</parameter_description>
-</parameter>
-<parameter name="x_root">
-<parameter_description> new X position
-</parameter_description>
-</parameter>
-<parameter name="y_root">
-<parameter_description> new y position
-</parameter_description>
-</parameter>
-<parameter name="event">
-<parameter_description> event received requiring update
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="gtk_draw_insertion_cursor">
<description>
Draws a text caret on @cr at @location. This is not a style function
@@ -42178,6 +42355,9 @@ to gtk_icon_theme_lookup_icon().
Since: 2.4
+Deprecated: 3.14: This function is deprecated, use
+gtk_icon_theme_add_resource_path() instead of builtin icons.
+
</description>
<parameters>
<parameter name="icon_info">
@@ -43751,6 +43931,9 @@ via gdk_pixbuf_new_from_inline().
Since: 2.4
+Deprecated: 3.14: Use gtk_icon_theme_add_resource_path()
+to add application-specific icons to the icon theme.
+
</description>
<parameters>
<parameter name="icon_name">
@@ -43770,6 +43953,36 @@ images can be registered for the same icon name at different sizes.)
<return></return>
</function>
+<function name="gtk_icon_theme_add_resource_path">
+<description>
+Adds a resource path that will be looked at when looking
+for icons, similar to search paths.
+
+This function should be used to make application-specific icons
+available as part of the icon theme.
+
+The resources are considered as part of the hicolor icon theme
+and must be located in subdirectories that are defined in the
+hicolor icon theme, such as ` path/16x16/actions/run.png`.
+Icons that are directly placed in the resource path instead
+of a subdirectory are also considered as ultimate fallback.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="icon_theme">
+<parameter_description> a #GtkIconTheme
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> a resource path
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_icon_theme_append_search_path">
<description>
Appends a directory to the search path.
@@ -44494,16 +44707,16 @@ Since: 2.4
Sets the search path for the icon theme object. When looking
for an icon theme, GTK+ will search for a subdirectory of
one or more of the directories in @path with the same name
-as the icon theme. (Themes from multiple of the path elements
-are combined to allow themes to be extended by adding icons
-in the user’s home directory.)
+as the icon theme containing an index.theme file. (Themes from
+multiple of the path elements are combined to allow themes to be
+extended by adding icons in the user’s home directory.)
In addition if an icon found isn’t found either in the current
icon theme or the default icon theme, and an image file with
the right name is found directly in one of the elements of
@path, then that image will be used for the icon name.
(This is legacy feature, and new icons should be put
-into the default icon theme, which is called hicolor,
+into the fallback icon theme, which is called hicolor,
rather than directly on the icon path.)
Since: 2.4
@@ -47145,6 +47358,7 @@ 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.
+Since: 3.10
</description>
<parameters>
@@ -47154,6 +47368,7 @@ surface; you still need to unref it if you own references.
</parameter>
</parameters>
<return> a new #GtkImage
+
</return>
</function>
@@ -49948,6 +50163,25 @@ Since: 3.10
<return></return>
</function>
+<function name="gtk_list_box_row_get_activatable">
+<description>
+Gets the value of the #GtkListBoxRow:activatable property
+for this row.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="row">
+<parameter_description> a #GtkListBoxRow
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the row is activatable
+
+</return>
+</function>
+
<function name="gtk_list_box_row_get_header">
<description>
Returns the current header of the @row. This can be used
@@ -49986,6 +50220,25 @@ Since: 3.10
</return>
</function>
+<function name="gtk_list_box_row_get_selectable">
+<description>
+Gets the value of the #GtkListBoxRow:selectable property
+for this row.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="row">
+<parameter_description> a #GtkListBoxRow
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the row is selectable
+
+</return>
+</function>
+
<function name="gtk_list_box_row_is_selected">
<description>
Returns whether the child is currently selected in its
@@ -50019,6 +50272,26 @@ Since: 3.10
</return>
</function>
+<function name="gtk_list_box_row_set_activatable">
+<description>
+Set the #GtkListBoxRow:activatable property for this row.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="row">
+<parameter_description> a #GTkListBoxrow
+</parameter_description>
+</parameter>
+<parameter name="activatable">
+<parameter_description> %TRUE to mark the row as activatable
+</parameter_description>
+</parameter>
+</parameters>
+<return></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
@@ -50041,6 +50314,26 @@ Since: 3.10
<return></return>
</function>
+<function name="gtk_list_box_row_set_selectable">
+<description>
+Set the #GtkListBoxRow:selectable property for this row.
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="row">
+<parameter_description> a #GTkListBoxrow
+</parameter_description>
+</parameter>
+<parameter name="selectable">
+<parameter_description> %TRUE to mark the row as selectable
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_list_box_select_all">
<description>
Select all children of @box, if the selection mode allows it.
@@ -50198,7 +50491,7 @@ 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.
+to not blindly replace an existing header with 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
@@ -50256,8 +50549,6 @@ Since: 3.10
Sets how selection works in the listbox.
See #GtkSelectionMode for details.
-Note: #GtkListBox does not support @GTK_SELECTION_MULTIPLE.
-
Since: 3.10
</description>
@@ -66780,9 +67071,9 @@ removed by the recently used resources list, and %FALSE otherwise.
<function name="gtk_render_activity">
<description>
-Renders an activity area (Such as in #GtkSpinner or the
-fill line in #GtkRange), the state %GTK_STATE_FLAG_ACTIVE
-determines whether there is activity going on.
+Renders an activity indicator (such as in #GtkSpinner).
+The state %GTK_STATE_FLAG_ACTIVE determines whether there is
+activity going on.
Since: 3.0
@@ -69944,6 +70235,7 @@ Typical examples are
- `file:///home/gnome/pict.jpg`
- `http://www.gnome.org`
- `mailto:me gnome org`
+
Ideally the timestamp is taken from the event triggering
the gtk_show_uri() call. If timestamp is not known you can take
%GDK_CURRENT_TIME.
@@ -71326,6 +71618,8 @@ gtk_status_icon_is_embedded().
Since: 2.10
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71368,6 +71662,8 @@ If this function fails, @icon is left unchanged;
Since: 2.14
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71387,6 +71683,8 @@ See #GtkStatusIcon:has-tooltip for more information.
Since: 2.16
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71409,6 +71707,8 @@ be freed or modified.
Since: 2.10
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71431,6 +71731,8 @@ returned pixbuf.
Since: 2.10
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71450,6 +71752,8 @@ Returns the #GdkScreen associated with @status_icon.
Since: 2.12
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71475,6 +71779,8 @@ status icon is embedded (see gtk_status_icon_is_embedded()).
Since: 2.10
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71520,6 +71826,8 @@ the return value will be %GTK_IMAGE_EMPTY.
Since: 2.10
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71538,6 +71846,8 @@ Gets the title of this tray icon. See gtk_status_icon_set_title().
Since: 2.18
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71556,6 +71866,8 @@ Gets the contents of the tooltip for @status_icon.
Since: 2.16
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71575,6 +71887,8 @@ Gets the contents of the tooltip for @status_icon.
Since: 2.16
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71597,6 +71911,8 @@ gtk_status_icon_is_embedded().
Since: 2.10
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71624,6 +71940,8 @@ as gtk_status_icon_position_menu().
Since: 2.14
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71644,6 +71962,8 @@ area.
Since: 2.10
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71663,6 +71983,8 @@ Creates an empty status icon object.
Since: 2.10
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
</parameters>
@@ -71680,6 +72002,8 @@ space in the notification area, if necessary.
Since: 2.10
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="filename">
@@ -71699,6 +72023,8 @@ themed icon, it will be updated when the theme changes.
Since: 2.14
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="icon">
@@ -71719,6 +72045,8 @@ appropriately.
Since: 2.10
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="icon_name">
@@ -71740,6 +72068,8 @@ space in the notification area, if necessary.
Since: 2.10
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="pixbuf">
@@ -71782,6 +72112,8 @@ to position @menu aligned to the status icon @user_data.
Since: 2.10
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="menu">
@@ -71817,6 +72149,8 @@ See gtk_status_icon_new_from_file() for details.
Since: 2.10
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71838,6 +72172,8 @@ See gtk_status_icon_new_from_gicon() for details.
Since: 2.14
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71860,6 +72196,8 @@ See gtk_status_icon_new_from_icon_name() for details.
Since: 2.10
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71881,6 +72219,8 @@ See gtk_status_icon_new_from_pixbuf() for details.
Since: 2.10
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71925,6 +72265,8 @@ See #GtkStatusIcon:has-tooltip for more information.
Since: 2.16
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71948,6 +72290,8 @@ the user.
Since: 2.20
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71970,6 +72314,8 @@ then remapped on the new screen.
Since: 2.12
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -71993,6 +72339,8 @@ readers to render the tray icon.
Since: 2.18
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -72020,6 +72368,8 @@ gtk_tooltip_set_markup().
Since: 2.16
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -72047,6 +72397,8 @@ gtk_tooltip_set_text().
Since: 2.16
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -72067,6 +72419,8 @@ Shows or hides a status icon.
Since: 2.10
+Deprecated: 3.14: Use notifications
+
</description>
<parameters>
<parameter name="status_icon">
@@ -73461,7 +73815,7 @@ gtk_style_context_notify_state_change() is called for a given state,
and the current theme/style defines transition animations for state
changes.
-The @region_id used must be unique in @context so the theming engine
+The @region_id used must be unique in @context so the themes
can uniquely identify rendered elements subject to a state transition.
Since: 3.0
@@ -73737,7 +74091,7 @@ Sets the sides where rendered elements (mostly through
gtk_render_frame()) will visually connect with other visual elements.
This is merely a hint that may or may not be honored
-by theming engines.
+by themes.
Container widgets are expected to set junction hints as appropriate
for their children, so it should not normally be necessary to call
@@ -82921,6 +83275,8 @@ rendered element.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="engine">
@@ -82945,6 +83301,8 @@ Gets the background color for a given state.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="engine">
@@ -82969,6 +83327,8 @@ Gets the border for a given state as a #GtkBorder.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="engine">
@@ -82993,6 +83353,8 @@ Gets the border color for a given state.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="engine">
@@ -83017,6 +83379,8 @@ Gets the foreground color for a given state.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="engine">
@@ -83089,6 +83453,8 @@ Returns the widget direction used for rendering.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="engine">
@@ -83107,6 +83473,8 @@ Gets the margin for a given state as a #GtkBorder.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="engine">
@@ -83131,6 +83499,8 @@ Gets the padding for a given state as a #GtkBorder.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="engine">
@@ -83155,6 +83525,8 @@ Returns the widget path used for style matching.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="engine">
@@ -83174,6 +83546,8 @@ to the currently rendered element.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="engine">
@@ -83202,6 +83576,7 @@ done with it.
<description>
Returns the #GdkScreen to which @engine currently rendering to.
+Deprecated: 3.14
</description>
<parameters>
@@ -83211,6 +83586,7 @@ Returns the #GdkScreen to which @engine currently rendering to.
</parameter>
</parameters>
<return> a #GdkScreen, or %NULL.
+
</return>
</function>
@@ -83220,6 +83596,8 @@ returns the state used when rendering.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="engine">
@@ -83239,6 +83617,8 @@ to the currently rendered content’s style.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="engine">
@@ -83259,6 +83639,8 @@ Gets the value for a widget style property.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="engine">
@@ -83285,6 +83667,8 @@ currently rendered content’s style.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="engine">
@@ -83306,6 +83690,8 @@ rendered element.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="engine">
@@ -83331,6 +83717,8 @@ defined the given class name.
Since: 3.0
+Deprecated: 3.14
+
</description>
<parameters>
<parameter name="engine">
@@ -83382,6 +83770,7 @@ Deprecated: 3.14
Loads and initializes a theming engine module from the
standard directories.
+Deprecated: 3.14
</description>
<parameters>
@@ -83392,6 +83781,7 @@ standard directories.
</parameters>
<return> A theming engine, or %NULL if
the engine @name doesn’t exist.
+
</return>
</function>
@@ -83399,6 +83789,9 @@ the engine @name doesn’t exist.
<description>
Looks up and resolves a color name in the current style’s color map.
+Since: 3.0
+
+Deprecated: 3.14
</description>
<parameters>
@@ -83416,6 +83809,7 @@ Looks up and resolves a color name in the current style’s color map.
</parameter>
</parameters>
<return> %TRUE if @color_name was found and resolved, %FALSE otherwise
+
</return>
</function>
@@ -91793,6 +92187,7 @@ Since: 2.10
<description>
Gets the setting set by gtk_tree_view_set_rules_hint().
+Deprecated: 3.14
</description>
<parameters>
@@ -91801,7 +92196,8 @@ Gets the setting set by gtk_tree_view_set_rules_hint().
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if rules are useful for the user of this tree
+<return> %TRUE if the hint is set
+
</return>
</function>
@@ -92983,19 +93379,23 @@ Since: 2.10
<function name="gtk_tree_view_set_rules_hint">
<description>
-This function tells GTK+ that the user interface for your
+Sets a hint for the theme to draw even/odd rows in the @tree_view
+with different colors, also known as "zebra striping".
+
+This function tells the GTK+ theme that the user interface for your
application requires users to read across tree rows and associate
-cells with one another. By default, GTK+ will then render the tree
-with alternating row colors. Do not use it
-just because you prefer the appearance of the ruled tree; that’s a
-question for the theme. Some themes will draw tree rows in
-alternating colors even when rules are turned off, and users who
-prefer that appearance all the time can choose those themes. You
-should call this function only as a semantic
-hint to the theme engine that your tree makes alternating colors
-useful from a functional standpoint (since it has lots of columns,
+cells with one another.
+
+Do not use it just because you prefer the appearance of the ruled
+tree; that’s a question for the theme. Some themes will draw tree
+rows in alternating colors even when rules are turned off, and
+users who prefer that appearance all the time can choose those
+themes. You should call this function only as a semantic hint to
+the theme engine that your tree makes alternating colors useful
+from a functional standpoint (since it has lots of columns,
generally).
+Deprecated: 3.14
</description>
<parameters>
@@ -95707,6 +96107,11 @@ Returns the event mask for the widget (a bitfield containing flags
from the #GdkEventMask enumeration). These are the events that the widget
will receive.
+Note: Internally, the widget event mask will be the logical OR of the event
+mask set through gtk_widget_set_events() or gtk_widget_add_events(), and the
+event mask necessary to cater for every #GtkEventController created for the
+widget.
+
</description>
<parameters>
@@ -98508,6 +98913,30 @@ was not added with siblings, %NULL is returned.
</return>
</function>
+<function name="gtk_widget_path_iter_get_state">
+<description>
+Returns the state flags corresponding to the widget found at
+the position @pos in the widget hierarchy defined by
+ path
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> a #GtkWidgetPath
+</parameter_description>
+</parameter>
+<parameter name="pos">
+<parameter_description> position to get the state for, -1 for the path head
+</parameter_description>
+</parameter>
+</parameters>
+<return> The state flags
+
+</return>
+</function>
+
<function name="gtk_widget_path_iter_has_class">
<description>
Returns %TRUE if the widget at position @pos has the class @name
@@ -98838,6 +99267,47 @@ Since: 3.0
<return></return>
</function>
+<function name="gtk_widget_path_iter_set_state">
+<description>
+Sets the widget name for the widget found at position @pos
+in the widget hierarchy defined by @path.
+
+If you want to update just a single state flag, you need to do
+this manually, as this function updates all state flags.
+
+## Setting a flag
+
+|[<!-- language="C" -->
+gtk_widget_path_iter_set_state (path, pos, gtk_widget_path_iter_get_state (path, pos) | flag);
+]|
+
+## Unsetting a flag
+
+|[<!-- language="C" -->
+gtk_widget_path_iter_set_state (path, pos, gtk_widget_path_iter_get_state (path, pos) & ~flag);
+]|
+
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> a #GtkWidgetPath
+</parameter_description>
+</parameter>
+<parameter name="pos">
+<parameter_description> position to modify, -1 for the path head
+</parameter_description>
+</parameter>
+<parameter name="state">
+<parameter_description> state flags
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_widget_path_length">
<description>
Returns the number of #GtkWidget #GTypes between the represented
@@ -99842,9 +100312,30 @@ set by gtk_widget_set_default_direction() will be used.
<function name="gtk_widget_set_double_buffered">
<description>
-This function does nothing.
+Widgets are double buffered by default; you can use this function
+to turn off the buffering. “Double buffered” simply means that
+gdk_window_begin_paint_region() and gdk_window_end_paint() are called
+automatically around expose events sent to the
+widget. gdk_window_begin_paint_region() diverts all drawing to a widget's
+window to an offscreen buffer, and gdk_window_end_paint() draws the
+buffer to the screen. The result is that users see the window
+update in one smooth step, and don’t see individual graphics
+primitives being rendered.
+
+In very simple terms, double buffered widgets don’t flicker,
+so you would only use this function to turn off double buffering
+if you had special needs and really knew what you were doing.
+
+Note: if you turn off double-buffering, you have to handle
+expose events, since even the clearing to the background color or
+pixmap will not happen automatically (as it is done in
+gdk_window_begin_paint_region()).
+
+Since 3.10 this function only works for widgets with native
+windows.
-Deprecated: 3.14: Widgets are always double-buffered.
+Deprecated: 3.14: This does not work under non-X11 backends,
+and it should not be used in newly written code.
</description>
<parameters>
@@ -101762,6 +102253,8 @@ Determines whether the window may have a resize grip.
Since: 3.0
+Deprecated: 3.14: Resize grips have been removed.
+
</description>
<parameters>
<parameter name="window">
@@ -102007,6 +102500,8 @@ position, width and height into the specified #GdkRectangle.
Since: 3.0
+Deprecated: 3.14: Resize grips have been removed.
+
</description>
<parameters>
<parameter name="window">
@@ -102903,6 +103398,8 @@ Determines whether a resize grip is visible for the specified window.
Since: 3.0
+Deprecated: 3.14: Resize grips have been removed.
+
</description>
<parameters>
<parameter name="window">
@@ -103430,6 +103927,8 @@ resize grip is currently shown.
Since: 3.0
+Deprecated: 3.14: Resize grips have been removed.
+
</description>
<parameters>
<parameter name="window">
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
