GDK 3 Reference Manual |
---|
- This document is for the GDK 3 library, version 3.22.19
+ This document is for the GDK 3 library, version 3.22.21
The latest versions can be found online at
https://developer.gnome.org/gdk3/.
diff -Nru gtk+3.0-3.22.19/docs/reference/gdk/version.xml gtk+3.0-3.22.21/docs/reference/gdk/version.xml
--- gtk+3.0-3.22.19/docs/reference/gdk/version.xml 2017-08-22 12:34:04.000000000 +0000
+++ gtk+3.0-3.22.21/docs/reference/gdk/version.xml 2017-09-11 15:21:07.000000000 +0000
@@ -1 +1 @@
-3.22.19
+3.22.21
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/broadwayd.1 gtk+3.0-3.22.21/docs/reference/gtk/broadwayd.1
--- gtk+3.0-3.22.19/docs/reference/gtk/broadwayd.1 2017-08-22 12:53:12.000000000 +0000
+++ gtk+3.0-3.22.21/docs/reference/gtk/broadwayd.1 2017-09-11 13:01:06.000000000 +0000
@@ -2,7 +2,7 @@
.\" Title: broadwayd
.\" Author: Alexander Larsson
.\" Generator: DocBook XSL Stylesheets vsnapshot
Example 3. Packing buttons with GtkBuilder
Create a new file with the following content named example-4.c.
+Create a new file with the following content named example-3.c.
#include <gtk/gtk.h> static void @@ -126,7 +126,7 @@ You can compile the program above with GCC using:
-gcc `pkg-config --cflags gtk+-3.0` -o example-4 example-4.c `pkg-config --libs gtk+-3.0`
+gcc `pkg-config --cflags gtk+-3.0` -o example-3 example-3.c `pkg-config --libs gtk+-3.0`
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/ch01s05.html gtk+3.0-3.22.21/docs/reference/gtk/html/ch01s05.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/ch01s05.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/ch01s05.html 2017-09-11 15:58:06.000000000 +0000 @@ -44,7 +44,7 @@
Example 4. Drawing in response to input
-Create a new file with the following content named example-3.c.
+Create a new file with the following content named example-4.c.
#include <gtk/gtk.h> /* Surface to store current scribbles */ @@ -243,7 +243,7 @@ You can compile the program above with GCC using:
-gcc `pkg-config --cflags gtk+-3.0` -o example-3 example-3.c `pkg-config --libs gtk+-3.0`
+gcc `pkg-config --cflags gtk+-3.0` -o example-4 example-4.c `pkg-config --libs gtk+-3.0`
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/ch26s02.html gtk+3.0-3.22.21/docs/reference/gtk/html/ch26s02.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/ch26s02.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/ch26s02.html 2017-09-11 15:58:06.000000000 +0000 @@ -418,15 +418,15 @@
cairo_region_t - GdkRectangle +GdkRectangle cairo_rectangle_int_t - + gdk_rectangle_intersect()
gdk_rectangle_intersect()
this function is still there - + gdk_rectangle_union()
gdk_rectangle_union()
this function is still there @@ -551,7 +551,7 @@ pixmap = gdk_pixmap_new (NULL, 1, 1, 1); -cr = gdk_cairo_create (pixmap); +cr = gdk_cairo_create (pixmap); cairo_rectangle (cr, 0, 0, 1, 1); cairo_fill (cr); cairo_destroy (cr); @@ -603,13 +603,13 @@ cairo_fill (cr); cairo_destroy (cr); -pixbuf = gdk_pixbuf_get_from_surface (s, +pixbuf = gdk_pixbuf_get_from_surface (s, 0, 0, 3, 3); cairo_surface_destroy (s); -cursor = gdk_cursor_new_from_pixbuf (display, pixbuf, 0, 0); +cursor = gdk_cursor_new_from_pixbuf (display, pixbuf, 0, 0); g_object_unref (pixbuf); @@ -628,7 +628,7 @@ Replace GdkColormap by GdkVisual
For drawing with cairo, it is not necessary to allocate colors, and
- a GdkVisual provides enough information for cairo to handle colors
+ a GdkVisual provides enough information for cairo to handle colors
in 'native' surfaces. Therefore, GdkColormap and related functions
have been removed in GTK+ 3, and visuals are used instead. The
colormap-handling functions of GtkWidget (gtk_widget_set_colormap()
,
@@ -701,10 +701,10 @@
GtkWidget *label)
{
GdkScreen *screen = gtk_widget_get_screen (GTK_WIDGET (window));
- GdkVisual *visual = gdk_screen_get_rgba_visual (screen);
+ GdkVisual *visual = gdk_screen_get_rgba_visual (screen);
if (visual == NULL)
- visual = gdk_screen_get_system_visual (screen);
+ visual = gdk_screen_get_system_visual (screen);
gtk_widget_set_visual (window, visual);
}
@@ -722,7 +722,7 @@
GdkDrawable is gone
GdkDrawable has been removed in GTK+ 3, together with GdkPixmap - and GdkImage. The only remaining drawable class is GdkWindow. + and GdkImage. The only remaining drawable class is GdkWindow. For dealing with image data, you should use a cairo_surface_t or a GdkPixbuf.
@@ -744,26 +744,26 @@gdk_drawable_get_visual()
gdk_window_get_visual()
gdk_window_get_visual()
gdk_drawable_get_size()
gdk_window_get_width()
- gdk_window_get_height()
+gdk_window_get_width()
+ gdk_window_get_height()
gdk_pixbuf_get_from_drawable()
gdk_pixbuf_get_from_window()
gdk_pixbuf_get_from_window()
gdk_drawable_get_clip_region()
gdk_window_get_clip_region()
gdk_window_get_clip_region()
gdk_drawable_get_visible_region()
gdk_window_get_visible_region()
gdk_window_get_visible_region()
The special-purpose GdkEventClient events and the gdk_add_client_message_filter()
and gdk_display_add_client_message_filter()
functions have been
removed. Receiving X11 ClientMessage events is still possible, using
- the general gdk_window_add_filter()
API. A client message filter like
+ the general gdk_window_add_filter()
API. A client message filter like
One advantage of using an event filter is that you can actually
remove the filter when you don't need it anymore, using
- gdk_window_remove_filter()
.
+ gdk_window_remove_filter()
.
The other difference to be aware of when working with event filters
@@ -881,7 +881,7 @@
means that your application does not receive core X11 key or button
events. Instead, all input events are delivered as XIDeviceEvents.
As a short-term workaround for this, you can force your application
- to not use XI2, with gdk_disable_multidevice()
. In the long term,
+ to not use XI2, with gdk_disable_multidevice()
. In the long term,
you probably want to rewrite your event filter to deal with
XIDeviceEvents.
In GTK+ 2.x, GDK could only be compiled for one backend at a time,
- and the GDK_WINDOWING_X11
or GDK_WINDOWING_WIN32
macros could
+ and the GDK_WINDOWING_X11
or GDK_WINDOWING_WIN32
macros could
be used to find out which one you are dealing with:
#ifdef GDK_WINDOWING_X11 if (timestamp != GDK_CURRENT_TIME) - gdk_x11_window_set_user_time (gdk_window, timestamp); + gdk_x11_window_set_user_time (gdk_window, timestamp); #endif #ifdef GDK_WINDOWING_WIN32 /* ... win32 specific code ... */ @@ -920,7 +920,7 @@In GTK+ 3, GDK can be built with multiple backends, and currently used backend has to be determined at runtime, typically using - type-check macros on a GdkDisplay or GdkWindow. You still need + type-check macros on a GdkDisplay or GdkWindow. You still need to use the GDK_WINDOWING macros to only compile code referring to supported backends:
@@ -950,7 +950,7 @@ if (GDK_IS_X11_DISPLAY (display)) { if (timestamp != GDK_CURRENT_TIME) - gdk_x11_window_set_user_time (gdk_window, timestamp); + gdk_x11_window_set_user_time (gdk_window, timestamp); } else #endif diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/ch32s05.html gtk+3.0-3.22.21/docs/reference/gtk/html/ch32s05.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/ch32s05.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/ch32s05.html 2017-09-11 15:58:06.000000000 +0000 @@ -60,8 +60,8 @@ behavior than before.- The Gtk+ scrolling implementation has changed.
gdk_window_scroll()
- andgdk_window_move_region()
no longer copy the region on the + The Gtk+ scrolling implementation has changed.gdk_window_scroll()
+ andgdk_window_move_region()
no longer copy the region on the window, but rather invalidate the entire scrolled region. This is slightly slower, but allowed us to implement a offscreen surface scrolling method which better fits modern hardware. Most scrolling diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/chap-css-overview.html gtk+3.0-3.22.21/docs/reference/gtk/html/chap-css-overview.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/chap-css-overview.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/chap-css-overview.html 2017-09-11 15:58:06.000000000 +0000 @@ -137,7 +137,7 @@ 4
button, entry { color: #ff00ea; - font: Comic Sans 12 + font: 12px "Comic Sans" }
box * { - font: Sans 20 + font: 20px Sans }
label#title-label { - font: Sans 15 + font: 15px Sans }
The windowing system generates events for native windows. The GDK
interface to the windowing system translates such native events into
- GdkEvent
+ GdkEvent
structures and sends them on to the GTK layer. In turn, the GTK layer
finds the widget that corresponds to a particular
GdkWindow
and emits the corresponding event
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/chap-input-handling.html gtk+3.0-3.22.21/docs/reference/gtk/html/chap-input-handling.html
--- gtk+3.0-3.22.19/docs/reference/gtk/html/chap-input-handling.html 2017-08-22 12:57:26.000000000 +0000
+++ gtk+3.0-3.22.21/docs/reference/gtk/html/chap-input-handling.html 2017-09-11 15:58:06.000000000 +0000
@@ -44,7 +44,7 @@
The most basic input devices that every computer user has interacted with are
keyboards and mice; beyond these, GTK+ supports touchpads, touchscreens and
more exotic input devices such as graphics tablets. Inside GTK+, every such
- input device is represented by a GdkDevice object.
+ input device is represented by a GdkDevice object.
To simplify dealing with the variability between these input devices, GTK+ @@ -67,16 +67,16 @@ the window with the keyboard focus.
- GDK translates these raw windowing system events into GdkEvents. + GDK translates these raw windowing system events into GdkEvents. Typical input events are:
GdkEventButton |
GdkEventMotion |
GdkEventCrossing |
GdkEventKey |
GdkEventFocus |
GdkEventTouch |
GdkEventButton |
GdkEventMotion |
GdkEventCrossing |
GdkEventKey |
GdkEventFocus |
GdkEventTouch |
@@ -85,14 +85,14 @@ grabs (system-wide or in-app) are taking input away:
GdkEventGrabBroken |
GdkEventGrabBroken |
“grab-notify” |
When GTK+ is initialized, it sets up an event handler function with
- gdk_event_handler_set()
, which receives all of these input events
+ gdk_event_handler_set()
, which receives all of these input events
(as well as others, for instance window management related events).
- For widgets which have a GdkWindow set, events are received from the
+ For widgets which have a GdkWindow set, events are received from the
windowing system and passed to gtk_main_do_event()
. See its documentation
for details of what it does: compression of enter/leave events,
identification of the widget receiving the event, pushing the event onto a
@@ -108,26 +108,26 @@
widget.
- When a GDK backend produces an input event, it is tied to a GdkDevice and
- a GdkWindow, which in turn represents a windowing system surface in the
+ When a GDK backend produces an input event, it is tied to a GdkDevice and
+ a GdkWindow, which in turn represents a windowing system surface in the
backend. If a widget has grabbed the current input device, or all input
devices, the event is propagated to that GtkWidget. Otherwise, it is
propagated to the the GtkWidget which called gtk_widget_register_window()
- on the GdkWindow receiving the event.
+ on the GdkWindow receiving the event.
Grabs are implemented for each input device, and globally. A grab for a
specific input device (gtk_device_grab_add()
), is sent events in
preference to a global grab (gtk_grab_add()
). Input grabs only have effect
within the GtkWindowGroup containing the GtkWidget which registered the
- event’s GdkWindow. If this GtkWidget is a child of the grab widget, the
+ event’s GdkWindow. If this GtkWidget is a child of the grab widget, the
event is propagated to the child — this is the basis for propagating
events within modal dialogs.
An event is propagated to a widget using gtk_propagate_event()
.
- Propagation differs between event types: key events (GDK_KEY_PRESS
,
- GDK_KEY_RELEASE
) are delivered to the top-level GtkWindow; other events
+ Propagation differs between event types: key events (GDK_KEY_PRESS
,
+ GDK_KEY_RELEASE
) are delivered to the top-level GtkWindow; other events
are propagated down and up the widget hierarchy in three phases (see
GtkPropagationPhase).
Any time during the propagation phase, a widget may indicate that a
received event was consumed and propagation should therefore be stopped.
- In traditional event handlers, this is hinted by returning GDK_EVENT_STOP
.
+ In traditional event handlers, this is hinted by returning GDK_EVENT_STOP
.
If gestures are used, this may happen when the widget tells the gesture
to claim the event touch sequence (or the pointer events) for its own. See the
"gesture states" section below to know more of the latter.
@@ -186,21 +186,21 @@
Each widget instance has a basic event mask and another per input device,
which determine the types of input event it receives. Each event mask set
on a widget is added to the corresponding (basic or per-device) event mask
- for the widget’s GdkWindow, and all child GdkWindows.
+ for the widget’s GdkWindow, and all child GdkWindows.
If a widget is windowless (gtk_widget_get_has_window()
returns FALSE
) and
an application wants to receive custom events on it, it must be placed
inside a GtkEventBox to receive the events, and an appropriate event mask
- must be set on the box. When implementing a widget, use a GDK_INPUT_ONLY
- GdkWindow to receive the events instead.
+ must be set on the box. When implementing a widget, use a GDK_INPUT_ONLY
+ GdkWindow to receive the events instead.
- Filtering events against event masks happens inside GdkWindow, which + Filtering events against event masks happens inside GdkWindow, which exposes event masks to the windowing system to reduce the number of events GDK receives from it. On receiving an event, it is filtered against the - GdkWindow’s mask for the input device, if set. Otherwise, it is filtered - against the GdkWindow’s basic event mask. + GdkWindow’s mask for the input device, if set. Otherwise, it is filtered + against the GdkWindow’s basic event mask.
This means that widgets must add to the event mask for each event type
@@ -208,7 +208,7 @@
gtk_widget_add_events()
to preserve the existing mask. Widgets which are
aware of floating devices should use gtk_widget_set_device_events()
or
gtk_widget_add_device_events()
, and must explicitly enable the device
- using gtk_widget_set_device_enabled()
. See the GdkDeviceManager
+ using gtk_widget_set_device_enabled()
. See the GdkDeviceManager
documentation for more information.
@@ -221,23 +221,23 @@
- Touch events are emitted as events of type GDK_TOUCH_BEGIN
, GDK_TOUCH_UPDATE
or
- GDK_TOUCH_END
, those events contain an “event sequence” that univocally identifies
+ Touch events are emitted as events of type GDK_TOUCH_BEGIN
, GDK_TOUCH_UPDATE
or
+ GDK_TOUCH_END
, those events contain an “event sequence” that univocally identifies
the physical touch until it is lifted from the device.
On some windowing platforms, multitouch devices perform pointer emulation, this works
by granting a “pointer emulating” hint to one of the currently interacting touch
- sequences, which will be reported on every GdkEventTouch event from that sequence. By
- default, if a widget didn't request touch events by setting GDK_TOUCH_MASK
on its
+ sequences, which will be reported on every GdkEventTouch event from that sequence. By
+ default, if a widget didn't request touch events by setting GDK_TOUCH_MASK
on its
event mask and didn't override “touch-event”, GTK+ will transform these
- “pointer emulating” events into semantically similar GdkEventButton and GdkEventMotion
- events. Depending on GDK_TOUCH_MASK
being in the event mask or not, non-pointer-emulating
+ “pointer emulating” events into semantically similar GdkEventButton and GdkEventMotion
+ events. Depending on GDK_TOUCH_MASK
being in the event mask or not, non-pointer-emulating
sequences could still trigger gestures or just get filtered out, regardless of the widget
not handling those directly.
- If the widget sets GDK_TOUCH_MASK
on its event mask and doesn't chain up on
+ If the widget sets GDK_TOUCH_MASK
on its event mask and doesn't chain up on
“touch-event”, only touch events will be received, and no pointer emulation
will be performed.
GDK_TOUCH_BEGIN
event.
+ GdkEventSequence will deliver only events to the widget that received its
+ GDK_TOUCH_BEGIN
event.
Explicit grabs happen programatically (both activation and deactivation), @@ -268,7 +268,7 @@ This makes it necessary for widgets to handle the cancellation of any ongoing interaction. Depending on whether a GTK or GDK grab is causing this, the widget will respectively receive a “grab-notify” signal, or a - GdkEventGrabBroken event. + GdkEventGrabBroken event.
On gestures, these signals are handled automatically, causing the gesture @@ -284,7 +284,7 @@
Event controllers are standalone objects that can perform specific actions - upon received GdkEvents. These are tied to a GtkWidget, and can be told of + upon received GdkEvents. These are tied to a GtkWidget, and can be told of the event propagation phase at which they will manage the events.
@@ -338,7 +338,7 @@
Alternatively, or at a later point in time, the widget may choose to deny the touch
sequences, thus letting those go through again in event propagation. When this happens
in the capture phase, and if there are no other claiming gestures in the widget,
- a GDK_TOUCH_BEGIN
/GDK_BUTTON_PRESS
event will be emulated and
+ a GDK_TOUCH_BEGIN
/GDK_BUTTON_PRESS
event will be emulated and
propagated downwards, in order to preserve consistency.
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Accelerator-Maps.html gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Accelerator-Maps.html
--- gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Accelerator-Maps.html 2017-08-22 12:57:26.000000000 +0000
+++ gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Accelerator-Maps.html 2017-09-11 15:58:06.000000000 +0000
@@ -267,7 +267,7 @@
(*GtkAccelMapForeach) (gpointer data
,
const gchar *accel_path
,
guint accel_key
,
- GdkModifierType accel_mods
,
+ GdkModifierType accel_mods
,
gboolean changed
);
void gtk_accel_map_add_entry (+const gchar *accel_path
,guint accel_key
, -GdkModifierType accel_mods
);
GdkModifierType accel_mods
);
Registers a new accelerator with the global accelerator map.
This function should only be called once per accel_path
@@ -403,7 +403,7 @@
gboolean gtk_accel_map_change_entry (const gchar *accel_path
,guint accel_key
, -GdkModifierType accel_mods
, +GdkModifierType accel_mods
,gboolean replace
);
Changes the accel_key
and accel_mods
@@ -775,7 +775,7 @@
user_function (GtkAccelMap *object,
gchar *accel_path,
guint accel_key,
- GdkModifierType accel_mods,
+ GdkModifierType accel_mods,
gpointer user_data)
Notifies of a change in the global accelerator map.
The path is also used as the detail for the signal,
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Bindings.html gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Bindings.html
--- gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Bindings.html 2017-08-22 12:57:26.000000000 +0000
+++ gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Bindings.html 2017-09-11 15:58:06.000000000 +0000
@@ -191,10 +191,10 @@
in the GtkCssProvider documentation. Inside the binding set
definition, key combinations are bound to one or more specific
signal emissions on the target widget. Key combinations are strings
-consisting of an optional GdkModifierType name and
+consisting of an optional GdkModifierType name and
key names
such as those defined in gdk/gdkkeysyms.h
-or returned from gdk_keyval_name()
, they have to be parsable by
+or returned from gdk_keyval_name()
, they have to be parsable by
gtk_accelerator_parse()
. Specifications of signal emissions consist
of a string identifying the signal name, and a list of signal specific
arguments in parenthesis.
void gtk_binding_entry_add_signall (GtkBindingSet *binding_set
,guint keyval
, -GdkModifierType modifiers
, +GdkModifierType modifiers
,const gchar *signal_name
,GSList *binding_args
);
Override or install a new key binding for keyval
@@ -470,7 +470,7 @@
gboolean gtk_bindings_activate (+GObject *object
,guint keyval
, -GdkModifierType modifiers
);
GdkModifierType modifiers
);
Find a key binding matching keyval
and modifiers
and activate the
@@ -513,7 +513,7 @@
gboolean gtk_bindings_activate_event (+GObject *object
, -GdkEventKey *event
);
GdkEventKey *event
);
Looks up key bindings for object
to find one matching
event
@@ -534,7 +534,7 @@
event
gboolean gtk_binding_set_activate (GtkBindingSet *binding_set
,guint keyval
, -GdkModifierType modifiers
, +GdkModifierType modifiers
,GObject *object
);
Find a key binding matching keyval
and modifiers
@@ -603,7 +603,7 @@
void gtk_binding_entry_add_signal (@@ -770,7 +770,7 @@GtkBindingSet *binding_set
,guint keyval
, -GdkModifierType modifiers
, +GdkModifierType modifiers
,const gchar *signal_name
,guint n_args
,...
);
void gtk_binding_entry_skip (+GtkBindingSet *binding_set
,guint keyval
, -GdkModifierType modifiers
);
GdkModifierType modifiers
);
Install a binding on binding_set
which causes key lookups
to be aborted, to prevent bindings from lower priority sets
@@ -810,7 +810,7 @@
void gtk_binding_entry_remove (+GtkBindingSet *binding_set
,guint keyval
, -GdkModifierType modifiers
);
GdkModifierType modifiers
);
Remove a binding previously installed via
gtk_binding_entry_add_signal()
on binding_set
.
GdkModifierType modifiers
;
GdkModifierType modifiers
;
key modifiers to match
The GtkClipboard object represents a clipboard of data shared
between different processes or between different widgets in
the same process. Each clipboard is identified by a name encoded as a
-GdkAtom. (Conversion to and from strings can be done with
-gdk_atom_intern()
and gdk_atom_name()
.) The default clipboard
+GdkAtom. (Conversion to and from strings can be done with
+gdk_atom_intern()
and gdk_atom_name()
.) The default clipboard
corresponds to the “CLIPBOARD” atom; another commonly used clipboard
is the “PRIMARY” clipboard, which, in X, traditionally contains
the currently selected text.
void (*GtkClipboardTargetsReceivedFunc) (GtkClipboard *clipboard
, -GdkAtom *atoms
, +GdkAtom *atoms
,gint n_atoms
,gpointer data
);
A function to be called when the results of gtk_clipboard_request_targets()
@@ -595,7 +595,7 @@
atoms
the supported targets,
-as array of GdkAtom, or NULL
if retrieving the data failed.
NULL
if retrieving the data failed.
void (*GtkClipboardRichTextReceivedFunc) (@@ -810,7 +810,7 @@GtkClipboard *clipboard
, -GdkAtom format
, +GdkAtom format
,const guint8 *text
,gsize length
,gpointer data
);
GtkClipboard *
-gtk_clipboard_get (GdkAtom selection
);
+gtk_clipboard_get (GdkAtom selection
);
.
@@ -821,8 +821,8 @@GtkClipboard * -gtk_clipboard_get_for_display (+gtk_clipboard_get_for_display (GdkDisplay *display
, -GdkAtom selection
);
GdkDisplay *display
,
+ GdkAtom selection
);
.
@@ -833,7 +833,7 @@GdkDisplay * +GdkDisplay * gtk_clipboard_get_display (GtkClipboard *clipboard
);Returns
@@ -846,7 +846,7 @@gtk_clipboard_get_default ()
GtkClipboard * -gtk_clipboard_get_default (+gtk_clipboard_get_default (GdkDisplay *display
);GdkDisplay *display
);Returns the default clipboard object for use with cut/copy/paste menu items and keyboard shortcuts.
@@ -859,7 +859,7 @@@@ -1067,7 +1067,7 @@- display
+ the GdkDisplay for which the clipboard is to be retrieved.
the GdkDisplay for which the clipboard is to be retrieved.
gtk_clipboard_request_contents ()
void gtk_clipboard_request_contents (GtkClipboard *clipboard
, -GdkAtom target
, +GdkAtom target
,GtkClipboardReceivedFunc callback
,gpointer user_data
);@@ -1211,7 +1211,7 @@gtk_clipboard_wait_for_contents ()
GtkSelectionData * gtk_clipboard_wait_for_contents (+GtkClipboard *clipboard
, -GdkAtom target
);GdkAtom target
);Returns
.
@@ -1247,7 +1247,7 @@guint8 * gtk_clipboard_wait_for_rich_text (GtkClipboard *clipboard
,GtkTextBuffer *buffer
, -GdkAtom *format
, +GdkAtom *format
,gsize *length
);Parameters
@@ -1439,7 +1439,7 @@gtk_clipboard_wait_for_targets ()
gboolean gtk_clipboard_wait_for_targets (GtkClipboard *clipboard
, -GdkAtom **targets
, +GdkAtom **targets
,gint *n_targets
);Parameters
@@ -1471,7 +1471,7 @@gboolean gtk_clipboard_wait_is_target_available (+GtkClipboard *clipboard
, -GdkAtom target
);GdkAtom target
);Checks if a clipboard supports pasting data of a given type. This function can be used to determine if a “Paste” menu item should be insensitive or not.
@@ -1493,7 +1493,7 @@
target
A GdkAtom indicating which target to look for.
A GdkAtom indicating which target to look for.
GdkAtom +GdkAtom gtk_clipboard_get_selection (GtkClipboard *clipboard
);Since: 3.22
“owner-change”
signalvoid user_function (GtkClipboard *clipboard, - GdkEvent *event, + GdkEvent *event, gpointer user_data)
GtkDestDefaults flags
,
const GtkTargetEntry *targets
,
gint n_targets
,
- GdkDragAction actions
);
+ GdkDragAction actions
);
Sets a widget as a potential drop destination, and adds default behaviors.
The default behaviors listed in flags
have an effect similar
@@ -405,7 +405,7 @@
behaviors described by flags
make some assumptions, that can conflict
with your own signal handlers. For instance GTK_DEST_DEFAULT_DROP causes
-invokations of gdk_drag_status()
in the context of “drag-motion”,
+invokations of gdk_drag_status()
in the context of “drag-motion”,
and invokations of gtk_drag_finish()
in “drag-data-received”.
Especially the later is dramatic, when your own “drag-motion”
handler calls gtk_drag_get_data()
to inspect the dragged data.
void gtk_drag_dest_set_proxy (GtkWidget *widget
, -GdkWindow *proxy_window
, -GdkDragProtocol protocol
, +GdkWindow *proxy_window
, +GdkDragProtocol protocol
,gboolean use_coordinates
);
gtk_drag_dest_set_proxy
has been deprecated since version 3.22 and should not be used in newly-written code.
Sets this widget as a proxy for drops to another window.
@@ -575,15 +575,15 @@GdkAtom +GdkAtom gtk_drag_dest_find_target (GtkWidget *widget
, -GdkDragContext *context
, +GdkDragContext *context
,GtkTargetList *target_list
);Looks for a match between the supported targets of
context
and thedest_target_list
, returning the first matching target, otherwise -returningGDK_NONE
.dest_target_list
+returningGDK_NONE
.dest_target_list
should usually be the return value fromgtk_drag_dest_get_target_list()
, but some widgets may have different valid targets for different parts of the widget; in @@ -622,7 +622,7 @@
void -gtk_drag_finish (@@ -891,8 +891,8 @@GdkDragContext *context
, +gtk_drag_finish (GdkDragContext *context
,gboolean success
,gboolean del
,guint32 time_
);
void gtk_drag_get_data (GtkWidget *widget
, -GdkDragContext *context
, -GdkAtom target
, +GdkDragContext *context
, +GdkAtom target
,guint32 time_
);
Gets the data associated with a drag. When the data is received or the retrieval fails, GTK+ will emit a @@ -944,7 +944,7 @@
GtkWidget *
-gtk_drag_get_source_widget (GdkDragContext *context
);
+gtk_drag_get_source_widget (GdkDragContext *context
);
Determines the source widget for a drag.
[method]
GdkDragContext * +GdkDragContext * gtk_drag_begin (+GtkWidget *widget
,GtkTargetList *targets
, -GdkDragAction actions
, +GdkDragAction actions
,gint button
, -GdkEvent *event
);GdkEvent *event
);
gtk_drag_begin
has been deprecated since version 3.10 and should not be used in newly-written code.
Use gtk_drag_begin_with_coordinates()
instead
GdkDragContext * +GdkDragContext * gtk_drag_begin_with_coordinates (GtkWidget *widget
,GtkTargetList *targets
, -GdkDragAction actions
, +GdkDragAction actions
,gint button
, -GdkEvent *event
, +GdkEvent *event
,gint x
,gint y
);Initiates a drag on the source side. The function only needs to be used @@ -1097,7 +1097,7 @@
The
event
is used to retrieve the timestamp that will be used internally to grab the pointer. Ifevent
- isNULL
, thenGDK_CURRENT_TIME
will be used. + isNULL
, thenGDK_CURRENT_TIME
will be used. However, you should try to pass a real event in all cases, since that can be used to get information about the drag.Generally there are three cases when you want to start a drag by hand by @@ -1113,8 +1113,8 @@ that you have in your “motion-notify-event” handler.
During a timeout handler, if you want to start a drag after the mouse
button is held down for some time. Try to save the last event that you got
-from the mouse, using gdk_event_copy()
, and pass it to this function
-(remember to free the event with gdk_event_free()
when you are done).
+from the mouse, using gdk_event_copy()
, and pass it to this function
+(remember to free the event with gdk_event_free()
when you are done).
If you can really not pass a real event, pass NULL instead.
[method]
@@ -1186,7 +1186,7 @@void
-gtk_drag_cancel (GdkDragContext *context
);
+gtk_drag_cancel (GdkDragContext *context
);
Cancels an ongoing drag operation on the source side.
If you want to be able to cancel a drag operation in this way, you need to keep a pointer to the drag context, either from an @@ -1210,7 +1210,7 @@
context
a GdkDragContext, as e.g. returned by gtk_drag_begin_with_coordinates()
a GdkDragContext, as e.g. returned by gtk_drag_begin_with_coordinates()
void -gtk_drag_set_icon_widget (@@ -1270,7 +1270,7 @@GdkDragContext *context
, +gtk_drag_set_icon_widget (GdkDragContext *context
,GtkWidget *widget
,gint hot_x
,gint hot_y
);
void -gtk_drag_set_icon_pixbuf (@@ -1317,7 +1317,7 @@GdkDragContext *context
, +gtk_drag_set_icon_pixbuf (GdkDragContext *context
,GdkPixbuf *pixbuf
,gint hot_x
,gint hot_y
);
void -gtk_drag_set_icon_stock (@@ -1365,7 +1365,7 @@GdkDragContext *context
, +gtk_drag_set_icon_stock (GdkDragContext *context
,const gchar *stock_id
,gint hot_x
,gint hot_y
);
void -gtk_drag_set_icon_surface (GdkDragContext *context
, +gtk_drag_set_icon_surface (GdkDragContext *context
,cairo_surface_t *surface
);
Sets surface
as the icon for a given drag. GTK+ retains
@@ -1405,7 +1405,7 @@
void -gtk_drag_set_icon_name (@@ -1456,7 +1456,7 @@GdkDragContext *context
, +gtk_drag_set_icon_name (GdkDragContext *context
,const gchar *icon_name
,gint hot_x
,gint hot_y
);
void -gtk_drag_set_icon_gicon (@@ -1504,7 +1504,7 @@GdkDragContext *context
, +gtk_drag_set_icon_gicon (GdkDragContext *context
,GIcon *icon
,gint hot_x
,gint hot_y
);
void
-gtk_drag_set_icon_default (GdkDragContext *context
);
+gtk_drag_set_icon_default (GdkDragContext *context
);
Sets the icon for a particular drag to the default icon.
[method]
@@ -1589,10 +1589,10 @@void gtk_drag_source_set (+GtkWidget *widget
, -GdkModifierType start_button_mask
, +GdkModifierType start_button_mask
,const GtkTargetEntry *targets
,gint n_targets
, -GdkDragAction actions
);
GdkDragAction actions
);
Sets up a widget so that GTK+ will start a drag operation when the user clicks and drags on the widget. The widget must have a window.
[method]
@@ -1970,7 +1970,7 @@If set for a widget, GTK+, during a drag over this
widget will check if the drag matches this widget’s list of possible targets
and actions.
- GTK+ will then call gdk_drag_status()
as appropriate.
gdk_drag_status()
as appropriate.
#define GTK_MICRO_VERSION (19) +#define GTK_MICRO_VERSION (21)Like
gtk_get_micro_version()
, but from the headers used at application compile time, rather than from the library linked @@ -406,7 +406,7 @@
GTK_BINARY_AGE
-#define GTK_BINARY_AGE (2219) +#define GTK_BINARY_AGE (2221)Like
gtk_get_binary_age()
, but from the headers used at application compile time, rather than from the library linked @@ -415,7 +415,7 @@
GTK_INTERFACE_AGE
-#define GTK_INTERFACE_AGE (19) +#define GTK_INTERFACE_AGE (21)Like
gtk_get_interface_age()
, but from the headers used at application compile time, rather than from the library linked diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Filesystem-utilities.html gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Filesystem-utilities.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Filesystem-utilities.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Filesystem-utilities.html 2017-09-11 15:58:06.000000000 +0000 @@ -83,7 +83,7 @@-GdkScreen * +GdkScreen * gtk_mount_operation_get_screen () @@ -130,7 +130,7 @@ @@ -181,7 +181,7 @@ passwords, questions or show processes blocking unmount. -GdkScreen * +GdkScreen *screen Read / Write gtk_show_uri_on_window() is a convenient way to launch applications for URIs.
Another object that is worth mentioning in this context is -GdkAppLaunchContext, which provides visual feedback when lauching +GdkAppLaunchContext, which provides visual feedback when lauching applications.
@@ -307,7 +307,7 @@gtk_mount_operation_set_screen ()
void gtk_mount_operation_set_screen (+GtkMountOperation *op
, -GdkScreen *screen
);GdkScreen *screen
);Sets the screen to show windows of the GtkMountOperation on.
Parameters
@@ -325,7 +325,7 @@@@ -336,7 +336,7 @@ - screen
+
gtk_mount_operation_get_screen ()
-GdkScreen * +GdkScreen * gtk_mount_operation_get_screen (GtkMountOperation *op
);Gets the screen on which windows of the GtkMountOperation will be shown.
@@ -367,7 +367,7 @@gtk_show_uri ()
gboolean -gtk_show_uri (@@ -437,7 +437,7 @@GdkScreen *screen
, +gtk_show_uri (GdkScreen *screen
,const gchar *uri
,guint32 timestamp
,GError **error
);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
.GDK_CURRENT_TIME
.This is the recommended call to be used as it passes information necessary for sandbox helpers to parent their dialogs properly.
@@ -525,7 +525,7 @@
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-General.html gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-General.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-General.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-General.html 2017-09-11 15:58:06.000000000 +0000 @@ -257,7 +257,7 @@The
-“screen”
property“screen” GdkScreen *+“screen” GdkScreen *The screen where this window will be displayed.
Flags: Read / Write
-GdkEvent * +GdkEvent * gtk_get_current_event () @@ -281,7 +281,7 @@ -GdkDevice * +GdkDevice * gtk_get_current_event_device () @@ -494,7 +494,7 @@ char ***argv
);Parses command line arguments, and initializes global attributes of GTK+, but does not actually open a connection -to a display. (See
+to a display. (Seegdk_display_open()
,gdk_get_display_arg_name()
)gdk_display_open()
,gdk_get_display_arg_name()
)Any arguments used by GTK+ or GDK are removed from the array and
argc
andargv
@@ -871,7 +871,7 @@gtk_main_do_event ()
void -gtk_main_do_event (+gtk_main_do_event (GdkEvent *event
);GdkEvent *event
);Processes a single GDK event.
This is public only to allow filtering of events between GDK and GTK+. You will not usually need to call this function directly.
@@ -958,7 +958,7 @@GtkModuleDisplayInitFunc ()
void -(*GtkModuleDisplayInitFunc) (+(*GtkModuleDisplayInitFunc) (GdkDisplay *display
);GdkDisplay *display
);A multihead-aware GTK+ module may have a
gtk_module_display_init()
function with this prototype. GTK+ calls this function for each opened display.@@ -971,7 +971,7 @@@@ -1153,7 +1153,7 @@- display
+ an open GdkDisplay
an open GdkDisplay
gtk_device_grab_add ()
void gtk_device_grab_add (GtkWidget *widget
, -GdkDevice *device
, +GdkDevice *device
,gboolean block_others
);Adds a GTK+ grab on
device
, so all the events ondevice
@@ -1180,7 +1180,7 @@- device
+ a GdkDevice to grab on.
a GdkDevice to grab on.
@@ -1199,7 +1199,7 @@ gtk_device_grab_remove ()
void gtk_device_grab_remove (+GtkWidget *widget
, -GdkDevice *device
);GdkDevice *device
);Removes a device grab from the given widget.
You have to pair calls to
@@ -1219,7 +1219,7 @@gtk_device_grab_add()
andgtk_device_grab_remove()
.@@ -1275,7 +1275,7 @@ - device
+ GtkKeySnoopFunc ()
gint (*GtkKeySnoopFunc) (GtkWidget *grab_widget
, -GdkEventKey *event
, +GdkEventKey *event
,gpointer func_data
);Key snooper functions are called before normal event delivery. They can be used to implement custom key event handling.
@@ -1342,17 +1342,17 @@
@@ -1362,18 +1362,18 @@gtk_get_current_event ()
-GdkEvent * +GdkEvent * gtk_get_current_event (void
);Obtains a copy of the event currently being processed by GTK+.
For example, if you are handling a “clicked” signal, -the current event will be the GdkEventButton that triggered +the current event will be the GdkEventButton that triggered the ::clicked signal.
Returns
a copy of the current event, or
+freed withNULL
if there is no current event. The returned event must be -freed withgdk_event_free()
.gdk_event_free()
.[transfer full][nullable]
guint32 gtk_get_current_event_time (void
);If there is a current event and it has a timestamp, -return that timestamp, otherwise return
+return that timestamp, otherwise returnGDK_CURRENT_TIME
.GDK_CURRENT_TIME
.
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-GtkSymbolicColor.html gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-GtkSymbolicColor.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-GtkSymbolicColor.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-GtkSymbolicColor.html 2017-09-11 15:58:06.000000000 +0000 @@ -149,7 +149,7 @@ be resolved withgtk_get_current_event_state ()
gboolean -gtk_get_current_event_state (+gtk_get_current_event_state (GdkModifierType *state
);GdkModifierType *state
);If there is a current event and it has a state field, place that state field in
state
and returnTRUE
, otherwise return @@ -1402,13 +1402,13 @@
@@ -1416,7 +1416,7 @@gtk_get_current_event_device ()
-GdkDevice * +GdkDevice * gtk_get_current_event_device (void
);If there is a current event and it has a device, return that device, otherwise return
NULL
.@@ -1449,7 +1449,7 @@gtk_get_event_widget ()
GtkWidget * -gtk_get_event_widget (+gtk_get_event_widget (GdkEvent *event
);GdkEvent *event
);If
event
isNULL
or the event was not associated with any widget, returnsNULL
, otherwise returns the widget that received the event @@ -1431,7 +1431,7 @@- event
+ a GdkEvent
a GdkEvent
gtk_propagate_event ()
void gtk_propagate_event (+GtkWidget *widget
, -GdkEvent *event
);GdkEvent *event
);Sends an event to a widget, propagating the event to parent widgets if the event remains unhandled.
Events received by GTK+ from GDK normally begin in
gtk_main_do_event()
. @@ -1463,7 +1463,7 @@All that said, you most likely don’t want to use any of these functions; synthesizing events is rarely needed. There are almost certainly better ways to achieve your goals. For example, use -
gdk_window_invalidate_rect()
orgtk_widget_queue_draw()
instead +gdk_window_invalidate_rect()
orgtk_widget_queue_draw()
instead of making up expose events.Parameters
@@ -1497,7 +1497,7 @@Use this priority for functionality related to size allocation.
It is used internally by GTK+ to compute the sizes of widgets. -This priority is higher than
GDK_PRIORITY_REDRAW
to avoid +This priority is higher thanGDK_PRIORITY_REDRAW
to avoid resizing a widget which was just redrawn.gtk_symbolic_color_resolve()
, which replaces all symbolic color references by the colors they refer to (in a given context) and evaluates mix, shade and other expressions, resulting -in a GdkRGBA value. +in a GdkRGBA value.It is not normally necessary to deal directly with GtkSymbolicColors, since they are mostly used behind the scenes by GtkStyleContext and GtkCssProvider.
@@ -161,7 +161,7 @@gtk_symbolic_color_new_literal ()
GtkSymbolicColor * -gtk_symbolic_color_new_literal (+gtk_symbolic_color_new_literal (const GdkRGBA *color
);const GdkRGBA *color
);@@ -472,7 +472,7 @@
gtk_symbolic_color_new_literal
has been deprecated since version 3.8 and should not be used in newly-written code.GtkSymbolicColor is deprecated.
@@ -177,7 +177,7 @@- color
+ a GdkRGBA
a GdkRGBA
gboolean gtk_symbolic_color_resolve (+GtkSymbolicColor *color
,GtkStyleProperties *props
, -GdkRGBA *resolved_color
);GdkRGBA *resolved_color
);
gtk_symbolic_color_resolve
has been deprecated since version 3.8 and should not be used in newly-written code.GtkSymbolicColor is deprecated.
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Keyboard-Accelerators.html gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Keyboard-Accelerators.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Keyboard-Accelerators.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Keyboard-Accelerators.html 2017-09-11 15:58:06.000000000 +0000 @@ -141,7 +141,7 @@-GdkModifierType +GdkModifierType gtk_accel_group_get_modifier_mask () @@ -237,7 +237,7 @@ -GdkModifierType +GdkModifierType gtk_accelerator_get_default_mod_mask () @@ -261,7 +261,7 @@ Read - @@ -363,7 +363,7 @@GdkModifierType +GdkModifierType modifier-mask Read void gtk_accel_group_connect (GtkAccelGroup *accel_group
,guint accel_key
, -GdkModifierType accel_mods
, +GdkModifierType accel_mods
,GtkAccelFlags accel_flags
,GClosure *closure
);Installs an accelerator in this group. When
accel_group
@@ -474,7 +474,7 @@ (*GtkAccelGroupActivate) (GtkAccelGroup *accel_group
,GObject *acceleratable
,guint keyval
, -GdkModifierType modifier
); +GdkModifierType modifier
);
@@ -544,7 +544,7 @@gboolean gtk_accel_group_disconnect_key (+GtkAccelGroup *accel_group
,guint accel_key
, -GdkModifierType accel_mods
);GdkModifierType accel_mods
);Removes an accelerator previously installed through
gtk_accel_group_connect()
.@@ -588,7 +588,7 @@GQuark accel_quark
,GObject *acceleratable
,guint accel_key
, -GdkModifierType accel_mods
); +GdkModifierType accel_mods
);Finds the first accelerator in
accel_group
that matchesaccel_key
@@ -753,11 +753,11 @@
gtk_accel_group_get_modifier_mask ()
-GdkModifierType +GdkModifierType gtk_accel_group_get_modifier_mask (-GtkAccelGroup *accel_group
);Gets a GdkModifierType representing the mask for this +
Gets a GdkModifierType representing the mask for this
+. For example, GDK_CONTROL_MASK, GDK_SHIFT_MASK, etc.accel_group
-. For example, GDK_CONTROL_MASK, GDK_SHIFT_MASK, etc.Parameters
@@ -785,7 +785,7 @@
gboolean gtk_accel_groups_activate (+GObject *object
,guint accel_key
, -GdkModifierType accel_mods
);GdkModifierType accel_mods
);Finds the first accelerator in any GtkAccelGroup attached to
object
that matchesaccel_key
@@ -909,10 +909,10 @@gtk_accelerator_valid ()
gboolean gtk_accelerator_valid (+guint keyval
, -GdkModifierType modifiers
);GdkModifierType modifiers
);Determines whether a given keyval and modifier mask constitute a valid keyboard accelerator. For example, the GDK_KEY_a keyval -plus GDK_CONTROL_MASK is valid - this is a “Ctrl+a” accelerator. +plus GDK_CONTROL_MASK is valid - this is a “Ctrl+a” accelerator. But, you can't, for instance, use the GDK_KEY_Control_L keyval as an accelerator.
@@ -948,13 +948,13 @@void gtk_accelerator_parse (+const gchar *accelerator
,guint *accelerator_key
, -GdkModifierType *accelerator_mods
);GdkModifierType *accelerator_mods
);Parses a string representing an accelerator. The format looks like “<Control>a” or “<Shift><Alt>F1” or “<Release>z” (the last one is for key release).
The parser is fairly liberal and allows lower or upper case, and also abbreviations such as “<Ctl>” and “<Ctrl>”. Key names are parsed using -
gdk_keyval_from_name()
. For character keys the name is not the symbol, +gdk_keyval_from_name()
. For character keys the name is not the symbol, but the lowercase name, e.g. one would use “<Ctrl>minus” instead of “<Ctrl>-”.If the parse fails,
accelerator_key
@@ -996,10 +996,10 @@gtk_accelerator_name ()
gchar * gtk_accelerator_name (+guint accelerator_key
, -GdkModifierType accelerator_mods
);GdkModifierType accelerator_mods
);Converts an accelerator keyval and modifier mask into a string parseable by
+GDK_KEY_q and GDK_CONTROL_MASK, this function returns “<Control>q”.gtk_accelerator_parse()
. For example, if you pass in -GDK_KEY_q and GDK_CONTROL_MASK, this function returns “<Control>q”.If you need to display accelerators in the user interface, see
gtk_accelerator_get_label()
.@@ -1034,7 +1034,7 @@gtk_accelerator_get_label ()
gchar * gtk_accelerator_get_label (+guint accelerator_key
, -GdkModifierType accelerator_mods
);GdkModifierType accelerator_mods
);Converts an accelerator keyval and modifier mask into a string which can be used to represent the accelerator to the user.
@@ -1072,7 +1072,7 @@ gtk_accelerator_parse_with_keycode (const gchar *accelerator
,guint *accelerator_key
,guint **accelerator_codes
, -GdkModifierType *accelerator_mods
); +GdkModifierType *accelerator_mods
);Parses a string representing an accelerator, similarly to
gtk_accelerator_parse()
but handles keycodes as well. This is only useful for system-level components, applications should use @@ -1128,10 +1128,10 @@gtk_accelerator_name_with_keycode ()
gchar * -gtk_accelerator_name_with_keycode (+GdkDisplay *display
, +gtk_accelerator_name_with_keycode (GdkDisplay *display
,guint accelerator_key
,guint keycode
, -GdkModifierType accelerator_mods
);GdkModifierType accelerator_mods
);Converts an accelerator keyval and modifier mask into a string parseable by
gtk_accelerator_parse_with_keycode()
, similarly togtk_accelerator_name()
but handling keycodes. @@ -1148,7 +1148,7 @@- display
+ a GdkDisplay or
NULL
to use the default display.a GdkDisplay or
NULL
to use the default display.[allow-none] @@ -1180,10 +1180,10 @@ gtk_accelerator_get_label_with_keycode ()
gchar * gtk_accelerator_get_label_with_keycode - (+GdkDisplay *display
, + (GdkDisplay *display
,guint accelerator_key
,guint keycode
, -GdkModifierType accelerator_mods
);GdkModifierType accelerator_mods
);Converts an accelerator keyval and modifier mask into a (possibly translated) string that can be displayed to a user, similarly to
gtk_accelerator_get_label()
, but handling @@ -1201,7 +1201,7 @@- display
+ a GdkDisplay or
NULL
to use the default display.a GdkDisplay or
NULL
to use the default display.[allow-none] @@ -1232,11 +1232,11 @@ gtk_accelerator_set_default_mod_mask ()
void -gtk_accelerator_set_default_mod_mask (+gtk_accelerator_set_default_mod_mask (GdkModifierType default_mod_mask
);GdkModifierType default_mod_mask
);Sets the modifiers that will be considered significant for keyboard accelerators. The default mod mask depends on the GDK backend in use, -but will typically include GDK_CONTROL_MASK | GDK_SHIFT_MASK | -GDK_MOD1_MASK | GDK_SUPER_MASK | GDK_HYPER_MASK | GDK_META_MASK. +but will typically include GDK_CONTROL_MASK | GDK_SHIFT_MASK | +GDK_MOD1_MASK | GDK_SUPER_MASK | GDK_HYPER_MASK | GDK_META_MASK. In other words, Control, Shift, Alt, Super, Hyper and Meta. Other modifiers will by default be ignored by GtkAccelGroup.
You must include at least the three modifiers Control, Shift @@ -1262,7 +1262,7 @@
gtk_accelerator_get_default_mod_mask ()
-GdkModifierType +GdkModifierType gtk_accelerator_get_default_mod_mask (void
);Gets the modifier mask.
The modifier mask determines which modifiers are considered significant @@ -1372,7 +1372,7 @@
- @@ -1398,7 +1398,7 @@+ GdkModifierType
accel_mods
;GdkModifierType
accel_mods
;The accelerator modifiers
@@ -1411,7 +1411,7 @@ user_function (GtkAccelGroup *accel_group, GObject *acceleratable, guint keyval, - GdkModifierType modifier, + GdkModifierType modifier, gpointer user_data)The
-“modifier-mask”
property“modifier-mask” GdkModifierType+“modifier-mask” GdkModifierTypeModifier Mask.
Flags: Read
The accel-activate signal is an implementation detail of GtkAccelGroup and not meant to be used by applications.
@@ -1464,7 +1464,7 @@void user_function (GtkAccelGroup *accel_group, guint keyval, - GdkModifierType modifier, + GdkModifierType modifier, GClosure *accel_closure, gpointer user_data)The accel-changed signal is emitted when an entry diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Resource-Files.html gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Resource-Files.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Resource-Files.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Resource-Files.html 2017-09-11 15:58:06.000000000 +0000 @@ -1180,7 +1180,7 @@
This function recomputes the styles for all widgets that use a particular GtkSettings object. (There is one GtkSettings object -per GdkScreen, see
gtk_settings_get_for_screen()
); It is useful +per GdkScreen, seegtk_settings_get_for_screen()
); It is useful when some global parameter has changed that affects the appearance of all widgets, because when a widget gets a new style, it will both redraw and recompute any cached information about its @@ -1285,7 +1285,7 @@gtk_rc_parse_color ()
guint gtk_rc_parse_color (+GScanner *scanner
, -GdkColor *color
);GdkColor *color
);
gtk_rc_parse_color
has been deprecated since version 3.0 and should not be used in newly-written code.Use GtkCssProvider instead
@@ -1310,7 +1310,7 @@@@ -1329,7 +1329,7 @@ - color
a pointer to a GdkColor in which to store +
a pointer to a GdkColor in which to store the result.
[out] guint gtk_rc_parse_color_full (+GScanner *scanner
,GtkRcStyle *style
, -GdkColor *color
);GdkColor *color
);
gtk_rc_parse_color_full
has been deprecated since version 3.0 and should not be used in newly-written code.Use GtkCssProvider instead
@@ -1359,7 +1359,7 @@@@ -1714,22 +1714,22 @@ - color
a pointer to a GdkColor in which to store +
a pointer to a GdkColor in which to store the result.
[out] - + GdkColor
fg
[5];Foreground colors
- + GdkColor
bg
[5];Background colors
- + GdkColor
text
[5];Text colors
- diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Selections.html gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Selections.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Selections.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Selections.html 2017-09-11 15:58:06.000000000 +0000 @@ -315,7 +315,7 @@+ GdkColor
base
[5];Base colors
-GdkAtom +GdkAtom gtk_selection_data_get_selection () @@ -345,7 +345,7 @@ -GdkAtom +GdkAtom gtk_selection_data_get_data_type () @@ -353,7 +353,7 @@ -GdkDisplay * +GdkDisplay * gtk_selection_data_get_display () @@ -369,7 +369,7 @@ -GdkAtom +GdkAtom gtk_selection_data_get_target () @@ -672,7 +672,7 @@ gtk_target_list_add ()
void gtk_target_list_add (GtkTargetList *list
, -GdkAtom target
, +GdkAtom target
,guint flags
,guint info
);Appends another target to a GtkTargetList.
@@ -904,7 +904,7 @@gtk_target_list_remove ()
void gtk_target_list_remove (+GtkTargetList *list
, -GdkAtom target
);GdkAtom target
);Removes a target from a target list.
Parameters
@@ -934,7 +934,7 @@gtk_target_list_find ()
gboolean gtk_target_list_find (GtkTargetList *list
, -GdkAtom target
, +GdkAtom target
,guint *info
);Looks up a given target in a GtkTargetList.
@@ -1046,7 +1046,7 @@gtk_selection_owner_set ()
gboolean gtk_selection_owner_set (GtkWidget *widget
, -GdkAtom selection
, +GdkAtom selection
,guint32 time_
);Claims ownership of a given selection for a particular widget, or, if
widget
@@ -1087,9 +1087,9 @@gtk_selection_owner_set_for_display ()
gboolean -gtk_selection_owner_set_for_display (GdkDisplay *display
, +gtk_selection_owner_set_for_display (GdkDisplay *display
,GtkWidget *widget
, -GdkAtom selection
, +GdkAtom selection
,guint32 time_
);Claim ownership of a given selection for a particular widget, or, if
widget
@@ -1105,7 +1105,7 @@- display
+ the GdkDisplay where the selection is set
the GdkDisplay where the selection is set
@@ -1137,8 +1137,8 @@ @@ -1305,7 +1305,7 @@gtk_selection_add_target ()
void gtk_selection_add_target (GtkWidget *widget
, -GdkAtom selection
, -GdkAtom target
, +GdkAtom selection
, +GdkAtom target
,guint info
);Appends a specified target to the list of supported targets for a given widget and selection.
@@ -1180,7 +1180,7 @@gtk_selection_add_targets ()
void gtk_selection_add_targets (GtkWidget *widget
, -GdkAtom selection
, +GdkAtom selection
,const GtkTargetEntry *targets
,guint ntargets
);Prepends a table of targets to the list of supported targets @@ -1224,7 +1224,7 @@
gtk_selection_clear_targets ()
void gtk_selection_clear_targets (+GtkWidget *widget
, -GdkAtom selection
);GdkAtom selection
);Remove all targets registered for the given selection for the widget.
@@ -1255,8 +1255,8 @@gtk_selection_convert ()
gboolean gtk_selection_convert (GtkWidget *widget
, -GdkAtom selection
, -GdkAtom target
, +GdkAtom selection
, +GdkAtom target
,guint32 time_
);Requests the contents of a selection. When received, a “selection-received” signal will be generated.
@@ -1287,7 +1287,7 @@time_
+In emergency, you could use GDK_CURRENT_TIME Time of request (usually of triggering event) -In emergency, you could use GDK_CURRENT_TIME
gtk_selection_data_set ()
void gtk_selection_data_set (@@ -1574,7 +1574,7 @@GtkSelectionData *selection_data
, -GdkAtom type
, +GdkAtom type
,gint format
,const guchar *data
,gint length
);gtk_selection_data_get_targets ()
gboolean gtk_selection_data_get_targets (const GtkSelectionData *selection_data
, -GdkAtom **targets
, +GdkAtom **targets
,gint *n_atoms
);Gets the contents of
selection_data
as an array of targets. @@ -1769,9 +1769,9 @@
gtk_selection_data_get_selection ()
-GdkAtom +GdkAtom gtk_selection_data_get_selection (-const GtkSelectionData *selection_data
);Retrieves the selection GdkAtom of the selection data.
+Retrieves the selection GdkAtom of the selection data.
Parameters
@@ -1789,7 +1789,7 @@
Returns
-the selection GdkAtom of the selection data.
+the selection GdkAtom of the selection data.
[transfer none]
Since: 2.16
@@ -1892,7 +1892,7 @@
gtk_selection_data_get_data_type ()
-GdkAtom +GdkAtom gtk_selection_data_get_data_type (const GtkSelectionData *selection_data
);Retrieves the data type of the selection.
@@ -1920,7 +1920,7 @@
gtk_selection_data_get_display ()
-GdkDisplay * +GdkDisplay * gtk_selection_data_get_display (const GtkSelectionData *selection_data
);Retrieves the display of the selection.
@@ -1975,7 +1975,7 @@
gtk_selection_data_get_target ()
-GdkAtom +GdkAtom gtk_selection_data_get_target (const GtkSelectionData *selection_data
);Retrieves the target of the selection.
@@ -2004,7 +2004,7 @@gtk_targets_include_image ()
gboolean -gtk_targets_include_image (GdkAtom *targets
, +gtk_targets_include_image (GdkAtom *targets
,gint n_targets
,gboolean writable
);Determines if any of the targets in
targets
@@ -2021,7 +2021,7 @@- targets
+ an array of GdkAtoms.
an array of GdkAtoms.
[array length=n_targets] @@ -2051,7 +2051,7 @@ gtk_targets_include_text ()
gboolean -gtk_targets_include_text (GdkAtom *targets
, +gtk_targets_include_text (GdkAtom *targets
,gint n_targets
);Determines if any of the targets in
targets
can be used to @@ -2067,7 +2067,7 @@- targets
+ an array of GdkAtoms.
an array of GdkAtoms.
[array length=n_targets] @@ -2091,7 +2091,7 @@ gtk_targets_include_uri ()
gboolean -gtk_targets_include_uri (GdkAtom *targets
, +gtk_targets_include_uri (GdkAtom *targets
,gint n_targets
);Determines if any of the targets in
targets
can be used to @@ -2107,7 +2107,7 @@- targets
+ an array of GdkAtoms.
an array of GdkAtoms.
[array length=n_targets] @@ -2131,7 +2131,7 @@ gtk_targets_include_rich_text ()
gboolean -gtk_targets_include_rich_text (GdkAtom *targets
, +gtk_targets_include_rich_text (GdkAtom *targets
,gint n_targets
,GtkTextBuffer *buffer
);Determines if any of the targets in
targets
@@ -2148,7 +2148,7 @@- targets
+ an array of GdkAtoms.
an array of GdkAtoms.
[array length=n_targets] @@ -2328,8 +2328,8 @@ - - GdkAtom
target
;+ GdkAtom representation of the target type
+ GdkAtom
target
;GdkAtom representation of the target type
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Stock-Items.html gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Stock-Items.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Stock-Items.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Stock-Items.html 2017-09-11 15:58:06.000000000 +0000 @@ -882,7 +882,7 @@ - diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Testing.html gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Testing.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Testing.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Testing.html 2017-09-11 15:58:06.000000000 +0000 @@ -773,7 +773,7 @@+ GdkModifierType
modifier
;GdkModifierType
modifier
;Modifier type for keyboard accelerator
gboolean gtk_test_widget_click (+GtkWidget *widget
,guint button
, -GdkModifierType modifiers
);GdkModifierType modifiers
);@@ -372,7 +372,7 @@
gtk_test_widget_click
has been deprecated since version 3.20 and should not be used in newly-written code.This testing infrastructure is phased out in favor of reftests.
@@ -788,7 +788,7 @@ input-only event window. For other widgets, this is usually widget->window. Certain caveats should be considered when using this function, in particular because the mouse pointer is warped to the button click -location, seegdk_test_simulate_button()
for details. +location, seegdk_test_simulate_button()
for details.Parameters
@@ -336,7 +336,7 @@@@ -828,7 +828,7 @@
gboolean gtk_test_widget_send_key (+GtkWidget *widget
,guint keyval
, -GdkModifierType modifiers
);GdkModifierType modifiers
);This function will generate keyboard press and release events in the middle of the first GdkWindow found that belongs to
+location, seewidget
. @@ -837,7 +837,7 @@ input-only event window. For other widgets, this is usually widget->window. Certain caveats should be considered when using this function, in particular because the mouse pointer is warped to the key press -location, seegdk_test_simulate_key()
for details.gdk_test_simulate_key()
for details.Parameters
@@ -308,7 +308,7 @@diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Themeable-Stock-Images.html gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Themeable-Stock-Images.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/gtk3-Themeable-Stock-Images.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/gtk3-Themeable-Stock-Images.html 2017-09-11 15:58:06.000000000 +0000 @@ -1048,7 +1048,7 @@
widget
+is to determine the appropriate GdkScreen. widget that will display the icon, or
NULL
. The only use that is typically made of this -is to determine the appropriate GdkScreen.[allow-none] @@ -1127,7 +1127,7 @@ GtkStyleContext *context
,GtkIconSize size
,int scale
, -GdkWindow *for_window
); +GdkWindow *for_window
);
gtk_icon_set_render_icon_surface
has been deprecated since version 3.10 and should not be used in newly-written code.Use GtkIconTheme instead.
@@ -1169,7 +1169,7 @@diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkAccelLabel.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkAccelLabel.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkAccelLabel.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkAccelLabel.html 2017-09-11 15:58:06.000000000 +0000 @@ -418,7 +418,7 @@ - for_window
+ [allow-none] void gtk_accel_label_set_accel (+GtkAccelLabel *accel_label
,guint accelerator_key
, -GdkModifierType accelerator_mods
);GdkModifierType accelerator_mods
);Manually sets a keyval and modifier mask as the accelerator rendered by
@@ -461,7 +461,7 @@accel_label
.void gtk_accel_label_get_accel (+GtkAccelLabel *accel_label
,guint *accelerator_key
, -GdkModifierType *accelerator_mods
);GdkModifierType *accelerator_mods
);Gets the keyval and modifier mask set with
gtk_accel_label_set_accel()
.diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkBuilder.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkBuilder.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkBuilder.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkBuilder.html 2017-09-11 15:58:06.000000000 +0000 @@ -403,7 +403,7 @@ asFALSE
), enumerations (can be specified by their name, nick or integer value), flags (can be specified by their name, nick, integer value, optionally combined with “|”, e.g. “GTK_VISIBLE|GTK_REALIZED”) -and colors (in a format understood bygdk_rgba_parse()
). +and colors (in a format understood bygdk_rgba_parse()
).GVariants can be specified in the format understood by
g_variant_parse()
, and pixbufs can be specified as a filename of an image file to load.Objects can be referred to by their name and by default refer to @@ -1634,7 +1634,7 @@ argument, so it need not be initialised beforehand.
This function can handle char, uchar, boolean, int, uint, long, -ulong, enum, flags, float, double, string, GdkColor, GdkRGBA and +ulong, enum, flags, float, double, string, GdkColor, GdkRGBA and GtkAdjustment type values. Support for GtkWidget type values is still to come.
Upon errors
FALSE
will be returned anderror
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkButton.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkButton.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkButton.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkButton.html 2017-09-11 15:58:06.000000000 +0000 @@ -269,7 +269,7 @@-GdkWindow * +GdkWindow * gtk_button_get_event_window () @@ -1368,7 +1368,7 @@
gtk_button_get_event_window ()
-GdkWindow * +GdkWindow * gtk_button_get_event_window (GtkButton *button
);Returns the button’s event window if it is realized,
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkCellArea.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkCellArea.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkCellArea.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkCellArea.html 2017-09-11 15:58:06.000000000 +0000 @@ -1038,8 +1038,8 @@NULL
otherwise. This function should be rarely needed.GtkCellAllocCallback ()
gboolean (*GtkCellAllocCallback) (GtkCellRenderer *renderer
, -const GdkRectangle *cell_area
, -const GdkRectangle *cell_background
, +const GdkRectangle *cell_area
, +const GdkRectangle *cell_background
,gpointer data
);The type of the callback functions used for iterating over the cell renderers and their allocated areas inside a GtkCellArea, @@ -1273,8 +1273,8 @@ gtk_cell_area_foreach_alloc (
GtkCellArea *area
,GtkCellAreaContext *context
,GtkWidget *widget
, -const GdkRectangle *cell_area
, -const GdkRectangle *background_area
, +const GdkRectangle *cell_area
, +const GdkRectangle *background_area
,GtkCellAllocCallback callback
,gpointer callback_data
);Calls
callback
@@ -1342,8 +1342,8 @@ gtk_cell_area_event (GtkCellArea *area
,GtkCellAreaContext *context
,GtkWidget *widget
, -GdkEvent *event
, -const GdkRectangle *cell_area
, +GdkEvent *event
, +const GdkRectangle *cell_area
,GtkCellRendererState flags
);Delegates event handling to a GtkCellArea.
@@ -1373,7 +1373,7 @@- event
+ the GdkEvent to handle
the GdkEvent to handle
@@ -1407,8 +1407,8 @@ GtkCellAreaContext *context
,GtkWidget *widget
,cairo_t *cr
, -const GdkRectangle *background_area
, -const GdkRectangle *cell_area
, +const GdkRectangle *background_area
, +const GdkRectangle *cell_area
,GtkCellRendererState flags
,gboolean paint_focus
);Renders
area
@@ -1485,8 +1485,8 @@GtkCellAreaContext *context
,GtkWidget *widget
,GtkCellRenderer *renderer
, -const GdkRectangle *cell_area
, -GdkRectangle *allocation
); +const GdkRectangle *cell_area
, +GdkRectangle *allocation
);Derives the allocation of
renderer
insidearea
ifarea
@@ -1549,10 +1549,10 @@ gtk_cell_area_get_cell_at_position (GtkCellArea *area
,GtkCellAreaContext *context
,GtkWidget *widget
, -const GdkRectangle *cell_area
, +const GdkRectangle *cell_area
,gint x
,gint y
, -GdkRectangle *alloc_area
); +GdkRectangle *alloc_area
);Gets the GtkCellRenderer at
x
andy
coordinates insidearea
@@ -2696,7 +2696,7 @@ gtk_cell_area_activate (GtkCellArea *area
,GtkCellAreaContext *context
,GtkWidget *widget
, -const GdkRectangle *cell_area
, +const GdkRectangle *cell_area
,GtkCellRendererState flags
,gboolean edit_only
);Activates
area
@@ -3150,8 +3150,8 @@ gtk_cell_area_activate_cell (GtkCellArea *area
,GtkWidget *widget
,GtkCellRenderer *renderer
, -GdkEvent *event
, -const GdkRectangle *cell_area
, +GdkEvent *event
, +const GdkRectangle *cell_area
,GtkCellRendererState flags
);This is used by GtkCellArea subclasses when handling events to activate cells, the base GtkCellArea class activates cells @@ -3185,12 +3185,12 @@
- event
+ the GdkEvent for which cell activation should occur
the GdkEvent for which cell activation should occur
- cell_area
the GdkRectangle in
widget
+@@ -3254,8 +3254,8 @@ the GdkRectangle in
widget
relative coordinates ofrenderer
for the current row.void gtk_cell_area_inner_cell_area (+GtkCellArea *area
,GtkWidget *widget
, -const GdkRectangle *cell_area
, -GdkRectangle *inner_area
);const GdkRectangle *cell_area
, +GdkRectangle *inner_area
);This is a convenience function for GtkCellArea implementations to get the inner area where a given GtkCellRenderer will be rendered. It removes any padding previously added by
@@ -3662,7 +3662,7 @@ user_function (GtkCellArea *area, GtkCellRenderer *renderer, GtkCellEditable *editable, - GdkRectangle *cell_area, + GdkRectangle *cell_area, gchar *path, gpointer user_data)gtk_cell_area_request_renderer()
.Indicates that editing has started on
renderer
@@ -3696,7 +3696,7 @@- cell_area
the GtkWidget relative GdkRectangle coordinates +
the GtkWidget relative GdkRectangle coordinates where
editable
should be addeddiff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkCellEditable.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkCellEditable.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkCellEditable.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkCellEditable.html 2017-09-11 15:58:06.000000000 +0000 @@ -162,10 +162,10 @@ gtk_cell_editable_start_editing ()
void gtk_cell_editable_start_editing (+GtkCellEditable *cell_editable
, -GdkEvent *event
);GdkEvent *event
);Begins editing on a
cell_editable
.event
- is the GdkEvent that began + is the GdkEvent that began the editing process. It may beNULL
, in the instance that editing was initiated through programatic means.@@ -184,7 +184,7 @@diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkCellRendererAccel.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkCellRendererAccel.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkCellRendererAccel.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkCellRendererAccel.html 2017-09-11 15:58:06.000000000 +0000 @@ -71,7 +71,7 @@ - event
+ [allow-none] Read / Write - @@ -226,7 +226,7 @@GdkModifierType +GdkModifierType accel-mods Read / Write
The
-“accel-mods”
property“accel-mods” GdkModifierType+“accel-mods” GdkModifierTypeThe modifier mask of the accelerator.
Flags: Read / Write
Since: 2.10
@@ -290,7 +290,7 @@ user_function (GtkCellRendererAccel *accel, gchar *path_string, guint accel_key, - GdkModifierType accel_mods, + GdkModifierType accel_mods, guint hardware_keycode, gpointer user_data)Gets emitted when the user has selected a new accelerator.
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkCellRenderer.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkCellRenderer.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkCellRenderer.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkCellRenderer.html 2017-09-11 15:58:06.000000000 +0000 @@ -262,13 +262,13 @@-GdkColor * +GdkColor *cell-background-gdk Read / Write @@ -485,8 +485,8 @@ gtk_cell_renderer_get_aligned_area ( -GdkRGBA * +GdkRGBA *cell-background-rgba Read / Write GtkCellRenderer *cell
,GtkWidget *widget
,GtkCellRendererState flags
, -const GdkRectangle *cell_area
, -GdkRectangle *aligned_area
); +const GdkRectangle *cell_area
, +GdkRectangle *aligned_area
);Gets the aligned area used by
cell
insidecell_area
. Used for finding @@ -537,7 +537,7 @@void gtk_cell_renderer_get_size (GtkCellRenderer *cell
,GtkWidget *widget
, -const GdkRectangle *cell_area
, +const GdkRectangle *cell_area
,gint *x_offset
,gint *y_offset
,gint *width
, @@ -614,8 +614,8 @@ gtk_cell_renderer_render (GtkCellRenderer *cell
,cairo_t *cr
,GtkWidget *widget
, -const GdkRectangle *background_area
, -const GdkRectangle *cell_area
, +const GdkRectangle *background_area
, +const GdkRectangle *cell_area
,GtkCellRendererState flags
);Invokes the virtual render function of the GtkCellRenderer. The three passed-in rectangles are areas in
cr
@@ -680,11 +680,11 @@gtk_cell_renderer_activate ()
gboolean gtk_cell_renderer_activate (GtkCellRenderer *cell
, -GdkEvent *event
, +GdkEvent *event
,GtkWidget *widget
,const gchar *path
, -const GdkRectangle *background_area
, -const GdkRectangle *cell_area
, +const GdkRectangle *background_area
, +const GdkRectangle *cell_area
,GtkCellRendererState flags
);Passes an activate event to the cell renderer for possible processing. Some cell renderers may use events; for example, GtkCellRendererToggle @@ -705,7 +705,7 @@
- event
+ a GdkEvent
a GdkEvent
@@ -747,11 +747,11 @@ gtk_cell_renderer_start_editing ()
GtkCellEditable * gtk_cell_renderer_start_editing (GtkCellRenderer *cell
, -GdkEvent *event
, +GdkEvent *event
,GtkWidget *widget
,const gchar *path
, -const GdkRectangle *background_area
, -const GdkRectangle *cell_area
, +const GdkRectangle *background_area
, +const GdkRectangle *cell_area
,GtkCellRendererState flags
);Passes an activate event to the cell renderer for possible processing.
@@ -770,7 +770,7 @@- event
+ a GdkEvent.
a GdkEvent.
[nullable] @@ -1796,8 +1796,8 @@
The
-“cell-background-gdk”
property“cell-background-gdk” GdkColor *-Cell background as a GdkColor
+“cell-background-gdk” GdkColor *
+Cell background as a GdkColor
GtkCellRenderer:cell-background-gdk
has been deprecated since version 3.4 and should not be used in newly-written code.Use “cell-background-rgba” instead.
@@ -1807,8 +1807,8 @@
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkCellRendererText.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkCellRendererText.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkCellRendererText.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkCellRendererText.html 2017-09-11 15:58:06.000000000 +0000 @@ -94,13 +94,13 @@-GdkColor * +GdkColor *background-gdk Read / Write @@ -160,13 +160,13 @@ -GdkRGBA * +GdkRGBA *background-rgba Read / Write -GdkColor * +GdkColor *foreground-gdk Read / Write @@ -482,8 +482,8 @@ -GdkRGBA * +GdkRGBA *foreground-rgba Read / Write
The
-“background-gdk”
property“background-gdk” GdkColor *-Background color as a GdkColor
+“background-gdk” GdkColor *
+Background color as a GdkColor
GtkCellRendererText:background-gdk
has been deprecated since version 3.4 and should not be used in newly-written code.Use “background-rgba” instead.
@@ -493,8 +493,8 @@
@@ -584,8 +584,8 @@The
-“background-rgba”
property“background-rgba” GdkRGBA *-Background color as a GdkRGBA
+“background-rgba” GdkRGBA *+Background color as a GdkRGBA
Flags: Read / Write
Since: 3.0
The
-“foreground-gdk”
property“foreground-gdk” GdkColor *-Foreground color as a GdkColor
+“foreground-gdk” GdkColor *
+Foreground color as a GdkColor
GtkCellRendererText:foreground-gdk
has been deprecated since version 3.4 and should not be used in newly-written code.Use “foreground-rgba” instead.
@@ -595,8 +595,8 @@
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkCellView.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkCellView.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkCellView.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkCellView.html 2017-09-11 15:58:06.000000000 +0000 @@ -190,13 +190,13 @@The
-“foreground-rgba”
property“foreground-rgba” GdkRGBA *-Foreground color as a GdkRGBA
+“foreground-rgba” GdkRGBA *+Foreground color as a GdkRGBA
Flags: Read / Write
Since: 3.0
-GdkColor * +GdkColor *background-gdk Read / Write @@ -623,7 +623,7 @@ -GdkRGBA * +GdkRGBA *background-rgba Read / Write gtk_cell_view_set_background_color ()
void gtk_cell_view_set_background_color (+GtkCellView *cell_view
, -const GdkColor *color
);const GdkColor *color
);
gtk_cell_view_set_background_color
has been deprecated since version 3.4 and should not be used in newly-written code.Use
@@ -659,7 +659,7 @@gtk_cell_view_set_background_rgba()
instead.gtk_cell_view_set_background_rgba ()
void gtk_cell_view_set_background_rgba (+GtkCellView *cell_view
, -const GdkRGBA *rgba
);const GdkRGBA *rgba
);Sets the background color of
cell_view
.@@ -858,8 +858,8 @@
The
-“background-gdk”
property“background-gdk” GdkColor *-The background color as a GdkColor
+“background-gdk” GdkColor *
+The background color as a GdkColor
GtkCellView:background-gdk
has been deprecated since version 3.4 and should not be used in newly-written code.Use “background-rgba” instead.
@@ -869,8 +869,8 @@
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkColorButton.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkColorButton.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkColorButton.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkColorButton.html 2017-09-11 15:58:06.000000000 +0000 @@ -165,13 +165,13 @@The
-“background-rgba”
property“background-rgba” GdkRGBA *-The background color as a GdkRGBA
+“background-rgba” GdkRGBA *+The background color as a GdkRGBA
Flags: Read / Write
Since: 3.0
-GdkColor * +GdkColor *color Read / Write @@ -277,7 +277,7 @@ -GdkRGBA * +GdkRGBA *rgba Read / Write gtk_color_button_new_with_color ()
GtkWidget * -gtk_color_button_new_with_color (+gtk_color_button_new_with_color (const GdkColor *color
);const GdkColor *color
);
gtk_color_button_new_with_color
has been deprecated since version 3.4 and should not be used in newly-written code.Use
@@ -293,7 +293,7 @@gtk_color_button_new_with_rgba()
instead.- color
+ A GdkColor to set the current color with
A GdkColor to set the current color with
gtk_color_button_set_color ()
void gtk_color_button_set_color (+GtkColorButton *button
, -const GdkColor *color
);const GdkColor *color
);
gtk_color_button_set_color
is deprecated and should not be used in newly-written code.Use
@@ -359,7 +359,7 @@gtk_color_chooser_set_rgba()
instead.- color
+ A GdkColor to set the current color with
A GdkColor to set the current color with
gtk_color_button_get_color ()
void gtk_color_button_get_color (+GtkColorButton *button
, -GdkColor *color
);GdkColor *color
);
gtk_color_button_get_color
has been deprecated since version 3.4 and should not be used in newly-written code.Use
@@ -395,7 +395,7 @@gtk_color_chooser_get_rgba()
instead.@@ -475,7 +475,7 @@ - color
+ a GdkColor to fill in with the current color.
a GdkColor to fill in with the current color.
[out] gtk_color_button_set_rgba ()
void gtk_color_button_set_rgba (+GtkColorButton *button
, -const GdkRGBA *rgba
);const GdkRGBA *rgba
);
gtk_color_button_set_rgba
has been deprecated since version 3.4 and should not be used in newly-written code.Use
@@ -499,7 +499,7 @@gtk_color_chooser_set_rgba()
instead.@@ -512,7 +512,7 @@ - rgba
+ a GdkRGBA to set the current color with
a GdkRGBA to set the current color with
gtk_color_button_get_rgba ()
void gtk_color_button_get_rgba (+GtkColorButton *button
, -GdkRGBA *rgba
);GdkRGBA *rgba
);
gtk_color_button_get_rgba
has been deprecated since version 3.4 and should not be used in newly-written code.Use
@@ -536,7 +536,7 @@gtk_color_chooser_get_rgba()
instead.@@ -690,7 +690,7 @@ - rgba
+ a GdkRGBA to fill in with the current color.
a GdkRGBA to fill in with the current color.
[out]
The
-“color”
property“color” GdkColor *+“color” GdkColor *
The selected color.
@@ -702,7 +702,7 @@
GtkColorButton:color
has been deprecated since version 3.4 and should not be used in newly-written code.
The
-“rgba”
property“rgba” GdkRGBA *+“rgba” GdkRGBA *The RGBA color.
Flags: Read / Write
Since: 3.0
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkColorChooser.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkColorChooser.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkColorChooser.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkColorChooser.html 2017-09-11 15:58:06.000000000 +0000 @@ -98,7 +98,7 @@@@ -175,7 +175,7 @@ -GdkRGBA * +GdkRGBA *rgba Read / Write gtk_color_chooser_get_rgba ()
void gtk_color_chooser_get_rgba (+GtkColorChooser *chooser
, -GdkRGBA *color
);GdkRGBA *color
);Gets the currently-selected color.
@@ -206,7 +206,7 @@Parameters
@@ -193,7 +193,7 @@- color
+ a GdkRGBA to fill in with the current color.
a GdkRGBA to fill in with the current color.
[out] gtk_color_chooser_set_rgba ()
void gtk_color_chooser_set_rgba (+GtkColorChooser *chooser
, -const GdkRGBA *color
);const GdkRGBA *color
);Sets the color.
Parameters
@@ -299,7 +299,7 @@GtkOrientation orientation
,gint colors_per_line
,gint n_colors
, -GdkRGBA *colors
); +GdkRGBA *colors
);Adds a palette to the color chooser. If
orientation
is horizontal, the colors are grouped in rows, withcolors_per_line
@@ -370,9 +370,9 @@Property Details
The
-“rgba”
property“rgba” GdkRGBA *+“rgba” GdkRGBA *The ::rgba property contains the currently selected color, -as a GdkRGBA struct. The property can be set to change +as a GdkRGBA struct. The property can be set to change the current selection programmatically.
Flags: Read / Write
Since: 3.4
@@ -382,7 +382,7 @@The
“use-alpha”
property“use-alpha” gbooleanWhen ::use-alpha is
TRUE
, colors may have alpha (translucency) -information. When it isFALSE
, the GdkRGBA struct obtained +information. When it isFALSE
, the GdkRGBA struct obtained via the “rgba” property will be forced to have alpha == 1.Implementations are expected to show alpha by rendering the color @@ -398,7 +398,7 @@
The
“color-activated”
signalvoid user_function (GtkColorChooser *chooser, - GdkRGBA *color, + GdkRGBA *color, gpointer user_data)Emitted when a color is activated from the color chooser. This usually happens when the user clicks a color swatch, diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkColorSelection.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkColorSelection.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkColorSelection.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkColorSelection.html 2017-09-11 15:58:06.000000000 +0000 @@ -246,13 +246,13 @@
-GdkColor * +GdkColor *current-color Read / Write @@ -535,7 +535,7 @@ -GdkRGBA * +GdkRGBA *current-rgba Read / Write gtk_color_selection_get_current_color ()
void gtk_color_selection_get_current_color (+GtkColorSelection *colorsel
, -GdkColor *color
);GdkColor *color
);
gtk_color_selection_get_current_color
has been deprecated since version 3.4 and should not be used in newly-written code.Use
@@ -558,7 +558,7 @@gtk_color_selection_get_current_rgba()
instead.@@ -570,7 +570,7 @@ - color
+ a GdkColor to fill in with the current color.
a GdkColor to fill in with the current color.
[out] gtk_color_selection_set_current_color ()
void gtk_color_selection_set_current_color (+GtkColorSelection *colorsel
, -const GdkColor *color
);const GdkColor *color
);
gtk_color_selection_set_current_color
has been deprecated since version 3.4 and should not be used in newly-written code.Use
@@ -596,7 +596,7 @@gtk_color_selection_set_current_rgba()
instead.@@ -672,7 +672,7 @@ - color
+ a GdkColor to set the current color with
a GdkColor to set the current color with
void gtk_color_selection_get_previous_color (+GtkColorSelection *colorsel
, -GdkColor *color
);GdkColor *color
);
gtk_color_selection_get_previous_color
has been deprecated since version 3.4 and should not be used in newly-written code.Use
@@ -695,7 +695,7 @@gtk_color_selection_get_previous_rgba()
instead.@@ -708,7 +708,7 @@ - color
+ a GdkColor to fill in with the original color value.
a GdkColor to fill in with the original color value.
[out] void gtk_color_selection_set_previous_color (+GtkColorSelection *colorsel
, -const GdkColor *color
);const GdkColor *color
);
gtk_color_selection_set_previous_color
has been deprecated since version 3.4 and should not be used in newly-written code.Use
@@ -735,7 +735,7 @@gtk_color_selection_set_previous_rgba()
instead.@@ -747,7 +747,7 @@ - color
+ a GdkColor to set the previous color with
a GdkColor to set the previous color with
gtk_color_selection_get_current_rgba ()
void gtk_color_selection_get_current_rgba (+GtkColorSelection *colorsel
, -GdkRGBA *rgba
);GdkRGBA *rgba
);
gtk_color_selection_get_current_rgba
is deprecated and should not be used in newly-written code.Sets
@@ -767,7 +767,7 @@rgba
to be the current color in the GtkColorSelection widget.@@ -780,7 +780,7 @@ - rgba
+ a GdkRGBA to fill in with the current color.
a GdkRGBA to fill in with the current color.
[out] gtk_color_selection_set_current_rgba ()
void gtk_color_selection_set_current_rgba (+GtkColorSelection *colorsel
, -const GdkRGBA *rgba
);const GdkRGBA *rgba
);
gtk_color_selection_set_current_rgba
is deprecated and should not be used in newly-written code.Sets the current color to be
@@ -803,7 +803,7 @@rgba
.@@ -816,7 +816,7 @@ - rgba
+ A GdkRGBA to set the current color with
A GdkRGBA to set the current color with
gtk_color_selection_get_previous_rgba ()
void gtk_color_selection_get_previous_rgba (+GtkColorSelection *colorsel
, -GdkRGBA *rgba
);GdkRGBA *rgba
);
gtk_color_selection_get_previous_rgba
is deprecated and should not be used in newly-written code.Fills
@@ -836,7 +836,7 @@rgba
in with the original color value.@@ -849,7 +849,7 @@ - rgba
+ a GdkRGBA to fill in with the original color value.
a GdkRGBA to fill in with the original color value.
[out] gtk_color_selection_set_previous_rgba ()
void gtk_color_selection_set_previous_rgba (+GtkColorSelection *colorsel
, -const GdkRGBA *rgba
);const GdkRGBA *rgba
);
gtk_color_selection_set_previous_rgba
is deprecated and should not be used in newly-written code.Sets the “previous” color to be
@@ -873,7 +873,7 @@rgba
.@@ -916,11 +916,11 @@ - rgba
+ a GdkRGBA to set the previous color with
a GdkRGBA to set the previous color with
gboolean gtk_color_selection_palette_from_string (const gchar *str
, -GdkColor **colors
, +GdkColor **colors
,gint *n_colors
);
gtk_color_selection_palette_from_string
is deprecated and should not be used in newly-written code.Parses a color palette string; the string is a colon-separated -list of color names readable by
+list of color names readable bygdk_color_parse()
.gdk_color_parse()
.Parameters
@@ -938,7 +938,7 @@
colors
+allocated array of GdkColor. return location for -allocated array of GdkColor.
[out][array length=n_colors] @@ -958,7 +958,7 @@ gtk_color_selection_palette_to_string ()
gchar * -gtk_color_selection_palette_to_string (const GdkColor *colors
, +gtk_color_selection_palette_to_string (const GdkColor *colors
,gint n_colors
);
gtk_color_selection_palette_to_string
is deprecated and should not be used in newly-written code.Encodes a palette as a string, useful for persistent storage.
@@ -993,7 +993,7 @@GtkColorSelectionChangePaletteFunc ()
void -(*GtkColorSelectionChangePaletteFunc) (const GdkColor *colors
, +(*GtkColorSelectionChangePaletteFunc) (const GdkColor *colors
,gint n_colors
);
GtkColorSelectionChangePaletteFunc
has been deprecated since version 3.4 and should not be used in newly-written code.@@ -1058,8 +1058,8 @@GtkColorSelectionChangePaletteWithScreenFunc ()
void (*GtkColorSelectionChangePaletteWithScreenFunc) - (GdkScreen *screen
, -const GdkColor *colors
, + (GdkScreen *screen
, +const GdkColor *colors
,gint n_colors
);
GtkColorSelectionChangePaletteWithScreenFunc
has been deprecated since version 3.4 and should not be used in newly-written code.@@ -1132,7 +1132,7 @@
The
-“current-color”
property“current-color” GdkColor *+“current-color” GdkColor *
The current GdkColor color.
@@ -1143,7 +1143,7 @@
GtkColorSelection:current-color
has been deprecated since version 3.4 and should not be used in newly-written code.
The
-“current-rgba”
property“current-rgba” GdkRGBA *+“current-rgba” GdkRGBA *The current RGBA color.
Flags: Read / Write
Since: 3.0
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkComboBox.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkComboBox.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkComboBox.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkComboBox.html 2017-09-11 15:58:06.000000000 +0000 @@ -1063,7 +1063,9 @@ gtk_combo_box_get_active_iter (GtkComboBox *combo_box
,GtkTreeIter *iter
);Sets
+ to point to the currently active item, if any item is active. +Otherwise,iter
- to point to the current active item, if it exists.iter
+ is left unchanged.@@ -4998,7 +5012,7 @@Parameters
@@ -1080,7 +1082,7 @@
@@ -1088,8 +1090,8 @@ - iter
+ The uninitialized GtkTreeIter.
A GtkTreeIter.
[out] Since: 2.4
@@ -1351,12 +1353,12 @@gtk_combo_box_popup_for_device ()
void gtk_combo_box_popup_for_device (+GtkComboBox *combo_box
, -GdkDevice *device
);GdkDevice *device
);Pops up the menu or dropdown list of
+are the only GdkDevices able to send events to it.combo_box
, the popup window will be grabbed so onlydevice
and its associated pointer/keyboard -are the only GdkDevices able to send events to it.Parameters
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkDrawingArea.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkDrawingArea.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkDrawingArea.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkDrawingArea.html 2017-09-11 15:58:06.000000000 +0000 @@ -167,7 +167,7 @@ gtk_style_context_get_color (context, gtk_style_context_get_state (context), &color); - gdk_cairo_set_source_rgba (cr, &color); + gdk_cairo_set_source_rgba (cr, &color); cairo_fill (cr); @@ -188,7 +188,7 @@ onscreen, or when it’s covered by another window and then uncovered. You can also force an expose event by adding to the “damage region” of the drawing area’s window;@@ -1373,7 +1375,7 @@
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/gtk-compiling.html gtk+3.0-3.22.21/docs/reference/gtk/html/gtk-compiling.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/gtk-compiling.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/gtk-compiling.html 2017-09-11 15:58:06.000000000 +0000 @@ -67,12 +67,12 @@ emit warnings when they are used (e.g. with gcc, you need to use the -Wdeprecated-declarations option). If these warnings are problematic, they can be turned off by defining the preprocessor -symbol - device
+ GDK_DISABLE_DEPRECATION_WARNINGS
by using the commandline +symbolGDK_DISABLE_DEPRECATION_WARNINGS
by using the commandline option-DGDK_DISABLE_DEPRECATION_WARNINGS
GTK+ deprecation annotations are versioned; by defining the -macros
GDK_VERSION_MIN_REQUIRED
andGDK_VERSION_MAX_ALLOWED
, +macrosGDK_VERSION_MIN_REQUIRED
andGDK_VERSION_MAX_ALLOWED
, you can specify the range of GTK+ versions whose API you want to use. APIs that were deprecated before or introduced after this range will trigger compiler warnings. diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkContainer.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkContainer.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkContainer.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkContainer.html 2017-09-11 15:58:06.000000000 +0000 @@ -1900,7 +1900,7 @@cairo_t *cr
);When a container receives a call to the draw function, it must send synthetic “draw” calls to all children that don’t have their -own GdkWindows. This function provides a convenient way of doing this. +own GdkWindows. This function provides a convenient way of doing this. A container, when it receives a call to its “draw” function, calls
gtk_container_propagate_draw()
once for each child, passing in thecr
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkDialog.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkDialog.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkDialog.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkDialog.html 2017-09-11 15:58:06.000000000 +0000 @@ -1097,7 +1097,7 @@gtk_widget_queue_draw_area()
and -gdk_window_invalidate_rect()
are equally good ways to do this. +gdk_window_invalidate_rect()
are equally good ways to do this. You’ll then get a draw signal for the invalid region.The available routines for drawing are documented on the GDK Drawing Primitives page diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkEntry.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkEntry.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkEntry.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkEntry.html 2017-09-11 15:58:06.000000000 +0000 @@ -1406,7 +1406,7 @@
gtk_entry_get_text_area ()
void gtk_entry_get_text_area (+GtkEntry *entry
, -GdkRectangle *text_area
);GdkRectangle *text_area
);Gets the area where the entry’s text is drawn. This function is useful when drawing something to the entry in a draw callback.
If the entry is not realized,
text_area
@@ -2713,7 +2713,7 @@gtk_entry_im_context_filter_keypress ()
gboolean gtk_entry_im_context_filter_keypress (+GtkEntry *entry
, -GdkEventKey *event
);GdkEventKey *event
);Allow the GtkEntry input method to internally handle key press and release events. If this function returns
TRUE
, then no further processing should be done for this key event. See @@ -3572,7 +3572,7 @@ gtk_entry_set_icon_drag_source (GtkEntry *entry
,GtkEntryIconPosition icon_pos
,GtkTargetList *target_list
, -GdkDragAction actions
); +GdkDragAction actions
);Sets up the icon at the given position so that GTK+ will start a drag operation when the user clicks and drags the icon.
To handle the drag operation, you need to connect to the usual @@ -3656,7 +3656,7 @@
void gtk_entry_get_icon_area (+GtkEntry *entry
,GtkEntryIconPosition icon_pos
, -GdkRectangle *icon_area
);GdkRectangle *icon_area
);Gets the area where entry’s icon at
icon_pos
is drawn. This function is useful when drawing something to the @@ -4217,6 +4217,20 @@+ + ++ + +Suggest offering Emoji support. Since 3.22.20
++ + + + +Suggest not offering Emoji support. Since 3.22.20
++ void user_function (GtkEntry *entry, GtkEntryIconPosition icon_pos, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::icon-press signal is emitted when an activatable icon is clicked.
@@ -5043,7 +5057,7 @@void user_function (GtkEntry *entry, GtkEntryIconPosition icon_pos, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::icon-release signal is emitted on the button release from a mouse click over an activatable icon.
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkEventBox.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkEventBox.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkEventBox.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkEventBox.html 2017-09-11 15:58:06.000000000 +0000 @@ -241,10 +241,10 @@Set whether the event box uses a visible or invisible child window. The default is to use visible windows.
In an invisible window event box, the window that the -event box creates is a
-GDK_INPUT_ONLY
window, which +event box creates is aGDK_INPUT_ONLY
window, which means that it is invisible and only serves to receive events.A visible window event box creates a visible (
GDK_INPUT_OUTPUT
) +A visible window event box creates a visible (
GDK_INPUT_OUTPUT
) window that acts as the parent window for all the widgets contained in the event box.You should generally make your event box invisible if diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkEventController.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkEventController.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkEventController.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkEventController.html 2017-09-11 15:58:06.000000000 +0000 @@ -142,7 +142,7 @@
Description
GtkEventController is a base, low-level implementation for event -controllers. Those react to a series of GdkEvents, and possibly trigger +controllers. Those react to a series of GdkEvents, and possibly trigger actions as a consequence of those.
@@ -216,7 +216,7 @@gtk_event_controller_handle_event ()
gboolean gtk_event_controller_handle_event (+GtkEventController *controller
, -const GdkEvent *event
);const GdkEvent *event
);Feeds an events into
@@ -236,7 +236,7 @@controller
, so it can be interpreted and the controller actions triggered.@@ -381,7 +381,7 @@ - event
+ a GdkEvent
a GdkEvent
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkGesture.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkGesture.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkGesture.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkGesture.html 2017-09-11 15:58:06.000000000 +0000 @@ -44,7 +44,7 @@The
“widget”
property“widget” GtkWidget *-The widget receiving the GdkEvents that the controller will handle.
+The widget receiving the GdkEvents that the controller will handle.
Flags: Read / Write / Construct Only
Since: 3.14
-GdkDevice * +GdkDevice * gtk_gesture_get_device () @@ -52,7 +52,7 @@ -GdkWindow * +GdkWindow * gtk_gesture_get_window () @@ -124,14 +124,14 @@ -GdkEventSequence * +GdkEventSequence * gtk_gesture_get_last_updated_sequence () - const GdkEvent * + const GdkEvent * gtk_gesture_get_last_event () @@ -212,7 +212,7 @@ @@ -295,7 +295,7 @@ -GdkWindow * +GdkWindow *window Read / Write GtkGesture is the base object for gesture recognition, although this object is quite generalized to serve as a base for multi-touch gestures, it is suitable to implement single-touch and pointer-based gestures (using -the special
+the specialNULL
GdkEventSequence value for these).NULL
GdkEventSequence value for these).The number of touches that a GtkGesture need to be recognized is controlled by the “n-points” property, if a gesture is keeping track of less or more than that number of sequences, it won't check wether the gesture @@ -332,7 +332,7 @@ GtkGestures, both across the parents of the widget receiving the event and in parallel within an individual widget. It is a responsibility of the widgets using those gestures to set the state of touch sequences accordingly -in order to enable cooperation of gestures around the GdkEventSequences +in order to enable cooperation of gestures around the GdkEventSequences triggering those.
Within a widget, gestures can be grouped through
gtk_gesture_group()
, grouped gestures synchronize the state of sequences, so calling @@ -356,13 +356,13 @@Stopping event propagation after the gesture group handles the event.
Note: if a sequence is set early to GTK_EVENT_SEQUENCE_CLAIMED on -GDK_TOUCH_BEGIN/GDK_BUTTON_PRESS (so those events are captured before +GDK_TOUCH_BEGIN/GDK_BUTTON_PRESS (so those events are captured before reaching the event widget, this implies GTK_PHASE_CAPTURE), one similar event will emulated if the sequence changes to GTK_EVENT_SEQUENCE_DENIED. This way event coherence is preserved before event propagation is unstopped again.
Sequence states can't be changed freely, see
+to know about the possible lifetimes of a GdkEventSequence.gtk_gesture_set_sequence_state()
-to know about the possible lifetimes of a GdkEventSequence.@@ -380,9 +380,9 @@Touchpad gestures
@@ -370,9 +370,9 @@ touchpad gesture events. The only precautions users of GtkGesture should do to enable this support are:-
- +
Enabling
GDK_TOUCHPAD_GESTURE_MASK
on their GdkWindowsEnabling
GDK_TOUCHPAD_GESTURE_MASK
on their GdkWindows- +
If the gesture has
GTK_PHASE_NONE
, ensuring events of type -GDK_TOUCHPAD_SWIPE
andGDK_TOUCHPAD_PINCH
are handled by the GtkGestureGDK_TOUCHPAD_SWIPE
andGDK_TOUCHPAD_PINCH
are handled by the GtkGestureFunctions
@@ -539,7 +539,7 @@gtk_gesture_get_device ()
-GdkDevice * +GdkDevice * gtk_gesture_get_device (-GtkGesture *gesture
);Returns the master GdkDevice that is currently operating +
Returns the master GdkDevice that is currently operating on
gesture
, orNULL
if the gesture is not being interacted.@@ -402,7 +402,7 @@Since: 3.14
@@ -410,7 +410,7 @@
gtk_gesture_get_window ()
-GdkWindow * +GdkWindow * gtk_gesture_get_window (GtkGesture *gesture
);Returns the user-defined window that receives the events handled by
gesture
@@ -443,7 +443,7 @@gtk_gesture_set_window ()
void gtk_gesture_set_window (+GtkGesture *gesture
, -GdkWindow *window
);GdkWindow *window
);Sets a specific window to receive events about, so
gesture
will effectively handle only events targetingwindow
@@ -466,7 +466,7 @@- window
+ [allow-none] gtk_gesture_get_sequence_state ()
GtkEventSequenceState gtk_gesture_get_sequence_state (+GtkGesture *gesture
, -GdkEventSequence *sequence
);GdkEventSequence *sequence
);Returns the
@@ -559,7 +559,7 @@sequence
state, as seen bygesture
.@@ -577,7 +577,7 @@ - sequence
+ gtk_gesture_set_sequence_state ()
gboolean gtk_gesture_set_sequence_state (GtkGesture *gesture
, -GdkEventSequence *sequence
, +GdkEventSequence *sequence
,GtkEventSequenceState state
);Sets the state of
sequence
ingesture
@@ -662,7 +662,7 @@- sequence
+ @@ -726,7 +726,7 @@ gtk_gesture_get_sequences ()
GList * gtk_gesture_get_sequences (-GtkGesture *gesture
);Returns the list of GdkEventSequences currently being interpreted +
Returns the list of GdkEventSequences currently being interpreted by
gesture
.@@ -747,7 +747,7 @@Returns
A list -of GdkEventSequences, the list elements are owned by GTK+ +of GdkEventSequences, the list elements are owned by GTK+ and must not be freed or modified, the list itself must be deleted through
g_list_free()
.[transfer container][element-type GdkEventSequence]
@@ -759,7 +759,7 @@gtk_gesture_handles_sequence ()
gboolean gtk_gesture_handles_sequence (+GtkGesture *gesture
, -GdkEventSequence *sequence
);GdkEventSequence *sequence
);Returns
TRUE
ifgesture
is currently handling events corresponding tosequence
@@ -780,7 +780,7 @@@@ -797,9 +797,9 @@ - sequence
+ a GdkEventSequence or
NULL
.a GdkEventSequence or
NULL
.[nullable]
gtk_gesture_get_last_updated_sequence ()
-GdkEventSequence * +GdkEventSequence * gtk_gesture_get_last_updated_sequence (-GtkGesture *gesture
);Returns the GdkEventSequence that was last updated on
gesture
+Returns the GdkEventSequence that was last updated on
gesture
.Parameters
@@ -826,9 +826,9 @@
gtk_gesture_get_last_event ()
-const GdkEvent * +const GdkEvent * gtk_gesture_get_last_event (+GtkGesture *gesture
, -GdkEventSequence *sequence
);GdkEventSequence *sequence
);Returns the last event that was processed for
sequence
.Note that the returned pointer is only valid as long as the
sequence
@@ -852,7 +852,7 @@@@ -870,7 +870,7 @@ - sequence
+ gtk_gesture_get_point ()
gboolean gtk_gesture_get_point (GtkGesture *gesture
, -GdkEventSequence *sequence
, +GdkEventSequence *sequence
,gdouble *x
,gdouble *y
);If
sequence
@@ -897,7 +897,7 @@- sequence
+ a GdkEventSequence, or
NULL
for pointer events.a GdkEventSequence, or
NULL
for pointer events.[allow-none] @@ -925,7 +925,7 @@ gtk_gesture_get_bounding_box ()
gboolean gtk_gesture_get_bounding_box (+GtkGesture *gesture
, -GdkRectangle *rect
);GdkRectangle *rect
);If there are touch sequences being currently handled by
-gesture
, this function returnsTRUE
and fills inrect
@@ -1023,11 +1023,11 @@ to the same group thangroup_gesture
. Gestures are by default isolated in their own groups.When gestures are grouped, the state of GdkEventSequences +
When gestures are grouped, the state of GdkEventSequences is kept in sync for all of those, so calling
gtk_gesture_set_sequence_state()
, on one will transfer the same value to the others.Groups also perform an "implicit grabbing" of sequences, if a -GdkEventSequence state is set to GTK_EVENT_SEQUENCE_CLAIMED on one group, +GdkEventSequence state is set to GTK_EVENT_SEQUENCE_CLAIMED on one group, every other gesture group attached to the same GtkWidget will switch the state for that sequence to GTK_EVENT_SEQUENCE_DENIED.
@@ -1154,7 +1154,7 @@
enum GtkEventSequenceState
-Describes the state of a GdkEventSequence in a GtkGesture.
+Describes the state of a GdkEventSequence in a GtkGesture.
Members
@@ -668,7 +668,7 @@@@ -1205,9 +1205,9 @@
@@ -1218,7 +1218,7 @@The
-“window”
property“window” GdkWindow *+“window” GdkWindow *If non-
+this GdkWindow, or a child of it.NULL
, the gesture will only listen for events that happen on -this GdkWindow, or a child of it.Flags: Read / Write
Since: 3.14
The
“begin”
signalvoid user_function (GtkGesture *gesture, - GdkEventSequence *sequence, + GdkEventSequence *sequence, gpointer user_data)This signal is emitted when the gesture is recognized. This means the number of touch sequences matches “n-points”, and the “check” @@ -1243,7 +1243,7 @@
- sequence
+ the GdkEventSequence that made the gesture to be recognized
the GdkEventSequence that made the gesture to be recognized
@@ -1262,7 +1262,7 @@ The
“cancel”
signalvoid user_function (GtkGesture *gesture, - GdkEventSequence *sequence, + GdkEventSequence *sequence, gpointer user_data)This signal is emitted whenever a sequence is cancelled. This usually happens on active touches when
gtk_event_controller_reset()
is called @@ -1289,7 +1289,7 @@- sequence
+ the GdkEventSequence that was cancelled
the GdkEventSequence that was cancelled
@@ -1308,7 +1308,7 @@ The
“end”
signalvoid user_function (GtkGesture *gesture, - GdkEventSequence *sequence, + GdkEventSequence *sequence, gpointer user_data)This signal is emitted when
gesture
either stopped recognizing the event @@ -1337,7 +1337,7 @@- sequence
+ the GdkEventSequence that made gesture recognition to finish
the GdkEventSequence that made gesture recognition to finish
@@ -1356,7 +1356,7 @@ The
“sequence-state-changed”
signalvoid user_function (GtkGesture *gesture, - GdkEventSequence *sequence, + GdkEventSequence *sequence, GtkEventSequenceState state, gpointer user_data)This signal is emitted whenever a sequence state changes. See @@ -1378,7 +1378,7 @@
- sequence
+ the GdkEventSequence that was cancelled
the GdkEventSequence that was cancelled
@@ -1402,7 +1402,7 @@ The
“update”
signalvoid user_function (GtkGesture *gesture, - GdkEventSequence *sequence, + GdkEventSequence *sequence, gpointer user_data)This signal is emitted whenever an event is handled while the gesture is recognized.
sequence
@@ -1423,7 +1423,7 @@- sequence
+ the GdkEventSequence that was updated
the GdkEventSequence that was updated
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkGestureMultiPress.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkGestureMultiPress.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkGestureMultiPress.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkGestureMultiPress.html 2017-09-11 15:58:06.000000000 +0000 @@ -168,7 +168,7 @@ gtk_gesture_multi_press_set_area ()
void gtk_gesture_multi_press_set_area (+GtkGestureMultiPress *gesture
, -const GdkRectangle *rect
);const GdkRectangle *rect
);If
rect
is non-NULL
, the press area will be checked to be confined within the rectangle, otherwise the button count @@ -208,7 +208,7 @@gtk_gesture_multi_press_get_area ()
gboolean gtk_gesture_multi_press_get_area (+GtkGestureMultiPress *gesture
, -GdkRectangle *rect
);GdkRectangle *rect
);If an area was set through
gtk_gesture_multi_press_set_area()
, this function will returnTRUE
and fill inrect
with the diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkGestureSingle.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkGestureSingle.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkGestureSingle.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkGestureSingle.html 2017-09-11 15:58:06.000000000 +0000 @@ -99,7 +99,7 @@-GdkEventSequence * +GdkEventSequence * gtk_gesture_single_get_current_sequence () @@ -172,7 +172,7 @@ interaction, these gestures stick to the first interacting sequence, which is accessible through gtk_gesture_single_get_current_sequence()
while the gesture is being interacted with. -By default gestures react to both
GDK_BUTTON_PRIMARY
and touch +By default gestures react to both
GDK_BUTTON_PRIMARY
and touch events,gtk_gesture_single_set_touch_only()
can be used to change the touch behavior. Callers may also specify a different mouse button number to interact with throughgtk_gesture_single_set_button()
, or react to any @@ -280,7 +280,7 @@If
touch_only
isTRUE
,gesture
will only handle events of type -GDK_TOUCH_BEGIN, GDK_TOUCH_UPDATE or GDK_TOUCH_END. IfFALSE
, +GDK_TOUCH_BEGIN, GDK_TOUCH_UPDATE or GDK_TOUCH_END. IfFALSE
, mouse events will be handled too.Parameters
@@ -403,7 +403,7 @@
gtk_gesture_single_get_current_sequence ()
-GdkEventSequence * +GdkEventSequence * gtk_gesture_single_get_current_sequence (GtkGestureSingle *gesture
);Returns the event sequence currently interacting with
gesture
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkGLArea.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkGLArea.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkGLArea.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkGLArea.html 2017-09-11 15:58:06.000000000 +0000 @@ -53,7 +53,7 @@-GdkGLContext * +GdkGLContext * gtk_gl_area_get_context () @@ -214,7 +214,7 @@ @@ -252,7 +252,7 @@ -GdkGLContext * +GdkGLContext *context Read @@ -310,7 +310,7 @@ -GdkGLContext* +GdkGLContext*create-context Run Last @@ -500,9 +500,9 @@Description
GtkGLArea is a widget that allows drawing with OpenGL.
-GtkGLArea sets up its own GdkGLContext for the window it creates, and +
GtkGLArea sets up its own GdkGLContext for the window it creates, and creates a custom GL framebuffer that the widget will do GL rendering onto. It also ensures that this framebuffer is the default GL rendering target when rendering.
@@ -318,7 +318,7 @@ or subclass GtkGLArea and override theGtkGLAreaClass.render()
virtual function. -The GtkGLArea widget ensures that the GdkGLContext is associated with +
The GtkGLArea widget ensures that the GdkGLContext is associated with the widget's drawing area, and it is kept updated when the size and position of the drawing area changes.
@@ -400,7 +400,7 @@If you need to initialize OpenGL state, e.g. buffer objects or shaders, you should use the “realize” signal; you can use the “unrealize” signal to clean up. Since the -GdkGLContext creation and initialization may fail, you will +GdkGLContext creation and initialization may fail, you will need to check for errors, using
gtk_gl_area_get_error()
. An example of how to safely initialize the GL state is:@@ -479,7 +479,7 @@-If you need to change the options for creating the GdkGLContext +
If you need to change the options for creating the GdkGLContext you should use the “create-context” signal.
gtk_gl_area_get_context ()
-GdkGLContext * +GdkGLContext * gtk_gl_area_get_context (-GtkGLArea *area
);Retrieves the GdkGLContext used by
area
+Retrieves the GdkGLContext used by
area
.Since: 3.16
@@ -531,7 +531,7 @@gtk_gl_area_make_current ()
void gtk_gl_area_make_current (-GtkGLArea *area
);Ensures that the GdkGLContext used by
area
+Ensures that the GdkGLContext used by
area
is associated with the GtkGLArea.This function is automatically called before emitting the @@ -1016,7 +1016,7 @@
gboolean use_es
);Sets whether the
-area
should create an OpenGL or an OpenGL ES context.You should check the capabilities of the GdkGLContext before drawing +
You should check the capabilities of the GdkGLContext before drawing with either API.
Parameters
@@ -1142,9 +1142,9 @@
The
-“context”
property“context” GdkGLContext *-The GdkGLContext used by the GtkGLArea widget.
-The GtkGLArea widget is responsible for creating the GdkGLContext +
“context” GdkGLContext *+The GdkGLContext used by the GtkGLArea widget.
+The GtkGLArea widget is responsible for creating the GdkGLContext instance. If you need to render with other kinds of buffers (stencil, depth, etc), use render buffers.
Flags: Read
@@ -1187,9 +1187,9 @@The
“use-es”
property“use-es” gboolean-If set to
TRUE
the widget will try to create a GdkGLContext using +If set to
-TRUE
the widget will try to create a GdkGLContext using OpenGL ES instead of OpenGL.See also:
+gdk_gl_context_set_use_es()
See also:
gdk_gl_context_set_use_es()
Flags: Read / Write
Default value: FALSE
Since: 3.22
@@ -1199,7 +1199,7 @@Signal Details
The
-“create-context”
signalGdkGLContext* +GdkGLContext* user_function (GtkGLArea *area, gpointer user_data)The ::create-context signal is emitted when the widget is being @@ -1239,7 +1239,7 @@
@@ -1251,7 +1251,7 @@Returns
-a newly created GdkGLContext; +
a newly created GdkGLContext; the GtkGLArea widget will take ownership of the returned value.
[transfer full]
The
“render”
signalgboolean user_function (GtkGLArea *area, - GdkGLContext *context, + GdkGLContext *context, gpointer user_data)The ::render signal is emitted every time the contents of the GtkGLArea should be redrawn.
@@ -1275,7 +1275,7 @@diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkIconTheme.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkIconTheme.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkIconTheme.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkIconTheme.html 2017-09-11 15:58:06.000000000 +0000 @@ -536,7 +536,7 @@ directly is also simple. The GtkIconTheme object acts as a database of all the icons in the current theme. You can create new GtkIconTheme objects, but it’s much more -efficient to use the standard icon theme for the GdkScreen +efficient to use the standard icon theme for the GdkScreen so that the icon information is shared with other people looking up icons. - context
the GdkGLContext used by
area
+the GdkGLContext used by
area
@@ -628,7 +628,7 @@gtk_icon_theme_get_for_screen ()
GtkIconTheme * -gtk_icon_theme_get_for_screen (+gtk_icon_theme_get_for_screen (GdkScreen *screen
);GdkScreen *screen
);Gets the icon theme object associated with
screen
; if this function has not previously been called for the given @@ -648,7 +648,7 @@- screen
+ gtk_icon_theme_set_screen ()
void gtk_icon_theme_set_screen (+GtkIconTheme *icon_theme
, -GdkScreen *screen
);GdkScreen *screen
);Sets the screen for an icon theme; the screen is used to track the user’s currently configured icon theme, which might be different for different screens.
@@ -688,7 +688,7 @@@@ -981,7 +981,7 @@ - screen
+ When rendering on displays with high pixel densities you should not use a
size
multiplied by the scaling factor returned by functions -likegdk_window_get_scale_factor()
. Instead, you should use +likegdk_window_get_scale_factor()
. Instead, you should usegtk_icon_theme_lookup_icon_for_scale()
, as the assets loaded for a given scaling factor may be different.@@ -1223,7 +1223,7 @@When rendering on displays with high pixel densities you should not use a
size
multiplied by the scaling factor returned by functions -likegdk_window_get_scale_factor()
. Instead, you should use +likegdk_window_get_scale_factor()
. Instead, you should usegtk_icon_theme_lookup_by_gicon_for_scale()
, as the assets loaded for a given scaling factor may be different.@@ -1479,7 +1479,7 @@const gchar *icon_name
,gint size
,gint scale
, -GdkWindow *for_window
, +GdkWindow *for_window
,GtkIconLookupFlags flags
,GError **error
);Looks up an icon in an icon theme for a particular window scale, @@ -1522,7 +1522,7 @@
- for_window
+ [allow-none] @@ -2081,7 +2081,7 @@ gtk_icon_info_load_surface ()
cairo_surface_t * gtk_icon_info_load_surface (GtkIconInfo *icon_info
, -GdkWindow *for_window
, +GdkWindow *for_window
,GError **error
);Renders an icon previously looked up in an icon theme using
gtk_icon_theme_lookup_icon()
; the size will be based on the size @@ -2110,7 +2110,7 @@- for_window
+ [allow-none] @@ -2229,10 +2229,10 @@ gtk_icon_info_load_symbolic ()
GdkPixbuf * gtk_icon_info_load_symbolic (GtkIconInfo *icon_info
, -const GdkRGBA *fg
, -const GdkRGBA *success_color
, -const GdkRGBA *warning_color
, -const GdkRGBA *error_color
, +const GdkRGBA *fg
, +const GdkRGBA *success_color
, +const GdkRGBA *warning_color
, +const GdkRGBA *error_color
,gboolean *was_symbolic
,GError **error
);Loads an icon, modifying it to match the system colours for the foreground, @@ -2263,24 +2263,24 @@
- fg
+ a GdkRGBA representing the foreground color of the icon
a GdkRGBA representing the foreground color of the icon
- success_color
a GdkRGBA representing the warning color +
a GdkRGBA representing the warning color of the icon or
NULL
to use the default color.[allow-none] - warning_color
a GdkRGBA representing the warning color +
a GdkRGBA representing the warning color of the icon or
NULL
to use the default color.[allow-none] @@ -2313,10 +2313,10 @@ - error_color
a GdkRGBA representing the error color +
a GdkRGBA representing the error color of the icon or
NULL
to use the default color (allow-none).[allow-none] gtk_icon_info_load_symbolic_async ()
void gtk_icon_info_load_symbolic_async (@@ -2340,24 +2340,24 @@GtkIconInfo *icon_info
, -const GdkRGBA *fg
, -const GdkRGBA *success_color
, -const GdkRGBA *warning_color
, -const GdkRGBA *error_color
, +const GdkRGBA *fg
, +const GdkRGBA *success_color
, +const GdkRGBA *warning_color
, +const GdkRGBA *error_color
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);- fg
+ a GdkRGBA representing the foreground color of the icon
a GdkRGBA representing the foreground color of the icon
- success_color
a GdkRGBA representing the warning color +
a GdkRGBA representing the warning color of the icon or
NULL
to use the default color.[allow-none] - warning_color
a GdkRGBA representing the warning color +
a GdkRGBA representing the warning color of the icon or
NULL
to use the default color.[allow-none] @@ -2728,7 +2728,7 @@ - error_color
a GdkRGBA representing the error color +
a GdkRGBA representing the error color of the icon or
NULL
to use the default color (allow-none).[allow-none] gtk_icon_info_get_embedded_rect ()
gboolean gtk_icon_info_get_embedded_rect (+GtkIconInfo *icon_info
, -GdkRectangle *rectangle
);GdkRectangle *rectangle
);
gtk_icon_info_get_embedded_rect
has been deprecated since version 3.14 and should not be used in newly-written code.Embedded rectangles are deprecated
@@ -2750,7 +2750,7 @@- rectangle
GdkRectangle in which to store embedded +
GdkRectangle in which to store embedded rectangle coordinates; coordinates are only stored when this function returns
TRUE
.[out] @@ -2769,7 +2769,7 @@gtk_icon_info_get_attach_points ()
gboolean gtk_icon_info_get_attach_points (GtkIconInfo *icon_info
, -GdkPoint **points
, +GdkPoint **points
,gint *n_points
);diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkIconView.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkIconView.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkIconView.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkIconView.html 2017-09-11 15:58:06.000000000 +0000 @@ -682,7 +682,7 @@
gtk_icon_info_get_attach_points
has been deprecated since version 3.14 and should not be used in newly-written code.@@ -2085,7 +2085,7 @@ gtk_icon_view_get_cell_rect ( -GdkColor * +GdkColor *selection-box-color Read GtkIconView *icon_view
,GtkTreePath *path
,GtkCellRenderer *cell
, -GdkRectangle *rect
); +GdkRectangle *rect
);Fills the bounding rectangle in widget coordinates for the cell specified by
path
andcell
@@ -2803,10 +2803,10 @@void gtk_icon_view_enable_model_drag_source (+GtkIconView *icon_view
, -GdkModifierType start_button_mask
, +GdkModifierType start_button_mask
,const GtkTargetEntry *targets
,gint n_targets
, -GdkDragAction actions
);GdkDragAction actions
);Turns
@@ -2859,7 +2859,7 @@ gtk_icon_view_enable_model_drag_dest (icon_view
into a drag source for automatic DND. Calling this method sets “reorderable” toFALSE
.GtkIconView *icon_view
,const GtkTargetEntry *targets
,gint n_targets
, -GdkDragAction actions
); +GdkDragAction actions
);Turns
@@ -3467,7 +3467,7 @@icon_view
into a drop destination for automatic DND. Calling this method sets “reorderable” toFALSE
.
The
-“selection-box-color”
style property“selection-box-color” GdkColor *+“selection-box-color” GdkColor *
The color of the selection box.
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkImage.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkImage.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkImage.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkImage.html 2017-09-11 15:58:06.000000000 +0000 @@ -434,7 +434,7 @@
GtkIconView:selection-box-color
has been deprecated since version 3.20 and should not be used in newly-written code.GtkImage is a subclass of GtkMisc, which implies that you can align it (center, left, right) and add padding to it, using GtkMisc methods.
-GtkImage is a “no window” widget (has no GdkWindow of its own), +
GtkImage is a “no window” widget (has no GdkWindow of its own), so by default does not receive events. If you want to receive events on the image, such as button clicks, place the image inside a GtkEventBox, then connect to the event signals on the event box.
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkIMContext.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkIMContext.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkIMContext.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkIMContext.html 2017-09-11 15:58:06.000000000 +0000 @@ -341,9 +341,9 @@gtk_im_context_set_client_window ()
void gtk_im_context_set_client_window (+GtkIMContext *context
, -GdkWindow *window
);GdkWindow *window
);Set the client window for the input context; this is the -GdkWindow in which the input appears. This window is +GdkWindow in which the input appears. This window is used in order to correctly position status windows, and may also be used for purposes internal to the input method.
@@ -424,7 +424,7 @@gtk_im_context_filter_keypress ()
gboolean gtk_im_context_filter_keypress (+GtkIMContext *context
, -GdkEventKey *event
);GdkEventKey *event
);Allow an input method to internally handle key press and release events. If this function returns
@@ -534,7 +534,7 @@TRUE
, then no further processing should be done for this key event.gtk_im_context_set_cursor_location ()
void gtk_im_context_set_cursor_location (+GtkIMContext *context
, -const GdkRectangle *area
);const GdkRectangle *area
);Notify the input method that a change in cursor position has been made. The location is relative to the client window.
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkInvisible.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkInvisible.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkInvisible.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkInvisible.html 2017-09-11 15:58:06.000000000 +0000 @@ -68,7 +68,7 @@-GdkScreen * +GdkScreen * gtk_invisible_get_screen () @@ -87,7 +87,7 @@ @@ -148,7 +148,7 @@ -GdkScreen * +GdkScreen *screen Read / Write gtk_invisible_new_for_screen ()
GtkWidget * -gtk_invisible_new_for_screen (+gtk_invisible_new_for_screen (GdkScreen *screen
);GdkScreen *screen
);Creates a new GtkInvisible object for a specified screen
Parameters
@@ -160,7 +160,7 @@@@ -177,8 +177,8 @@ - screen
a GdkScreen which identifies on which +
a GdkScreen which identifies on which the new GtkInvisible will be created.
gtk_invisible_set_screen ()
void gtk_invisible_set_screen (-GtkInvisible *invisible
, -GdkScreen *screen
);Sets the GdkScreen where the GtkInvisible object will be displayed.
+GdkScreen *screen
); +Sets the GdkScreen where the GtkInvisible object will be displayed.
Parameters
@@ -195,7 +195,7 @@
@@ -206,9 +206,9 @@ - screen
+ a GdkScreen.
a GdkScreen.
gtk_invisible_get_screen ()
-GdkScreen * ++GdkScreen * gtk_invisible_get_screen (-GtkInvisible *invisible
);Returns the GdkScreen object associated with
invisible
+Returns the GdkScreen object associated with
invisible
Since: 2.2
@@ -244,7 +244,7 @@Property Details
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkLayout.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkLayout.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkLayout.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkLayout.html 2017-09-11 15:58:06.000000000 +0000 @@ -118,7 +118,7 @@The
-“screen”
property“screen” GdkScreen *+“screen” GdkScreen *The screen where this window will be displayed.
Flags: Read / Write
-GdkWindow * +GdkWindow * gtk_layout_get_bin_window () @@ -213,7 +213,7 @@ If you just want to draw, a GtkDrawingArea is a better choice since it has lower overhead. If you just need to position child widgets at specific points, then GtkFixed provides that functionality on its own.
-When handling expose events on a GtkLayout, you must draw to the GdkWindow +
When handling expose events on a GtkLayout, you must draw to the GdkWindow returned by
@@ -572,7 +572,7 @@gtk_layout_get_bin_window()
, rather than to the one returned bygtk_widget_get_window()
as you would for a GtkDrawingArea.
gtk_layout_get_bin_window ()
-GdkWindow * +GdkWindow * gtk_layout_get_bin_window (GtkLayout *layout
);Retrieve the bin window of the layout used for drawing operations.
@@ -592,7 +592,7 @@Since: 2.14
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkMenu.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkMenu.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkMenu.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkMenu.html 2017-09-11 15:58:06.000000000 +0000 @@ -337,7 +337,7 @@Read / Write - @@ -348,7 +348,7 @@GdkAnchorHints +GdkAnchorHints anchor-hints Read / Write / Construct Read / Write - @@ -709,8 +709,8 @@GdkWindowTypeHint +GdkWindowTypeHint menu-type-hint Read / Write / Construct gtk_menu_set_screen ()
void gtk_menu_set_screen (-GtkMenu *menu
, -GdkScreen *screen
);Sets the GdkScreen on which the menu will be displayed.
+GdkScreen *screen
);Sets the GdkScreen on which the menu will be displayed.
Parameters
@@ -2692,7 +2692,7 @@@@ -727,7 +727,7 @@
@@ -847,11 +847,11 @@ - screen
a GdkScreen, or
NULL
if the screen should be determined by the widget the menu is attached to.[allow-none] gtk_menu_popup_at_rect ()
void gtk_menu_popup_at_rect (+GtkMenu *menu
, -GdkWindow *rect_window
, -const GdkRectangle *rect
, -GdkGravity rect_anchor
, -GdkGravity menu_anchor
, -const GdkEvent *trigger_event
);GdkWindow *rect_window
, +const GdkRectangle *rect
, +GdkGravity rect_anchor
, +GdkGravity menu_anchor
, +const GdkEvent *trigger_event
);Displays
menu
and makes it available for selection.See
gtk_menu_popup_at_widget()
andgtk_menu_popup_at_pointer()
, which @@ -892,13 +892,13 @@- rect_window
the GdkWindow
rect
+the GdkWindow
rect
is relative to.[not nullable] @@ -918,7 +918,7 @@ - rect
the GdkRectangle to align
menu
+the GdkRectangle to align
menu
with.[not nullable] @@ -947,9 +947,9 @@ - trigger_event
the GdkEvent that initiated this request or +
the GdkEvent that initiated this request or
NULL
if it's the current event.[nullable] void gtk_menu_popup_at_widget (+GtkMenu *menu
,GtkWidget *widget
, -GdkGravity widget_anchor
, -GdkGravity menu_anchor
, -const GdkEvent *trigger_event
);GdkGravity widget_anchor
, +GdkGravity menu_anchor
, +const GdkEvent *trigger_event
);Displays
menu
and makes it available for selection.See
gtk_menu_popup_at_pointer()
to pop up a menu at the master pointer. @@ -1009,7 +1009,7 @@@@ -1037,7 +1037,7 @@ - trigger_event
the GdkEvent that initiated this request or +
the GdkEvent that initiated this request or
NULL
if it's the current event.[nullable] gtk_menu_popup_at_pointer ()
void gtk_menu_popup_at_pointer (+GtkMenu *menu
, -const GdkEvent *trigger_event
);const GdkEvent *trigger_event
);Displays
menu
and makes it available for selection.See
gtk_menu_popup_at_widget()
to pop up a menu at a widget. @@ -1066,7 +1066,7 @@@@ -1094,7 +1094,7 @@ - trigger_event
the GdkEvent that initiated this request or +
the GdkEvent that initiated this request or
NULL
if it's the current event.[nullable] gtk_menu_popup_for_device ()
void gtk_menu_popup_for_device (GtkMenu *menu
, -GdkDevice *device
, +GdkDevice *device
,GtkWidget *parent_menu_shell
,GtkWidget *parent_menu_item
,GtkMenuPositionFunc func
, @@ -1152,7 +1152,7 @@- device
+ a GdkDevice.
a GdkDevice.
[allow-none] @@ -1505,7 +1505,7 @@ gtk_menu_set_monitor ( GtkMenu *menu
,gint monitor_num
);Informs GTK+ on which monitor a menu should be popped up. -See
+Seegdk_monitor_get_geometry()
.gdk_monitor_get_geometry()
.This function should be called from a GtkMenuPositionFunc if the menu should not appear on the same monitor as the pointer. This information can’t be reliably inferred from the coordinates @@ -1570,7 +1570,7 @@
gtk_menu_place_on_monitor ()
void gtk_menu_place_on_monitor (+GtkMenu *menu
, -GdkMonitor *monitor
);GdkMonitor *monitor
);Places
menu
on the given monitor.@@ -2128,13 +2128,13 @@
The
-“anchor-hints”
property“anchor-hints” GdkAnchorHints+“anchor-hints” GdkAnchorHintsPositioning hints for aligning the menu relative to a rectangle.
These hints determine how the menu should be positioned in the case that the menu would fall off-screen if placed in its ideal position.
-
For example,
GDK_ANCHOR_FLIP_Y
will replaceGDK_GRAVITY_NORTH_WEST
with -GDK_GRAVITY_SOUTH_WEST
and vice versa if the menu extends beyond the +For example,
GDK_ANCHOR_FLIP_Y
will replaceGDK_GRAVITY_NORTH_WEST
with +GDK_GRAVITY_SOUTH_WEST
and vice versa if the menu extends beyond the bottom edge of the monitor.See
gtk_menu_popup_at_rect()
,gtk_menu_popup_at_widget()
,gtk_menu_popup_at_pointer()
, “rect-anchor-dx”, @@ -2170,8 +2170,8 @@
The
-“menu-type-hint”
property“menu-type-hint” GdkWindowTypeHint-The GdkWindowTypeHint to use for the menu's GdkWindow.
+“menu-type-hint” GdkWindowTypeHint+The GdkWindowTypeHint to use for the menu's GdkWindow.
See
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkMenuShell.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkMenuShell.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkMenuShell.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkMenuShell.html 2017-09-11 15:58:06.000000000 +0000 @@ -599,7 +599,7 @@ set togtk_menu_popup_at_rect()
,gtk_menu_popup_at_widget()
,gtk_menu_popup_at_pointer()
, “anchor-hints”, “rect-anchor-dx”, “rect-anchor-dy”, and “popped-up”.FALSE
should not display mnemonics or accelerators, since it cannot be guaranteed that they will work. -See also
+gdk_keyboard_grab()
See also
gdk_keyboard_grab()
Parameters
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/gtk-migrating-2-to-3.html gtk+3.0-3.22.21/docs/reference/gtk/html/gtk-migrating-2-to-3.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/gtk-migrating-2-to-3.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/gtk-migrating-2-to-3.html 2017-09-11 15:58:06.000000000 +0000 @@ -311,7 +311,7 @@ GError *error = NULL; info = (GAppInfo*) g_desktop_app_info_new ("epiphany.desktop"); -context = (GAppLaunchContext*) gdk_display_get_app_launch_context (display); +context = (GAppLaunchContext*) gdk_display_get_app_launch_context (display); g_app_info_launch (info, NULL, context, &error); if (error) @@ -337,7 +337,7 @@ with
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/gtk-migrating-GtkStyleContext-parser-extensions.html gtk+3.0-3.22.21/docs/reference/gtk/html/gtk-migrating-GtkStyleContext-parser-extensions.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/gtk-migrating-GtkStyleContext-parser-extensions.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/gtk-migrating-GtkStyleContext-parser-extensions.html 2017-09-11 15:58:06.000000000 +0000 @@ -34,7 +34,7 @@ The installed properties depend on the “name” property, so they should be added in theg_app_info_create_from_commandline()
, or you can use the more lowlevelg_spawn
family of functions (e.g.g_spawn_command_line_async()
), and passDISPLAY
- in the environment.gdk_screen_make_display_name()
can be + in the environment.gdk_screen_make_display_name()
can be used to find the right value for theDISPLAY
environment variable. @@ -410,8 +410,8 @@ 2 3 4 - cairo_t *cr = gdk_cairo_create (window); -gdk_cairo_set_source_pixbuf (cr, pixbuf, x, y); +@@ -423,7 +423,7 @@ Note that very similar code can be used when porting code using GdkPixmap to cairo_surface_t by calling cairo_t *cr = gdk_cairo_create (window); +gdk_cairo_set_source_pixbuf (cr, pixbuf, x, y); cairo_paint (cr); cairo_destroy (cr);cairo_set_source_surface()
instead of -gdk_cairo_set_source_pixbuf()
. +gdk_cairo_set_source_pixbuf()
. @@ -493,7 +493,7 @@ cairo_surface_t *surface; surface = ... -cr = gdk_cairo_create (window); +cr = gdk_cairo_create (window); cairo_set_source_surface (cr, surface, x_origin, y_origin); cairo_pattern_set_extend (cairo_get_source (cr), CAIRO_EXTEND_REPEAT); cairo_rectangle (cr, 0, 0, width, height); @@ -508,7 +508,7 @@ The surface here can be either an image surface or a X surface, and can either be created on the spot or kept around for caching purposes. Another alternative is to use pixbufs instead of surfaces with -gdk_cairo_set_source_pixbuf()
instead ofcairo_set_source_surface()
. +gdk_cairo_set_source_pixbuf()
instead ofcairo_set_source_surface()
. @@ -576,15 +576,15 @@ GdkRGBA rgba; cairo_t *cr; -cr = gdk_cairo_create (drawable); +cr = gdk_cairo_create (drawable); /* clip */ -gdk_cairo_rectangle (cr, &area); +gdk_cairo_rectangle (cr, &area); cairo_clip (cr); /* set the correct source color */ context = gtk_widget_get_style_context (widget)); state = gtk_widget_get_state_flags (widget); gtk_style_context_get_color (context, state, &rgba); -gdk_cairo_set_source_rgba (cr, &rgba); +gdk_cairo_set_source_rgba (cr, &rgba); /* draw the text */ cairo_move_to (cr, x, y); pango_cairo_show_layout (cr, layout); @@ -597,7 +597,7 @@Clipping using
@@ -718,7 +718,7 @@cairo_clip()
is of course not restricted to text rendering and can be used everywhere where GC clips were used. - And usinggdk_cairo_set_source_color()
with style colors should + And usinggdk_cairo_set_source_color()
with style colors should be used in all the places where a style’s GC was used to achieve a particular color.+gdk_rgba_free (color1); cairo_t *cr = cairo_create (surface); /* clipping restricts the intermediate surface's size, so it's a good idea * to use it. */ -gdk_cairo_rectangle (cr, &area); +gdk_cairo_rectangle (cr, &area); cairo_clip (cr); /* Now push a group to change the target */ cairo_push_group (cr); @@ -737,7 +737,7 @@ The surface here can be either an image surface or a X surface, and can either be created on the spot or kept around for caching purposes. Another alternative is to use pixbufs instead of surfaces with -gdk_cairo_set_source_pixbuf()
instead ofcairo_set_source_surface()
. +gdk_cairo_set_source_pixbuf()
instead ofcairo_set_source_surface()
. The cairo developers plan to add self-copies in the future to allow exactly this effect, so you might want to keep up on cairo diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/gtk-migrating-GtkStyleContext-css.html gtk+3.0-3.22.21/docs/reference/gtk/html/gtk-migrating-GtkStyleContext-css.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/gtk-migrating-GtkStyleContext-css.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/gtk-migrating-GtkStyleContext-css.html 2017-09-11 15:58:06.000000000 +0000 @@ -385,7 +385,7 @@- With GtkStyleContext, you generally use GdkRGBA instead of GdkColor + With GtkStyleContext, you generally use GdkRGBA instead of GdkColor and the code looks like this:
vfunc. For example, if an engine with the name "Clearlooks" installs a - "focus-color" property with the type GdkRGBA, the property + "focus-color" property with the type GdkRGBA, the property
constructed()
-Clearlooks-focus-color
will be registered and accepted in CSS like this: diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkOverlay.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkOverlay.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkOverlay.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkOverlay.html 2017-09-11 15:58:06.000000000 +0000 @@ -426,7 +426,7 @@gboolean user_function (GtkOverlay *overlay, GtkWidget *widget, - GdkRectangle *allocation, + GdkRectangle *allocation, gpointer user_data)The ::get-child-position signal is emitted to determine the position and size of any overlay child widgets. A diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkPadController.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkPadController.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkPadController.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkPadController.html 2017-09-11 15:58:06.000000000 +0000 @@ -85,7 +85,7 @@
@@ -137,12 +137,12 @@ GAction objects, thus letting the application give those a more semantic meaning. -GdkDevice * +GdkDevice *pad Read / Write / Construct Only Buttons and sensors are not constrained to triggering a single action, some -
+may have different modes. SeeGDK_SOURCE_TABLET_PAD
devices feature multiple "modes", all these input +GDK_SOURCE_TABLET_PAD
devices feature multiple "modes", all these input elements have one current mode, which may determine the final action being triggered. Pad devices often divide buttons and sensors into groups, all elements in a group share the same current mode, but different groups -may have different modes. Seegdk_device_pad_get_n_groups()
and -gdk_device_pad_get_group_n_modes()
.gdk_device_pad_get_n_groups()
and +gdk_device_pad_get_group_n_modes()
.Each of the actions that a given button/strip/ring performs for a given mode is defined by GtkPadActionEntry, it contains an action name that will be looked up in the given GActionGroup and activated whenever the @@ -194,7 +194,7 @@
GtkPadController * gtk_pad_controller_new (+GtkWindow *window
,GActionGroup *group
, -GdkDevice *pad
);GdkDevice *pad
);Creates a new GtkPadController that will associate events from
pad
to actions. ANULL
pad may be provided so the controller manages all pad devices @@ -227,7 +227,7 @@@@ -455,14 +455,14 @@ - pad
+ A
GDK_SOURCE_TABLET_PAD
device, orNULL
to handle all pads.A
GDK_SOURCE_TABLET_PAD
device, orNULL
to handle all pads.[nullable]
@@ -233,7 +233,7 @@The
-“pad”
property“pad” GdkDevice *+“pad” GdkDevice *Pad device to control.
Flags: Read / Write / Construct Only
gtk_plug_construct_for_display ()
void gtk_plug_construct_for_display (GtkPlug *plug
, -GdkDisplay *display
, +GdkDisplay *display
,Window socket_id
);Finish the initialization of
plug
for a given GtkSocket identified by @@ -257,7 +257,7 @@diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkRange.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkRange.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkRange.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkRange.html 2017-09-11 15:58:06.000000000 +0000 @@ -1198,7 +1198,7 @@ - display
the GdkDisplay associated with
socket_id
+the GdkDisplay associated with
socket_id
’s GtkSocket.@@ -306,7 +306,7 @@ gtk_plug_new_for_display ()
GtkWidget * -gtk_plug_new_for_display (GdkDisplay *display
, +gtk_plug_new_for_display (GdkDisplay *display
,Window socket_id
);Create a new plug widget inside the GtkSocket identified by socket_id.
@@ -320,7 +320,7 @@@@ -396,7 +396,7 @@ - display
the GdkDisplay on which
socket_id
+the GdkDisplay on which
socket_id
is displayed
@@ -563,7 +563,7 @@gtk_plug_get_socket_window ()
-GdkWindow * +GdkWindow * gtk_plug_get_socket_window (GtkPlug *plug
);Retrieves the socket the plug is embedded in.
@@ -442,7 +442,7 @@
The
-“socket-window”
property“socket-window” GdkWindow *+“socket-window” GdkWindow *The window of the socket the plug is embedded in.
Flags: Read
Since: 2.14
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkPopover.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkPopover.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkPopover.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkPopover.html 2017-09-11 15:58:06.000000000 +0000 @@ -219,7 +219,7 @@@@ -652,7 +652,7 @@ -GdkRectangle * +GdkRectangle *pointing-to Read / Write gtk_popover_set_pointing_to ()
void gtk_popover_set_pointing_to (+GtkPopover *popover
, -const GdkRectangle *rect
);const GdkRectangle *rect
);Sets the rectangle that
popover
will point to, in the coordinate space of the widgetpopover
@@ -687,7 +687,7 @@gtk_popover_get_pointing_to ()
gboolean gtk_popover_get_pointing_to (+GtkPopover *popover
, -GdkRectangle *rect
);GdkRectangle *rect
);If a rectangle to point to has been set, this function will return
TRUE
and fill inrect
with such rectangle, otherwise @@ -1111,7 +1111,7 @@
The
-“pointing-to”
property“pointing-to” GdkRectangle *+“pointing-to” GdkRectangle *Marks a specific rectangle to be pointed.
Flags: Read / Write
Since: 3.12
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/gtk-question-index.html gtk+3.0-3.22.21/docs/reference/gtk/html/gtk-question-index.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/gtk-question-index.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/gtk-question-index.html 2017-09-11 15:58:06.000000000 +0000 @@ -547,7 +547,7 @@- 1 2 gdk_window_set_events (gdk_window, + gdk_window_set_events (gdk_window, GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK);@@ -756,10 +756,10 @@ - 1 2 gdk_window_set_events (gdk_window, + gdk_window_set_events (gdk_window, (GdkEventMask) GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK);To make a window transparent, it needs to use a visual which supports that. This is done by getting the RGBA visual of the screen with -
@@ -776,9 +776,9 @@ 7gdk_screen_get_rgba_visual()
and setting it on the window. Note that -gdk_screen_get_rgba_visual()
will returnNULL
if transparent windows +gdk_screen_get_rgba_visual()
and setting it on the window. Note that +gdk_screen_get_rgba_visual()
will returnNULL
if transparent windows are not supported on the screen, you should fall back to -gdk_screen_get_system_visual()
in that case. Additionally, note that this +gdk_screen_get_system_visual()
in that case. Additionally, note that this will change from screen to screen, so it needs to be repeated whenever the window is moved to a different screen. GdkVisual *visual; -visual = gdk_screen_get_rgba_visual (screen); +visual = gdk_screen_get_rgba_visual (screen); if (visual == NULL) - visual = gdk_screen_get_system_visual (screen); + visual = gdk_screen_get_system_visual (screen); gtk_widget_set_visual (GTK_WIDGET (window), visual);gtk_range_get_range_rect ()
void gtk_range_get_range_rect (+GtkRange *range
, -GdkRectangle *range_rect
);GdkRectangle *range_rect
);This function returns the area that contains the range’s trough and its steppers, in widget->window coordinates.
This function is useful mainly for GtkRange subclasses.
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkScrolledWindow.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkScrolledWindow.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkScrolledWindow.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkScrolledWindow.html 2017-09-11 15:58:06.000000000 +0000 @@ -889,8 +889,8 @@ unscrollable child to a viewport, then adding the viewport to the scrolled window. If a child has native scrolling, usegtk_container_add()
instead of this function. -The viewport scrolls the child by moving its GdkWindow, and takes -the size of the child to be the size of its toplevel GdkWindow. +
The viewport scrolls the child by moving its GdkWindow, and takes +the size of the child to be the size of its toplevel GdkWindow. This will be very wrong for most widgets that support native scrolling; for example, if you add a widget such as GtkTreeView with a viewport, the whole widget will scroll, including the column headings. Thus, @@ -1110,7 +1110,7 @@
gboolean kinetic_scrolling
);Turns kinetic scrolling on or off. Kinetic scrolling only applies to devices with source -
+GDK_SOURCE_TOUCHSCREEN
.GDK_SOURCE_TOUCHSCREEN
.Parameters
@@ -815,7 +815,7 @@@@ -1840,7 +1840,7 @@
The
“kinetic-scrolling”
property“kinetic-scrolling” gbooleanWhether kinetic scrolling is enabled or not. Kinetic scrolling -only applies to devices with source
+only applies to devices with sourceGDK_SOURCE_TOUCHSCREEN
.GDK_SOURCE_TOUCHSCREEN
.Flags: Read / Write
Default value: TRUE
Since: 3.4
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkSearchBar.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkSearchBar.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkSearchBar.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkSearchBar.html 2017-09-11 15:58:06.000000000 +0000 @@ -360,11 +360,11 @@gtk_search_bar_handle_event ()
gboolean gtk_search_bar_handle_event (+GtkSearchBar *bar
, -GdkEvent *event
);GdkEvent *event
);This function should be called when the top-level window which contains the search bar received a key event.
If the key event is handled by the search bar, the bar will -be shown, the entry populated with the entered text and
GDK_EVENT_STOP
+be shown, the entry populated with the entered text andGDK_EVENT_STOP
will be returned. The caller should ensure that events are not propagated further.If no entry has been connected to the search bar, using @@ -425,7 +425,7 @@
@@ -433,9 +433,9 @@ - event
+ a GdkEvent containing key press events
a GdkEvent containing key press events
Returns
-
GDK_EVENT_STOP
if the key press event resulted ++the search bar if necessary),
GDK_EVENT_STOP
if the key press event resulted in text being entered in the search entry (and revealing -the search bar if necessary),GDK_EVENT_PROPAGATE
otherwise.GDK_EVENT_PROPAGATE
otherwise.Since: 3.10
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkSearchEntry.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkSearchEntry.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkSearchEntry.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkSearchEntry.html 2017-09-11 15:58:06.000000000 +0000 @@ -167,7 +167,7 @@gtk_search_entry_handle_event ()
gboolean gtk_search_entry_handle_event (+GtkSearchEntry *entry
, -GdkEvent *event
);GdkEvent *event
);This function should be called when the top-level window which contains the search entry received a key event. If the entry is part of a GtkSearchBar, it is preferable @@ -175,7 +175,7 @@ reveal the entry in addition to passing the event to this function.
If the key event is handled by the search entry and starts -or continues a search,
GDK_EVENT_STOP
will be returned. +or continues a search,GDK_EVENT_STOP
will be returned. The caller should ensure that the entry is shown in this case, and not propagate the event further.@@ -202,8 +202,8 @@Returns
-
GDK_EVENT_STOP
if the key press event resulted -in a search beginning or continuing,GDK_EVENT_PROPAGATE
+
GDK_EVENT_STOP
if the key press event resulted +in a search beginning or continuing,GDK_EVENT_PROPAGATE
otherwise.Since: 3.16
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkSettings.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkSettings.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkSettings.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkSettings.html 2017-09-11 15:58:06.000000000 +0000 @@ -720,7 +720,7 @@gtk_settings_get_for_screen ()
GtkSettings * -gtk_settings_get_for_screen (+gtk_settings_get_for_screen (GdkScreen *screen
);GdkScreen *screen
);Gets the GtkSettings object for
screen
, creating it if necessary.@@ -825,7 +825,7 @@ - property_value
+ a GValue which must hold GdkColor values.
Returns
+has been set to the resulting GdkColor.
TRUE
ifgstring
could be parsed andproperty_value
-has been set to the resulting GdkColor.
@@ -1231,7 +1231,7 @@The
“color-hash”
property“color-hash” GHashTable *Holds a hash table representation of the “gtk-color-scheme” -setting, mapping color names to GdkColors.
+setting, mapping color names to GdkColors.[transfer container]
@@ -1355,7 +1355,7 @@ Color names must be acceptable as identifiers in the gtkrc syntax, and color specifications must be in the format accepted by -
GtkSettings:color-hash
has been deprecated since version 3.8 and should not be used in newly-written code.gdk_color_parse()
. +gdk_color_parse()
.Note that due to the way the color tables from different sources are merged, color specifications will be converted to hexadecimal form when getting this property.
@@ -1602,7 +1602,7 @@“gtk-error-bell” gbooleanWhen
TRUE
, keyboard navigation and other input-related errors will cause a beep. Since the error bell is implemented using -gdk_window_beep()
, the windowing system may offer ways to +gdk_window_beep()
, the windowing system may offer ways to configure the error bell in many ways, such as flashing the window or similar visual effects.Flags: Read / Write
@@ -1731,7 +1731,7 @@
GtkSettings:gtk-keynav-cursor-only
has been deprecated since version 3.10 and should not be used in newly-written code.Generally, the behavior for touchscreen input should be - performed dynamically based on
+ performed dynamically based ongdk_event_get_source_device()
.gdk_event_get_source_device()
.Flags: Read / Write
Default value: FALSE
@@ -2185,7 +2185,7 @@
GtkSettings:gtk-touchscreen-mode
has been deprecated since version 3.4. and should not be used in newly-written code.Generally, the behavior for touchscreen input should be - performed dynamically based on
+ performed dynamically based ongdk_event_get_source_device()
.gdk_event_get_source_device()
.Flags: Read / Write
Default value: FALSE
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkSocket.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkSocket.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkSocket.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkSocket.html 2017-09-11 15:58:06.000000000 +0000 @@ -68,7 +68,7 @@-GdkWindow * +GdkWindow * gtk_socket_get_plug_window () @@ -193,7 +193,7 @@ allowing the same level of integration when embedding a Qt widget in GTK or vice versa. The GtkPlug and GtkSocket widgets are only available when GTK+ -is compiled for the X11 platform and
@@ -282,7 +282,7 @@GDK_WINDOWING_X11
is defined. +is compiled for the X11 platform andGDK_WINDOWING_X11
is defined. They can only be used on a GdkX11Display. To use GtkPlug and GtkSocket, you need to include thegtk/gtkx.h
header.
gtk_socket_get_plug_window ()
-GdkWindow * +GdkWindow * gtk_socket_get_plug_window (GtkSocket *socket_
);Retrieves the window of the plug. Use this to check if the plug has been created inside of the socket.
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkStatusIcon.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkStatusIcon.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkStatusIcon.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkStatusIcon.html 2017-09-11 15:58:06.000000000 +0000 @@ -186,7 +186,7 @@-GdkScreen * +GdkScreen * gtk_status_icon_get_screen () @@ -364,7 +364,7 @@ @@ -1103,12 +1103,12 @@ -GdkScreen * +GdkScreen *screen Read / Write gtk_status_icon_set_screen ()
void gtk_status_icon_set_screen (+GtkStatusIcon *status_icon
, -GdkScreen *screen
);GdkScreen *screen
);-
gtk_status_icon_set_screen
has been deprecated since version 3.14 and should not be used in newly-written code.Use notifications
Sets the GdkScreen where
status_icon
+Sets the GdkScreen where
@@ -1128,7 +1128,7 @@status_icon
is displayed; if the icon is already mapped, it will be unmapped, and then remapped on the new screen.@@ -1139,13 +1139,13 @@ - screen
+
gtk_status_icon_get_screen ()
-GdkScreen * +GdkScreen * gtk_status_icon_get_screen (GtkStatusIcon *status_icon
);-
gtk_status_icon_get_screen
has been deprecated since version 3.14 and should not be used in newly-written code.Use notifications
Returns the GdkScreen associated with
status_icon
+Returns the GdkScreen associated with
status_icon
.Since: 2.12
@@ -1665,8 +1665,8 @@gtk_status_icon_get_geometry ()
gboolean gtk_status_icon_get_geometry (GtkStatusIcon *status_icon
, -GdkScreen **screen
, -GdkRectangle *area
, +GdkScreen **screen
, +GdkRectangle *area
,GtkOrientation *orientation
);@@ -1851,7 +1851,7 @@
gtk_status_icon_get_geometry
has been deprecated since version 3.14 and should not be used in newly-written code.
@@ -1982,7 +1982,7 @@The
-“screen”
property“screen” GdkScreen *+“screen” GdkScreen *The screen where this status icon will be displayed.
Flags: Read / Write
The
“button-press-event”
signalgboolean user_function (GtkStatusIcon *status_icon, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::button-press-event signal will be emitted when a button (typically from a mouse) is pressed.
@@ -2004,7 +2004,7 @@@@ -2029,7 +2029,7 @@ - event
the GdkEventButton which triggered +
the GdkEventButton which triggered this signal.
[type Gdk.EventButton] The
“button-release-event”
signalgboolean user_function (GtkStatusIcon *status_icon, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::button-release-event signal will be emitted when a button (typically from a mouse) is released.
@@ -2051,7 +2051,7 @@@@ -2216,7 +2216,7 @@ - event
the GdkEventButton which triggered +
the GdkEventButton which triggered this signal.
[type Gdk.EventButton] The
“scroll-event”
signalgboolean user_function (GtkStatusIcon *status_icon, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::scroll-event signal is emitted when a button in the 4 to 7 range is pressed. Wheel mice are usually configured to generate @@ -2238,7 +2238,7 @@
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkStyleContext.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkStyleContext.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkStyleContext.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkStyleContext.html 2017-09-11 15:58:06.000000000 +0000 @@ -115,7 +115,7 @@ - event
the GdkEventScroll which triggered +
the GdkEventScroll which triggered this signal.
[type Gdk.EventScroll] -GdkScreen * +GdkScreen * gtk_style_context_get_screen () @@ -123,7 +123,7 @@ -GdkFrameClock * +GdkFrameClock * gtk_style_context_get_frame_clock () @@ -691,7 +691,7 @@ @@ -703,7 +703,7 @@ -GdkFrameClock * +GdkFrameClock *paint-clock Read / Write @@ -1177,7 +1177,7 @@ combination of all providers’ information in priority order. -GdkScreen * +GdkScreen *screen Read / Write For GTK+ widgets, any GtkStyleContext returned by
gtk_widget_get_style_context()
will already have a GtkWidgetPath, a -GdkScreen and RTL/LTR information set. The style context will also be +GdkScreen and RTL/LTR information set. The style context will also be updated automatically if any of these settings change on the widget.If you are using the theming layer standalone, you will need to set a widget path and a screen yourself to the created style context through @@ -1293,7 +1293,7 @@
gtk_style_context_add_provider_for_screen ()
void gtk_style_context_add_provider_for_screen - (GdkScreen *screen
, + (GdkScreen *screen
,GtkStyleProvider *provider
,guint priority
);Adds a global style provider to
screen
@@ -1316,7 +1316,7 @@- screen
+ @@ -1553,9 +1553,9 @@
gtk_style_context_get_screen ()
-GdkScreen * +GdkScreen * gtk_style_context_get_screen (-GtkStyleContext *context
);Returns the GdkScreen to which
context
+Returns the GdkScreen to which
context
is attached.
gtk_style_context_get_frame_clock ()
-GdkFrameClock * +GdkFrameClock * gtk_style_context_get_frame_clock (-GtkStyleContext *context
);Returns the GdkFrameClock to which
context
+Returns the GdkFrameClock to which
context
is attached.Returns
-a GdkFrameClock, or
NULL
+a GdkFrameClock, or
NULL
ifcontext
does not have an attached frame clock.[nullable][transfer none]
@@ -1839,7 +1839,7 @@void gtk_style_context_get_color (+GtkStyleContext *context
,GtkStateFlags state
, -GdkRGBA *color
);GdkRGBA *color
);Gets the foreground color for a given state.
See
@@ -1879,7 +1879,7 @@ gtk_style_context_get_background_color (gtk_style_context_get_property()
and GTK_STYLE_PROPERTY_COLOR for details.GtkStyleContext *context
,GtkStateFlags state
, -GdkRGBA *color
); +GdkRGBA *color
);
gtk_style_context_get_background_color
has been deprecated since version 3.16 and should not be used in newly-written code.Use
@@ -1927,7 +1927,7 @@gtk_render_background()
instead.void gtk_style_context_get_border_color (+GtkStyleContext *context
,GtkStateFlags state
, -GdkRGBA *color
);GdkRGBA *color
);
gtk_style_context_get_border_color
has been deprecated since version 3.16 and should not be used in newly-written code.Use
@@ -2215,7 +2215,7 @@gtk_render_frame()
instead.gboolean gtk_style_context_lookup_color (+GtkStyleContext *context
,const gchar *color_name
, -GdkRGBA *color
);GdkRGBA *color
);Looks up and resolves a color name in the
context
color map.@@ -2299,7 +2299,7 @@gtk_style_context_notify_state_change ()
void gtk_style_context_notify_state_change (@@ -2394,7 +2394,7 @@GtkStyleContext *context
, -GdkWindow *window
, +GdkWindow *window
,gpointer region_id
,GtkStateType state
,gboolean state_value
);- window
+ @@ -2546,14 +2546,14 @@ gtk_style_context_scroll_animations ()
void gtk_style_context_scroll_animations (GtkStyleContext *context
, -GdkWindow *window
, +GdkWindow *window
,gint dx
,gint dy
);-
gtk_style_context_scroll_animations
has been deprecated since version 3.6 and should not be used in newly-written code.This function does nothing.
This function is analogous to
gdk_window_scroll()
, and +This function is analogous to
@@ -2573,7 +2573,7 @@gdk_window_scroll()
, and should be called together with it so the invalidation areas for any ongoing animation are scrolled together with it.@@ -2630,7 +2630,7 @@ - window
a GdkWindow used previously in +
a GdkWindow used previously in
gtk_style_context_notify_state_change()
gtk_style_context_remove_provider_for_screen ()
void gtk_style_context_remove_provider_for_screen - (GdkScreen *screen
, + (GdkScreen *screen
,GtkStyleProvider *provider
);Removes
provider
from the global style providers list inscreen
@@ -2646,7 +2646,7 @@- screen
+ @@ -2663,9 +2663,9 @@ gtk_style_context_reset_widgets ()
void -gtk_style_context_reset_widgets (+gtk_style_context_reset_widgets (GdkScreen *screen
);GdkScreen *screen
);This function recomputes the styles for all widgets under a particular -GdkScreen. This is useful when some global parameter has changed that +GdkScreen. This is useful when some global parameter has changed that affects the appearance 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 color scheme changes @@ -2680,7 +2680,7 @@
- screen
+ gtk_style_context_set_background ()
void gtk_style_context_set_background (+GtkStyleContext *context
, -GdkWindow *window
);GdkWindow *window
);
gtk_style_context_set_background
has been deprecated since version 3.18 and should not be used in newly-written code.Use
gtk_render_background()
instead. @@ -2720,7 +2720,7 @@@@ -3291,7 +3291,7 @@ - window
+ gtk_style_context_set_screen ()
void gtk_style_context_set_screen (+GtkStyleContext *context
, -GdkScreen *screen
);GdkScreen *screen
);Attaches
context
to the given screen.The screen is used to add style information from “global” style @@ -3315,7 +3315,7 @@
@@ -3328,7 +3328,7 @@ - screen
+ gtk_style_context_set_frame_clock ()
void gtk_style_context_set_frame_clock (+GtkStyleContext *context
, -GdkFrameClock *frame_clock
);GdkFrameClock *frame_clock
);Attaches
context
to the given frame clock.The frame clock is used for the timing of animations.
@@ -3346,12 +3346,12 @@- context
+ @@ -3681,7 +3681,7 @@ - frame_clock
+ gdouble y
,gdouble width
,gdouble height
, -GdkRectangle *out_clip
); +GdkRectangle *out_clip
);Returns the area that will be affected (i.e. drawn to) when calling
gtk_render_background()
for the givencontext
and @@ -4723,14 +4723,14 @@GTK_STYLE_PROPERTY_BACKGROUND_COLOR
#define GTK_STYLE_PROPERTY_BACKGROUND_COLOR "background-color"-A property holding the background color of rendered elements as a GdkRGBA.
+A property holding the background color of rendered elements as a GdkRGBA.
GTK_STYLE_PROPERTY_COLOR
#define GTK_STYLE_PROPERTY_COLOR "color"-A property holding the foreground color of rendered elements as a GdkRGBA.
+A property holding the foreground color of rendered elements as a GdkRGBA.
@@ -4792,7 +4792,7 @@GTK_STYLE_PROPERTY_BORDER_COLOR
#define GTK_STYLE_PROPERTY_BORDER_COLOR "border-color"-A property holding the element’s border color as a GdkRGBA.
+A property holding the element’s border color as a GdkRGBA.
@@ -5901,7 +5901,7 @@
@@ -5917,7 +5917,7 @@The
-“paint-clock”
property“paint-clock” GdkFrameClock *+“paint-clock” GdkFrameClock *The associated GdkFrameClock.
Flags: Read / Write
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkStyle.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkStyle.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkStyle.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkStyle.html 2017-09-11 15:58:06.000000000 +0000 @@ -501,7 +501,7 @@The
-“screen”
property“screen” GdkScreen *+“screen” GdkScreen *The associated GdkScreen.
Flags: Read / Write
gtk_style_attach ()
GtkStyle * gtk_style_attach (+GtkStyle *style
, -GdkWindow *window
);GdkWindow *window
);
gtk_style_attach
has been deprecated since version 3.0 and should not be used in newly-written code.Use
@@ -531,7 +531,7 @@gtk_widget_style_attach()
instead@@ -608,7 +608,7 @@ - window
+ a GdkWindow.
a GdkWindow.
gtk_style_set_background ()
void gtk_style_set_background (GtkStyle *style
, -GdkWindow *window
, +GdkWindow *window
,GtkStateType state_type
);@@ -634,7 +634,7 @@
gtk_style_set_background
has been deprecated since version 3.0 and should not be used in newly-written code.- window
+ @@ -652,7 +652,7 @@ void gtk_style_apply_default_background (GtkStyle *style
,cairo_t *cr
, -GdkWindow *window
, +GdkWindow *window
,GtkStateType state_type
,gint x
,gint y
, @@ -669,7 +669,7 @@gboolean gtk_style_lookup_color (+GtkStyle *style
,const gchar *color_name
, -GdkColor *color
);GdkColor *color
);
gtk_style_lookup_color
has been deprecated since version 3.0 and should not be used in newly-written code.Use
@@ -702,7 +702,7 @@gtk_style_context_lookup_color()
instead@@ -2616,7 +2616,7 @@ - color
+ the GdkColor to fill in.
the GdkColor to fill in.
[out] GtkStateType state_type
,GtkWidget *widget
,const gchar *detail
, -GdkWindowEdge edge
, +GdkWindowEdge edge
,gint x
,gint y
,gint width
, @@ -2697,7 +2697,7 @@void gtk_draw_insertion_cursor (@@ -2799,53 +2799,53 @@GtkWidget *widget
,cairo_t *cr
, -const GdkRectangle *location
, +const GdkRectangle *location
,gboolean is_primary
,GtkTextDirection direction
,gboolean draw_arrow
);- - GdkColor
fg
[5];+ Set of foreground GdkColor
+ Set of foreground GdkColor
- - GdkColor
bg
[5];+ Set of background GdkColor
+ Set of background GdkColor
- - GdkColor
light
[5];+ Set of light GdkColor
+ Set of light GdkColor
- - GdkColor
dark
[5];+ Set of dark GdkColor
+ Set of dark GdkColor
- - GdkColor
mid
[5];+ Set of mid GdkColor
+ Set of mid GdkColor
- - GdkColor
text
[5];+ Set of text GdkColor
+ Set of text GdkColor
- - GdkColor
base
[5];+ Set of base GdkColor
+ Set of base GdkColor
- + GdkColor
text_aa
[5];Color halfway between text/base
- - GdkColor
black
;+ GdkColor to use for black
+ GdkColor to use for black
- - GdkColor
white
;+ GdkColor to use for white
+ GdkColor to use for white
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkTextBuffer.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkTextBuffer.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkTextBuffer.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkTextBuffer.html 2017-09-11 15:58:06.000000000 +0000 @@ -564,7 +564,7 @@ -GdkAtom * +GdkAtom * gtk_text_buffer_get_deserialize_formats () @@ -580,7 +580,7 @@ -GdkAtom * +GdkAtom * gtk_text_buffer_get_serialize_formats () @@ -588,7 +588,7 @@ -GdkAtom +GdkAtom gtk_text_buffer_register_deserialize_format () @@ -596,7 +596,7 @@ -GdkAtom +GdkAtom gtk_text_buffer_register_deserialize_tagset () @@ -604,7 +604,7 @@ -GdkAtom +GdkAtom gtk_text_buffer_register_serialize_format () @@ -612,7 +612,7 @@ -GdkAtom +GdkAtom gtk_text_buffer_register_serialize_tagset () @@ -3355,7 +3355,7 @@ contents of buffer
are available. In most cases,clipboard
will be -the GtkClipboard of typeGDK_SELECTION_PRIMARY
for a view ofbuffer
+the GtkClipboard of typeGDK_SELECTION_PRIMARY
for a view ofbuffer
.Parameters
@@ -3493,7 +3493,7 @@gboolean gtk_text_buffer_deserialize (GtkTextBuffer *register_buffer
,GtkTextBuffer *content_buffer
, -GdkAtom format
, +GdkAtom format
,GtkTextIter *iter
,const guint8 *data
,gsize length
, @@ -3567,7 +3567,7 @@gboolean gtk_text_buffer_deserialize_get_can_create_tags (+GtkTextBuffer *buffer
, -GdkAtom format
);GdkAtom format
);This functions returns the value set with
gtk_text_buffer_deserialize_set_can_create_tags()
@@ -3586,7 +3586,7 @@@@ -3604,7 +3604,7 @@ - format
+ a GdkAtom representing a registered rich text format
a GdkAtom representing a registered rich text format
void gtk_text_buffer_deserialize_set_can_create_tags (GtkTextBuffer *buffer
, -GdkAtom format
, +GdkAtom format
,gboolean can_create_tags
);Use this function to allow a rich text deserialization function to create new tags in the receiving buffer. Note that using this @@ -3637,7 +3637,7 @@
- format
+ a GdkAtom representing a registered rich text format
a GdkAtom representing a registered rich text format
@@ -3686,7 +3686,7 @@
gtk_text_buffer_get_deserialize_formats ()
-GdkAtom * +GdkAtom * gtk_text_buffer_get_deserialize_formats (@@ -3719,7 +3719,7 @@GtkTextBuffer *buffer
,gint *n_formats
);Returns
an array of -GdkAtoms representing the registered formats.
+GdkAtoms representing the registered formats.[array length=n_formats][transfer container]
Since: 2.10
@@ -3760,7 +3760,7 @@
gtk_text_buffer_get_serialize_formats ()
-GdkAtom * +GdkAtom * gtk_text_buffer_get_serialize_formats (GtkTextBuffer *buffer
,gint *n_formats
);This function returns the rich text serialize formats registered @@ -3792,7 +3792,7 @@
Returns
an array of -GdkAtoms representing the registered formats.
+GdkAtoms representing the registered formats.[array length=n_formats][transfer container]
Since: 2.10
@@ -3800,7 +3800,7 @@
gtk_text_buffer_register_deserialize_format ()
-GdkAtom +GdkAtom gtk_text_buffer_register_deserialize_format (GtkTextBuffer *buffer
,const gchar *mime_type
, @@ -3853,7 +3853,7 @@@@ -3862,7 +3862,7 @@Returns
-the GdkAtom that corresponds to the +
the GdkAtom that corresponds to the newly registered format’s mime-type.
[transfer none]
gtk_text_buffer_register_deserialize_tagset ()
-GdkAtom +GdkAtom gtk_text_buffer_register_deserialize_tagset (@@ -3894,7 +3894,7 @@GtkTextBuffer *buffer
,const gchar *tagset_name
);@@ -3903,7 +3903,7 @@Returns
-the GdkAtom that corresponds to the +
the GdkAtom that corresponds to the newly registered format’s mime-type.
[transfer none]
gtk_text_buffer_register_serialize_format ()
-GdkAtom +GdkAtom gtk_text_buffer_register_serialize_format (GtkTextBuffer *buffer
,const gchar *mime_type
, @@ -3956,7 +3956,7 @@@@ -3965,7 +3965,7 @@Returns
-the GdkAtom that corresponds to the +
the GdkAtom that corresponds to the newly registered format’s mime-type.
[transfer none]
gtk_text_buffer_register_serialize_tagset ()
-GdkAtom +GdkAtom gtk_text_buffer_register_serialize_tagset (@@ -4012,7 +4012,7 @@GtkTextBuffer *buffer
,const gchar *tagset_name
);@@ -4085,7 +4085,7 @@Returns
-the GdkAtom that corresponds to the +
the GdkAtom that corresponds to the newly registered format’s mime-type.
[transfer none]
guint8 * gtk_text_buffer_serialize (@@ -4156,7 +4156,7 @@GtkTextBuffer *register_buffer
,GtkTextBuffer *content_buffer
, -GdkAtom format
, +GdkAtom format
,const GtkTextIter *start
,const GtkTextIter *end
,gsize *length
);void gtk_text_buffer_unregister_deserialize_format (+GtkTextBuffer *buffer
, -GdkAtom format
);GdkAtom format
);This function unregisters a rich text format that was previously registered using
@@ -4176,7 +4176,7 @@gtk_text_buffer_register_deserialize_format()
orgtk_text_buffer_register_deserialize_tagset()
.@@ -4190,7 +4190,7 @@ - format
+ a GdkAtom representing a registered rich text format.
a GdkAtom representing a registered rich text format.
void gtk_text_buffer_unregister_serialize_format (+GtkTextBuffer *buffer
, -GdkAtom format
);GdkAtom format
);This function unregisters a rich text format that was previously registered using
@@ -4210,7 +4210,7 @@gtk_text_buffer_register_serialize_format()
orgtk_text_buffer_register_serialize_tagset()
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkTextTag.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkTextTag.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkTextTag.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkTextTag.html 2017-09-11 15:58:06.000000000 +0000 @@ -157,13 +157,13 @@ - format
+ a GdkAtom representing a registered rich text format.
a GdkAtom representing a registered rich text format.
-GdkColor * +GdkColor *background-gdk Read / Write @@ -239,13 +239,13 @@ -GdkRGBA * +GdkRGBA *background-rgba Read / Write -GdkColor * +GdkColor *foreground-gdk Read / Write @@ -329,13 +329,13 @@ -GdkRGBA * +GdkRGBA *foreground-rgba Read / Write -GdkColor * +GdkColor *paragraph-background-gdk Read / Write @@ -436,7 +436,7 @@ -GdkRGBA * +GdkRGBA *paragraph-background-rgba Read / Write @@ -478,7 +478,7 @@ -GdkRGBA * +GdkRGBA *strikethrough-rgba Read / Write @@ -689,7 +689,7 @@ -GdkRGBA * +GdkRGBA *underline-rgba Read / Write gboolean gtk_text_tag_event (GtkTextTag *tag
,GObject *event_object
, -GdkEvent *event
, +GdkEvent *event
,const GtkTextIter *iter
);Emits the “event” signal on the GtkTextTag.
@@ -1108,13 +1108,13 @@- - GdkColor
bg_color
;+ Background GdkColor.
+ Background GdkColor.
- - GdkColor
fg_color
;+ Foreground GdkColor.
+ Foreground GdkColor.
@@ -1155,8 +1155,8 @@ - @@ -1206,8 +1206,8 @@- GdkRGBA *
rgba
[2];+ + GdkRGBA *
rgba
[2];
The
-“background-gdk”
property“background-gdk” GdkColor *-Background color as a GdkColor.
+“background-gdk” GdkColor *
+Background color as a GdkColor.
GtkTextTag:background-gdk
has been deprecated since version 3.4 and should not be used in newly-written code.Use “background-rgba” instead.
@@ -1217,8 +1217,8 @@
@@ -1334,8 +1334,8 @@The
-“background-rgba”
property“background-rgba” GdkRGBA *-Background color as a GdkRGBA.
+“background-rgba” GdkRGBA *+Background color as a GdkRGBA.
Flags: Read / Write
Since: 3.2
The
-“foreground-gdk”
property“foreground-gdk” GdkColor *-Foreground color as a GdkColor.
+“foreground-gdk” GdkColor *
+Foreground color as a GdkColor.
GtkTextTag:foreground-gdk
has been deprecated since version 3.4 and should not be used in newly-written code.Use “foreground-rgba” instead.
@@ -1345,8 +1345,8 @@
@@ -1488,8 +1488,8 @@The
-“foreground-rgba”
property“foreground-rgba” GdkRGBA *-Foreground color as a GdkRGBA.
+“foreground-rgba” GdkRGBA *+Foreground color as a GdkRGBA.
Flags: Read / Write
Since: 3.2
The
-“paragraph-background-gdk”
property“paragraph-background-gdk” GdkColor *-The paragraph background color as a GdkColor.
+“paragraph-background-gdk” GdkColor *
+The paragraph background color as a GdkColor.
GtkTextTag:paragraph-background-gdk
has been deprecated since version 3.4 and should not be used in newly-written code.Use “paragraph-background-rgba” instead.
@@ -1500,8 +1500,8 @@
@@ -1667,7 +1667,7 @@The
-“paragraph-background-rgba”
property“paragraph-background-rgba” GdkRGBA *-The paragraph background color as a GdkRGBA.
+“paragraph-background-rgba” GdkRGBA *+The paragraph background color as a GdkRGBA.
Flags: Read / Write
Since: 3.2
The
-“strikethrough-rgba”
property“strikethrough-rgba” GdkRGBA *+“strikethrough-rgba” GdkRGBA *This property modifies the color of strikeouts. If not set, strikeouts will use the forground color.
Flags: Read / Write
@@ -1732,7 +1732,7 @@
@@ -1920,7 +1920,7 @@The
-“underline-rgba”
property“underline-rgba” GdkRGBA *+“underline-rgba” GdkRGBA *This property modifies the color of underlines. If not set, underlines will use the forground color.
If “underline” is set to
PANGO_UNDERLINE_ERROR
, an alternate @@ -1815,7 +1815,7 @@gboolean user_function (GtkTextTag *tag, GObject *object, - GdkEvent *event, + GdkEvent *event, GtkTextIter *iter, gpointer user_data)The ::event signal is emitted when an event occurs on a region of the diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkTextView.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkTextView.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkTextView.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkTextView.html 2017-09-11 15:58:06.000000000 +0000 @@ -206,7 +206,7 @@
-GdkWindow * +GdkWindow * gtk_text_view_get_window () @@ -785,7 +785,7 @@ @@ -1409,7 +1409,7 @@ -GdkColor * +GdkColor *error-underline-color Read gtk_text_view_get_visible_rect ()
void gtk_text_view_get_visible_rect (+GtkTextView *text_view
, -GdkRectangle *visible_rect
);GdkRectangle *visible_rect
);Fills
visible_rect
with the currently-visible region of the buffer, in buffer coordinates. Convert to window coordinates @@ -1443,7 +1443,7 @@void gtk_text_view_get_iter_location (+GtkTextView *text_view
,const GtkTextIter *iter
, -GdkRectangle *location
);GdkRectangle *location
);Gets a rectangle which roughly contains the character at
iter
. The rectangle position is in buffer coordinates; use @@ -1484,8 +1484,8 @@void gtk_text_view_get_cursor_locations (+GtkTextView *text_view
,const GtkTextIter *iter
, -GdkRectangle *strong
, -GdkRectangle *weak
);GdkRectangle *strong
, +GdkRectangle *weak
);Given an
iter
within a text layout, determine the positions of the strong and weak cursors if the insertion point is at that @@ -1878,10 +1878,10 @@
gtk_text_view_get_window ()
-GdkWindow * +GdkWindow * gtk_text_view_get_window (-GtkTextView *text_view
,GtkTextWindowType win
);Retrieves the GdkWindow corresponding to an area of the text view; +
Retrieves the GdkWindow corresponding to an area of the text view; possible windows include the overall widget window, child windows on the left, right, top, bottom, and the window that displays the text buffer. Windows are
NULL
and nonexistent if their width or @@ -1911,7 +1911,7 @@gtk_text_view_get_window_type ()
GtkTextWindowType gtk_text_view_get_window_type (+GtkTextView *text_view
, -GdkWindow *window
);GdkWindow *window
);Usually used to find out which window an event corresponds to.
If you connect to an event signal on
text_view
, this function @@ -3487,7 +3487,7 @@gboolean gtk_text_view_im_context_filter_keypress (+GtkTextView *text_view
, -GdkEventKey *event
);GdkEventKey *event
);Allow the GtkTextView input method to internally handle key press and release events. If this function returns
TRUE
, then no further processing should be done for this key event. See @@ -4318,7 +4318,7 @@Style Property Details
@@ -4550,8 +4550,8 @@The
-“error-underline-color”
style property“error-underline-color” GdkColor *+“error-underline-color” GdkColor *
Color with which to draw error-indication underlines.
Flags: Read
Returns
-+
GDK_EVENT_STOP
to stop other handlers from being invoked for the -event.GDK_EVENT_PROPAGATE
to propagate the event further.
GDK_EVENT_STOP
to stop other handlers from being invoked for the +event.GDK_EVENT_PROPAGATE
to propagate the event further.Flags: Run Last
Since: 3.16
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkThemingEngine.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkThemingEngine.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkThemingEngine.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkThemingEngine.html 2017-09-11 15:58:06.000000000 +0000 @@ -82,7 +82,7 @@-GdkScreen * +GdkScreen * gtk_theming_engine_get_screen () @@ -471,10 +471,10 @@
@@ -677,7 +677,7 @@gtk_theming_engine_get_screen ()
-GdkScreen * +GdkScreen * gtk_theming_engine_get_screen (GtkThemingEngine *engine
);-
gtk_theming_engine_get_screen
has been deprecated since version 3.14 and should not be used in newly-written code.Returns the GdkScreen to which
engine
+Returns the GdkScreen to which
engine
currently rendering to.void gtk_theming_engine_get_color (+GtkThemingEngine *engine
,GtkStateFlags state
, -GdkRGBA *color
);GdkRGBA *color
);
gtk_theming_engine_get_color
has been deprecated since version 3.14 and should not be used in newly-written code.Gets the foreground color for a given state.
@@ -716,7 +716,7 @@ gtk_theming_engine_get_background_color (GtkThemingEngine *engine
,GtkStateFlags state
, -GdkRGBA *color
); +GdkRGBA *color
);
gtk_theming_engine_get_background_color
has been deprecated since version 3.14 and should not be used in newly-written code.Gets the background color for a given state.
@@ -754,7 +754,7 @@void gtk_theming_engine_get_border_color (+GtkThemingEngine *engine
,GtkStateFlags state
, -GdkRGBA *color
);GdkRGBA *color
);
gtk_theming_engine_get_border_color
has been deprecated since version 3.14 and should not be used in newly-written code.Gets the border color for a given state.
@@ -1032,7 +1032,7 @@gboolean gtk_theming_engine_lookup_color (+GtkThemingEngine *engine
,const gchar *color_name
, -GdkRGBA *color
);GdkRGBA *color
);
gtk_theming_engine_lookup_color
has been deprecated since version 3.14 and should not be used in newly-written code.Looks up and resolves a color name in the current style’s color map.
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkToolbar.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkToolbar.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkToolbar.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkToolbar.html 2017-09-11 15:58:06.000000000 +0000 @@ -354,10 +354,14 @@ GtkSeparatorToolItem to the toolbar. If the GtkToolbar child property “expand” is TRUE and the property “draw” is set to FALSE, the effect is to force all following items to the end of the toolbar. +@@ -634,11 +638,15 @@By default, a toolbar can be shrunk, upon which it will add an arrow button +to show an overflow menu offering access to any GtkToolItem child that has +a proxy menu item. To disable this and request enough size for all children, +call
gtk_toolbar_set_show_arrow()
to set “show-arrow” toFALSE
.Creating a context menu for the toolbar can be done by connecting to the “popup-context-menu” signal.
void gtk_toolbar_set_show_arrow (-GtkToolbar *toolbar
,gboolean show_arrow
);Sets whether to show an overflow menu when -
+toolbar
- doesn’t have room for all items on it. IfTRUE
, -items that there are not room are available through an -overflow menu.Sets whether to show an overflow menu when
toolbar
+ isn’t allocated enough +size to show all of its items. IfTRUE
, items which can’t fit intoolbar
+, +and which have a proxy menu item set bygtk_tool_item_set_proxy_menu_item()
+or “create-menu-proxy”, will be available in an overflow menu, +which can be opened by an added arrow button. IfFALSE
,toolbar
+ will +request enough size to fit all of its child items without any overflow.Parameters
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkToolItem.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkToolItem.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkToolItem.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkToolItem.html 2017-09-11 15:58:06.000000000 +0000 @@ -1158,7 +1158,7 @@
The GtkMenuItem passed to
-gtk_tool_item_set_proxy_menu_item()
, if themenu_item_ids
match.[transfer none]
+[transfer none][nullable]
Since: 2.4
@@ -1173,6 +1173,7 @@menu_item_id
is used to identify the caller of this function and should also be used withgtk_tool_item_get_proxy_menu_item()
. +See also “create-menu-proxy”.
Parameters
@@ -479,7 +479,7 @@@@ -1184,8 +1185,8 @@
- tool_item
- + + a GtkToolItem.
[nullable] diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkToolPalette.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkToolPalette.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkToolPalette.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkToolPalette.html 2017-09-11 15:58:06.000000000 +0000 @@ -857,7 +857,7 @@ menu_item_id
GtkWidget *widget
,GtkDestDefaults flags
,GtkToolPaletteDragTargets targets
, -GdkDragAction actions
); +GdkDragAction actions
);Sets
palette
as drag source (seegtk_tool_palette_set_drag_source()
) and setswidget
@@ -898,7 +898,7 @@diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkTooltip.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkTooltip.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkTooltip.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkTooltip.html 2017-09-11 15:58:06.000000000 +0000 @@ -451,7 +451,7 @@ - actions
+ the GdkDragActions which the widget should suppport
the GdkDragActions which the widget should suppport
gtk_tooltip_trigger_tooltip_query ()
void -gtk_tooltip_trigger_tooltip_query (+gtk_tooltip_trigger_tooltip_query (GdkDisplay *display
);GdkDisplay *display
);Triggers a new tooltip query on
display
, in order to update the current visible tooltip, or to show/hide the current tooltip. This function is @@ -467,7 +467,7 @@- display
+ gtk_tooltip_set_tip_area ()
void gtk_tooltip_set_tip_area (+GtkTooltip *tooltip
, -const GdkRectangle *rect
);const GdkRectangle *rect
);Sets the area of the widget, where the contents of this tooltip apply, to be
rect
(in widget coordinates). This is especially useful for @@ -504,7 +504,7 @@diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkTreeViewColumn.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkTreeViewColumn.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkTreeViewColumn.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkTreeViewColumn.html 2017-09-11 15:58:06.000000000 +0000 @@ -2247,7 +2247,7 @@ - rect
+ gtk_tree_view_column_cell_get_size ()
void gtk_tree_view_column_cell_get_size (+GtkTreeViewColumn *tree_column
, -const GdkRectangle *cell_area
, +const GdkRectangle *cell_area
,gint *x_offset
,gint *y_offset
,gint *width
, diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkTreeView.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkTreeView.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkTreeView.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkTreeView.html 2017-09-11 15:58:06.000000000 +0000 @@ -510,7 +510,7 @@-GdkWindow * +GdkWindow * gtk_tree_view_get_bin_window () @@ -1023,7 +1023,7 @@ @@ -1055,7 +1055,7 @@ -GdkColor * +GdkColor *even-row-color Read @@ -3511,7 +3511,7 @@ gtk_tree_view_get_cell_area ( -GdkColor * +GdkColor *odd-row-color Read GtkTreeView *tree_view
,GtkTreePath *path
,GtkTreeViewColumn *column
, -GdkRectangle *rect
);GdkRectangle *rect
);Fills the bounding rectangle in bin_window coordinates for the cell at the row specified by
path
and the column specified bycolumn
@@ -3571,7 +3571,7 @@ gtk_tree_view_get_background_area (GtkTreeView *tree_view
,GtkTreePath *path
,GtkTreeViewColumn *column
, -GdkRectangle *rect
); +GdkRectangle *rect
);Fills the bounding rectangle in bin_window coordinates for the cell at the row specified by
path
and the column specified bycolumn
@@ -3629,7 +3629,7 @@gtk_tree_view_get_visible_rect ()
void gtk_tree_view_get_visible_rect (+GtkTreeView *tree_view
, -GdkRectangle *visible_rect
);GdkRectangle *visible_rect
);Fills
visible_rect
with the currently-visible region of the buffer, in tree coordinates. Convert to bin_window coordinates with @@ -3710,7 +3710,7 @@
gtk_tree_view_get_bin_window ()
-GdkWindow * +GdkWindow * gtk_tree_view_get_bin_window (GtkTreeView *tree_view
);Returns the window that
tree_view
renders to. @@ -3734,7 +3734,7 @@@@ -4052,7 +4052,7 @@ gtk_tree_view_enable_model_drag_dest (Returns
-A GdkWindow, or
NULL
whentree_view
+A GdkWindow, or
NULL
whentree_view
hasn’t been realized yet.[nullable][transfer none]
GtkTreeView *tree_view
,const GtkTargetEntry *targets
,gint n_targets
, -GdkDragAction actions
); +GdkDragAction actions
);Turns
@@ -4098,10 +4098,10 @@tree_view
into a drop destination for automatic DND. Calling this method sets “reorderable” toFALSE
.void gtk_tree_view_enable_model_drag_source (+GtkTreeView *tree_view
, -GdkModifierType start_button_mask
, +GdkModifierType start_button_mask
,const GtkTargetEntry *targets
,gint n_targets
, -GdkDragAction actions
);GdkDragAction actions
);Turns
@@ -5872,7 +5872,7 @@tree_view
into a drag source for automatic DND. Calling this method sets “reorderable” toFALSE
.
@@ -5922,7 +5922,7 @@The
-“even-row-color”
style property“even-row-color” GdkColor *+“even-row-color” GdkColor *
Color to use for even rows.
Flags: Read
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkViewport.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkViewport.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkViewport.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkViewport.html 2017-09-11 15:58:06.000000000 +0000 @@ -100,7 +100,7 @@The
-“odd-row-color”
style property“odd-row-color” GdkColor *+“odd-row-color” GdkColor *
Color to use for odd rows.
Flags: Read
-GdkWindow * +GdkWindow * gtk_viewport_get_bin_window () @@ -108,7 +108,7 @@ -GdkWindow * +GdkWindow * gtk_viewport_get_view_window () @@ -420,7 +420,7 @@
gtk_viewport_get_bin_window ()
-GdkWindow * +GdkWindow * gtk_viewport_get_bin_window (GtkViewport *viewport
);Gets the bin window of the GtkViewport.
@@ -440,7 +440,7 @@Since: 2.20
@@ -448,7 +448,7 @@
gtk_viewport_get_view_window ()
-GdkWindow * +GdkWindow * gtk_viewport_get_view_window (GtkViewport *viewport
);Gets the view window of the GtkViewport.
@@ -468,7 +468,7 @@Since: 2.22
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkWidget.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkWidget.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkWidget.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkWidget.html 2017-09-11 15:58:06.000000000 +0000 @@ -199,7 +199,7 @@-GdkFrameClock * +GdkFrameClock * gtk_widget_get_frame_clock () @@ -414,7 +414,7 @@ -GdkWindow * +GdkWindow * gtk_widget_get_parent_window () @@ -454,7 +454,7 @@ -GdkEventMask +GdkEventMask gtk_widget_get_device_events () @@ -502,7 +502,7 @@ -GdkVisual * +GdkVisual * gtk_widget_get_visual () @@ -1077,7 +1077,7 @@ -GdkDisplay * +GdkDisplay * gtk_widget_get_display () @@ -1085,7 +1085,7 @@ -GdkWindow * +GdkWindow * gtk_widget_get_root_window () @@ -1093,7 +1093,7 @@ -GdkScreen * +GdkScreen * gtk_widget_get_screen () @@ -1277,7 +1277,7 @@ -GdkWindow * +GdkWindow * gtk_widget_get_window () @@ -1677,7 +1677,7 @@ -GdkModifierType +GdkModifierType gtk_widget_get_modifier_mask () @@ -2189,7 +2189,7 @@ Read / Write - @@ -2360,7 +2360,7 @@GdkEventMask +GdkEventMask events Read / Write @@ -2383,7 +2383,7 @@ -GdkWindow * +GdkWindow *window Read @@ -2410,7 +2410,7 @@ -GdkColor * +GdkColor *cursor-color Read @@ -2426,7 +2426,7 @@ -GdkColor * +GdkColor *link-color Read @@ -2452,7 +2452,7 @@ -GdkColor * +GdkColor *secondary-cursor-color Read @@ -4082,16 +4082,16 @@ -GdkColor * +GdkColor *visited-link-color Read
gtk_widget_get_frame_clock ()
-GdkFrameClock * +GdkFrameClock * gtk_widget_get_frame_clock (GtkWidget *widget
);Obtains the frame clock for a widget. The frame clock is a global “ticker” that can be used to drive animations and repaints. The most common reason to get the frame clock is to call -
+gdk_frame_clock_get_frame_time()
, in order to get a time to use for +gdk_frame_clock_get_frame_time()
, in order to get a time to use for animating. For example you might record the start of the animation -with an initial value fromgdk_frame_clock_get_frame_time()
, and +with an initial value fromgdk_frame_clock_get_frame_time()
, and then update the animation by calling -gdk_frame_clock_get_frame_time()
again during each repaint.gdk_frame_clock_get_frame_time()
again during each repaint.gdk_frame_clock_request_phase() will result in a new frame on the clock, but won’t necessarily repaint any widgets. To repaint a widget, you have to use
gtk_widget_queue_draw()
which invalidates @@ -4119,7 +4119,7 @@@@ -4133,7 +4133,7 @@Returns
-a GdkFrameClock, +
a GdkFrameClock, or NULL if widget is unrealized.
[nullable][transfer none]
Retrieves the internal scale factor that maps from window coordinates to the actual device pixels. On traditional systems this is 1, on high density outputs, it can be a higher value (typically 2).
-See
+gdk_window_get_scale_factor()
.See
gdk_window_get_scale_factor()
.Parameters
@@ -4161,7 +4161,7 @@
GtkTickCallback ()
gboolean (*GtkTickCallback) (GtkWidget *widget
, -GdkFrameClock *frame_clock
, +GdkFrameClock *frame_clock
,gpointer user_data
);Callback type for adding a function to update animations. See
gtk_widget_add_tick_callback()
.@@ -4219,11 +4219,11 @@gtk_widget_queue_draw_area()
yourself.gdk_frame_clock_get_frame_time() should generally be used for timing continuous animations and -
gdk_frame_timings_get_predicted_presentation_time()
if you are +gdk_frame_timings_get_predicted_presentation_time()
if you are trying to display isolated frames at particular times.This is a more convenient alternative to connecting directly to the -“update” signal of GdkFrameClock, since you don't -have to worry about when a GdkFrameClock is assigned to a widget.
+“update” signal of GdkFrameClock, since you don't +have to worry about when a GdkFrameClock is assigned to a widget.Parameters
@@ -4491,7 +4491,7 @@
const gchar *accel_signal
,GtkAccelGroup *accel_group
,guint accel_key
, -GdkModifierType accel_mods
, +GdkModifierType accel_mods
,GtkAccelFlags accel_flags
);Installs an accelerator for this
widget
inaccel_group
@@ -4555,7 +4555,7 @@ gtk_widget_remove_accelerator (GtkWidget *widget
,GtkAccelGroup *accel_group
,guint accel_key
, -GdkModifierType accel_mods
); +GdkModifierType accel_mods
);Removes an accelerator from
@@ -4739,14 +4739,14 @@widget
, previously installed withgtk_widget_add_accelerator()
.gtk_widget_event ()
gboolean gtk_widget_event (+GtkWidget *widget
, -GdkEvent *event
);GdkEvent *event
);Rarely-used function. This function is used to emit the event signals on a widget (those signals should never be emitted without using this function to do so). If you want to synthesize an event though, don’t use this function; instead, use
gtk_main_do_event()
so the event will behave as if it were in the event queue. Don’t synthesize expose events; instead, -usegdk_window_invalidate_rect()
to invalidate a region of the +usegdk_window_invalidate_rect()
to invalidate a region of the window.Parameters
@@ -4764,7 +4764,7 @@@@ -4846,8 +4846,8 @@ - event
+ a GdkEvent
a GdkEvent
gtk_widget_intersect ()
gboolean gtk_widget_intersect (+GtkWidget *widget
, -const GdkRectangle *area
, -GdkRectangle *intersection
);const GdkRectangle *area
, +GdkRectangle *intersection
);Computes the intersection of a
widget
’s area andarea
, storing @@ -5159,7 +5159,7 @@gtk_widget_set_parent_window ()
void gtk_widget_set_parent_window (+GtkWidget *widget
, -GdkWindow *parent_window
);GdkWindow *parent_window
);Sets a non default parent window for
widget
.For GtkWindow classes, setting a
parent_window
@@ -5194,7 +5194,7 @@
gtk_widget_get_parent_window ()
-GdkWindow * ++GdkWindow * gtk_widget_get_parent_window (GtkWidget *widget
);Gets
@@ -5227,7 +5227,7 @@widget
’s parent window, orNULL
if it does not have one.void gtk_widget_set_events (-GtkWidget *widget
,gint events
);Sets the event mask (see GdkEventMask) for a widget. The event +
Sets the event mask (see GdkEventMask) for a widget. The event mask determines which events a widget will receive. Keep in mind that different widgets have different default event masks, and by changing the event mask you may disrupt a widget’s functionality, @@ -5266,7 +5266,7 @@
gtk_widget_get_events ()
gint gtk_widget_get_events (-GtkWidget *widget
);Returns the event mask (see GdkEventMask) for the widget. These are the +
Returns the event mask (see GdkEventMask) for the widget. These are the events that the widget will receive.
Note: Internally, the widget event mask will be the logical OR of the event mask set through
gtk_widget_set_events()
orgtk_widget_add_events()
, and the @@ -5320,7 +5320,7 @@@@ -5332,9 +5332,9 @@ - events
+ an event mask, see GdkEventMask
an event mask, see GdkEventMask
gtk_widget_set_device_events ()
void gtk_widget_set_device_events (-GtkWidget *widget
, -GdkDevice *device
, -GdkEventMask events
);Sets the device event mask (see GdkEventMask) for a widget. The event +
GdkDevice *device
, +GdkEventMask events
);Sets the device event mask (see GdkEventMask) for a widget. The event mask determines which events a widget will receive from
device
. Keep in mind that different widgets have different default event masks, and by @@ -5362,7 +5362,7 @@- device
+ @@ -5378,9 +5378,9 @@
gtk_widget_get_device_events ()
-GdkEventMask +GdkEventMask gtk_widget_get_device_events (+GtkWidget *widget
, -GdkDevice *device
);GdkDevice *device
);Returns the events mask for the widget corresponding to an specific device. These are the events that the widget will receive when
@@ -5400,7 +5400,7 @@device
operates on it.@@ -5418,8 +5418,8 @@ - device
+ gtk_widget_add_device_events ()
void gtk_widget_add_device_events (+GtkWidget *widget
, -GdkDevice *device
, -GdkEventMask events
);GdkDevice *device
, +GdkEventMask events
);Adds the device events in the bitfield
events
to the event mask forwidget
@@ -5440,12 +5440,12 @@- device
+ @@ -5458,14 +5458,14 @@ - events
+ an event mask, see GdkEventMask
an event mask, see GdkEventMask
gtk_widget_set_device_enabled ()
void gtk_widget_set_device_enabled (-GtkWidget *widget
, -GdkDevice *device
, +GdkDevice *device
,gboolean enabled
);Enables or disables a GdkDevice to interact with
widget
+Enables or disables a GdkDevice to interact with
-widget
and all its children.It does so by descending through the GdkWindow hierarchy +
It does so by descending through the GdkWindow hierarchy and enabling the same mask that is has for core events -(i.e. the one that
+(i.e. the one thatgdk_window_get_events()
returns).gdk_window_get_events()
returns).Parameters
@@ -5482,7 +5482,7 @@
- device
+ @@ -5500,7 +5500,7 @@ gtk_widget_get_device_enabled ()
gboolean gtk_widget_get_device_enabled (+GtkWidget *widget
, -GdkDevice *device
);GdkDevice *device
);Returns whether
device
can interact withwidget
and its @@ -5521,7 +5521,7 @@@@ -5651,7 +5651,7 @@ - device
+
gtk_widget_get_visual ()
-GdkVisual * +GdkVisual * gtk_widget_get_visual (GtkWidget *widget
);Gets the visual that will be used to render
@@ -5682,9 +5682,9 @@widget
.gtk_widget_set_visual ()
void gtk_widget_set_visual (+GtkWidget *widget
, -GdkVisual *visual
);GdkVisual *visual
);Sets the visual that should be used for by widget and its children for -creating GdkWindows. The visual must be on the same GdkScreen as +creating GdkWindows. The visual must be on the same GdkScreen as returned by
gtk_widget_get_screen()
, so handling the “screen-changed” signal is necessary.Setting a new
visual
@@ -5724,7 +5724,7 @@gint *y
);-
gtk_widget_get_pointer
has been deprecated since version 3.4 and should not be used in newly-written code.Use
+gdk_window_get_device_position()
instead.Use
gdk_window_get_device_position()
instead.Obtains the location of the mouse pointer in widget coordinates. Widget coordinates are a bit odd; for historical reasons, they are @@ -6165,7 +6165,7 @@ gtk_widget_shape_combine_region (
GtkWidget *widget
,cairo_region_t *region
);Sets a shape for this widget’s GDK window. This allows for -transparent windows etc., see
gdk_window_shape_combine_region()
+transparent windows etc., seegdk_window_shape_combine_region()
for more information.Parameters
@@ -6199,7 +6199,7 @@cairo_region_t *region
);Sets an input shape for this widget’s GDK window. This allows for windows which react to mouse click in a nonrectangular region, see -
+gdk_window_input_shape_combine_region()
for more information.gdk_window_input_shape_combine_region()
for more information.Parameters
@@ -6378,7 +6378,7 @@
void gtk_widget_override_background_color (+GtkWidget *widget
,GtkStateFlags state
, -const GdkRGBA *color
);const GdkRGBA *color
);
gtk_widget_override_background_color
has been deprecated since version 3.16 and should not be used in newly-written code.This function is not useful in the context of CSS-based @@ -6427,7 +6427,7 @@
void gtk_widget_override_color (+GtkWidget *widget
,GtkStateFlags state
, -const GdkRGBA *color
);const GdkRGBA *color
);
gtk_widget_override_color
has been deprecated since version 3.16 and should not be used in newly-written code.Use a custom style provider and style classes instead
@@ -6528,7 +6528,7 @@void gtk_widget_override_symbolic_color (+GtkWidget *widget
,const gchar *name
, -const GdkRGBA *color
);const GdkRGBA *color
);
gtk_widget_override_symbolic_color
has been deprecated since version 3.16 and should not be used in newly-written code.This function is not useful in the context of CSS-based @@ -6576,8 +6576,8 @@
gtk_widget_override_cursor ()
void gtk_widget_override_cursor (+GtkWidget *widget
, -const GdkRGBA *cursor
, -const GdkRGBA *secondary_cursor
);const GdkRGBA *cursor
, +const GdkRGBA *secondary_cursor
);
gtk_widget_override_cursor
has been deprecated since version 3.16 and should not be used in newly-written code.This function is not useful in the context of CSS-based @@ -6589,7 +6589,7 @@ cursor-color and secondary-cursor-color style properties. All other style values are left untouched. See also
-gtk_widget_modify_style()
.Note that the underlying properties have the GdkColor type, +
Note that the underlying properties have the GdkColor type, so the alpha value in
@@ -6725,7 +6725,7 @@primary
andsecondary
will be ignored.void gtk_widget_modify_fg (+GtkWidget *widget
,GtkStateType state
, -const GdkColor *color
);const GdkColor *color
);
gtk_widget_modify_fg
has been deprecated since version 3.0 and should not be used in newly-written code.Use
@@ -6769,7 +6769,7 @@gtk_widget_override_color()
insteadvoid gtk_widget_modify_bg (+GtkWidget *widget
,GtkStateType state
, -const GdkColor *color
);const GdkColor *color
);
gtk_widget_modify_bg
has been deprecated since version 3.0 and should not be used in newly-written code.Use
@@ -6823,7 +6823,7 @@gtk_widget_override_background_color()
insteadvoid gtk_widget_modify_text (+GtkWidget *widget
,GtkStateType state
, -const GdkColor *color
);const GdkColor *color
);
gtk_widget_modify_text
has been deprecated since version 3.0 and should not be used in newly-written code.Use
@@ -6870,7 +6870,7 @@gtk_widget_override_color()
insteadvoid gtk_widget_modify_base (+GtkWidget *widget
,GtkStateType state
, -const GdkColor *color
);const GdkColor *color
);
gtk_widget_modify_base
has been deprecated since version 3.0 and should not be used in newly-written code.Use
@@ -6962,8 +6962,8 @@gtk_widget_override_background_color()
insteadgtk_widget_modify_cursor ()
void gtk_widget_modify_cursor (+GtkWidget *widget
, -const GdkColor *primary
, -const GdkColor *secondary
);const GdkColor *primary
, +const GdkColor *secondary
);
gtk_widget_modify_cursor
has been deprecated since version 3.0 and should not be used in newly-written code.Use
@@ -7075,7 +7075,7 @@ gtk_widget_set_font_options (gtk_widget_override_cursor()
instead.GtkWidget *widget
,const cairo_font_options_t *options
);Sets the cairo_font_options_t used for Pango rendering in this widget. -When not set, the default font options for the GdkScreen will be used.
+When not set, the default font options for the GdkScreen will be used.Parameters
@@ -7107,7 +7107,7 @@
const cairo_font_options_t * gtk_widget_get_font_options (GtkWidget *widget
);Returns the cairo_font_options_t used for Pango rendering. When not set, -the defaults font options for the GdkScreen will be used.
+the defaults font options for the GdkScreen will be used.Parameters
@@ -7461,7 +7461,7 @@
Invalidates the area of
widget
defined byregion
by calling -gdk_window_invalidate_region()
on the widget’s window and all its +gdk_window_invalidate_region()
on the widget’s window and all its child windows. Once the main loop becomes idle (after the current batch of events has been processed, roughly), the window will receive expose events for the union of all regions that have been @@ -7545,10 +7545,10 @@Widgets are double buffered by default; you can use this function to turn off the buffering. “Double buffered” simply means that -
@@ -7558,7 +7558,7 @@gdk_window_begin_draw_frame()
andgdk_window_end_draw_frame()
are called +gdk_window_begin_draw_frame()
andgdk_window_end_draw_frame()
are called automatically around expose events sent to the -widget.gdk_window_begin_draw_frame()
diverts all drawing to a widget's -window to an offscreen buffer, andgdk_window_end_draw_frame()
draws the +widget.gdk_window_begin_draw_frame()
diverts all drawing to a widget's +window to an offscreen buffer, andgdk_window_end_draw_frame()
draws the buffer to the screen. The result is that users see the window update in one smooth step, and don’t see individual graphics primitives being rendered.Note: if you turn off double-buffering, you have to handle expose events, since even the clearing to the background color or pixmap will not happen automatically (as it is done in -
+gdk_window_begin_draw_frame()
).gdk_window_begin_draw_frame()
).In 3.10 GTK and GDK have been restructured for translucent drawing. Since then expose events for double-buffered widgets are culled into a single event to the toplevel GDK window. If you now unset double buffering, you @@ -7906,7 +7906,7 @@
gtk_widget_send_expose ()
gint gtk_widget_send_expose (+GtkWidget *widget
, -GdkEvent *event
);GdkEvent *event
);
gtk_widget_send_expose
has been deprecated since version 3.22 and should not be used in newly-written code.Application and widget code should not handle @@ -7920,9 +7920,9 @@ event to a windowless child widget (
gtk_widget_get_has_window()
isFALSE
), and that is normally done usinggtk_container_propagate_draw()
.If you want to force an area of a window to be redrawn, -use
+with a call togdk_window_invalidate_rect()
orgdk_window_invalidate_region()
. +usegdk_window_invalidate_rect()
orgdk_window_invalidate_region()
. To cause the redraw to be done immediately, follow that call -with a call togdk_window_process_updates()
.gdk_window_process_updates()
.Parameters
@@ -7939,7 +7939,7 @@
@@ -8014,7 +8014,7 @@@@ -7956,7 +7956,7 @@ - event
+ a expose GdkEvent
a expose GdkEvent
gtk_widget_send_focus_change ()
gboolean gtk_widget_send_focus_change (+GtkWidget *widget
, -GdkEvent *event
);GdkEvent *event
);Sends the focus change
@@ -7981,7 +7981,7 @@ 9 10 11 -event
towidget
GdkEvent *fevent = gdk_event_new (GDK_FOCUS_CHANGE); ++gdk_event_free (event); GdkEvent *fevent = gdk_event_new (GDK_FOCUS_CHANGE); fevent->focus_change.type = GDK_FOCUS_CHANGE; fevent->focus_change.in = TRUE; @@ -7991,7 +7991,7 @@ gtk_widget_send_focus_change (widget, fevent); -gdk_event_free (event);@@ -8154,7 +8154,7 @@ - event
+ a GdkEvent of type GDK_FOCUS_CHANGE
a GdkEvent of type GDK_FOCUS_CHANGE
This step is unnecessary with GtkStyleContext.
This function attaches the widget’s GtkStyle to the widget's -GdkWindow. It is a replacement for
+GdkWindow. It is a replacement for@@ -8493,7 +8493,7 @@
Gets the settings object holding the settings used for this widget.
Note that this function can only be called when the GtkWidget is attached to a toplevel, since the settings object is specific -to a particular GdkScreen.
+to a particular GdkScreen.Parameters
@@ -8520,11 +8520,11 @@
gtk_widget_get_clipboard ()
GtkClipboard * gtk_widget_get_clipboard (+GtkWidget *widget
, -GdkAtom selection
);GdkAtom selection
);Returns the clipboard object for the given selection to be used with
widget
.widget
- must have a GdkDisplay + must have a GdkDisplay associated with it, so must be attached to a toplevel window.@@ -8543,10 +8543,10 @@@@ -8566,9 +8566,9 @@ - selection
a GdkAtom which identifies the clipboard -to use.
GDK_SELECTION_CLIPBOARD
gives the +a GdkAtom which identifies the clipboard +to use.
GDK_SELECTION_CLIPBOARD
gives the default clipboard. Another common value -isGDK_SELECTION_PRIMARY
, which gives +isGDK_SELECTION_PRIMARY
, which gives the primary X selection.
gtk_widget_get_display ()
-GdkDisplay * +GdkDisplay * gtk_widget_get_display (-GtkWidget *widget
);Get the GdkDisplay for the toplevel window associated with +
Get the GdkDisplay for the toplevel window associated with this widget. This function can only be called after the widget has been added to a widget hierarchy with a GtkWindow at the top.
In general, you should only create display specific @@ -8591,7 +8591,7 @@
Returns
-the GdkDisplay for the toplevel for this widget.
+the GdkDisplay for the toplevel for this widget.
[transfer none]
Since: 2.2
@@ -8599,17 +8599,17 @@
gtk_widget_get_root_window ()
-GdkWindow * +GdkWindow * gtk_widget_get_root_window (GtkWidget *widget
);-
gtk_widget_get_root_window
has been deprecated since version 3.12 and should not be used in newly-written code.Use
+gdk_screen_get_root_window()
insteadUse
gdk_screen_get_root_window()
insteadGet the root window where this widget is located. This function can only be called after the widget has been added to a widget hierarchy with GtkWindow at the top.
The root window is useful for such purposes as creating a popup -GdkWindow associated with the window. In general, you should only +GdkWindow associated with the window. In general, you should only create display specific resources when a widget has been realized, and you should free those resources when the widget is unrealized.
@@ -8629,7 +8629,7 @@Returns
-the GdkWindow root window for the toplevel for this widget.
+the GdkWindow root window for the toplevel for this widget.
[transfer none]
Since: 2.2
@@ -8637,9 +8637,9 @@
gtk_widget_get_screen ()
-GdkScreen * +GdkScreen * gtk_widget_get_screen (-GtkWidget *widget
);Get the GdkScreen from the toplevel window associated with +
Get the GdkScreen from the toplevel window associated with this widget. This function can only be called after the widget has been added to a widget hierarchy with a GtkWindow at the top.
@@ -8663,7 +8663,7 @@Returns
-the GdkScreen for the toplevel for this widget.
+the GdkScreen for the toplevel for this widget.
[transfer none]
Since: 2.2
@@ -8673,7 +8673,7 @@gtk_widget_has_screen ()
gboolean gtk_widget_has_screen (-GtkWidget *widget
);Checks whether there is a GdkScreen is associated with +
Checks whether there is a GdkScreen is associated with this widget. All toplevel widgets have an associated screen, and all widgets added into a hierarchy with a toplevel window at the top.
@@ -8694,7 +8694,7 @@Since: 2.2
@@ -9059,7 +9059,7 @@ gtk_widget_is_composited (GtkWidget *widget
);-
gtk_widget_is_composited
has been deprecated since version 3.22 and should not be used in newly-written code.Use
+gdk_screen_is_composited()
instead.Use
gdk_screen_is_composited()
instead.Whether
widget
can rely on having its alpha channel @@ -9068,7 +9068,7 @@ ’s screen.Please note that the semantics of this call will change in the future if used on a widget that has a composited -window in its hierarchy (as set by
+window in its hierarchy (as set bygdk_window_set_composited()
).gdk_window_set_composited()
).Parameters
@@ -9098,8 +9098,8 @@ gtk_widget_error_bell (
GtkWidget *widget
);Notifies the user about an input-related error on this widget. If the “gtk-error-bell” setting is
-TRUE
, it calls -gdk_window_beep()
, otherwise it does nothing.Note that the effect of
+gdk_window_beep()
can be configured in many +gdk_window_beep()
, otherwise it does nothing.Note that the effect of
gdk_window_beep()
can be configured in many ways, depending on the windowing backend and the desktop environment or window manager that is used.@@ -9472,7 +9472,7 @@
gtk_widget_get_window ()
-GdkWindow * +GdkWindow * gtk_widget_get_window (GtkWidget *widget
);Returns the widget’s window if it is realized,
NULL
otherwise@@ -9503,11 +9503,11 @@gtk_widget_register_window ()
void gtk_widget_register_window (-GtkWidget *widget
, -GdkWindow *window
);Registers a GdkWindow with the widget and sets it up so that +
GdkWindow *window
); +Registers a GdkWindow with the widget and sets it up so that the widget receives events for it. Call
-gtk_widget_unregister_window()
when destroying the window.Before 3.8 you needed to call
gdk_window_set_user_data()
directly to set +Before 3.8 you needed to call
@@ -9527,7 +9527,7 @@gdk_window_set_user_data()
directly to set this up. This is now deprecated and you should usegtk_widget_register_window()
instead. Old code will keep working as is, although some new features like transparency might not work perfectly.@@ -9540,8 +9540,8 @@ - window
+ gtk_widget_unregister_window ()
void gtk_widget_unregister_window (-GtkWidget *widget
, -GdkWindow *window
);Unregisters a GdkWindow from the widget that was previously set up with +
GdkWindow *window
); +Unregisters a GdkWindow from the widget that was previously set up with
gtk_widget_register_window()
. You need to call this when the window is no longer used by the widget, such as when you destroy it.@@ -9560,7 +9560,7 @@@@ -9573,7 +9573,7 @@ - window
+ gtk_cairo_should_draw_window ()
gboolean gtk_cairo_should_draw_window (+cairo_t *cr
, -GdkWindow *window
);GdkWindow *window
);This function is supposed to be called in “draw” implementations for widgets that support multiple windows.
cr
@@ -9622,7 +9622,7 @@void gtk_cairo_transform_to_window (+cairo_t *cr
,GtkWidget *widget
, -GdkWindow *window
);GdkWindow *window
);Transforms the given cairo context
cr
that fromwidget
-relative @@ -10218,7 +10218,7 @@gboolean gtk_widget_get_has_window (GtkWidget *widget
);Determines whether
widget
- has a GdkWindow of its own. See + has a GdkWindow of its own. Seegtk_widget_set_has_window()
.Parameters
@@ -10249,10 +10249,10 @@ gtk_widget_set_has_window (GtkWidget *widget
,gboolean has_window
);Specifies whether
widget
- has a GdkWindow of its own. Note that + has a GdkWindow of its own. Note that all realized widgets have a non-NULL
“window” pointer (gtk_widget_get_window()
never returns aNULL
window when a widget -is realized), but for many of them it’s actually the GdkWindow of +is realized), but for many of them it’s actually the GdkWindow of one of its parent widgets. Widgets that do not create awindow
for themselves in “realize” must announce this by calling this function withhas_window
@@ -10811,13 +10811,13 @@gtk_widget_set_window ()
void gtk_widget_set_window (+GtkWidget *widget
, -GdkWindow *window
);GdkWindow *window
);Sets a widget’s window. This function should only be used in a widget’s “realize” implementation. The
-window
passed is -usually either new window created withgdk_window_new()
, or the +usually either new window created withgdk_window_new()
, or the window of its parent widget as returned bygtk_widget_get_parent_window()
.Widgets must indicate whether they will create their own GdkWindow +
Widgets must indicate whether they will create their own GdkWindow by calling
gtk_widget_set_has_window()
. This is usually done in the widget’sinit()
function.Note that this function does not add any reference to
window
@@ -10838,7 +10838,7 @@@@ -10925,8 +10925,8 @@ - window
+ a GdkWindow.
a GdkWindow.
[transfer full] Enables or disables multiple pointer awareness. If this setting is
+that if custom GdkWindows are created in “realize”, +TRUE
,widget
will start receiving multiple, per device enter/leave events. Note -that if custom GdkWindows are created in “realize”, -gdk_window_set_support_multidevice()
will have to be called manually on them.gdk_window_set_support_multidevice()
will have to be called manually on them.Parameters
@@ -10987,7 +10987,7 @@ gtk_widget_set_realized (
GtkWidget *widget
,gboolean realized
);Marks the widget as being realized. This function must only be -called after all GdkWindows for the
widget
+called after all GdkWindows for thewidget
have been created and registered.This function should only ever be called in a derived widget's @@ -11152,7 +11152,7 @@
gtk_widget_device_is_shadowed ()
gboolean gtk_widget_device_is_shadowed (+GtkWidget *widget
, -GdkDevice *device
);GdkDevice *device
);Returns
TRUE
ifdevice
has been shadowed by a GTK+ device grab on another widget, so it would stop sending @@ -11176,7 +11176,7 @@@@ -11193,13 +11193,13 @@ - device
+
gtk_widget_get_modifier_mask ()
-GdkModifierType +GdkModifierType gtk_widget_get_modifier_mask (+GtkWidget *widget
, -GdkModifierIntent intent
);GdkModifierIntent intent
);Returns the modifier mask the
-widget
’s windowing system backend uses for a particular purpose.See
+gdk_keymap_get_modifier_mask()
.See
gdk_keymap_get_modifier_mask()
.Parameters
@@ -13741,7 +13741,7 @@
@@ -13931,7 +13931,7 @@ Signal emitted when widget is associated with a -GdkWindow, which means that
gtk_widget_realize()
has been called or +GdkWindow, which means thatgtk_widget_realize()
has been called or the widget has been mapped (that is, it is going to be drawn).+the widget’s GdkWindow. Signal emitted when the pointer moves over -the widget’s GdkWindow.
@@ -13942,7 +13942,7 @@ - + Signal is emitted when a GdkWindow is destroyed.
Signal is emitted when a GdkWindow is destroyed.
@@ -14085,7 +14085,7 @@ +with the action Signal emitted on the drag source when a drag -with the action
GDK_ACTION_MOVE
is successfully completed.GDK_ACTION_MOVE
is successfully completed.@@ -14151,7 +14151,7 @@ +widgets screen changes. See Signal emitted when the composited status of -widgets screen changes. See
gdk_screen_is_composited()
.gdk_screen_is_composited()
.@@ -14236,7 +14236,7 @@ @@ -14636,7 +14636,7 @@ Invalidates the area of widget defined by -region by calling
gdk_window_invalidate_region()
on the widget's +region by callinggdk_window_invalidate_region()
on the widget's window and all its child windows.
The
-“events”
property“events” GdkEventMask+“events” GdkEventMaskThe event mask that decides what kind of GdkEvents this widget gets.
Flags: Read / Write
Default value: GDK_STRUCTURE_MASK
@@ -14992,7 +14992,7 @@
The
-“window”
property“window” GdkWindow *+“window” GdkWindow *The widget's window if it is realized,
NULL
otherwise.Flags: Read
Since: 2.14
@@ -15011,7 +15011,7 @@
The
-“cursor-color”
style property“cursor-color” GdkColor *+“cursor-color” GdkColor *
The color with which to draw the insertion cursor in entries and text views.
@@ -15078,7 +15078,7 @@
The
-“link-color”
style property“link-color” GdkColor *+“link-color” GdkColor *
The "link-color" style property defines the color of unvisited links.
@@ -15113,7 +15113,7 @@
GtkWidget:link-color
has been deprecated since version 3.12 and should not be used in newly-written code.
The
-“secondary-cursor-color”
style property“secondary-cursor-color” GdkColor *+“secondary-cursor-color” GdkColor *
The color with which to draw the secondary insertion cursor in entries and text views when editing mixed right-to-left and left-to-right text.
@@ -15175,7 +15175,7 @@
The
-“visited-link-color”
style property“visited-link-color” GdkColor *+“visited-link-color” GdkColor *
The "visited-link-color" style property defines the color of visited links.
@@ -15244,12 +15244,12 @@
GtkWidget:visited-link-color
has been deprecated since version 3.12 and should not be used in newly-written code.The
“button-press-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::button-press-event signal will be emitted when a button (typically from a mouse) is pressed.
-To receive this signal, the GdkWindow associated to the -widget needs to enable the GDK_BUTTON_PRESS_MASK mask.
+To receive this signal, the GdkWindow associated to the +widget needs to enable the GDK_BUTTON_PRESS_MASK mask.
This signal will be sent to the grab widget if there is one.
Parameters
@@ -15267,7 +15267,7 @@@@ -15291,12 +15291,12 @@ - event
the GdkEventButton which triggered +
the GdkEventButton which triggered this signal.
[type Gdk.EventButton] The
“button-release-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::button-release-event signal will be emitted when a button (typically from a mouse) is released.
-To receive this signal, the GdkWindow associated to the -widget needs to enable the GDK_BUTTON_RELEASE_MASK mask.
+To receive this signal, the GdkWindow associated to the +widget needs to enable the GDK_BUTTON_RELEASE_MASK mask.
This signal will be sent to the grab widget if there is one.
Parameters
@@ -15314,7 +15314,7 @@@@ -15428,7 +15428,7 @@ - event
the GdkEventButton which triggered +
the GdkEventButton which triggered this signal.
[type Gdk.EventButton] The ::composited-changed signal is emitted when the composited status of
+Seewidgets
screen changes. -Seegdk_screen_is_composited()
.gdk_screen_is_composited()
.
GtkWidget::composited-changed
has been deprecated since version 3.22 and should not be used in newly-written code.Use GdkScreen::composited-changed instead.
@@ -15462,13 +15462,13 @@The
“configure-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::configure-event signal will be emitted when the size, position or stacking of the
-widget
's window has changed.To receive this signal, the GdkWindow associated to the widget needs -to enable the GDK_STRUCTURE_MASK mask. GDK will enable this mask +
To receive this signal, the GdkWindow associated to the widget needs +to enable the GDK_STRUCTURE_MASK mask. GDK will enable this mask automatically for all new windows.
Parameters
@@ -15486,7 +15486,7 @@@@ -15510,7 +15510,7 @@ - event
the GdkEventConfigure which triggered +
the GdkEventConfigure which triggered this signal.
[type Gdk.EventConfigure] The
“damage-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)Emitted when a redirected window belonging to
widget
gets drawn into. @@ -15532,7 +15532,7 @@- event
+ the GdkEventExpose event.
the GdkEventExpose event.
[type Gdk.EventExpose] @@ -15556,7 +15556,7 @@ The
“delete-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::delete-event signal is emitted if a user requests that a toplevel window is closed. The default handler for this signal @@ -15636,14 +15636,14 @@
The
“destroy-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)-The ::destroy-event signal is emitted when a GdkWindow is destroyed. +
The ::destroy-event signal is emitted when a GdkWindow is destroyed. You rarely get this signal, because most widgets disconnect themselves from their window before they destroy it, so no widget owns the window at destroy time.
-To receive this signal, the GdkWindow associated to the widget needs -to enable the GDK_STRUCTURE_MASK mask. GDK will enable this mask +
To receive this signal, the GdkWindow associated to the widget needs +to enable the GDK_STRUCTURE_MASK mask. GDK will enable this mask automatically for all new windows.
Parameters
@@ -15723,7 +15723,7 @@The
“drag-begin”
signalvoid user_function (GtkWidget *widget, - GdkDragContext *context, + GdkDragContext *context, gpointer user_data)The ::drag-begin signal is emitted on the drag source when a drag is started. A typical reason to connect to this signal is to set up a @@ -15765,10 +15765,10 @@
The
“drag-data-delete”
signalvoid user_function (GtkWidget *widget, - GdkDragContext *context, + GdkDragContext *context, gpointer user_data)The ::drag-data-delete signal is emitted on the drag source when a drag -with the action
GDK_ACTION_MOVE
is successfully completed. The signal +with the actionGDK_ACTION_MOVE
is successfully completed. The signal handler is responsible for deleting the data that has been dropped. What "delete" means depends on the context of the drag operation.@@ -15805,7 +15805,7 @@The
“drag-data-get”
signalvoid user_function (GtkWidget *widget, - GdkDragContext *context, + GdkDragContext *context, GtkSelectionData *data, guint info, guint time, @@ -15867,7 +15867,7 @@The
“drag-data-received”
signalvoid user_function (GtkWidget *widget, - GdkDragContext *context, + GdkDragContext *context, gint x, gint y, GtkSelectionData *data, @@ -15877,7 +15877,7 @@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 not finish the drag. +to callgdk_drag_status()
and not finish the drag. If the data was received in response to a “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 @@ -15886,10 +15886,10 @@ whether the data was processed successfully.Applications must create some means to determine why the signal was emitted -and therefore whether to call
+and therefore whether to callgdk_drag_status()
orgtk_drag_finish()
.gdk_drag_status()
orgtk_drag_finish()
.The handler may inspect the selected action with -
gdk_drag_context_get_selected_action()
before calling -gtk_drag_finish()
, e.g. to implementGDK_ACTION_ASK
as +gdk_drag_context_get_selected_action()
before calling +gtk_drag_finish()
, e.g. to implementGDK_ACTION_ASK
as shown in the following example:@@ -15951,7 +15951,7 @@ // handle data here - action = gdk_drag_context_get_selected_action (context); + action = gdk_drag_context_get_selected_action (context); if (action == GDK_ACTION_ASK) { GtkWidget *dialog; @@ -16043,7 +16043,7 @@
The
“drag-drop”
signalgboolean user_function (GtkWidget *widget, - GdkDragContext *context, + GdkDragContext *context, gint x, gint y, guint time, @@ -16111,7 +16111,7 @@The
“drag-end”
signalvoid user_function (GtkWidget *widget, - GdkDragContext *context, + GdkDragContext *context, gpointer user_data)The ::drag-end signal is emitted on the drag source when a drag is finished. A typical reason to connect to this signal is to undo @@ -16150,7 +16150,7 @@
The
“drag-failed”
signalgboolean user_function (GtkWidget *widget, - GdkDragContext *context, + GdkDragContext *context, GtkDragResult result, gpointer user_data)The ::drag-failed signal is emitted on the drag source when a drag has @@ -16202,7 +16202,7 @@
The
“drag-leave”
signalvoid user_function (GtkWidget *widget, - GdkDragContext *context, + GdkDragContext *context, guint time, gpointer user_data)The ::drag-leave signal is emitted on the drop site when the cursor @@ -16253,7 +16253,7 @@
The
“drag-motion”
signalgboolean user_function (GtkWidget *widget, - GdkDragContext *context, + GdkDragContext *context, gint x, gint y, guint time, @@ -16264,11 +16264,11 @@ If it is not in a drop zone, it returnsFALSE
and no further processing is necessary. Otherwise, the handler returnsTRUE
. In this case, the handler is responsible for providing the necessary information for -displaying feedback to the user, by callinggdk_drag_status()
. +displaying feedback to the user, by callinggdk_drag_status()
.If the decision whether the drop will be accepted or rejected can't be made based solely on the cursor position and the type of the data, the handler may inspect the dragged data by calling
@@ -16363,11 +16363,11 @@ target = gtk_drag_dest_find_target (widget, context, NULL); if (target == GDK_NONE) - gdk_drag_status (context, 0, time); + gdk_drag_status (context, 0, time); else { private_data->pending_status - = gdk_drag_context_get_suggested_action (context); + = gdk_drag_context_get_suggested_action (context); gtk_drag_get_data (widget, context, target, time); } @@ -16396,9 +16396,9 @@ str = gtk_selection_data_get_text (selection_data); if (!data_is_acceptable (str)) - gdk_drag_status (context, 0, time); + gdk_drag_status (context, 0, time); else - gdk_drag_status (context, + gdk_drag_status (context, private_data->suggested_action, time); } @@ -16483,7 +16483,7 @@ with a clip region already set to the widget's dirty region, i.e. to the area that needs repainting. Complicated widgets that want to avoid redrawing themselves completely can get the full -extents of the clip region withgtk_drag_get_data()
and -defer thegdk_drag_status()
call to the “drag-data-received” +defer thegdk_drag_status()
call to the “drag-data-received” handler. Note that you must pass GTK_DEST_DEFAULT_DROP, GTK_DEST_DEFAULT_MOTION or GTK_DEST_DEFAULT_ALL togtk_drag_dest_set()
when using the drag-motion signal that way.gdk_cairo_get_clip_rectangle()
, or they can +extents of the clip region withgdk_cairo_get_clip_rectangle()
, or they can get a finer-grained representation of the dirty region withcairo_copy_clip_rectangle_list()
.@@ -16526,13 +16526,13 @@The
“enter-notify-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::enter-notify-event will be emitted when the pointer enters the
-widget
's window.To receive this signal, the GdkWindow associated to the widget needs -to enable the GDK_ENTER_NOTIFY_MASK mask.
+To receive this signal, the GdkWindow associated to the widget needs +to enable the GDK_ENTER_NOTIFY_MASK mask.
This signal will be sent to the grab widget if there is one.
Parameters
@@ -16550,7 +16550,7 @@@@ -16574,7 +16574,7 @@ - event
the GdkEventCrossing which triggered +
the GdkEventCrossing which triggered this signal.
[type Gdk.EventCrossing] The
“event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The GTK+ main loop will emit three signals for each GDK event delivered to a widget: one generic ::event signal, another, more specific, @@ -16597,7 +16597,7 @@
- event
+ the GdkEvent which triggered this signal
the GdkEvent which triggered this signal
@@ -16623,7 +16623,7 @@ The
“event-after”
signalvoid user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)After the emission of the “event” signal and (optionally) the second more specific signal, ::event-after will be emitted @@ -16644,7 +16644,7 @@
- event
+ the GdkEvent which triggered this signal
the GdkEvent which triggered this signal
@@ -16696,13 +16696,13 @@ The
“focus-in-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::focus-in-event signal will be emitted when the keyboard focus enters the
-widget
's window.To receive this signal, the GdkWindow associated to the widget needs -to enable the GDK_FOCUS_CHANGE_MASK mask.
+To receive this signal, the GdkWindow associated to the widget needs +to enable the GDK_FOCUS_CHANGE_MASK mask.
Parameters
@@ -16719,7 +16719,7 @@
@@ -16743,13 +16743,13 @@ - event
the GdkEventFocus which triggered +
the GdkEventFocus which triggered this signal.
[type Gdk.EventFocus] The
“focus-out-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::focus-out-event signal will be emitted when the keyboard focus leaves the
-widget
's window.To receive this signal, the GdkWindow associated to the widget needs -to enable the GDK_FOCUS_CHANGE_MASK mask.
+To receive this signal, the GdkWindow associated to the widget needs +to enable the GDK_FOCUS_CHANGE_MASK mask.
Parameters
@@ -16766,7 +16766,7 @@
@@ -16790,7 +16790,7 @@ - event
the GdkEventFocus which triggered this +
the GdkEventFocus which triggered this signal.
[type Gdk.EventFocus] The
“grab-broken-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)Emitted when a pointer or keyboard grab on a window belonging to
widget
@@ -16814,7 +16814,7 @@- event
+ the GdkEventGrabBroken event.
the GdkEventGrabBroken event.
[type Gdk.EventGrabBroken] @@ -16987,12 +16987,12 @@ The
“key-press-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::key-press-event signal is emitted when a key is pressed. The signal emission will reoccur at the key-repeat rate when the key is kept pressed.
-To receive this signal, the GdkWindow associated to the widget needs -to enable the GDK_KEY_PRESS_MASK mask.
+To receive this signal, the GdkWindow associated to the widget needs +to enable the GDK_KEY_PRESS_MASK mask.
This signal will be sent to the grab widget if there is one.
- event
+ the GdkEventKey which triggered this signal.
the GdkEventKey which triggered this signal.
[type Gdk.EventKey] @@ -17033,11 +17033,11 @@ The
“key-release-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::key-release-event signal is emitted when a key is released.
-To receive this signal, the GdkWindow associated to the widget needs -to enable the GDK_KEY_RELEASE_MASK mask.
+To receive this signal, the GdkWindow associated to the widget needs +to enable the GDK_KEY_RELEASE_MASK mask.
This signal will be sent to the grab widget if there is one.
- event
+ the GdkEventKey which triggered this signal.
the GdkEventKey which triggered this signal.
[type Gdk.EventKey] @@ -17123,13 +17123,13 @@ The
“leave-notify-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::leave-notify-event will be emitted when the pointer leaves the
-widget
's window.To receive this signal, the GdkWindow associated to the widget needs -to enable the GDK_LEAVE_NOTIFY_MASK mask.
+To receive this signal, the GdkWindow associated to the widget needs +to enable the GDK_LEAVE_NOTIFY_MASK mask.
This signal will be sent to the grab widget if there is one.
@@ -17210,13 +17210,13 @@ - event
the GdkEventCrossing which triggered +
the GdkEventCrossing which triggered this signal.
[type Gdk.EventCrossing] The
“map-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::map-event signal will be emitted when the
-widget
's window is mapped. A window is mapped when it becomes visible on the screen.To receive this signal, the GdkWindow associated to the widget needs -to enable the GDK_STRUCTURE_MASK mask. GDK will enable this mask +
To receive this signal, the GdkWindow associated to the widget needs +to enable the GDK_STRUCTURE_MASK mask. GDK will enable this mask automatically for all new windows.
Parameters
@@ -17234,7 +17234,7 @@- event
+ the GdkEventAny which triggered this signal.
the GdkEventAny which triggered this signal.
[type Gdk.EventAny] @@ -17304,12 +17304,12 @@ The
“motion-notify-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::motion-notify-event signal is emitted when the pointer moves -over the widget's GdkWindow.
-To receive this signal, the GdkWindow associated to the widget -needs to enable the GDK_POINTER_MOTION_MASK mask.
+over the widget's GdkWindow. +To receive this signal, the GdkWindow associated to the widget +needs to enable the GDK_POINTER_MOTION_MASK mask.
This signal will be sent to the grab widget if there is one.
@@ -17462,13 +17462,13 @@ - event
the GdkEventMotion which triggered +
the GdkEventMotion which triggered this signal.
[type Gdk.EventMotion] The
“property-notify-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::property-notify-event signal will be emitted when a property on the
-widget
's window has been changed or deleted.To receive this signal, the GdkWindow associated to the widget needs -to enable the GDK_PROPERTY_CHANGE_MASK mask.
+To receive this signal, the GdkWindow associated to the widget needs +to enable the GDK_PROPERTY_CHANGE_MASK mask.
Parameters
@@ -17485,7 +17485,7 @@
@@ -17509,10 +17509,10 @@ - event
the GdkEventProperty which triggered +
the GdkEventProperty which triggered this signal.
[type Gdk.EventProperty] The
“proximity-in-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)-To receive this signal the GdkWindow associated to the widget needs -to enable the GDK_PROXIMITY_IN_MASK mask.
+To receive this signal the GdkWindow associated to the widget needs +to enable the GDK_PROXIMITY_IN_MASK mask.
This signal will be sent to the grab widget if there is one.
Parameters
@@ -17530,7 +17530,7 @@@@ -17554,10 +17554,10 @@ - event
the GdkEventProximity which triggered +
the GdkEventProximity which triggered this signal.
[type Gdk.EventProximity] The
“proximity-out-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)-To receive this signal the GdkWindow associated to the widget needs -to enable the GDK_PROXIMITY_OUT_MASK mask.
+To receive this signal the GdkWindow associated to the widget needs +to enable the GDK_PROXIMITY_OUT_MASK mask.
This signal will be sent to the grab widget if there is one.
Parameters
@@ -17575,7 +17575,7 @@@@ -17683,7 +17683,7 @@ gpointer user_data) - event
the GdkEventProximity which triggered +
the GdkEventProximity which triggered this signal.
[type Gdk.EventProximity] The ::realize signal is emitted when
widget
is associated with a -GdkWindow, which means thatgtk_widget_realize()
has been called or the +GdkWindow, which means thatgtk_widget_realize()
has been called or the widget has been mapped (that is, it is going to be drawn).Parameters
@@ -17714,7 +17714,7 @@The
“screen-changed”
signalvoid user_function (GtkWidget *widget, - GdkScreen *previous_screen, + GdkScreen *previous_screen, gpointer user_data)The ::screen-changed signal gets emitted when the screen of a widget has changed.
@@ -17753,13 +17753,13 @@The
“scroll-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::scroll-event signal is emitted when a button in the 4 to 7 range is pressed. Wheel mice are usually configured to generate button press events for buttons 4 and 5 when the wheel is turned.
-To receive this signal, the GdkWindow associated to the widget needs -to enable the GDK_SCROLL_MASK mask.
+To receive this signal, the GdkWindow associated to the widget needs +to enable the GDK_SCROLL_MASK mask.
This signal will be sent to the grab widget if there is one.
Parameters
@@ -17777,7 +17777,7 @@@@ -17801,7 +17801,7 @@ - event
the GdkEventScroll which triggered +
the GdkEventScroll which triggered this signal.
[type Gdk.EventScroll] The
“selection-clear-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::selection-clear-event signal will be emitted when the the
widget
@@ -17822,7 +17822,7 @@@@ -17879,7 +17879,7 @@ - event
the GdkEventSelection which triggered +
the GdkEventSelection which triggered this signal.
[type Gdk.EventSelection] The
“selection-notify-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)Parameters
@@ -17951,7 +17951,7 @@The
“selection-request-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::selection-request-event signal will be emitted when another client requests ownership of the selection owned by @@ -17973,7 +17973,7 @@
@@ -18066,7 +18066,7 @@ - event
the GdkEventSelection which triggered +
the GdkEventSelection which triggered this signal.
[type Gdk.EventSelection] The
“size-allocate”
signalvoid user_function (GtkWidget *widget, - GdkRectangle *allocation, + GdkRectangle *allocation, gpointer user_data)@@ -18313,13 +18313,13 @@Parameters
@@ -18268,7 +18268,7 @@The
“touch-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *arg1, + GdkEvent *arg1, gpointer user_data)Flags: Run Last
The
“unmap-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::unmap-event signal will be emitted when the
-widget
's window is unmapped. A window is unmapped when it becomes invisible on the screen.To receive this signal, the GdkWindow associated to the widget needs -to enable the GDK_STRUCTURE_MASK mask. GDK will enable this mask +
To receive this signal, the GdkWindow associated to the widget needs +to enable the GDK_STRUCTURE_MASK mask. GDK will enable this mask automatically for all new windows.
Parameters
@@ -18337,7 +18337,7 @@- event
+ the GdkEventAny which triggered this signal.
the GdkEventAny which triggered this signal.
[type Gdk.EventAny] @@ -18361,7 +18361,7 @@ void user_function (GtkWidget *widget, gpointer user_data)-The ::unrealize signal is emitted when the GdkWindow associated with +
The ::unrealize signal is emitted when the GdkWindow associated with
widget
is destroyed, which means thatgtk_widget_unrealize()
has been called or the widget has been unmapped (that is, it is going to be @@ -18395,13 +18395,13 @@The
“visibility-notify-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::visibility-notify-event will be emitted when the
-widget
's window is obscured or unobscured.To receive this signal the GdkWindow associated to the widget needs -to enable the GDK_VISIBILITY_NOTIFY_MASK mask.
+To receive this signal the GdkWindow associated to the widget needs +to enable the GDK_VISIBILITY_NOTIFY_MASK mask.
GtkWidget::visibility-notify-event
has been deprecated since version 3.12 and should not be used in newly-written code.Modern composited windowing systems with pervasive @@ -18425,7 +18425,7 @@
@@ -18449,13 +18449,13 @@ - event
the GdkEventVisibility which +
the GdkEventVisibility which triggered this signal.
[type Gdk.EventVisibility] The
“window-state-event”
signalgboolean user_function (GtkWidget *widget, - GdkEvent *event, + GdkEvent *event, gpointer user_data)The ::window-state-event will be emitted when the state of the toplevel window associated to the
-widget
changes.To receive this signal the GdkWindow associated to the widget -needs to enable the GDK_STRUCTURE_MASK mask. GDK will enable +
To receive this signal the GdkWindow associated to the widget +needs to enable the GDK_STRUCTURE_MASK mask. GDK will enable this mask automatically for all new windows.
Parameters
@@ -18473,7 +18473,7 @@diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkWindowGroup.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkWindowGroup.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkWindowGroup.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkWindowGroup.html 2017-09-11 15:58:06.000000000 +0000 @@ -269,7 +269,7 @@ - event
the GdkEventWindowState which +
the GdkEventWindowState which triggered this signal.
[type Gdk.EventWindowState] GtkWidget * gtk_window_group_get_current_device_grab (+GtkWindowGroup *window_group
, -GdkDevice *device
);GdkDevice *device
);Returns the current grab widget for
device
, orNULL
if none.@@ -288,7 +288,7 @@diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/GtkWindow.html gtk+3.0-3.22.21/docs/reference/gtk/html/GtkWindow.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/GtkWindow.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/GtkWindow.html 2017-09-11 15:58:06.000000000 +0000 @@ -158,7 +158,7 @@ - device
+ -GdkGravity +GdkGravity gtk_window_get_gravity () @@ -214,7 +214,7 @@ -GdkScreen * +GdkScreen * gtk_window_get_screen () @@ -620,7 +620,7 @@ -GdkModifierType +GdkModifierType gtk_window_get_mnemonic_modifier () @@ -682,7 +682,7 @@ -GdkWindowTypeHint +GdkWindowTypeHint gtk_window_get_type_hint () @@ -1057,7 +1057,7 @@ Read / Write - @@ -1126,7 +1126,7 @@GdkGravity +GdkGravity gravity Read / Write @@ -1164,7 +1164,7 @@ -GdkScreen * +GdkScreen *screen Read / Write Read / Write / Construct Only - @@ -1831,12 +1831,12 @@GdkWindowTypeHint +GdkWindowTypeHint type-hint Read / Write void gtk_window_set_geometry_hints (+GtkWindow *window
,GtkWidget *geometry_widget
, -GdkGeometry *geometry
, -GdkWindowHints geom_mask
);GdkGeometry *geometry
, +GdkWindowHints geom_mask
);This function sets up hints about how a window can be resized by the user. You can set a minimum and maximum size; allowed resize increments (e.g. for xterm, you can only resize by the size of a -character); aspect ratios; and more. See the GdkGeometry struct.
+character); aspect ratios; and more. See the GdkGeometry struct.Parameters
@@ -1877,11 +1877,11 @@
gtk_window_set_gravity ()
void gtk_window_set_gravity (+GtkWindow *window
, -GdkGravity gravity
);GdkGravity gravity
);Window gravity defines the meaning of coordinates passed to -
-gtk_window_move()
. Seegtk_window_move()
and GdkGravity for +gtk_window_move()
. Seegtk_window_move()
and GdkGravity for more details.The default window gravity is GDK_GRAVITY_NORTH_WEST which will +
The default window gravity is GDK_GRAVITY_NORTH_WEST which will typically “do what you mean.”
Parameters
@@ -1909,7 +1909,7 @@
gtk_window_get_gravity ()
-GdkGravity +GdkGravity gtk_window_get_gravity (GtkWindow *window
);Gets the value set by
gtk_window_set_gravity()
.@@ -1983,7 +1983,7 @@On Wayland, this function can also be used to attach a new GTK_WINDOW_POPUP to a GTK_WINDOW_TOPLEVEL parent already mapped on screen so that the GTK_WINDOW_POPUP will be created as a -subsurface-based window GDK_WINDOW_SUBSURFACE which can be +subsurface-based window GDK_WINDOW_SUBSURFACE which can be positioned at will relatively to the GTK_WINDOW_TOPLEVEL surface.
On Windows, this function puts the child window on top of the parent, much as the window manager would have done on X.
@@ -2141,8 +2141,8 @@gtk_window_set_screen ()
void gtk_window_set_screen (-GtkWindow *window
, -GdkScreen *screen
);Sets the GdkScreen where the
window
+GdkScreen *screen
); +Sets the GdkScreen where the
@@ -2162,7 +2162,7 @@window
is displayed; if the window is already mapped, it will be unmapped, and then remapped on the new screen.@@ -2173,9 +2173,9 @@ - screen
+ a GdkScreen.
a GdkScreen.
gtk_window_get_screen ()
-GdkScreen * +GdkScreen * gtk_window_get_screen (-GtkWindow *window
);Returns the GdkScreen associated with
window
+Returns the GdkScreen associated with
window
.Since: 2.2
@@ -2389,7 +2389,7 @@gboolean gtk_window_mnemonic_activate (+GtkWindow *window
,guint keyval
, -GdkModifierType modifier
);GdkModifierType modifier
);Activates the targets associated with the mnemonic.
Parameters
@@ -2428,7 +2428,7 @@gtk_window_activate_key ()
gboolean gtk_window_activate_key (+GtkWindow *window
, -GdkEventKey *event
);GdkEventKey *event
);Activates mnemonics and accelerators for this GtkWindow. This is normally called by the default ::key_press_event handler for toplevel windows, however in some cases it may be useful to call this directly when @@ -2449,7 +2449,7 @@
@@ -2466,7 +2466,7 @@ - event
+ gtk_window_propagate_key_event ()
gboolean gtk_window_propagate_key_event (+GtkWindow *window
, -GdkEventKey *event
);GdkEventKey *event
);Propagate a key press or release event to the focus widget and up the focus container chain until a widget handles
event
. @@ -2490,7 +2490,7 @@@@ -2961,7 +2961,7 @@ - event
+ gtk_window_fullscreen_on_monitor ()
void gtk_window_fullscreen_on_monitor (GtkWindow *window
, -GdkScreen *screen
, +GdkScreen *screen
,gint monitor
);Asks to place
window
in the fullscreen state. Note that you shouldn't assume @@ -2984,7 +2984,7 @@- screen
+ a GdkScreen to draw to
a GdkScreen to draw to
@@ -3132,7 +3132,7 @@ gtk_window_begin_resize_drag ()
void gtk_window_begin_resize_drag (GtkWindow *window
, -GdkWindowEdge edge
, +GdkWindowEdge edge
,gint button
,gint root_x
,gint root_y
, @@ -3322,7 +3322,7 @@gtk_window_set_mnemonic_modifier ()
void gtk_window_set_mnemonic_modifier (+GtkWindow *window
, -GdkModifierType modifier
);GdkModifierType modifier
);Sets the mnemonic modifier for this window.
Parameters
@@ -3353,7 +3353,7 @@gtk_window_set_type_hint ()
void gtk_window_set_type_hint (+GtkWindow *window
, -GdkWindowTypeHint hint
);GdkWindowTypeHint hint
);By setting the type hint for the window, you allow the window manager to decorate and handle the window in a way which is suitable to the function of the window in your application.
@@ -3898,7 +3898,7 @@
gtk_window_get_mnemonic_modifier ()
-GdkModifierType +GdkModifierType gtk_window_get_mnemonic_modifier (GtkWindow *window
);Returns the mnemonic modifier for this window. See
@@ -3972,11 +3972,11 @@ moving even if you use the coordinates of the current position as returned by this function.gtk_window_set_mnemonic_modifier()
.If you haven’t changed the window gravity, its gravity will be -GDK_GRAVITY_NORTH_WEST. This means that
-gtk_window_get_position()
+GDK_GRAVITY_NORTH_WEST. This means thatgtk_window_get_position()
gets the position of the top-left corner of the window manager frame for the window.gtk_window_move()
sets the position of this same top-left corner.If a window has gravity GDK_GRAVITY_STATIC the window manager +
If a window has gravity GDK_GRAVITY_STATIC the window manager frame is not relevant, and thus
gtk_window_get_position()
will always produce accurate results. However you can’t use static gravity to do things like place a window in a corner of the screen, @@ -4268,7 +4268,7 @@
gtk_window_get_type_hint ()
-GdkWindowTypeHint +GdkWindowTypeHint gtk_window_get_type_hint (GtkWindow *window
);Gets the type hint for this window. See
gtk_window_set_type_hint()
.@@ -4535,7 +4535,7 @@ first, the location of the reference point in root window coordinates; and second, which point on the window is positioned at the reference point. -By default the gravity is GDK_GRAVITY_NORTH_WEST, so the reference +
By default the gravity is GDK_GRAVITY_NORTH_WEST, so the reference point is simply the
+(which is GDK_GRAVITY_NORTH_WEST) and move the window to 0,0.x
,y
supplied togtk_window_move()
. The @@ -4544,17 +4544,17 @@ ,y
. Therefore, to position a window at the top left of the screen, you want to use the default gravity -(which is GDK_GRAVITY_NORTH_WEST) and move the window to 0,0.To position a window at the bottom right corner of the screen, you -would set GDK_GRAVITY_SOUTH_EAST, which means that the reference +would set GDK_GRAVITY_SOUTH_EAST, which means that the reference point is at
x
+ the window width andy
+ the window height, and the bottom-right corner of the window border will be placed at that reference point. So, to place a window in the bottom right corner you would first set gravity to south east, then write: -gtk_window_move (window,
(note that this +gdk_screen_width()
- window_width, -gdk_screen_height()
- window_height)gtk_window_move (window,
(note that this example does not take multi-head scenarios into account).gdk_screen_width()
- window_width, +gdk_screen_height()
- window_height)The Extended Window Manager Hints Specification has a nice table of gravities in the “implementation notes” section.
@@ -4606,7 +4606,7 @@ and callsgtk_window_set_default_size()
and/orgtk_window_move()
to resize/move the window.If
@@ -5180,7 +5180,7 @@ gtk_window_set_auto_startup_notification (gtk_window_parse_geometry()
returnsTRUE
, it will also -set the GDK_HINT_USER_POS and/or GDK_HINT_USER_SIZE hints +set the GDK_HINT_USER_POS and/or GDK_HINT_USER_SIZE hints indicating to the window manager that the size/position of the window was user-specified. This causes most window managers to honor the geometry.gboolean setting
);By default, after showing the first GtkWindow, GTK+ calls -
@@ -5504,13 +5504,13 @@gdk_notify_startup_complete()
. Call this function to disable +gdk_notify_startup_complete()
. Call this function to disable the automatic startup notification. You might do this if your first window is a splash screen, and you want to delay notification until after your real main window has been shown, for example.gtk_window_get_resize_grip_area ()
gboolean gtk_window_get_resize_grip_area (+GtkWindow *window
, -GdkRectangle *rect
);GdkRectangle *rect
);
gtk_window_get_resize_grip_area
has been deprecated since version 3.14 and should not be used in newly-written code.Resize grips have been removed.
If a window has a resize grip, this will retrieve the grip -position, width and height into the specified GdkRectangle.
+position, width and height into the specified GdkRectangle.Parameters
@@ -5527,7 +5527,7 @@
@@ -5997,8 +5997,8 @@ - rect
a pointer to a GdkRectangle which we should store +
a pointer to a GdkRectangle which we should store the resize grip area.
[out]
The
-“gravity”
property“gravity” GdkGravity-The window gravity of the window. See
gtk_window_move()
and GdkGravity for +“gravity” GdkGravity+The window gravity of the window. See
gtk_window_move()
and GdkGravity for more details about window gravity.Flags: Read / Write
Default value: GDK_GRAVITY_NORTH_WEST
@@ -6122,7 +6122,7 @@
@@ -6181,7 +6181,7 @@The
-“screen”
property“screen” GdkScreen *+“screen” GdkScreen *The screen where this window will be displayed.
Flags: Read / Write
The
-“type-hint”
property“type-hint” GdkWindowTypeHint+“type-hint” GdkWindowTypeHintHint to help the desktop environment understand what kind of window this is and how to treat it.
Flags: Read / Write
Default value: GDK_WINDOW_TYPE_HINT_NORMAL
diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/html/index.html gtk+3.0-3.22.21/docs/reference/gtk/html/index.html --- gtk+3.0-3.22.19/docs/reference/gtk/html/index.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/html/index.html 2017-09-11 15:58:06.000000000 +0000 @@ -15,7 +15,7 @@
GTK+ 3 Reference Manual
- This document is for the GTK+ 3 library, version 3.22.19 + This document is for the GTK+ 3 library, version 3.22.21 . The latest versions can be found online at https://developer.gnome.org/gtk3/. diff -Nru gtk+3.0-3.22.19/docs/reference/gtk/version.xml gtk+3.0-3.22.21/docs/reference/gtk/version.xml --- gtk+3.0-3.22.19/docs/reference/gtk/version.xml 2017-08-22 12:34:04.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/gtk/version.xml 2017-09-11 15:21:07.000000000 +0000 @@ -1 +1 @@ -3.22.19 +3.22.21 diff -Nru gtk+3.0-3.22.19/docs/reference/libgail-util/html/index.html gtk+3.0-3.22.21/docs/reference/libgail-util/html/index.html --- gtk+3.0-3.22.19/docs/reference/libgail-util/html/index.html 2017-08-22 12:57:26.000000000 +0000 +++ gtk+3.0-3.22.21/docs/reference/libgail-util/html/index.html 2017-09-11 15:58:06.000000000 +0000 @@ -15,7 +15,7 @@