GTK Gossip: GtkProgressBar

GtkProgressBar 常用來顯示目前的工作進度，例如程式安裝、檔案複製、下載等，可以使用gtk_progress_bar_new()建立一個 GtkProgressBar，若要設定進度比例，可以使用gtk_progress_bar_set_fraction()函式，可設定的值為0.0到 1.0，相對應的要取得目前進度比例，可以使用 gtk_progress_bar_get_fraction()函式。

GtkProgressBar可以使用gtk_progress_bar_set_text()設定文字顯示，使用 gtk_progress_bar_get_text()取得文字，另外，您還可以使用 gtk_progress_bar_set_orientation()設定進度列的移動方向，可設定的值有：

• GTK_PROGRESS_LEFT_TO_RIGHT：從左向右（預設）
• GTK_PROGRESS_RIGHT_TO_LEFT：從右向左
• GTK_PROGRESS_BOTTOM_TO_TOP： 從下向上
• GTK_PROGRESS_TOP_TO_BOTTOM：從上向下

下面的程式使用 gtk_timeout_add() 設定一個計時器，模擬進度遞增的狀況：

• gtk_progress_bar_demo.c

#include <gtk/gtk.h>



gboolean timeout_callback(gpointer data) {


    gdouble value;


    GString *text;




    value = gtk_progress_bar_get_fraction(GTK_PROGRESS_BAR(data));




    value += 0.01;


    if(value > 1.0) {


        value = 0.0;


    }




    gtk_progress_bar_set_fraction(GTK_PROGRESS_BAR(data), value);




    text = g_string_new(


             gtk_progress_bar_get_text(GTK_PROGRESS_BAR(data)));


    g_string_sprintf(text, "%d %%", (int) (value * 100));




    gtk_progress_bar_set_text(GTK_PROGRESS_BAR(data), text->str);




    return TRUE;


}




int main(int   argc, char *argv[]) {

    GtkWidget *window;

    GtkWidget *progressBar;


    gint timer;




    gtk_init(&argc, &argv);



    window = gtk_window_new(GTK_WINDOW_TOPLEVEL);

    gtk_window_set_title(GTK_WINDOW(window), "GtkProgressBar");

    gtk_window_set_default_size(GTK_WINDOW(window), 300, 30);



    progressBar = gtk_progress_bar_new();


    timer = gtk_timeout_add(100, timeout_callback, progressBar);




    gtk_container_add(GTK_CONTAINER(window), progressBar);




    g_signal_connect(GTK_OBJECT(window), "destroy",

                     G_CALLBACK(gtk_main_quit), NULL);

 

    gtk_widget_show_all(window);



    gtk_main();



    return 0;

}

執行的結果如下所示：