gtkWindowSetDefaultSize: gtkWindowSetDefaultSize

In RGtk2: R Bindings for Gtk 2.8.0 and Above

Description

Sets the default size of a window. If the window's "natural" size (its size request) is larger than the default, the default will be ignored. More generally, if the default size does not obey the geometry hints for the window (gtkWindowSetGeometryHints can be used to set these explicitly), the default size will be clamped to the nearest permitted size.

Usage

gtkWindowSetDefaultSize(object, width, height)

Arguments

object	a GtkWindow
width	width in pixels, or -1 to unset the default width
height	height in pixels, or -1 to unset the default height

Details

Unlike gtkWidgetSetSizeRequest, which sets a size request for a widget and thus would keep users from shrinking the window, this function only sets the initial size, just as if the user had resized the window themselves. Users can still shrink the window again as they normally would. Setting a default size of -1 means to use the "natural" default size (the size request of the window).

For more control over a window's initial size and how resizing works, investigate gtkWindowSetGeometryHints.

For some uses, gtkWindowResize is a more appropriate function. gtkWindowResize changes the current size of the window, rather than the size to be used on initial display. gtkWindowResize always affects the window itself, not the geometry widget.

The default size of a window only affects the first time a window is shown; if a window is hidden and re-shown, it will remember the size it had prior to hiding, rather than using the default size.

Windows can't actually be 0x0 in size, they must be at least 1x1, but passing 0 for width and height is OK, resulting in a 1x1 default size.

Author(s)

Derived by RGtkGen from GTK+ documentation

RGtk2 documentation built on Oct. 14, 2021, 5:08 p.m.