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继承过来的信号,如处理窗口的点击事件。
信号"button-press-event"不是GtkWindow本身的信号,是从GtkWidget继承过来的信号。回调函数怎么写,查看方法和上面的是一样的,这里主要说一下,事件信号回调函数参数里有个 事件属性 的参数。
gboolean fun(GtkWidget *w, GdkEvent *e, gpointer data)
{
// 参数GdkEvent,常直接写成GdkEventButton,
// 这样后期使用则不需要转换,代表鼠标事件
// GdkEvent * 相当于事件的万能指针,使用时候转换为所需要的类型
}
GdkEventButton是一个结构体,它保存着用户操作鼠标的状态,里面有哪些成员呢?我们也是可以查看的。
e->x, e->y 指点击窗口的坐标值,e->button可以判断鼠标哪个键按下。
这里需要注意,有些回调函数比较特别,我们找不到它所对应的信号,如“定时器”,这时候我们如何确定它的回调函数呢?
查询这个接口的用法:
找到这个接口,点击这个参数:
进去后,就是其回调函数的写法:
帮助文档下载请点此。
我们使用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可以判断鼠标哪个键按下。
这里需要注意,有些回调函数比较特别,我们找不到它所对应的信号,如“定时器”,这时候我们如何确定它的回调函数呢?
查询这个接口的用法:
找到这个接口,点击这个参数:
进去后,就是其回调函数的写法:
帮助文档下载请点此。
相关文章推荐
- GTK帮助文档的使用
- 简单概述使用jbuilder中archive builder(jar与jad文档定制),javadoc(帮助文档输出)
- [引]SQL帮助文档:使用 WAITFOR 使SQL语句停顿后执行
- 让vim使用中文帮助文档
- EyesBaby1.0使用帮助文档
- 使用Sandcastle生成.NET帮助文档
- JConfig帮助文档翻译-在文件系统下的使用
- Visual C++ 2010 使用心得 和帮助文档问题
- MSDN帮助文档不能使用的解决办法【转帖整理】
- Mysql 命令行模式 学会使用帮助文档
- 使用方便的SDK帮助文档
- [引]SQL帮助文档:使用 WAITFOR 使SQL语句停顿后执行
- 在NetBeans 6.1 中使用中文API帮助文档
- 读帮助文档发现Delphi2009的新特性,象C语言一样用数组方式使用指针.
- Delphi 2005帮助文档无法使用的解决办法
- 程序中帮助文档的制作与使用
- 如何让 eclipse 全面 使用 Java API中文帮助文档
- 使用GTK-DOC自动生成API文档
- EyesBaby1.0使用帮助文档
- Visual C++ 2010 使用心得 和帮助文档问题