GTK系统添加建立一种新的“类型”的过程
GObject, Glib, GDK, GTK+...

GLib的一些规范

simplyzhao posted @ 2009年6月07日 05:28 in Gtk+ with tags GObject glib gtk+ , 2137 阅读

来源:

imtx.cn/archives/167.html

 

在一些面向对象的程序语言中,有一些内置方法,是用来取得类的所属关系或者类型。比如Python中,用type来取得实例的类型。

GLib中规定了一些规范来实现这个。 这是在学用GObject定义自己的类型前需要注意的。

当用户在头文件中创建新类型时,有一些规范用户需要注意:

  • 使用object_method的形式来定义函数名称:例如在一个bar类中定义一个名为foo的函数,则用bar_foo。
  • 使用前缀来避免与其他工程的命名空间冲突。如果你的库(或应用程序)名为Marman,那么所有的函数名称前缀为maman_。举例:maman_object_method。
  • 创建一个宏命为PREFIX_OBJECT_TYPE用来返回GType关联的对象类型。比如,Bar这个类在一个以maman前缀的库中,则使用 MANMAN_BAR_TYPE。另有一个不成文的规定是,定义一个使用全局静态变或一个名为prefix_object_get_type的函数来实现 这个宏。我们将在后面的章节中讨论这个函数。
  • 创建一个宏命名为PREFIX_OBJECT(obj)来返回一个指向 PrefixObject类型的指针。这个宏用于必要时安全地强制转换一个静态类型。运行环境检查时,同样也是安全地执行动态类型。在处理过程中禁用动态 类型检查是可行的。例如,我们可以创建MAMAN_BAR(obj)来保持先前的例子。
  • 如果类型是类化的,那么创建一个命令为 PREFIX_OBJECT_CLASS(klass)的宏。这个宏与前面那个是非常相似的:它以类结构的动态类型检查来进行静态转换,并返回一个指向 PrefixObjectClass这个类型的类结构的指针。同样,例子为:MAMAN_BAR_CLASS。
  • 创建一个宏命名为PREFIX_IS_BAR (obj):这个宏用于判断输入的对象实例是否是BAR类型的。
  • 如果类型是类化的,创建一个名为PREFIX_IS_OBJECT_CLASS (klass)的宏,与上面的类似,返回输入的类型指针是否是OBJECT类型。
  • 如果类型是类化的,创建一个名为PREFIX_OBJECT_GET_CLASS,返回一个实例所属的类的类型指针。这个宏因为安全的原因,被静态和动态类型所使用,就像上面的转换宏一样。

至于这些宏的实现是非常直观的:一些数量的简单使用的宏由gtype.h提供。针对上面我们兴趣的例子,我们写了下面的代码来声明这些宏:

 

#define MAMAN_BAR_TYPE                  (maman_bar_get_type ())

#define MAMAN_BAR(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), MAMAN_BAR_TYPE, MamanBar))

#define MAMAN_BAR_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), MAMAN_BAR_TYPE, MamanBarClass))

#define MAMAN_IS_BAR(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), MAMAN_BAR_TYPE))

#define MAMAN_IS_BAR_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), MAMAN_BAR_TYPE))

#define MAMAN_BAR_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), MAMAN_BAR_TYPE, MamanBarClass))

 
GType maman_bar_get_type (void)

{

static GType type = 0;

if (type == 0) {

static const GTypeInfo info = {

/* You fill this structure. */

};

type = g_type_register_static (G_TYPE_OBJECT,

"MamanBarType",

&info, 0);

}

return type;

}

 

例子(GtkWindow):

 

#define GTK_TYPE_WINDOW            (gtk_window_get_type ())
#define GTK_WINDOW(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_WINDOW, GtkWindow))
#define GTK_WINDOW_CLASS(klass)        (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_WINDOW, GtkWindowClass))
#define GTK_IS_WINDOW(obj)        (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_WINDOW))
#define GTK_IS_WINDOW_CLASS(klass)    (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_WINDOW))
#define GTK_WINDOW_GET_CLASS(obj)       (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_WINDOW, GtkWindowClass))

 

 

Enjoy Linux, Fighting.

登录 *


loading captcha image...
(输入验证码)
or Ctrl+Enter