天天看点

【golang-GUI开发】struct tags系统(一)

我们已经介绍了qt的signal和slot,现在该讲讲它的struct tags系统了。qt拥有多种的struct tags,我们会去一一了解它们。

什么是struct tags?

struct tag

又叫做结构体标签,顾名思义,它就是用来给结构体字段做标记的。比如我们熟悉的JSON就使用了tags:

type User struct {
    UserId   int    `json:"user_id" bson:"user_id"`
    UserName string `json:"user_name" bson:"user_name"`
}
           

tags由反引号包裹,name在

:

之前,value在

:

之后由双引号包裹。

有了这些tags,我们的代码就可以很轻松的使用reflect来取得tags的name和name对应的值:

u := &User{UserId: 1, UserName: "tony"}
t := reflect.TypeOf(u)
field := t.Elem().Field(0)
fmt.Println(field.Tag.Get("json"))    // "user_id"
fmt.Println(field.Tag.Get("bson"))    // "user_id"
           

我们的qt正是依赖这一特性实现了Qt的moc系统,使用不同的tags除了可以实现signal和slot之外还能实现moc的多种功能,甚至是qt自己的一些扩展。

“->” 和 “<-”

在signal里我们已经介绍了auto,它具有很多的局限性,项目作者也表示auto应该尽量单独使用,不应该使用

auto(...)

的形式。而为了更方便的连接signal和slot,我们就需要用到

->

<-

了。

先看个示例,这次我们从官方的例子里节选一段:

type Chart struct {
	core.QObject
	*charts.QChart

	_ func() `constructor:"init"`

	_ func() `slot:"handleTimeout,<-(this.m_timer.timeout)"`
}
           

对于槽handleTimeout,我们使用了

<-

,它和下面这句等价:

this.m_timer.ConnectTimeout(this.handleTimeout)
           

意思是将

this.m_timer

的Timeout信号和

this.handleTimeout

函数connect,当触发了

this.m_timer

的Timeout信号时这个函数也会被调用。

你也可以不指定信号名称,默认会和signal tag指定的信号名同名的函数进行connect:

_ func() `slot:"handleTimeout,<-(this.m_timer)"`
           
_ func() `slot:"handleTimeout,<-(this.m_timer.handleTimeout)"`
           

等价。

我们再来看一下

->

的使用:

import "controller"

type dialogTemplate struct {
	core.QObject

	_ func() `constructor:"init"`

	_ func(cident string) `signal:"show,<-(controller.Controller)"`
	_ func(bool)          `signal:"blur,->(controller.Controller)"`
}
           

可以看到,我们对信号Blur使用了

->

,这个表达的含义与

<-

相反,它是将signal tag声明的信号或是slot tag声明的槽与

->

之后的函数进行connect,当你触发这个信号或是调用这个槽时,括号内的函数也会被调用,等价于:

this.ConnectBlur(controller.Controller.blur)
           

或是(如上面所说,可以省略函数名)

this.ConnectBlur(controller.Controller)
           

“->”和“<-”的一些使用规则

上一段里我们已经提到可以在这两个tags里省略连接和被连接对象的函数名,这里还有几个规则:

  1. 括号里指定的可以是全局对象,包括导入的包里的可见对象,例如上个例子里的

    controller.Controller

  2. this代指当前对象的实例(可以理解为c++的

    this

    ,python的

    self

    占位符,或者golang的

    receiver

    )。
  3. 括号里的内容还可以是

    this.StructField

    ,也就是对象里的字段
  4. 对于想连接继承的

    QObject

    及其派生类或是其他类的signal/slot,目前只能使用

    this.BaseClass.method

    的形式(与auto类似),这一点作者表示会在以后改进。

“->”和“<-”以及“auto”

这三者都需要和signal/slot tag配合使用,他们都会自动connect信号和槽,但是它们也有许多不同。

  • 首先我们日常使用应该尽量使用

    singal:"signalName,auto"

    而不是

    auto(...)

    ->

    <-

    ,如果只是为了少写

    Connect*

    ,那么不应使用后三者,因为除非你有大量的

    Connect*

    需要编写,否则容易影响代码阅读,特别是对连接对象是当前类实例的成员函数时。
  • ->

    <-

    用于不同的对象之间进行交互,比起分散的

    Connect*

    调用,在struct tags里声明逻辑关系更易于维护。
  • ->

    <-

    用于连接已有的信号和槽,如果想复用基类或者成员变量的signal和slot,你就需要

    ->

    <-

    替代

    auto

  • 和QML交互时,也应该使用

    ->

    <-

    连接来自QML的signals。

客观上这三者都能极大的简化我们对signal/slot的实现和使用,所以根据不同的场景需求,我们需要选用合适的tags来简化我们的开发。

下一篇文章我们将了解

constructor

这个tag,qt中的构造函数。

如果对本篇有什么疑问或者建议,欢迎在评论中提出。

祝玩得愉快!