[gtk+] Some additions to the migration guide
- From: Matthias Clasen <matthiasc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk+] Some additions to the migration guide
- Date: Sun, 20 Nov 2016 13:14:52 +0000 (UTC)
commit 8a88745186fb88c1db5b545f6feb8f88f7e7615e
Author: Matthias Clasen <mclasen redhat com>
Date: Sun Nov 20 07:46:47 2016 -0500
Some additions to the migration guide
docs/reference/gtk/migrating-3to4.xml | 44 +++++++++++++++++++++++++++++++++
1 files changed, 44 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/gtk/migrating-3to4.xml b/docs/reference/gtk/migrating-3to4.xml
index e8ce2aa..7b7c36f 100644
--- a/docs/reference/gtk/migrating-3to4.xml
+++ b/docs/reference/gtk/migrating-3to4.xml
@@ -53,6 +53,14 @@
</section>
<section>
+ <title>Do not use widget style properties</title>
+ <para>
+ Style properties do not exist in GTK+ 4. You should stop using them in
+ your custom CSS.
+ </para>
+ </section>
+
+ <section>
<title>Review your window creation flags</title>
<para>
GTK+ 4 removes the GDK_WA_CURSOR flag. Instead, just use
@@ -98,6 +106,14 @@
</para>
</section>
+ <section>
+ <title>Stop using gdk_pixbuf_get_from_window() and gdk_cairo_set_source_window()</title>
+ <para>
+ These functions are not supported in GTK+ 4. Instead, either use backend-specific
+ APIs, or render your widgets using gtk_widget_render().
+ </para>
+ </section>
+
</section>
<section>
@@ -111,6 +127,17 @@
</para>
<section>
+ <title>Adapt to GdkWindow API changes</title>
+ <para>
+ The gdk_window_new() function has been replaced by a number of more
+ specialized constructors: gdk_window_new_toplevel(), gdk_window_new_popup(),
+ gdk_window_new_temp(), gdk_window_new_child(), gdk_window_new_input(),
+ gdk_wayland_window_new_subsurface(). Use the appropriate ones to create
+ your windows.
+ </para>
+ </section>
+
+ <section>
<title>Adapt to GtkStyleContext API changes</title>
<para>
The getters in the GtkStyleContext API, such as
@@ -122,6 +149,15 @@
</section>
<section>
+ <title>Adapt to GtkCssProvider API changes</title>
+ <para>
+ In GTK+ 4, the various #GtkCssProvider load functions have lost
+ their #GError argument. If you want to handle CSS loading errors,
+ use the #GtkCssProvider::parsing-error signal instead.
+ </para>
+ </section>
+
+ <section>
<title>Stop using GtkContainer::border-width</title>
<para>
GTK+ 4 has removed the #GtkContainer::border-width property.
@@ -150,6 +186,14 @@
</section>
<section>
+ <title>Use gtk_widget_measure</title>
+ <para>
+ gtk_widget_measure replaces the various gtk_widget_get_preferred_ functions
+ for querying sizes.
+ </para>
+ </section>
+
+ <section>
<title>Adapt to drawing model changes</title>
<para>
This area has seen the most radical changes in the transition from GTK+ 3
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]