Banner

Added in version 1.3.

class Banner(**properties: Any)

Superclasses: Widget, InitiallyUnowned, Object

Implemented Interfaces: Accessible, Actionable, Buildable, ConstraintTarget

Constructors:

Banner(**properties)
new(title:str) -> Gtk.Widget

Constructors

class Banner

classmethod new(title: str) → Widget

Creates a new AdwBanner.

Added in version 1.3.

Parameters:

title – the banner title

Methods

class Banner

get_button_label() → str | None

Gets the button label for self.

Added in version 1.3.

get_revealed() → bool

Gets if a banner is revealed

Added in version 1.3.

get_title() → str

Gets the title for self.

Added in version 1.3.

get_use_markup() → bool

Gets whether to use Pango markup for the banner title.

Added in version 1.3.

set_button_label(label: str | None = None) → None

Sets the button label for self.

If set to "" or NULL, the button won’t be shown.

The button can be used with a GAction, or with the button_clicked signal.

Added in version 1.3.

Parameters:

label – the label

set_revealed(revealed: bool) → None

Sets whether a banner should be revealed

Added in version 1.3.

Parameters:

revealed – whether a banner should be revealed

set_title(title: str) → None

Sets the title for this banner.

See also: use_markup.

Added in version 1.3.

Parameters:

title – the title

set_use_markup(use_markup: bool) → None

Sets whether to use Pango markup for the banner title.

See also parse_markup.

Added in version 1.3.

Parameters:

use_markup – whether to use markup

Properties

class Banner

props.button_label: str

The label to show on the button.

If set to "" or NULL, the button won’t be shown.

The button can be used with a GAction, or with the button_clicked signal.

Added in version 1.3.

props.revealed: bool

Whether the banner is currently revealed.

Added in version 1.3.

props.title: str

The title for this banner.

See also: use_markup.

Added in version 1.3.

props.use_markup: bool

Whether to use Pango markup for the banner title.

See also parse_markup.

Added in version 1.3.

Signals

class Banner.signals

button_clicked() → None

This signal is emitted after the action button has been clicked.

It can be used as an alternative to setting an action.

Added in version 1.3.