Root#
- class Root(*args, **kwargs)#
Implementations: AboutDialog
, AppChooserDialog
, ApplicationWindow
, Assistant
, ColorChooserDialog
, Dialog
, DragIcon
, FileChooserDialog
, FontChooserDialog
, MessageDialog
, PageSetupUnixDialog
, PrintUnixDialog
, ShortcutsWindow
, Window
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
get_display
.
GtkRoot
also maintains the location of keyboard focus inside its widget
hierarchy, with set_focus
and get_focus
.
Methods#
- class Root
-
- get_focus() Widget | 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 beFalse
for the widget.
- set_focus(focus: Widget | None = None) None #
If
focus
is not the current focus widget, and is focusable, sets it as the focus widget for the root.If
focus
isNone
, 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
grab_focus
instead of this function.- Parameters:
focus – widget to be the new focus widget, or
None
to unset the focus widget