Package: gtk

Function gtk-widget-root-window

Lambda List

gtk-widget-root-window (widget)

Arguments

widget -- a gtk-widget object

Return Value

The gdk-window root window for the toplevel for this widget.

Details

Get the root window where the widget is located. This function can only be called after the widget has been added to a widget hierarchy with a gtk-window widget at the top.

The root window is useful for such purposes as creating a popup gdk-window object associated with the window. In general, you should only create display specific resources when a widget has been realized, and you should free those resources when the widget is unrealized.

Warning

The gtk-widget-root-window function has been deprecated since version 3.12 and should not be used in newly written code. Use the gdk-screen-root-window function instead.
 

See also

2021-9-20