GTK+ 2.0 教学-进度显示器

进度显示器用于显示正在进行的操作状态。在下面的程式码中可以看出,它相当容易使用。下面的内容从创建一个新进度显示器开始。

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

Note 注意,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;
}

Comments are closed.