:right-sidebar: True

Statusbar
===================================================================

.. currentmodule:: gi.repository.Gtk





.. deprecated:: 4.10

   This widget will be removed in GTK 5



.. class:: Statusbar(**properties: ~typing.Any)
   :no-contents-entry:


Superclasses: :class:`~gi.repository.Gtk.Widget`, :class:`~gi.repository.GObject.InitiallyUnowned`, :class:`~gi.repository.GObject.Object`



Implemented Interfaces: :class:`~gi.repository.Gtk.Accessible`, :class:`~gi.repository.Gtk.Buildable`, :class:`~gi.repository.Gtk.ConstraintTarget`



:Constructors:

::

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



Constructors
------------

.. rst-class:: interim-class

.. class:: Statusbar
   :no-index:


   .. classmethod:: new() -> ~gi.repository.Gtk.Widget

      Creates a new ``GtkStatusbar`` ready for messages.






      .. deprecated:: 4.10

         This widget will be removed in GTK 5











Methods
-------

.. rst-class:: interim-class

.. class:: Statusbar
   :no-index:


   .. method:: 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:: 4.10

         This widget will be removed in GTK 5




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





   .. method:: 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:: 4.10

         This widget will be removed in GTK 5




      :param context_id: a context identifier





   .. method:: push(context_id: int, text: str) -> int

      Pushes a new message onto a statusbar’s stack.






      .. deprecated:: 4.10

         This widget will be removed in GTK 5




      :param context_id: the message’s context id, as returned by
         :func:`~gi.repository.Gtk.Statusbar.get_context_id`


      :param text: the message to add to the statusbar





   .. method:: 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:: 4.10

         This widget will be removed in GTK 5




      :param context_id: a context identifier


      :param message_id: a message identifier, as returned by :obj:`~gi.repository.Gtk.Statusbar.push`





   .. method:: remove_all(context_id: int) -> None

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






      .. deprecated:: 4.10

         This widget will be removed in GTK 5




      :param context_id: a context identifier











Signals
-------

.. rst-class:: interim-class

.. class:: Statusbar.signals
   :no-index:
   

   .. method:: text_popped(context_id: int, text: str) -> None

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






      .. deprecated:: 4.10

         This widget will be removed in GTK 5




      :param context_id: the context id of the relevant message/statusbar


      :param text: the message that was just popped





   .. method:: text_pushed(context_id: int, text: str) -> None

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






      .. deprecated:: 4.10

         This widget will be removed in GTK 5




      :param context_id: the context id of the relevant message/statusbar


      :param text: the message that was pushed