From: Emmanuele Bassi Date: Fri, 8 Oct 2021 11:27:24 +0000 (+0100) Subject: docs: Mention gtk_window_set_position() being gone X-Git-Tag: archive/raspbian/4.6.5+ds-1+rpi1~1^2~19^2~5^2~245^2 X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=0054f8bd746a4791120737f72e01183f57561cf9;p=gtk4.git docs: Mention gtk_window_set_position() being gone People search for it in the migration guide much more than other GdkSurface and GtkWindow methods. --- diff --git a/docs/reference/gtk/migrating-3to4.md b/docs/reference/gtk/migrating-3to4.md index 492e8628e4..2a0164fd7e 100644 --- a/docs/reference/gtk/migrating-3to4.md +++ b/docs/reference/gtk/migrating-3to4.md @@ -668,18 +668,21 @@ box children as necessary. ### Adapt to `GtkWindow` API changes Following the `GdkSurface` changes, a number of `GtkWindow` APIs that were -X11-specific have been removed. This includes `gtk_window_set_geometry_hints()`, -`gtk_window_set_gravity()`, `gtk_window_move()`, `gtk_window_parse_geometry()`, +X11-specific have been removed. This includes `gtk_window_set_position()`, +`gtk_window_set_geometry_hints()`, `gtk_window_set_gravity()`, +`gtk_window_move()`, `gtk_window_parse_geometry()`, `gtk_window_set_keep_above()`, `gtk_window_set_keep_below()`, `gtk_window_begin_resize_drag()`, `gtk_window_begin_move_drag()`. Most likely, you should just stop using them. In some cases, you can fall back to using the underlying `GdkToplevel` APIs (for example, -[method@Gdk.Toplevel.begin_resize]). +[`method@Gdk.Toplevel.begin_resize`]); alternatively, you will need to get +the native windowing system surface from the `GtkWindow` and call platform +specific API. The APIs for controlling `GtkWindow` size have changed to be better aligned with the way size changes are integrated in the frame cycle. `gtk_window_resize()` and `gtk_window_get_size()` have been removed. Instead, use -[method@Gtk.Window.set_default_size] and [method@Gtk.Window.get_default_size]. +[`method@Gtk.Window.set_default_size`] and [`method@Gtk.Window.get_default_size`]. ### Adapt to `GtkHeaderBar` and `GtkActionBar` API changes