Method

GtkWidgetget_root_window

deprecated: 3.12 since: 2.2

Declaration [src]

GdkWindow*
gtk_widget_get_root_window (
  GtkWidget* widget
)

Description [src]

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

The root window is useful for such purposes as creating a popup GdkWindow 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.

Available since: 2.2

Deprecated since: 3.12

Use gdk_screen_get_root_window() instead.

Return value

Type: GdkWindow

The GdkWindow root window for the toplevel for this widget.

The returned data is owned by the instance.