[gtkmm] Regenerate .docs .xml
- From: Murray Cumming <murrayc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtkmm] Regenerate .docs .xml
- Date: Fri, 31 Jan 2014 09:07:38 +0000 (UTC)
commit b0cfaec234c8438fffbd23a1db6992eb9d0baadb
Author: Murray Cumming <murrayc murrayc com>
Date: Fri Jan 31 09:55:05 2014 +0100
Regenerate .docs .xml
gdk/src/gdk_docs.xml | 154 +++--
gtk/src/gtk_docs.xml | 1925 +++++++++++++++++++++++++++++++++-----------------
2 files changed, 1391 insertions(+), 688 deletions(-)
---
diff --git a/gdk/src/gdk_docs.xml b/gdk/src/gdk_docs.xml
index fcc5df7..c0465ee 100644
--- a/gdk/src/gdk_docs.xml
+++ b/gdk/src/gdk_docs.xml
@@ -1186,7 +1186,7 @@ interface.
<description>
#GdkFrameClockPhase is used to represent the different paint clock
phases that can be requested. The elements of the enumeration
-correspond to the signals of #GdkPaintClock.
+correspond to the signals of #GdkFrameClock.
Since: 3.8
@@ -1522,8 +1522,8 @@ Since: 2.16
<enum name="GdkModifierIntent">
<description>
-This enum is used with gdk_keymap_get_modifier_mask() and
-gdk_get_modifier_mask() in order to determine what modifiers the
+This enum is used with gdk_keymap_get_modifier_mask()
+in order to determine what modifiers the
currently used windowing system backend uses for particular
purposes. For example, on X11/Windows, the Control key is used for
invoking menu shortcuts (accelerators), whereas on Apple computers
@@ -1652,6 +1652,54 @@ mapping of the X server which key is interpreted as this modifier).
<parameter_description> A reserved bit flag; do not use in your own code
</parameter_description>
</parameter>
+<parameter name="GDK_MODIFIER_RESERVED_14_MASK">
+<parameter_description> A reserved bit flag; do not use in your own code
+</parameter_description>
+</parameter>
+<parameter name="GDK_MODIFIER_RESERVED_15_MASK">
+<parameter_description> A reserved bit flag; do not use in your own code
+</parameter_description>
+</parameter>
+<parameter name="GDK_MODIFIER_RESERVED_16_MASK">
+<parameter_description> A reserved bit flag; do not use in your own code
+</parameter_description>
+</parameter>
+<parameter name="GDK_MODIFIER_RESERVED_17_MASK">
+<parameter_description> A reserved bit flag; do not use in your own code
+</parameter_description>
+</parameter>
+<parameter name="GDK_MODIFIER_RESERVED_18_MASK">
+<parameter_description> A reserved bit flag; do not use in your own code
+</parameter_description>
+</parameter>
+<parameter name="GDK_MODIFIER_RESERVED_19_MASK">
+<parameter_description> A reserved bit flag; do not use in your own code
+</parameter_description>
+</parameter>
+<parameter name="GDK_MODIFIER_RESERVED_20_MASK">
+<parameter_description> A reserved bit flag; do not use in your own code
+</parameter_description>
+</parameter>
+<parameter name="GDK_MODIFIER_RESERVED_21_MASK">
+<parameter_description> A reserved bit flag; do not use in your own code
+</parameter_description>
+</parameter>
+<parameter name="GDK_MODIFIER_RESERVED_22_MASK">
+<parameter_description> A reserved bit flag; do not use in your own code
+</parameter_description>
+</parameter>
+<parameter name="GDK_MODIFIER_RESERVED_23_MASK">
+<parameter_description> A reserved bit flag; do not use in your own code
+</parameter_description>
+</parameter>
+<parameter name="GDK_MODIFIER_RESERVED_24_MASK">
+<parameter_description> A reserved bit flag; do not use in your own code
+</parameter_description>
+</parameter>
+<parameter name="GDK_MODIFIER_RESERVED_25_MASK">
+<parameter_description> A reserved bit flag; do not use in your own code
+</parameter_description>
+</parameter>
<parameter name="GDK_SUPER_MASK">
<parameter_description> the Super modifier. Since 2.10
</parameter_description>
@@ -1664,6 +1712,10 @@ mapping of the X server which key is interpreted as this modifier).
<parameter_description> the Meta modifier. Since 2.10
</parameter_description>
</parameter>
+<parameter name="GDK_MODIFIER_RESERVED_29_MASK">
+<parameter_description> A reserved bit flag; do not use in your own code
+</parameter_description>
+</parameter>
<parameter name="GDK_RELEASE_MASK">
<parameter_description> not used in GDK itself. GTK+ uses it to differentiate
between (keyval, modifiers) pairs from key press and release events.
@@ -1680,7 +1732,7 @@ between (keyval, modifiers) pairs from key press and release events.
<description>
Specifies the kind of crossing for #GdkEventCrossing.
-See the X11 protocol specification of <type>LeaveNotify</type> for
+See the X11 protocol specification of LeaveNotify for
full details of crossing event generation.
</description>
@@ -2379,7 +2431,7 @@ Since: 3.0
The ::from-embedder signal is emitted to translate coordinates
in the embedder of an offscreen window to the offscreen window.
-See also #GtkWindow::to-embedder.
+See also #GdkWindow::to-embedder.
Since: 2.18
@@ -2444,7 +2496,7 @@ Since: 2.18
The ::to-embedder signal is emitted to translate coordinates
in an offscreen window to its embedder.
-See also #GtkWindow::from-embedder.
+See also #GdkWindow::from-embedder.
Since: 2.18
@@ -2656,9 +2708,8 @@ decorations.
<parameter_description> the window is presented as focused (with active decorations).
</parameter_description>
</parameter>
-<parameter name="GDK_WINDOW_TILED">
-<parameter_description> the window is in a tiled state, see
-gdk_window_get_tiled_edges() for more details. Since 3.10
+<parameter name="GDK_WINDOW_STATE_TILED">
+<parameter_description> the window is in a tiled state, Since 3.10
</parameter_description>
</parameter>
</parameters>
@@ -3015,7 +3066,7 @@ Finds or creates an atom corresponding to a given string.
Note that this function is identical to gdk_atom_intern() except
that if a new #GdkAtom is created the string itself is used rather
than a copy. This saves memory, but can only be used if the string
-will <emphasis>always</emphasis> exist. It can be used with statically
+will always exist. It can be used with statically
allocated strings in the main program, but not with statically
allocated memory in dynamically loaded modules, if you expect to
ever unload the module again (e.g. do not use this function in
@@ -3307,7 +3358,7 @@ Since: 3.10
<function name="gdk_color_copy">
<description>
-Makes a copy of a color structure.
+Makes a copy of a #GdkColor.
The result must be freed using gdk_color_free().
@@ -3345,7 +3396,7 @@ Compares two colors.
<function name="gdk_color_free">
<description>
-Frees a color structure created with gdk_color_copy().
+Frees a #GdkColor created with gdk_color_copy().
</description>
<parameters>
@@ -3377,9 +3428,7 @@ table that stores #GdkColors.
<function name="gdk_color_parse">
<description>
Parses a textual specification of a color and fill in the
-<structfield>red</structfield>, <structfield>green</structfield>,
-and <structfield>blue</structfield> fields of a #GdkColor
-structure.
+ red, @green, and @blue fields of a #GdkColor.
The string can either one of a large set of standard names
(taken from the X11 <filename>rgb.txt</filename> file), or
@@ -3654,7 +3703,7 @@ cursor sizes.
If @x or @y are <literal>-1</literal>, the pixbuf must have
options named "x_hot" and "y_hot", resp., containing
-integer values between %0 and the width resp. height of
+integer values between <literal>0</literal> and the width resp. height of
the pixbuf. (Since: 3.0)
On the X backend, support for RGBA cursors requires a
@@ -4696,7 +4745,7 @@ Returns %TRUE if there is an ongoing grab on @device for @display.
Flushes any requests queued for the windowing system; this happens automatically
when the main loop blocks waiting for new events, but if your application
is drawing without returning control to the main loop, you may need
-to call this function explicitely. A common case where this function
+to call this function explicitly. A common case where this function
needs to be called is when an application is executing drawing commands
from a thread other than the thread where the main loop is running.
@@ -5368,7 +5417,7 @@ be sent.
Sets the double click distance (two clicks within this distance
count as a double click and result in a #GDK_2BUTTON_PRESS event).
See also gdk_display_set_double_click_time().
-Applications should <emphasis>not</emphasis> set this, it is a global
+Applications should not set this, it is a global
user-configured setting.
Since: 2.4
@@ -5391,7 +5440,7 @@ Since: 2.4
<description>
Sets the double click time (two clicks within this time interval
count as a double click and result in a #GDK_2BUTTON_PRESS event).
-Applications should <emphasis>not</emphasis> set this, it is a global
+Applications should not set this, it is a global
user-configured setting.
Since: 2.2
@@ -6073,7 +6122,7 @@ This function is called by the drag destination.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkDragContext
+<parameter_description> a #GdkDragContext
</parameter_description>
</parameter>
<parameter name="success">
@@ -7028,7 +7077,7 @@ of g_get_monotonic_time().
<function name="gdk_frame_clock_get_history_start">
<description>
-#GdkFrameClock internally keeps a history of #GdkFrameTiming
+#GdkFrameClock internally keeps a history of #GdkFrameTimings
objects for recent frames that can be retrieved with
gdk_frame_clock_get_timings(). The set of stored frames
is the set from the counter values given by
@@ -7149,7 +7198,7 @@ window system for processing and display to the user. The
accessor functions for #GdkFrameTimings can return 0 to
indicate an unavailable value for two reasons: either because
the information is not yet available, or because it isn't
-available at all. Once gdk_frame_timings_complete() returns
+available at all. Once gdk_frame_timings_get_complete() returns
%TRUE for a frame, you can be certain that no further values
will become available and be stored in the #GdkFrameTimings.
@@ -7346,7 +7395,7 @@ Since: 2.2
</description>
<parameters>
</parameters>
-<return> the display name, if specified explicitely, otherwise %NULL
+<return> the display name, if specified explicitly, otherwise %NULL
this string is owned by GTK+ and must not be modified or freed.
</return>
@@ -7627,7 +7676,7 @@ with g_free().
</parameter_description>
</parameter>
<parameter name="keyval">
-<parameter_description> a keyval, such as %GDK_a, %GDK_Up, %GDK_Return, etc.
+<parameter_description> a keyval, such as %GDK_KEY_a, %GDK_KEY_Up, %GDK_KEY_Return, etc.
</parameter_description>
</parameter>
<parameter name="keys">
@@ -7848,7 +7897,7 @@ However, this did not work if multi-modifier combinations were
used in the keymap, since, for instance, <literal><Control></literal>
would be masked out even if only <literal><Control><Alt></literal>
was used in the keymap. To support this usage as well as well as
-possible, all <emphasis>single modifier</emphasis> combinations
+possible, all single modifier combinations
that could affect the key for any combination of modifiers will
be returned in @consumed_modifiers; multi-modifier combinations
are returned only when actually found in @state. When you store
@@ -8323,7 +8372,7 @@ use by calls to gdk_display_open().
Any arguments used by GDK are removed from the array and @argc and @argv are
updated accordingly.
-You shouldn't call this function explicitely if you are using
+You shouldn't call this function explicitly if you are using
gtk_init(), gtk_init_check(), gdk_init(), or gdk_init_check().
Since: 2.2
@@ -11877,7 +11926,7 @@ It is allowed for @dest to be the same as either @src1 or @src2.
<function name="gdk_rgba_copy">
<description>
-Makes a copy of a #GdkRGBA structure.
+Makes a copy of a #GdkRGBA.
The result must be freed through gdk_rgba_free().
@@ -11919,7 +11968,7 @@ Since: 3.0
<function name="gdk_rgba_free">
<description>
-Frees a #GdkRGBA struct created with gdk_rgba_copy()
+Frees a #GdkRGBA created with gdk_rgba_copy()
Since: 3.0
@@ -11955,9 +12004,7 @@ Since: 3.0
<function name="gdk_rgba_parse">
<description>
Parses a textual representation of a color, filling in
-the <structfield>red</structfield>, <structfield>green</structfield>,
-<structfield>blue</structfield> and <structfield>alpha</structfield>
-fields of the @rgba struct.
+the @red, @green, @blue and @alpha fields of the @rgba #GdkRGBA.
The string can be either one of:
<itemizedlist>
@@ -11987,7 +12034,7 @@ Since: 3.0
</description>
<parameters>
<parameter name="rgba">
-<parameter_description> the #GdkRGBA struct to fill in
+<parameter_description> the #GdkRGBA to fill in
</parameter_description>
</parameter>
<parameter name="spec">
@@ -13119,7 +13166,7 @@ Since: 3.10
Set the double click time for the default display. See
gdk_display_set_double_click_time().
See also gdk_display_set_double_click_distance().
-Applications should <emphasis>not</emphasis> set this, it is a
+Applications should not set this, it is a
global user-configured setting.
</description>
@@ -14237,14 +14284,14 @@ some Wayland interface.
A good example would be writing a panel or on-screen-keyboard as an
out-of-process helper - as opposed to having those in the compositor
-process. In this case the underlying surface isn't a wl_shell
+process. In this case the underlying surface isn't an xdg_shell
surface and the panel or OSK client need to identify the wl_surface
as a panel or OSK to the compositor. The assumption is that the
compositor will expose a private interface to the special client
that lets the client identify the wl_surface as a panel or such.
This function should be called before a #GdkWindow is shown. This is
-best done by connecting to the #GtkWidget::realized signal:
+best done by connecting to the #GtkWidget::realize signal:
<informalexample>
<programlisting>
@@ -15588,7 +15635,7 @@ with the position of @window delivered in the most-recently-processed
position from the most recent configure event.
<note>
-If @window is not a toplevel, it is <emphasis>much</emphasis> better
+If @window is not a toplevel, it is much better
to call gdk_window_get_position(), gdk_window_get_width() and
gdk_window_get_height() instead, because it avoids the roundtrip to
the X server and because these functions support the full 32-bit
@@ -16136,7 +16183,7 @@ Since: 2.22
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the %window has a native window, %FALSE otherwise.
+<return> %TRUE if the @window has a native window, %FALSE otherwise.
</return>
</function>
@@ -17001,8 +17048,7 @@ the screen. Drawing is redirected to an offscreen buffer
and an expose event is emitted on the parent of the composited
window. It is the responsibility of the parent's expose handler
to manually merge the off-screen content onto the screen in
-whatever way it sees fit. See <xref linkend="composited-window-example"/>
-for an example.
+whatever way it sees fit.
It only makes sense for child windows to be composited; see
gdk_window_set_opacity() if you need translucent toplevel
@@ -17136,7 +17182,7 @@ Since: 3.0
</description>
<parameters>
<parameter name="window">
-<parameter_description> a #Gdkwindow
+<parameter_description> a #GdkWindow
</parameter_description>
</parameter>
<parameter name="device">
@@ -17600,7 +17646,7 @@ This function only works for toplevel windows.
GTK+ will automatically update this property automatically if
the @window background is opaque, as we know where the opaque regions
are. If your window background is not opaque, please update this
-property in your #GtkWindow::style_updated handler.
+property in your #GtkWidget::style-updated handler.
Since: 3.10
@@ -17721,7 +17767,7 @@ switcher, or other desktop utility program that displays a small
thumbnail representation of the windows on the desktop). If a
window's semantic type as specified with gdk_window_set_type_hint()
already fully describes the window, this function should
-<emphasis>not</emphasis> be called in addition, instead you should
+not be called in addition, instead you should
allow the window to be treated according to standard policy for
its semantic type.
@@ -17746,7 +17792,7 @@ Since: 2.2
Toggles whether a window should appear in a task list or window
list. If a window's semantic type as specified with
gdk_window_set_type_hint() already fully describes the window, this
-function should <emphasis>not</emphasis> be called in addition,
+function should not be called in addition,
instead you should allow the window to be treated according to
standard policy for its semantic type.
@@ -18247,7 +18293,7 @@ Returns the X cursor belonging to a #GdkCursor.
</parameter_description>
</parameter>
</parameters>
-<return> an Xlib <type>Cursor</type>.
+<return> an Xlib Cursor.
</return>
</function>
@@ -18263,7 +18309,7 @@ Returns the display of a #GdkCursor.
</parameter_description>
</parameter>
</parameters>
-<return> an Xlib <type>Display*</type>.
+<return> an Xlib Display*.
</return>
</function>
@@ -18505,7 +18551,7 @@ should be taken.
If the windowing system supports it, existing cursors created
with gdk_cursor_new(), gdk_cursor_new_for_display() and
-gdk_cursor_new_for_name() are updated to reflect the theme
+gdk_cursor_new_from_name() are updated to reflect the theme
change. Custom cursors constructed with
gdk_cursor_new_from_pixbuf() will have to be handled
by the application (GTK+ applications can learn about
@@ -18780,7 +18826,7 @@ Gets the root window of the default screen
</description>
<parameters>
</parameters>
-<return> an Xlib <type>Window</type>.
+<return> an Xlib Window.
</return>
</function>
@@ -18806,7 +18852,7 @@ Gets the default GTK+ display.
</description>
<parameters>
</parameters>
-<return> the Xlib <type>Display*</type> for
+<return> the Xlib Display* for
the display specified in the <option>--display</option> command
line option or the <envar>DISPLAY</envar> environment variable.
</return>
@@ -18877,7 +18923,7 @@ Since: 2.2
<description>
Returns the name of an X atom for GDK's default display. This
function is meant mainly for debugging, so for convenience, unlike
-<function>XAtomName()</function> and gdk_atom_name(), the result
+XAtomName() and gdk_atom_name(), the result
doesn't need to be freed. Also, this function will never return %NULL,
even if @xatom is invalid.
@@ -18986,7 +19032,7 @@ Since: 3.6
<function name="gdk_x11_lookup_xdisplay">
<description>
-Find the #GdkDisplay corresponding to @display, if any exists.
+Find the #GdkDisplay corresponding to @xdisplay, if any exists.
Since: 2.2
@@ -19155,7 +19201,7 @@ Since: 2.2
</parameter_description>
</parameter>
</parameters>
-<return> an Xlib <type>Screen*</type>
+<return> an Xlib Screen*
</return>
</function>
@@ -19263,7 +19309,7 @@ Returns the X visual belonging to a #GdkVisual.
</parameter_description>
</parameter>
</parameters>
-<return> an Xlib <type>Visual*</type>.
+<return> an Xlib Visual*.
</return>
</function>
@@ -19286,7 +19332,7 @@ Since: 2.24
</parameter_description>
</parameter>
<parameter name="window">
-<parameter_description> an XLib <type>Window</type>
+<parameter_description> an Xlib Window
</parameter_description>
</parameter>
</parameters>
@@ -19345,7 +19391,7 @@ window handle
</parameter_description>
</parameter>
<parameter name="window">
-<parameter_description> an XLib <type>Window</type>
+<parameter_description> an Xlib Window
</parameter_description>
</parameter>
</parameters>
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index 607e221..d3b11fb 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -23,6 +23,27 @@ Since: 2.24
</return>
</signal>
+<enum name="GtkAccelFlags">
+<description>
+Accelerator flags used with gtk_accel_group_connect().
+
+</description>
+<parameters>
+<parameter name="GTK_ACCEL_VISIBLE">
+<parameter_description> Accelerator is visible
+</parameter_description>
+</parameter>
+<parameter name="GTK_ACCEL_LOCKED">
+<parameter_description> Accelerator not removable
+</parameter_description>
+</parameter>
+<parameter name="GTK_ACCEL_MASK">
+<parameter_description> Mask
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<signal name="GtkAccelGroup::accel-activate">
<description>
The accel-activate signal is an implementation detail of
@@ -120,7 +141,7 @@ The "activate" signal is emitted when the action is activated.
Since: 2.4
-Deprecated: 3.10: Use #GSimpleAction:activate instead
+Deprecated: 3.10: Use #GSimpleAction::activate instead
</description>
<parameters>
@@ -969,6 +990,10 @@ contains. (See also: #GtkVButtonBox and #GtkHButtonBox).
<parameter_description> Buttons are centered in the box. Since 2.12.
</parameter_description>
</parameter>
+<parameter name="GTK_BUTTONBOX_EXPAND">
+<parameter_description> Buttons expand to fill the box. Since 3.12.
+</parameter_description>
+</parameter>
</parameters>
</enum>
@@ -1431,6 +1456,26 @@ Since: 2.10
<return></return>
</signal>
+<enum name="GtkCellRendererAccelMode">
+<description>
+Determines if the edited accelerators are GTK+ accelerators. If
+they are, consumed modifiers are suppressed, only accelerators
+accepted by GTK+ are allowed, and the accelerators are rendered
+in the same way as they are in menus.
+
+</description>
+<parameters>
+<parameter name="GTK_CELL_RENDERER_ACCEL_MODE_GTK">
+<parameter_description> GTK+ accelerators mode
+</parameter_description>
+</parameter>
+<parameter name="GTK_CELL_RENDERER_ACCEL_MODE_OTHER">
+<parameter_description> Other accelerator mode
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<signal name="GtkCellRendererCombo::changed">
<description>
This signal is emitted each time after the user selected an item in
@@ -1622,7 +1667,7 @@ The ::color-set signal is emitted when the user selects a color.
When handling this signal, use gtk_color_button_get_rgba() to
find out which color was just selected.
-Note that this signal is only emitted when the <emphasis>user</emphasis>
+Note that this signal is only emitted when the user
changes the color. If you need to react to programmatic color changes
as well, use the notify::color signal.
@@ -1876,6 +1921,39 @@ than when a loading function was called.
<return></return>
</signal>
+<enum name="GtkCssProviderError">
+<description>
+Deprecated.
+
+</description>
+<parameters>
+<parameter name="GTK_CSS_PROVIDER_ERROR_FAILED">
+<parameter_description> Failed.
+</parameter_description>
+</parameter>
+<parameter name="GTK_CSS_PROVIDER_ERROR_SYNTAX">
+<parameter_description> Syntax error.
+</parameter_description>
+</parameter>
+<parameter name="GTK_CSS_PROVIDER_ERROR_IMPORT">
+<parameter_description> Import error.
+</parameter_description>
+</parameter>
+<parameter name="GTK_CSS_PROVIDER_ERROR_NAME">
+<parameter_description> Name error.
+</parameter_description>
+</parameter>
+<parameter name="GTK_CSS_PROVIDER_ERROR_DEPRECATED">
+<parameter_description> Deprecation error.
+</parameter_description>
+</parameter>
+<parameter name="GTK_CSS_PROVIDER_ERROR_UNKNOWN_VALUE">
+<parameter_description> Unknown value.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<enum name="GtkCssSectionType">
<description>
The different types of sections indicate parts of a CSS document as
@@ -1936,6 +2014,53 @@ animations</ulink> for details. Since 3.6
</parameters>
</enum>
+<enum name="GtkDeleteType">
+<description>
+See also: #GtkEntry::delete-from-cursor.
+
+</description>
+<parameters>
+<parameter name="GTK_DELETE_CHARS">
+<parameter_description> Delete characters.
+</parameter_description>
+</parameter>
+<parameter name="GTK_DELETE_WORD_ENDS">
+<parameter_description> Delete only the portion of the word to the
+left/right of cursor if we're in the middle of a word.
+</parameter_description>
+</parameter>
+<parameter name="GTK_DELETE_WORDS">
+<parameter_description> Delete words.
+</parameter_description>
+</parameter>
+<parameter name="GTK_DELETE_DISPLAY_LINES">
+<parameter_description> Delete display-lines. Display-lines
+refers to the visible lines, with respect to to the current line
+breaks. As opposed to paragraphs, which are defined by line
+breaks in the input.
+</parameter_description>
+</parameter>
+<parameter name="GTK_DELETE_DISPLAY_LINE_ENDS">
+<parameter_description> Delete only the portion of the
+display-line to the left/right of cursor.
+</parameter_description>
+</parameter>
+<parameter name="GTK_DELETE_PARAGRAPH_ENDS">
+<parameter_description> Delete to the end of the
+paragraph. Like C-k in Emacs (or its reverse).
+</parameter_description>
+</parameter>
+<parameter name="GTK_DELETE_PARAGRAPHS">
+<parameter_description> Delete entire line. Like C-k in pico.
+</parameter_description>
+</parameter>
+<parameter name="GTK_DELETE_WHITESPACE">
+<parameter_description> Delete only whitespace. Like M-\ in Emacs.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<enum name="GtkDestDefaults">
<description>
The #GtkDestDefaults enumeration specifies the various
@@ -2026,6 +2151,44 @@ see gtk_window_set_modal()
parent is destroyed, see gtk_window_set_destroy_with_parent()
</parameter_description>
</parameter>
+<parameter name="GTK_DIALOG_USE_HEADER_BAR">
+<parameter_description> Create dialog with actions in header
+bar instead of action area. Since 3.12.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
+<enum name="GtkDirectionType">
+<description>
+Focus movement types.
+
+</description>
+<parameters>
+<parameter name="GTK_DIR_TAB_FORWARD">
+<parameter_description> Move forward.
+</parameter_description>
+</parameter>
+<parameter name="GTK_DIR_TAB_BACKWARD">
+<parameter_description> Move backward.
+</parameter_description>
+</parameter>
+<parameter name="GTK_DIR_UP">
+<parameter_description> Move up.
+</parameter_description>
+</parameter>
+<parameter name="GTK_DIR_DOWN">
+<parameter_description> Move down.
+</parameter_description>
+</parameter>
+<parameter name="GTK_DIR_LEFT">
+<parameter_description> Move left.
+</parameter_description>
+</parameter>
+<parameter name="GTK_DIR_RIGHT">
+<parameter_description> Move right.
+</parameter_description>
+</parameter>
</parameters>
</enum>
@@ -2915,7 +3078,7 @@ new folder.
<description>
The ::file-set signal is emitted when the user selects a file.
-Note that this signal is only emitted when the <emphasis>user</emphasis>
+Note that this signal is only emitted when the user
changes the file.
Since: 2.12
@@ -3190,7 +3353,7 @@ The ::font-set signal is emitted when the user selects a font.
When handling this signal, use gtk_font_button_get_font_name()
to find out which font was just selected.
-Note that this signal is only emitted when the <emphasis>user</emphasis>
+Note that this signal is only emitted when the user
changes the font. If you need to react to programmatic font changes
as well, use the notify::font-name signal.
@@ -3386,6 +3549,54 @@ gtk_im_context_set_surrounding() method.
</return>
</signal>
+<enum name="GtkIMPreeditStyle">
+<description>
+Style for input method preedit. See also
+#GtkSettings:gtk-im-preedit-style
+
+Deprecated: 3.10
+
+</description>
+<parameters>
+<parameter name="GTK_IM_PREEDIT_NOTHING">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+<parameter name="GTK_IM_PREEDIT_CALLBACK">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+<parameter name="GTK_IM_PREEDIT_NONE">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
+<enum name="GtkIMStatusStyle">
+<description>
+Style for input method status. See also
+#GtkSettings:gtk-im-status-style
+
+Deprecated: 3.10
+
+</description>
+<parameters>
+<parameter name="GTK_IM_STATUS_NOTHING">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+<parameter name="GTK_IM_STATUS_CALLBACK">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+<parameter name="GTK_IM_STATUS_NONE">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<enum name="GtkIconLookupFlags">
<description>
Used to specify options for gtk_icon_theme_lookup_icon()
@@ -3393,12 +3604,12 @@ Used to specify options for gtk_icon_theme_lookup_icon()
</description>
<parameters>
<parameter name="GTK_ICON_LOOKUP_NO_SVG">
-<parameter_description> Never return SVG icons, even if gdk-pixbuf
+<parameter_description> Never get SVG icons, even if gdk-pixbuf
supports them. Cannot be used together with %GTK_ICON_LOOKUP_FORCE_SVG.
</parameter_description>
</parameter>
<parameter name="GTK_ICON_LOOKUP_FORCE_SVG">
-<parameter_description> Return SVG icons, even if gdk-pixbuf
+<parameter_description> Get SVG icons, even if gdk-pixbuf
doesn't support them.
Cannot be used together with %GTK_ICON_LOOKUP_NO_SVG.
</parameter_description>
@@ -3407,7 +3618,7 @@ Cannot be used together with %GTK_ICON_LOOKUP_NO_SVG.
<parameter_description> When passed to
gtk_icon_theme_lookup_icon() includes builtin icons
as well as files. For a builtin icon, gtk_icon_info_get_filename()
-returns %NULL and you need to call gtk_icon_info_get_builtin_pixbuf().
+is %NULL and you need to call gtk_icon_info_get_builtin_pixbuf().
</parameter_description>
</parameter>
<parameter name="GTK_ICON_LOOKUP_GENERIC_FALLBACK">
@@ -3417,13 +3628,50 @@ fallback, see gtk_icon_theme_choose_icon(). Since 2.12.
</parameter_description>
</parameter>
<parameter name="GTK_ICON_LOOKUP_FORCE_SIZE">
-<parameter_description> Always return the icon scaled to the
+<parameter_description> Always get the icon scaled to the
requested size. Since 2.14.
</parameter_description>
</parameter>
</parameters>
</enum>
+<enum name="GtkIconSize">
+<description>
+Built-in stock icon sizes.
+
+</description>
+<parameters>
+<parameter name="GTK_ICON_SIZE_INVALID">
+<parameter_description> Invalid size.
+</parameter_description>
+</parameter>
+<parameter name="GTK_ICON_SIZE_MENU">
+<parameter_description> Size appropriate for menus (16px).
+</parameter_description>
+</parameter>
+<parameter name="GTK_ICON_SIZE_SMALL_TOOLBAR">
+<parameter_description> Size appropriate for small toolbars (16px).
+</parameter_description>
+</parameter>
+<parameter name="GTK_ICON_SIZE_LARGE_TOOLBAR">
+<parameter_description> Size appropriate for large toolbars (24px)
+</parameter_description>
+</parameter>
+<parameter name="GTK_ICON_SIZE_BUTTON">
+<parameter_description> Size appropriate for buttons (16px)
+</parameter_description>
+</parameter>
+<parameter name="GTK_ICON_SIZE_DND">
+<parameter_description> Size appropriate for drag and drop (32px)
+</parameter_description>
+</parameter>
+<parameter name="GTK_ICON_SIZE_DIALOG">
+<parameter_description> Size appropriate for dialogs (48px)
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<signal name="GtkIconTheme::changed">
<description>
Emitted when the current icon theme is switched or GTK+ detects
@@ -4868,6 +5116,52 @@ Represents the packing location #GtkBox children. (See: #GtkVBox,
</parameters>
</enum>
+<enum name="GtkPageOrientation">
+<description>
+See also gtk_print_settings_set_orientation().
+
+</description>
+<parameters>
+<parameter name="GTK_PAGE_ORIENTATION_PORTRAIT">
+<parameter_description> Portrait mode.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PAGE_ORIENTATION_LANDSCAPE">
+<parameter_description> Landscape mode.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PAGE_ORIENTATION_REVERSE_PORTRAIT">
+<parameter_description> Reverse portrait mode.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PAGE_ORIENTATION_REVERSE_LANDSCAPE">
+<parameter_description> Reverse landscape mode.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
+<enum name="GtkPageSet">
+<description>
+See also gtk_print_job_set_page_set().
+
+</description>
+<parameters>
+<parameter name="GTK_PAGE_SET_ALL">
+<parameter_description> All pages.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PAGE_SET_EVEN">
+<parameter_description> Even pages.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PAGE_SET_ODD">
+<parameter_description> Odd pages.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<signal name="GtkPaned::accept-position">
<description>
The ::accept-position signal is a
@@ -5004,6 +5298,66 @@ Since: 2.0
<return></return>
</signal>
+<enum name="GtkPathPriorityType">
+<description>
+Priorities for path lookups.
+See also gtk_binding_set_add_path().
+
+Deprecated: 3.0
+
+</description>
+<parameters>
+<parameter name="GTK_PATH_PRIO_LOWEST">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+<parameter name="GTK_PATH_PRIO_GTK">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+<parameter name="GTK_PATH_PRIO_APPLICATION">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+<parameter name="GTK_PATH_PRIO_THEME">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+<parameter name="GTK_PATH_PRIO_RC">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+<parameter name="GTK_PATH_PRIO_HIGHEST">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
+<enum name="GtkPathType">
+<description>
+Widget path types.
+See also gtk_binding_set_add_path().
+
+Deprecated: 3.0
+
+</description>
+<parameters>
+<parameter name="GTK_PATH_WIDGET">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+<parameter name="GTK_PATH_WIDGET_CLASS">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+<parameter name="GTK_PATH_CLASS">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<enum name="GtkPlacesOpenFlags">
<description>
These flags serve two purposes. First, the application can call gtk_places_sidebar_set_open_flags()
@@ -5378,6 +5732,27 @@ pages when printing multiple pages per sheet. Since 2.14
</parameters>
</enum>
+<enum name="GtkPrintDuplex">
+<description>
+See also gtk_print_settings_set_duplex().
+
+</description>
+<parameters>
+<parameter name="GTK_PRINT_DUPLEX_SIMPLEX">
+<parameter_description> No duplex.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PRINT_DUPLEX_HORIZONTAL">
+<parameter_description> Horizontal duplex.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PRINT_DUPLEX_VERTICAL">
+<parameter_description> Vertical duplex.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<enum name="GtkPrintError">
<description>
Error codes that identify various errors that can occur while
@@ -5882,6 +6257,56 @@ yet. This value will only be returned when running asynchronously.
</parameters>
</enum>
+<enum name="GtkPrintPages">
+<description>
+See also gtk_print_job_set_pages()
+
+</description>
+<parameters>
+<parameter name="GTK_PRINT_PAGES_ALL">
+<parameter_description> All pages.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PRINT_PAGES_CURRENT">
+<parameter_description> Current page.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PRINT_PAGES_RANGES">
+<parameter_description> Range of pages.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PRINT_PAGES_SELECTION">
+<parameter_description> Selected pages.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
+<enum name="GtkPrintQuality">
+<description>
+See also gtk_print_settings_set_quality().
+
+</description>
+<parameters>
+<parameter name="GTK_PRINT_QUALITY_LOW">
+<parameter_description> Low quality.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PRINT_QUALITY_NORMAL">
+<parameter_description> Normal quality.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PRINT_QUALITY_HIGH">
+<parameter_description> High quality.
+</parameter_description>
+</parameter>
+<parameter name="GTK_PRINT_QUALITY_DRAFT">
+<parameter_description> Draft quality.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<enum name="GtkPrintStatus">
<description>
The status gives a rough indication of the completion of a running
@@ -6111,6 +6536,31 @@ Emitted when the range value changes.
<return></return>
</signal>
+<enum name="GtkRcFlags">
+<description>
+Deprecated
+
+</description>
+<parameters>
+<parameter name="GTK_RC_FG">
+<parameter_description>Deprecated
+</parameter_description>
+</parameter>
+<parameter name="GTK_RC_BG">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+<parameter name="GTK_RC_TEXT">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+<parameter name="GTK_RC_BASE">
+<parameter_description> Deprecated
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<enum name="GtkRcTokenType">
<description>
The #GtkRcTokenType enumeration represents the tokens
@@ -6123,163 +6573,163 @@ Deprecated: 3.0: Use #GtkCssProvider instead.
</description>
<parameters>
<parameter name="GTK_RC_TOKEN_INVALID">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_INCLUDE">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_NORMAL">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_ACTIVE">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_PRELIGHT">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_SELECTED">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_INSENSITIVE">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_FG">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_BG">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_TEXT">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_BASE">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_XTHICKNESS">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_YTHICKNESS">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_FONT">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_FONTSET">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_FONT_NAME">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_BG_PIXMAP">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_PIXMAP_PATH">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_STYLE">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_BINDING">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_BIND">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_WIDGET">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_WIDGET_CLASS">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_CLASS">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_LOWEST">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_GTK">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_APPLICATION">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_THEME">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_RC">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_HIGHEST">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_ENGINE">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_MODULE_PATH">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_IM_MODULE_PATH">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_IM_MODULE_FILE">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_STOCK">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_LTR">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_RTL">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_COLOR">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_UNBIND">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
<parameter name="GTK_RC_TOKEN_LAST">
-<parameter_description>
+<parameter_description> Deprecated
</parameter_description>
</parameter>
</parameters>
@@ -6309,7 +6759,7 @@ Since: 2.10
This signal is emitted when there is a change in the set of
selected recently used resources. This can happen when a user
modifies the selection with the mouse or the keyboard, or when
-explicitely calling functions to change the selection.
+explicitly calling functions to change the selection.
Since: 2.10
@@ -6733,6 +7183,111 @@ Since: 2.12
<return></return>
</signal>
+<enum name="GtkScrollStep">
+<description>
+
+</description>
+<parameters>
+<parameter name="GTK_SCROLL_STEPS">
+<parameter_description> Scroll in steps.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_PAGES">
+<parameter_description> Scroll by pages.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_ENDS">
+<parameter_description> Scroll to ends.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_HORIZONTAL_STEPS">
+<parameter_description> Scroll in horizontal steps.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_HORIZONTAL_PAGES">
+<parameter_description> Scroll by horizontal pages.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_HORIZONTAL_ENDS">
+<parameter_description> Scroll to the horizontal ends.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
+<enum name="GtkScrollType">
+<description>
+Scrolling types.
+
+</description>
+<parameters>
+<parameter name="GTK_SCROLL_NONE">
+<parameter_description> No scrolling.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_JUMP">
+<parameter_description> Jump to new location.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_STEP_BACKWARD">
+<parameter_description> Step backward.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_STEP_FORWARD">
+<parameter_description> Step forward.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_PAGE_BACKWARD">
+<parameter_description> Page backward.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_PAGE_FORWARD">
+<parameter_description> Page forward.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_STEP_UP">
+<parameter_description> Step up.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_STEP_DOWN">
+<parameter_description> Step down.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_PAGE_UP">
+<parameter_description> Page up.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_PAGE_DOWN">
+<parameter_description> Page down.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_STEP_LEFT">
+<parameter_description> Step to the left.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_STEP_RIGHT">
+<parameter_description> Step to the right.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_PAGE_LEFT">
+<parameter_description> Page to the left.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_PAGE_RIGHT">
+<parameter_description> Page to the right.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_START">
+<parameter_description> Scroll to start.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SCROLL_END">
+<parameter_description> Scroll to end.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<enum name="GtkScrollablePolicy">
<description>
Defines the policy to be used in a scrollable widget when updating
@@ -7689,7 +8244,7 @@ notify::active signal.
<enum name="GtkTargetFlags">
<description>
The #GtkTargetFlags enumeration is used to specify
-constraints on an entry in a #GtkTargetTable.
+constraints on a #GtkTargetEntry.
</description>
<parameters>
@@ -8066,6 +8621,53 @@ gtk_text_buffer_remove_tag().
<return></return>
</signal>
+<enum name="GtkTextBufferTargetInfo">
+<description>
+These values are used as "info" for the targets contained in the
+lists returned by gtk_text_buffer_get_copy_target_list() and
+gtk_text_buffer_get_paste_target_list().
+
+The values counts down from <literal>-1</literal> to avoid clashes
+with application added drag destinations which usually start at 0.
+
+</description>
+<parameters>
+<parameter name="GTK_TEXT_BUFFER_TARGET_INFO_BUFFER_CONTENTS">
+<parameter_description> Buffer contents
+</parameter_description>
+</parameter>
+<parameter name="GTK_TEXT_BUFFER_TARGET_INFO_RICH_TEXT">
+<parameter_description> Rich text
+</parameter_description>
+</parameter>
+<parameter name="GTK_TEXT_BUFFER_TARGET_INFO_TEXT">
+<parameter_description> Text
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
+<enum name="GtkTextDirection">
+<description>
+Reading directions for text.
+
+</description>
+<parameters>
+<parameter name="GTK_TEXT_DIR_NONE">
+<parameter_description> No direction.
+</parameter_description>
+</parameter>
+<parameter name="GTK_TEXT_DIR_LTR">
+<parameter_description> Left to right text direction.
+</parameter_description>
+</parameter>
+<parameter name="GTK_TEXT_DIR_RTL">
+<parameter_description> Right to left text direction.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<enum name="GtkTextSearchFlags">
<description>
Flags affecting how a search is done.
@@ -8522,6 +9124,39 @@ The default bindings for this signal is Insert.
<return></return>
</signal>
+<enum name="GtkTextWindowType">
+<description>
+Used to reference the parts of #GtkTextView.
+
+</description>
+<parameters>
+<parameter name="GTK_TEXT_WINDOW_WIDGET">
+<parameter_description> Window that floats over scrolling areas.
+</parameter_description>
+</parameter>
+<parameter name="GTK_TEXT_WINDOW_TEXT">
+<parameter_description> Scrollable text window.
+</parameter_description>
+</parameter>
+<parameter name="GTK_TEXT_WINDOW_LEFT">
+<parameter_description> Left side border window.
+</parameter_description>
+</parameter>
+<parameter name="GTK_TEXT_WINDOW_RIGHT">
+<parameter_description> Right side border window.
+</parameter_description>
+</parameter>
+<parameter name="GTK_TEXT_WINDOW_TOP">
+<parameter_description> Top border window.
+</parameter_description>
+</parameter>
+<parameter name="GTK_TEXT_WINDOW_BOTTOM">
+<parameter_description> Bottom border window.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<signal name="GtkToggleAction::toggled">
<description>
Should be connected if you wish to perform an action
@@ -8753,6 +9388,23 @@ Emitted when the style of the toolbar changes.
<return></return>
</signal>
+<enum name="GtkToolbarSpaceStyle">
+<description>
+Whether spacers are vertical lines or just blank.
+
+</description>
+<parameters>
+<parameter name="GTK_TOOLBAR_SPACE_EMPTY">
+<parameter_description> Use blank spacers.
+</parameter_description>
+</parameter>
+<parameter name="GTK_TOOLBAR_SPACE_LINE">
+<parameter_description> Use vertical lines for spacers.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<enum name="GtkToolbarStyle">
<description>
Used to customize the appearance of a #GtkToolbar. Note that
@@ -8794,11 +9446,11 @@ This signal is emitted when a row in the model has changed.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath identifying the changed row
+<parameter_description> a #GtkTreePath-struct identifying the changed row
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a valid #GtkTreeIter pointing to the changed row
+<parameter_description> a valid #GtkTreeIter-struct pointing to the changed row
</parameter_description>
</parameter>
</parameters>
@@ -8823,7 +9475,7 @@ the row previously was at. It may not be a valid location anymore.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath identifying the row
+<parameter_description> a #GtkTreePath-struct identifying the row
</parameter_description>
</parameter>
</parameters>
@@ -8842,11 +9494,11 @@ row or lost its last child row.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath identifying the row
+<parameter_description> a #GtkTreePath-struct identifying the row
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a valid #GtkTreeIter pointing to the row
+<parameter_description> a valid #GtkTreeIter-struct pointing to the row
</parameter_description>
</parameter>
</parameters>
@@ -8869,11 +9521,11 @@ then fill it with the desired values.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath identifying the new row
+<parameter_description> a #GtkTreePath-struct identifying the new row
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a valid #GtkTreeIter pointing to the new row
+<parameter_description> a valid #GtkTreeIter-struct pointing to the new row
</parameter_description>
</parameter>
</parameters>
@@ -8885,7 +9537,7 @@ then fill it with the desired values.
This signal is emitted when the children of a node in the
#GtkTreeModel have been reordered.
-Note that this signal is <emphasis>not</emphasis> emitted
+Note that this signal is not emitted
when rows are reordered by DND, since this is implemented
by removing and then reinserting the row.
@@ -8896,12 +9548,13 @@ by removing and then reinserting the row.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath identifying the tree node whose children
+<parameter_description> a #GtkTreePath-struct identifying the tree node whose children
have been reordered
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a valid #GtkTreeIter pointing to the node whose
+<parameter_description> a valid #GtkTreeIter-struct 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">
@@ -9407,6 +10060,31 @@ actions' accelerators are shown.
</parameters>
</enum>
+<enum name="GtkUnit">
+<description>
+See also gtk_print_settings_set_paper_width().
+
+</description>
+<parameters>
+<parameter name="GTK_UNIT_NONE">
+<parameter_description> No units.
+</parameter_description>
+</parameter>
+<parameter name="GTK_UNIT_POINTS">
+<parameter_description> Dimensions in points.
+</parameter_description>
+</parameter>
+<parameter name="GTK_UNIT_INCH">
+<parameter_description> Dimensions in inches.
+</parameter_description>
+</parameter>
+<parameter name="GTK_UNIT_MM">
+<parameter_description> Dimensions in millimeters
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<signal name="GtkWidget::accel-closures-changed">
<description>
@@ -9761,7 +10439,7 @@ gtk_selection_data_set_text().
The ::drag-data-received signal is emitted on the drop site when the
dragged data has been received. If the data was received in order to
determine whether the drop will be accepted, the handler is expected
-to call gdk_drag_status() and <emphasis>not</emphasis> finish the drag.
+to call gdk_drag_status() and not finish the drag.
If the data was received in response to a #GtkWidget::drag-drop signal
(and this is the last target to be received), the handler for this
signal is expected to process the received data and then call
@@ -10765,7 +11443,7 @@ 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
+#GdkWindow, which means that gtk_widget_realize() has been called or the
widget has been mapped (that is, it is going to be drawn).
</description>
@@ -11191,6 +11869,23 @@ event. %FALSE to propagate the event further.
</return>
</signal>
+<enum name="GtkWidgetHelpType">
+<description>
+Kinds of widget-specific help. Used by the ::show-help signal.
+
+</description>
+<parameters>
+<parameter name="GTK_WIDGET_HELP_TOOLTIP">
+<parameter_description> Tooltip.
+</parameter_description>
+</parameter>
+<parameter name="GTK_WIDGET_HELP_WHATS_THIS">
+<parameter_description> What's this.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<signal name="GtkWindow::activate-default">
<description>
The ::activate-default signal is a
@@ -12397,7 +13092,7 @@ all accel groups which are attached to @object
<function name="gtk_accel_label_get_accel">
<description>
-Returns the keyval and modifier mask set with
+Gets the keyval and modifier mask set with
gtk_accel_label_set_accel().
Since: 3.12
@@ -12959,7 +13654,7 @@ see gtk_accelerator_get_label().
<function name="gtk_accelerator_name_with_keycode">
<description>
Converts an accelerator keyval and modifier mask
-into a string parseable by gtk_accelerator_parse_full(),
+into a string parseable by gtk_accelerator_parse_with_keycode(),
similarly to gtk_accelerator_name() but handling keycodes.
This is only useful for system-level components, applications
should use gtk_accelerator_parse() instead.
@@ -13661,7 +14356,7 @@ for that.
Since: 2.4
-Deprecated: 3.10: Use g_simple_action_get_enabled() on a #GSimpleAction
+Deprecated: 3.10: Use g_action_get_enabled() on a #GAction
instead
</description>
@@ -13725,7 +14420,7 @@ 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()
+#GtkActionable widgets with gtk_widget_get_tooltip_text()
</description>
<parameters>
@@ -14429,7 +15124,7 @@ Returns whether the action is effectively sensitive.
Since: 2.4
-Deprecated: 3.10: Use g_simple_action_get_enabled() on a #GSimpleAction
+Deprecated: 3.10: Use g_action_get_enabled() on a #GAction
instead
</description>
@@ -14467,103 +15162,6 @@ 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
@@ -14652,163 +15250,6 @@ unregistered an equal number of times.
<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_observer_primary_accel_changed">
-<description>
-This function is called when an action that the observer is
-registered to receive events for has one of its accelerators changed.
-
-Accelerator changes are reported for all targets associated with the
-action. The @action_and_target string should be used to check if the
-reported target is the one that the observer is interested in.
-
-</description>
-<parameters>
-<parameter name="observer">
-<parameter_description> a #GtkActionObserver
-</parameter_description>
-</parameter>
-<parameter name="observable">
-<parameter_description> the source of the event
-</parameter_description>
-</parameter>
-<parameter name="action_name">
-<parameter_description> the name of the action
-</parameter_description>
-</parameter>
-<parameter name="action_and_target">
-<parameter_description> detailed action of the changed accel, in "action and target" format
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="gtk_action_set_accel_group">
<description>
Sets the #GtkAccelGroup in which the accelerator for this action
@@ -14988,7 +15429,7 @@ API to set a label
<function name="gtk_action_set_sensitive">
<description>
-Sets the ::sensitive property of the action to @sensitive. Note that
+Sets the :sensitive property of the action to @sensitive. Note that
this doesn't necessarily mean effective sensitivity. See
gtk_action_is_sensitive()
for that.
@@ -15065,7 +15506,7 @@ 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()
+#GtkActionable widgets with gtk_widget_set_tooltip_text()
</description>
<parameters>
@@ -15083,7 +15524,7 @@ Deprecated: 3.10: Use #GAction instead, and set tooltips on associated
<function name="gtk_action_set_visible">
<description>
-Sets the ::visible property of the action to @visible. Note that
+Sets the :visible property of the action to @visible. Note that
this doesn't necessarily mean effective visibility. See
gtk_action_is_visible()
for that.
@@ -16074,6 +16515,7 @@ to the ::notify:gtk-alternative-button-order signal on the
notified if the button order setting changes.
Since: 2.6
+Deprecated: 3.10: Deprecated
</description>
<parameters>
@@ -17031,7 +17473,7 @@ the primary instance.
Concretely, gtk_init() is called in the default handler for the
#GApplication::startup signal. Therefore, #GtkApplication subclasses should
-chain up in their #GApplication:startup handler before using any GTK+ API.
+chain up in their #GApplication::startup handler before using any GTK+ API.
Note that commandline arguments are not passed to gtk_init().
All GTK+ functionality that is available via commandline arguments
@@ -17152,7 +17594,7 @@ gtk_accelerator_parse()
Sets or unsets the application menu for @application.
This can only be done in the primary instance of the application,
-after it has been registered. #GApplication:startup is a good place
+after it has been registered. #GApplication::startup is a good place
to call this.
The application menu is a single menu containing items that typically
@@ -17190,7 +17632,7 @@ Sets or unsets the menubar for windows of @application.
This is a menubar in the traditional sense.
This can only be done in the primary instance of the application,
-after it has been registered. #GApplication:startup is a good place
+after it has been registered. #GApplication::startup is a good place
to call this.
Depending on the desktop environment, this may appear at the top of
@@ -18392,13 +18834,13 @@ Since: 2.4
<function name="gtk_border_copy">
<description>
-Copies a #GtkBorder structure.
+Copies a #GtkBorder-struct.
</description>
<parameters>
<parameter name="border_">
-<parameter_description> a #GtkBorder
+<parameter_description> a #GtkBorder-struct
</parameter_description>
</parameter>
</parameters>
@@ -18408,12 +18850,12 @@ Copies a #GtkBorder structure.
<function name="gtk_border_free">
<description>
-Frees a #GtkBorder structure.
+Frees a #GtkBorder-struct.
</description>
<parameters>
<parameter name="border_">
-<parameter_description> a #GtkBorder
+<parameter_description> a #GtkBorder-struct
</parameter_description>
</parameter>
</parameters>
@@ -18422,14 +18864,14 @@ Frees a #GtkBorder structure.
<function name="gtk_border_new">
<description>
-Allocates a new #GtkBorder structure and initializes its elements to zero.
+Allocates a new #GtkBorder-struct and initializes its elements to zero.
Since: 2.14
</description>
<parameters>
</parameters>
-<return> a newly allocated #GtkBorder. Free with gtk_border_free()
+<return> a newly allocated #GtkBorder-struct. Free with gtk_border_free()
</return>
</function>
@@ -18606,22 +19048,22 @@ Obtains information about how @child is packed into @box.
</parameter_description>
</parameter>
<parameter name="expand">
-<parameter_description> pointer to return location for #GtkBox:expand child
+<parameter_description> pointer to return location for expand child
property
</parameter_description>
</parameter>
<parameter name="fill">
-<parameter_description> pointer to return location for #GtkBox:fill child
+<parameter_description> pointer to return location for fill child
property
</parameter_description>
</parameter>
<parameter name="padding">
-<parameter_description> pointer to return location for #GtkBox:padding
+<parameter_description> pointer to return location for padding
child property
</parameter_description>
</parameter>
<parameter name="pack_type">
-<parameter_description> pointer to return location for #GtkBox:pack-type
+<parameter_description> pointer to return location for pack-type
child property
</parameter_description>
</parameter>
@@ -18632,8 +19074,7 @@ child property
<function name="gtk_box_reorder_child">
<description>
Moves @child to a new @position in the list of @box children.
-The list is the <structfield>children</structfield> field of
-#GtkBox-struct, and contains both widgets packed #GTK_PACK_START
+The list contains widgets packed #GTK_PACK_START
as well as widgets packed #GTK_PACK_END, in the order that these
widgets were added to @box.
@@ -18666,7 +19107,7 @@ the list
<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,
+child. If there is more vertical space available than requested,
and the baseline is not allocated by the parent then
@position is used to allocate the baseline wrt the
extra space available.
@@ -18702,19 +19143,19 @@ Sets the way @child is packed into @box.
</parameter_description>
</parameter>
<parameter name="expand">
-<parameter_description> the new value of the #GtkBox:expand child property
+<parameter_description> the new value of the expand child property
</parameter_description>
</parameter>
<parameter name="fill">
-<parameter_description> the new value of the #GtkBox:fill child property
+<parameter_description> the new value of the fill child property
</parameter_description>
</parameter>
<parameter name="padding">
-<parameter_description> the new value of the #GtkBox:padding child property
+<parameter_description> the new value of the padding child property
</parameter_description>
</parameter>
<parameter name="pack_type">
-<parameter_description> the new value of the #GtkBox:pack-type child property
+<parameter_description> the new value of the pack-type child property
</parameter_description>
</parameter>
</parameters>
@@ -18910,7 +19351,7 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="parser">
-<parameter_description> a #GMarkupParser structure to fill in
+<parameter_description> a #GMarkupParser to fill in
</parameter_description>
</parameter>
<parameter name="data">
@@ -19233,7 +19674,7 @@ domain.
<note><para>
If you are adding an object that depends on an object that is not
its child (for instance a #GtkTreeView that depends on its
-#GtkTreeModel), you have to explicitely list all of them in @object_ids.
+#GtkTreeModel), you have to explicitly list all of them in @object_ids.
</para></note>
Since: 2.14
@@ -19275,7 +19716,7 @@ domain.
<note><para>
If you are adding an object that depends on an object that is not
its child (for instance a #GtkTreeView that depends on its
-#GtkTreeModel), you have to explicitely list all of them in @object_ids.
+#GtkTreeModel), you have to explicitly list all of them in @object_ids.
</para></note>
Since: 3.4
@@ -19316,7 +19757,7 @@ Upon errors 0 will be returned and @error will be assigned a
<note><para>
If you are adding an object that depends on an object that is not
its child (for instance a #GtkTreeView that depends on its
-#GtkTreeModel), you have to explicitely list all of them in @object_ids.
+#GtkTreeModel), you have to explicitly list all of them in @object_ids.
</para></note>
Since: 2.14
@@ -19382,7 +19823,7 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> a pointer to a structure sent in as user data to all signals
+<parameter_description> user data to pass back with all signals
</parameter_description>
</parameter>
</parameters>
@@ -19623,7 +20064,7 @@ Since: 3.10
</parameter_description>
</parameter>
</parameters>
-<return> a #Gtkbuilder containing the described interface
+<return> a #GtkBuilder containing the described interface
</return>
</function>
@@ -19645,7 +20086,7 @@ Since: 3.10
</parameter_description>
</parameter>
</parameters>
-<return> a #Gtkbuilder containing the described interface
+<return> a #GtkBuilder containing the described interface
</return>
</function>
@@ -19675,7 +20116,7 @@ Since: 3.10
</parameter_description>
</parameter>
</parameters>
-<return> a #Gtkbuilder containing the interface described by @string
+<return> a #GtkBuilder containing the interface described by @string
</return>
</function>
@@ -25032,7 +25473,7 @@ the requested format.
</parameter>
<parameter name="len">
<parameter_description> length of @text, in bytes, or -1, in which case
-the length will be determined with <function>strlen()</function>.
+the length will be determined with strlen().
</parameter_description>
</parameter>
</parameters>
@@ -28172,7 +28613,7 @@ a spacer.
</parameter_description>
</parameter>
<parameter name="border_width">
-<parameter_description> amount of blank space to leave <emphasis>outside</emphasis>
+<parameter_description> amount of blank space to leave outside
the container. Valid values are in the range 0-65535 pixels.
</parameter_description>
</parameter>
@@ -28853,6 +29294,9 @@ Returns the action area of @dialog.
Since: 2.14
+Deprecated:3.12: Direct access to the action area
+is discouraged; use gtk_dialog_add_button(), etc.
+
</description>
<parameters>
<parameter name="dialog">
@@ -28860,7 +29304,7 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> the action area.
+<return> the action area
</return>
</function>
@@ -28883,6 +29327,26 @@ Since: 2.14
</return>
</function>
+<function name="gtk_dialog_get_header_bar">
+<description>
+Returns the header bar of @dialog. Note that the
+headerbar is only used by the dialog if the
+#GtkDialog:use-header-bar property is %TRUE.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="dialog">
+<parameter_description> a #GtkDialog
+</parameter_description>
+</parameter>
+</parameters>
+<return> the header bar
+
+</return>
+</function>
+
<function name="gtk_dialog_get_response_for_widget">
<description>
Gets the response id of a widget in the action area
@@ -29069,7 +29533,7 @@ gtk_widget_destroy (dialog);
Note that even though the recursive main loop gives the effect of a
modal dialog (it prevents the user from interacting with other
windows in the same window group while the dialog is run), callbacks
-such as timeouts, IO channel watches, DND drops, etc, <emphasis>will</emphasis>
+such as timeouts, IO channel watches, DND drops, etc, will
be triggered during a gtk_dialog_run() call.
@@ -29123,6 +29587,7 @@ GTK_RESPONSE_HELP,
]|
Since: 2.6
+Deprecated: 3.10: Deprecated
</description>
<parameters>
@@ -29154,6 +29619,7 @@ See gtk_dialog_set_alternative_button_order() for more information.
This function is for use by language bindings.
Since: 2.6
+Deprecated: 3.10: Deprecated
</description>
<parameters>
@@ -31392,7 +31858,7 @@ Since: 2.16
</description>
<parameters>
<parameter name="entry">
-<parameter_description> a #GtkIconEntry
+<parameter_description> a #GtkEntry
</parameter_description>
</parameter>
</parameters>
@@ -32632,7 +33098,7 @@ Since: 2.16
<function name="gtk_entry_set_inner_border">
<description>
-Sets %entry's inner-border property to %border, or clears it if %NULL
+Sets %entry's inner-border property to @border, or clears it if %NULL
is passed. The inner-border is the area around the entry's text, but
inside its frame.
@@ -32924,7 +33390,7 @@ as plaintext
<description>
Changes the size request of the entry to be about the right size
for @n_chars characters. Note that it changes the size
-<emphasis>request</emphasis>, the size can still be affected by
+request, the size can still be affected by
how you pack the widget into containers. If @n_chars is -1, the
size reverts to the default entry size.
@@ -33912,7 +34378,7 @@ Gets the current folder of @chooser as a local filename.
See gtk_file_chooser_set_current_folder().
Note that this is the folder that the file chooser is currently displaying
-(e.g. "/home/username/Documents"), which is <emphasis>not the same</emphasis>
+(e.g. "/home/username/Documents"), which is not the same
as the currently-selected folder if the chooser is in
%GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER mode
(e.g. "/home/username/Documents/selected-folder/". To get the
@@ -33963,7 +34429,7 @@ Gets the current folder of @chooser as an URI.
See gtk_file_chooser_set_current_folder_uri().
Note that this is the folder that the file chooser is currently displaying
-(e.g. "file:///home/username/Documents"), which is <emphasis>not the same</emphasis>
+(e.g. "file:///home/username/Documents"), which is not the same
as the currently-selected folder if the chooser is in
%GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER mode
(e.g. "file:///home/username/Documents/selected-folder/". To get the
@@ -34851,10 +35317,10 @@ gtk_file_chooser_select_filename().
Note that the file must exist, or nothing will be done except
for the directory change.
-If you are implementing a <guimenuitem>File/Save As...</guimenuitem> dialog,
+If you are implementing a save dialog,
you should use this function if you already have a file name to which the
user may save; for example, when the user opens an existing file and then
-does <guimenuitem>File/Save As...</guimenuitem> on it. If you don't have
+does Save As... If you don't have
a file name already — for example, if the user just created a new
file and is saving it for the first time, do not call this function.
Instead, use something similar to this:
@@ -34905,10 +35371,10 @@ the dialog's file name entry.
Note that the file must exist, or nothing will be done except
for the directory change.
-You should use this function only when implementing a <guimenuitem>File/Save
-As...</guimenuitem> dialog for which you already have a file name to which
+You should use this function only when implementing a save
+dialog for which you already have a file name to which
the user may save. For example, when the user opens an existing file and
-then does <guimenuitem>File/Save As...</guimenuitem> on it to save a copy or
+then does Save As... to save a copy or
a modified version. If you don't have a file name already — for
example, if the user just created a new file and is saving it for the first
time, do not call this function. Instead, use something similar to this:
@@ -35112,10 +35578,10 @@ name will also appear in the dialog's file name entry.
Note that the URI must exist, or nothing will be done except for the
directory change.
-You should use this function only when implementing a <guimenuitem>File/Save
-As...</guimenuitem> dialog for which you already have a file name to which
-the user may save. For example, whenthe user opens an existing file and then
-does <guimenuitem>File/Save As...</guimenuitem> on it to save a copy or a
+You should use this function only when implementing a save
+dialog for which you already have a file name to which
+the user may save. For example, when the user opens an existing file and then
+does Save As... to save a copy or a
modified version. If you don't have a file name already — for example,
if the user just created a new file and is saving it for the first time, do
not call this function. Instead, use something similar to this:
@@ -35379,7 +35845,7 @@ Since: 2.6
<function name="gtk_file_filter_filter">
<description>
Tests whether a file should be displayed according to @filter.
-The #GtkFileFilterInfo structure @filter_info should include
+The #GtkFileFilterInfo @filter_info should include
the fields returned from gtk_file_filter_get_needed().
This function will not typically be used by applications; it
@@ -35395,7 +35861,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="filter_info">
-<parameter_description> a #GtkFileFilterInfo structure containing information
+<parameter_description> a #GtkFileFilterInfo containing information
about a file.
</parameter_description>
</parameter>
@@ -35427,7 +35893,7 @@ be modified or freed.
<function name="gtk_file_filter_get_needed">
<description>
-Gets the fields that need to be filled in for the structure
+Gets the fields that need to be filled in for the #GtkFileFilterInfo
passed to gtk_file_filter_filter()
This function will not typically be used by applications; it
@@ -38703,7 +39169,7 @@ Since: 3.10
</parameter>
</parameters>
<return> the custom title widget
-of the header, or %NULL if none has been set explicitely.
+of the header, or %NULL if none has been set explicitly.
</return>
</function>
@@ -38729,9 +39195,6 @@ Since: 3.12
<function name="gtk_header_bar_get_has_subtitle">
<description>
-Returns whether the header bar reserves space
-for a subtitle.
-
Since: 3.12
</description>
@@ -38741,7 +39204,10 @@ Since: 3.12
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the header bar reserves space
+for a subtitle.
+
+</return>
</function>
<function name="gtk_header_bar_get_show_close_button">
@@ -38777,7 +39243,7 @@ Since: 3.10
</parameter>
</parameters>
<return> the subtitle of the header, or %NULL if none has
-been set explicitely. The returned string is owned by the widget
+been set explicitly. The returned string is owned by the widget
and must not be modified or freed.
</return>
@@ -38797,7 +39263,7 @@ Since: 3.10
</parameter>
</parameters>
<return> the title of the header, or %NULL if none has
-been set explicitely. The returned string is owned by the widget
+been set explicitly. The returned string is owned by the widget
and must not be modified or freed.
</return>
@@ -39568,7 +40034,7 @@ Since: 2.4
</description>
<parameters>
<parameter name="icon_info">
-<parameter_description> a #GtkIconInfo structure
+<parameter_description> a #GtkIconInfo
</parameter_description>
</parameter>
</parameters>
@@ -39665,7 +40131,7 @@ Since: 3.12
</description>
<parameters>
<parameter name="icon_info">
-<parameter_description> a #GtkIconInfo structure
+<parameter_description> a #GtkIconInfo
</parameter_description>
</parameter>
</parameters>
@@ -39693,7 +40159,7 @@ Since: 2.4
</description>
<parameters>
<parameter name="icon_info">
-<parameter_description> a #GtkIconInfo structure from gtk_icon_theme_lookup_icon()
+<parameter_description> a #GtkIconInfo from gtk_icon_theme_lookup_icon()
</parameter_description>
</parameter>
<parameter name="error">
@@ -39723,7 +40189,7 @@ Since: 3.8
</description>
<parameters>
<parameter name="icon_info">
-<parameter_description> a #GtkIconInfo structure from gtk_icon_theme_lookup_icon()
+<parameter_description> a #GtkIconInfo from gtk_icon_theme_lookup_icon()
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -39753,7 +40219,7 @@ Since: 3.8
</description>
<parameters>
<parameter name="icon_info">
-<parameter_description> a #GtkIconInfo structure from gtk_icon_theme_lookup_icon()
+<parameter_description> a #GtkIconInfo from gtk_icon_theme_lookup_icon()
</parameter_description>
</parameter>
<parameter name="res">
@@ -39793,7 +40259,7 @@ Since: 3.10
</description>
<parameters>
<parameter name="icon_info">
-<parameter_description> a #GtkIconInfo structure from gtk_icon_theme_lookup_icon()
+<parameter_description> a #GtkIconInfo from gtk_icon_theme_lookup_icon()
</parameter_description>
</parameter>
<parameter name="for_window">
@@ -39890,7 +40356,7 @@ Since: 3.8
</description>
<parameters>
<parameter name="icon_info">
-<parameter_description> a #GtkIconInfo structure from gtk_icon_theme_lookup_icon()
+<parameter_description> a #GtkIconInfo from gtk_icon_theme_lookup_icon()
</parameter_description>
</parameter>
<parameter name="fg">
@@ -39939,7 +40405,7 @@ Since: 3.8
</description>
<parameters>
<parameter name="icon_info">
-<parameter_description> a #GtkIconInfo structure from gtk_icon_theme_lookup_icon()
+<parameter_description> a #GtkIconInfo from gtk_icon_theme_lookup_icon()
</parameter_description>
</parameter>
<parameter name="res">
@@ -40021,7 +40487,7 @@ Since: 3.8
</description>
<parameters>
<parameter name="icon_info">
-<parameter_description> a #GtkIconInfo structure from gtk_icon_theme_lookup_icon()
+<parameter_description> a #GtkIconInfo from gtk_icon_theme_lookup_icon()
</parameter_description>
</parameter>
<parameter name="context">
@@ -40055,7 +40521,7 @@ Since: 3.8
</description>
<parameters>
<parameter name="icon_info">
-<parameter_description> a #GtkIconInfo structure from gtk_icon_theme_lookup_icon()
+<parameter_description> a #GtkIconInfo from gtk_icon_theme_lookup_icon()
</parameter_description>
</parameter>
<parameter name="res">
@@ -40676,7 +41142,7 @@ Deprecated: 3.10: Use #GtkIconTheme instead.
<function name="gtk_icon_source_get_direction">
<description>
Obtains the text direction this icon source applies to. The return
-value is only useful/meaningful if the text direction is <emphasis>not</emphasis>
+value is only useful/meaningful if the text direction is not
wildcarded.
Deprecated: 3.10: Use #GtkIconTheme instead.
@@ -40758,7 +41224,7 @@ Retrieves the source pixbuf, or %NULL if none is set.
In addition, if a filename source is in use, this
function in some cases will return the pixbuf from
loaded from the filename. This is, for example, true
-for the GtkIconSource passed to the GtkStyle::render_icon()
+for the GtkIconSource passed to the #GtkStyle render_icon(<!-- -->)
virtual function. The reference count on the pixbuf is
not incremented.
@@ -40779,7 +41245,7 @@ Deprecated: 3.10: Use #GtkIconTheme instead.
<function name="gtk_icon_source_get_size">
<description>
Obtains the icon size this source applies to. The return value
-is only useful/meaningful if the icon size is <emphasis>not</emphasis> wildcarded.
+is only useful/meaningful if the icon size is not wildcarded.
Deprecated: 3.10: Use #GtkIconTheme instead.
@@ -40816,7 +41282,7 @@ Deprecated: 3.10: Use #GtkIconTheme instead.
<function name="gtk_icon_source_get_state">
<description>
Obtains the widget state this icon source applies to. The return
-value is only useful/meaningful if the widget state is <emphasis>not</emphasis>
+value is only useful/meaningful if the widget state is not
wildcarded.
Deprecated: 3.10: Use #GtkIconTheme instead.
@@ -41186,7 +41652,7 @@ Since: 2.4
<function name="gtk_icon_theme_choose_icon">
<description>
-Looks up a named icon and returns a structure containing
+Looks up a named icon and returns a #GtkIconInfo 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()
@@ -41227,7 +41693,7 @@ about the icon, or %NULL if the icon wasn't found.
<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
+#GtkIconInfo 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.)
@@ -41626,7 +42092,7 @@ your reference to the icon. %NULL if the icon isn't found.
<function name="gtk_icon_theme_lookup_by_gicon">
<description>
-Looks up an icon and returns a structure containing
+Looks up an icon and returns a #GtkIconInfo containing
information such as the filename of the icon.
The icon can then be rendered into a pixbuf using
gtk_icon_info_load_icon().
@@ -41652,7 +42118,7 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> a #GtkIconInfo structure containing
+<return> a #GtkIconInfo containing
information about the icon, or %NULL if the icon
wasn't found. Unref with g_object_unref()
@@ -41661,10 +42127,10 @@ wasn't found. Unref with g_object_unref()
<function name="gtk_icon_theme_lookup_by_gicon_for_scale">
<description>
-Looks up an icon and returns a structure containing
+Looks up an icon and returns a #GtkIconInfo 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 ().
+gtk_icon_info_load_icon().
Since: 3.10
@@ -41691,7 +42157,7 @@ Since: 3.10
</parameter_description>
</parameter>
</parameters>
-<return> a #GtkIconInfo structure containing
+<return> a #GtkIconInfo containing
information about the icon, or %NULL if the icon
wasn't found. Unref with g_object_unref()
@@ -41700,7 +42166,7 @@ wasn't found. Unref with g_object_unref()
<function name="gtk_icon_theme_lookup_icon">
<description>
-Looks up a named icon and returns a structure containing
+Looks up a named icon and returns a #GtkIconInfo 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()
@@ -41736,7 +42202,7 @@ about the icon, or %NULL if the icon wasn't found.
<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
+#GtkIconInfo 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.)
@@ -45086,7 +45552,7 @@ Note that there are some alternative ways to initialize GTK+:
if you are calling gtk_parse_args(), gtk_init_check(),
gtk_init_with_args() or g_option_context_parse() with
the option group returned by gtk_get_option_group(),
-you <emphasis>don't</emphasis> have to call gtk_init().
+you don't have to call gtk_init().
<note><para>
This function will terminate your program if it was unable to
@@ -48937,8 +49403,7 @@ Emits the #GtkMenuItem::activate signal on the given item
<function name="gtk_menu_item_deselect">
<description>
-Emits the #GtkMenuItem::deselect signal on the given item. Behaves
-exactly like #gtk_item_deselect.
+Emits the #GtkMenuItem::deselect signal on the given item.
</description>
<parameters>
@@ -49118,8 +49583,7 @@ mnemonic character
<function name="gtk_menu_item_select">
<description>
-Emits the #GtkMenuItem::select signal on the given item. Behaves
-exactly like #gtk_item_select.
+Emits the #GtkMenuItem::select signal on the given item.
</description>
<parameters>
@@ -49810,7 +50274,7 @@ then you would use the action name "mygroup.quit" in your
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
-gtk_application_set_menu_bar().
+gtk_application_set_menubar().
Since: 3.6
@@ -50045,7 +50509,7 @@ propagated to submenus whenever a submenu is popped up, so you
don't have to worry about recursively setting it for your entire
menu hierarchy. Only when programmatically picking a submenu and
popping it up manually, the @take_focus property of the submenu
-needs to be set explicitely.
+needs to be set explicitly.
Note that setting it to %FALSE has side-effects:
@@ -50205,48 +50669,6 @@ 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
@@ -53763,7 +54185,7 @@ Deprecated:3.0: Use gtk_render_activity() instead
</parameter_description>
</parameter>
<parameter name="step">
-<parameter_description> the nth step, a value between 0 and #GtkSpinner:num-steps
+<parameter_description> the nth step
</parameter_description>
</parameter>
<parameter name="x">
@@ -54570,7 +54992,7 @@ to a display. (See gdk_display_open(), gdk_get_display_arg_name())
Any arguments used by GTK+ or GDK are removed from the array and
@argc and @argv are updated accordingly.
-There is no need to call this function explicitely if you are using
+There is no need to call this function explicitly if you are using
gtk_init(), or gtk_init_check().
@@ -54645,7 +55067,7 @@ 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
+connect to the #GtkPlacesSidebar::populate-popup signal, you can use this
function to get the location that is being referred to during the callbacks
for your menu items.
@@ -55120,6 +55542,193 @@ Since: 2.2
</return>
</function>
+<function name="gtk_popover_get_modal">
+<description>
+Returns whether the popover is modal, see gtk_popover_set_modal to
+see the implications of this.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="popover">
+<parameter_description> a #GtkPopover
+</parameter_description>
+</parameter>
+</parameters>
+<return> #TRUE if @popover is modal
+
+</return>
+</function>
+
+<function name="gtk_popover_get_pointing_to">
+<description>
+If a rectangle to point to has been set, this function will
+return %TRUE and fill in @rect with such rectangle, otherwise
+it will return %FALSE and fill in @rect with the attached
+widget coordinates.
+
+
+</description>
+<parameters>
+<parameter name="popover">
+<parameter_description> a #GtkPopover
+</parameter_description>
+</parameter>
+<parameter name="rect">
+<parameter_description> location to store the rectangle
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if a rectangle to point to was set.
+</return>
+</function>
+
+<function name="gtk_popover_get_position">
+<description>
+Returns the preferred position of @popover.
+
+
+</description>
+<parameters>
+<parameter name="popover">
+<parameter_description> a #GtkPopover
+</parameter_description>
+</parameter>
+</parameters>
+<return> The preferred position.
+</return>
+</function>
+
+<function name="gtk_popover_get_relative_to">
+<description>
+Returns the wigdet @popover is currently attached to
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="popover">
+<parameter_description> a #GtkPopover
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GtkWidget
+
+</return>
+</function>
+
+<function name="gtk_popover_new">
+<description>
+Creates a new popover to point to @relative_to
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="relative_to">
+<parameter_description> #GtkWidget the popover is related to
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GtkPopover
+
+</return>
+</function>
+
+<function name="gtk_popover_set_modal">
+<description>
+Sets whether @popover is modal, a modal popover will grab all input
+within the toplevel and grab the keyboard focus on it when being
+displayed. Clicking outside the popover area or pressing Esc will
+dismiss the popover and ungrab input.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="popover">
+<parameter_description> a #GtkPopover
+</parameter_description>
+</parameter>
+<parameter name="modal">
+<parameter_description> #TRUE to make popover claim all input within the toplevel
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_popover_set_pointing_to">
+<description>
+Sets the rectangle that @popover will point to, in the coordinate
+space of the widget @popover is attached to, see
+gtk_popover_set_relative_to()
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="popover">
+<parameter_description> a #GtkPopover
+</parameter_description>
+</parameter>
+<parameter name="rect">
+<parameter_description> rectangle to point to
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_popover_set_position">
+<description>
+Sets the preferred position for @popover to appear. If the @popover
+is currently visible, it will be immediately updated.
+
+<note>
+This preference will be respected where possible, although
+on lack of space (eg. if close to the window edges), the
+#GtkPopover may choose to appear on the opposite side
+</note>
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="popover">
+<parameter_description> a #GtkPopover
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> preferred popover position
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_popover_set_relative_to">
+<description>
+Sets a new widget to be attached to @popover. If @popover is
+visible, the position will be updated.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="popover">
+<parameter_description> a #GtkPopover
+</parameter_description>
+</parameter>
+<parameter name="relative_to">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_print_backend_get_printer_list">
<description>
Returns the current list of printers.
@@ -56680,7 +57289,7 @@ Since: 2.10
<description>
Sets the number of pages in the document.
-This <emphasis>must</emphasis> be set to a positive number
+This must be set to a positive number
before the rendering starts. It may be set in a
#GtkPrintOperation::begin-print signal hander.
@@ -58681,7 +59290,7 @@ Since: 2.10
<description>
Gets a new #GtkPrintSettings object that represents the
current values in the print dialog. Note that this creates a
-<emphasis>new object</emphasis>, and you need to unref it
+new object, and you need to unref it
if don't want to keep it.
Since: 2.10
@@ -61011,7 +61620,7 @@ to store this information, you should make a copy.
<function name="gtk_rc_get_im_module_file">
<description>
Obtains the path to the IM modules file. See the documentation
-of the <link
linkend="im-module-file"><envar>GTK_IM_MODULE_FILE</envar></link>
+of the <envar>GTK_IM_MODULE_FILE</envar>
environment variable for more details.
Deprecated: 3.0: Use #GtkCssProvider instead.
@@ -61028,7 +61637,7 @@ name of the file listing the IM modules available for loading
<function name="gtk_rc_get_im_module_path">
<description>
Obtains the path in which to look for IM modules. See the documentation
-of the <link linkend="im-module-path"><envar>GTK_PATH</envar></link>
+of the <envar>GTK_PATH</envar>
environment variable for more details about looking up modules. This
function is useful solely for utilities supplied with GTK+ and should
not be used by applications under normal circumstances.
@@ -61171,7 +61780,7 @@ is searched in the current directory.
<function name="gtk_rc_parse_color">
<description>
-Parses a color in the <link linkend="color=format">format</link> expected
+Parses a color in the format expected
in a RC file.
Note that theme engines should use gtk_rc_parse_color_full() in
@@ -61186,7 +61795,7 @@ Deprecated:3.0: Use #GtkCssProvider instead
</parameter_description>
</parameter>
<parameter name="color">
-<parameter_description> a pointer to a #GdkColor structure in which to store
+<parameter_description> a pointer to a #GdkColor in which to store
the result
</parameter_description>
</parameter>
@@ -61199,7 +61808,7 @@ that was expected but not found
<function name="gtk_rc_parse_color_full">
<description>
-Parses a color in the <link linkend="color=format">format</link> expected
+Parses a color in the format expected
in a RC file. If @style is not %NULL, it will be consulted to resolve
references to symbolic colors.
@@ -61218,7 +61827,7 @@ Deprecated:3.0: Use #GtkCssProvider instead
</parameter_description>
</parameter>
<parameter name="color">
-<parameter_description> a pointer to a #GdkColor structure in which to store
+<parameter_description> a pointer to a #GdkColor in which to store
the result
</parameter_description>
</parameter>
@@ -61239,7 +61848,7 @@ Deprecated:3.0: Use #GtkCssProvider instead
</description>
<parameters>
<parameter name="scanner">
-<parameter_description> a #GtkScanner (must be initialized for parsing an RC file)
+<parameter_description> a #GScanner (must be initialized for parsing an RC file)
</parameter_description>
</parameter>
<parameter name="priority">
@@ -61301,7 +61910,7 @@ A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
or gtk_widget_class_install_style_property_parser() which parses
borders in the form
<literal>"{ left, right, top, bottom }"</literal> for integers
-%left, %right, %top and %bottom.
+left, right, top and bottom.
</description>
@@ -61329,8 +61938,8 @@ has been set to the resulting #GtkBorder.
A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
or gtk_widget_class_install_style_property_parser() which parses a
color given either by its name or in the form
-<literal>{ red, green, blue }</literal> where %red, %green and
-%blue are integers between 0 and 65535 or floating-point numbers
+<literal>{ red, green, blue }</literal> where red, green and
+blue are integers between 0 and 65535 or floating-point numbers
between 0 and 1.
@@ -61493,7 +62102,7 @@ of all widgets, because when a widget gets a new style, it will
both redraw and recompute any cached information about its
appearance. As an example, it is used when the default font size
set by the operating system changes. Note that this function
-doesn't affect widgets that have a style set explicitely on them
+doesn't affect widgets that have a style set explicitly on them
with gtk_widget_set_style().
Since: 2.4
@@ -62708,7 +63317,7 @@ Since: 2.10
<function name="gtk_recent_filter_filter">
<description>
Tests whether a file should be displayed according to @filter.
-The #GtkRecentFilterInfo structure @filter_info should include
+The #GtkRecentFilterInfo @filter_info should include
the fields returned from gtk_recent_filter_get_needed().
This function will not typically be used by applications; it
@@ -62724,7 +63333,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="filter_info">
-<parameter_description> a #GtkRecentFilterInfo structure containing information
+<parameter_description> a #GtkRecentFilterInfo containing information
about a recently used resource
</parameter_description>
</parameter>
@@ -62756,7 +63365,7 @@ is owned by the filter object and should not be freed.
<function name="gtk_recent_filter_get_needed">
<description>
-Gets the fields that need to be filled in for the structure
+Gets the fields that need to be filled in for the #GtkRecentFilterInfo
passed to gtk_recent_filter_filter()
This function will not typically be used by applications; it
@@ -63309,7 +63918,7 @@ Since: 2.10
<function name="gtk_recent_info_match">
<description>
-Checks whether two #GtkRecentInfo structures point to the same
+Checks whether two #GtkRecentInfo-struct point to the same
resource.
Since: 2.10
@@ -63325,7 +63934,7 @@ Since: 2.10
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if both #GtkRecentInfo structures point to se same
+<return> %TRUE if both #GtkRecentInfo-struct point to se same
resource, %FALSE otherwise.
</return>
@@ -63370,20 +63979,20 @@ Since: 2.10
<function name="gtk_recent_manager_add_full">
<description>
Adds a new resource, pointed by @uri, into the recently used
-resources list, using the metadata specified inside the #GtkRecentData
-structure passed in @recent_data.
+resources list, using the metadata specified inside the #GtkRecentData-struct
+passed in @recent_data.
The passed URI will be used to identify this resource inside the
list.
In order to register the new recently used resource, metadata about
the resource must be passed as well as the URI; the metadata is
-stored in a #GtkRecentData structure, which must contain the MIME
+stored in a #GtkRecentData-struct, which must contain the MIME
type of the resource pointed by the URI; the name of the application
that is registering the item, and a command line to be used when
launching the item.
-Optionally, a #GtkRecentData structure might contain a UTF-8 string
+Optionally, a #GtkRecentData-struct might contain a UTF-8 string
to be used when viewing the item instead of the last component of the
URI; a short description of the item; whether the item should be
considered private - that is, should be displayed only by the
@@ -63505,7 +64114,7 @@ Since: 2.10
<function name="gtk_recent_manager_lookup_item">
<description>
Searches for a URI inside the recently used resources list, and
-returns a structure containing informations about the resource
+returns a #GtkRecentInfo-struct containing informations about the resource
like its MIME type, or its display name.
Since: 2.10
@@ -63525,7 +64134,7 @@ Since: 2.10
</parameter_description>
</parameter>
</parameters>
-<return> a #GtkRecentInfo structure containing information
+<return> a #GtkRecentInfo-struct containing information
about the resource pointed by @uri, or %NULL if the URI was
not registered in the recently used resources list. Free with
gtk_recent_info_unref().
@@ -64405,7 +65014,7 @@ Frees a #GtkRequisition.
<function name="gtk_requisition_new">
<description>
-Allocates a new #GtkRequisition structure and initializes its elements to zero.
+Allocates a new #GtkRequisition-struct and initializes its elements to zero.
Since: 3.0
@@ -65917,7 +66526,7 @@ the search bar if necessary), %GDK_EVENT_PROPAGATE otherwise.
<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().
+gtk_search_bar_connect_entry().
Since: 3.10
@@ -65995,7 +66604,7 @@ given widget and selection.
</description>
<parameters>
<parameter name="widget">
-<parameter_description> a #GtkTarget
+<parameter_description> a #GtkWidget
</parameter_description>
</parameter>
<parameter name="selection">
@@ -66094,13 +66703,13 @@ this widget).
<function name="gtk_selection_data_copy">
<description>
-Makes a copy of a #GtkSelectionData structure and its data.
+Makes a copy of a #GtkSelectionData-struct and its data.
</description>
<parameters>
<parameter name="data">
-<parameter_description> a pointer to a #GtkSelectionData structure.
+<parameter_description> a pointer to a #GtkSelectionData-struct.
</parameter_description>
</parameter>
</parameters>
@@ -66110,13 +66719,13 @@ Makes a copy of a #GtkSelectionData structure and its data.
<function name="gtk_selection_data_free">
<description>
-Frees a #GtkSelectionData structure returned from
+Frees a #GtkSelectionData-struct returned from
gtk_selection_data_copy().
</description>
<parameters>
<parameter name="data">
-<parameter_description> a pointer to a #GtkSelectionData structure.
+<parameter_description> a pointer to a #GtkSelectionData-struct.
</parameter_description>
</parameter>
</parameters>
@@ -66132,7 +66741,7 @@ Since: 2.14
</description>
<parameters>
<parameter name="selection_data">
-<parameter_description> a pointer to a #GtkSelectionData structure.
+<parameter_description> a pointer to a #GtkSelectionData-struct.
</parameter_description>
</parameter>
</parameters>
@@ -66150,7 +66759,7 @@ Since: 2.14
</description>
<parameters>
<parameter name="selection_data">
-<parameter_description> a pointer to a #GtkSelectionData structure.
+<parameter_description> a pointer to a #GtkSelectionData-struct.
</parameter_description>
</parameter>
</parameters>
@@ -66168,7 +66777,7 @@ Since: 3.0
</description>
<parameters>
<parameter name="selection_data">
-<parameter_description> a pointer to a #GtkSelectionData structure
+<parameter_description> a pointer to a #GtkSelectionData-struct.
</parameter_description>
</parameter>
<parameter name="length">
@@ -66190,7 +66799,7 @@ Since: 2.14
</description>
<parameters>
<parameter name="selection_data">
-<parameter_description> a pointer to a #GtkSelectionData structure.
+<parameter_description> a pointer to a #GtkSelectionData-struct.
</parameter_description>
</parameter>
</parameters>
@@ -66208,7 +66817,7 @@ Since: 2.14
</description>
<parameters>
<parameter name="selection_data">
-<parameter_description> a pointer to a #GtkSelectionData structure.
+<parameter_description> a pointer to a #GtkSelectionData-struct.
</parameter_description>
</parameter>
</parameters>
@@ -66226,7 +66835,7 @@ Since: 2.14
</description>
<parameters>
<parameter name="selection_data">
-<parameter_description> a pointer to a #GtkSelectionData structure.
+<parameter_description> a pointer to a #GtkSelectionData-struct.
</parameter_description>
</parameter>
</parameters>
@@ -66265,7 +66874,7 @@ Since: 2.16
</description>
<parameters>
<parameter name="selection_data">
-<parameter_description> a pointer to a #GtkSelectionData structure.
+<parameter_description> a pointer to a #GtkSelectionData-struct.
</parameter_description>
</parameter>
</parameters>
@@ -66283,7 +66892,7 @@ Since: 2.14
</description>
<parameters>
<parameter name="selection_data">
-<parameter_description> a pointer to a #GtkSelectionData structure.
+<parameter_description> a pointer to a #GtkSelectionData-struct.
</parameter_description>
</parameter>
</parameters>
@@ -66366,13 +66975,13 @@ non-%NULL it must be freed with g_strfreev().
<function name="gtk_selection_data_set">
<description>
Stores new data into a #GtkSelectionData object. Should
-<emphasis>only</emphasis> be called from a selection handler callback.
+only be called from a selection handler callback.
Zero-terminates the stored data.
</description>
<parameters>
<parameter name="selection_data">
-<parameter_description> a pointer to a #GtkSelectionData structure.
+<parameter_description> a pointer to a #GtkSelectionData-struct.
</parameter_description>
</parameter>
<parameter name="type">
@@ -66824,9 +67433,6 @@ 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.
-This function can be used as a replacement for gnome_vfs_url_show()
-and gnome_url_show().
-
Since: 2.14
</description>
@@ -67826,6 +68432,30 @@ Since: 3.10
<return></return>
</function>
+<function name="gtk_stack_get_child_by_name">
+<description>
+Finds the child of the #GtkStack with the name given as
+the argument. Returns %NULL if there is no child with this
+name.
+
+Since: 3.12
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of the child to find
+</parameter_description>
+</parameter>
+</parameters>
+<return> the requested child of the #GtkStack
+
+</return>
+</function>
+
<function name="gtk_stack_get_homogeneous">
<description>
Gets whether @stack is homogeneous.
@@ -68928,7 +69558,7 @@ Since: 2.10
<description>
Returns a new context identifier, given a description
of the actual context. Note that the description is
-<emphasis>not</emphasis> shown in the UI.
+not shown in the UI.
</description>
@@ -70870,7 +71500,7 @@ Since: 2.16
</parameter_description>
</parameter>
<parameter name="var_args">
-<parameter_description> a <type>va_list</type> of pairs of property names and
+<parameter_description> a va_list of pairs of property names and
locations to return the property values, starting with the
location for @first_property_name.
</parameter_description>
@@ -71944,7 +72574,7 @@ Deprecated: 3.4: Use gtk_grid_get_row_spacing() with #GtkGrid.
<function name="gtk_table_get_homogeneous">
<description>
Returns whether the table cells are all constrained to the same
-width and height. (See gtk_table_set_homogenous ())
+width and height. (See gtk_table_set_homogeneous ())
Deprecated: 3.4: Use gtk_grid_get_row_homogeneous() and
gtk_grid_get_column_homogeneous() with #GtkGrid.
@@ -72047,7 +72677,7 @@ the cell containing the largest widget.
<function name="gtk_table_resize">
<description>
-If you need to change a table's size <emphasis>after</emphasis>
+If you need to change a table's size after
it has been created, this function allows you to do so.
Deprecated: 3.4: #GtkGrid resizes automatically.
@@ -72189,13 +72819,13 @@ Deprecated: 3.4: Use gtk_grid_set_row_spacing() with #GtkGrid.
<function name="gtk_target_entry_copy">
<description>
-Makes a copy of a #GtkTargetEntry structure and its data.
+Makes a copy of a #GtkTargetEntry and its data.
</description>
<parameters>
<parameter name="data">
-<parameter_description> a pointer to a #GtkTargetEntry structure.
+<parameter_description> a pointer to a #GtkTargetEntry
</parameter_description>
</parameter>
</parameters>
@@ -72206,13 +72836,13 @@ Free with gtk_target_entry_free()
<function name="gtk_target_entry_free">
<description>
-Frees a #GtkTargetEntry structure returned from
+Frees a #GtkTargetEntry returned from
gtk_target_entry_new() or gtk_target_entry_copy().
</description>
<parameters>
<parameter name="data">
-<parameter_description> a pointer to a #GtkTargetEntry structure.
+<parameter_description> a pointer to a #GtkTargetEntry.
</parameter_description>
</parameter>
</parameters>
@@ -72221,7 +72851,7 @@ gtk_target_entry_new() or gtk_target_entry_copy().
<function name="gtk_target_entry_new">
<description>
-Makes a new #GtkTargetEntry structure.
+Makes a new #GtkTargetEntry.
</description>
@@ -72239,7 +72869,7 @@ Makes a new #GtkTargetEntry structure.
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to a new GtkTargetEntry structure.
+<return> a pointer to a new #GtkTargetEntry.
Free with gtk_target_entry_free()
</return>
</function>
@@ -72272,7 +72902,7 @@ Appends another target to a #GtkTargetList.
<function name="gtk_target_list_add_image_targets">
<description>
-Appends the image targets supported by #GtkSelection to
+Appends the image targets supported by #GtkSelectionData to
the target list. All targets are added with the same @info.
Since: 2.6
@@ -72352,7 +72982,7 @@ Prepends a table of #GtkTargetEntry to a target list.
<function name="gtk_target_list_add_text_targets">
<description>
-Appends the text targets supported by #GtkSelection to
+Appends the text targets supported by #GtkSelectionData to
the target list. All targets are added with the same @info.
Since: 2.6
@@ -72373,7 +73003,7 @@ Since: 2.6
<function name="gtk_target_list_add_uri_targets">
<description>
-Appends the URI targets supported by #GtkSelection to
+Appends the URI targets supported by #GtkSelectionData to
the target list. All targets are added with the same @info.
Since: 2.6
@@ -73410,7 +74040,7 @@ newly-inserted text. The standard left-to-right cursor is a mark
with right gravity (when you type, the cursor stays on the right
side of the text you're typing).
-The caller of this function does <emphasis>not</emphasis> own a
+The caller of this function does not own a
reference to the returned #GtkTextMark, so you can ignore the
return value if you like. Marks are owned by the buffer and go
away when the buffer does.
@@ -73534,7 +74164,7 @@ re-initialized to point to the location where text was deleted.
<function name="gtk_text_buffer_delete_interactive">
<description>
-Deletes all <emphasis>editable</emphasis> text in the given range.
+Deletes all editable text in the given range.
Calls gtk_text_buffer_delete() for each editable sub-range of
[ start,@end). @start and @end are revalidated to point to
the location of the last deleted range, or left untouched if
@@ -73959,7 +74589,7 @@ than the number of lines in the @buffer, the end iterator is returned.
<description>
Obtains an iterator pointing to @byte_index within the given line.
@byte_index must be the start of a UTF-8 character, and must not be
-beyond the end of the line. Note <emphasis>bytes</emphasis>, not
+beyond the end of the line. Note bytes, not
characters; UTF-8 may encode one character as multiple bytes.
</description>
@@ -73988,7 +74618,7 @@ characters; UTF-8 may encode one character as multiple bytes.
<description>
Obtains an iterator pointing to @char_offset within the given
line. The @char_offset must exist, offsets off the end of the line
-are not allowed. Note <emphasis>characters</emphasis>, not bytes;
+are not allowed. Note characters, not bytes;
UTF-8 may encode one character as multiple bytes.
</description>
@@ -74226,7 +74856,7 @@ text (text marked with tags that set the invisibility attribute) if
@include_hidden_chars is %FALSE. The returned string includes a
0xFFFC character whenever the buffer contains
embedded images, so byte and character indexes into
-the returned string <emphasis>do</emphasis> correspond to byte
+the returned string do correspond to byte
and character indexes into the buffer. Contrast with
gtk_text_buffer_get_text(). Note that 0xFFFC can occur in normal
text as well, so it is not a reliable indicator that a pixbuf or
@@ -74298,7 +74928,7 @@ Returns the text in the range [ start,@end). Excludes undisplayed
text (text marked with tags that set the invisibility attribute) if
@include_hidden_chars is %FALSE. Does not include characters
representing embedded images, so byte and character indexes into
-the returned string do <emphasis>not</emphasis> correspond to byte
+the returned string do not correspond to byte
and character indexes into the buffer. Contrast with
gtk_text_buffer_get_slice().
@@ -75759,7 +76389,7 @@ 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
+character 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.
@@ -75926,8 +76556,8 @@ 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 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,
+at the end of the tagged range, but that the character
+at @iter is outside 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.
@@ -76047,7 +76677,7 @@ a carriage return/newline sequence. For some Unicode characters,
the equivalent of say the letter "a" with an accent mark will be
represented as two characters, first the letter then a "combining
mark" that causes the accent to be rendered; so the cursor can't go
-between those two characters. See also the #PangoLogAttr structure and
+between those two characters. See also the #PangoLogAttr-struct and
pango_break() function.
@@ -76823,7 +77453,7 @@ itself.
<function name="gtk_text_iter_get_text">
<description>
-Returns <emphasis>text</emphasis> in the given range. If the range
+Returns text in the given range. If the range
contains non-text elements such as images, the character and byte
offsets in the returned string will not correspond to character and
byte offsets in the buffer. If you want offsets to correspond, see
@@ -76852,7 +77482,7 @@ point. (If @toggled_on is %TRUE, the list contains tags that are
toggled on.) If a tag is toggled on at @iter, then some non-empty
range of characters following @iter has that tag applied to it. If
a tag is toggled off, then some non-empty range following @iter
-does <emphasis>not</emphasis> have the tag applied to it.
+does not have the tag applied to it.
</description>
@@ -77138,7 +77768,7 @@ buffer, moves @iter to the start of the last line in the buffer.
<function name="gtk_text_iter_set_line_index">
<description>
Same as gtk_text_iter_set_line_offset(), but works with a
-<emphasis>byte</emphasis> index. The given byte index must be at
+byte index. The given byte index must be at
the start of a character, it can't be in the middle of a UTF-8
encoded character.
@@ -77159,7 +77789,7 @@ encoded character.
<function name="gtk_text_iter_set_line_offset">
<description>
-Moves @iter within a line, to a new <emphasis>character</emphasis>
+Moves @iter within a line, to a new character
(not byte) offset. The given character offset must be less than or
equal to the number of characters in the line; if equal, @iter
moves to the start of the next line. See
@@ -77302,7 +77932,7 @@ algorithms).
<description>
This is equivalent to (gtk_text_iter_begins_tag () ||
gtk_text_iter_ends_tag ()), i.e. it tells you whether a range with
- tag applied to it begins <emphasis>or</emphasis> ends at @iter.
+ tag applied to it begins or ends at @iter.
</description>
@@ -78620,7 +79250,7 @@ those to buffer coordinates with
gtk_text_view_window_to_buffer_coords().
Note that this is different from gtk_text_view_get_iter_at_location(),
-which returns cursor locations, i.e. positions <emphasis>between</emphasis>
+which returns cursor locations, i.e. positions between
characters.
Since: 2.6
@@ -83352,7 +83982,7 @@ You must free this iter with gtk_tree_iter_free().
</description>
<parameters>
<parameter name="iter">
-<parameter_description> a #GtkTreeIter
+<parameter_description> a #GtkTreeIter-struct
</parameter_description>
</parameter>
</parameters>
@@ -83564,7 +84194,7 @@ Since: 2.4
With the @n_columns and @types parameters, you give an array of column
types for this model (which will be exposed to the parent model/view).
The @func, @data and @destroy parameters are for specifying the modify
-function. The modify function will get called for <emphasis>each</emphasis>
+function. The modify function will get called for each
data access, the goal of the modify function is to return the data which
should be displayed at the location specified using the parameters of the
modify function.
@@ -83715,7 +84345,7 @@ each column number followed by a place to store the value being
retrieved. The list is terminated by a -1. For example, to get a
value from column 0 with type %G_TYPE_STRING, you would
write: <literal>gtk_tree_model_get (model, iter, 0, &place_string_here, -1)</literal>,
-where <literal>place_string_here</literal> is a <type>gchar*</type>
+where <literal>place_string_here</literal> is a #gchararray
to be filled with the string.
Returned values with type %G_TYPE_OBJECT have to be unreferenced,
@@ -83794,11 +84424,11 @@ not exist, @iter is set to an invalid iterator and %FALSE is returned.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the uninitialized #GtkTreeIter
+<parameter_description> the uninitialized #GtkTreeIter-struct
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> the #GtkTreePath
+<parameter_description> the #GtkTreePath-struct
</parameter_description>
</parameter>
</parameters>
@@ -83820,7 +84450,7 @@ Initializes @iter with the first iterator in the tree
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the uninitialized #GtkTreeIter
+<parameter_description> the uninitialized #GtkTreeIter-struct
</parameter_description>
</parameter>
</parameters>
@@ -83841,11 +84471,11 @@ exists. Otherwise, @iter is left invalid and %FALSE is returned.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> an uninitialized #GtkTreeIter
+<parameter_description> an uninitialized #GtkTreeIter-struct
</parameter_description>
</parameter>
<parameter name="path_string">
-<parameter_description> a string representation of a #GtkTreePath
+<parameter_description> a string representation of a #GtkTreePath-struct
</parameter_description>
</parameter>
</parameters>
@@ -83871,7 +84501,7 @@ Returns the number of columns supported by @tree_model.
<function name="gtk_tree_model_get_path">
<description>
-Returns a newly-created #GtkTreePath referenced by @iter.
+Returns a newly-created #GtkTreePath-struct referenced by @iter.
This path should be freed with gtk_tree_path_free().
@@ -83883,11 +84513,11 @@ This path should be freed with gtk_tree_path_free().
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter
+<parameter_description> the #GtkTreeIter-struct
</parameter_description>
</parameter>
</parameters>
-<return> a newly-created #GtkTreePath
+<return> a newly-created #GtkTreePath-struct
</return>
</function>
@@ -83908,7 +84538,7 @@ Since: 2.2
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a #GtkTreeIter
+<parameter_description> a #GtkTreeIter-struct
</parameter_description>
</parameter>
</parameters>
@@ -83920,7 +84550,7 @@ Must be freed with g_free().
<function name="gtk_tree_model_get_valist">
<description>
-See gtk_tree_model_get(), this version takes a <type>va_list</type>
+See gtk_tree_model_get(), this version takes a va_list
for language bindings to use.
</description>
@@ -83934,7 +84564,7 @@ for language bindings to use.
</parameter_description>
</parameter>
<parameter name="var_args">
-<parameter_description> <type>va_list</type> of column/return location pairs
+<parameter_description> va_list of column/return location pairs
</parameter_description>
</parameter>
</parameters>
@@ -83955,7 +84585,7 @@ to free any allocated memory.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter
+<parameter_description> the #GtkTreeIter-struct
</parameter_description>
</parameter>
<parameter name="column">
@@ -83989,11 +84619,11 @@ If @parent is %NULL returns the first node, equivalent to
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the new #GtkTreeIter to be set to the child
+<parameter_description> the new #GtkTreeIter-struct to be set to the child
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> the #GtkTreeIter, or %NULL
+<parameter_description> the #GtkTreeIter-struct, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -84013,7 +84643,7 @@ Returns %TRUE if @iter has children, %FALSE otherwise.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter to test for children
+<parameter_description> the #GtkTreeIter-struct to test for children
</parameter_description>
</parameter>
</parameters>
@@ -84036,7 +84666,7 @@ of toplevel nodes is returned.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter, or %NULL
+<parameter_description> the #GtkTreeIter-struct, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -84059,7 +84689,7 @@ to be invalid.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter
+<parameter_description> the #GtkTreeIter-struct
</parameter_description>
</parameter>
</parameters>
@@ -84085,11 +84715,11 @@ is set.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter to set to the nth child
+<parameter_description> the #GtkTreeIter-struct to set to the nth child
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> the #GtkTreeIter to get the child from, or %NULL.
+<parameter_description> the #GtkTreeIter-struct to get the child from, or %NULL.
</parameter_description>
</parameter>
<parameter name="n">
@@ -84118,11 +84748,11 @@ called.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the new #GtkTreeIter to set to the parent
+<parameter_description> the new #GtkTreeIter-struct to set to the parent
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> the #GtkTreeIter
+<parameter_description> the #GtkTreeIter-struct
</parameter_description>
</parameter>
</parameters>
@@ -84146,7 +84776,7 @@ Since: 3.0
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter
+<parameter_description> the #GtkTreeIter-struct
</parameter_description>
</parameter>
</parameters>
@@ -84182,7 +84812,7 @@ of its reffed state.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter
+<parameter_description> the #GtkTreeIter-struct
</parameter_description>
</parameter>
</parameters>
@@ -84200,11 +84830,11 @@ Emits the #GtkTreeModel::row-changed signal on @tree_model.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath pointing to the changed row
+<parameter_description> a #GtkTreePath-struct pointing to the changed row
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a valid #GtkTreeIter pointing to the changed row
+<parameter_description> a valid #GtkTreeIter-struct pointing to the changed row
</parameter_description>
</parameter>
</parameters>
@@ -84229,7 +84859,7 @@ outstanding references on the deleted node should not be released.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath pointing to the previous location of
+<parameter_description> a #GtkTreePath-struct pointing to the previous location of
the deleted row
</parameter_description>
</parameter>
@@ -84250,11 +84880,11 @@ state of a node changes.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath pointing to the changed row
+<parameter_description> a #GtkTreePath-struct pointing to the changed row
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a valid #GtkTreeIter pointing to the changed row
+<parameter_description> a valid #GtkTreeIter-struct pointing to the changed row
</parameter_description>
</parameter>
</parameters>
@@ -84272,11 +84902,11 @@ Emits the #GtkTreeModel::row-inserted signal on @tree_model.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath pointing to the inserted row
+<parameter_description> a #GtkTreePath-struct pointing to the inserted row
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a valid #GtkTreeIter pointing to the inserted row
+<parameter_description> a valid #GtkTreeIter-struct pointing to the inserted row
</parameter_description>
</parameter>
</parameters>
@@ -84297,12 +84927,12 @@ reordered.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath pointing to the tree node whose children
+<parameter_description> a #GtkTreePath-struct 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
+<parameter_description> a valid #GtkTreeIter-struct pointing to the node whose children
have been reordered, or %NULL if the depth of @path is 0
</parameter_description>
</parameter>
@@ -84332,12 +84962,12 @@ Since: 3.10
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath pointing to the tree node whose children
+<parameter_description> a #GtkTreePath-struct 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
+<parameter_description> a valid #GtkTreeIter-struct pointing to the node
whose children have been reordered, or %NULL if the depth
of @path is 0
</parameter_description>
@@ -84586,7 +85216,7 @@ Please note that nodes that are deleted are not unreffed.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter
+<parameter_description> the #GtkTreeIter-struct
</parameter_description>
</parameter>
</parameters>
@@ -84602,7 +85232,7 @@ As a result, the depth of the path is increased.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath
+<parameter_description> a #GtkTreePath-struct
</parameter_description>
</parameter>
<parameter name="index_">
@@ -84625,11 +85255,11 @@ If the two nodes are equal, then 0 is returned.
</description>
<parameters>
<parameter name="a">
-<parameter_description> a #GtkTreePath
+<parameter_description> a #GtkTreePath-struct
</parameter_description>
</parameter>
<parameter name="b">
-<parameter_description> a #GtkTreePath to compare with
+<parameter_description> a #GtkTreePath-struct to compare with
</parameter_description>
</parameter>
</parameters>
@@ -84639,17 +85269,17 @@ If the two nodes are equal, then 0 is returned.
<function name="gtk_tree_path_copy">
<description>
-Creates a new #GtkTreePath as a copy of @path.
+Creates a new #GtkTreePath-struct as a copy of @path.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath
+<parameter_description> a #GtkTreePath-struct
</parameter_description>
</parameter>
</parameters>
-<return> a new #GtkTreePath
+<return> a new #GtkTreePath-struct
</return>
</function>
@@ -84660,7 +85290,7 @@ Moves @path to point to the first child of the current path.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath
+<parameter_description> a #GtkTreePath-struct
</parameter_description>
</parameter>
</parameters>
@@ -84674,7 +85304,7 @@ Frees @path. If @path is %NULL, it simply returns.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath
+<parameter_description> a #GtkTreePath-struct
</parameter_description>
</parameter>
</parameters>
@@ -84689,7 +85319,7 @@ Returns the current depth of @path.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath
+<parameter_description> a #GtkTreePath-struct
</parameter_description>
</parameter>
</parameters>
@@ -84710,7 +85340,7 @@ The length of the array can be obtained with gtk_tree_path_get_depth().
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath
+<parameter_description> a #GtkTreePath-struct
</parameter_description>
</parameter>
</parameters>
@@ -84731,7 +85361,7 @@ Since: 3.0
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath
+<parameter_description> a #GtkTreePath-struct
</parameter_description>
</parameter>
<parameter name="depth">
@@ -84754,11 +85384,11 @@ Returns %TRUE if @descendant is a descendant of @path.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath
+<parameter_description> a #GtkTreePath-struct
</parameter_description>
</parameter>
<parameter name="descendant">
-<parameter_description> another #GtkTreePath
+<parameter_description> another #GtkTreePath-struct
</parameter_description>
</parameter>
</parameters>
@@ -84774,11 +85404,11 @@ Returns %TRUE if @path is a descendant of @ancestor.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath
+<parameter_description> a #GtkTreePath-struct
</parameter_description>
</parameter>
<parameter name="ancestor">
-<parameter_description> another #GtkTreePath
+<parameter_description> another #GtkTreePath-struct
</parameter_description>
</parameter>
</parameters>
@@ -84788,20 +85418,20 @@ Returns %TRUE if @path is a descendant of @ancestor.
<function name="gtk_tree_path_new">
<description>
-Creates a new #GtkTreePath.
-This structure refers to a row.
+Creates a new #GtkTreePath-struct.
+This refers to a row.
</description>
<parameters>
</parameters>
-<return> A newly created #GtkTreePath.
+<return> A newly created #GtkTreePath-struct.
</return>
</function>
<function name="gtk_tree_path_new_first">
<description>
-Creates a new #GtkTreePath.
+Creates a new #GtkTreePath-struct.
The string representation of this path is "0".
@@ -84809,7 +85439,7 @@ The string representation of this path is "0".
</description>
<parameters>
</parameters>
-<return> A new #GtkTreePath
+<return> A new #GtkTreePath-struct
</return>
</function>
@@ -84830,7 +85460,7 @@ Since: 2.2
</parameter_description>
</parameter>
</parameters>
-<return> A newly created #GtkTreePath
+<return> A newly created #GtkTreePath-struct
</return>
</function>
@@ -84852,14 +85482,14 @@ Since: 3.12
</parameter_description>
</parameter>
</parameters>
-<return> A newly created #GtkTreePath
+<return> A newly created #GtkTreePath-struct
</return>
</function>
<function name="gtk_tree_path_new_from_string">
<description>
-Creates a new #GtkTreePath initialized to @path.
+Creates a new #GtkTreePath-struct initialized to @path.
@path is expected to be a colon separated list of numbers.
For example, the string "10:4:0" would create a path of depth
@@ -84875,7 +85505,7 @@ If an invalid path string is passed in, %NULL is returned.
</parameter_description>
</parameter>
</parameters>
-<return> A newly-created #GtkTreePath, or %NULL
+<return> A newly-created #GtkTreePath-struct, or %NULL
</return>
</function>
@@ -84886,7 +85516,7 @@ Moves the @path to point to the next node at the current depth.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath
+<parameter_description> a #GtkTreePath-struct
</parameter_description>
</parameter>
</parameters>
@@ -84902,7 +85532,7 @@ As a result, the depth of the path is increased.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath
+<parameter_description> a #GtkTreePath-struct
</parameter_description>
</parameter>
<parameter name="index_">
@@ -84922,7 +85552,7 @@ current depth, if it exists.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath
+<parameter_description> a #GtkTreePath-struct
</parameter_description>
</parameter>
</parameters>
@@ -84943,7 +85573,7 @@ return value for this string.
</description>
<parameters>
<parameter name="path">
-<parameter_description> A #GtkTreePath
+<parameter_description> A #GtkTreePath-struct
</parameter_description>
</parameter>
</parameters>
@@ -84960,7 +85590,7 @@ Moves the @path to point to its parent node, if it has a parent.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath
+<parameter_description> a #GtkTreePath-struct
</parameter_description>
</parameter>
</parameters>
@@ -85092,7 +85722,7 @@ propagated, and the path is updated appropriately. If
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a valid #GtkTreePath to monitor
+<parameter_description> a valid #GtkTreePath-struct to monitor
</parameter_description>
</parameter>
</parameters>
@@ -85139,7 +85769,7 @@ itself, and is not generally needed by most applications.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a valid #GtkTreePath to monitor
+<parameter_description> a valid #GtkTreePath-struct to monitor
</parameter_description>
</parameter>
</parameters>
@@ -86153,7 +86783,7 @@ are supported.
As an example, <literal>gtk_tree_store_new (3, G_TYPE_INT, G_TYPE_STRING,
GDK_TYPE_PIXBUF);</literal> will create a new #GtkTreeStore with three columns, of type
-<type>int</type>, <type>string</type> and #GdkPixbuf respectively.
+#gint, #gchararray, and #GdkPixbuf respectively.
</description>
@@ -86350,7 +86980,7 @@ or a method on the #GtkTreeModel interface is called.
<function name="gtk_tree_store_set_valist">
<description>
-See gtk_tree_store_set(); this version takes a <type>va_list</type> for
+See gtk_tree_store_set(); this version takes a va_list for
use by language bindings.
@@ -86365,7 +86995,7 @@ use by language bindings.
</parameter_description>
</parameter>
<parameter name="var_args">
-<parameter_description> <type>va_list</type> of column/value pairs
+<parameter_description> va_list of column/value pairs
</parameter_description>
</parameter>
</parameters>
@@ -87541,7 +88171,7 @@ the arrow.
<description>
Changes the appearance of the sort indicator.
-This <emphasis>does not</emphasis> actually sort the model. Use
+This does not actually sort the model. Use
gtk_tree_view_column_set_sort_column_id() if you want automatic sorting
support. This function is primarily for custom sorting behavior, and should
be used in conjunction with gtk_tree_sortable_set_sort_column_id() to do
@@ -89764,12 +90394,12 @@ Since: 2.10
This function tells GTK+ 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 <emphasis>not</emphasis> use it
+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 <emphasis>semantic</emphasis>
+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).
@@ -91290,7 +91920,7 @@ Since: 3.10
<function name="gtk_widget_class_bind_template_child_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().
+on a freshly built instance's private data, or alternatively accessible via gtk_widget_get_template_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).
@@ -91306,7 +91936,7 @@ If @internal_child is specified, #GtkBuildableIface.get_internal_child() will be
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()
+gtk_widget_class_bind_template_child_private() and gtk_widget_class_bind_template_child_internal_private()
might be more convenient to use.
<note><para>This must be called from a composite widget classes class
@@ -92675,6 +93305,8 @@ Since: 3.12
<description>
Gets the value of the #GtkWidget:margin-left property.
+Deprecated: 3.12: Use gtk_widget_get_margin_start() instead.
+
Since: 3.0
</description>
@@ -92693,6 +93325,8 @@ Since: 3.0
<description>
Gets the value of the #GtkWidget:margin-right property.
+Deprecated: 3.12: Use gtk_widget_get_margin_end() instead.
+
Since: 3.0
</description>
@@ -93083,7 +93717,7 @@ 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
+Use gtk_widget_get_preferred_height_and_baseline_for_width() if you want to support
baseline alignment.
Since: 3.0
@@ -93283,6 +93917,8 @@ and you should free those resources when the widget is unrealized.
Since: 2.2
+Deprecated: 3.12: Use gdk_screen_get_root_window() instead
+
</description>
<parameters>
<parameter name="widget">
@@ -93487,7 +94123,9 @@ gtk_widget_set_support_multidevice() for more information.
<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 will only report children which were previously declared with
+gtk_widget_class_bind_template_child_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
@@ -93588,8 +94226,8 @@ seem unlikely, it actually happens when a #GtkPlug is embedded
inside a #GtkSocket within the same application.
To reliably find the toplevel #GtkWindow, use
-gtk_widget_get_toplevel() and check if the %TOPLEVEL flags
-is set on the result.
+gtk_widget_get_toplevel() and call gtk_widget_is_toplevel()
+on the result.
|[
GtkWidget *toplevel = gtk_widget_get_toplevel (widget);
if (gtk_widget_is_toplevel (toplevel))
@@ -94156,8 +94794,8 @@ Since: 2.18
<function name="gtk_widget_is_focus">
<description>
Determines if the widget is the focus widget within its
-toplevel. (This does not mean that the %HAS_FOCUS flag is
-necessarily set; %HAS_FOCUS will only be set if the
+toplevel. (This does not mean that the #GtkWidget:has-focus property is
+necessarily set; #GtkWidget:has-focus will only be set if the
toplevel widget additionally has the global input focus.)
@@ -94317,7 +94955,7 @@ gtk_label_set_mnemonic_widget()).
The widgets in the list are not individually referenced. If you
want to iterate through the list and perform actions involving
callbacks that might destroy the widgets, you
-<emphasis>must</emphasis> call <literal>g_list_foreach (result,
+must call <literal>g_list_foreach (result,
(GFunc)g_object_ref, NULL)</literal> first, and then unref all the
widgets afterwards.
@@ -94461,8 +95099,8 @@ calls to of gtk_widget_modify_bg().
<function name="gtk_widget_modify_cursor">
<description>
-Sets the cursor color to use in a widget, overriding the
-#GtkWidget:cursor-color and #GtkWidget:secondary-cursor-color
+Sets the cursor color to use in a widget, overriding the #GtkWidget
+cursor-color and secondary-cursor-color
style properties.
All other style values are left untouched.
@@ -94553,8 +95191,8 @@ Modifies style values on the widget.
Modifications made using this technique take precedence over
style values set via an RC file, however, they will be overridden
-if a style is explicitely set on the widget using gtk_widget_set_style().
-The #GtkRcStyle structure is designed so each field can either be
+if a style is explicitly set on the widget using gtk_widget_set_style().
+The #GtkRcStyle-struct is designed so each field can either be
set or unset, so it is possible, using this function, to modify some
style values and leave the others unchanged.
@@ -94577,7 +95215,7 @@ Deprecated:3.0: Use #GtkStyleContext with a custom #GtkStyleProvider instead
</parameter_description>
</parameter>
<parameter name="style">
-<parameter_description> the #GtkRcStyle holding the style modifications
+<parameter_description> the #GtkRcStyle-struct holding the style modifications
</parameter_description>
</parameter>
</parameters>
@@ -94680,6 +95318,11 @@ Sets the color to use for a widget.
All other style values are left untouched.
+This function does not act recursively. Setting the color of a
+container does not affect its children. Note that some widgets that
+you may not think of as containers, for instance #GtkButton<!-- -->s,
+are actually containers.
+
<note><para>
This API is mostly meant as a quick way for applications to
change a widget appearance. If you are developing a widgets
@@ -94725,7 +95368,7 @@ of previous calls to gtk_widget_override_color()
<function name="gtk_widget_override_cursor">
<description>
Sets the cursor color to use in a widget, overriding the
-#GtkWidget:cursor-color and #GtkWidget:secondary-cursor-color
+cursor-color and secondary-cursor-color
style properties. All other style values are left untouched.
See also gtk_widget_modify_style().
@@ -96496,7 +97139,7 @@ packed. The ability to set the direction is present in order
so that correct localization into languages with right-to-left
reading directions can be done. Generally, applications will
let the default reading direction present, except for containers
-where the containers are arranged in an order that is explicitely
+where the containers are arranged in an order that is explicitly
visual rather than logical (such as buttons for text justification).
If the direction is set to %GTK_TEXT_DIR_NONE, then the value
@@ -96563,9 +97206,10 @@ changing the event mask you may disrupt a widget's functionality,
so be careful. This function must be called while a widget is
unrealized. Consider gtk_widget_add_events() for widgets that are
already realized, or if you want to preserve the existing event
-mask. This function can't be used with #GTK_NO_WINDOW widgets;
-to get events on those widgets, place them inside a #GtkEventBox
-and receive events on the event box.
+mask. This function can't be used with widgets that have no window.
+(See gtk_widget_get_has_window()). To get events on those widgets,
+place them inside a #GtkEventBox and receive events on the event
+box.
</description>
<parameters>
@@ -96794,6 +97438,8 @@ Since: 3.12
Sets the left margin of @widget.
See the #GtkWidget:margin-left property.
+Deprecated: 3.12: Use gtk_widget_set_margin_start() instead.
+
Since: 3.0
</description>
@@ -96815,6 +97461,8 @@ Since: 3.0
Sets the right margin of @widget.
See the #GtkWidget:margin-right property.
+Deprecated: 3.12: Use gtk_widget_set_margin_end() instead.
+
Since: 3.0
</description>
@@ -97064,13 +97712,14 @@ the entire widget is redrawn on every size change. If your widget
leaves the upper left unchanged when made bigger, turning this
setting off will improve performance.
-Note that for %NO_WINDOW widgets setting this flag to %FALSE turns
-off all allocation on resizing: the widget will not even redraw if
-its position changes; this is to allow containers that don't draw
-anything to avoid excess invalidations. If you set this flag on a
-%NO_WINDOW widget that <emphasis>does</emphasis> draw on @widget->window,
-you are responsible for invalidating both the old and new allocation
-of the widget when the widget is moved and responsible for invalidating
+Note that for widgets where gtk_widget_get_has_window() is %FALSE
+setting this flag to %FALSE turns off all allocation on resizing:
+the widget will not even redraw if its position changes; this is to
+allow containers that don't draw anything to avoid excess
+invalidations. If you set this flag on a widget with no window that
+does draw on @widget->window, you are
+responsible for invalidating both the old and new allocation of the
+widget when the widget is moved and responsible for invalidating
regions newly when the widget increases size.
</description>
@@ -97744,7 +98393,7 @@ bindings.
</parameter_description>
</parameter>
<parameter name="var_args">
-<parameter_description> a <type>va_list</type> of pairs of property names and
+<parameter_description> a va_list of pairs of property names and
locations to return the property values, starting with the location
for @first_property_name.
</parameter_description>
@@ -98770,7 +99419,7 @@ that size is the current size. To avoid race conditions, connect to
"configure-event" on the window and adjust your size-dependent
state to match the size delivered in the #GdkEventConfigure.
-Note 2: The returned size does <emphasis>not</emphasis> include the
+Note 2: The returned size does not include the
size of the window manager decorations (aka the window frame or
border). Those are not drawn by GTK+ and GTK+ has no reliable
method of determining their size.
@@ -98790,7 +99439,7 @@ of the window decorations/border into account, while your
application cannot.
In any case, if you insist on application-specified window
-positioning, there's <emphasis>still</emphasis> a better way than
+positioning, there's still a better way than
doing it yourself - gtk_window_set_position() will frequently
handle the details for you.
@@ -98862,7 +99511,7 @@ Retrieves the title of the window. See gtk_window_set_title().
</parameter>
</parameters>
<return> the title of the window, or %NULL if none has
-been set explicitely. The returned string is owned by the widget
+been set explicitly. The returned string is owned by the widget
and must not be modified or freed.
</return>
</function>
@@ -99165,7 +99814,7 @@ Since: 3.12
Returns a list of all existing toplevel windows. The widgets
in the list are not individually referenced. If you want
to iterate through the list and perform actions involving
-callbacks that might destroy the widgets, you <emphasis>must</emphasis> call
+callbacks that might destroy the widgets, you must call
<literal>g_list_foreach (result, (GFunc)g_object_ref, NULL)</literal> first, and
then unref all the widgets afterwards.
@@ -99301,6 +99950,14 @@ linkend="gtk-X11-arch">window manager</link>.
If you simply want an undecorated window (no window borders), use
gtk_window_set_decorated(), don't use #GTK_WINDOW_POPUP.
+All top-level windows created by gtk_window_new() are stored in
+an internal top-level window list. This list can be obtained from
+gtk_window_list_toplevels(). Due to Gtk+ keeping a reference to
+the window internally, gtk_window_new() does not return a reference
+to the caller.
+
+To delete a #GtkWindow, call gtk_window_destroy().
+
</description>
<parameters>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
