进度显示器用于显示正在进行的操作状态。在下面的程式码中可以看出,它相当容易使用。下面的内容从创建一个新进度显示器开始。
GtkWidget *gtk_progress_bar_new( void ); |
[adsense][/adsense]
创建进度显示器后就可以使用它了。
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 則留言
Comments are closed.