gtkwindow: Document further resize with csd

Applying the client-side decorations in the configure routine greatly
increases the chances of having the right size for the GtkHEaderBar and
border shadows.

Yet, it may be possible that these sizes change at a later point in
time, if for example the GtkHeaderBar grows in height while adding new
controls.

Mention this possible pitfall in the documentation for
gtk_window_resize().

https://bugzilla.gnome.org/show_bug.cgi?id=756618
This commit is contained in:
Olivier Fourdan 2015-12-02 11:15:39 +01:00
parent 058dfb0723
commit de41389352

View File

@ -5306,6 +5306,14 @@ gtk_window_get_default_size (GtkWindow *window,
* client side decorations depend on the theme and may not be realized
* or visible at the time gtk_window_resize() is issued.
*
* Typically, gtk_window_resize() will compensate for the GtkHeaderBar
* height only if it's known at the time the resulting GtkWindow
* configuration is issued.
* For example, if new widgets are added after the GtkWindow configuration
* and cause the GtkHeaderBar to grow in height, this will result in a
* window content smaller that specified by gtk_window_resize() and not
* a larger window.
*
**/
void
gtk_window_resize (GtkWindow *window,