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.

https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1-latest/status-page.png

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.

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.

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 child widget.

props.description: str

The description markup to be displayed below the title.

props.icon_name: str

The name of the icon to be used.

Changing this will set paintable to NULL.

props.paintable: Paintable

The paintable to be used.

Changing this will set icon_name to NULL.

props.title: str

The title to be displayed below the icon.

It is not parsed as Pango markup.