GTK+图形化应用程序开发学习笔记（二十）—分栏列表构建
GTK+图形化应用程序开发学习笔记（二十）—分栏列表构建
分栏列表构件（GtkCList）是较常用的构件，它是多列列表构件，可以非常方便的处理数千列的信息。每一列都可以有一个标题，而且可以是活动的。你还可以将函数绑定到列选择上。
一、创建分栏列表构件
创建GtkCList构件的方法和创建其他构件的方法是类似的。
1．
| 名称:： |
gtk_clist_new |
| 功能： |
创建分栏列表构件 |
| 头文件： |
#include <gtk/gtk.h> |
| 函数原形： |
GtkWidget *gtk_clist_new(gint columus); |
| 参数： |
columus 分栏列表的列数 |
| 返回值： |
新的分栏列表构件 |
columus就是分栏列表的列数。注意分栏列表没有自己的滚动条，如果要提供滚动条功能，应该将分栏列表构件放在一个滚动窗口构件中。
现在创建完的分栏列表构件，外观和文本框一样，我们需要设置分栏列表构件的列标题。
2．
| 名称:： |
gtk_clist_set_column_title |
| 功能： |
设置分栏列表构件的列标题 |
| 头文件： |
#include <gtk/gtk.h> |
| 函数原形： |
gtk_clist_set_column_title(GtkCList *clist,gint column,gchar *title); |
| 参数： |
clist 分栏列表构件 column 标题的编号 title 列标题 |
| 返回值： |
无 |
clist是就要设置的分栏列表构件，column就标题的编号，也是标题在分栏按钮中的位置0为第一个位置。
在设置完分栏列表构件的列标题后还要调用gtk_clist_column_titles_show函数把他显示出来。
3．
| 名称:： |
gtk_clist_column_titles_show |
| 功能： |
显示分栏列表构件的列标题 |
| 头文件： |
#include <gtk/gtk.h> |
| 函数原形： |
gtk_clist_column_titles_show(GtkCList *clist); |
| 参数： |
clist 分栏列表构件 |
| 返回值： |
无 |
好了下面我们就可以建立没有内容的分栏列表构件了。
| #include <gtk/gtk.h>
int main(int argc,char *argv[ ]) { GtkWidget *window; GtkWidget *clist;
gtk_init(&argc,&argv); window=gtk_window_new(GTK_WINDOW_TOPLEVEL); gtk_signal_connect(GTK_OBJECT(window),”delete_event”,GTK_SIGNAL_FUNC(gtk_main_quit),NULL); gtk_widget_set_size_request(window,200,150); gtk_container_set_border_width(GTK_CONTAINER(window),10);
clist=gtk_clist_new(3); gtk_clist_set_column_title(GTK_CLIST(clist),0,”姓名”); gtk_clist_set_column_title(GTK_CLIST(clist),1,”姓别”); gtk_clist_set_column_title(GTK_CLIST(clist),2,”年龄”);
gtk_clist_column_titles_show(GTK_CLIST(clist)); gtk_container_add(GTK_CONTAINER(window),clist);
gtk_widget_show(clist); gtk_widget_show(window); gtk_main(); } |
程序运行后得到如下界面：
还有一些函数可以对分栏列表的列标题进行操作，下面我们分别进行介绍。
4．
| 名称:： |
gtk_clist_column_titles_hide |
| 功能： |
隐藏分栏列表构件的列标题 |
| 头文件： |
#include <gtk/gtk.h> |
| 函数原形： |
gtk_clist_column_titles_show(GtkCList *clist); |
| 参数： |
clist 分栏列表构件 |
| 返回值： |
无 |
创建分栏列表构件时自动创建响应的标题按钮。标题一般处于分栏窗口的顶部，它可以是能对鼠标点击的按钮，也可以仅仅是不会作任何响应的标签。下面的四个函数可以设置这些标签的状态。
5．
| 名称:： |
gtk_clist_column_title_active gtk_clist_column_title_passive gtk_clist_column_titles_active gtk_clist_column_titles_passive |
| 功能： |
激活/停用分栏列表构件的列标题按钮 |
| 头文件： |
#include <gtk/gtk.h> |
| 函数原形： |
gtk_clist_column_titles_active(GtkCList *clist,gint column); |
| 参数： |
clist 分栏列表构件 column 列标题编号 |
| 返回值： |
无 |
活动标题就是可以对用户动作响应的按钮标题，被动标题仅仅是一个标签。前两个函数激活或停用指定列的标题按钮，后两个激或或禁用整个分栏列表构件的按钮标题。
有时候不是所有的标题都是文本。GtkCList构件为我们提供的标题按钮实际上能够和所有的构件结合起来使用，例如，它可以和pixmap构件结合起来，在上面显示一副图片。使用下面得用函数可以为标题按钮设置构件。
6．
| 名称:： |
gtk_clist_set_column_widget |
| 功能： |
为标题按钮设置构件 |
| 头文件： |
#include <gtk/gtk.h> |
| 函数原形： |
gtk_clist_set_column_twidget(GtkCList *clist,gint column,GtkWidget *widget); |
| 参数： |
clist 分栏列表构件 column 列标题编号 widget 要设置的构件 |
| 返回值： |
无 |
下面我们来看看上面几个函数的作用：
| #include <gtk/gtk.h>
int main(int argc,char *argv[ ]) { GtkWidget *window; GtkWidget *clist; GtkWidget *image;
gtk_init(&argc,&argv); window=gtk_window_new(GTK_WINDOW_TOPLEVEL); gtk_signal_connect(GTK_OBJECT(window),”delete_event”,GTK_SIGNAL_FUNC(gtk_main_quit),NULL); gtk_widget_set_size_request(window,200,150); gtk_container_set_border_width(GTK_CONTAINER(window),10);
clist=gtk_clist_new(3); gtk_clist_set_column_title(GTK_CLIST(clist),0,”姓名”); gtk_clist_set_column_title(GTK_CLIST(clist),1,”姓别”); gtk_clist_set_column_title(GTK_CLIST(clist),2,”年龄”);
gtk_clist_column_title_passive(GTK_CLIST(clist),1);/*设置编号为1的列标题为不活动的列标题*/ image=gtk_image_new_from_file(“ 1” ); /*创建图片构件，大家可以把参数改为自己的图片文件名*/ gtk_clist_set_column_widget(GTK_CLIST(clist),0,image);/*设置标题按钮构件*/
gtk_clist_column_titles_show(GTK_CLIST(clist)); gtk_container_add(GTK_CONTAINER(window),clist);
gtk_widget_show(clist); gtk_widget_show(window); gtk_main(); } |
运行上面程序得到如下界面：
我们还可以用gtk_clist_set_shadow_type来设置分栏列表构件的边框类型。
7．
| 名称:： |
gtk_clist_set_shadow_type |
| 功能： |
设置分栏列表构件的边框类型 |
| 头文件： |
#include <gtk/gtk.h> |
| 函数原形： |
gtk_clist_set_shadow_type(GtkCList *clist,GtkShadowType border); |
| 参数： |
clist 分栏列表构件 border 边框类型 |
| 返回值： |
无 |
边框类型可以取下面的值：
GTK_SHADOW_NONE
GTK_SHADOW_IN
GTK_SHADOW_OUT
GTK_SHADOW_ETCHED_IN
GTK_SHADOW_ETCHED_OUT
二、向列表中添加/删除行
可以用三种方法添加行。即在前面、后面和指定位子加入行。
8．
| 名称:： |
gtk_clist_prepend gtk_clist_append gtk_clist_insert |
| 功能： |
向列表中添加行 |
| 头文件： |
#include <gtk/gtk.h> |
| 函数原形： |
gtk_clist_prepend(GtkCList *clist, gchar *text[ ]); gtk_clist_append(GtkCList *clist, gchar *text[ ]); gtk_clist_insert(GtkCList *clist, gint row, gchar text[ ]); |
| 参数： |
clist 分栏列表构件 row 列标题编号 text 文本数组 |
| 返回值： |
无 |
有两种方式在列表中删除行，gtk_clist_remove可以删除指定的行，gtk_clist_clear可以删除所有的行。
9．
| 名称:： |
gtk_clist_remove gtk_clist_clear |
| 功能： |
向列表中添加/删除行 |
| 头文件： |
#include <gtk/gtk.h> |
| 函数原形： |
gtk_clist_remove(GtkCList *clist, gint row); gtk_clist_clear(GtkCList *clist); |
| 参数： |
clist 分栏列表件 row 行编号 |
| 返回值： |
无 |
还有两个很方便的函数可以用在当列表中要发生很大变化时。因为GtkCList在发生变化时要重绘自身，所以当列表中内容变化较大时，频繁重绘会让屏幕不停闪烁。最好的办法是先将列表“冻结”，然后更新列表，最后将其“解冻”。
10．
| 名称:： |
gtk_clist_freeze gtk_clist_thaw |
| 功能： |
冻结/解冻列表 |
| 头文件： |
#include <gtk/gtk.h> |
| 函数原形： |
gtk_clist_freeze(GtkCList *clist); gtk_clist_thaw(GtkCList *clist); |
| 参数： |
clist 分栏列表构件 |
| 返回值： |
无 |
下面我们就向列表中插入几行数据：
| #include <gtk/gtk.h>
int main(int argc,char *argv[ ]) { GtkWidget *window; GtkWidget *clist; gchar *text1[3]={“刘备”,”男”,” 23” }; /*定义列表项数据*/ gchar *text2[3]={“关羽”,”男”,” 22” };
gtk_init(&argc,&argv); window=gtk_window_new(GTK_WINDOW_TOPLEVEL); gtk_signal_connect(GTK_OBJECT(window),”delete_event”,GTK_SIGNAL_FUNC(gtk_main_quit),NULL); gtk_widget_set_size_request(window,200,150); gtk_container_set_border_width(GTK_CONTAINER(window),10);
clist=gtk_clist_new(3); gtk_clist_set_column_title(GTK_CLIST(clist),0,”姓名”); gtk_clist_set_column_title(GTK_CLIST(clist),1,”姓别”); gtk_clist_set_column_title(GTK_CLIST(clist),2,”年龄”);
gtk_clist_prepend(GTK_CLIST(clist),text1);/*将列表项数据添加到列表*/ gtk_clist_prepend(GTK_CLIST(clist),text2);
gtk_clist_column_titles_show(GTK_CLIST(clist)); gtk_container_add(GTK_CONTAINER(window),clist);
gtk_widget_show(clist); gtk_widget_show(window); gtk_main(); } |
程序运行后得到如下界面：
三、列表设置
可以用gtk_clist_set_column_justification函数设置列的对齐方式.
11．
| 名称:： |
gtk_clist_set_column_justification |
| 功能： |
设置列的对齐方式 |
| 头文件： |
#include <gtk/gtk.h> |
| 函数原形： |
void gtk_clist_set_column_justification( GtkCList *clist, gint column, GtkJustification justification ); |
| 参数： |
clist 分栏列表构件 column 列标题编号 justification 对齐方式 |
| 返回值： |
无 |
GtkJustification参数类型可取以下值：
GTK_JUSTIFY_LEFT：列中的文本左对齐。
GTK_JUSTIFY_RIGHT：列中的文本右对齐。
GTK_JUSTIFY_CENTER：列中的文本居中对齐。
GTK_JUSTIFY_FILL：文本使用列中所有可用的空间。
创建构件时单元格的宽度是依据它们的标题确定的，而单元格的高度的却省值是当前字体的高度。因此在多数情况下这不一定符合要求，gtk_clist_set_column_width函数设置单元格的宽度。gtk_clist_set_column_width函数可以设置单元格的高度。
12．
| 名称:： |
gtk_clist_set_column_width gtk_clist_set_row_height |
| 功能： |
设置单元格的高度和宽度 |
| 头文件： |
#include <gtk/gtk.h> |
| 函数原形： |
void gtk_clist_set_column_width( GtkCList *clist,gint column,gint width ); void gtk_clist_set_row_height( GtkCList *clist,gint height ); |
| 参数： |
clist 分栏列表构件 column 列标题编号 width 单元格的宽度 height 单元格的高度 |
| 返回值： |
无 |
注意，单元格宽度和高度都是以像素度量，而不是以字母度量的。缺省值是当前字体的宽度和高度。
13．
| 名称:： |
gtk_clist_set_shif |
| 功能： |
设置单元格内水平和垂直方向上的缩进 |
| 头文件： |
#include <gtk/gtk.h> |
| 函数原形： |
void gtk_clist_set_shift( GtkCList *clist,gint row,gint column,gint vertical, gint horizontal); |
| 参数： |
clist 分栏列表构件 row 行编号 column 列编号 vertical 水平缩进 horizontal 垂直缩进 |
| 返回值： |
无 |
gtk_clist_set_column_with函数可以用于设置单元格内水平和垂直方向上的缩进，缩进值是以像素度量的整数值，它可以是正数也可以是负数。下面是我们应用上面两个函数的程序例子：
| #include <gtk/gtk.h>
int main(int argc,char *argv[ ]) { GtkWidget *window; GtkWidget *clist; gchar *text1[3]={“刘备”,”男”,” 23” }; /*定义列表项数据*/ gchar *text2[3]={“关羽”,”男”,” 22” };
gtk_init(&argc,&argv); window=gtk_window_new(GTK_WINDOW_TOPLEVEL); gtk_signal_connect(GTK_OBJECT(window),”delete_event”,GTK_SIGNAL_FUNC(gtk_main_quit),NULL); gtk_widget_set_size_request(window,200,150); gtk_container_set_border_width(GTK_CONTAINER(window),10);
clist=gtk_clist_new(3); gtk_clist_set_column_title(GTK_CLIST(clist),0,”姓名”); gtk_clist_set_column_title(GTK_CLIST(clist),1,”姓别”); gtk_clist_set_column_title(GTK_CLIST(clist),2,”年龄”);
gtk_clist_prepend(GTK_CLIST(clist),text1);/*将列表项数据添加到列表*/ gtk_clist_prepend(GTK_CLIST(clist),text2); gtk_clist_set_column_justification(GTK_CLIST(clist),0,GTK_JUSTIFY_CENTER);/*设置列0的对齐方式为居中对齐*/ gtk_clist_set_column_width(GTK_CLIST(clist),0,50);/*设置列0的宽度为50*/ gtk_clist_set_shift(GTK_CLIST(clist),1,1,0,10);
gtk_clist_column_titles_show(GTK_CLIST(clist)); gtk_container_add(GTK_CONTAINER(window),clist);
gtk_widget_show(clist); gtk_widget_show(window); gtk_main(); } |
下面是运行后的界面：
我们可以gtk_clist_get_text来得到指定单元格的数据，可以用gtk_clist_set_text来修改这些数据。
14．
| 名称:： |
gtk_clist_get_text gtk_clist_set_text |
| 功能： |
查看/设置单元格中的文本 |
| 头文件： |
#include <gtk/gtk.h> |
| 函数原形： |
gint gtk_clist_get_text( GtkCList *clist,gint row,gint column,gchar **text ); void gtk_clist_set_text( GtkCList *clist,gint row,gint column,const gchar *text ); |
| 参数： |
clist 分栏列表构件 text 单元格文本 |
| 返回值： |
无 |
gtk_clist_set_text可以设置单元格的文本，函数可以用新文本来覆盖原有的文本，row和column用来指定单元的位置，单元格的横纵位置都是从0开始的。
gtk_clist_get_text取得指定单元格的数据，这些指针都是指向存储在构件内部的数据指针，所以不应该修改或释放。引用的数据没有必要将不感兴趣的数据全部读出。任何返回值指针（除了GtkCList构件）都可以是NULL。
四、信号
与其他构件一样，GtkCList有一些信号供我们使用。GtkCList构件是从容器构件GtkContainer派生的，它有容器所具有的一些信号，还有下面这些附加信号：
select_row：选中一行时引发，该信号传递以下信息，依次是GtkCList *clist、gint row、
gint column、GtkEventButton *event、gpointer data。该信号的回调函数形势如下：
void select_row_callback(GtkWidget *widget,gint row,gint column,GtkEventButton *event,gpointer data);
unselect_row：用户对一行取消选择，引发这个信号。传递的信息与上一个信号一样。
click_column：选中某一列时引发。传递以下信息： GtkCList *clist、gint column、gpointer data。
下面是程序例子：
| #include <gtk/gtk.h>
void select_row_callback(GtkWidget *clist,gint row,gint column,GdkEventButton *event,gpointer data);
int main(int argc,char *argv[ ]) { GtkWidget *window; GtkWidget *clist; gchar *text1[3]={“刘备”,”男”,” 23” }; /*定义列表项数据*/ gchar *text2[3]={“关羽”,”男”,” 22” };
gtk_init(&argc,&argv); window=gtk_window_new(GTK_WINDOW_TOPLEVEL); gtk_signal_connect(GTK_OBJECT(window),”delete_event”,GTK_SIGNAL_FUNC(gtk_main_quit),NULL); gtk_widget_set_size_request(window,200,150); gtk_container_set_border_width(GTK_CONTAINER(window),10);
clist=gtk_clist_new(3); gtk_clist_set_column_title(GTK_CLIST(clist),0,”姓名”); gtk_clist_set_column_title(GTK_CLIST(clist),1,”姓别”); gtk_clist_set_column_title(GTK_CLIST(clist),2,”年龄”);
gtk_clist_prepend(GTK_CLIST(clist),text1);/*将列表项数据添加到列表*/ gtk_clist_prepend(GTK_CLIST(clist),text2);
gtk_signal_connect(GTK_OBJECT(clist),”select_row”,GTK_SIGNAL_FUNC(select_row_callback),NULL);/*捕捉select_row信号*/
gtk_clist_column_titles_show(GTK_CLIST(clist)); gtk_container_add(GTK_CONTAINER(window),clist);
gtk_widget_show(clist); gtk_widget_show(window); gtk_main(); }
void select_row_callback(GtkWidget *clist,gint row,gint column,GdkEventButton *event,gpointer data)/*设置select_row信号的回调函数*/ { gchar *text=NULL; gtk_clist_get_text(GTK_CLIST(clist),row,column,&text); gprint(“%s/n”,text); } |
程序运行后当用户点击单元格，屏幕就打印相应的内容。