Statusbar

Deprecated since version 4.10: This widget will be removed in GTK 5

class Statusbar(**properties: Any)

Superclasses: Widget, InitiallyUnowned, Object

Implemented Interfaces: Accessible, Buildable, ConstraintTarget

Constructors:

Statusbar(**properties)
new() -> Gtk.Widget

Constructors

class Statusbar

classmethod new() → Widget

Creates a new GtkStatusbar ready for messages.

Deprecated since version 4.10: This widget will be removed in GTK 5

Methods

class Statusbar

get_context_id(context_description: str) → int

Returns a new context identifier, given a description of the actual context.

Note that the description is not shown in the UI.

Deprecated since version 4.10: This widget will be removed in GTK 5

Parameters:

context_description – textual description of what context the new message is being used in

pop(context_id: int) → None

Removes the first message in the GtkStatusbar’s stack with the given context id.

Note that this may not change the displayed message, if the message at the top of the stack has a different context id.

Deprecated since version 4.10: This widget will be removed in GTK 5

Parameters:

context_id – a context identifier

push(context_id: int, text: str) → int

Pushes a new message onto a statusbar’s stack.

Deprecated since version 4.10: This widget will be removed in GTK 5

Parameters:

• context_id – the message’s context id, as returned by get_context_id()

• text – the message to add to the statusbar

remove(context_id: int, message_id: int) → None

Forces the removal of a message from a statusbar’s stack. The exact context_id and message_id must be specified.

Deprecated since version 4.10: This widget will be removed in GTK 5

Parameters:

• context_id – a context identifier

• message_id – a message identifier, as returned by push

remove_all(context_id: int) → None

Forces the removal of all messages from a statusbar’s stack with the exact context_id.

Deprecated since version 4.10: This widget will be removed in GTK 5

Parameters:

context_id – a context identifier

Signals

class Statusbar.signals

text_popped(context_id: int, text: str) → None

Emitted whenever a new message is popped off a statusbar’s stack.

Deprecated since version 4.10: This widget will be removed in GTK 5

Parameters:

• context_id – the context id of the relevant message/statusbar

• text – the message that was just popped

text_pushed(context_id: int, text: str) → None

Emitted whenever a new message gets pushed onto a statusbar’s stack.

Deprecated since version 4.10: This widget will be removed in GTK 5

Parameters:

• context_id – the context id of the relevant message/statusbar

• text – the message that was pushed