StatusPage

class StatusPage(**properties: Any)

Superclasses: Widget, InitiallyUnowned, Object

Implemented Interfaces: Accessible, Buildable, ConstraintTarget

A page used for empty/error states and similar use-cases.

The AdwStatusPage widget can have an icon, a title, a description and a custom widget which is displayed below them.

CSS nodes

AdwStatusPage has a main CSS node with name statuspage.

When setting an SpinnerPaintable as paintable, the main nodes gains the .spinner style class for a more compact appearance.

Style classes

AdwStatusPage can use the `.compact <style-classes.html#compact-status-page>`__ style class for when it needs to fit into a small space such a sidebar or a popover, similar to when using a spinner as the paintable.

Constructors

class StatusPage

classmethod new() → Widget

Creates a new AdwStatusPage.

Methods

class StatusPage

get_child() → Widget | None

Gets the child widget of self.

get_description() → str | None

Gets the description markup for self.

get_icon_name() → str | None

Gets the icon name for self.

get_paintable() → Paintable | None

Gets the paintable for self.

get_title() → str

Gets the title for self.

set_child(child: Widget | None = None) → None

Sets the child widget of self.

Parameters:

child – the child widget

set_description(description: str | None = None) → None

Sets the description markup for self.

The description is displayed below the title. It is parsed as Pango markup.

Parameters:

description – the description

set_icon_name(icon_name: str | None = None) → None

Sets the icon name for self.

Changing this will set paintable to NULL.

Parameters:

icon_name – the icon name

set_paintable(paintable: Paintable | None = None) → None

Sets the paintable for self.

Changing this will set icon_name to NULL.

Parameters:

paintable – the paintable

set_title(title: str) → None

Sets the title for self.

The title is displayed below the icon. It is not parsed as Pango markup.

Parameters:

title – the title

Properties

class StatusPage

props.child: Widget

The type of the None singleton.

props.description: str

The type of the None singleton.

props.icon_name: str

The type of the None singleton.

props.paintable: Paintable

The type of the None singleton.

props.title: str

The type of the None singleton.