mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-11-17 14:30:15 +00:00
f37a0627fc
2001-08-07 Havoc Pennington <hp@pobox.com>
* gtk/gtkfilesel.c (open_ref_dir): fix a typo.
* gtk/gtkplug.c (gtk_plug_init): remove setting of auto_shrink;
some fixage is needed here, but nothing simple. Owen understands
it. ;-)
* gtk/gtkwindow.h, gtk/gtkwindow.c: Rework code and API for window
sizing and positioning. Also, fix bug in compute_geometry_hints
(width/height confusion for setting min size).
(gtk_window_move): new function
(gtk_window_resize): new function
(gtk_window_get_size): new function
(gtk_window_get_position): new function
(gtk_window_parse_geometry): new function
* gtk/gtkwidget.c (gtk_widget_set_size_request): new function
(gtk_widget_get_size_request): new function
(gtk_widget_get_usize): delete, that was a short-lived function
;-)
(gtk_widget_set_usize): deprecate
(gtk_widget_set_uposition): deprecate, make it a trivial
gtk_window_move() wrapper
(gtk_widget_class_init): remove x/y/width/height properties,
add width_request height_request
* demos/*: update to avoid deprecated functions
* gtk/gtklayout.c: add x/y child properties
* gtk/gtkfixed.c: add x/y child properties, and get rid of
uses of "gint16"
* tests/testgtk.c (create_window_sizing): lots of tweaks to window
sizing test
* gdk/x11/gdkevents-x11.c (gdk_event_translate): Ensure that
configure events on toplevel windows are always in root window
coordinates, following ICCCM spec that all synthetic events
are in root window coords already, while real events are
in parent window coords. Previously the code assumed that
coords of 0,0 were parent window coords, which was
really broken.
* gtk/gtkcontainer.c (gtk_container_get_focus_chain): fix
warning
* gdk/gdkwindow.h (GdkWindowHints): add GDK_HINT_USER_POS
and GDK_HINT_USER_SIZE so we can set USSize and USPosition
hints in gtk_window_parse_geometry()
* gdk/x11/gdkwindow-x11.c (gdk_window_set_geometry_hints): support
new USER_POS USER_SIZE hints
122 lines
4.6 KiB
Plaintext
122 lines
4.6 KiB
Plaintext
This is a list of things to check when testing window size/pos functions.
|
|
===
|
|
|
|
gtk_widget_set_size_request():
|
|
- causes the widget to request the given size
|
|
- for toplevel windows, changes the default-requested size if
|
|
no default size is set and gtk_window_resize() has not been called
|
|
- passing -1 for either width or height reverts to "natural" request
|
|
in that dimension
|
|
- passing 0 is allowed, and results in requisition of 1x1
|
|
(0x0 is a permitted requisition, but equivalent to 1x1,
|
|
we use 1x1 for implementation convenience)
|
|
- causes notifies on width_request, height_request properties
|
|
|
|
gtk_window_resize():
|
|
- causes a configure request in all cases if the window is mapped,
|
|
unless the new size is the same as the old size
|
|
- overrides the default size on map if the window is unmapped
|
|
- allows size of 0, equivalent to 1
|
|
- clamped to geometry hints
|
|
|
|
gtk_window_set_default_size():
|
|
- has no effect after the window has been mapped the first time,
|
|
unless the window has been unrealized in which case it should
|
|
have an effect
|
|
- allows size of 0, equivalent to 1
|
|
- allows size of -1 to unset the default size
|
|
- clamped to geometry hints
|
|
- gtk_window_resize() overrides it
|
|
- causes notifies on default_width, default_height properties
|
|
|
|
gtk_window_get_default_size():
|
|
- returns the values last passed to set_default_size(), including
|
|
-1. If set_default_size() has not been called, returns -1.
|
|
|
|
gtk_window_move():
|
|
- always causes a configure request if the window is mapped,
|
|
unless the last configure request we sent was for the same
|
|
position being moved to
|
|
- position may be negative to move windows offscreen
|
|
- if GTK_WIN_POS_CENTER_ALWAYS (or other future position
|
|
constraints we may add) is in effect, the move
|
|
request is clamped to obey the constraints. thus
|
|
calling gtk_window_move() on a CENTER_ALWAYS window
|
|
may trigger the window to bounce back to center if it
|
|
wasn't there
|
|
- overrides all GTK_WIN_POS_ except CENTER_ALWAYS
|
|
|
|
gtk_window_get_size():
|
|
- obtains the client-side known size of widget->window,
|
|
as last received from a configure event
|
|
- prior to mapping, returns the default size we will request
|
|
- between realization and mapping, computes default size
|
|
rather than looking at widget->window up-to-date size,
|
|
so the size will be correct after force-realizing a window
|
|
|
|
gtk_window_get_position():
|
|
- obtains the point to be passed to gtk_window_move() in order
|
|
to keep the window in its current position
|
|
- round-trips to the server to get the position; this is suboptimal
|
|
from both a race condition and speed standpoint but required to get
|
|
window frame size
|
|
- if the window is unmapped, returns the default position we will
|
|
request
|
|
|
|
gtk_window_set_position():
|
|
- not the inverse of get_position(), sadly
|
|
- modifies the default positioning of the window
|
|
- if set to CENTER_ALWAYS and the window is mapped, results in a
|
|
configure request moving the window to the center, unless the
|
|
window was already centered
|
|
- ignored if gtk_window_move() called, with the exception
|
|
of CENTER_ALWAYS
|
|
|
|
gtk_window_parse_geometry():
|
|
- parses a standard X geometry string
|
|
- toggles on one or both of GDK_HINT_USER_SIZE, GDK_HINT_USER_POS
|
|
- "xprop" shows user size/position are set on the window
|
|
- calls gtk_window_set_default_size() to set the window size
|
|
- calls gtk_window_move() to set the window position
|
|
- calls gtk_window_set_gravity() to set the window gravity
|
|
|
|
gtk_window_reshow_with_initial_size():
|
|
- for use by GUI builders; unrealizes and re-shows the window,
|
|
using default size (and also position, but position
|
|
is reset on any hide anyway)
|
|
- window should be positioned and sized as it was on initial map,
|
|
barring odd window managers
|
|
|
|
gtk_window_set_geometry_hints():
|
|
- if a hint is set with this function, we do not override it
|
|
in other parts of the code
|
|
|
|
General behavior
|
|
===
|
|
|
|
- no infinite loops or nasty fighting-the-user flicker during
|
|
operations such as moving/resizing a window
|
|
|
|
Properties
|
|
===
|
|
|
|
GtkWindow::default_width, GtkWindow::default_height:
|
|
- default_width is -1 if unset, or >= 0 if
|
|
a default width is set
|
|
- default_height is -1 if unset, or >= 0 if
|
|
a default height is set
|
|
|
|
GtkWindow::allow_grow, GtkWindow::resizable:
|
|
- equivalent properties; changing one notifies on the other
|
|
- if FALSE, we set the min size to the max size in the geometry
|
|
hints.
|
|
- If the app programmer has called gtk_window_set_geometry_hints()
|
|
however and set min or max size, we don't replace the hint they
|
|
set.
|
|
|
|
GtkWidget::width_request, GtkWidget::height_request:
|
|
- if -1, default requisition of widget is used
|
|
- otherwise, override default requisition
|
|
|
|
|