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;
}

執行的結果如下所示：