Gtk.Root

Implementations:

Gtk.DragIcon, Gtk.Window

Methods

	get_display ()
	get_focus ()
	set_focus (focus)

Virtual Methods

None

Properties

None

Signals

None

Fields

None

Class Details

class Gtk.Root

Bases:

GObject.GInterface

Structure:

Gtk.RootInterface

GtkRoot is the interface implemented by all widgets that can act as a toplevel widget.

The root widget takes care of providing the connection to the windowing system and manages layout, drawing and event delivery for its widget hierarchy.

The obvious example of a GtkRoot is GtkWindow.

To get the display to which a GtkRoot belongs, use [method`Gtk`.Root.get_display].

GtkRoot also maintains the location of keyboard focus inside its widget hierarchy, with [method`Gtk`.Root.set_focus] and [method`Gtk`.Root.get_focus].

get_display()

Returns:

the display of root

Return type:

Gdk.Display

Returns the display that this GtkRoot is on.

get_focus()

Returns:

the currently focused widget

Return type:

Gtk.Widget or None

Retrieves the current focused widget within the root.

Note that this is the widget that would have the focus if the root is active; if the root is not focused then gtk_widget_has_focus (widget) will be False for the widget.

set_focus(focus)

Parameters:

focus (Gtk.Widget or None) – widget to be the new focus widget, or None to unset the focus widget

If focus is not the current focus widget, and is focusable, sets it as the focus widget for the root.

If focus is None, unsets the focus widget for the root.

To set the focus to a particular widget in the root, it is usually more convenient to use [method`Gtk`.Widget.grab_focus] instead of this function.