Progress Bar

 

Sono usate per mostrare lo stato di un'operazione.
Ci sono due funzioni per creare una nuova progress.

GtkWidget *gtk_progress_bar_new( void );

GtkWidget *gtk_progress_bar_new_with_adjustment( GtkAdjustment *adjustment );

Il secondo metodo ha il vantaggio che ci permette di usare un adjustment per specificare il range dei paramentri della progress bar.

L'adjustment di una progress può essere cambiato dinamicamente usando:

void gtk_progress_set_adjustment( GtkProgress *progress,
GtkAdjustment *adjustment );

Per far avanzare la progress useremo:

void gtk_progress_bar_update( GtkProgressBar *pbar,
gfloat percentage );

Il primo argomento è la progress creata ed il secondo l'avanzamento che vogliamo che va da 0-100% questo è passato alla funzione come un numero reale da 0 a 1.

Per settare l'orientamento della progress si può usare:

void gtk_progress_bar_set_orientation( GtkProgressBar *pbar,
GtkProgressBarOrientation orientation );

Dove l'argomento orientation può assumere una delle seguenti forme che indicano la direzione in cui la progress si muove:

GTK_PROGRESS_LEFT_TO_RIGHT
GTK_PROGRESS_RIGHT_TO_LEFT
GTK_PROGRESS_BOTTOM_TO_TOP
GTK_PROGRESS_TOP_TO_BOTTOM

Possiamo inoltre determinare lo stile della progress con:

void gtk_progress_bar_set_bar_style( GtkProgressBar *pbar,
GtkProgressBarStyle style );

lo stile può assumere uno dei seguenti valori:
GTK_PROGRESS_CONTINUOUS
GTK_PROGRESS_DISCRETE

Nel secondo caso la barra si presenta come formata da blocchi il cui numero può essere settato con:

void gtk_progress_bar_set_discrete_blocks( GtkProgressBar *pbar,
guint blocks );

Nel continuous mode, la progress può anche indicare al suo interno una stringa di testo che rifletta il suo stato:

void gtk_progress_set_format_string( GtkProgress *progress,
gchar *format);

L'argomento format è simile al printf del C e possono essere usate le seguenti direttive:

%p - percentage
%v - value
%l - lower range value
%u - upper range value

La visualizzazione di questa stringa di testo è attivata con la funzione:

void gtk_progress_set_show_text( GtkProgress *progress,
gint show_text );

Dove l'argomento show_text può assumere il valore TRUE/FALSE.

La corrente stringa di testo di una progress può essere ricavata con le seguenti due funzioni:

gchar *gtk_progress_get_current_text( GtkProgress *progress );

gchar *gtk_progress_get_text_from_value( GtkProgress *progress,
gfloat value );

C'e' inoltre un altro modo per cambiare il valore di una progress:

void gtk_progress_configure( GtkProgress *progress,
gfloat value,
gfloat min,
gfloat max );

Le funzioni rimanenti sono intuitive e servono in vari modi per settare o ricavare il valore corrente della progress:

void gtk_progress_set_percentage( GtkProgress *progress,
gfloat percentage );

void gtk_progress_set_value( GtkProgress *progress,
gfloat value );

gfloat gtk_progress_get_value( GtkProgress *progress );

gfloat gtk_progress_get_current_percentage( GtkProgress *progress );

gfloat gtk_progress_get_percentage_from_value( GtkProgress *progress,
gfloat value );

 

 

 Esempio

#include <gtk/gtk.h>

typedef struct _ProgressData {
GtkWidget *window;
GtkWidget *pbar;
int timer;
} ProgressData;

/* Aggiorna il value della progress */
gint progress_timeout( gpointer data )
{
gfloat new_val;
GtkAdjustment *adj;

/* Calcola il value della progress usando il range dell'adjustment */

new_val = gtk_progress_get_value( GTK_PROGRESS(data) ) + 1;

adj = GTK_PROGRESS (data)->adjustment;
if (new_val > adj->upper)
new_val = adj->lower;

/* Setta il nuovo value */
gtk_progress_set_value (GTK_PROGRESS (data), new_val);

return(TRUE);
}

/* Callback che attiva la visualizzazione della stringa di testo
* nella progress */

void toggle_show_text( GtkWidget *widget,
ProgressData *pdata )
{
gtk_progress_set_show_text (GTK_PROGRESS (pdata->pbar),
GTK_TOGGLE_BUTTON (widget)->active);
}

/* Callback che attiva l'activity mode */
void toggle_activity_mode( GtkWidget *widget,
ProgressData *pdata )
{
gtk_progress_set_activity_mode (GTK_PROGRESS (pdata->pbar),
GTK_TOGGLE_BUTTON (widget)->active);
}

/* Callback che attiva il continuous mode */

void set_continuous_mode( GtkWidget *widget,
ProgressData *pdata )
{
gtk_progress_bar_set_bar_style (GTK_PROGRESS_BAR (pdata->pbar),
GTK_PROGRESS_CONTINUOUS);
}

/* Callback che attiva il discrete mode */

void set_discrete_mode( GtkWidget *widget,
ProgressData *pdata )
{
gtk_progress_bar_set_bar_style (GTK_PROGRESS_BAR (pdata->pbar),
GTK_PROGRESS_DISCRETE);
}

/* Disallochiamo la memoria e rimuoviamo il timer */
void destroy_progress( GtkWidget *widget,
ProgressData *pdata)
{
gtk_timeout_remove (pdata->timer);
pdata->timer = 0;
pdata->window = NULL;
g_free(pdata);
gtk_main_quit();
}

int main( int argc,
char *argv[])
{
ProgressData *pdata;
GtkWidget *align;
GtkWidget *separator;
GtkWidget *table;
GtkAdjustment *adj;
GtkWidget *button;
GtkWidget *check;
GtkWidget *vbox;

gtk_init (&argc, &argv);

/* Alloca la memoria per i dati */
pdata = g_malloc( sizeof(ProgressData) );

pdata->window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
gtk_window_set_policy (GTK_WINDOW (pdata->window), FALSE, FALSE, TRUE);

gtk_signal_connect (GTK_OBJECT (pdata->window), "destroy",
GTK_SIGNAL_FUNC (destroy_progress),
pdata);
gtk_window_set_title (GTK_WINDOW (pdata->window), "GtkProgressBar");
gtk_container_set_border_width (GTK_CONTAINER (pdata->window), 0);

vbox = gtk_vbox_new (FALSE, 5);
gtk_container_set_border_width (GTK_CONTAINER (vbox), 10);
gtk_container_add (GTK_CONTAINER (pdata->window), vbox);
gtk_widget_show(vbox);

/* Crea un alignment object */
align = gtk_alignment_new (0.5, 0.5, 0, 0);
gtk_box_pack_start (GTK_BOX (vbox), align, FALSE, FALSE, 5);
gtk_widget_show(align);

/* Crea un GtkAdjusment object per il range della progress */
adj = (GtkAdjustment *) gtk_adjustment_new (0, 1, 150, 0, 0, 0);

/* Crea la progress usando l'adjustment */
pdata->pbar = gtk_progress_bar_new_with_adjustment (adj);

/* Setta il formato della stringa da visualizzare
* nella progress bar:
* %p - percentage
* %v - value
* %l - lower range value
* %u - upper range value */
gtk_progress_set_format_string (GTK_PROGRESS (pdata->pbar),
"%v from [%l-%u] (=%p%%)");
gtk_container_add (GTK_CONTAINER (align), pdata->pbar);
gtk_widget_show(pdata->pbar);

/* Aggiunge un timer callback per aggiornare il value della progress bar */
pdata->timer = gtk_timeout_add (100, progress_timeout, pdata->pbar);

separator = gtk_hseparator_new ();
gtk_box_pack_start (GTK_BOX (vbox), separator, FALSE, FALSE, 0);
gtk_widget_show(separator);

/* righe, colonne, homogeneous */
table = gtk_table_new (2, 3, FALSE);
gtk_box_pack_start (GTK_BOX (vbox), table, FALSE, TRUE, 0);
gtk_widget_show(table);

/* Aggiunge un check button per la visualizzazione del testo nella progress */
check = gtk_check_button_new_with_label ("Show text");
gtk_table_attach (GTK_TABLE (table), check, 0, 1, 0, 1,
GTK_EXPAND | GTK_FILL, GTK_EXPAND | GTK_FILL,
5, 5);
gtk_signal_connect (GTK_OBJECT (check), "clicked",
GTK_SIGNAL_FUNC (toggle_show_text),
pdata);
gtk_widget_show(check);

/* Aggiunge un check button per l'activity mode */
check = gtk_check_button_new_with_label ("Activity mode");
gtk_table_attach (GTK_TABLE (table), check, 0, 1, 1, 2,
GTK_EXPAND | GTK_FILL, GTK_EXPAND | GTK_FILL,
5, 5);
gtk_signal_connect (GTK_OBJECT (check), "clicked",
GTK_SIGNAL_FUNC (toggle_activity_mode),
pdata);
gtk_widget_show(check);

separator = gtk_vseparator_new ();
gtk_table_attach (GTK_TABLE (table), separator, 1, 2, 0, 2,
GTK_EXPAND | GTK_FILL, GTK_EXPAND | GTK_FILL,
5, 5);
gtk_widget_show(separator);

/* Aggiunge un radio button per il continuous display mode */
button = gtk_radio_button_new_with_label (NULL, "Continuous");
gtk_table_attach (GTK_TABLE (table), button, 2, 3, 0, 1,
GTK_EXPAND | GTK_FILL, GTK_EXPAND | GTK_FILL,
5, 5);
gtk_signal_connect (GTK_OBJECT (button), "clicked",
GTK_SIGNAL_FUNC (set_continuous_mode),
pdata);
gtk_widget_show (button);

/* Aggiunge un radio button per il discrete display mode */
button = gtk_radio_button_new_with_label(
gtk_radio_button_group (GTK_RADIO_BUTTON (button)),
"Discrete");
gtk_table_attach (GTK_TABLE (table), button, 2, 3, 1, 2,
GTK_EXPAND | GTK_FILL, GTK_EXPAND | GTK_FILL,
5, 5);
gtk_signal_connect (GTK_OBJECT (button), "clicked",
GTK_SIGNAL_FUNC (set_discrete_mode),
pdata);
gtk_widget_show (button);

separator = gtk_hseparator_new ();
gtk_box_pack_start (GTK_BOX (vbox), separator, FALSE, FALSE, 0);
gtk_widget_show(separator);

/* Aggiunge un button per l'uscita dal programma */
button = gtk_button_new_with_label ("close");
gtk_signal_connect_object (GTK_OBJECT (button), "clicked",
(GtkSignalFunc) gtk_widget_destroy,
GTK_OBJECT (pdata->window));
gtk_box_pack_start (GTK_BOX (vbox), button, FALSE, FALSE, 0);

/* Setta il bottone come default. */
GTK_WIDGET_SET_FLAGS (button, GTK_CAN_DEFAULT);
gtk_widget_grab_default (button);
gtk_widget_show(button);

gtk_widget_show (pdata->window);

gtk_main ();

return(0);
}