学习图形界面开发,肯定离不开帮助文档的使用,因为它不像C语言那样就那么几个函数接口,图形接口的接口可以用海量来形容,常用的我们可能能记住,其它的真的没有必要去记,用到什么就去帮助文档查看用法。
我们使用GTK帮助文档,主要分为这么几步:
1)查看所用控件的相应接口(功能,参数,返回值)
2)查看控件的继承关系( 继承过来的接口,继承过来的信号 )
3)查看控件的信号(主要查看信号所对应回调函数的写法)
1)查看所用控件的相应接口(功能,参数,返回值)
查看所用控件的相应接口( 本身的接口,继承过来的接口 ),主要是为了查看这个接口如何使用,包括函数的功能,参数,返回值。
下面我们以按钮( GtkButton )为例:
a) 可以通过接口名字查询,如 gtk_button_new_with_label
b) 可以通过控件类型名字查询,如 gktbutton (不区分大小写)
右边就是控件的相应内容:
控件本身的接口:
点击所查看的控件接口:
查看接口的功能,参数,返回值:
GtkWidget *button = gkt_button_new_with_label("^_^");
我们还这么操作过按钮:
gtk_widget_show( button ); // 显示按钮
gtk_widget_set_size_request( button, 150 , 100) // 设置按钮大小
但是,我们查看控件(GtkButton)接口的时候,发现,它的本身接口都是gtk_button_开头的接口,我们没有看到gtk_widget_开头的接口,这时候我们就要查看控件(GtkButton)的继承关系,看它把哪些接口继承过来。
2)查看控件的继承关系( 继承过来的接口,继承过来的信号 )
继承我们可以理解为现实生活中的财产继承,如,我本身有些钱,这些钱是我的,我可以随便用,但是,同时我继承我父母的钱,那相当于他们的钱也间接给了我,这样的话,我就有两份钱,一份我自己本人的,一份是继承过来,我都可以用。
控件本身就有属于自己的接口,但是,它还继承别人的,这样它相当于有2套接口,本身的,继承的,都能用。
按钮的继承关系:
这里需要注意的是,除了接口可以继承,信号也是可以继承的。
按钮本身的信号:
继承过来的信号:
3)查看控件的信号(主要查看信号所对应回调函数的写法)
找到控件所对应的信号:
如:
处理信号时,除了本身信号以外,别忘了,还有继承信号,根据需要来选择。譬如,事件信号,使用的都是从GtkWidget继承过来的信号,如处理窗口的点击事件。
信号"button-press-event"不是GtkWindow本身的信号,是从GtkWidget继承过来的信号。回调函数怎么写,查看方法和上面的是一样的,这里主要说一下,事件信号回调函数参数里有个 事件属性 的参数。
gboolean fun(GtkWidget *w, GdkEvent *e, gpointer data)
{
// 参数GdkEvent,常直接写成GdkEventButton,
// 这样后期使用则不需要转换,代表鼠标事件
// GdkEvent * 相当于事件的万能指针,使用时候转换为所需要的类型
}
GdkEventButton是一个结构体,它保存着用户操作鼠标的状态,里面有哪些成员呢?我们也是可以查看的。
e->x, e->y 指点击窗口的坐标值,e->button可以判断鼠标哪个键按下。
这里需要注意,有些回调函数比较特别,我们找不到它所对应的信号,如“定时器”,这时候我们如何确定它的回调函数呢?
查询这个接口的用法:
找到这个接口,点击这个参数:
进去后,就是其回调函数的写法: