📄 x892.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"><HTML><HEAD><TITLE>进度条 Progress Bars</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+"><LINKREL="HOME"TITLE="GTK+ 2.0 教程"HREF="book1.html"><LINKREL="UP"TITLE="杂项构件"HREF="c816.html"><LINKREL="PREVIOUS"TITLE="工具提示对象 The Tooltips Object"HREF="x873.html"><LINKREL="NEXT"TITLE="对话框 Dialogs"HREF="x924.html"></HEAD><BODYCLASS="SECT1"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLESUMMARY="Header navigation table"WIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><THCOLSPAN="3"ALIGN="center">GTK+ 2.0 教程</TH></TR><TR><TDWIDTH="10%"ALIGN="left"VALIGN="bottom"><AHREF="x873.html"ACCESSKEY="P"><<< Previous</A></TD><TDWIDTH="80%"ALIGN="center"VALIGN="bottom">杂项构件</TD><TDWIDTH="10%"ALIGN="right"VALIGN="bottom"><AHREF="x924.html"ACCESSKEY="N">Next >>></A></TD></TR></TABLE><HRALIGN="LEFT"WIDTH="100%"></DIV><DIVCLASS="SECT1"><H1CLASS="SECT1"><ANAME="SEC-PROGRESSBARS">进度条 Progress Bars</H1><P>进度条用于显示正在进行的操作的状态。在下面的代码中可以看出，它相当容易使用。下面的内容从创建一个新进度条开始。</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">GtkWidget *gtk_progress_bar_new( void );</PRE></TD></TR></TABLE><P>创建进度条后就可以使用它了。</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_progress_bar_set_fraction ( GtkProgressBar *pbar, gdouble fraction );</PRE></TD></TR></TABLE><P>第一个参数是希望操作的进度条，第二个参数是“已完成”的百分比，意思是进度条从0-100%已经填充的数量。它以0～1范围的实数传递给函数。</P><P>GTK 1.2版已经给进度条添加了一个新的功能，那就是允许它以不同的方法显示其值，并通知用户它的当前值和范围。</P><P>进度条可以用以下函数设置它的移动方向：</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_progress_bar_set_orientation( GtkProgressBar *pbar, GtkProgressBarOrientation orientation );</PRE></TD></TR></TABLE><P><TTCLASS="LITERAL">orientation</TT>参数可以取下列值之一，以指示进度条的移动方向：</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING"> GTK_PROGRESS_LEFT_TO_RIGHT 从左向右 GTK_PROGRESS_RIGHT_TO_LEFT 从右向左 GTK_PROGRESS_BOTTOM_TO_TOP 从下向上 GTK_PROGRESS_TOP_TO_BOTTOM 从上向下</PRE></TD></TR></TABLE><P>除了指示进度已经发生的数量以外，进度条还可以设置为仅仅指示有活动在继续,即活动状态。这在进度无法按数值度量的情况下很有用。用下面的函数来表明进度有了些进展。</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_progress_bar_pulse ( GtkProgressBar *progress );</PRE></TD></TR></TABLE><P>活动指示的步数由以下函数设置：</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_progress_bar_set_pulse_step( GtkProgressBar *pbar, gdouble fraction );</PRE></TD></TR></TABLE><P>在非活动状态下，进度条可以用下列函数在滑槽里显示一个可配置的文本串：</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_progress_bar_set_text( GtkProgressBar *progress, const gchar *text );</PRE></TD></TR></TABLE><DIVCLASS="NOTE"><P></P><TABLECLASS="NOTE"WIDTH="100%"BORDER="0"><TR><TDWIDTH="25"ALIGN="CENTER"VALIGN="TOP"><IMGSRC="./stylesheet-images/note.gif"HSPACE="5"ALT="Note"></TD><TDALIGN="LEFT"VALIGN="TOP"><P>注意,gtk_progress_set_text()不再支持 GTK+ 1.2版进度条里那种类似printf()的格式参数</P></TD></TR></TABLE></DIV><P>你可以通过调用 gtk_progess_bar_set_text() 并把 NULL 作为第二个参数来关闭文本串的显示．</P><P>进度条的当前文本设置能由下面的函数取得。不要释放返回的字符串．</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">const gchar *gtk_progress_bar_get_text( GtkProgressBar *pbar );</PRE></TD></TR></TABLE><P>进度条通常和timeouts或其它类似函数同时使用(详见<AHREF="c1713.html">超时、I/O 和 Idle 函数</A>这一章)，使应用程序就像是多任务一样。一般都以同样的方式调用 gtk_progress_bar_set_fraction() 或 gtk_progress_bar_pulse() 函数。</P><P>下面是一个进度条的示例，用timeout函数更新进度条的值。代码也演示了怎样复位进度条。</P><P><SPANCLASS="INLINEMEDIAOBJECT"><IMGSRC="images/progressbar.png"></SPAN></P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING"> #include <gtk/gtk.h>typedef struct _ProgressData { GtkWidget *window; GtkWidget *pbar; int timer; gboolean activity_mode;} ProgressData;/* 更新进度条，这样就能够看到进度条的移动 */gint 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;} /* 回调函数，切换在进度条你的滑槽上的文本显示 */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");}/* 回调函数，切换进度条的活动模式 */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);} /* 回调函数，切换进度条的移动方向 */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) */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; 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 (G_OBJECT (pdata->window), "destroy", G_CALLBACK (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); /* 创建一个居中对齐的对象 */ 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 (); gtk_container_add (GTK_CONTAINER (align), pdata->pbar); gtk_widget_show (pdata->pbar); /* 加一个定时器(timer)，以更新进度条的值 */ pdata->timer = gtk_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, 2, 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 (G_OBJECT (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 (G_OBJECT (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 (G_OBJECT (check), "clicked", G_CALLBACK (toggle_orientation), pdata); gtk_widget_show (check); /* 添加一个按钮，用来退出应用程序 */ button = gtk_button_new_with_label ("close"); g_signal_connect_swapped (G_OBJECT (button), "clicked", G_CALLBACK (gtk_widget_destroy), pdata->window); gtk_box_pack_start (GTK_BOX (vbox), button, FALSE, FALSE, 0); /* 将按钮设置为能缺省的构件 */ 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;}</PRE></TD></TR></TABLE></DIV><DIVCLASS="NAVFOOTER"><HRALIGN="LEFT"WIDTH="100%"><TABLESUMMARY="Footer navigation table"WIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top"><AHREF="x873.html"ACCESSKEY="P"><<< Previous</A></TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"><AHREF="book1.html"ACCESSKEY="H">Home</A></TD><TDWIDTH="33%"ALIGN="right"VALIGN="top"><AHREF="x924.html"ACCESSKEY="N">Next >>></A></TD></TR><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top">工具提示对象 The Tooltips Object</TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"><AHREF="c816.html"ACCESSKEY="U">Up</A></TD><TDWIDTH="33%"ALIGN="right"VALIGN="top">对话框 Dialogs</TD></TR></TABLE></DIV></BODY></HTML>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -