【golang-GUI开发】struct tags系统（二）qt的自定义组件和构造函数

今天我们来讲讲自定义组件和它的构造函数。

在前面的文章里我们已经接触了好几个自定组件，这次的示例是一个自定义对话框，他有一个about按钮，点击按钮可以显示出Qt的信息或者用户输入的信息。这是效果图：

下面我们就来重点讲解自定义组件和它的构造函数吧。

构造函数的声明

先上代码：

type MyDialog struct {
    widgets.QDialog
    
    _ func() `constructor:"init"`
    
    _ func(string) `signal:"showAbout"`
    _ func() `signal:"showAboutQt"`
    
    _ func(bool)   `slot:"aboutClicked,auto"`
    _ func(string) `slot:"enableAboutButton,auto"`
    
    label         *widgets.QLabel
    edit          *widgets.QLineEdit
    testCheck     *widgets.QCheckBox
    isDialogCheck *widgets.QCheckBox
    aboutButton   *widgets.QPushButton
    closeButton   *widgets.QPushButton
}

构造函数用 “ _ func() `constructor:"init"` ”
来声明，目前只支持无参数的构造函数，以后会逐步扩展。之后我们需要实现一个名字是init的类方法，这是构造函数的实体。

qt的moc系统遇到派生自QObject及其派生类的类时，会自动生成一个New[type name]的函数（type name也会被Title处理），它会返回一个已经初始化的指向自定义类型实例的指针，这个函数的参数类型会根据最先继承的QObject或是其派生类的New[type name]而定，举个例子：

假设我们的类继承自QLineEdit，在qt里有NewQLineEdit(parent QWidget_ITF)，那么我们这个类自动生成的New[type name]就会是New[type name](parent QWidget_ITF);
再举个例子，我们的组件继承自QWidget，它有NewQWidget(parent QWidget_ITF, fo core.Qt__WindowType)，那么我们的类会自动生成New[type name](parent QWidget_ITF, fo core.Qt__WindowType)。

我们实现的init会被New[type name]自动调用。不过这里有个问题，如果我想实现自己的New[type name]函数呢，比如需要加上自己的配置参数，其实也很简单，我们再定义一个New[type name]WithXXX然后在其中调用New[type name]即可，向下面这样：

func NewYourTypeWithConfig(conf Config) *YourType {
    // 假设继承自QWidget
    obj := NewYourType(nil, 0)
    // 一些额外的初始化处理
    // 一般在init里进行界面的初始化，如果你的界面初始化依赖外部数据，那么可以不指定constructor，
    // 这样New[type name]就不会自动调用init，你可以在自定义函数里调用它。
    obj.conf = conf
  
    // obj.init()
}

这就是构造函数的全貌了，接着我们来看看界面的初始化，也就是我们要实现的init函数:

func (d *MyDialog) init() {
    d.label = widgets.NewQLabel2("About &Text:", d, 0)
    d.edit = widgets.NewQLineEdit(nil)
    // 将label和edit绑定
    d.label.SetBuddy(d.edit)
    
    d.testCheck = widgets.NewQCheckBox2("Test case", nil)
    // 选择显示自定义组件的About还是Qt的About
    d.isDialogCheck = widgets.NewQCheckBox2("Show &Dialog's about", nil)

    // 当用户输入要显示的内容时才可以点击
    d.aboutButton = widgets.NewQPushButton2("&About", nil)
    d.aboutButton.SetDefault(true)
    d.aboutButton.SetEnabled(false)
    
    d.closeButton = widgets.NewQPushButton2("&Close", nil)
    d.closeButton.ConnectClicked( func(_ bool) {
        d.Done(0)
    })
    
    d.edit.ConnectTextChanged(d.EnableAboutButton)
    d.aboutButton.ConnectClicked(d.aboutClicked)
    
    topLeftLayout := widgets.NewQHBoxLayout()
    topLeftLayout.AddWidget(d.label, 0, 0)
    topLeftLayout.AddWidget(d.edit, 0, 0)
    
    leftLayout := widgets.NewQVBoxLayout()
    leftLayout.AddLayout(topLeftLayout, 0)
    leftLayout.AddWidget(d.testCheck, 0, 0)
    leftLayout.AddWidget(d.isDialogCheck, 0, 0)
    
    rightLayout := widgets.NewQVBoxLayout()
    rightLayout.AddWidget(d.aboutButton, 0, 0)
    rightLayout.AddWidget(d.closeButton, 0, 0)
    rightLayout.AddStretch(0)
    
    mainLayout := widgets.NewQHBoxLayout()
    mainLayout.AddLayout(leftLayout, 0)
    mainLayout.AddLayout(rightLayout, 0)
    d.SetLayout(mainLayout)
    
    d.SetWindowTitle("about")
}

代码也很简单，初始化widgets之后使用QBoxLayout进行布局，然后连接一下closeButton，使用QDialog::done退出dialog。

我们设置aboutButton初始为不可点击状态，直到有输入内容存在在改变它的状态，这一步由自动连接的enableAboutButton槽来完成；
然后是点击aboutButton时会检查isDialogCheck的值来确定弹出哪种对话框，这一步由aboutClicked槽来完成：

func (d *MyDialog) aboutClicked(_ bool) {
    text := d.edit.Text()
    
    if d.isDialogCheck.IsChecked() {
        d.ShowAbout(text)
    } else {
        d.ShowAboutQt()
    }
}

func (d *MyDialog) enableAboutButton(text string) {
    if text != "" {
        d.aboutButton.SetEnabled(true)
    } else {
        d.aboutButton.SetEnabled(false)
    }
}

然后就是主函数，将显示About对话框的信号和相应的处理函数连接，然后显示我们的组件：

func main() {
    app := widgets.NewQApplication(len(os.Args), os.Args)
    
    dialog := NewMyDialog(nil, 0)
    // 显示About Qt
    dialog.ConnectShowAboutQt( func() {
        app.AboutQtDefault()
    })
    // 显示自定义内容的About
    dialog.ConnectShowAbout( func(text string) {
        widgets.NewQMessageBox(dialog).About(dialog, "About Dialog", text)
    })
    
    dialog.Show()
    
    app.Exec()
}

显示About Qt时的效果：

怎么样，是不是很简单，下一篇文章里我们将结束对qt struct tags的探索，如果有任何疑问或者建议，欢迎在评论指出！
祝玩得愉快！