## GtkCellRendererProgress

GtkCellRendererProgress — Renders numbers as progress bars

## Functions

GtkCellRenderer * | gtk_cell_renderer_progress_new ()

## Properties

GtkProgressBarOrientation | orientation | Read / Write
gint | pulse | Read / Write
gchar * | text | Read / Write
gfloat | text-xalign | Read / Write
gfloat | text-yalign | Read / Write
gint | value | Read / Write

## Types and Values

struct | GtkCellRendererProgress

## Object Hierarchy

        GObject
        ╰── GInitiallyUnowned
            ╰── GtkObject
                ╰── GtkCellRenderer
                    ╰── GtkCellRendererProgress

## Includes

    #include <gtk/gtk.h>

## Description

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

The GtkCellRendererProgress cell renderer was added in GTK+ 2.6.

## Functions

### gtk_cell_renderer_progress_new ()

    GtkCellRenderer *
    gtk_cell_renderer_progress_new (void);

Creates a new GtkCellRendererProgress.

#### Returns

the new cell renderer

Since 2.6

## Types and Values

### struct GtkCellRendererProgress

    struct GtkCellRendererProgress;

## Property Details

### The `“orientation”` property

      “orientation”              GtkProgressBarOrientation

The "orientation" property controls the direction and growth direction of the progress bar (left-to-right, right-to-left, top-to-bottom or bottom-to-top).

Flags: Read / Write

Default value: GTK_PROGRESS_LEFT_TO_RIGHT

Since 2.12

### The `“pulse”` property

      “pulse”                    gint

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`.

Flags: Read / Write

Allowed values: >= -1

Default value: -1

Since 2.12

### The `“text”` property

      “text”                     gchar *

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

Flags: Read / Write

Default value: NULL

Since 2.6

### The `“text-xalign”` property

      “text-xalign”              gfloat

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.

Flags: Read / Write

Allowed values: [0,1]

Default value: 0.5

Since 2.12

### The `“text-yalign”` property

      “text-yalign”              gfloat

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

Flags: Read / Write

Allowed values: [0,1]

Default value: 0.5

Since 2.12

### The `“value”` property

      “value”                    gint

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

Flags: Read / Write

Allowed values: [0,100]

Default value: 0

Since 2.6