## GtkCellRendererProgress

GtkCellRendererProgress — Renders numbers as progress bars

## Synopsis

    #include <gtk/gtk.h>

                        GtkCellRendererProgress;
    GtkCellRenderer*    gtk_cell_renderer_progress_new      (void);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkCellRenderer
                         +----GtkCellRendererProgress

## Properties

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

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

## Details

### GtkCellRendererProgress

    typedef struct _GtkCellRendererProgress GtkCellRendererProgress;

### gtk_cell_renderer_progress_new ()

    GtkCellRenderer*    gtk_cell_renderer_progress_new      (void);

Creates a new GtkCellRendererProgress.

Returns : | the new cell renderer

Since 2.6

## Property Details

### The `"orientation"` property

      "orientation"              GtkProgressBarOrientation  : Read / Write

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

Default value: GTK_PROGRESS_LEFT_TO_RIGHT

Since 2.12

### The `"pulse"` property

      "pulse"                    gint                  : 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`.

Allowed values: >= G_MAXULONG

Default value: -1

Since 2.12

### The `"text"` property

      "text"                     gchar*                : Read / Write

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.

Default value: NULL

Since 2.6

### The `"text-xalign"` property

      "text-xalign"              gfloat                : 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.

Allowed values: [0,1]

Default value: 0.5

Since 2.12

### The `"text-yalign"` property

      "text-yalign"              gfloat                : 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).

Allowed values: [0,1]

Default value: 0.5

Since 2.12

### The `"value"` property

      "value"                    gint                  : Read / Write

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

Allowed values: [0,100]

Default value: 0

Since 2.6