sugar3.graphics.window module¶
STABLE.
- class sugar3.graphics.window.UnfullscreenButton¶
Bases:
gi.overrides.Gtk.Window
A ready-made “Unfullscreen” button.
Used by
Window
to exit fullscreen mode.- connect_button_clicked(cb)¶
- do_get_preferred_width()¶
get_preferred_width(self) -> minimum_width:int, natural_width:int
- class sugar3.graphics.window.Window(**args)¶
Bases:
gi.overrides.Gtk.Window
An activity window.
Used as a container to display things that happen in an activity. A window must contain a canvas widget, and a toolbar box widget. A window may also contain alert message widgets and a tray widget.
- Widgets are kept in a vertical box in this order;
toolbar box,
alerts,
canvas,
tray.
A window may be in fullscreen or non-fullscreen mode. In fullscreen mode, the toolbar and tray are hidden.
Motion events are tracked, and an unfullscreen button is shown when the mouse is moved into the top right corner of the canvas.
- Key press events are tracked;
escape will cancel fullscreen mode,
Alt+space will toggle tray visibility.
- add_alert(alert)¶
Add an alert to the window.
You must call
Gtk.Widget
.show()
on the alert to make it visible.- Parameters
alert (
Alert
) – the alert to add
- property canvas¶
Property: the
Gtk.Widget
to be shown as the canvas, below the toolbar and alerts, and above the tray.
- do_get_property(pspec)¶
- do_set_property(pspec, value)¶
- enable_fullscreen_mode¶
(bool) whether the window is allowed to enter fullscreen mode, default True.
- Type
Property
- fullscreen()¶
Make the window fullscreen. The toolbar and tray will be hidden, and the
UnfullscreenButton
will be shown for a short time.
- get_canvas()¶
Get canvas widget.
- Returns
the canvas
- Return type
- get_enable_fullscreen_mode()¶
Get enable fullscreen mode.
- Returns
enable fullscreen mode
- Return type
bool
- get_toolbar_box()¶
Get
ToolbarBox
widget.- Returns
- the
current toolbar box of the window
- Return type
- is_fullscreen()¶
Check if the window is fullscreen.
- Returns
window is fullscreen
- Return type
bool
- remove_alert(alert)¶
Remove an alert message from the window.
- Parameters
alert (
Alert
) – the alert to remove
- reveal()¶
Make window active.
Brings the window to the top and makes it active, even after invoking on response to non-GTK events (in contrast to present()). See bug #1423
- set_canvas(canvas)¶
Set canvas widget.
- Parameters
canvas (
Gtk.Widget
) – the canvas to set
- set_enable_fullscreen_mode(enable_fullscreen_mode)¶
Set enable fullscreen mode.
- Parameters
enable_fullscreen_mode (bool) – enable fullscreen mode
- set_toolbar_box(toolbar_box)¶
Set
ToolbarBox
widget.- Parameters
toolbar_box (
ToolbarBox
) – the toolbar box to set as current
- set_tray(tray, position)¶
Set the tray.
- Parameters
position (
Gtk.PositionType
) – the edge to set the tray at
- property toolbar_box¶
Property: the
ToolbarBox
to be shown above the alerts and canvas.
- unfullscreen()¶
Restore the window to non-fullscreen mode. The
UnfullscreenButton
will be hidden, and the toolbar and tray will be shown.