進度顯示器用於顯示正在進行的操作狀態。在下面的程式碼中可以看出，它相當容易使用。下面的內容從創建一個新進度顯示器開始。
GtkWidget *gtk_progress_bar_new( void ); |
創建進度顯示器後就可以使用它了。
void gtk_progress_bar_set_fraction ( GtkProgressBar *pbar,
gdouble fraction );
|
第一個參數是希望操作的進度顯示器，第二個參數是「已完成」的百分比，意思是進度顯示器從0-100%已經填充的數量。它以0～1範圍的實數傳遞給函式。
GTK 1.2版已經給進度顯示器添加了一個新的功能，那就是允許它以不同的方法顯示其值，並通知用戶它的當前值和範圍。
進度顯示器可以用以下函式設置它的移動方向：
void gtk_progress_bar_set_orientation( GtkProgressBar *pbar,
GtkProgressBarOrientation orientation );
|
orientation參數可以取下列值之一，以指示進度顯示器的移動方向：
GTK_PROGRESS_LEFT_TO_RIGHT 從左向右 GTK_PROGRESS_RIGHT_TO_LEFT 從右向左 GTK_PROGRESS_BOTTOM_TO_TOP 從下向上 GTK_PROGRESS_TOP_TO_BOTTOM 從上向下 |
除了指示進度已經發生的數量以外，進度顯示器還可以設置為僅僅指示有活動在繼續，即活動狀態。這在進度無法按數值度量的情況下很有用。用下面的函式來表明進度有了些進展。
void gtk_progress_bar_pulse ( GtkProgressBar *progress ); |
活動指示的步數由以下函式設置：
void gtk_progress_bar_set_pulse_step( GtkProgressBar *pbar,
gdouble fraction );
|
在非活動狀態下，進度顯示器可以用下列函式在滑槽裡顯示一個可配置的文字：
void gtk_progress_bar_set_text( GtkProgressBar *progress,
const gchar *text );
|
 |
注意,gtk_progress_set_text()不再支持 GTK+ 1.2版進度顯示器裡那種類似printf()的格式參數 |
你可以通過呼叫 gtk_progess_bar_set_text() 並把 NULL 作為第二個參數來關閉字串的顯示．
進度顯示器的當前文字設置能由下面的函式取得。不要釋放傳回的字串．
const gchar *gtk_progress_bar_get_text( GtkProgressBar *pbar ); |
進度顯示器通常和timeouts或其它類似函式同時使用(詳見逾時、I/O 和 Idle 函式這一章)，使應用程式就像是多任務一樣。一般都以同樣的方式呼叫 gtk_progress_bar_set_fraction() 或 gtk_progress_bar_pulse() 函式。
下面是一個進度顯示器的範例，用timeout函式更新進度顯示器的值。程式碼告訴你如何重設進度顯示器。
#include <gtk/gtk.h>
typedef struct _ProgressData {
GtkWidget *window;
GtkWidget *pbar;
int timer;
gboolean activity_mode;
} ProgressData;
/* 更新進度顯示器，這樣就能夠看到進度顯示器的移動 */
static gboolean progress_timeout( gpointer data )
{
ProgressData *pdata = (ProgressData *)data;
gdouble new_val;
if (pdata->activity_mode)
gtk_progress_bar_pulse (GTK_PROGRESS_BAR (pdata->pbar));
else
{
/* 使用在調整物件中設置的取值範圍計算進度顯示器的值 */ new_val = gtk_progress_bar_get_fraction (GTK_PROGRESS_BAR (pdata->pbar)) + 0.01;
if (new_val > 1.0)
new_val = 0.0;
/* 設置進度顯示器的新值 */ gtk_progress_bar_set_fraction (GTK_PROGRESS_BAR (pdata->pbar), new_val); } /* 這是一個timeout函式，傳回 TRUE，這樣它就能夠繼續被呼叫 */ return TRUE; } /* 回呼函式，切換在進度顯示器你的滑槽上的文字顯示 */ static void toggle_show_text( GtkWidget *widget,
ProgressData *pdata )
{
const gchar *text;
text = gtk_progress_bar_get_text (GTK_PROGRESS_BAR (pdata->pbar));
if (text && *text)
gtk_progress_bar_set_text (GTK_PROGRESS_BAR (pdata->pbar), "");
else
gtk_progress_bar_set_text (GTK_PROGRESS_BAR (pdata->pbar), "some text");
}
/* 回呼函式，切換進度顯示器的活動模式 */ static void toggle_activity_mode( GtkWidget *widget,
ProgressData *pdata )
{
pdata->activity_mode = !pdata->activity_mode;
if (pdata->activity_mode)
gtk_progress_bar_pulse (GTK_PROGRESS_BAR (pdata->pbar));
else
gtk_progress_bar_set_fraction (GTK_PROGRESS_BAR (pdata->pbar), 0.0);
}
/* 回呼函式，切換進度顯示器的移動方向 */ static void toggle_orientation( GtkWidget *widget,
ProgressData *pdata )
{
switch (gtk_progress_bar_get_orientation (GTK_PROGRESS_BAR (pdata->pbar))) {
case GTK_PROGRESS_LEFT_TO_RIGHT:
gtk_progress_bar_set_orientation (GTK_PROGRESS_BAR (pdata->pbar),
GTK_PROGRESS_RIGHT_TO_LEFT);
break;
case GTK_PROGRESS_RIGHT_TO_LEFT:
gtk_progress_bar_set_orientation (GTK_PROGRESS_BAR (pdata->pbar),
GTK_PROGRESS_LEFT_TO_RIGHT);
break;
default:;
// 什麼也不做 } } /* 清除配置的記憶體，刪除計時器(timer) */ static void destroy_progress( GtkWidget *widget,
ProgressData *pdata)
{
g_source_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;
GtkWidget *button;
GtkWidget *check;
GtkWidget *vbox;
gtk_init (&argc, &argv);
/* 為傳遞到回呼函式中的資料配置記憶體 */
pdata = g_malloc (sizeof (ProgressData));
pdata->window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
gtk_window_set_resizable (GTK_WINDOW (pdata->window), TRUE);
g_signal_connect (pdata->window, "destroy",
G_CALLBACK (destroy_progress),
(gpointer) 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);
/* 創建一個居中對齊的物件 */ 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);
/* 創建進度顯示器 */ pdata->pbar = gtk_progress_bar_new ();
pdata->activity_mode = FALSE;
gtk_container_add (GTK_CONTAINER (align), pdata->pbar);
gtk_widget_show (pdata->pbar);
/* 加一個計時器(timer)，以更新進度顯示器的值 */ pdata->timer = g_timeout_add (100, progress_timeout, pdata);
separator = gtk_hseparator_new ();
gtk_box_pack_start (GTK_BOX (vbox), separator, FALSE, FALSE, 0);
gtk_widget_show (separator);
/* 行數、列數、同質性(homogeneous) */ table = gtk_table_new (2, 3, FALSE);
gtk_box_pack_start (GTK_BOX (vbox), table, FALSE, TRUE, 0);
gtk_widget_show (table);
/* 添加一個複選按鈕，以選擇是否顯示在滑槽裡的文字 */ 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);
g_signal_connect (check, "clicked",
G_CALLBACK (toggle_show_text),
pdata);
gtk_widget_show (check);
/* 添加一個複選按鈕，切換活動狀態 */ 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);
g_signal_connect (check, "clicked",
G_CALLBACK (toggle_activity_mode),
pdata);
gtk_widget_show (check);
/* 添加一個複選按鈕，切換移動方向 */ check = gtk_check_button_new_with_label ("Right to Left");
gtk_table_attach (GTK_TABLE (table), check, 0, 1, 2, 3,
GTK_EXPAND | GTK_FILL, GTK_EXPAND | GTK_FILL,
5, 5);
g_signal_connect (check, "clicked",
G_CALLBACK (toggle_orientation),
pdata);
gtk_widget_show (check);
/* 添加一個按鈕，用來退出應用程式 */ button = gtk_button_new_with_label ("close");
g_signal_connect_swapped (button, "clicked",
G_CALLBACK (gtk_widget_destroy),
pdata->window);
gtk_box_pack_start (GTK_BOX (vbox), button, FALSE, FALSE, 0);
/* 將按鈕設置為能預設的元件 */ gtk_widget_set_can_default (button, TRUE); /* 將預設焦點設置到這個按鈕上，使之成為預設按鈕，只要按ENTER鍵
* 就相當於點擊了這個按鈕 */
//譯者註： 能預設的元件在獲取焦點後成為預設元件，用戶按方向鍵等可以切換焦點。
gtk_widget_grab_default (button);
gtk_widget_show (button);
gtk_widget_show (pdata->window);
gtk_main ();
return 0;
} |
2 則留言