您的位置:首页 > 其它

GTK帮助文档的使用

2015-01-16 16:18 357 查看
学习图形界面开发,肯定离不开帮助文档的使用,因为它不像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继承过来的信号,如处理窗口的点击事件。

GtkWidget *window = gtk_window_new(GTK_WINDOW_TOPLEVEL);	// 创建窗口

gtk_widget_add_events(window, GDK_BUTTON_PRESS_MASK);		// 接受鼠标事件

g_signal_connect(window, "button-press-event", G_CALLBACK(deal_mouse_press), NULL); // 处理"button-press-event"信号


信号"button-press-event"不是GtkWindow本身的信号,是从GtkWidget继承过来的信号。回调函数怎么写,查看方法和上面的是一样的,这里主要说一下,事件信号回调函数参数里有个 事件属性 的参数。



gboolean fun(GtkWidget *w, GdkEvent *e, gpointer data)
{

// 参数GdkEvent,常直接写成GdkEventButton,
// 这样后期使用则不需要转换,代表鼠标事件
// GdkEvent * 相当于事件的万能指针,使用时候转换为所需要的类型

}

GdkEventButton是一个结构体,它保存着用户操作鼠标的状态,里面有哪些成员呢?我们也是可以查看的。









e->x, e->y 指点击窗口的坐标值,e->button可以判断鼠标哪个键按下。

这里需要注意,有些回调函数比较特别,我们找不到它所对应的信号,如“定时器”,这时候我们如何确定它的回调函数呢?

查询这个接口的用法:



找到这个接口,点击这个参数:



进去后,就是其回调函数的写法:



帮助文档下载请点此。
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: