我们到处都能看到进度条的应用,我们下载拷贝个文件,下载个电影等总能看到进度条的影子,如图:
进度条的常用操作无非设置其比例或者获取其比例。
进度条的创建:
GtkWidget *gtk_progress_bar_new(void);
返回值:进度条指针
设置进度条显示的进度比例:
void gtk_progress_bar_set_fraction( GtkProgressBar *pbar,
gdouble fraction);
pbar:需要操作的进度条
fraction:0.0到1.0
设置进度条显示的进度比例:
gdouble gtk_progress_bar_get_fraction (GtkProgressBar *pbar);
pbar:需要操作的进度条
返回值:进度比例
设置滑槽上的文本显示:
void gtk_progress_bar_set_text( GtkProgressBar *pbar,
gchar *text);
pbar:需要操作的进度条
text:设置的文本内容
设置进度条的移动方向:
void gtk_progress_bar_set_orientation( GtkProgressBar *pbar,
GtkProgressBarOrientation orientation);
pbar:需要操作的进度条
orientation:移动方向,它是一个枚举变量
GTK_PROGRESS_LEFT_TO_RIGHT:从左向右
GTK_PROGRESS_RIGHT_TO_LEFT:从右向左
GTK_PROGRESS_BOTTOM_TO_TOP:从下向上
GTK_PROGRESS_TOP_TO_BOTTOM:从上向下
获取进度条的方向:
gtk_progress_bar_get_orientation(GtkProgressBar *pbar);
pbar:需要操作的进度条
返回值:进度条的方向,它是一个枚举类型
例子代码如下:
#include <gtk/gtk.h>
#include <string.h>
// 回调函数,切换进度条的移动方向
void toggle_orientation(GtkWidget *widget, gpointer data)
{
// gtk_progress_bar_get_orientation: 获得进度条当前移动的方向
switch( gtk_progress_bar_get_orientation( GTK_PROGRESS_BAR(data) ) ){
case GTK_PROGRESS_LEFT_TO_RIGHT:
gtk_progress_bar_set_orientation(GTK_PROGRESS_BAR(data), GTK_PROGRESS_RIGHT_TO_LEFT);
break;
case GTK_PROGRESS_RIGHT_TO_LEFT:
gtk_progress_bar_set_orientation(GTK_PROGRESS_BAR(data), GTK_PROGRESS_LEFT_TO_RIGHT);
break;
default: // 什么也不做
break;
}
}
// 更新进度条,这样就能够看到进度条的移动
void callback(GtkWidget *widget, gpointer data)
{
// 在原来值基础上增加 0.05
gdouble new_val = gtk_progress_bar_get_fraction( GTK_PROGRESS_BAR(data) ) + 0.05;
if(new_val > 1.0){ // 越界处理
new_val = 0.0;
}
// 设置进度条的新值
gtk_progress_bar_set_fraction(GTK_PROGRESS_BAR(data), new_val);
}
int main(int argc, char *argv[])
{
gtk_init(&argc, &argv); // 初始化
GtkWidget *window = gtk_window_new(GTK_WINDOW_TOPLEVEL); // 创建主窗口
gtk_window_set_title(GTK_WINDOW(window), "GtkProgressBar"); // 设置窗口标题
gtk_container_set_border_width(GTK_CONTAINER(window), 10); // 设置边框宽度
// 设置窗口的最小大小
gtk_widget_set_size_request(window, 300, 200);
// 窗口关联 destroy 信号 到 gtk_main_quit
g_signal_connect(G_OBJECT(window), "destroy", G_CALLBACK(gtk_main_quit), NULL);
GtkWidget *vbox = gtk_vbox_new(FALSE, 5); // 垂直布局容器
gtk_container_add(GTK_CONTAINER(window), vbox); // 容器加入窗口
// 创建一个进度条
GtkWidget *progress = gtk_progress_bar_new();
gtk_container_add(GTK_CONTAINER(vbox), progress); // 加入垂直布局容器
// 设置进度条显示的百分比:50%
gtk_progress_bar_set_fraction(GTK_PROGRESS_BAR(progress), 0.5 );
// 设置在进度条的滑槽上的文本显示
gtk_progress_bar_set_text(GTK_PROGRESS_BAR(progress), "some text");
// 添加一个按钮,切换移动方向
GtkWidget *button_orientation = gtk_button_new_with_label("Right to Left");
g_signal_connect(button_orientation, "clicked", G_CALLBACK(toggle_orientation), progress);
gtk_container_add(GTK_CONTAINER(vbox), button_orientation); // 加入垂直布局容器
// 增加进度条进度按钮
GtkWidget *button = gtk_button_new_with_label("add");
g_signal_connect(button, "clicked", G_CALLBACK(callback), progress); // connect
gtk_container_add(GTK_CONTAINER(vbox), button); // 加入垂直布局容器
gtk_widget_show_all(window);
gtk_main(); // 主事件循环
return 0;
}
程序运行效果图如下: