:right-sidebar: True

CellRendererProgress
===================================================================

.. currentmodule:: gi.repository.Gtk





.. deprecated:: 4.10

   List views use widgets to display their contents.
   You should use :obj:`~gi.repository.Gtk.ProgressBar` instead



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


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



Implemented Interfaces: :class:`~gi.repository.Gtk.Orientable`



Renders numbers as progress bars

``GtkCellRendererProgress`` renders a numeric value as a progress par in a cell.
Additionally, it can display a text on top of the progress bar.



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

.. rst-class:: interim-class

.. class:: CellRendererProgress
   :no-index:


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

      Creates a new ``GtkCellRendererProgress``.






      .. deprecated:: 4.10

         Please do not use it in newly written code













Properties
----------

.. rst-class:: interim-class

.. class:: CellRendererProgress
   :no-index:
   

   .. attribute:: props.inverted
      :type: bool

      






   .. attribute:: props.pulse
      :type: int

      Setting this to a non-negative value causes the cell renderer to
      enter "activity mode", where a block bounces back and forth to
      indicate that some progress is made, without specifying exactly how
      much.

      Each increment of the property causes the block to move by a little
      bit.

      To indicate that the activity has not started yet, set the property
      to zero. To indicate completion, set the property to ``%G_MAXINT``.







   .. attribute:: props.text
      :type: str

      The "text" property determines the label which will be drawn
      over the progress bar. Setting this property to :const:`None` causes the default
      label to be displayed. Setting this property to an empty string causes
      no label to be displayed.







   .. attribute:: props.text_xalign
      :type: float

      The "text-xalign" property controls the horizontal alignment of the
      text in the progress bar.  Valid values range from 0 (left) to 1
      (right).  Reserved for RTL layouts.







   .. attribute:: props.text_yalign
      :type: float

      The "text-yalign" property controls the vertical alignment of the
      text in the progress bar.  Valid values range from 0 (top) to 1
      (bottom).







   .. attribute:: props.value
      :type: int

      The "value" property determines the percentage to which the
      progress bar will be "filled in".