Gtk.CellRendererProgress¶

class — extends CellRenderer, Orientable

:::warning Deprecated since 4.10 This API is deprecated. :::

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¶

new¶

@classmethod
def new(cls) -> CellRenderer

:::warning Deprecated since 4.10 This API is deprecated. :::

Creates a new GtkCellRendererProgress.

Properties¶

inverted¶

inverted: bool  # read/write

Whether progess is inverted.

pulse¶

pulse: int  # read/write

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.

text¶

text: str  # read/write

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

text_xalign¶

text_xalign: float  # read/write

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.

text_yalign¶

text_yalign: float  # read/write

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

value¶

value: int  # read/write

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